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í

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.
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 |