Сценарий работы с ЭТРН
В этом блоке рассмотрим сценарии взаимодействия интеграции, LSS.Monitor и оператора ЭТРН.
Для более сложных кейсов взаимодействия обратитесь в команду внедрения за консультацией по реализации.
Титулы ЭТРН можно загрузить в любой момент: при создании волны или через факт обновления данных.
Последний загруженный титул отображается в мобильном приложении исполнителя и считается актуальным. Также на мобильное устройство можно загрузить актуальный
QR-код .gif и ЭТРН в формате .pdf.
Все статусы логист также может посмотреть в веб-интерфейсе Monitor.
Мобильное приложение исполнителя не запрещает завершать деманды без проставленного актуального титула.
Отслеживание и своевременная загрузка титулов ЭТРН и QR-кодов для перевозки — ответственность интеграции.
Последовательность действий
Базовый сценарий T1, T2, T3, T4
Для сценария ниже считаем, что:
- Волна загружена, запущена и отправлена на исполнение, подписанных ЭТРН в ней нет.
- Интеграционный модуль подписан на эту волну.
- В интеграционном модуле есть ключ УКЭП, с помощью которого происходит подписание документов у оператора ЭТРН.
Как правильно подписаться на изменения, описано в документе.
Волну можно загрузить с уже подписанными ЭТРН order:key.cargo.invoice.waybill.status = T1.
| Шаг | Действие | Инициатор | Взаимодействие |
|---|---|---|---|
| 1. | Интеграционный модуль опрашивает Оператора ЭТРН на наличие подписанных ЭТРН T1. | Интеграционный модуль | Интеграционный модуль → Оператор ЭТРН |
| 2. | Интеграционный модуль создает факты на Серверной части Monitor для каждого заказа с получением T1. | Интеграционный модуль | Интеграционный модуль → Серверная часть Monitor |
| 3. | Серверная часть Monitor применяет факты к волне. Данные загружаются в Мобильное приложение, где отображается статус T1. | Серверная часть Monitor | Серверная часть Monitor → Мобильное приложение |
| 4. | Исполнитель на погрузке устанавливает статус DEMAND_DONE для PICKUP. Мобильное приложение отправляет факт погрузки на сервер. | Мобильное приложение | Мобильное приложение → Серверная часть Monitor |
| 5. | Серверная часть Monitor применяет факты к волне и оповещает Интеграционный модуль по подписке о новых фактах. | Серверная часть Monitor | Серверная часть Monitor → Интеграционный модуль |
| 6. | Интеграционный модуль скачивает необходимые факты по заказам и передает Оператору ЭТРН статус T2. | Интеграционный модуль | Интеграционный модуль → Оператор ЭТРН |
| 7. | Оператор ЭТРН подтверждает подписание T2. Интеграционный модуль выгружает ЭТРН в формате .pdf и QR-код для перевозки, после чего генерирует факт для заказа с титулом T2 и ссылками на документы. | Интеграционный модуль | Интеграционный модуль → Серверная часть Monitor |
| 8. | Серверная часть Monitor применяет факты к волне. Данные загружаются в Мобильное приложение: отображается статус T2 и появляется возможность скачать сопроводительные документы. | Серверная часть Monitor | Серверная часть Monitor → Мобильное приложение |
| 9. | Интеграционный модуль опрашивает Оператора ЭТРН на наличие подписанных ЭТРН T3. | Интеграционный модуль | Интеграционный модуль → Оператор ЭТРН |
| 10. | Интеграционный модуль создает факты на Серверной части Monitor для каждого заказа с получением T3. | Интеграционный модуль | Интеграционный модуль → Серверная часть Monitor |
| 11. | Серверная часть Monitor применяет факты к волне. Данные загружаются в Мобильное приложение, где отображается статус T3. | Серверная часть Monitor | Серверная часть Monitor → Мобильное приложение |
| 12. | Исполнитель на выгрузке устанавливает статус DEMAND_DONE для DROP. Мобильное приложение отправляет факт выгрузки на сервер. | Мобильное приложение | Мобильное приложение → Серверная часть Monitor |
| 13. | Серверная часть Monitor применяет факты к волне и оповещает Интеграционный модуль по подписке о новых фактах. | Серверная часть Monitor | Серверная часть Monitor → Интеграционный модуль |
| 14. | Интеграционный модуль скачивает необходимые факты по заказам и передает Оператору ЭТРН статус T4. | Интеграционный модуль | Интеграционный модуль → Оператор ЭТРН |
| 15. | Оператор ЭТРН подтверждает подписание T4. Интеграционный модуль генерирует факт для заказа с титулом T4. | Интеграционный модуль | Интеграционный модуль → Серверная часть Monitor |
Важно: документация будет дополнена после реализации методов для поддержки титулов T7, T8.