СЕРВИС ИНТЕГРАЦИИ С ГИС ЭПД

1. ОБЩЕЕ ОПИСАНИЕ

Сервис интеграции с ГИС ЭПД — специализированный интеграционный программный модуль, предназначенный для взаимодействия корпоративных учетных систем с Государственной информационной системой электронных перевозочных документов (ГИС ЭПД) Минтранса РФ.

2. ПОДДЕРЖИВАЕМЫЕ ТИПЫ ПЕРЕВОЗОЧНЫХ ДОКУМЕНТОВ

Сервис обеспечивает передачу и обработку всех видов электронных перевозочных документов, предусмотренных регламентом взаимодействия с ГИС ЭПД (версии 2.0):

3. ФУНКЦИОНАЛЬНЫЕ ВОЗМОЖНОСТИ

3.1. Управление пулом уникальных идентификаторов (УИД)

• Предварительное резервирование УИД: автоматический заказ блоков идентификаторов в ГИС ЭПД через Выходной шлюз и их сохранение в локальной базе данных
• Выдача идентификаторов учетным системам: предоставление свободных УИД по запросу через REST API (/api/uids/allocate) или через шину сообщений
• Контроль состояний идентификаторов: отслеживание жизненного цикла УИД (received_from_gis, issued_to_service, consumed)
• Гарантия идемпотентности: предотвращение повторной выдачи и дублирования номеров при повторных запросах
• Поддержка присвоения УИД на стороне ГИС: возможность отправки первичных титулов без предварительного УИД с последующей фиксацией присвоенного системой номера

3.2. Прием, подготовка и отправка документов

• Загрузка пакетов: получение файлов из распределенных объектных хранилищ (S3) или по защищенным HTTP-ссылкам
• Распаковка и валидация архивов: извлечение содержимого ZIP-пакетов, автоматическая идентификация типов файлов (XML-титул, отсоединенные электронные подписи, файлы доверенностей)
• Формирование multipart-запросов: автоматическая сборка пакета данных в соответствии со спецификацией Входного шлюза ГИС ЭПД (v2/v3)
• Отправка данных: передача сформированных пакетов в ГИС ЭПД и регистрация присвоенного запросу идентификатора (RequestId)

3.3. Поддержка электронной подписи (ЭП) и доверенностей (МЧД)

• Работа с ЭП: поддержка усиленной квалифицированной (УКЭП) и усиленной неквалифицированной (УНЭП) электронных подписей в формате отсоединенных подписей
• Передача машиночитаемых доверенностей: отправка XML-файлов МЧД совместно с подписями доверителей в составе единого пакета титула

3.4. Мониторинг статусов обработки

• Фоновый опрос (Polling Worker): автоматический периодический опрос ГИС ЭПД по находящимся в обработке запросам с настраиваемой периодичностью
• Поддержка уровней детализации ответов:
  • Business — получение итогового бизнес-статуса документа
  • Verbose — получение расширенных сведений о статусах обработки и квитанциях
  • Trace — получение детальной трассировки выполнения проверок в ГИС ЭПД
• Запросы по идентификаторам: возможность проверки статуса как по номеру запроса (RequestId), так и по уникальному идентификатору документа (Uid)
• Публикация событий: отправка сообщений об изменении статуса (MQEpdRequestStatusChanged) в шину данных для обновления состояния в учетных системах

3.5. Получение QR-кодов для контроля на линии

• Запрос QR-кода: получение официального QR-кода из ГИС ЭПД по идентификатору документа (Uid)
• Передача в учетные системы: передача данных QR-кода для отображения в мобильных приложениях водителей или вывода на печать в виде сопроводительного листа

3.6. Классификация ошибок и рекомендации по их устранению

• Справочник ошибок: сопоставление кодов ошибок ГИС ЭПД с внутренней базой знаний регламентных ошибок
• Формирование рекомендаций: предоставление текстового описания причины ошибки и шагов для её исправления пользователем (например, некорректный формат файла, невалидный сертификат, дубликат документа)

4. СТАТУСНАЯ МОДЕЛЬ ДОКУМЕНТОВ

5. СПОСОБЫ ВЗАИМОДЕЙСТВИЯ И ИНТЕГРАЦИИ