Quelltext der Seite csHUB:FMS

{{DISPLAYTITLE:Fr. Meyer's Sohn (FMS)}}
<bs:bookshelf src="Buch:Cs HUB" />

'''<span class="col-red">IN BEARBEITUNG</span>'''<br /><br />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.

{{Hinweisbox|boxtype=Erfolg|icon=ja|header=|Note text=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.|bgcolor=}}


{| class="bs-exportable cuscosky"
!'''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|alternativtext=|ohne|mini|212x212px]]
|}
<br />{{TOClimit|limit=2}}

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

&#xAD;

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

<br /><br />[[Datei:csHUB:FMS 1719235490706.png]]<br /><br />

In '''cs JOB''' sieht es demnach so aus:<br /><br />
[[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.<br /><br />

[[Datei:csHUB:image2022-4-20 7-26-7.png]]<br /><br />

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


{| class="mw-collapsible mw-collapsed cuscosky"
|+Ä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
|- style="height:25px;"
|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:
*[[Vorlage:Order/Technik|Technik]]
===Aufbau und Bedienung===
Allgemeine Informationen zum Aufbau des Bearbeitungsfensters sowie Details der Bedienung finden Sie hier:
*[[Vorlage:Order/Aufbau_und_Bedienung|Aufbau und Bedienung]]

===Allgemeine Konfigurationen===
Hier erfahren Sie, welche Konfigurationen Sie für Ihre Auftragsschnittstelle vornehmen müssen:
*[[Vorlage:Order/Allgemeine_Konfiguration|Allgemeine Konfigurationen]]
===Anlagetypen===
Hier erklären wir Ihnen, wie die Software entscheidet, um welchen Anlagetyp es sich handelt:
*[[Vorlage:Order/Anlagetypen|Anlagetypen]]
[[Category:Order]]
[[Category:Cs hub]]