REST-API voor gevaarlijke goederen

Wat de API doet

Zendingen. De REST-API met JSON van DGAssistant maakt de zending gevaarlijke goederen aan vanuit uw eigen beheer- of logistieke systeem en levert de verklaring van de afzender, de checklist en de merktekens van de colli, reeds getoetst aan de toepasselijke regelgeving. Uw systeem houdt de commerciële gegevens; DGAssistant levert de regelkennis en de documenten.

Groupage. De API dekt ook het bundelen van zendingen van meerdere afzenders, langs beide assen. De contractuele as is de hoofdzending — een boeking, een zee- of luchtgroupage, een wegzendingbundel — met haar betrokkenen, haar referenties, de eraan gekoppelde zendingen, haar statusovergangen en haar geschiedenis. De fysieke as is de laadeenheid (container, voertuig, oplegger of luchtvrachtlaadeenheid) en de vervoersbeweging (reis, vlucht of rit) met haar aanlopen, samen met de schepen, voertuigen en locaties van het account. Meer dan de helft van de dienst is aan dit deel gewijd.

De specificatie van de API voor gevaarlijke goederen openen

Twee werkwijzen: batch en interactief

Batch. Eén aanroep draagt de volledige beschrijving van de zending met al haar goederen. Het is de weg die bedoeld is voor beheer- en logistieke systemen die reeds samengestelde zendingen aanleveren.

Interactief. Eerst wordt de zending geopend en daarna worden de goederen één voor één toegevoegd. Elk antwoord draagt de controlemeldingen van wat zojuist is toegevoegd, zodat uw eigen toepassing die aan de gebruiker kan tonen terwijl de zending wordt voorbereid.

Vooraf vastgelegde gegevens of gegevens in de aanroep

Vooraf vastgelegde gegevens. De producten en de betrokkenen — afzenders, vervoerders, geadresseerden, beladers en chauffeurs — worden vooraf aangemaakt en de API gebruikt hun codes. Dat is de eenvoudigste werkwijze en die wij aanbevelen, omdat de classificatie één keer wordt vastgesteld en bij elke zending wordt hergebruikt.

Gegevens in de aanroep. De producten en de betrokkenen worden vastgelegd in dezelfde aanroep die de zending aanmaakt. Dat past bij systemen die geen eigen catalogus bijhouden of die incidenteel gevaarlijke goederen verzenden.

De documenten die zij teruggeeft

Per zending: de verklaring van de afzender van de toepasselijke regelgeving, de checklist en de merktekens van de colli. Zij worden opgehaald als PDF, XLSX of DOCX, of rechtstreeks vanuit de dienst per e-mail verzonden.

Voor de groupage: de documenten van de laadeenheid, de documenten van de vervoersbeweging — waaronder het manifest van gevaarlijke goederen en de kennisgeving aan de kapitein — en de documenten van de hoofdzending.

Wat de API controleert

In de zending. De scheiding tussen de samen vervoerde goederen, de hoeveelheidsgrenzen van de toepasselijke verpakkingsinstructie en van de regimes voor gelimiteerde en vrijgestelde hoeveelheid, de toelaatbaarheid van de goederen voor de vervoerswijze, de toelaatbaarheid van de verpakking en de volledigheid van de aangifte. Wanneer iets niet voldoet, vermeldt het antwoord welke regel niet wordt gehaald en met welke waarden, zodat de melding in uw eigen toepassing kan worden getoond.

In de groupage. De scheiding binnen de laadeenheid, de scheiding tussen de eenheden die in dezelfde beweging zijn geladen, de berekening van de drempel van 1.1.3.6 van het ADR voor de beweging met de uitsplitsing daarvan, en de beperkingen van de rit als gegevens, zoals de tunnelbeperkingscode of de aanwezigheid van gevaarlijke goederen met een hoog gevaarpotentieel.

Gedekte regelgeving en vervoerswijzen

ADR voor de weg, IMDG voor de zee, IATA voor de lucht en 49 CFR. De drie belangrijkste regelgevingen worden samen beheerd en niet als afzonderlijke modules, zodat een zending die van vervoerswijze verandert niet opnieuw hoeft te worden voorbereid.

Gezamenlijke verpakking, oververpakkingen, tanks, vervoer in bulk, lege ongereinigde verpakkingen, afval en radioactieve stoffen van klasse 7 worden ondersteund, met de gegevens die elk daarvan vereist. De teksten van de documenten worden in negentien talen uitgegeven.

Beschikbaarheid

De dienst wordt in drie regio's gepubliceerd — Europa, Amerika en Azië-Pacific —, elk met een eigen adres, zodat de koppeling werkt met de regio waar het account wordt gehouden. De infrastructuur is redundant en wordt onafgebroken bewaakt.

Hoe te beginnen

Vraag twee weken gratis proefgebruik aan, en daarmee de aanmeldgegevens van de dienst. De verificatie gebruikt OAuth 2.0 met de methode 'client credentials': uw systeem verkrijgt een toegangstoken en zendt dat bij elke aanvraag mee.

De volledige specificatie is gepubliceerd in de opmaak OpenAPI en kan worden gelezen, verkend en gebruikt om een client in uw eigen taal te genereren voordat ook maar één regel koppelingscode is geschreven.