Перейти к основному содержимому

FTP и электронная почта в 1С

Разработчику

FTP (File Transfer Protocol) — это сетевой протокол, предназначенный для передачи файлов между компьютерами по сети. В экосистеме 1С он часто применяется как простой и надёжный способ обмена файлами между информационными базами, внешними системами и файловыми хранилищами: например, для выгрузки отчётов, загрузки прайсов, передачи архивов или файлов обмена. Протокол работает по модели «клиент — сервер»: клиент инициирует соединение и отдаёт команды, сервер их обрабатывает и передаёт либо принимает файлы.

Необходимость FTP в прикладных сценариях 1С обусловлена тем, что не все системы готовы поддерживать сложные механизмы интеграции — веб‑сервисы или прямое подключение к базам. FTP даёт универсальный, легко настраиваемый канал: достаточно указать хост, порт, учётные данные и путь к каталогу, чтобы организовать регулярный обмен. Кроме того, FTP удобен для пакетной передачи больших объёмов данных, когда важно сохранить целостность файлов и иметь возможность повторной загрузки при сбоях. В типовых интеграциях FTP используют для выгрузки файлов в общий каталог, получения прайс‑листов и актов от банков или EDI‑провайдеров, а также для временного хранения файлов перед их обработкой внутри 1С.

Электронная почта в контексте 1С — это не только средство коммуникации, но и канал обмена данными: через почту передают документы, отчёты, уведомления, файлы-вложения, а также служебные сообщения об ошибках и статусах обмена. В прикладных решениях электронная почта может использоваться как резервный или основной транспорт для доставки файлов, особенно если получатель не имеет прямого сетевого доступа к серверу 1С либо требуется подтверждение доставки и прочтения. Важной особенностью является работа с вложениями: они позволяют передавать структурированные файлы (XML, CSV, PDF) вместе с сопроводительным текстом, что удобно для юридически значимых документов и согласований.

FTP/FTPS и электронная почта — "классический" транспорт, когда контрагент не даёт REST API:

  • выгрузка пакетов обмена в общий каталог;
  • получение прайсов и актов с FTP-банка или EDI-провайдера;
  • отправка XML/CSV вложением на ящик партнёра;
  • приём входящих писем с файлами обмена.

REST API — это архитектурный стиль взаимодействия систем, при котором обмен данными происходит через HTTP‑запросы к определённым адресам (эндпоинтам) с использованием стандартных методов (GET, POST, PUT, DELETE) и форматов (чаще всего JSON или XML). В 1С REST API применяют для интеграции с веб‑сервисами, мобильными приложениями, интернет‑магазинами и внешними платформами. Платформа поддерживает публикацию собственных HTTP‑сервисов и вызов внешних API, что позволяет строить гибкие сценарии: от получения курсов валют и статусов заказов до передачи данных в CRM и DWH. REST‑подход удобен тем, что он прост в реализации, хорошо масштабируется и легко документируется, а для разработчика 1С это возможность использовать привычные механизмы запросов и обработки JSON.

Выгрузка пакетов обмена в общий каталог — это типовой сценарий интеграции, при котором 1С формирует файлы обмена (в форматах XML, JSON, CSV или внутреннем формате платформы) и помещает их в заранее оговорённую сетевую папку или каталог на FTP. Такой подход позволяет отделить процесс формирования данных от их доставки: сначала система готовит пакеты, затем отдельный сервис или регламентное задание переносит их в каталог, откуда другая система забирает файлы для дальнейшей обработки. Это повышает надёжность: при временных сбоях сети или недоступности приёмника файлы остаются в каталоге и могут быть загружены позже, а контроль за процессом упрощается за счёт журналов и статусов выгрузки.

Получение прайсов и актов с FTP‑банка или EDI‑провайдера — это регулярная задача, когда 1С должна скачивать файлы из внешнего источника, проверять их целостность, обрабатывать содержимое и фиксировать результаты в информационной базе. В таких сценариях важно учитывать расписание, повторные попытки при сбоях, проверку контрольных сумм или подписей, а также обработку ошибок: например, если файл повреждён или имеет неверный формат, система должна зафиксировать проблему и уведомить администратора. Для этого в 1С используют регламентные задания, механизмы журналирования и обработки исключений, а сам процесс скачивания и разбора файлов оформляют в виде отдельной обработки или подсистемы обмена.

EDI‑провайдер — это сервисная компания, которая обеспечивает электронный обмен структурированными документами (накладные, счета‑фактуры, заказы, акты) между контрагентами в стандартизированных форматах (EDIFACT, UN/EDIFACT, ANSI X12 и др.). В России такие провайдеры часто работают через собственные шлюзы и FTP‑каталоги, предоставляя доступ к файлам по учётным данным и гарантируя доставку, подтверждение получения и хранение истории. Для 1С EDI‑провайдер выступает как внешний источник данных: система может скачивать файлы, конвертировать их в документы и справочники, а также отправлять исходящие документы через провайдера. Интеграция с EDI‑провайдером обычно включает настройку маршрутов, правил сопоставления контрагентов и номенклатуры, а также контроль статусов доставки.

Вложение к письму — это файл, прикреплённый к электронному сообщению, который передаётся вместе с текстом письма и заголовками. В 1С вложения используют, чтобы передавать документы, отчёты, файлы обмена и архивы, когда канал FTP или веб‑сервис недоступен либо неудобен. При отправке письма вложения кодируются и упаковываются в MIME‑формат, а при получении — извлекаются и сохраняются на диск или сразу обрабатываются в памяти. Важно учитывать ограничения по размеру вложений, требования к форматам и необходимость проверки на вирусы или целостность, особенно если файлы содержат структурированные данные для загрузки в ИБ.

Файлы обмена — это структурированные файлы, предназначенные для передачи данных между информационными системами. В 1С они могут быть в форматах XML, JSON, CSV, TXT, а также во внутренних форматах платформы. Файлы обмена содержат либо полные выгрузки справочников и документов, либо пакеты изменений (дельта‑данные), либо служебную информацию о регистрации изменений, топологии узлов и статусах доставки. Их используют в механизмах универсального обмена, РИБ, интеграции с внешними системами и EDI. Ключевое требование к файлам обмена — чёткая структура, контроль целостности (контрольные суммы, подписи) и возможность повторной обработки без дублирования данных.

Для новых проектов чаще смотрят на HTTP; FTP и почта остаются в корпоративном и отраслевом обмене.


FTPСоединение

Объект FTPСоединение — хост, порт, пользователь, пароль, активный/пассивный режим, прокси.

Объект FTPСоединение в 1С — это встроенный программный интерфейс, позволяющий из кода на BSL устанавливать соединение с FTP‑сервером, выполнять команды и передавать файлы. С его помощью можно подключаться к серверу, переходить по каталогам, загружать и скачивать файлы, получать списки файлов, удалять и переименовывать объекты. Объект абстрагирует низкоуровневые детали протокола и предоставляет удобные методы для типичных операций, а также позволяет задавать параметры соединения: хост, порт, учётные данные, режим работы и прокси. Это основной инструмент для реализации сценариев обмена через FTP без привлечения внешних утилит.

Хост — это сетевое имя или IP‑адрес FTP‑сервера, к которому устанавливается соединение. В 1С хост указывают как часть параметров подключения и используют для определения адреса сервера в сети. От корректности хоста зависит возможность установить соединение, а в распределённых инфраструктурах хосты могут меняться в зависимости от среды (тестовая, продуктивная) или региона.

Порт — это номер сетевого порта, по которому FTP‑сервер принимает соединения. Стандартный порт для FTP — 21, но в некоторых конфигурациях используют нестандартные порты для разделения трафика или повышения безопасности. В параметрах FTP‑соединения порт задают явно, и он должен совпадать с настройками сервера; в противном случае соединение не установится либо будет работать некорректно.

Пользователь и пароль — это учётные данные для аутентификации на FTP‑сервере. В 1С их передают в составе параметров соединения и используют для подтверждения прав на чтение и запись файлов в заданных каталогах. Безопасность таких данных обеспечивают за счёт хранения в защищённых хранилищах, ограничения прав учётной записи на стороне сервера и применения защищённых протоколов (FTPS, FTPES) вместо обычного FTP.

Активный и пассивный режим — это два способа организации передачи данных в FTP, которые влияют на то, как устанавливается соединение для передачи файлов. В активном режиме сервер инициирует соединение к клиенту, что может быть заблокировано межсетевыми экранами; в пассивном режиме клиент запрашивает у сервера свободный порт, и сервер отвечает адресом и портом, после чего клиент сам устанавливает соединение для передачи. В 1С выбор режима важен при работе через корпоративные сети и NAT: чаще используют пассивный режим, поскольку он лучше проходит через файрволы и прокси.

Прокси — это промежуточный сервер, через который проходит сетевой трафик. В сценариях интеграции 1С прокси может потребоваться, если прямой доступ к FTP‑серверу запрещён политиками безопасности. Платформа позволяет задавать параметры прокси (адрес, порт, аутентификацию) в настройках соединения, чтобы обеспечить маршрутизацию запросов. При использовании прокси важно учитывать задержки, ограничения по размеру файлов и необходимость дополнительной настройки правил доступа.

FTP = Новый FTPСоединение(Сервер, , Пользователь, Пароль);
МассивФайлов = FTP.НайтиФайлы(КаталогНаСервере, "*.xml");

Для Каждого Файл Из МассивФайлов Цикл
Если Файл.ЭтоФайл() Тогда
FTP.Получить(Файл.ПолноеИмя, ЛокальныйКаталог + Файл.Имя);
КонецЕсли;
КонецЦикла;
МетодНазначение
НайтиФайлыСписок по маске
ПолучитьСкачать на диск
ЗаписатьЗагрузить на сервер
Переместить, УдалитьУправление на сервере

Поддерживаются FTPS и FTPES. Тяжёлые операции — на сервере 1С или в регламентном задании, не в модуле формы.

FTPS (FTP over SSL/TLS) — это защищённая версия FTP, при которой соединение шифруется с помощью SSL/TLS. В отличие от обычного FTP, где данные передаются в открытом виде, FTPS защищает учётные данные и содержимое файлов от перехвата. В 1С поддержка FTPS реализуется через соответствующие параметры соединения и использование безопасных библиотек, а на стороне сервера требуется настройка сертификатов и протоколов шифрования.

FTPES (Explicit FTP over SSL/TLS) — это вариант защищённого FTP, при котором соединение изначально устанавливается в обычном режиме, а затем клиент явно запрашивает шифрование (команда AUTH TLS). Это позволяет использовать один и тот же порт для обычного и защищённого трафика и упрощает работу через межсетевые экраны. В 1С FTPES применяют, когда сервер настроен на явное обновление соединения до защищённого, и это удобно для унификации инфраструктуры и снижения количества открытых портов.

Связка с универсальным обменом: файл Message_<Отправитель>_<Получатель>.xml кладут в FTP-каталог, партнёр забирает по расписанию.


ИнтернетПочта

Объект ИнтернетПочта работает с SMTP (отправка) и POP3/IMAP (получение). Параметры серверов — в ИнтернетПочтовыйПрофиль.

Объект ИнтернетПочта в 1С — это программный интерфейс для работы с электронной почтой из кода на BSL. С его помощью можно отправлять и получать письма, управлять вложениями, читать заголовки и статусы доставки, а также автоматизировать типовые сценарии: рассылку уведомлений, получение отчётов, обработку входящих файлов. Объект инкапсулирует работу с протоколами SMTP, POP3 и IMAP, предоставляя единый набор методов для разных сценариев. Это позволяет реализовывать почтовые интеграции без внешних утилит и сторонних библиотек.

SMTP (Simple Mail Transfer Protocol) — это протокол отправки электронной почты. В 1С SMTP используют для передачи писем от информационной базы к почтовому серверу, который затем доставляет их получателям. Для работы с SMTP в параметрах соединения указывают адрес сервера, порт (обычно 587 или 25), учётные данные и настройки шифрования (STARTTLS). SMTP важен для автоматических рассылок: уведомлений о заказах, статусах документов, ошибках обмена и отчётах.

POP3 (Post Office Protocol) и IMAP (Internet Message Access Protocol) — это протоколы получения электронной почты. POP3 загружает письма на локальное устройство и обычно удаляет их с сервера, а IMAP синхронизирует состояние писем между клиентом и сервером, сохраняя их на сервере и позволяя работать с ними с разных устройств. В 1С эти протоколы применяют для автоматического получения писем, извлечения вложений и разбора содержимого: например, чтобы забирать акты, счета или файлы обмена, поступающие по почте. Выбор между POP3 и IMAP зависит от требований к хранению писем и необходимости видеть их в почтовом клиенте пользователя.

ИнтернетПочтовыйПрофиль — это объект конфигурации в 1С, который хранит параметры почтового соединения: адрес сервера, порты, учётные данные, настройки шифрования, а также дополнительные параметры (таймауты, кодировки, правила обработки ошибок). Использование профиля позволяет централизовать настройки, упростить поддержку и быстро переключать сценарии (например, между тестовым и продуктивным почтовым сервером). Профили можно назначать разным регламентным заданиям и обработкам, обеспечивая гибкость и безопасность хранения учётных данных.

Типичная настройка профиля:

  • СерверSMTP, СерверPOP3 или СерверIMAP;
  • Пользователь, Пароль;
  • АдресОтправителя, АдресПолучателя.

Отправка может включать текст, HTML и вложения (файлы обмена). Получение — разбор вложений и передача в обработку загрузки сообщения обмена.

Безопасность

Пароли почты и FTP храните в защищённом хранилище или настройках, недоступных пользователям. Используйте TLS там, где поддерживает сервер.


Связанные материалы