API REST de marchandises dangereuses

Ce que fait l'API

Envois. L'API REST JSON de DGAssistant crée l'envoi de marchandises dangereuses depuis votre propre système de gestion ou de logistique et renvoie la déclaration de l'expéditeur, la liste de contrôle et le marquage des colis, déjà vérifiés au regard de la réglementation applicable. Votre système conserve les données commerciales ; DGAssistant apporte la connaissance réglementaire et les documents.

Groupage. L'API couvre également le regroupement d'envois de plusieurs expéditeurs, selon ses deux axes. L'axe contractuel est l'envoi principal — une réservation, un groupage maritime ou aérien, un groupage routier — avec ses intervenants, ses références, les envois qui y sont rattachés, ses changements d'état et son historique. L'axe physique est l'engin de transport (conteneur, véhicule, remorque ou unité de chargement) et l'opération de transport (voyage, vol ou trajet) avec ses escales, ainsi que les navires, les véhicules et les lieux du compte. Plus de la moitié du service est consacrée à cette partie.

Ouvrir la spécification de l'API de marchandises dangereuses

Deux manières de travailler : par lots et interactive

Par lots. Un seul appel porte la spécification complète de l'envoi avec toutes ses marchandises. C'est la voie destinée aux systèmes de gestion et de logistique qui transmettent des envois déjà constitués.

Interactive. L'envoi est d'abord ouvert, puis les marchandises sont ajoutées une à une. Chaque réponse porte les messages de validation de ce qui vient d'être ajouté, afin que votre propre application puisse les montrer à l'utilisateur pendant la préparation.

Données prédéfinies ou données au fil de l'appel

Données prédéfinies. Les produits et les intervenants — expéditeurs, transporteurs, destinataires, chargeurs et conducteurs — sont créés au préalable et l'API utilise leurs codes. C'est la manière la plus simple de travailler et celle que nous recommandons, car la classification réglementaire est réglée une fois puis réutilisée à chaque envoi.

Données au fil de l'appel. Les produits et les intervenants sont définis dans l'appel même qui crée l'envoi. Cela convient aux systèmes qui ne tiennent pas de catalogue propre ou qui expédient des marchandises occasionnelles.

Les documents qu'elle renvoie

Pour chaque envoi : la déclaration de l'expéditeur de la réglementation applicable, la liste de contrôle et le marquage des colis. Ils sont récupérés en PDF, XLSX ou DOCX, ou envoyés directement par courrier électronique depuis le service lui-même.

Pour le groupage : les documents de l'engin de transport, les documents de l'opération — parmi lesquels le manifeste de marchandises dangereuses et la notification au capitaine — et les documents de l'envoi principal.

Ce que l'API vérifie

Dans l'envoi. La ségrégation entre les marchandises transportées ensemble, les limites de quantité de l'instruction d'emballage applicable et des régimes de quantité limitée et exceptée, l'admissibilité des marchandises pour le mode de transport, la conformité de l'emballage et l'exhaustivité de la déclaration. Lorsqu'un point n'est pas respecté, la réponse indique quelle règle n'est pas satisfaite et avec quelles valeurs, afin que le message puisse être affiché dans votre propre application.

Dans le groupage. La ségrégation à l'intérieur de l'engin de transport, la ségrégation entre les engins chargés dans la même opération, le calcul du seuil 1.1.3.6 de l'ADR pour l'opération avec son détail, et les restrictions du trajet renvoyées sous forme de données, tels le code de restriction en tunnels ou la présence de marchandises dangereuses à haut risque.

Réglementations et types de transport couverts

ADR pour la route, IMDG pour la mer, IATA pour l'air et 49 CFR. Les trois réglementations principales sont gérées ensemble et non comme des modules séparés, de sorte qu'un envoi qui change de mode de transport n'a pas à être préparé de nouveau.

L'emballage en commun, les suremballages, les citernes, le transport en vrac, les emballages vides non nettoyés, les déchets et les matières radioactives de la classe 7 sont pris en charge, avec les données que chacun requiert. Les textes des documents sont édités en dix-neuf langues.

Disponibilité

Le service est publié dans trois régions — Europe, Amériques et Asie-Pacifique —, chacune avec son adresse propre, afin que l'intégration travaille avec la région où le compte est tenu. L'infrastructure est redondante et surveillée en permanence.

Comment commencer

Demandez un essai gratuit de deux semaines, et avec lui les identifiants du service. L'authentification emploie OAuth 2.0 avec le mode « client credentials » : votre système obtient un jeton d'accès et l'envoie dans chaque requête.

La spécification complète est publiée au format OpenAPI et peut être lue, explorée et utilisée pour engendrer un client dans votre propre langage avant d'écrire la moindre ligne de code d'intégration.