Diese Release Note richtet sich an die Bahnbetreiber.
Die ETA Train-Funktionalität ist in zwei Teile unterteilt:
- Einblick in den Standort des Zuges im Hinterland.
- Einblick in die Ankunfts- und Abfahrtszeiten des Zuges sowie in den Verlauf der Abläufe an den Deepsea-Terminals im Rotterdamer Hafen.
ETA Train im Hinterland
Um den Standort des Zuges im Hinterland abzurufen, müssen in der Rotation die incoming und/oder outgoing train number sowie die first departure date und/oder outgoing first departure date angegeben werden. Diese Daten können beim Erstellen einer neuen Rotation angegeben oder später zu einer bestehenden Rotation hinzugefügt bzw. dort geändert werden. Werden diese Daten nicht korrekt übermittelt, kann kein Abgleich mit den von einer externen Partei bereitgestellten Standortdaten des Zuges im Hinterland vorgenommen werden. Achten Sie außerdem darauf, der Rotation einen Traktionsanbieter zuzuweisen. Dadurch erhält auch der Traktionsanbieter Einblick in die Rotation und die dazugehörigen Daten und kann die erwarteten und tatsächlichen Ankunfts- und Abfahrtszeiten aktualisieren.
Verwenden Sie für die Übermittlung dieser Daten die Operator API – voyages. Dabei handelt es sich um die folgenden Felder:
- Incoming train number: trainNumber
- Outgoing train number: outgoingTrainNumber
- Incoming first departure date: firstDepartureDate
- Outgoing first departure date: outgoingTrainFirstDepartureDate
- Traktionsanbieter: tractionSupplier
Sobald die Daten korrekt eingegeben wurden, können die ETA Train-Daten für die verbleibenden Fahrplanpunkte abgerufen werden, die der Zug auf dem Weg zum Rotterdamer Hafen und/oder vom Rotterdamer Hafen zurück ins Hinterland passieren wird. Diese Punkte und damit auch die Daten für jeden einzelnen Punkt werden erst sichtbar, sobald der Zug den jeweiligen Punkt passiert hat. Standardmäßig handelt es sich dabei um den Abfahrtsort im Hinterland, den niederländischen Grenzübergang, Barendrecht Vork und die Güterbahnhöfe bei den Terminals.
Die ETA Train-Daten können nicht rückwirkend abgerufen werden. Das bedeutet, dass, wenn die erforderlichen Daten erst ab Barendrecht Vork korrekt übermittelt werden, die ETA Train-Informationen für den Abfahrtsort im Hinterland und den niederländischen Grenzübergang nicht mehr abgerufen werden können.
Verwenden Sie zum Abrufen der Standortdaten des Zuges aus dem Hinterland die Tracking API. Dabei geht es speziell um die trainLocationReports**, eine voyage-level list. Jeder Bericht enthält die folgenden Felder: operationalTrainNumber ,startDate, direction,trainAccessPointType,terminalShortName,trainLocationStatus,trainLocation,locationDateTime,bookedLocationDateTime,referencedLocationDateTime,trainDelay.
Bitte beachten Sie: Die Tracking API kann verwendet werden, um Echtzeit-Updates zu voyages, visits und (detached) handlings zu erhalten. Um diese Echtzeit-Updates zu ermöglichen, verwendet die API einen Mechanismus, der als ‘long polling’ bezeichnet wird. Wenn Sie eine Anfrage senden, um auf Updates zu warten, erhalten Sie sofort ein Update, wenn seit Ihrer letzten Anfrage eines stattgefunden hat. Wenn kein Update vorliegt, wartet die Anfrage, bis ein Update erfolgt, oder es kommt zu einem Time-out, sobald das von Ihnen angegebene maxTimeout erreicht ist. Nachdem die API-response zurückgegeben wurde und Ihr client die Verarbeitung der Updates abgeschlossen hat, müssen Sie Ihre Position immer aktualisieren. Auf diese Weise sucht die API bei Ihrer nächsten Anfrage nach Updates nach dieser Position im eventlog. Dieser Mechanismus ermöglicht auch batching, da Sie alle Updates so schnell erhalten, wie Sie diese verarbeiten können.
In Bezug auf die trainLocationReports ist es wichtig zu beachten, dass Sie Updates mit einer Vorher- und Nachher-Situation erhalten, in denen nur die Änderungen enthalten sind. Wenn also nur ein handling geändert wurde, erhalten Sie nur dieses handling innerhalb des visit innerhalb des voyage und nicht alle containers und visits. Dieselbe delta per item gilt für die trainLocationReports eines rail voyage: Jedes Update enthält nur die reports, die hinzugefügt oder geändert wurden, und nicht die reports, die Sie bereits in früheren Updates erhalten haben.
Weitere Informationen finden Sie im Hinterland Notification API Changelog.
ETA Train im Hafen Rotterdam
Dieser Teil der Funktionalität bietet Transparenz pro vorgemeldeter Visit über die Ankunfts- und Abfahrtszeiten sowie den Fortschritt der Abfertigung. Hierfür stehen die unten aufgeführten Datenfelder zur Verfügung. Alle diese Daten können von allen an der Visit beteiligten Parteien abgerufen werden.
- Estimated time of arrival (ETA)
- Übermitteln
- Rail Operator: übermittelt die ETA bei der Erstellung einer Visit. Werden timetable slots verwendet, wird der Beginn des Slots automatisch als ETA übernommen. Sowohl die ETA als auch der timetable slot können anschließend aktualisiert werden.
- Terminal & Traction Supplier: können die ETA aktualisieren.
- Abrufen
- Rail Operator, Traction Supplier und Terminal können die von den anderen Parteien übermittelte ETA über die Tracking API abrufen.
- Übermitteln
- Grund der Verspätung
- Übermitteln
- Traction Supplier: kann den Grund einer Zugverspätung übermitteln.
- Abrufen
- Mithilfe des Verspätungsgrundes können Terminal und Rail Operator die erwartete Dauer und die Auswirkungen der Verspätung besser einschätzen. Beide Parteien können den Verspätungsgrund über die Tracking API abrufen.
- Übermitteln
- Actual time of arrival (ATA)
- Übermitteln
- Rail Operator, Terminal und Traction Supplier: können die ATA übermitteln und bereits von anderen Parteien geteilte ATA-Werte aktualisieren.
- Abrufen
- Rail Operator, Terminal und Traction Supplier können die von den anderen Parteien übermittelte ATA über die Tracking API abrufen.
- Übermitteln
- Planned start of operations
- Übermitteln
- Terminal: kann den erwarteten Zeitpunkt übermitteln und aktualisieren, zu dem das Laden bzw. Entladen des ersten Containers beginnt, bis die erste CODECO empfangen wurde.
- Abrufen
- Rail Operator und Traction Supplier können den vom Terminal übermittelten planned start of operations über die Tracking API abrufen.
- Übermitteln
- Actual start of operations
- Abrufen
- Der actual start of operations wird automatisch erfasst, sobald die erste Lade-/Entlade-CODECO für die Visit in HCN Rail empfangen wird, und kann über die Tracking API abgerufen werden.
- Abrufen
- Planned finish of operations
- Übermitteln
- Terminal: kann den erwarteten Zeitpunkt übermitteln und aktualisieren, zu dem das Laden bzw. Entladen des letzten Containers abgeschlossen ist, bis die letzte CODECO empfangen wurde.
- Abrufen
- Rail Operator und Traction Supplier können den vom Terminal übermittelten planned finish of operations über die Tracking API abrufen.
- Übermitteln
- Actual finish of operations
- Abrufen
- Der actual finish of operations wird automatisch erfasst, sobald die letzte Lade-/Entlade-CODECO für die Visit in HCN Rail empfangen wird, und kann über die Tracking API abgerufen werden.
- Abrufen
- Estimated time of departure (ETD)
- Übermitteln
- Rail Operator: übermittelt die ETD bei der Erstellung einer Visit. Werden timetable slots verwendet, wird das Ende des Slots automatisch als ETD übernommen.
- Terminal & Traction Supplier: können die ETD aktualisieren.
- Abrufen
- Rail Operator, Traction Supplier und Terminal können die von den anderen Parteien übermittelte ETD über die Tracking API abrufen.
- Übermitteln
- Actual time of departure (ATD)
- Übermitteln
- Rail Operator, Terminal und Traction Supplier: können die ATD übermitteln und bereits von anderen Parteien geteilte ATD-Werte aktualisieren.
- Abrufen
- Rail Operator, Terminal und Traction Supplier können die von den anderen Parteien übermittelte ATD über die Tracking API abrufen.
- Übermitteln
Übermitteln
| Data | Rail operator | Terminal | Traction supplier |
| Estimated time of arrival (ETA) | Operator API – visits | Create visit endpoint | visitData.eta of visitData.timetableEntry ODER Operator API – visits | Update visit endpoint | visitData.eta of visitData.timetableEntry | Terminal API | Accept visit | plannedVisitData.eta ODER Terminal API | Update visit status | plannedVisitData.eta | Traction Supplier API | Update Transport Status | transportVisitStatus.eta |
| Grund der Verspätung | Traction Supplier API | Update Transport Status | transportVisitStatus.arrivalDelayReason UND/ODER Traction Supplier API | Update Transport Status | transportVisitStatus.departureDelayReason | ||
| Actual time of arrival (ATA) | Operator API – visits | Update visit endpoint | visitData.ata | Terminal API | Update visit status | visitResult.ata | Traction Supplier API | Update Transport Status | transportVisitStatus.ata |
| Planned start of operations | Terminal API | Accept visit | plannedVisitData.estimatedStartOfOperations ODER Terminal API | Update visit status | plannedVisitData.estimatedStartOfOperations | ||
| Planned finish of operations | Terminal API | Accept visit | plannedVisitData.estimatedEndOfOperations ODER Terminal API | Update visit status | plannedVisitData.estimatedEndOfOperations | ||
| Actual finish of operations | Terminal API | Complete visit | endOfOperations | ||
| Estimated time of departure (ETD) | Operator API – visits | Create visit endpoint | visitData.etd of visitData.timetableEntry ODER Operator API – visits | Update visit endpoint | visitData.etd of visitData.timetableEntry | Terminal API | Accept visit | plannedVisitData.etd ODER Terminal API | Update visit status | plannedVisitData.etd | Traction Supplier API | Update Transport Status | transportVisitStatus.etd |
| Actual time of departure (ATD) | Operator API – visits | Update visit endpoint | visitData.atd | Terminal API | Update visit status | visitResult.atd | Tracking API | Listen to ALL updates | visits.transportVisitStatus.atd |
Abrufen
Die folgende Tabelle zeigt, wie die von den Parteien in den Spalten bereitgestellten Daten abgerufen werden können. Beispiel: Rufen Sie Tracking API | Listen to ALL updates | visits.requestedVisitData.eta auf, um die vom Rail Operator bereitgestellte ETA abzurufen.
| Data | Rail operator | Terminal | Traction supplier |
| Estimated time of arrival (ETA) | Tracking API | Listen to ALL updates | visits.requestedVisitData.eta | Tracking API | Listen to ALL updates | visits.plannedVisitData.eta | Tracking API | Listen to ALL updates | visits.transportVisitStatus.eta |
| Grund der Verspätung | Tracking API | Listen to ALL updates | visits.transportVisitStatus.arrivalDelayReason UND/ODER Tracking API | Listen to ALL updates | visits.transportVisitStatus.departureDelayReason | ||
| Actual time of arrival (ATA) | Tracking API | Listen to ALL updates | visits.requestedVisitData.ata | Tracking API | Listen to ALL updates | visits.visitResult.ata | Tracking API | Listen to ALL updates | visits.transportVisitStatus.ata |
| Planned start of operations | Tracking API | Listen to ALL updates | visits.plannedVisitData.estimatedStartOfOperations. | ||
| Actual start of operations | Tracking API | Listen to ALL updates | Visits.startOfOperations | ||
| Planned finish of operations | Tracking API | Listen to ALL updates | visits.plannedVisitData.estimatedEndOfOperations | ||
| Actual finish of operations | Tracking API | Listen to ALL updates | Visits.endOfOperations | ||
| Estimated time of departure (ETD) | Tracking API | Listen to ALL updates | visits.requestedVisitData.etd | Tracking API | Listen to ALL updates | visits.plannedVisitData.etd | Tracking API | Listen to ALL updates | visits.transportVisitStatus.etd |
| Actual time of departure (ATD) | Tracking API | Listen to ALL updates | visits.requestedVisitData.atd | Tracking API | Listen to ALL updates | visits.visitResult.atd | Tracking API | Listen to ALL updates | visits.transportVisitStatus.atd |
