rework:eic:transport_beauftragen [SLON Knowledge Center]

Diese Seite ist nicht editierbar. Sie können den Quelltext sehen, jedoch nicht verändern. Kontaktieren Sie den Administrator, wenn Sie glauben, dass hier ein Fehler vorliegt.
====== 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:eic:start|SLON EIC – Datenaustausch mit externer Software]].

<callout type="info" title="Lizenz" icon="true">
SLON EIC ist ein Zusatzmodul zur SLON Plattform. Zur Aktivierung kontaktieren Sie bitte den SLON Support.
</callout>

===== 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:wiki:pasted:todo_screenshot_eic_transport_ablauf.png}}

==== 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.

<callout type="info" title="Vorteile der Warteschlange" icon="true">
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.
</callout>

==== 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.

{{draft:wiki:pasted:todo_screenshot_eic_pruefung_preis.png}}

==== 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="warning" title="WICHTIG" icon="true">
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.
</callout>

==== 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:wiki:pasted:todo_screenshot_eic_etiketten.png}}

Die Vorgaben zur Positionierung dieser Etiketten finden Sie unter [[rework:versand:etiketten|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. |

<callout type="info" title="Webhook" icon="true">
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.
</callout>

===== 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.

{{draft:wiki:pasted:todo_screenshot_eic_testclient.png}}

==== 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:eic:simulator|Lokaler Simulator und empfohlenes Vorgehen bei der Anbindung]].

<callout type="warning" title="Simulation" icon="true">
Der Simulator arbeitet ausschließlich mit angenommenen Daten und ersetzt die Abnahme gegen die SLON Plattform **nicht**.
</callout>

<callout type="info" title="Hinweis" icon="true">
OpenAPI-Spezifikation, Test-Client und Simulator richten sich an die technische Anbindung durch Entwickler. Für den Zugang und weitere Unterlagen wenden Sie sich bitte an den SLON Support: [[info@slon.bz.it|info@slon.bz.it]].
</callout>

===== Weiterführende Artikel =====

  * [[rework:eic:start|SLON EIC – Datenaustausch mit externer Software]]
  * [[rework:eic:schnittstellen|Verfügbare SLON EIC Schnittstellen]]
  * [[rework:eic:simulator|Lokaler Simulator und empfohlenes Vorgehen bei der Anbindung]]