Marine Traffic (Kpler)
Inhalt
Weiterführende Seiten
Stammdaten
ADMIN → EDI → EDI PARTNER
Der Provider Kpler wird mit Einrichtung der Schnittstelle in den Stammdaten automatisch durch CargoSoft angelegt.
ADMIN → STATUSARTEN → STATUSEVENTS
Mit Einrichtung der Schnittstelle werden die erforderlichen Statuscodes und Einstellungen für die Statusanfrage für den Provider Kpler in den Stammdaten angelegt.
Diese können, sofern notwendig, individuell angepasst werden.
Statusmeldung und Statuscode
Folgende Statusmeldungen werden übermittelt und werden im Reiter EDI-Status verarbeitet:
Statuscode | Statusbezeichnung |
|---|---|
CEP | Container empty to shipper |
CPS | Container pickup at shipper |
CGI | Container arrival at first POL (Gate-in) |
CLL | Container loaded at first POL |
VDL | Vessel departure from first POL |
VAT1,2,3,4,5 | Vessel arrival at T/S port 1,2,3,4,5 |
CDT1,2,3,4,5 | Container discharge at T/S port1,2,3,4,5 |
CLT1,2,3,4,5 | Container loaded at T/S port 1,2,3,4,5 |
VDT1,2,3,4,5 | Vessel departure from T/S 1,2,3,4,5 |
VAD | Vessel arrival at final POD |
CDD | Container discharge at final POD |
CGO | Container departure from final POD (Gate-out) |
CIF | Container arrival at last inland facility (Gate-in) |
ECEP | Container empty estm. to shipper |
ECPS | Container pickup estm. at shipper |
ECGI | Container arrival estm. at first POL (Gate-in) |
ECLL | Container loaded estm. at first POL |
EVDL | Vessel departure estm. from first POL |
EVAT1,2,3,4 | Vessel arrival estm. at T/S port 1,2,3,4 |
ECDT1,2,3,4 | Container discharge estm. at T/S port1,2,3,4 |
ECLT1,2,3,4 | Container loaded estm. at T/S port 1,2,3,4 |
EVDT1,2,3,4 | Vessel departure estm. from T/S 1,2,3,4 |
EVAD | Vessel arrival estm. at final POD |
ECDD | Container discharge estm. at final POD |
ECGO | Container departure estm. from final POD (Gate-out) |
ECIF | Container arrival estm. at last inland facility (Gate-in) |
FUNCERROR | Functional error |
FUNCOK | Functional error |
ROL | Rollover warning |
CGOT1,2,3,4 | Container gate out at T/S port 1,2,3,4 |
CGIT1,2,3,4 | Container gate in at T/S port 1,2,3,4 |
Folgende Einstellungen in den Statusevents sind als Standart definiert und ausgeliefert:
Statusampel
Statuscode FUNCERROR / Functional error hat in der Statusampel die Farbe Rot
Statuscode FUNCOK / Functional ok hat in der Statusampel die Farbe Grün
Stautscode ROL / Rollover warning hat in der Statusampel die Farbe Gelb
Diese Status werden mit der entsprechenden Farbe im EDI-Status-Reiter markiert.
Füllt-Feld-Regeln
Folgende Füllt-Feld-Regeln sind bereits mit der Auslieferung aktiv:
Statuscode VDL/Vessel departure from first POL: Regel 002/tats. Abfahrtsdatum (ATD)
Statuscode EVDL/Vessel departure estm. from first POL: Regel 023/gepl. Abfahrtdatum (ETD)
Statuscode VAD/Vessel arrival at final POD: Regel 003/tats. Ankunftsdatum (ATA)
Statuscode EVAD/Vessel arrival estm. at final POD: 006/gepl. Ankunftsdatum (ETA)
Reiter Statusanforderung
Über den Reiter Statusanforderung im Auftrag werden die Statusanfragen gesendet.
Der Reiter muss über den Maskeneditor in den Auftrag eingebunden werden.
Statusanfrage senden
Die Anfrage kann entweder anhand der Containernummer, der Buchungsnummer und/oder der B/L-Nummer erfolgen.
Die Angabe des SCAC-Codes ist verpflichtend.
Über das Aktivieren der Checkbox Anfordern und Speichern wird die Statusanfrage an den Provider gesendet.
Die Statusanforderung kann auch automatisch erfolgen.
Folgende Bedingungen müssen erfüllt sein, damit die Automatik greift:
Globalsetting MARITIME_TRAFFIC_STATUS mit oder ohne Mandanteneinschränkung aktivieren
Bei Bedarf, damit nicht alle Senungen auch aus der Vergangenheit abgefragt werden, Globalsetting MARITIME_TRAFFIC_STATUS_FROM zusätzlich aktivieren, ab welchem Leistungsmonat der Trigger laufen soll
Seefracht Export oder Import
In der Akte muss eine Buchungsnummer und/oder eine OBL-Nr erfasst sein
Der SCAC-Code muss erfasst sein
In der Warenbeschreibung muss mindestens eine Zeile mit einem Container erfasst sein (kann auch ohne Container-Nr sein - einfach nur 1 C2 reicht). Hintergrund hierzu ist, dass dieses Sendungsverfolgung nur für FCL und nicht für LCL funktioniert
Folgende Global Setting stehen dazu zur Verfügung:
Für alle Mandanten wird die automatische Statusabfrage aktiviert:
Insert into Global_sett_t (schluessel , wert)values('MARITIME_TRAFFIC_STATUS' ,'J');
Für einen bestimmten Mandanten (001 ist hier Platzhalter für einen Mandanten) wird die automatische Statusabfrage aktiviert:
Insert into Global_sett_t (schluessel , wert)values('MARITIME_TRAFFIC_STATUS001', 'J');
Ab einem bestimmten Leistungsmonat (202611 ist hier Platzhalter für den Monat) wird die Statusabfrage aktiviert:
Insert into Global_sett_t (schluessel , wert)values('MARITIME_TRAFFIC_STATUS_FROM' , '202611');
Reiter EDI-Status
Ist die Abfrage aktiviert, werden fortlaufend die aktuellen Daten zum Container im Reiter EDI-Status angezeigt.
Der Reiter muss über den Maskeneditor in den Auftrag eingebunden werden.
Darstellung der Status auf dem EDI-Status-Reiter
Die Statuscodes für den Hauptlauf per Schiff werden auf Sendungsebene dargestellt.
Statuscodes, die das Handling an Land dokumentieren (wie z.B. Vorlauf per LKW/Bahn, Gate In, Gate Out, Beladen auf das Schiff, Entladen vom Schiff, ect.), werden auf Containerebene angezeigt.
Tracking URL
Beim Status FUNCOK/Functional ok wird unten, im Detailbereich für einen Statuscode auf dem EDI-Status-Reiter, die Tracking-URL zu der Sendung angezeigt.
Mit dieser URL kann jeder die Trackingdaten zu der entsprechenden Sendung auf der Marine Traffic Homepage aufrufen - auch ohne Account.
Zusätzlich findet eine Übertragung ins SCM Tracking statt und wird dort - bei entsprechender Konfiguration - angezeigt.
Ausnahme: Vor-/Nachlauf per Binnenschiff (Feeder)
Eine Ausnahme hierzu bildet der Vor- oder Nachlauf per Binnenschiff/Feeder. Die Status für diese Transportabschnitte werden im EDI-Statusreiter auch als Hauptlauf per Schiff auf Sendungsebene dargestellt.
Im Status wird zusätzlich der Mode of Transport mit Feeder (für Vor- oder Nachlauf per Binnenschiff) oder Maritime (Hauptlauf per Schiff) angezeigt. So kann unterschieden werden, für welchen Transportabschnitt der Status gilt.
Füllt-Feld-Regeln, die z.B. für ATA im POL oder ATD im POD in den Statusevents erfasst wurden, werden zusätzlich immer noch mit dem erfassten Hafen in der TMS-Position abgeglichen und nur gesetzt, wenn der Hafen im Status mit dem Hafen in der Position übereinstimmt.
So wird sichergestellt, dass die Füllt-Feld-Regel nur für den korrekten Ort greift.
Statusabfrage deaktivieren
Ist der Transport abgeschlossen, wird die Statusübermittlung automatisch für die Container des Auftrags eingestellt.
ACHTUNG: Eine manuelle Deaktivierung ist nicht möglich!