Zuletzt bearbeitet vor 3 Monaten
von Andrea

csHUB:MSC: Unterschied zwischen den Versionen

Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
Zeile 78: Zeile 78:
[[Datei:csHUB:MSC 1704785892355.png]]
[[Datei:csHUB:MSC 1704785892355.png]]


 
==== Exportaufträge ====
* Für Exportaufträge gilt:
 
{| class="cuscosky"
{| class="cuscosky"
!'''Bezeichnung MSC'''
!'''Bezeichnung MSC'''
Zeile 98: Zeile 96:
|Referenz 3
|Referenz 3
|}
|}


=== Interpretation Wegpunkttypen ===
=== Interpretation Wegpunkttypen ===
Hier geht es darum, die PIN-Nummern den richtigen Wegpunkten zuzuordnen.
Das muss noch geschrieben werden.
 
=== Interpretation Freistellung / PIN ===
Beim ersten Wegpunkt wird der Inhalt aus dem Feld <referenceOut>  in das Feld '''PIN''' übernommen:
Beim ersten Wegpunkt wird der Inhalt aus dem Feld <referenceOut>  in das Feld '''PIN''' übernommen.


[[Datei:csHUB:MSC 1704970589989.png]]
[[Datei:csHUB:MSC 1704970589989.png]]
Zeile 109: Zeile 106:




Beim letzten Wegpunkt wird der Inhalt aus dem Feld <referenceIn>  in das Feld '''PIN'''  übernommen:
Beim letzten Wegpunkt wird der Inhalt aus dem Feld <referenceIn>  in das Feld '''PIN'''  übernommen.


[[Datei:csHUB:MSC 1704970659346.png]]
[[Datei:csHUB:MSC 1704970659346.png]]
Zeile 124: Zeile 121:


=== Interpretation Datum von / Datum bis ===
=== Interpretation Datum von / Datum bis ===
Soll ein Container aufgenommen werden, wird im Wegpunkttyp '''Aufnahme''' nur das Feld '''Datum von''' gefüllt. Das '''Datum bis''' bleibt leer. Die Logik greift, wenn im Bereich <transportDate> als Wegpunkttyp <type>loading</type> angegeben ist und im <transportPoint> als Ladeort <depot> angegeben ist. Ist unter <type>loading</type> weder Datum noch Uhrzeit eingetragen, wird auch nichts übernommen.
Soll ein Container aufgenommen werden, wird im Wegpunkttyp '''Aufnahme''' nur das Feld '''Datum von''' gefüllt.  
 
 


Hier ein Beispiel dazu:
Die Logik greift, wenn im Bereich <transportDate> als Wegpunkttyp <type>loading</type> angegeben ist und im <transportPoint> als Ladeort <depot> angegeben ist.


[[Datei:csHUB:MSC 1704894267107.png]]
[[Datei:csHUB:MSC 1704894267107.png]]




Ist unter <type>loading</type> weder Datum noch Uhrzeit eingetragen, wird auch nichts übernommen.


In den Menüs Container Import und Container Import Watchlist sieht es so aus:
In den Menüpunkten Container Import und Container Import Watchlist sieht es so aus.
[[Datei:csHUB:MSC 1704894603411.png|ohne|mini]]
[[Datei:csHUB:MSC 1704894603411.png|ohne|mini]]


Zeile 140: Zeile 136:
== Generelles ==
== Generelles ==


=== Abfragen / getDetails ===
=== Automatische Intervallabfragen ===
Die Transportdaten werden von MSC nicht aktiv an cargo support geschickt, sondern müssen von cargo support abgerufen werden. Das ist automatisch oder auch manuell möglich.  
Die Transportdaten werden von MSC nicht aktiv an cargo support geschickt, sondern müssen von cargo support abgerufen werden. Das ist automatisch oder auch manuell möglich.  


Zeile 166: Zeile 162:
Sobald sich der Auftrag im Status "Gefahren" befindet, wird die Abfrage beendet.
Sobald sich der Auftrag im Status "Gefahren" befindet, wird die Abfrage beendet.


 
=== Manuelle Abfragen ===
 
Das manuelle Abfragen der Transportdetails ist in '''cs JOB''' über den Reiter '''Auftragsbearbeitung''' möglich. Dort werden alle Aufträge, von denen Transportdaten abgefragt werden sollen, angehakt. Anschließend wird über '''Rechtsklick > Aktion > MSC Details anfragen''' die Abfrage der getDetails ausgelöst. Dadurch werden alle Aufträge, die die Auftragsquelle Order / MSC haben, bei MSC angefragt. Wurden versehentlich andere Aufträge markiert, die keine oder eine andere Auftragsquelle haben, werden diese einfach ignoriert.
Das manuelle Abfragen der Transportdetails ist in '''cs JOB''' über den Reiter '''Auftragsbearbeitung''' möglich. Dort werden alle Aufträge, von denen Transportdaten abgefragt werden sollen, angehakt. Anschließend wird über '''Rechtsklick > Aktion > MSC Details anfragen''' die Abfrage der getDetails ausgelöst. Dadurch werden alle Aufträge, die die Auftragsquelle Order / MSC haben, bei MSC angefragt. Wurden versehentlich andere Aufträge markiert, die keine oder eine andere Auftragsquelle haben, werden diese einfach ignoriert.
[[Datei:csHUB:MSC 1704789535733.png|ohne|mini]]
[[Datei:csHUB:MSC 1704789535733.png|ohne|mini]]
Zeile 185: Zeile 180:
!'''User-Story'''
!'''User-Story'''
|-
|-
|R 01 22 V1
|R 01 24 V1
|9.33.2.139
|x.xx.x.xxx
|Lademittel
|Lademittel
|Beispielinhalt
|Beispielinhalt

Version vom 12. Januar 2024, 08:17 Uhr

In dieser Übersicht finden Sie detaillierte Informationen zu den von MSC gelieferten Daten und wie diese von cs JOB übernommen und verarbeitet werden. Zudem zeigen wir Ihnen auf, welche Daten Sie an MSC 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 In Bearbeitung


Vorlage:TOClimit


Interpretationen

Interpretation Referenzen

Hier zeigen wir Ihnen, mit welchen Inhalten die Referenzfelder 1-3 in den Menüpunkten Container Import und Container Import Watchlist in cs JOB gefüllt werden. Dabei wird zwischen Neuanlage und Änderung unterschieden.

Bei der Neuanlage in Revision 1 wird der übermittelte Inhalt aus dem Feld <orderReference> in das Feld Referenz 1 eingetragen.

Datei:csHUB:MSC 1704719567790.png


Datei:csHUB:MSC 1704719650432.png


Mit dem Eingang der fehlenden Auftragsdaten, also ab Revision 2, gibt es dann folgende Logik bei der Übernahme der Referenzen:

Importaufträge

Bezeichnung MSC Datenursprung Feld cargo support
B/L <sendersFileReferenceNumber> Referenz 1
PO# <orderReference> Referenz 2
Release <turnOutReference> Referenz 3


Zum Beispiel wird die B/L-Nummer aus dem Feld <sendersFileReferenceNumber> in das Feld Referenz 1 in cs JOB geschrieben.

Datei:csHUB:MSC 1704785776222.png

Datei:csHUB:MSC 1704785892355.png

Exportaufträge

Bezeichnung MSC Datenursprung Feld cargo support
Booking Number <sendersFileReferenceNumber> Referenz 1
PO# <orderReference> Referenz 2
B/L wird aktuell nicht übermittelt Referenz 3

Interpretation Wegpunkttypen

Das muss noch geschrieben werden.

Interpretation Freistellung / PIN

Beim ersten Wegpunkt wird der Inhalt aus dem Feld <referenceOut> in das Feld PIN übernommen.

Datei:csHUB:MSC 1704970589989.png


Beim letzten Wegpunkt wird der Inhalt aus dem Feld <referenceIn> in das Feld PIN übernommen.

Datei:csHUB:MSC 1704970659346.png


Bei allen anderen Wegpunkten werden die Inhalte sowohl aus dem Feld <referenceOut> als auch <referenceIn> übernommen. Wenn beide Felder gefüllt sind, werden die Inhalte mit einem | getrennt.

Datei:csHUB:MSC 1704970846754.png

Daraus ergibt sich folgende Ansicht im Menü Container Import und Container Import Watchlist:


Interpretation Datum von / Datum bis

Soll ein Container aufgenommen werden, wird im Wegpunkttyp Aufnahme nur das Feld Datum von gefüllt.

Die Logik greift, wenn im Bereich <transportDate> als Wegpunkttyp <type>loading</type> angegeben ist und im <transportPoint> als Ladeort <depot> angegeben ist.

Datei:csHUB:MSC 1704894267107.png


Ist unter <type>loading</type> weder Datum noch Uhrzeit eingetragen, wird auch nichts übernommen.

In den Menüpunkten Container Import und Container Import Watchlist sieht es so aus.


Generelles

Automatische Intervallabfragen

Die Transportdaten werden von MSC nicht aktiv an cargo support geschickt, sondern müssen von cargo support abgerufen werden. Das ist automatisch oder auch manuell möglich.

Für das automatische Abrufen sind folgende Abfragezeitpunkte werktags zwischen 07:00 und 20:00 Uhr MEZ definiert:

Zeitpunkt vor dem ersten Wegpunktdatum Abfragefrequenz
Ab 3 Wochen täglich um 18:00 Uhr
Ab 7 Tage täglich um 07:00 Uhr / 13:00 Uhr / 18:00 Uhr
Ab 5 Tage alle 4 Stunden mit 07:00 Uhr beginnend
Ab 3 Tage alle 3 Stunden mit 07:00 Uhr beginnend
Ab 1 Tag alle 2 Stunden mit 07:00 Uhr beginnend

Sobald sich der Auftrag im Status "Gefahren" befindet, wird die Abfrage beendet.

Manuelle Abfragen

Das manuelle Abfragen der Transportdetails ist in cs JOB über den Reiter Auftragsbearbeitung möglich. Dort werden alle Aufträge, von denen Transportdaten abgefragt werden sollen, angehakt. Anschließend wird über Rechtsklick > Aktion > MSC Details anfragen die Abfrage der getDetails ausgelöst. Dadurch werden alle Aufträge, die die Auftragsquelle Order / MSC haben, bei MSC angefragt. Wurden versehentlich andere Aufträge markiert, die keine oder eine andere Auftragsquelle haben, werden diese einfach ignoriert.


Ä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 "Art der Änderung" 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
R 01 24 V1 x.xx.x.xxx Lademittel Beispielinhalt XXXXXX

Allgemeine Informationen

Technik

Informationen über die notwendigen Einstellungen in der Software und auf dem Server vorgenommen finden Sie hier:

Aufbau und Bedienung

Allgemeine Informationen zum Aufbau des Bearbeitungsfensters sowie Details der 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: