Lokaler Simulator und empfohlenes Vorgehen bei der Anbindung

Für die Entwicklung einer Anbindung an SLON EIC steht ein lokaler Simulator zur Verfügung. Damit kann ein externes System die komplette Schnittstelle durchlaufen, ohne dass ein installierter SLON EIC, Zugangsdaten zur SLON Plattform oder eine Verbindung zur SLON Plattform notwendig sind.

Dieser Artikel beschreibt den Simulator und das von SLON empfohlene dreistufige Vorgehen bei der Anbindung eines ERP-Systems. Den Ablauf der Transportbeauftragung selbst finden Sie unter Transportbeauftragung über SLON EIC.

Der Simulator bildet die Schnittstelle nicht nach, sondern verwendet dieselben Programmbausteine wie der echte SLON EIC. Simuliert wird ausschließlich das Verhalten der SLON Plattform dahinter.

Dadurch ist sichergestellt, dass eine gegen den Simulator entwickelte Anbindung denselben Vertrag verwendet wie eine Anbindung an den echten SLON EIC.

SLON empfiehlt, die Anbindung eines ERP-Systems in drei aufeinander aufbauenden Phasen umzusetzen. Jede Phase setzt voraus, dass die vorhergehende erfolgreich abgeschlossen wurde.

  Phase 1 – Prozess explorativ kennenlernen
  ┌─────────────┐      ┌────────────────────────────┐
  │ Test-Client │ ───► │ Simulator                  │
  └─────────────┘      │ angenommene Daten          │
                       └────────────────────────────┘

  Phase 2 – Anbindung programmieren und testen
  ┌─────────────┐      ┌────────────────────────────┐
  │ ERP-System  │ ───► │ Simulator                  │
  └─────────────┘      │ angenommene Daten          │
                       └────────────────────────────┘

  Phase 3 – Abnahme gegen die SLON Plattform
  ┌─────────────┐      ┌───────────┐      ┌────────────────┐
  │ ERP-System  │ ───► │ SLON EIC  │ ───► │ SLON Plattform │
  └─────────────┘      └───────────┘      │ Echtdaten      │
                                          └────────────────┘

Aufbau: Test-Client → Simulator

In der ersten Phase wird der gesamte Prozess mit dem Test-Client durchgespielt, noch ohne eine Zeile Programmcode im ERP-System. Ziel ist, den Ablauf und die ausgetauschten Daten zu verstehen.

1. Starten Sie den Simulator.
2. Starten Sie den Test-Client und richten Sie ihn auf die Adresse des Simulators.
3. Durchlaufen Sie einen vollständigen Transportauftrag: Erfassung, Senden, Preisabfrage, Bestätigung, Statusverfolgung und Etikett-Download.
4. Aktivieren Sie im Test-Client die Klartext-Ausgabe der Aufrufe, um Request und Response jedes Schritts nachzuvollziehen.

Aufbau: ERP-System → Simulator

In der zweiten Phase wird die Anbindung im ERP-System entwickelt und gegen den Simulator getestet. Da keine Verbindung zur SLON Plattform besteht, können Sie beliebig oft testen, ohne Transportaufträge auf der Plattform zu erzeugen.

1. Richten Sie das ERP-System auf die Adresse des Simulators.
2. Entwickeln und testen Sie den vollständigen Ablauf inklusive Bestätigung und Statusverfolgung.
3. Testen Sie gezielt auch die Fehlerfälle (siehe Abschnitt „Fehlerfälle gezielt auslösen„).

Aufbau: ERP-System → SLON EIC → SLON Plattform

Erst wenn in Phase 2 alle Tests erfolgreich sind, erfolgt der Test gegen die echte Umgebung. Dazu wird der Simulator durch einen installierten SLON EIC mit Verbindung zur SLON Plattform ersetzt.

1. Installieren und konfigurieren Sie SLON EIC mit den von SLON bereitgestellten Zugangsdaten.
2. Richten Sie das ERP-System auf die Adresse des SLON EIC.
3. Führen Sie einen vollständigen Abnahmelauf durch.

Die folgenden Punkte werden vom Simulator bewusst nicht nachgebildet und können ausschließlich in Phase 3 geprüft werden:

• Adressprüfung und Geokodierung – ob eine Adresse tatsächlich in die Datenkontrolle gelangt, entscheidet erst die SLON Plattform.
• Preisberechnung – der Preis des Simulators ist ein fester, angenommener Wert.
• Aufteilung und Routenplanung des Transportauftrags.
• Gültigkeit der IDs von Logistiknetzwerken, Lagereinheiten und Transportoptionen.
• Inhalt von Barcode-Etikette und Lieferschein – der Simulator liefert Platzhalter-Dokumente ohne Barcode. Diese sind nicht scannbar und dürfen nicht produktiv verwendet werden.

Für eine belastbare Anbindung ist es wichtig, nicht nur den fehlerfreien Ablauf zu testen. Der Simulator kann die relevanten Fehler- und Sonderfälle gezielt erzeugen.

Zwei Sonderfälle werden über eine Kennung im Feld externalDocumentId ausgelöst – also in dem Feld, in dem Ihr ERP-System beim Senden des Transportauftrags seine eigene Belegnummer übergibt. Es genügt, wenn die Kennung an beliebiger Stelle im Wert vorkommt; Groß- und Kleinschreibung sind unerheblich. Ihr gewohntes Nummernschema bleibt dadurch erhalten, zum Beispiel ERP-SIM-ROUTEFAIL-3001.

Der Simulator wird zusammen mit dem Test-Client und der OpenAPI-Spezifikation bereitgestellt. Eine ausführliche technische Beschreibung inklusive aller Startoptionen liegt dem Simulator bei.

• Einleitung zum Datenaustausch mit externer Software
• Transportbeauftragung über SLON EIC
• Verfügbare SLON EIC Schnittstellen