Содержание:
1. Работа с «Заказами» в учетной системе 1С
2. Работа с ответом на заказ (ORDRSP) в программе 1C:Предприятие
3. Работа с уведомлением об отгрузке (DESADV)
4. Работа с универсальным передаточным документом (УПД)
5. Дополнительные возможности программы 1С
Интеграция с системами электронного документооборота (ЭДО) и электронного обмена данными (EDI) стала неотъемлемой частью автоматизации бизнеса. Компании, взаимодействующие с торговыми сетями, дистрибьюторами и поставщиками, всё чаще требуют полного цикла электронного обмена — от загрузки заказов до передачи УПД (универсального передаточного документа). А Платформа 1С:Предприятие 8 предоставляет гибкие возможности для настройки и интеграции подобных процессов через управляемые формы, модули интеграции и встроенные механизмы обмена. В этой статье рассмотрим практическую реализацию полного цикла EDI и ЭДО-документооборота в интеграционном модуле: от заказов до УПД, включая примеры кода и организационные аспекты настройки.
1. Работа с «Заказами» в учетной системе 1С
Модуль интеграции EDI/ЭДО представляет собой набор управляемых форм, серверных процедур и обменных обработок, обеспечивающих двусторонний обмен документами с внешним провайдером. Как правило, взаимодействие выполняется через XML-файлы, размещаемые на FTP/HTTP-серверах или через REST API.
Модуль может быть реализован как отдельная подсистема «Электронный обмен», включающая объекты:
● справочник «Партнёры EDI»;
● регистр «Журнал обмена EDI»;
● обработки «Загрузка заказов EDI», «Выгрузка ответов», «Формирование УПД».
Для начала нужно выстроить настройки событий для совершения операций, перед загрузкой «Заказа».
Настройка событий
На этапе настройки администратор задаёт путь к каталогу обмена или параметры API-сервиса (адрес, логин, пароль). Эти параметры сохраняются в регистре сведений:
Процедура УстановитьПараметрыEDI(АдресСервера, Пользователь, Пароль)
Настройки = РегистрыСведений.ПараметрыEDI.СоздатьНаборЗаписей();
Настройки.Очистить();
Запись = Настройки.Добавить();
Запись.АдресСервера = АдресСервера;
Запись.Пользователь = Пользователь;
Запись.Пароль = Пароль;
Настройки.Записать();
КонецПроцедуры
Для внесения нового реквизита нужно обратиться к разделу «При запуске», как показано ниже:
Наименование
Для новых реквизитов нужно задать наименование и тип:
EUR
После настройки система готова к приёму заказов.
Процесс загрузки заказов EDI обычно выполняется по расписанию регламентным заданием. Программа проверяет наличие новых файлов (ORDERS), преобразует их в структуру данных и создаёт документы «Заказ покупателя» или «Заказ клиента».
Процедура ЗагрузитьORDERS()
Файлы = НайтиФайлы(ПутьКФайлам, "*.xml");
Для каждого Файл Из Файлы Цикл
XML = Новый ЧтениеXML(Файл.ПолноеИмя);
Заказ = Документы.ЗаказПокупателя.СоздатьДокумент();
Заказ.Контрагент = НайтиКонтрагента(XML.ПокупательИНН);
Заказ.НомерВнешнейСистемы = XML.Номер;
Заказ.Дата = XML.Дата;
Для каждого Позиция Из XML.Товары Цикл
Стр = Заказ.Товары.Добавить();
Стр.Номенклатура = НайтиНоменклатуру(Позиция.Код);
Стр.Количество = Позиция.Количество;
КонецЦикла;
Заказ.Записать();
ПереместитьФайлВАрхив(Файл);
КонецЦикла;
КонецПроцедуры
Первым делом определяется тип заказа:
ЗаказКлиента
При этом, параметры настроек для «ORDERS», «ORDRSP» и «DESADV» должны быть идентичны:
ТипДокумента
Загруженные заказы автоматически помечаются в журнале обмена как «Приняты». Далее возможно формирование ответов ORDRSP.
2. Работа с ответом на заказ (ORDRSP) в программе 1C:Предприятие
Ответ на заказ (ORDRSP) отражает подтверждение, частичное согласие или отказ по позициям заказа. В 1С он формируется на основе документа «Заказ покупателя» или «Заказ клиента» после проверки доступности номенклатуры на складе.
Пользователь формирует документ «Ответ на заказ» по кнопке «Создать ORDRSP» в карточке заказа.
Выполнить действие
Нужно обязательно сохранить «Причины расхождений» и посмотреть, что функция элемента поменялась на «Записаны коды причин Х5».
Так можно просмотреть «ORDRP»:
Изменить
В модуле реализуется процедура формирования XML по шаблону, соответствующему требованиям EDI-провайдера:
Процедура СформироватьORDRSP(Заказ)
XML = Новый ЗаписьXML;
XML.ОткрытьФайл(Путь + Заказ.Номер + "_ORDRSP.xml");
XML.ЗаписатьНачалоЭлемента("ORDRSP");
XML.ЗаписатьАтрибут("Номер", Заказ.Номер);
XML.ЗаписатьАтрибут("Дата", Формат(ТекущаяДата(), "ДФ=yyyy-MM-dd"));
Для каждого Товар Из Заказ.Товары Цикл
XML.ЗаписатьНачалоЭлемента("LineItem");
XML.ЗаписатьАтрибут("Код", Товар.Номенклатура.Код);
XML.ЗаписатьАтрибут("Количество", Товар.Количество);
XML.ЗаписатьАтрибут("Статус", "Accepted");
XML.ЗаписатьКонецЭлемента();
КонецЦикла;
XML.ЗаписатьКонецЭлемента();
XML.Закрыть();
КонецПроцедуры
После выгрузки файл передаётся на сервер или в каталог обмена. В журнале обмена фиксируется статус «Отправлено», что позволяет контролировать синхронизацию и повторные отправки.
3. Работа с уведомлением об отгрузке (DESADV)
Документ DESADV (Dispatch Advice) уведомляет торговую сеть о фактической отгрузке товаров. В 1С он формируется на основании реализации товаров и услуг или товарной накладной, после проведения которой система получает доступ к данным по упаковкам, серийным номерам и количеству мест.
Но для создания «DESADV» нужно убрать «галочки» со следующих пунктов, а на «Уведомление об отгрузке» выбрать «Обмен с сервером»:
Уведомление об отгрузке
Палетный лист — это вложенный элемент структуры DESADV, отражающий иерархию упаковки. Формирование документа в 1С реализуется как часть процедуры выгрузки:
Процедура СформироватьDESADV(Реализация)
XML = Новый ЗаписьXML;
XML.ОткрытьФайл(Путь + Реализация.Номер + "_DESADV.xml");
XML.ЗаписатьНачалоЭлемента("DESADV");
XML.ЗаписатьАтрибут("Номер", Реализация.Номер);
XML.ЗаписатьАтрибут("Дата", Формат(Реализация.Дата, "ДФ=yyyy-MM-dd"));
Для каждого Палета Из Реализация.Палеты Цикл
XML.ЗаписатьНачалоЭлемента("Pallet");
XML.ЗаписатьАтрибут("Номер", Палета.Номер);
Для каждого Товар Из Палета.Товары Цикл
XML.ЗаписатьЭлемент("Товар", Товар.Код);
КонецЦикла;
XML.ЗаписатьКонецЭлемента();
КонецЦикла;
XML.ЗаписатьКонецЭлемента();
XML.Закрыть();
КонецПроцедуры
Наиболее частые параметры для «DESADV» отображены далее:
Наименование
После генерации файл помещается в каталог OUT, а в журнал обмена записывается событие «Уведомление об отгрузке сформировано».
4. Работа с универсальным передаточным документом (УПД)
Универсальный передаточный документ (УПД) объединяет функции счёта-фактуры и товарной накладной. В ЭДО используется два титула:
● Титул продавца — создаётся и подписывается поставщиком;
● Титул покупателя — формируется в ответ на подтверждение получения.
Модуль 1С поддерживает цепочку статусов:
«Подготовлен» → «Отправлен» → «Подписан» → «Подтверждён покупателем» → «Завершён».
Для создания УПД нужно обновить перечень «ON_SCHFDOPPR», а для отправки УПД существует кнопка «Выполнить действие»:
Выполнить действие
В управляемой форме реализуется кнопка «Сформировать УПД», вызывающая обработку:
Процедура СформироватьУПД(Реализация)
УПД = Документы.УПД.СоздатьДокумент();
УПД.Организация = Реализация.Организация;
УПД.Контрагент = Реализация.Контрагент;
УПД.Основание = Реализация.Ссылка;
УПД.Сумма = Реализация.СуммаДокумента;
УПД.Статус = "Подготовлен";
УПД.Записать();
КонецПроцедуры
После записи документ передаётся в подсистему ЭДО, где автоматически подписывается электронной подписью организации. Получатель при подтверждении формирует титул покупателя, который возвращается и привязывается к исходному документу УПД.
Статус обновляется регламентным заданием:
Если УПД.ПолученТитулПокупателя Тогда
УПД.Статус = "Подтверждён";
УПД.Записать();
КонецЕсли;
5. Дополнительные возможности программы 1С
Интеграционный модуль может быть расширен:
● Журналом событий обмена (логирование ошибок, повторные попытки отправки);
● Мониторингом документов с визуальной подсветкой статусов в управляемой форме;
● Механизмом уведомлений пользователям о поступлении заказов и УПД;
● Интеграцией с подсистемой «Задачи» для контроля ответственных лиц.
Интеграция EDI и ЭДО в управляемых формах 1С:Предприятие 8 позволяет автоматизировать весь цикл электронного взаимодействия между поставщиками и покупателями — от приёма заказов до обмена юридически значимыми документами.
Практика показывает, что внедрение такого модуля снижает ошибки операторов, сокращает время обработки заказов и повышает прозрачность документооборота.
Важнейшим условием успешной реализации является тщательная настройка параметров обмена и поддержание логики синхронизации между внутренней системой и внешними EDI-провайдерами. Таким образом, использование интеграционного модуля управляемых форм в 1С становится фундаментом современного электронного бизнеса, обеспечивая не только соответствие законодательству, но и конкурентное преимущество за счёт скорости и точности обработки данных.
Специалист компании ООО "Кодерлайн"
Лев Туренко
