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 controlelijst en de merktekens van de colli, reeds getoetst aan het toepasselijke reglement. Uw systeem houdt de commerciële gegevens; DGAssistant levert de regelkennis en de documenten.

Consolidatie. 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 luchtconsolidatie, 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

De API levert dezelfde documenten die de toepassing opstelt. Die van de zending en van de consolidatie worden opgehaald als PDF, XLSX of DOCX, die van de zending kunnen bovendien rechtstreeks vanuit de dienst per e-mail worden verzonden; die van de vrachtbrief, als PDF.

• Per zending: het vervoersdocument van het toepasselijke reglement —het ADR-vervoersdocument, de IMO-verklaring voor gevaarlijke goederen of het multimodale IMDG-formulier, en de IATA-verklaring van de afzender—, de controlelijst, de merktekens van de colli op volledige grootte of op kleine aangepaste grootte en, bij luchtvervoer, het gegevensblad voor de luchtvrachtbrief.
• Voor de hoofdzending: het consolidatiemanifest, de containerlijst, de paklijst per eenheid, de laadlijst per afzender en het gegevensblad van het hoofddocument.
• Voor de transporteenheid: het container-/voertuigbeladingscertificaat, het multimodale formulier voor gevaarlijke goederen, het scheidingsrapport van de eenheid, de controlelijst vóór de ondertekening van het certificaat en het consolidatie-etiket.
• Voor de vervoersbeweging: het manifest van gevaarlijke goederen, het scheidingsrapport tussen eenheden aan boord, het rapport over de vrijstellingsdrempel van ADR 1.1.3.6, het beperkingenblad, de laadlijst, de kennisgeving aan de gezagvoerder (NOTOC) en het geconsolideerde vervoersdocument van het voertuig.
• Voor de vrachtbrief: het concept, het ondertekende exemplaar, het bijgevoegde ADR-vervoersdocument en het bewijsrapport.

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 consolidatie. 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 reglementen en vervoerswijzen

ADR voor de weg, IMDG voor de zee, IATA voor de lucht en 49 CFR. De drie belangrijkste reglementen 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, ontplofbare stoffen van klasse 1 —met hun netto massa ontplofbare stof per collo— 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.