ЭПД и ЭТРН: как подключить интеграцию с СБИС, Астралом и Диадоком и обмениваться через ГИС ЭПД
Электронные накладные (ЭПД и ЭТРН) — это теперь норма логистики. Но вот беда: контрагент может быть на СБИС, вы на Диадоке, партнёр на Астрале, а система 1С сама по себе. Как свести всё в один поток, чтобы не прыгать между сервисами и не теряться в документах? Разбираем, как подключить интеграцию между операторами, когда нужен роуминг, а когда ГИС ЭПД, и как всё это работает с 1С и ERP.
Коротко о главном
ЭПД (электронный путевой лист) и ЭТРН (электронная транспортная накладная) — это один формат, разные названия в зависимости от оператора. В России работают под ГИС ЭПД, государственной системой, где по закону 140-ФЗ обязаны участвовать все перевозчики с 1 сентября 2026 года.
Операторы (СБИС, Диадок, Калуга Астрал, Такском, Деловые линии и другие) между собой не дружат напрямую. Чтобы обмениваться документами через разные операторы, используется либо роуминг (прямой обмен между операторами с их согласия), либо ГИС ЭПД (государственный реестр и маршрут через него). Первый быстрее, второй — обязателен для государственных грузов и работает с любым оператором.
Интеграция с 1С и ERP-системами — через стандартные API каждого оператора. Настроил один раз, и документы летят в оба места: и в личный кабинет оператора, и в систему бухгалтерии.
В этой статье
- Что такое ЭПД, ЭТРН и ГИС ЭПД
- Роуминг между операторами: как это работает
- Когда использовать ГИС ЭПД, а когда роуминг
- Интеграция ЭПД с 1С и системами учёта
- API и прямое подключение операторов
- Подвохи на интеграции и как их избежать
- Настройка шаг за шагом
Что такое ЭПД, ЭТРН и ГИС ЭПД
ЭПД и ЭТРН — один документ, у каждого оператора свой жаргон. На бумаге это накладная и путевой лист, в электронном виде — структурированные данные, которые машины могут обрабатывать автоматически. Содержимое одинаковое: груз, маршрут, перевозчик, грузоотправитель, грузополучатель, подписи.
ГИС ЭПД (государственная информационная система электронных путевых листов) — это федеральный реестр под Минтрансом, куда обязаны загружать все документы с 1 сентября 2026 года. По закону 140-ФЗ каждый перевозчик должен быть там зарегистрирован и отправлять все ЭПД и ЭТРН в систему. Не отправил — штраф, работа остановлена.
Каждый оператор (СБИС, Диадок, Контур, Астрал) подключена к ГИС ЭПД как технический партнёр. Когда вы в личном кабинете оператора подписываете и отправляете документ, оператор автоматически загружает его в ГИС и уведомляет получателя — где бы тот ни был.
Роуминг между операторами: как это работает
Роуминг — это договорное соглашение между двумя операторами ЭДО на прямой обмен документами. Когда роуминг настроен, вы отправляете документ через свой оператор, а он автоматически пересылает его другому оператору, и партнёр видит документ в своём личном кабинете.
Механика: оператор А (например, Диадок) и оператор Б (например, СБИС) подписывают соглашение. В оператор А добавляется маршрут на оператор Б. Когда из оператора А отправляется документ партнёру на оператор Б, технически документ уходит сначала в оператор А, потом по маршруту в оператор Б, потом в личный кабинет партнёра.
Диадок поддерживает роуминг с 27 операторами из 44 аккредитованных. СБИС — с большинством. Астрал — выборочно. На практике: если контрагент на популярном операторе, роуминг почти наверняка есть. Подробнее о том, какие операторы поддерживают обмен, читайте в статье про операторов ЭДО.
Сроки настройки роуминга: если оба оператора уже договорились и маршрут работает — мгновенно, как только вы найдёте контрагента по ИНН. Если маршрута нет, оператор направляет заявку другому оператору — согласование идёт до 8 рабочих дней.
ГИС ЭПД: государственный маршрут для всех
ГИС ЭПД — это не конкурент операторам, а надстройка над ними. По закону 140-ФЗ каждый оператор обязан отправлять в ГИС копию каждого электронного путевого листа. Грузоотправитель видит это по документу — сбоку отметка «Загружено в ГИС».
Механизм такой: вы подписываете в Диадоке (или СБИС, или Астрале) — оператор отправляет копию в ГИС ЭПД. Получатель может быть хоть на другом операторе, хоть в 1С, хоть в Экселе — ГИС вышлет ему уведомление, и он скачает файл оттуда. Подпись фактически одна (в Диадоке), а документ видят везде.
Главное отличие от роуминга: ГИС ЭПД работает без согласия операторов. Даже если роуминга между вашим оператором и оператором контрагента нет, документ через ГИС всё равно дойдёт.
Когда обязателен: перевозки государственных грузов, перевозки через границу, перевозки от крупных грузоотправителей (часто там в контрактах требование — обязательно через ГИС).
Нужна помощь с настройкой обмена логистическими документами между операторами? Диадок: Логистика — поддерживаем роуминг, ГИС ЭПД и интеграцию с 1С.
Интеграция ЭПД с 1С и ERP-системами
Интеграция — это когда документ одновременно летит в оператора и в 1С (или другую ERP). 1С сама по себе не включается в цепь ЭДО, это учётная система. Но она может читать документы и подготавливать их.
Вариант 1: через встроенный обмен 1С с оператором. В 1С есть готовая механика для СБИС, Диадока и некоторых других — в настройках обмена указываешь реквизиты оператора (логин, пароль, сертификат), и документы автоматически передаются туда. 1С смотрит в ОСВ и накладные в регистре, готовит структурированные файлы и отправляет. Обратно — скачивает подписанные версии.
Вариант 2: через API оператора. Оператор предоставляет API (часто REST или SOAP), компания или интегратор пишет скрипт, который вытаскивает данные из 1С, форматирует в XML по стандарту оператора и отправляет. Ответное письмо — когда контрагент подписал, скрипт скачивает и загружает в 1С обратно.
Вариант 3: через третьи платформы интеграции (например, MuleSoft, Zapier). Они уже знают форматы, и интегратор просто соединяет источник (1С) и приёмник (оператор).
Сложность: не всякая версия 1С поддерживает обмен. 1С 8.3 — есть, 1С 7.7 — нет. Нужно обновиться или писать интеграцию на стороне.
API и прямое подключение: когда вы в управлении сами
Каждый крупный оператор выкладывает API и документацию. СБИС, Диадок, Астрал, Такском — у всех есть. Через API вы отправляете документ программно, не открывая личный кабинет.
Типичный сценарий: ваша система (ERP, WMS, TMS) готовит файл ЭПД в XML по формату оператора, отправляет через API с сертификатом, получает обратно статус отправки, потом переодически запрашивает статус подписания. Когда контрагент подписал, API возвращает подписанный файл, система загружает его себе.
Плюсы API: полная автоматизация, сроки предсказуемы, нет ручной работы, масштабируется на сотни и тысячи документов в день.
Минусы: нужен разработчик, который знает XML и протокол конкретного оператора, документация у операторов местами неполная, версии API могут отличаться.
Основные API-операторы:
- СБИС — REST API с авторизацией через сертификат или токен, хорошо документирован.
- Диадок — REST API, поддерживает как КЭП юрлица, так и КЭП физлица с МЧД, тестовый сервер есть.
- Калуга Астрал — SOAP API и REST, требует подключение через их IP и сертификат.
- Такском — API через личный кабинет, документация скуповата.
Подвохи на интеграции и как их избежать
На практике интеграция часто падает на первой же попытке. Вот что срабатывает:
- Несовместимость версий форматов. ЭТРН между операторами может быть разных версий (140 от Минтранса обновляется ежегодно), и если один оператор на версии 2025, а другой ещё на 2024, файл не пройдёт валидацию. Решение: всегда проверяй версию, которую поддерживает оператор контрагента.
- Неверный сертификат подписи. КЭП юрлица работает не везде (часто только у своего оператора). КЭП физлица + МЧД — универсальнее, но нужно настроить полномочия в доверенности и убедиться, что они покрывают документ. Отказ по подписи — самая частая ошибка.
- Грузоотправитель и грузополучатель по-разному указаны. В вашей 1С — ООО «Рога и Копыта», в ГИС ЭПД надо точно как в ЕГРЮЛ. Несовпадение — отказ.
- Роуминг не настроен, а вы уже отправляете. Документ повиснет в статусе «отправлен», а получатель его не видит. Перед первой отправкой проверь, активен ли роуминг или надо опираться на ГИС.
- В 1С не настроена квалифицированная подпись. 1С должна иметь доступ к сертификату (через CryptoPro или другой контейнер), иначе подписать документ не сможет. Часто попадают: сертификат на локальной машине, а 1С на сервере.
- Роуминг между операторами не поднимается уже неделю. Обычно это значит, что заявка в одном операторе зависла. Решение: напомни техподдержке второго оператора, дай им реквизиты первого и перечень документов на обмен.
Как настроить интеграцию: пошагово
Сценарий 1: роуминг между двумя операторами (простейший случай)
Шаг 1. Узнайте, поддерживает ли ваш оператор роуминг с оператором контрагента. На сайте оператора ищите раздел «Статусы роуминга» или «Маршруты». Там список компаний-партнёров и статус связи.
Шаг 2. Если роуминг есть и активен, достаточно найти контрагента по ИНН в системе вашего оператора и отправить приглашение к обмену. Контрагент получит уведомление в своём личном кабинете.
Шаг 3. Контрагент подтверждает приглашение. Статус переходит в «активен». Теперь можно отправлять первый ЭПД.
Шаг 4. Отправьте тестовый документ. Проверьте статус в личном кабинете и убедитесь, что контрагент его получил.
Сценарий 2: интеграция 1С с оператором через встроенный обмен
Шаг 1. В 1С откройте раздел «Обмен данными» (меню зависит от версии и конфигурации). Создайте новое подключение к оператору.
Шаг 2. Введите реквизиты: адрес сервера оператора, логин, пароль или путь к сертификату. Если оператор требует IP-фильтр, согласуйте со своим администратором сервера.
Шаг 3. Загрузите в 1С документ (накладную, путевой лист), согласно формату оператора. 1С подготовит файл в требуемом XML и отправит.
Шаг 4. Дождитесь подписания контрагентом. 1С регулярно опрашивает оператора о статусе (настраивается в параметрах). Когда документ подписан, 1С загружает его обратно.
Сценарий 3: прямое подключение через API
Шаг 1. Заказ интеграцию у разработчика или интегратора. Они получат от оператора документацию на API, тестовые реквизиты и песочницу.
Шаг 2. Разработчик в своей системе (WMS, TMS, ERP или кастомный скрипт) подготавливает документ в формате оператора, инициирует подключение к API с вашим сертификатом.
Шаг 3. Тестирование в песочнице. Отправляется несколько фиктивных документов, проверяется корректность ответов, статусы подписания.
Шаг 4. После одобрения — переход в боевое окружение. Документы начинают ходить по-настоящему.
Часто задаваемые вопросы
Итог
Интеграция ЭПД между операторами — это не черная магия, а логичная система с двумя маршрутами. Если контрагент на другом операторе и между операторами есть роуминг, документ дойдёт прямым путём в его личный кабинет. Если роуминга нет или вы работаете с госструктурой, опираетесь на ГИС ЭПД — через неё всё равно дойдёт.
С 1С и ERP проще, чем кажется: либо встроенный обмен (если оператор его поддерживает), либо интеграция через API (если есть разработчик). Главное — настроить один раз и позволить системам разговаривать друг с другом без вашего участия.
Перед первой интеграцией: проверьте, поддерживает ли ваш оператор роуминг с контрагентом, согласуйте версию формата ЭПД (140 на 2025 или 2026), убедитесь, что сертификат подписи везде одинаковый, и дайте системам время на синхронизацию. Тогда всё встанет на место.