Zuletzt bearbeitet vor einem Monat
von Antje Schäfer

Maersk (API)

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

Um den Auftragstyp festzulegen, werden die Inhalte aus den Feldern <carrierBookingType> und <transportMode> der Übertragungsdatei von Maersk in das Feld Auftragstyp Importtext geschrieben.

Interpretation Zollware

Header / Zollware / IsCustomsGoods


Wenn "instructionTypeName": "Haulage Instructions" übermittelt wird dann durchsuche den Bereich "text" und schaue, ob es dort eine Nummer gibt, die mit 400 beginnt und 2452 endet. Dann setze IsCustomsGoods / Zollware = true.

Beispiel: "Att contains: Imo cl.3 - UN2618\nATC400040760420252452 by customer"

Interpretation der Codes: Tabelle aus Reiter xsd Werte Order, Link um die Spalte "Zollverfahren cs CONNECT" ergänzen und dort das Mapping aus der linken Tabelle reinschreiben

Interpretation NCTS

Haken setzen, wenn beim Zollverfahren folgende Werte übermittelt werden: 1N / 1P / AM / 1R / 13P

Kein Beispiel vorhanden

Interpretation Bemerkung Disponent

relatedCarriage > VesselPortCallEnd estimatedTimeOfArrival Textbaustein: "ETA: Inhalt aus Übermittlung"
relatedCarriage > VesselPortCallStart estimatedTimeOfDeparture Textbaustein: "ETD: Inhalt aus Übermittlung"
instructions text Wenn "instructionTypeName": "Haulage Instructions" Dann übernehme den Inhalt in das Feld

Interpretation Wegpunkttyp Datum von / bis

Es kommt auf die Übermittlung aus routepoint > transportActivity an.

Field "timestamp": "+01:00:00" doesn’t mean that “Germany is in Timezone UTC+1”, it means time difference between the timestamp we send (UTC TimeZone) and Location TimeZone.  you have to add that time difference to our timeStamps in order to calculate local time and you will get the same time window as we sent in PDF

Interpretation PIN

Hafen: "referenceTypeName": "Booking Reference Number"

Übernahme in das Feld wenn routePoint > transportActivity = 03 oder 04 Wenn "referenceTypeName": "PIN Number" dann schreibe das in routePoint > transportActivity = 03 oder 04 // Falls nicht übermittelt dann nehme "referenceTypeName": "Booking Reference Number"

Gestellung: "referenceTypeName": "Customer Reference" oder  "Customer Reference Number"

Übernahme in das Feld wenn routePoint > transportActivity = 05 oder 06

Depot: "referenceTypeName": "Booking Reference Number"

Übernahme in das Feld wenn routePoint > transportActivity = 01 oder 02

"referenceTypeName": "Freight Order Next"

Wenn Export und routePoint > transportActivity = 04 dann übernehme dies "referenceTypeName": "Freight Order Previous" Wenn Import und routePoint > transportActivity = 03 dann übernehme dies

Generelles

Beschreibung

Hinweis:Bitte beachten Sie, dass bei dieser Schnittstelle keine Rückmeldungen versendet werden.


Ä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


Allgemeine Informationen

Technik

Informationen über die notwendigen Einstellungen, die in der Software und auf dem Server vorgenommen werden, 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: