In dieser Übersicht finden Sie detaillierte Informationen zu den von FMS gelieferten Daten und wie diese von cs JOB übernommen und verarbeitet werden. Zudem zeigen wir Ihnen auf, welche Daten Sie an FMS zurückmelden können.
Die Schnittstelle ist durch ein ausgeklügeltes System in der Lage, sogar unstrukturierte Daten, sowie logistisch relevante Informationen in Freitextfeldern sinnvoll zu interpretieren und automatisiert in cs JOB zu verarbeiten.
In der Übersicht (PDF) und in den Ergänzenden Interpretationen finden Sie eine übersichtliche Erläuterung zu den jeweiligen Interpretationen und zu der Weiterverarbeitung in cs JOB.
Für Rückfragen zu diesen oder anderen Punkten stehen wir Ihnen natürlich sehr gerne zur Verfügung. Kontaktieren Sie einfach den Support.
| Begriff | Erklärung |
|---|---|
| 1:1 | Hier werden die Daten ohne weitere Verarbeitung in cs JOB übernommen. |
| Matching | Hier muss ein/e Mitarbeiter*in eine Zuordnung vornehmen. Einmal getätigte Zuordnungen müssen bei Folgeaufträgen nicht erneut getätigt werden. Die Software lernt so stets dazu und kann immer mehr Zuordnungen eigenständig vornehmen. |
| Interpretation | Diese Daten werden von der Universalschnittstelle Container interpretiert. Die übermittelten Daten passen im rohen Zustand nicht in cs JOB. |
| Hinweise | Hier finden Sie weiterführende Hinweise zu Feldern, wenn diese in cs JOB generiert werden sowie Erläuterungen zu den Interpretationen. Teilweise sind die Hinweise zu den Interpretationen sehr umfangreich und werden daher am Ende dieser Seite im Detail dargestellt. |
| Übersicht |
Interpretationen
Interpretation Wegpunkttypen
FMS übermittelt verschiedene Adressen. Diese Adressen sind immer einem Wegpunkttyp zugeordnet. Damit diese je Richtung (Import / Export) direkt zugeordnet werden können, ergänzen wir diese Informationen hinter jedem Wegpunkttyp Importtext.
Multistopp
Der Wegpunkttyp für einen Multistopp wird als <AddressData role="ServiceStop"> übermittelt. Da dieser für verschiedene Arten von Multistopps stehen kann, ergänzen wir zusätzlich den Inhalt aus Adressname 1.
Interpretation Datum von / Datum bis
Bei jeder Adresse werden entsprechende Zeiten übermittelt. Dabei gibt es drei Arten von Zeiten:
- delivery
- start
- end
Bei der Übermittlung werden in der Regel Datum und Uhrzeit gesendet. Kommt es allerdings zu dem Fall, dass nur ein Datum versendet wird, ergänzen wir die Uhrzeit. Dabei wird bei Start (Datum von) die Uhrzeit "00:00 Uhr" und End (Datum bis) die Uhrzeit "23:59 Uhr" ergänzt.
Bei der <AddressData role="Terminal"> übernehmen wir nur die Zeitart "delivery".
Interpretation Adressnamen
Wenn es mehrere Übermittlungen mit dem Typ <Name> gibt, werden alle Inhalte hintereinander in das entsprechende Feld übernommen. Die Trennung der Informationen erfolgt mit einem Semikolon.
In cs JOB sieht es demnach so aus:
Generelles
Mehrfachaufträge
Es besteht die Möglichkeit, dass mehrere Container in einem Auftrag übermittelt werden. Dies ist immer dann der Fall, wenn mehrere Positionen vom Typ <TransportContainer> vorhanden sind.
Bei einer Mehrfachübermittlung werden Aufträge entsprechend der Anzahl an Positionen <TransportContainer> erstellt. An die Referenznummer der erstellten Aufträge wird die jeweilige Positionsnummer aus <TransportContainer> angehängt.
Die erstellten Aufträge sind dabei identisch, lediglich die Inhalte innerhalb von <TransportContainer> können abweichend sein.
Erstellung einer Externen Wegpunkt ID
Die Externe Wegpunkt ID ist im Bereich cs HUB / Order zu einem Pflichtfeld geworden. Diese ID wird benötigt, um die Wegpunkte in einem Auftrag oder der Fahrt, bei einem Update, gezielt zu aktualisieren.
In dieser Schnittstelle wird die Externe Wegpunkt ID nicht mit übermittelt. Somit wird eine Erstellung der Externen Wegpunkt ID durch eine Programmierung seitens cargo support übernommen. Dabei wird aus dem Feld <Code codelist="UNIQUE"> ein Hashwert gebildet.
Supplement Key "Warstein"
Steht in der Übertragungsdatei eine Zeile mit dem Supplement key Warstein, die so aussieht wie im folgenden Bild, dann wird in das Feld Auftragsvariante Importtext in cs JOB das Wort "Warstein" geschrieben.
Das sieht in cs JOB dann wie folgt aus:
Änderungshistorie
Die Änderungshistorie bezieht sich auf den Lieferumfang und beschreibt die Änderungen der Spezifikation der jeweiligen Schnittstelle. Bitte informieren Sie sich regelmäßig über die jeweiligen Änderungen. Der Spalte Inhalt können sie entnehmen, ob es sich um eine Änderung, eine neu aufgenommene oder um eine Löschung einer Spezifikation handelt. Für Rückfragen können Sie sich auch gerne an unseren Support wenden.
| Revision | Version | Titel | Inhalt | User Story |
|---|---|---|---|---|
| 06 24 V1 | 9.36.1.323 | Supplement key "Auftragsvariante" | Bei Übermittlung eines entsprechenden Supplement keys wird der Text "Warstein" in das Feld Auftragsvariante Importtext / OrderVariantImportText geschrieben. | 255873 |
| 06 24 V1 | 9.36.1.322 | Storno | Bei Storno werden alle Container, die zu einem Auftrag gehören, storniert. | 255024 |
| 06 24 V1 | 9.34.2.171 | Kundenmatchcode / Importtext unvollständig | Im Feld Matchcode Auftraggeber stehen neben dem Namen jetzt auch Straße, PLZ und der Ort. | 239356 |
| 06 24 V1 | 9.34.0.340 | Statusmeldung (IsoCode) | Der ISO-Code wird aus dem Lademittel übernommen, alternativ aus dem Feld Gruppen-ISO-Code. Ist beides leer, wird keiner übernommen. | 203467 |
| 06 24 V1 | 9.34.0.319 | Rückmeldung | Bei jedem Wegpunkt bei den Wegpunktstatus "Ankunft" und "Abgeschlossen" werden Rückmeldungen erstellt. | 204179 |
| 06 24 V1 | 9.33.2.193 | Status Response Ergänzung / Veränderung "Externe Wegpunkt-ID" | Die Externe Wegpunkt-ID wird in einem Hash-Wert dargestellt. | 201611 |
| 06 24 V1 | 9.33.2.166 | Adressenamen werden nicht zusammengefügt | Gibt es mehrere Zeilen mit dem Typ <Name>, wird der Inhalt aller durch Semikolon getrennt in das entsprechende Feld übernommen. | 200882 |
Allgemeine Informationen
Technik
Informationen über die notwendigen Einstellungen, die in der Software und auf dem Server vorgenommen werden müssen, finden Sie hier:
Aufbau und Bedienung
Allgemeine Informationen zum Aufbau des Bearbeitungsfensters sowie Details zur Bedienung finden Sie hier:
Allgemeine Konfigurationen
Hier erfahren Sie, welche Konfigurationen Sie für Ihre Auftragsschnittstelle vornehmen müssen:
Anlagetypen
Hier erklären wir Ihnen, wie die Software entscheidet, um welchen Anlagetyp es sich handelt:
