API REST per merci pericolose

Che cosa fa l'API

Spedizioni. L'API REST JSON di DGAssistant crea la spedizione di merci pericolose dal Suo sistema gestionale o logistico e restituisce la dichiarazione dello speditore, la lista di controllo e la marcatura dei colli, già verificate rispetto alla normativa applicabile. Il Suo sistema conserva i dati commerciali; DGAssistant fornisce la conoscenza normativa e i documenti.

Consolidamento. L'API copre anche il raggruppamento di spedizioni di più speditori, lungo i suoi due assi. L'asse contrattuale è la spedizione principale — una prenotazione, un consolidamento marittimo o aereo, un groupage stradale — con i suoi soggetti, i suoi riferimenti, le spedizioni a essa collegate, i suoi passaggi di stato e la sua storia. L'asse fisico è l'unità di trasporto (container, veicolo, rimorchio o unità di carico) e il movimento di trasporto (viaggio, volo o tragitto) con i suoi scali, insieme a navi, veicoli e luoghi dell'account. Più della metà del servizio è dedicata a questa parte.

Aprire la specifica dell'API per merci pericolose

Due modi di lavorare: a lotti e interattivo

A lotti. Un'unica chiamata porta la specifica completa della spedizione con tutte le sue merci. È la via pensata per i sistemi gestionali e logistici che inviano spedizioni già composte.

Interattivo. Prima si apre la spedizione e poi si aggiungono le merci una a una. Ogni risposta riporta i messaggi di verifica di quanto appena aggiunto, affinché la Sua applicazione possa mostrarli all'utente mentre la spedizione viene preparata.

Dati predefiniti o dati nella chiamata

Dati predefiniti. I prodotti e i soggetti — speditori, vettori, destinatari, caricatori e conducenti — si creano in anticipo e l'API ne usa i codici. È il modo più semplice di lavorare e quello che consigliamo, perché la classificazione normativa si risolve una volta e si riusa in ogni spedizione.

Dati nella chiamata. I prodotti e i soggetti si definiscono nella stessa chiamata che crea la spedizione. Si adatta ai sistemi che non tengono un catalogo proprio o che spediscono merci occasionali.

I documenti che restituisce

Per ogni spedizione: la dichiarazione dello speditore della normativa applicabile, la lista di controllo e la marcatura dei colli. Si recuperano in PDF, XLSX o DOCX, oppure si inviano direttamente per posta elettronica dal servizio stesso.

Per il consolidamento: i documenti dell'unità di trasporto, i documenti del movimento — fra cui il manifesto delle merci pericolose e la notifica al comandante — e i documenti della spedizione principale.

Che cosa verifica l'API

Nella spedizione. La segregazione fra le merci trasportate insieme, i limiti di quantità dell'istruzione di imballaggio applicabile e dei regimi di quantità limitata ed esente, l'ammissibilità delle merci per il modo di trasporto, la legittimità dell'imballaggio e la completezza della dichiarazione. Quando qualcosa non è conforme, la risposta indica quale regola non è soddisfatta e con quali valori, affinché il messaggio possa essere mostrato nella Sua applicazione.

Nel consolidamento. La segregazione all'interno dell'unità di trasporto, la segregazione fra le unità caricate nello stesso movimento, il calcolo della soglia 1.1.3.6 dell'ADR per il movimento con il relativo dettaglio, e le restrizioni del tragitto restituite come dati, quali il codice di restrizione in galleria o la presenza di merci pericolose ad alto rischio.

Normative e tipi di trasporto coperti

ADR per la strada, IMDG per il mare, IATA per l'aria e 49 CFR. Le tre normative principali sono gestite insieme e non come moduli separati, cosicché una spedizione che cambia modo di trasporto non debba essere preparata di nuovo.

Imballaggio in comune, sovrimballaggi, cisterne, trasporto alla rinfusa, imballaggi vuoti non ripuliti, rifiuti e materie radioattive della classe 7 sono supportati, con i dati che ciascuno richiede. I testi dei documenti sono emessi in diciannove lingue.

Disponibilità

Il servizio è pubblicato in tre regioni — Europa, Americhe e Asia-Pacifico — ciascuna con il proprio indirizzo, affinché l'integrazione operi verso la regione in cui è tenuto l'account. L'infrastruttura è ridondante e sorvegliata senza interruzione.

Come iniziare

Richieda una prova gratuita di due settimane e, con essa, le credenziali del servizio. L'autenticazione usa OAuth 2.0 con il metodo «client credentials»: il Suo sistema ottiene un token di accesso e lo invia in ogni richiesta.

La specifica completa è pubblicata in formato OpenAPI e può essere letta, esplorata e usata per generare un client nel Suo linguaggio prima di scrivere una sola riga di codice di integrazione.