Интерфейс REST для опасных грузов

Что делает интерфейс

Отправки. Интерфейс REST с JSON создаёт отправку опасного груза из вашей учётной или логистической системы и возвращает декларацию грузоотправителя, контрольный лист и маркировку упаковок, уже проверенные по применимым правилам. Ваша система хранит коммерческие данные; DGAssistant даёт знание правил и документы.

Консолидация. Интерфейс охватывает и объединение отправок нескольких грузоотправителей по двум его осям. Договорная ось — основная отправка: бронирование, морская или воздушная консолидация, дорожная сборная партия, — с её участниками, её ссылками, присоединёнными отправками, переходами состояний и историей. Физическая ось — транспортная единица (контейнер, транспортное средство, прицеп или средство пакетирования) и транспортный рейс (рейс судна, полёт или поездка) с его заходами, вместе с судами, транспортными средствами и пунктами учётной записи. Более половины службы посвящено этой части.

Открыть спецификацию интерфейса для опасных грузов

Два режима работы: пакетный и диалоговый

Пакетный. Один вызов несёт полное описание отправки со всеми её грузами. Это путь для учётных и логистических систем, которые передают уже собранные отправки.

Диалоговый. Сначала отправка открывается, затем грузы добавляются по одному. Каждый ответ несёт сообщения проверки только что добавленного, чтобы ваше приложение могло показать их пользователю во время подготовки отправки.

Заранее описанные данные или данные в самом вызове

Заранее описанные данные. Грузы и участники — грузоотправители, перевозчики, грузополучатели, погрузчики и водители — создаются заранее, а интерфейс использует их коды. Это самый простой способ работы и тот, который мы рекомендуем, потому что классификация решается один раз и повторно применяется в каждой отправке.

Данные в самом вызове. Грузы и участники описываются в том же вызове, который создаёт отправку. Это подходит системам, которые не ведут собственного каталога или отправляют опасные грузы изредка.

Документы, которые он возвращает

По каждой отправке: декларация грузоотправителя применимых правил, контрольный лист и маркировка упаковок. Они выгружаются в PDF, XLSX или DOCX либо отправляются по электронной почте прямо из службы.

Для консолидации: документы транспортной единицы, документы рейса — среди них манифест опасных грузов и уведомление капитану — и документы основной отправки.

Что проверяет интерфейс

В отправке. Разделение между грузами, перевозимыми вместе, предельные количества применимой инструкции по упаковке и режимов ограниченных и освобождённых количеств, допустимость грузов для данного вида перевозки, допустимость тары и полноту декларации. Если что-то не соблюдено, ответ называет невыполненное правило и значения, при которых оно нарушено, чтобы сообщение можно было показать в вашем приложении.

В консолидации. Разделение внутри транспортной единицы, разделение между единицами, загруженными в один рейс, расчёт порога 1.1.3.6 ДОПОГ для рейса с его расшифровкой и ограничения маршрута, возвращаемые как данные, например код ограничения проезда через туннели или наличие грузов повышенной опасности.

Охваченные правила и виды перевозки

ДОПОГ для дороги, МКМПОГ для моря, ИАТА для воздуха и 49 CFR. Три основных свода правил ведутся вместе, а не как отдельные модули, чтобы отправку, меняющую вид перевозки, не приходилось готовить заново.

Совместная упаковка, транспортные пакеты, цистерны, перевозка навалом, порожняя неочищенная тара, отходы и радиоактивные материалы класса 7 поддерживаются со всеми данными, которых каждый из них требует. Тексты документов выпускаются на девятнадцати языках.

Доступность

Служба опубликована в трёх регионах — Европа, Америка и Азиатско-Тихоокеанский регион, — у каждого свой адрес, чтобы подключение работало с тем регионом, где ведётся учётная запись. Инфраструктура зарезервирована и находится под непрерывным наблюдением.

Как начать

Запросите бесплатную двухнедельную пробную версию, а вместе с ней — учётные данные службы. Проверка подлинности использует OAuth 2.0 по схеме «client credentials»: ваша система получает маркер доступа и передаёт его в каждом запросе.

Полная спецификация опубликована в формате OpenAPI: её можно прочитать, изучить и использовать для создания клиента на вашем языке ещё до того, как будет написана первая строка кода подключения.