Gefahrgut-REST-Schnittstelle

Was die Schnittstelle leistet

Sendungen. Die REST-Schnittstelle mit JSON von DGAssistant legt die Gefahrgutsendung aus Ihrem Verwaltungs- oder Logistiksystem an und gibt Versendererklärung, Checkliste und Versandstückkennzeichnung zurück, bereits gegen die zutreffende Vorschrift geprüft. Ihr System hält die kaufmännischen Daten; DGAssistant liefert das Regelwissen und die Dokumente.

Konsolidierung. Die Schnittstelle deckt auch die Zusammenfassung der Sendungen mehrerer Versender ab, entlang ihrer beiden Achsen. Die vertragliche Achse ist die Hauptsendung — eine Buchung, eine See- oder Luftkonsolidierung, eine Straßensammelladung — mit ihren Beteiligten, ihren Referenzen, den ihr zugeordneten Sendungen, ihren Statusübergängen und ihrer Historie. Die physische Achse ist die Beförderungseinheit (Container, Fahrzeug, Anhänger oder Luftfracht-Ladeeinheit) und der Beförderungsvorgang (Seereise, Flug oder Fahrt) mit seinen Anläufen, zusammen mit den Schiffen, Fahrzeugen und Orten des Kontos. Mehr als die Hälfte des Dienstes ist diesem Teil gewidmet.

Spezifikation der Gefahrgut-Schnittstelle öffnen

Zwei Arbeitsweisen: Stapel und Dialog

Stapel. Ein einziger Aufruf trägt die vollständige Beschreibung der Sendung mit allen ihren Gütern. Das ist der Weg für Verwaltungs- und Logistiksysteme, die fertig zusammengestellte Sendungen übergeben.

Dialog. Zuerst wird die Sendung eröffnet, dann werden die Güter einzeln hinzugefügt. Jede Antwort führt die Prüfhinweise zum soeben Hinzugefügten mit, damit Ihre eigene Anwendung sie dem Benutzer während der Vorbereitung anzeigen kann.

Vorab angelegte Daten oder Daten im Aufruf

Vorab angelegte Daten. Güter und Beteiligte — Absender, Frachtführer, Empfänger, Verlader und Fahrer — werden vorher angelegt, und die Schnittstelle verwendet ihre Codes. Das ist der einfachste Weg und der, den wir empfehlen, weil die Einstufung einmal geklärt und in jeder Sendung wiederverwendet wird.

Daten im Aufruf. Güter und Beteiligte werden in demselben Aufruf festgelegt, der die Sendung anlegt. Das passt zu Systemen, die keinen eigenen Bestand führen oder nur gelegentlich Gefahrgut versenden.

Die Dokumente, die sie zurückgibt

Je Sendung: die Versendererklärung der zutreffenden Vorschrift, die Checkliste und die Versandstückkennzeichnung. Sie werden als PDF, XLSX oder DOCX abgerufen oder unmittelbar aus dem Dienst per E-Mail versandt.

Für die Konsolidierung: die Dokumente der Beförderungseinheit, die Dokumente des Beförderungsvorgangs — darunter das Gefahrgutmanifest und die Mitteilung an den Kapitän — und die Dokumente der Hauptsendung.

Was die Schnittstelle prüft

In der Sendung. Die Trennung zwischen den gemeinsam beförderten Gütern, die Mengengrenzen der zutreffenden Verpackungsanweisung sowie der begrenzten und freigestellten Mengen, die Zulässigkeit der Güter für den Verkehrsträger, die Zulässigkeit der Verpackung und die Vollständigkeit der Erklärung. Wird etwas nicht erfüllt, nennt die Antwort die nicht eingehaltene Regel und die betroffenen Werte, sodass sich die Meldung in Ihrer eigenen Anwendung anzeigen lässt.

In der Konsolidierung. Die Trennung innerhalb der Beförderungseinheit, die Trennung zwischen den im selben Vorgang geladenen Einheiten, die Berechnung des Schwellenwerts nach 1.1.3.6 des ADR für den Vorgang samt Aufschlüsselung und die Beschränkungen der Fahrt als Daten, etwa der Tunnelbeschränkungscode oder das Vorhandensein gefährlicher Güter mit hohem Gefahrenpotenzial.

Abgedeckte Vorschriften und Beförderungsarten

ADR für die Straße, IMDG für die See, IATA für die Luft und 49 CFR. Die drei Hauptvorschriften werden gemeinsam geführt und nicht als getrennte Module, damit eine Sendung, die den Verkehrsträger wechselt, nicht neu vorbereitet werden muss.

Zusammenpackung, Umverpackungen, Tanks, Beförderung in loser Schüttung, leere ungereinigte Verpackungen, Abfälle und radioaktive Stoffe der Klasse 7 werden unterstützt, jeweils mit den Daten, die sie verlangen. Die Texte der Dokumente werden in neunzehn Sprachen ausgegeben.

Verfügbarkeit

Der Dienst wird in drei Regionen veröffentlicht — Europa, Amerika und Asien-Pazifik —, jede mit eigener Adresse, damit die Anbindung gegen die Region arbeitet, in der das Konto geführt wird. Die Infrastruktur ist redundant und wird rund um die Uhr überwacht.

Wie man anfängt

Fordern Sie eine kostenlose zweiwöchige Testversion und damit die Zugangsdaten des Dienstes an. Die Anmeldung erfolgt über OAuth 2.0 mit dem Verfahren „client credentials“: Ihr System holt ein Zugriffstoken und sendet es in jeder Anfrage mit.

Die vollständige Spezifikation ist im Format OpenAPI veröffentlicht und lässt sich lesen, erkunden und zur Erzeugung eines Clients in Ihrer eigenen Sprache nutzen, bevor eine einzige Zeile Anbindungscode geschrieben ist.