ЭДО: Такском, Контур.Диадок, ЭДО Лайт

Электронный документооборот заменяет бумажные акты, УПД и счета-фактуры юридически значимыми электронными документами с квалифицированной подписью. Подключить сайт на 1С-Битрикс к операторам Такском, Контур.Диадок и к сервису ЭДО Лайт можно через их API и роуминг между операторами.

Что такое ЭДО и зачем он в связке с сайтом

ЭДО — это обмен юридически значимыми документами между контрагентами через оператора электронного документооборота. Документ подписывается усиленной квалифицированной электронной подписью (УКЭП), а оператор фиксирует факт и время передачи. Для формализованных документов (УПД, счёт-фактура) ФНС устанавливает обязательный XML-формат.

Зачем это интеграции сайта на Битрикс:

• После отгрузки B2B-заказа контрагенту нужно отправить закрывающие документы — их можно формировать и отправлять из системы автоматически;
• Статусы документов (получен, подписан, отклонён) возвращаются в CRM и связываются с заказом;
• Уходит бумажный оборот, курьеры и потери оригиналов;
• Документы хранятся у оператора и юридически значимы без распечатки.

Такском, Контур.Диадок и ЭДО Лайт: чем различаются

Все три решают задачу обмена документами, но занимают разные ниши.

Принципиальный момент — роуминг: контрагенты могут быть у разных операторов, и документ проходит между ними по межоператорскому обмену. Поэтому интеграция обычно делается с вашим оператором, а до контрагента документ доходит независимо от того, где он обслуживается.

Электронная подпись и требования к документам

Юридическую значимость документу придаёт квалифицированная подпись. Для формализованных документов подпись должна соответствовать требованиям ФНС, а сам документ — утверждённому XML-формату. Это накладывает ограничения на интеграцию:

• УКЭП выпускается удостоверяющим центром на конкретное лицо организации;
• Подпись обычно ставится на стороне, где есть доступ к сертификату и криптопровайдеру (например КриптоПро), а не на публичном веб-сервере;
• Формализованные документы (УПД, счёт-фактура) должны строго соответствовать XML-схеме ФНС, иначе оператор их не примет;
• Неформализованные документы (договоры, акты в свободной форме) допускают PDF, но также подписываются УКЭП.

На практике сайт чаще всего готовит данные документа, а формирование корректного XML и подписание отдаёт на сторону 1С или самого оператора через их API.

Архитектура интеграции на 1С-Битрикс

Интеграцию с оператором ЭДО собирают как отдельный модуль, работающий с API по токену/сертификату. Типовой поток «отправка закрывающих документов»:

1. Заказ переходит в статус «отгружен» — событие инициирует формирование документа;
2. Модуль собирает данные сделки: контрагент, позиции, суммы, реквизиты;
3. Документ формируется в нужном формате (XML для формализованных) на сайте или в 1С;
4. Через API оператора документ отправляется контрагенту, при необходимости после подписания УКЭП;
5. Оператор возвращает идентификатор документа и статусы, которые модуль пишет в заказ.

Обратный поток статусов удобно принимать по вебхуку оператора либо периодически опрашивать методом получения списка изменений. Пример вызова через HTTP-клиент Битрикса:

$http = new Bitrix\Main\Web\HttpClient();
$http->setHeader('Authorization', $edoToken);
$resp = $http->post($edoApi.'/documents/send', $payload);

• Идентификатор документа оператора храните в свойстве заказа — по нему сверяются статусы;
• Логируйте каждую отправку и смену статуса;
• Предусмотрите обработку отклонения: контрагент может вернуть документ на уточнение.

Роуминг, статусы и жизненный цикл документа

Электронный документ проходит несколько состояний, и их корректная обработка — половина успеха интеграции. Для формализованного документа с обязательным ответным титулом цикл сложнее, чем «отправил—получил».

Если контрагент обслуживается у другого оператора, включается роуминг — межоператорский обмен. Для интеграции это прозрачно: вы работаете с API своего оператора, а он маршрутизирует документ. Но задержки роуминга стоит учитывать в логике таймаутов и напоминаний.

Частые сложности и как их избежать

Внедрение ЭДО чаще спотыкается не на коде, а на форматах и организационных нюансах. Что стоит учесть заранее:

• Несоответствие XML-схеме ФНС — оператор отклонит документ; формирование формализованных документов лучше доверить 1С или проверять по актуальной схеме;
• Разные операторы у контрагентов — проверяйте готовность роуминга, иногда его нужно предварительно настроить;
• Отсутствие приглашения к обмену — до отправки документов контрагенты должны установить связь (обменяться приглашениями) в системе оператора;
• Ошибки подписи — истёкший сертификат УКЭП блокирует отправку, нужен мониторинг срока действия;
• Рассинхрон статусов — без регулярной сверки статусы в CRM отстают от реальных.

Итог

Интеграция сайта на 1С-Битрикс с операторами ЭДО — Такском, Контур.Диадок, ЭДО Лайт — автоматизирует отправку закрывающих документов по B2B-заказам и возврат их статусов в CRM. Ключевые условия: корректный формат формализованных документов по схеме ФНС, безопасное подписание УКЭП вне веб-сервера и аккуратная обработка жизненного цикла с учётом роуминга и ответных титулов.

Мы проектируем интеграцию как отдельный модуль, связывающий сайт, оператора ЭДО и 1С, где формируются и подписываются документы, а в CRM подтягиваются статусы. Если нужно перевести обмен документами с контрагентами в электронный вид без ручной выгрузки, поможем выстроить процесс под вашего оператора и учётную систему.