API REST pentru mărfuri periculoase
API-ul REST JSON al DGAssistant creează expediții de mărfuri periculoase din propriul dumneavoastră sistem de gestiune sau de logistică și returnează declarația expeditorului, lista de control și marcarea coletelor, verificate în raport cu reglementarea aplicabilă. Se adresează companiilor care integrează aceste documente în ERP-ul lor și acoperă și consolidarea.
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.
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 factorii implicați — 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 factorii implicați 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, rezumatul mărfurilor periculoase din unitate, 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.
Disponibilitatea API-ului
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 să utilizați API-ul
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.
Secțiunile specificației API
| Secțiune | |
|---|---|
| Prezentare generalăPrezentarea API-ului și a limitelor sale de utilizare, cu fișierele OpenAPI 3.0 și 2.0 ale specificației și indexul tuturor secțiunilor. | Deschideți |
| AutentificareTokenuri de acces OAuth2 emise prin acordarea de tip „client credentials”, ca alternativă la autentificarea HTTP Basic pentru toate operațiunile autentificate. | Deschideți |
| Verificări de conexiuneVerificarea disponibilității API-ului, a credențialelor utilizatorului API și a cererilor cu și fără autentificare. | Deschideți |
| Date de referințăMărfuri periculoase și radionuclizi, ambalaje și instrucțiuni de ambalare, coduri, țări și locații la care fac trimitere expedițiile, produsele și consolidarea. | Deschideți |
| ProduseProduse simple și produse în ambalare în comun din catalog, inclusiv crearea interactivă a unui produs în ambalare în comun pentru o expediție. | Deschideți |
| Factori implicațiFactori implicați predefiniți: expeditori, destinatari, încărcători, transportatori, furnizori și conducători auto. | Deschideți |
| Vehicule, remorci și naveVehiculele, remorcile și navele conturilor, cu numărul de înmatriculare, încadrarea ADR și documentul de conformitate. | Deschideți |
| Locații și restricțiiPorturile, aeroporturile și terminalele conturilor și restricțiile care se aplică atunci când în ele se planifică sau se încarcă un echipament de transport. | Deschideți |
| ExpedițiiCrearea unei expediții cu tot conținutul ei (în lot) sau cu primul ei conținut (interactiv), precum și consultarea și ștergerea expedițiilor. | Deschideți |
| Conținutul expedițieiProduse, ambalări în comun și supraambalaje adăugate la o expediție tratată interactiv sau eliminate din aceasta. | Deschideți |
| Documentele expedițieiDocumentele unei expediții (document de transport, listă de control, marcarea coletelor și altele), trimiterea lor prin e-mail și documentele înghețate. | Deschideți |
| Scrisori de trăsurăScrisori de trăsură CMR, electronice (e-CMR) și naționale, de la verificarea acoperirii traseului de Protocolul e-CMR până la emitere, livrare și anulare. | Deschideți |
| Cereri de consolidareCererile de consolidare ale conturilor de clienți sau ale consilierului lor de siguranță în numele lor și deciziile consolidatorului. | Deschideți |
| Expediții principaleExpedițiile principale cu expedițiile lor și fluxul lor de aprobare. | Deschideți |
| Echipamente de transportEchipamentele de transport, conținutul lor, verificările de segregare și istoricul deplasărilor. | Deschideți |
| Curse și escaleVoiaje, zboruri și parcursuri rutiere cu escalele și echipamentele lor de transport, verificări de segregare, calculul pragului de încărcătură (ADR 1.1.3.6) și restricții. | Deschideți |
| Documente de consolidareDocumentele expedițiilor principale, ale echipamentelor de transport și ale curselor. | Deschideți |
| WebhookuriAbonamentele la webhookuri ale contului, testarea lor și livrările recente. | Deschideți |