InnerWeb
Zum Inhalt springen

Anbindung der Lieferavisierung per SOAP: Hinweise zur Umsetzung

Der Abruf der Lieferdaten über den Kartencode erfolgt per SOAP und erfordert Implementierungsarbeiten auf beiden Seiten. Die IT des Kunden und der Anbieter des Avisierungssystems sollten vor dem Start einige Punkte abstimmen: den Schlüssel, den Umfang der Felder, das Verhalten bei unbekannten Codes und den Zugriff auf die Telemetrie.

5
Schritte der Einführung der Anbindung
Quelle: Umsetzungsempfehlung
5 Zeichen
maßgeblicher Code der Avisierungskarte
Quelle: Funktionsblatt Lieferungen

Umfang der Anbindung und was wir nicht versprechen

Das Modul Lieferungen und Avisierungen in InnerWeb ruft nach der Eingabe des Kartencodes die Daten der geplanten Lieferung aus dem Avisierungssystem des Kunden ab und füllt das Formular vor. Die Anbindung erfolgt per SOAP. Wir versprechen keine Anbindung an ein beliebiges Avisierungssystem ohne Implementierungsarbeiten, denn jedes System hat eigene Felder, Einschränkungen und eine eigene Art, Daten zurückzugeben.

InnerWeb ist ein eigenständiges System, das die vorhandenen Systeme des Kunden ergänzt. Das Avisierungssystem bleibt die Quelle des Lieferplans, und unsere Seite verantwortet die Verarbeitung der Daten und das Verhalten am Tor.

Die Umsetzungsschritte der Reihe nach

Die Reihenfolge der Arbeiten ist wichtig, denn viele Probleme zeigen sich erst am Tor, wenn der Fahrer wartet. Wir empfehlen fünf Schritte.

  • Schritt 1: Abstimmung des SOAP-Dienstvertrags, also der Eingabe- und Ausgabefelder
  • Schritt 2: technischer Zugang und Testumgebung auf Seiten des Avisierungssystems
  • Schritt 3: Zuordnung der Felder der Avisierung zu den Feldern der Lieferung in InnerWeb
  • Schritt 4: Tests mit echten, nicht existierenden und bereits abgeschlossenen Lieferungen
  • Schritt 5: Probebetrieb an einem Tor mit aktivierter Telemetrie der Suchen

Beispielhafter Anteil der Arbeit an den Schritten der Anbindung (Beispielkalkulation)

Beispielhafter Anteil der Arbeit an den Schritten der Anbindung (Beispielkalkulation)Balkendiagramm: Vertrag 15 Prozent, Zugang 15, Zuordnung 25, Tests 30, Probebetrieb 150102030%SOAP-Vertrag: 15 %15 %SOAP-VertragZugang und Umgebung: 15 %15 %Zugang undUmgebungZuordnung der Felder: 25 %25 %Zuordnung derFelderTests: 30 %30 %TestsProbebetrieb: 15 %15 %Probebetrieb
Quelle: Beispielkalkulation: angenommene Aufteilung der Arbeit, keine Daten des Kunden

Abstimmungen, ohne die die Anbindung nicht gelingt

Die folgenden Punkte halten Sie am besten in einem Abstimmungsprotokoll fest, das beide Seiten unterzeichnen, bevor der erste Test beginnt.

Verbindender Schlüssel und Format des Codes

Der Code der Avisierungskarte ist ein eigenes Feld der Lieferung und dient als Schlüssel, der die Lieferung in InnerWeb mit dem Datensatz im Avisierungssystem des Kunden verknüpft. Die Abfrage erfolgt über einen einheitlichen fünfstelligen Schlüssel, und führende Nullen, die der Werkschutz eingibt, ändern das Ergebnis nicht. Der Anbieter des Avisierungssystems muss bestätigen, dass dieses Format zu seinen Codes passt.

Verhalten bei unbekannten Codes und abgeschlossenen Transporten

Ein externes System kann für unbekannte Codes den zuletzt abgeschlossenen Transport zurückgeben. Deshalb wird eine Lieferung mit abgeschlossenem Transport im Avisierungssystem bewusst als fehlende Daten behandelt, damit es nicht zu einer falschen Identifizierung des Fahrers und zu einem Problem nach der DSGVO kommt. Der Anbieter sollte beschreiben, wie sein Dienst auf einen unbekannten Code antwortet, und die IT des Kunden sollte dies durch einen Test bestätigen.

Pflichtfelder und fehlende Angaben

Die Art des Vorgangs aus der Avisierung bestimmt das Kennzeichen der Lieferung, und der Name des Abfertigungspunkts wird den Codes für Lager und Rampen zugeordnet. Fehlt in der Avisierung der Spediteur, setzt das System einen Ersatzspediteur ein. Sinnvoll ist, mit dem Anbieter festzulegen, welche Felder der Avisierung auf seiner Seite verpflichtend sind, damit ein fehlender Spediteur nicht zur Regel wird.

Typische Fallstricke der Einführung

Der erste Fallstrick ist eine Abweichung zwischen den Namen der Abfertigungspunkte und den Rampencodes in InnerWeb. Die Zuordnung erfolgt über den Namen, daher bedeutet eine Abweichung in der Schreibweise eine Lieferung ohne zugewiesenes Lager. Vor den Tests müssen die Verzeichnisse abgeglichen werden.

Der zweite Fallstrick ist die Antwortzeit des Dienstes. Der Werkschutz wird am Tor keine Antwort abwarten, die mehrere Sekunden dauert. Die Antwortzeit jeder Suche erfasst die Telemetrie, daher sollten die Grenzen für eine akzeptable Zeit bereits vor dem Start anhand der Testdaten festgelegt werden.

Der dritte Fallstrick sind die Wartungsfenster des Avisierungssystems. Ist der Dienst nachts nicht erreichbar, der Betrieb aber rund um die Uhr in Betrieb, braucht der Werkschutz ein Verfahren für das manuelle Anlegen einer Lieferung, denn eine ausbleibende Antwort des Systems bedeutet fehlende Daten.

Telemetrie als Teil der Abstimmung

Jede Suche per Kartencode der Avisierung wird in der Telemetrie gespeichert: Code, Ergebnis, Status, Antwortzeit und Quelle. Vereinbaren Sie mit dem Anbieter von vornherein, dass diese Einträge die Grundlage für die Besprechung von Meldungen über nicht funktionierende Karten sind. Ein Streit darüber, wer recht hat, endet dann bei den Zahlen.

Zur Abstimmung gehört auch der Datenschutz: wer die Kartencodes sieht, wie lange die Einträge aufbewahrt werden und wer Einsicht verlangen darf. Diese Festlegungen sollten Sie mit dem Datenschutzbeauftragten des Kunden abstimmen.

Videomaterial

Häufig gestellte Fragen

Ist die Anbindung an das Avisierungssystem sofort einsatzbereit?

Nein. Die Anbindung erfolgt per SOAP und erfordert Implementierungsarbeiten auf beiden Seiten. Ohne diese versprechen wir keine Anbindung an ein beliebiges Avisierungssystem.

Was geschieht mit einer Lieferung, deren Transport im Avisierungssystem abgeschlossen wurde?

Sie wird bewusst als fehlende Daten behandelt, weil ein externes System für unbekannte Codes den zuletzt abgeschlossenen Transport zurückgeben kann, was zu einer falschen Identifizierung des Fahrers führen könnte.

Was soll der Werkschutz tun, wenn der Dienst der Avisierung nicht erreichbar ist?

Die Lieferung nach dem vorbereiteten Verfahren manuell anlegen. Eine ausbleibende Antwort des Systems wird wie fehlende Daten behandelt.

Quellen

Planen wir die Anbindung an Ihr Avisierungssystem

Vereinbaren Sie ein Gespräch mit unserem Team. Gemeinsam mit der IT Ihres Betriebs und dem Anbieter der Avisierung halten wir Vertrag und Schritte der Arbeiten fest.

Sprechen wir