Transportbeauftragung über SLON EIC
Mit SLON EIC stellt SLON eine Edge-Applikation zur Verfügung, über welche externe Systeme mit der SLON Plattform kommunizieren können. SLON EIC stellt dabei lokal verschiedene Konnektoren bereit, an welche 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 zu SLON EIC finden Sie unter Einleitung zum 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, welche 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 und/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.
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.
Für die Statusverfolgung 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 ein zyklisches Abfragen, sondern eventgetrieben bekannt gegeben.Hilfsmittel für die Anbindung
Für die Anbindung des externen Systems an SLON EIC stehen zwei Hilfsmittel zur Verfügung, die den Entwicklungs- und Integrationsprozess unterstützen.
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 OpenAPI-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 Konsolen-Anwendung, 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, 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 (Methode, URL, Header und Inhalt) ausgegeben. So lässt sich die exakte Nutzung der Schnittstelle anhand eines echten Datenaustauschs nachvollziehen und als Vorlage für die eigene Anbindung verwenden.
