Интеграция 1С:ERP с API СБИС: кастомный обмен ЭДО и автоматизация ЭТРН

Постановка задачи

Заказчик: Крупное производственное/логистическое предприятие, использующее «1С:ERP Управление предприятием».

Исходная ситуация и ограничения: Компания активно использует оператора ЭДО СБИС для обмена юридически значимыми документами. Однако стандартные модули интеграции (внешние обработки), предоставляемые оператором СБИС, не могут быть использованы в силу следующих причин:

• Высокая кастомизация ERP: Конфигурация 1С глубоко переписана под бизнес-процессы заказчика.
• Собственный модуль доставки: В системе реализован уникальный функционал управления логистикой, который не пересекается со стандартными объектами типовой конфигурации.
• Специфические цепочки документов: Процесс отгрузки неразрывно связан с внутренними статусами собственного модуля доставки, что требует сложной логики маппинга данных при отправке во внешнюю систему.

Цель проекта: Обеспечить бесшовный двусторонний обмен электронными документами между доработанной 1С:ERP и API оператора СБИС, полностью исключив ручной труд и использование сторонних промежуточных обработок.

Задачи реализации

1. Разработка серверного ядра взаимодействия (API-клиент)

1. Реализовать механизмы авторизации в сервисе СБИС (получение токенов сессий).
2. Разработать универсальные методы формирования HTTP-запросов к JSON-RPC эндпоинтам СБИС (ЗаписатьДокумент, СписокИзменений и т.д.).
3. Обеспечить обработку сетевых ошибок, таймаутов и парсинг ответов сервера для корректной записи статусов в базу 1С.

2. Интеграция с входящими и исходящими документами

1. Написать алгоритмы генерации XML-файлов соответствующего формата на основе данных из сильно измененных объектов 1С:ЕРП.
2. Реализовать сборку структуры JSON-пакета согласно требованиям API СБИС, включая вложение бинарных данных сформированного файла.
3. Настроить привязку идентификаторов электронного документа СБИС к объектам 1С.

3. Автоматизация работы с Электронными транспортными накладными (ЭТРН)

1. Поскольку используется собственный модуль доставки, необходимо реализовать формирование специфических титулов ЭТРН, извлекая данные о водителях, ТС и маршрутах напрямую из уникальных регистров или справочников модуля доставки заказчика.
2. Реализовать динамическое создание контрагентов (перевозчиков) по ИНН прямо в момент получения входящей ЭТРН, если они отсутствуют в базе.

4. Фоновый мониторинг входящих событий (Загрузка статусов)

1. Разработать регламентное задание, которое будет опрашивать метод СБИС.СписокИзменений.
2. Система должна автоматически отслеживать подписание документов контрагентами, получение отказов в подписи и ошибки маршрутизации.
3. При получении новых входящих документов (например, актов от поставщиков или ответных титулов по ЭТРН) система должна сопоставлять их с существующими заказами 1С по номерам или создавать черновики уведомлений ответственным лицам.

5. Пользовательский интерфейс (АРМ сотрудника)

1. Создать единую форму рабочего места, где сотрудники смогут видеть реестры реализаций, договоров и транспортных операций с актуальными статусами ЭДО.
2. Реализовать ручную принудительную отправку документов и возможность просмотра полученного XML/E-архива непосредственно из интерфейса 1С без перехода в веб-кабинет СБИС.

Ожидаемый результат

Единая информационная среда, в которой жизненный цикл физической доставки груза внутри собственной подсистемы 1С зеркально отражается в электронном документообороте СБИС. Исключены двойные вводы данных, минимизированы риски потери документов и обеспечена полная прозрачность движения грузов и финансов для всех участников цепи поставок.

Сложности и риски проекта

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

1. Несоответствие документации СБИС реальному функционалу (Shadow API)

Официальная документация оператора ЭДО содержала неточности или не отражала специфику поведения системы при передаче определенных бизнес-сценариев (особенно касающихся цепочек ЭТРН).

2. Изменение работы API в процессе реализации («Живая» интеграция)

Разработка велась параллельно с обновлением платформы СБИС. В середине цикла разработки оператор изменил логику обработки титулов ЭТРН и форматы возвращаемых идентификаторов документов.

3. Сложность тестирования и ограничения тестового контура

Одной из главных проблем стала невозможность полноценной эмуляции сквозного процесса обмена документами.

• Проблема: Тестовый контур (sandbox) СБИС работает изолированно: документ, отправленный из 1С, виден только в личном кабинете теста и никогда не доходит до реального контрагента. Однако логика проверки корректности заполнения выполняется именно при отправке документа контрагенту.
• Решение команды: Реализация дополнительных этапов проверки корректности заполнения документов и увеличение уровня логирования процесса обмена, что позволило оперативно выявлять и решать проблемы.