Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
| Beide Seiten der vorigen Revision Vorhergehende Überarbeitung | |||
| draft:rework:eic:transport_beauftragen [10.08.2026 23:00] – [DRAFT] Mailto-Fix: DokuWiki setzt das mailto: selbst florian | draft:rework:eic:transport_beauftragen [10.08.2026 23:01] (aktuell) – Draft published, cleaning up florian | ||
|---|---|---|---|
| Zeile 1: | Zeile 1: | ||
| - | ====== 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 [[rework: | ||
| - | |||
| - | <callout type=" | ||
| - | 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. | ||
| - | |||
| - | {{draft: | ||
| - | |||
| - | ==== 1. Transportanfrage senden ==== | ||
| - | |||
| - | Das externe System sendet die Transportanfrage an SLON EIC. Die Anfrage wird nicht sofort weitergeleitet, | ||
| - | |||
| - | Zusätzlich zur Transportanfrage kann optional ein Lieferschein angehängt werden. | ||
| - | |||
| - | <callout type=" | ||
| - | 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, | ||
| - | </ | ||
| - | |||
| - | ==== 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, | ||
| - | |||
| - | {{draft: | ||
| - | |||
| - | ==== 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. | ||
| - | |||
| - | <callout type=" | ||
| - | 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. | ||
| - | |||
| - | {{draft: | ||
| - | |||
| - | Die Vorgaben zur Positionierung dieser Etiketten finden Sie unter [[rework: | ||
| - | |||
| - | ==== 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. | | ||
| - | |||
| - | <callout type=" | ||
| - | Zusätzlich zur Abfrage per Polling besteht die Möglichkeit, | ||
| - | </ | ||
| - | |||
| - | ===== 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" | ||
| - | |||
| - | 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, | ||
| - | |||
| - | Besonders hilfreich für die Entwicklung ist die Möglichkeit, | ||
| - | |||
| - | {{draft: | ||
| - | |||
| - | ==== 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 [[rework: | ||
| - | |||
| - | <callout type=" | ||
| - | Der Simulator arbeitet ausschließlich mit angenommenen Daten und ersetzt die Abnahme gegen die SLON Plattform **nicht**. | ||
| - | </ | ||
| - | |||
| - | <callout type=" | ||
| - | OpenAPI-Spezifikation, | ||
| - | </ | ||
| - | |||
| - | ===== Weiterführende Artikel ===== | ||
| - | |||
| - | * [[rework: | ||
| - | * [[rework: | ||
| - | * [[rework: | ||