API REST pentru mărfuri periculoase

Ce face API-ul

Expediții. API-ul REST JSON al DGAssistant creează expediția de mărfuri periculoase din propriul dumneavoastră sistem de gestiune sau de logistică și returnează declarația expeditorului, lista de control și marcarea coletelor, deja verificate în raport cu reglementarea aplicabilă. Sistemul dumneavoastră păstrează datele comerciale; DGAssistant furnizează cunoștințele de reglementare și documentele.

Consolidare. API-ul acoperă și gruparea expedițiilor mai multor expeditori, pe cele două axe ale acesteia. Axa contractuală este expediția principală — o rezervare, o consolidare maritimă sau aeriană, un grupaj rutier — cu părțile, referințele și expedițiile atașate, cu tranzițiile de stare și cu istoricul său. Axa fizică este echipamentul de transport (container, vehicul, remorcă sau dispozitiv de încărcare ULD) și cursa de transport (voiaj, zbor sau parcurs rutier) cu escalele sale, împreună cu navele, vehiculele și locațiile contului. Mai mult de jumătate din serviciu este dedicată acestei părți.

Deschideți specificația API pentru mărfuri periculoase

Două moduri de lucru: în lot și interactiv

În lot. Un singur apel transmite specificația completă a expediției, cu toate mărfurile sale. Este modul destinat sistemelor de gestiune și de logistică ce trimit expediții complete, deja constituite.

Interactiv. Mai întâi se deschide expediția, apoi mărfurile se adaugă una câte una. Fiecare răspuns conține mesajele de validare pentru ceea ce tocmai a fost adăugat, astfel încât propria dumneavoastră aplicație să le poată afișa utilizatorului în timp ce expediția este pregătită.

Date predefinite sau date ad-hoc

Date predefinite. Produsele și participanții — expeditori, transportatori, destinatari, încărcători și conducători auto — sunt creați în prealabil, iar API-ul utilizează codurile lor. Este modul de lucru cel mai simplu și cel pe care îl recomandăm, deoarece clasificarea de reglementare se stabilește o singură dată și se reutilizează în fiecare expediție.

Date ad-hoc. Produsele și participanții sunt definiți în același apel care creează expediția. Este potrivit pentru sistemele care nu țin un catalog propriu sau care expediază ocazional mărfuri.

Documentele returnate

API-ul returnează aceleași documente pe care le generează aplicația. Cele ale expediției și ale consolidării se obțin în format PDF, XLSX sau DOCX, iar cele ale expediției pot fi trimise și prin e-mail direct din serviciu; cele ale scrisorii de trăsură, în format PDF.

• Pentru fiecare expediție: documentul de transport al reglementării aplicabile – documentul de transport ADR, declarația OMI de mărfuri periculoase sau formularul multimodal IMDG și declarația IATA a expeditorului –, lista de control, marcarea coletelor în dimensiune completă sau în format mic personalizat și, pentru transportul aerian, fișa de date a scrisorii de transport aerian.
• Pentru expediția principală: manifestul de consolidare, lista de containere, lista de colisaj a fiecărei unități, fișa de încărcare pe expeditor și fișa de date a documentului principal.
• Pentru unitatea de transport: certificatul de încărcare a containerului sau a vehiculului, formularul multimodal pentru mărfuri periculoase, raportul de segregare al unității, lista de control dinaintea semnării certificatului și eticheta de consolidare.
• Pentru cursă: manifestul de mărfuri periculoase, raportul de segregare între unitățile de la bord, raportul privind pragul exceptării 1.1.3.6 din ADR, fișa de restricții de parcurs, fișa de încărcare, notificarea comandantului (NOTOC) și documentul de transport consolidat al vehiculului.
• Pentru scrisoarea de trăsură: proiectul, exemplarul semnat, documentul de transport ADR atașat și raportul probatoriu.

Ce verifică API-ul

În expediție. Segregarea între mărfurile transportate împreună, limitele de cantitate ale instrucțiunii de ambalare aplicabile și ale regimurilor de cantități limitate și exceptate, admisibilitatea mărfurilor pentru modul de transport, conformitatea ambalajului și caracterul complet al declarației. Atunci când ceva nu este conform, răspunsul indică regula care nu este respectată și cu ce valori, astfel încât mesajul să poată fi afișat în propria dumneavoastră aplicație.

În consolidare. Segregarea în interiorul unității de transport, segregarea între unitățile încărcate în aceeași cursă, calculul pragului 1.1.3.6 din ADR pentru cursa respectivă, cu defalcarea sa, și restricțiile de parcurs returnate sub formă de date, cum ar fi codul de restricție în tuneluri sau prezența mărfurilor periculoase cu risc ridicat.

Reglementări și tipuri de transport acoperite

ADR pentru transportul rutier, IMDG pentru cel maritim, IATA pentru cel aerian și 49 CFR. Cele trei reglementări principale sunt gestionate împreună, și nu ca module separate, astfel încât o expediție care își schimbă modul de transport nu trebuie pregătită din nou.

Ambalarea în comun, supraambalajele, cisternele, transportul în vrac, ambalajele goale necurățate, deșeurile, explozivii din clasa 1 – cu masa netă de exploziv pe colet – și materialele radioactive din clasa 7 sunt toate acceptate, cu datele pe care le necesită fiecare. Textele documentelor sunt emise în nouăsprezece limbi.

Disponibilitate

Serviciul este publicat în trei regiuni — Europa, Americile și Asia-Pacific — fiecare cu propria adresă, astfel încât integrarea funcționează cu regiunea în care este deținut contul. Infrastructura este redundantă și monitorizată non-stop.

Cum începeți

Solicitați o perioadă de probă gratuită de două săptămâni și, odată cu aceasta, credențialele de acces la serviciu. Autentificarea utilizează OAuth 2.0 cu acordarea de tip „client credentials”: sistemul dumneavoastră obține un token de acces și îl trimite în fiecare cerere.

Specificația completă este publicată în format OpenAPI și poate fi citită, explorată și utilizată pentru a genera un client în propriul dumneavoastră limbaj de programare, înainte de a scrie o singură linie de cod de integrare.