csHUB:FMS: Unterschied zwischen den Versionen

Version vom 28. Juni 2024, 14:57 Uhr

IN BEARBEITUNG

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.

Vorlage:Hinweisbox

Begriff	Erklärung
1:1	Hier werden die Daten ohne weitere Verarbeitung in cs JOB übernommen.
Matching	Hier muss ein Mitarbeiter 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 zu umfangreich und werden daher am Ende dieser Seite im Detail dargestellt.
Übersicht	Datei:csHUB:Lieferumfang FMS Revision 04 22 V1.pdf

Vorlage:TOClimit

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.

Datei:csHUB:image2022-4-20 7-39-46.png

Multistop

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.

Datei:csHUB:image2022-4-20 7-47-12.png

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" die Uhrzeit 00:00 Uhr und "End" die Uhrzeit 23:59 Uhr ergänzt.

Datei:csHUB:image2022-4-20 9-7-51.png

Datei:csHUB:image2022-4-20 9-7-11.png

Bei der <AddressData role="Terminal"> übernehmen wir nur die Zeitart "delivery".

Datei:csHUB:image2022-4-20 9-26-12.png

Datei:csHUB:image2022-4-20 9-25-29.png

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.

Datei:csHUB:FMS 1719235490706.png

In cs JOB sieht es demnach so aus:

Datei:csHUB:FMS 1719235618408.png

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.

Datei:csHUB:image2022-4-20 7-23-36.png

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.

Datei:csHUB:image2022-4-20 7-26-7.png

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.

Datei:csHUB:FMS 1719576872454.png

Das sieht in cs JOB dann wie folgt aus:

Datei:csHUB:FMS 1719577319979.png

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

Änderungshistorie
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	Rückmeldungen werden bei jedem Wegpunkt bei den Wegpunktstatus "Ankunft" und "Abgeschlossen" 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 in der Software und auf dem Server vorgenommen finden Sie hier:

Technik

Aufbau und Bedienung

Allgemeine Informationen zum Aufbau des Bearbeitungsfensters sowie Details der Bedienung finden Sie hier:

Aufbau und Bedienung

Allgemeine Konfigurationen

Hier erfahren Sie, welche Konfigurationen Sie für Ihre Auftragsschnittstelle vornehmen müssen:

Allgemeine Konfigurationen

Anlagetypen

Hier erklären wir Ihnen, wie die Software entscheidet, um welchen Anlagetyp es sich handelt:

Anlagetypen

@@ Zeile 103: / Zeile 103: @@
 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 <nowiki><Code codelist="UNIQUE"> ein Hashwert gebildet.</nowiki>
+=== 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.<br /><br />
+[[Datei:csHUB:FMS 1719576872454.png]]<br /><br />Das sieht in '''cs JOB''' dann wie folgt aus:<br /><br />[[Datei:csHUB:FMS 1719577319979.png]]
 ==Änderungshistorie==
@@ Zeile 119: / Zeile 128: @@
 |9.36.1.323
 |Supplement key "Auftragsvariante"
-|''Bei Übermittlung eines entsprechenden Supplement keyswird der Text "Warstein" in das Feld Auftragsvariante Importtext / OrderVariantImportText geschrieben --> spezifisch für EKB?''
+|Bei Übermittlung eines entsprechenden Supplement keys wird der Text "Warstein" in das Feld Auftragsvariante Importtext / OrderVariantImportText geschrieben.
 |255873
 |-
@@ Zeile 125: / Zeile 134: @@
 |9.36.1.322
 |Storno
-|Bei Storno werden alle Container, die zu einem Auftrag gehören, storniert. ''---> Doku nötig?''
+|Bei Storno werden alle Container, die zu einem Auftrag gehören, storniert.
 |255024
-|-
-|06 24 V1
-|9.35.0.27
-|Rückmeldung (NEU)
-|''Doku nötig? nein''
-|202493
 |-
 |06 24 V1
 |9.34.2.171
 |Kundenmatchcode / Importtext unvollständig
-|Im Feld <nowiki>'''Matchcode Auftraggeber'''</nowiki> stehen neben dem Namen jetzt auch Straße, PLZ und der Ort ''Vermerk in Excel-Datei''
+|Im Feld '''Matchcode Auftraggeber''' stehen neben dem Namen jetzt auch Straße, PLZ und der Ort.
 |239356
 |-
@@ Zeile 143: / Zeile 146: @@
 |9.34.0.340
 |Statusmeldung (IsoCode)
-|Der ISO-Code wird aus dem Lademitteltyp im Auftrag übernommen, alternativ aus dem Feld "Gruppen-ISO-Code". Sind beide Felder leer, wird keiner übernommen. ''Excel-Datei: ISO-Code = Matching''
+|Der ISO-Code wird aus dem Lademittel übernommen, alternativ aus dem Feld '''Gruppen-ISO-Code.''' Ist beides leer, wird keiner übernommen.
 |203467
 |-
@@ Zeile 149: / Zeile 152: @@
 |9.34.0.319
 |Rückmeldung
-|''Ist-Zeiten der Wegpunkte sind bereits in der Excel-Datei. Doku nötig?''
+|Rückmeldungen werden bei jedem Wegpunkt bei den Wegpunktstatus "Ankunft" und "Abgeschlossen" erstellt.
 |204179
-|-
+|- style="height:25px;"
 |06 24 V1
 |9.33.2.193
 |Status Response Ergänzung / Veränderung "Externe Wegpunkt-ID"
-|''Info Erstellung WegpunktID wie bei MSC?''
+|Die '''Externe Wegpunkt-ID''' wird in einem Hash-Wert dargestellt.
 |201611
 |-
@@ Zeile 161: / Zeile 164: @@
 |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. ''--> Siehe Interpretation''
+|Gibt es mehrere Zeilen mit dem Typ <Name>, wird der Inhalt aller durch Semikolon getrennt in das entsprechende Feld übernommen.
 |200882
 |}