REST API veszélyes árukhoz

Mire képes az API

Küldemények. A DGAssistant JSON REST API-ja az Ön saját ügyviteli vagy logisztikai rendszeréből hozza létre a veszélyesáru-küldeményt, és visszaadja a feladói nyilatkozatot, az ellenőrző listát és a küldeménydarabok jelölését, mindezt az alkalmazandó szabályozás szerint már ellenőrizve. Az Ön rendszere a kereskedelmi adatokat kezeli; a DGAssistant a szabályozási szakértelmet és az okmányokat biztosítja.

Gyűjtés. Az API a több feladótól származó küldemények összevonását is lefedi, annak mindkét dimenziójában. A szerződéses dimenzió a fő küldemény — foglalás, tengeri vagy légi gyűjtés, közúti gyűjtőfuvar — a feleivel, hivatkozásaival, a hozzá csatolt küldeményekkel, állapotváltozásaival és előzményeivel. A fizikai dimenzió a szállítóeszköz (konténer, jármű, pótkocsi vagy egységrakomány-képző eszköz) és a fuvar (tengeri út, légi járat vagy közúti út) a megállóival, valamint a fiók vízi járművei, járművei és helyszínei. A szolgáltatás több mint fele ennek a résznek szól.

A veszélyesáru-API specifikációjának megnyitása

Kétféle munkamód: kötegelt és interaktív

Kötegelt. Egyetlen hívás tartalmazza a küldemény teljes leírását az összes árujával együtt. Ez a mód azoknak az ügyviteli és logisztikai rendszereknek szól, amelyek már összeállított, teljes küldeményeket küldenek.

Interaktív. Először a küldeményt kell megnyitni, majd az árukat egyenként kell hozzáadni. Minden válasz tartalmazza az éppen hozzáadott tételre vonatkozó ellenőrzési üzeneteket, így az Ön saját alkalmazása a küldemény összeállítása közben megjelenítheti azokat a felhasználónak.

Előre rögzített vagy menet közben megadott adatok

Előre rögzített adatok. A termékeket és a résztvevőket — feladókat, szállítókat, címzetteket, berakókat és járművezetőket — előzetesen kell létrehozni, az API pedig a kódjaikat használja. Ez a legegyszerűbb munkamód, és ezt ajánljuk, mert a szabályozás szerinti osztályozást egyszer kell elvégezni, és minden küldeményben újra felhasználható.

Menet közben megadott adatok. A termékeket és a résztvevőket ugyanabban a hívásban kell meghatározni, amely a küldeményt létrehozza. Olyan rendszerekhez illik, amelyek nem tartanak fenn saját katalógust, vagy alkalmanként szállítanak árut.

A visszaadott okmányok

Az API ugyanazokat az okmányokat adja vissza, amelyeket az alkalmazás készít. A küldemény és a gyűjtés okmányai PDF, XLSX vagy DOCX formátumban kérhetők le, és a küldemény okmányai magából a szolgáltatásból e-mailben is elküldhetők; a fuvarlevél okmányai pedig PDF formátumban érhetők el.

• Minden küldeményhez: az alkalmazandó szabályozás szerinti fuvarokmány – az ADR fuvarokmány, az IMO veszélyesáru-nyilatkozat vagy az IMDG multimodális nyomtatvány, illetve az IATA feladói nyilatkozat –, az ellenőrző lista, a küldeménydarabok jelölése teljes méretben vagy kis egyedi méretben, valamint légi szállításnál a légi fuvarlevél adatlapja.
• A fő küldeményhez: a gyűjtési rakományjegyzék, a konténerjegyzék, az egyes szállítóegységek csomagjegyzéke, a feladónkénti rakodási jegyzék és a fő okmány adatlapja.
• A szállítóegységhez: a konténer/jármű megrakási bizonyítvány, a multimodális veszélyes áru nyomtatvány, a szállítóegység elkülönítési jelentése, a bizonyítvány aláírása előtti ellenőrző lista és a gyűjtőküldemény-címke.
• A fuvarhoz: a veszélyesáru-rakományjegyzék, a fedélzeten lévő szállítóegységek közötti elkülönítési jelentés, az ADR 1.1.3.6 szerinti mentességi küszöbértékről szóló jelentés, az útvonal-korlátozási lap, a rakodási jegyzék, a kapitány értesítése (NOTOC) és a jármű összevont fuvarokmánya.
• A fuvarlevélhez: a tervezet, az aláírt példány, a csatolt ADR fuvarokmány és az igazoló jelentés.

Mit ellenőriz az API

A küldeményben. Az együtt szállított áruk közötti elkülönítés, az alkalmazandó csomagolási utasítás, valamint a korlátozott és az engedményes mennyiségekre vonatkozó szabályok mennyiségi korlátai, az áruk szállíthatósága az adott szállítási módon, a csomagolóeszköz előírásszerűsége és a nyilatkozat teljessége. Ha valami nem felel meg, a válasz megadja, melyik szabály nem teljesül és milyen értékekkel, így az üzenet az Ön saját alkalmazásában is megjeleníthető.

A gyűjtésben. Az elkülönítés a szállítóegységen belül, az elkülönítés az ugyanabban a fuvarban berakott szállítóegységek között, az ADR 1.1.3.6 bekezdése szerinti küszöbérték kiszámítása a fuvarra, részletes bontással, valamint az útvonal-korlátozások adatként visszaadva, például az alagútkorlátozási kód vagy a nagy közbiztonsági kockázattal járó veszélyes áruk jelenléte.

Támogatott szabályozások és szállítási formák

ADR a közúti, IMDG a tengeri és IATA a légi szállításhoz, valamint a 49 CFR. A három fő szabályozást együtt kezeli, nem pedig külön modulokként, így a szállítási módot váltó küldeményt nem kell újra elkészíteni.

Az együvé csomagolás, az egyesítőcsomagolások, a tartányok, az ömlesztett szállítás, az üres, tisztítatlan csomagolóeszközök, a hulladékok, az 1 osztály robbanóanyagai – küldeménydarabonkénti nettó robbanóanyag tömegükkel – és a 7 osztály radioaktív anyagai egyaránt támogatottak, az egyes esetekhez szükséges adatokkal. Az okmányok szövegei tizenkilenc nyelven készülnek.

Rendelkezésre állás

A szolgáltatás három régióban — Európában, Amerikában és az ázsiai–csendes-óceáni térségben — érhető el, mindegyik saját címmel, így az integráció abban a régióban működik, ahol a fiókot vezetik. Az infrastruktúra redundáns, és éjjel-nappal felügyelt.

Hogyan kezdjen hozzá

Kérjen kéthetes ingyenes próbaidőszakot, és vele együtt a szolgáltatás hozzáférési adatait. A hitelesítés az OAuth 2.0 szabványt használja, ügyfél-hitelesítő adatokkal történő engedélyezéssel (client credentials grant): az Ön rendszere hozzáférési tokent kér le, és azt minden kérésben elküldi.

A teljes specifikáció OpenAPI formátumban érhető el: elolvashatja, kipróbálhatja, és a saját programozási nyelvén ügyfélprogramot generálhat belőle, mielőtt egyetlen sor integrációs kódot írna.