Интеграция ЭТрН по API — это не «подключить документы», а встроить чужой документооборот в свой процесс. Ниже — практический чек-лист, что выяснить и что заложить, прежде чем начинать проект.
Когда это нужно
Ориентир простой: при сотнях документов в день без API или модуля для учётной системы работа превращается в ручной труд оператора. До этого порога интерфейса сервиса обычно достаточно.
Второй признак — когда данные для накладной уже есть в вашей системе. Если заказ содержит стороны, груз, маршрут и ТС, заполнять то же самое второй раз в чужом интерфейсе бессмысленно.
Что должен закрывать API
| Функция | Зачем |
|---|---|
| Формирование документа | Накладная собирается из данных заказа |
| Отправка, в том числе массовая | Поштучная отправка на объёме не работает |
| Подписание | Титулы должны закрываться из вашего контура |
| Получение статусов | Без обратной связи вы не знаете, закрыт ли рейс |
| Сценарии отклонений | Переадресовка, замена ТС, расхождения, аннулирование |
| Справочники и роуминг | Проверка контрагентов и готовности обмена |
Последние две строки — то, что чаще всего забывают на этапе выбора и болезненно обнаруживают на этапе эксплуатации.
Вопросы оператору
- Есть ли готовый модуль под нашу систему — или только «голый» API?
- Насколько полна документация и есть ли тестовый контур?
- Поддерживаются ли массовые операции и групповая отправка?
- Как передаются статусы — опрос или уведомления?
- Как реализованы отклонения: переадресовка, замена ТС, расхождения, аннулирование?
- Какое покрытие роуминга по нашим контрагентам, по конкретным парам?
- Что происходит при смене оператора — как выгружается архив?
Что заложить в проект
- Мастер-данные. Контрагенты, адреса, ТС, водители, доверенности. Грязные справочники на объёме дают поток переоформлений — это не «доработаем позже», а предусловие.
- Матрица ролей. Кто отправитель, перевозчик, получатель в каждом типе рейса и кто подписывает титулы.
- Мониторинг незакрытых титулов. На сотнях рейсов застрявший документ невозможно заметить глазами — нужен отчёт или дашборд.
- Отклонения как основной сценарий. На объёме переадресовки и расхождения происходят ежедневно. Если они не автоматизированы, ручная работа никуда не денется — просто переедет в другое место.
- Переходный период. Часть контрагентов не будет готова к сроку; нужен рабочий обходной путь.
Про входящий поток
API решает исходящее направление: вы формируете и отправляете документы из своей системы. Но половина документооборота приходит извне — от перевозчиков, отправителей, получателей, и приходит она вразнобой: через операторов, почтой, фотографиями.
SLAI собирает входящие документы из любых каналов, распознаёт их, приводит к единой структуре и проверяет комплектность по рейсу — чтобы интегрированный контур получал выверенные данные с обеих сторон, а не только с той, которую вы контролируете.