wiki:eic_transport_order [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 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 [[wiki:eic_intro|Einleitung zum 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, welche 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 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.

{{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}}

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

<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 ein zyklisches Abfragen, sondern eventgetrieben bekannt gegeben.
</callout>

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

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

<callout type="info" title="Hinweis" icon="true">
OpenAPI-Spezifikation und Test-Client richten sich an die technische Anbindung durch Entwickler. Für den Zugang und weitere Unterlagen wenden Sie sich bitte an den SLON Support.
</callout>

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

  * [[wiki:eic_intro|Einleitung zum Datenaustausch mit externer Software]]
  * [[wiki:eic_list_implemented|Verfügbare SLON EIC Schnittstellen]]