Přejít na obsah

REST API pro nebezpečné věci

REST API DGAssistant ve formátu JSON vytváří zásilky nebezpečných věcí z vašeho podnikového nebo logistického systému a vrací deklaraci odesilatele, kontrolní seznam a označení kusů, ověřené podle příslušného předpisu. Je určeno společnostem, které tyto doklady začleňují do svého systému ERP, a pokrývá i konsolidaci.

Co API umí

Propojení DGAssistant s podnikovým informačním systémem

Zásilky. REST API DGAssistant ve formátu JSON vytvoří zásilku nebezpečných věcí z vašeho vlastního podnikového nebo logistického systému a vrátí deklaraci odesilatele, kontrolní seznam a označení kusů, již ověřené podle příslušného předpisu. Váš systém uchovává obchodní údaje; DGAssistant dodává znalost předpisů a dokumenty.

Konsolidace. API pokrývá také seskupování zásilek od více odesilatelů, a to v obou jeho osách. Smluvní osou je hlavní zásilka — rezervace, námořní nebo letecká konsolidace, silniční sběrná přeprava — s jejími účastníky, referencemi, připojenými zásilkami, přechody mezi stavy a historií. Fyzickou osou je přepravní zařízení (kontejner, vozidlo, přípojné vozidlo nebo jednotkové nákladové zařízení ULD) a přeprava (námořní cesta, let nebo jízda) s jejími zastávkami, spolu s plavidly, vozidly a místy vedenými v účtu. Této části je věnována více než polovina služby.

Otevřít specifikaci API pro nebezpečné věci

Dva způsoby práce: dávkový a interaktivní

Dávkový režim. Jediné volání obsahuje úplnou specifikaci zásilky se všemi jejími věcmi. Tento způsob je určen pro podnikové a logistické systémy, které odesílají celé zásilky již sestavené.

Interaktivní režim. Nejprve se otevře zásilka a věci se přidávají jedna po druhé. Každá odpověď obsahuje validační zprávy k tomu, co bylo právě přidáno, takže je vaše vlastní aplikace může zobrazit uživateli již během přípravy zásilky.

Předdefinovaná data nebo data zadaná za běhu

Předdefinovaná data. Produkty a účastníci — odesilatelé, dopravci, příjemci, nakládci a řidiči — se vytvoří předem a API používá jejich kódy. Je to nejjednodušší způsob práce a ten, který doporučujeme, protože klasifikace podle předpisů se stanoví jednou a znovu se použije v každé zásilce.

Data zadaná za běhu. Produkty a účastníci se definují v témže volání, které vytváří zásilku. Tento způsob se hodí pro systémy, které nevedou vlastní katalog nebo které odesílají věci jen příležitostně.

Dokumenty, které API vrací

API vrací tytéž dokumenty, které vytváří aplikace. Dokumenty zásilky a konsolidace lze získat ve formátu PDF, XLSX nebo DOCX a dokumenty zásilky lze navíc odeslat e-mailem přímo ze služby; dokumenty nákladního listu jsou k dispozici ve formátu PDF.

  • Pro každou zásilku: přepravní doklad podle příslušného předpisu – přepravní doklad ADR, prohlášení o nebezpečných věcech IMO nebo multimodální formulář IMDG a deklarace odesilatele IATA –, kontrolní seznam, označení kusů v plné velikosti nebo v malé uživatelské velikosti a u letecké přepravy datový list pro letecký nákladní list.
  • Pro hlavní zásilku: konsolidační manifest, seznam kontejnerů, balicí list každé jednotky, nakládací list podle odesilatelů a datový list hlavního dokladu.
  • Pro dopravní jednotku: osvědčení o naložení kontejneru nebo vozidla, multimodální formulář pro nebezpečné věci, souhrn nebezpečných věcí v jednotce, kontrolní seznam před podpisem osvědčení a štítek konsolidace.
  • Pro přepravu: manifest nebezpečných věcí, zpráva o oddělování mezi jednotkami na palubě, zpráva o mezní hodnotě výjimky podle ADR 1.1.3.6, list omezení jízdy, nakládací list, oznámení veliteli letadla (NOTOC) a souhrnný přepravní doklad vozidla.
  • Pro nákladní list: návrh, podepsané vyhotovení, připojený přepravní doklad ADR a důkazní protokol.

Co API ověřuje

V zásilce. Oddělování mezi společně přepravovanými věcmi, množstevní limity příslušného pokynu pro balení i režimů omezených a vyňatých množství, přípustnost věcí pro daný druh dopravy, soulad obalu s předpisy a úplnost prohlášení. Pokud něco nevyhovuje, odpověď uvede, které pravidlo není splněno a s jakými hodnotami, takže zprávu lze zobrazit ve vaší vlastní aplikaci.

V konsolidaci. Oddělování uvnitř dopravní jednotky, oddělování mezi jednotkami naloženými v téže přepravě, výpočet mezní hodnoty podle 1.1.3.6 ADR pro danou přepravu včetně rozpisu a omezení jízdy vrácená jako data, například kód omezení pro tunely nebo přítomnost vysoce rizikových nebezpečných věcí.

Podporované předpisy a druhy přepravy

ADR pro silniční, IMDG pro námořní a IATA pro leteckou přepravu a 49 CFR. Tři hlavní předpisy se spravují společně, nikoli jako samostatné moduly, takže zásilku, která změní druh dopravy, není nutné připravovat znovu.

API podporuje společné balení, přepravní obalové soubory, cisterny, přepravu ve volně loženém stavu, prázdné nevyčištěné obaly, odpady, výbušné látky a předměty třídy 1 – s čistou hmotností výbušniny na kus – a radioaktivní látky třídy 7, vždy s údaji, které každý z těchto případů vyžaduje. Texty dokumentů se vystavují v devatenácti jazycích.

Dostupnost API

Služba je provozována ve třech regionech — Evropa, Amerika a Asie a Tichomoří — a každý z nich má vlastní adresu, takže integrace pracuje s regionem, ve kterém je veden účet. Infrastruktura je redundantní a nepřetržitě monitorovaná.

Jak začít používat API

Požádejte o bezplatnou dvoutýdenní zkušební verzi a s ní i o přístupové údaje ke službě. Autentizace využívá OAuth 2.0 s grantem client credentials: váš systém získá přístupový token a odesílá jej s každým požadavkem.

Úplná specifikace je zveřejněna ve formátu OpenAPI a lze ji číst, procházet a použít k vygenerování klienta ve vašem programovacím jazyce dříve, než napíšete jediný řádek integračního kódu.

Části specifikace API

Část
PřehledPředstavení API a limitů jeho používání se soubory specifikace OpenAPI 3.0 a 2.0 a se seznamem všech částí.Otevřít
AutentizacePřístupové tokeny OAuth2 vydávané s grantem client credentials jako alternativa k autentizaci HTTP Basic u všech operací, které autentizaci vyžadují.Otevřít
Kontroly připojeníKontrola dostupnosti API, přístupových údajů uživatele API a požadavků s autentizací i bez ní.Otevřít
Kmenová dataNebezpečné věci a radionuklidy, obaly a pokyny pro balení, kódy, země a místa, na která odkazují zásilky, produkty a konsolidace.Otevřít
ProduktyJednoduché produkty a produkty ve společném balení z katalogu, včetně interaktivního vytvoření produktu ve společném balení pro zásilku.Otevřít
ÚčastníciPředdefinovaní účastníci: odesilatelé, příjemci, nakládci, dopravci, dodavatelé a řidiči.Otevřít
Vozidla, přípojná vozidla a plavidlaVozidla, přípojná vozidla a plavidla vedená v účtech s registrační značkou, označením vozidla ADR a dokladem o shodě.Otevřít
Místa a omezeníPřístavy, letiště a terminály vedené v účtech a omezení, která platí, když se v nich plánuje nebo nakládá přepravní zařízení.Otevřít
ZásilkyVytvoření zásilky s celým obsahem (dávkový režim) nebo s prvním obsahem (interaktivní režim) a načtení a odstranění zásilek.Otevřít
Obsah zásilkyProdukty, společná balení a přepravní obalové soubory přidávané do zásilky zpracovávané interaktivně nebo z ní odebírané.Otevřít
Dokumenty zásilkyDokumenty zásilky (přepravní doklad, kontrolní seznam, označení kusů a další), jejich odeslání e-mailem a zmrazené dokumenty.Otevřít
Nákladní listyNákladní listy CMR, elektronické nákladní listy (e-CMR) a vnitrostátní nákladní listy, od kontroly, zda trasu pokrývá Protokol e-CMR, až po vystavení, doručení a zrušení.Otevřít
Žádosti o konsolidaciŽádosti o konsolidaci od účtů klientů nebo jejich jménem od jejich bezpečnostního poradce a rozhodnutí konsolidátora.Otevřít
Hlavní zásilkyHlavní zásilky s jejich zásilkami a schvalovacím postupem.Otevřít
Přepravní zařízeníPřepravní zařízení, jejich obsah, kontroly oddělování a historie pohybů.Otevřít
Přepravy a zastávkyNámořní cesty, lety a silniční jízdy s jejich zastávkami a přepravními zařízeními, kontroly oddělování, výpočet mezní hodnoty nákladu (ADR 1.1.3.6) a omezení.Otevřít
Dokumenty konsolidaceDokumenty hlavních zásilek, přepravních zařízení a přeprav.Otevřít
WebhookyOdběry webhooků účtu, jejich test a nedávná doručení.Otevřít

Abyste se přesvědčili, jak rychlá a snadná je integrace, můžete si službu dva týdny nezávazně vyzkoušet