Меня зовут Максим, я веб-разработчик. С 2024–2025 годов электронный документооборот (ЭДО) из «удобной опции» превратился в обязательное требование для всё большего числа бизнесов. Электронные счета-фактуры, УПД нового формата 5.03, электронные транспортные накладные (ЭТрН), электронные путевые листы — всё это нужно не только уметь формировать, но и интегрировать в бизнес-процессы, в том числе на сайте. Если ваш интернет-магазин или B2B-портал до сих пор работает с бумажными документами — пора менять подход. Расскажу, как я интегрирую ЭДО в веб-проекты.

Что изменилось в 2024–2026

УПД формата 5.03

Универсальный передаточный документ (УПД) — основной документ для оформления поставок товаров и услуг. С 2024 года ФНС утвердила новый формат 5.03, который заменяет старые форматы счетов-фактур и актов.

Что изменилось в 5.03:

  • Новые обязательные поля: идентификатор государственного контракта, код вида товара по ТН ВЭД (для экспорта), дополнительные сведения о прослеживаемости товаров
  • Поддержка маркировки (коды Data Matrix для прослеживаемых товаров)
  • Обязательная машиночитаемая структура (XML)

Для интернет-магазинов и B2B-порталов: если вы формируете УПД при отгрузке товара — нужно перейти на формат 5.03. Старые форматы будут приниматься ФНС всё с большими ограничениями.

Электронные транспортные накладные (ЭТрН)

С 2024 года электронные транспортные накладные стали обязательными для перевозок отдельных категорий грузов. С 2025 года — расширение обязательности. ЭТрН формируется через оператора ЭДО и подписывается УКЭП (усиленной квалифицированной электронной подписью) всех участников: грузоотправитель → перевозчик → грузополучатель.

Для бизнеса с доставкой: если вы отправляете товары собственным транспортом или через перевозчика — ЭТрН уже актуальна или станет актуальной в ближайшие месяцы.

Электронные путевые листы

С 1 марта 2025 года — возможность оформления путевых листов в электронном виде. Пока добровольно, но тренд к обязательности очевиден.

Зачем интегрировать ЭДО в сайт

Классическая схема ЭДО: бухгалтер формирует документы в 1С → отправляет через оператора ЭДО (Диадок, СБИС, Контур) → контрагент подписывает. Сайт в этой цепочке не участвует.

Но для автоматизированного бизнеса — сайт должен быть частью процесса:

Интернет-магазин. Клиент оформил заказ → сайт автоматически формирует УПД → отправляет через ЭДО → клиент подписывает в личном кабинете или через оператора. Без участия бухгалтера.

B2B-портал. Оптовый клиент сделал заказ через личный кабинет → система формирует УПД, транспортную накладную, счёт → отправляет по ЭДО → клиент видит документы в личном кабинете с возможностью подписания.

Маркетплейс. Селлер загрузил товар → маркетплейс оформил продажу → автоматически сформированы все документы → отправлены покупателю и селлеру.

Как я интегрирую ЭДО в веб-проекты

Архитектура

Сайт не работает с ЭДО напрямую — между ними стоит «прослойка»: оператор ЭДО (Диадок/Контур.Диадок, СБИС, Тензор, Калуга Астрал) или 1С.

Два основных варианта:

Вариант 1: Сайт → 1С → Оператор ЭДО.

Сайт формирует заказ → данные уходят в 1С → 1С формирует УПД → 1С отправляет через встроенный модуль ЭДО (1С-ЭДО, Диадок для 1С).

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

Вариант 2: Сайт → API оператора ЭДО напрямую.

Сайт формирует XML-документ в формате 5.03 → отправляет через API оператора ЭДО → контрагент получает и подписывает.

Плюсы: мгновенная отправка, нет зависимости от 1С. Минусы: нужно формировать корректный XML (сложная структура), нужна УКЭП на сервере для подписания.

Я обычно использую Вариант 1 для компаний, где 1С — центральная система. Вариант 2 — для маркетплейсов и SaaS, где 1С отсутствует или второстепенна.

API операторов ЭДО

Контур.Диадок API. REST API для отправки и получения документов. Поддерживает: формирование документов, подписание, отслеживание статуса, загрузку подписанных документов.

СБИС API. Аналогичный функционал. Хорошая документация, SDK для Python и .NET (для Node.js — через REST).

Тензор API. Ещё один оператор с API-доступом.

Все операторы работают по единому стандарту ФНС для форматов документов, но API у каждого — свой.

Формирование УПД 5.03

XML-структура УПД 5.03 регламентирована ФНС (приказ от 19.12.2023 № ЕД-7-26/970@). Это сложный XML с десятками обязательных полей:

  • Реквизиты продавца и покупателя (ИНН, КПП, наименование, адрес)
  • Номер и дата документа
  • Сведения о товарах/услугах (наименование, количество, цена, ставка НДС, сумма)
  • Коды маркировки (если товар прослеживаемый)
  • Идентификатор госконтракта (если применимо)

Для формирования я использую: XML-библиотеки Node.js (xmlbuilder2) + валидация XSD-схемой ФНС. Каждый документ проверяется на соответствие схеме перед отправкой.

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

Для подписания документов через API нужна УКЭП (усиленная квалифицированная электронная подпись) организации, установленная на сервере.

Технически: КриптоПро CSP на сервере + контейнер с закрытым ключом. При формировании документа — сервер подписывает XML, формирует файл подписи (PKCS#7), отправляет оператору ЭДО вместе с документом.

Безопасность: закрытый ключ хранится в защищённом контейнере, доступ — только серверному процессу. Логирование всех операций подписания.

Личный кабинет клиента с документами

В B2B-портале: раздел «Документы» в личном кабинете клиента. Клиент видит:

  • Список документов (УПД, счета-фактуры, акты, ТрН) с фильтрами по дате и типу
  • Статус каждого документа: отправлен → получен → подписан / отклонён
  • Возможность скачать PDF-копию
  • Кнопка «Подписать» (для тех операторов, которые поддерживают подписание через веб-интерфейс)

Данные подтягиваются из 1С или от оператора ЭДО через API.

Маркировка товаров и ЭДО

Отдельная тема — связка ЭДО с системой маркировки «Честный знак». Для категорий товаров, подлежащих обязательной маркировке (молочная продукция, вода, пиво, табак, обувь, одежда, шины, парфюмерия, БАДы и др.), в УПД обязательно указываются коды Data Matrix.

Для интернет-магазинов: при отгрузке товара с маркировкой — коды сканируются, включаются в УПД, и информация автоматически передаётся в «Честный знак» через оператора ЭДО.

Техническая интеграция: API «Честного знака» (GS1 RUS) для проверки и передачи кодов + включение кодов в XML УПД.

Стоимость интеграции ЭДО

Базовая интеграция (сайт → 1С → ЭДО, автоматическое формирование УПД при заказе). Срок: 2–4 недели. Бюджет: 100–250 тысяч рублей.

Полноценная интеграция (API оператора ЭДО, серверная подпись, личный кабинет с документами, маркировка). Срок: 1–3 месяца. Бюджет: 300–800 тысяч рублей.

Подписка на оператора ЭДО: от 2 000 до 15 000 рублей в месяц (зависит от объёма документов).

КриптоПро CSP: лицензия от 2 700 рублей + УКЭП от 1 500 рублей в год.

Что в итоге

ЭДО — это не «когда-нибудь потом». Для многих бизнесов это уже обязательное требование. Для остальных — вопрос времени. Чем раньше вы интегрируете ЭДО в свои бизнес-процессы (включая сайт) — тем меньше головной боли при очередном ужесточении требований.

Если нужна помощь с интеграцией ЭДО на вашем сайте — обращайтесь.