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

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

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

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

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

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

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

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

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

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

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

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

API возвращает те же документы, которые формирует приложение. Документы отправки и консолидации выгружаются в PDF, XLSX или DOCX, документы отправки можно также отправить по электронной почте прямо из службы; документы транспортной накладной — в PDF.

• По каждой отправке: транспортный документ применимых правил —транспортный документ ДОПОГ, декларация ИМО об опасных грузах или мультимодальная форма МКМПОГ и декларация грузоотправителя ИАТА—, контрольный перечень, маркировка упаковок в полном размере или в малом пользовательском размере, а при воздушной перевозке — лист данных для авиагрузовой накладной.
• По основной отправке: консолидированный манифест, список контейнеров, упаковочный лист каждой единицы, погрузочная ведомость по грузоотправителям и лист данных основного документа.
• По транспортной единице: свидетельство о загрузке контейнера или транспортного средства, мультимодальная форма для опасных грузов, отчёт о разделении единицы, контрольный перечень перед подписанием свидетельства и консолидационная этикетка.
• По рейсу: манифест опасных грузов, отчёт о разделении между единицами на борту, отчёт о пороге изъятия по ДОПОГ 1.1.3.6, лист ограничений рейса, погрузочная ведомость, уведомление командиру воздушного судна (NOTOC) и консолидированный транспортный документ транспортного средства.
• По транспортной накладной: черновик, подписанный экземпляр, приложенный транспортный документ ДОПОГ и доказательственный отчёт.

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

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

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

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

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

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

Доступность

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

Как начать

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

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