Inhaltsverzeichnis
Transportbeauftragung über SLON EIC
Mit SLON EIC stellt SLON eine Edge-Applikation zur Verfügung, über die externe Systeme mit der SLON Plattform kommunizieren können. SLON EIC stellt dabei lokal verschiedene Konnektoren bereit, an die sich das externe System verbinden kann.
Dieser Artikel beschreibt den Prozess, über den ein externes System einen neuen Transportauftrag automatisiert an die SLON Plattform übergibt. Eine allgemeine Einführung finden Sie unter SLON EIC – Datenaustausch mit externer Software.
Lizenz
SLON EIC ist ein Zusatzmodul zur SLON Plattform. Zur Aktivierung kontaktieren Sie bitte den SLON Support.Ablauf der Transportbeauftragung
Die Beauftragung eines neuen Transportauftrags erfolgt in mehreren Prozessschritten. Das externe System übergibt die Transportanfrage an SLON EIC, welches die weitere Kommunikation mit der SLON Plattform übernimmt.
1. Transportanfrage senden
Das externe System sendet die Transportanfrage an SLON EIC. Die Anfrage wird nicht sofort weitergeleitet, sondern zunächst in die lokale Warteschlange von SLON EIC eingereiht.
Zusätzlich zur Transportanfrage kann optional ein Lieferschein angehängt werden.
Vorteile der Warteschlange
SLON EIC arbeitet die Warteschlange zyklisch ab. Dadurch werden Timeouts bei vielen Anfragen in kurzer Zeit automatisch vermieden. Gleichzeitig puffert die Warteschlange mögliche Netzwerkaussetzer, in denen die SLON Plattform nicht erreichbar ist – die Anfragen bleiben erhalten und werden weitergeleitet, sobald die Verbindung wiederhergestellt ist.2. Prüfung und Preisberechnung
SLON EIC leitet die Transportanfragen aus der Warteschlange nach und nach an die SLON Plattform weiter. Dort wird jede Transportanfrage zunächst geprüft.
- Ist eine Transportanfrage unvollständig oder fehlerhaft, gibt SLON EIC einen Fehler an das externe System zurück.
- Ist die Transportanfrage korrekt und vollständig, wird ein Preis berechnet und an das externe System zurückgegeben.
3. Transport bestätigen
Mit der zurückgegebenen Antwort kann das externe System den Transport bestätigen. Sobald der Transport bestätigt ist, beginnt die SLON Plattform mit der Abarbeitung des Transportauftrags.
WICHTIG
Erst mit der Bestätigung wird der Transportauftrag verbindlich in die Plattform übernommen und die Abarbeitung gestartet. Ohne Bestätigung wird der Transport nicht ausgeführt.4. Transportetiketten bereitstellen
Mit der Bestätigung des Transports werden – sofern in der Transportanfrage angegeben wurde, dass SLON die Transportetiketten generieren soll – die Barcode-Etiketten automatisch erzeugt und für den Download bereitgestellt.
Die Vorgaben zur Positionierung dieser Etiketten finden Sie unter Transportetiketten drucken und anbringen.
5. Statusverfolgung
Nach der Bestätigung kann das externe System über SLON EIC jederzeit den Status des Transports abfragen und wird so über jede Änderung informiert. Dafür stehen zwei Verfahren zur Verfügung:
| Verfahren | Beschreibung |
|---|---|
| Polling | Das externe System fragt den Transportstatus zyklisch über SLON EIC ab. |
| Webhook | Statusänderungen werden eventgetrieben an einen konfigurierten Endpunkt gemeldet, sobald sie eintreten. |
Webhook
Zusätzlich zur Abfrage per Polling besteht die Möglichkeit, einen Webhook zu konfigurieren. Änderungen werden dann nicht über zyklisches Abfragen, sondern eventgetrieben bekannt gegeben.Hilfsmittel für die Anbindung
OpenAPI-Spezifikation
Die REST-Schnittstelle von SLON EIC ist vollständig in einer OpenAPI-Spezifikation beschrieben. Diese dient als verbindliche Referenz („Single Source of Truth„) für den Vertrag zwischen dem externen System und SLON EIC und dokumentiert sämtliche Endpunkte, Datenfelder, Statuswerte und Fehlermeldungen.
Anhand der Spezifikation können auf Kundenseite passende Client-Bibliotheken automatisch generiert und die Anbindung strukturiert entwickelt werden. Die aktuelle Spezifikation stellt Ihnen der SLON Support auf Anfrage zur Verfügung.
Test-Client
Zusätzlich steht ein Test-Client zur Verfügung – eine kleine Konsolenanwendung, mit der die Transportbeauftragung ohne fertige Anbindung ausprobiert werden kann. Der Test-Client führt interaktiv durch die Erfassung eines Transportauftrags und durchläuft den kompletten Ablauf: Senden, Preisabfrage, Statusverfolgung und Etikett-Download.
Besonders hilfreich für die Entwicklung ist die Möglichkeit, sämtliche API-Aufrufe im Klartext anzuzeigen: Zu jedem Schritt werden der zugehörige Request und die Response ausgegeben – Methode, URL, Header und Inhalt. So lässt sich die exakte Nutzung der Schnittstelle anhand eines echten Datenaustauschs nachvollziehen und als Vorlage für die eigene Anbindung verwenden.
Simulator
Für die Entwicklung steht darüber hinaus ein lokaler Simulator zur Verfügung, mit dem die komplette Schnittstelle durchlaufen werden kann, ohne dass ein installierter SLON EIC, Zugangsdaten oder eine Verbindung zur SLON Plattform notwendig sind. Dadurch können Sie beliebig oft testen, ohne Transportaufträge auf der SLON Plattform zu erzeugen.
Das von SLON empfohlene dreistufige Vorgehen finden Sie unter Lokaler Simulator und empfohlenes Vorgehen bei der Anbindung.