Zugbildungs-API jetzt für Bahnbetreiber verfügbar

15 Mai 2024 | Hinterland Container Notification Rail

Während der letzten Sitzung des Lenkungsausschusses von Rail Connected stimmten die Mitglieder dem 1. Oktober als spätestem Termin für die Übermittlung der Zugbildung über HCN Rail an die Terminals zu, die an HCN Rail angeschlossen sind. Diese E-Mail enthält Informationen zu den Folgeschritten dieser Entscheidung für Bahnbetreiber. Die Kommunikation für Traktionsdienstleister folgt zu einem späteren Zeitpunkt.

Was bedeutet dies für Sie als Bahnbetreiber?

Mit dieser Erweiterung bietet HCN Rail neben einer zentralen digitalen Plattform für die Voranmeldung von Containern und Besuchen auch die Möglichkeit, die Zugbildung zu teilen. Das digitale Teilen der Zugbildung reduziert manuelle Arbeitsschritte und ermöglicht die Wiederverwendung von Daten, wodurch das Risiko von Fehlern reduziert und die Effizienz der Kommunikation zwischen den verschiedenen Kettenparteien erhöht wird.

Konkret bedeutet dies für Sie als Bahnbetreiber, dass Sie bis spätestens 1. Oktober auf das Teilen der Zugbildung über HCN Rail über die Webumgebung oder die dafür entwickelte API umstellen müssen.

Was müssen Sie tun, wenn Sie Ihre Zugbildung über die Webumgebung von HCN Rail mit Portbase teilen möchten?

Demnächst erhalten Sie Anweisungen dazu, wie Sie die Zugbildung über die Webumgebung übermitteln können. Diese Anweisungen dienen als Leitfaden für die Zugbildungsfunktion in der Webumgebung von HCN Rail. Darüber hinaus wird Mitte Juni eine Demo organisiert, in der diese Anweisungen näher erläutert werden. Da diese Demo einen Einblick in die Verwendung der Zugbildungsfunktion bietet, empfehlen wir die Teilnahme an dieser Demo sowohl für Benutzer der Webumgebung als auch der API. Weitere Informationen zu dieser Demo folgen in Kürze.

Was müssen Sie tun, wenn Sie Ihre Zugbildung über eine Systemverknüpfung mit Portbase teilen möchten?

Wenn Sie die Zugbildung über eine Systemverknüpfung von Ihrem eigenen TMS aus mit Portbase teilen möchten, empfehlen wir Ihnen, sich so schnell wie möglich mit Ihrem Softwareanbieter in Verbindung zu setzen. Ihr Softwareanbieter benötigt die folgenden Informationen:

  • Für die Integration kann Ihr Softwareanbieter die API-Spezifikationen zu Rate ziehen.
  • Darüber hinaus wurden Usecases entwickelt, die zusätzliche Erklärungen zur Verwendung der Zugbildungsfunktion bieten. Diese Usecases finden Sie hier, unter ‚Usecases – Train composition‘.
  • Zur Einrichtung der Systemverknüpfung benötigt Ihr Softwareanbieter ein Testkonto. Wenn Ihr Softwareanbieter noch nicht über ein Testkonto verfügt, kann er dieses hier anfragen.
  • Um die Integrationsprozesse zu unterstützen, wurde eine Anlaufstelle eingerichtet, an die sich Ihr Softwareanbieter bei technische Fragen wenden kann. Senden Sie dazu eine E-Mail an g.keulers@portbase.com.

Beachten Sie außerdem Folgendes:

  • Um Ihre Zugbildung über eine Systemverknüpfung mit Portbase teilen zu können, müssen Sie eine Reihe von Feldern bezüglich der Gefahrstoffe pro Container in bereits vorhandene Endpoints einfügen.Bei Containern, die Gefahrgut transportieren, müssen die UN-Nummer, die Gefahrnummer und die Gefahrenklasse auf der Zugbildung mit dem Terminal geteilt werden. Für die Handlings, die bei den an HCN Rail angeschlossenen Terminals vorangemeldet wurden, ruft die Zugbildungsfunktion die Containerdaten, einschließlich der Gefahrgutdaten, unter Verwendung der handlingID, ab. Dazu ist es erforderlich, dass Sie bereits in der Voranmeldung die Details zum Gefahrgut angeben. Dies war zuvor noch nicht möglich. Mit der Inbetriebnahme der Zugbildungs-API wurden daher auch eine Reihe neuer Felder zum Create (detached) handling, Update (detached) handling und Move any handling endpoints in den Operator API – Handlings hinzugefügt. Hierbei handelt es sich um die folgenden Felder: handlingData.dangerousGoods.unCode, handlingData.dangerousGoods.hazardClass, und handlingData.dangerousGoods.gevi. Hierzu kann Ihr Softwareanbieter die API-Spezifikationen zu Rate ziehen.
  • Über eine Systemverknüpfung ist es möglich, Remarks auf Handling-Ebene in die Zugbildung aufzunehmen. Wenn Sie diese Möglichkeit nutzen möchten, prüfen Sie bei Ihrem Softwareanbieter, ob Sie das Feld handlingData.remarks im Create (detached) handling, Update (detached) handling, und Move any handling endpoints in den Operator API – handlings,  bereits füllen können.
  • Das Laden nach Richtlinie wird derzeit noch nicht von der Zugbildungsfunktion unterstützt.

Portbase unterstützt Sie während dieses Integrationsprozesses. Um Sie bestmöglich betreuen zu können, bitten wir Sie, uns mitzuteilen, ob Sie die Zugbildung über die Webumgebung oder über die API mit Portbase teilen möchten. Wir haben nicht die Kapazität, alle zur gleichen Zeit zu unterstützen, was bedeutet, dass wir gemeinsam einen Zeitplan erarbeiten müssen. Je früher Sie uns Ihren Zeitplan mitteilen, desto besser können wir diesen berücksichtigen. Wir bitten Sie daher, die folgenden Informationen per E-Mail an s.dorrepaal@portbase.com zu senden:

  1. Möchten Sie die Zugbildung über die Webumgebung oder über die API mit Portbase teilen?
  2. Wenn Sie die Zugbildung über eine API teilen möchten, gelten außerdem die folgenden Fragen:
    • Wer ist Ihr Softwareanbieter?
    • Wann kann Ihr Softwareanbieter mit der Einrichtung der Systemverknüpfung beginnen?