Öffentlichen Tracking-Link und AIS-Position nutzen

Zweck und Einsatzbereich

Mit einem gültigen öffentlichen Tracking-Link können Sie eine freigegebene Seefrachtakte ohne NeuraPort-Anmeldung öffnen. Die Seite zeigt die Aktennummer, den aktuellen Status, eine ETA, Lade- und Löschhafen, einen Meilensteinverlauf, nummerierte Container sowie – falls verfügbar – eine AIS-Position des zugeordneten Schiffs.

Der vollständige Link ist zugleich der Zugangsschlüssel. Es gibt keine zusätzliche Anmeldung oder Identitätsprüfung. Jede Person, die den Link erhält, kann ihn öffnen und weitergeben. Behandeln Sie ihn daher wie ein Passwort: nicht in öffentlich zugängliche Notizen übernehmen, nicht weiterleiten und bei vermuteter Offenlegung sofort vom Absender ersetzen lassen.

Die öffentliche Ansicht ist eine Informationshilfe. Sie ist weder Carrierquittung noch Liefernachweis oder verbindliche Bestätigung von Fahrplan, Zoll-, VGM- oder Containerstatus. AIS-Daten stammen aus einer externen öffentlichen Quelle und können fehlen, veraltet sein oder dem falschen gleichnamigen Schiff zugeordnet werden.

Voraussetzungen und Berechtigungen

Sie benötigen ausschließlich den vollständigen, aktiven Link. Ein NeuraPort-Benutzerkonto ist nicht erforderlich. Der Link funktioniert nur, wenn:

der Absender ihn für genau diese Akte erzeugt und nicht deaktiviert hat,
ein gegebenenfalls gespeicherter Ablaufzeitpunkt noch nicht erreicht ist,
für die Organisationseinheit der Akte das Modul Tracking und das passende Modul Ocean Export oder Ocean Import lesbar verfügbar sind,
die öffentliche Tracking-Domain und das zugehörige Backend korrekt bereitgestellt sind.

Der Link ist nicht an Ihre E-Mail-Adresse, Ihr Gerät oder eine einzelne Nutzung gebunden. Ein erfolgreicher Abruf erhöht lediglich den Aufrufzähler des Links. Wiederholtes Laden, mehrere Browser und mehrere Personen werden nicht unterschieden.

Die reguläre Linkerzeugung setzt derzeit keinen Ablaufzeitpunkt. Ein Standardlink kann deshalb bis zur ausdrücklichen Deaktivierung, Löschung der Akte oder Sperre einer benötigten Lizenz gültig bleiben. Auch das Archivieren der Akte und ein späterer Rechteentzug beim ursprünglichen Ersteller deaktivieren ihn nicht automatisch.

Wenn Sie den Zugriff nicht mehr benötigen oder eine Weitergabe vermuten, wenden Sie sich an den Absender. Nur ein berechtigter interner Benutzer kann den Link deaktivieren oder neu erzeugen. Die alte URL darf nach einer Rotation nicht weiterverwendet werden.

Schritt-für-Schritt-Anleitung

Sendung öffnen und Angaben prüfen

Öffnen Sie ausschließlich den vollständigen HTTPS-Link, den Sie vom Absender erhalten haben. Geben Sie den geheimen Teil nicht in Suchmaschinen oder fremde Formulare ein.
Prüfen Sie im Kopf der Seite die Aktennummer und den angezeigten Unternehmensnamen. Stimmen beide nicht mit Ihrem Vorgang überein, schließen Sie die Seite und informieren Sie den Absender, ohne den Link weiterzuleiten.
Lesen Sie Status und ETA. Ein grüner Statuspunkt bedeutet im aktuellen Stand nicht zuverlässig, dass die Sendung planmäßig ist: Verspätungs- und Fortschrittswerte werden von der öffentlichen Datenquelle derzeit nicht geliefert.
Vergleichen Sie unter Route Lade- und Löschhafen. Der Fortschrittsbalken bleibt ohne gelieferten Fortschrittswert typischerweise bei 0 % absolviert und ist daher kein belastbarer Positionsnachweis.
Prüfen Sie den Sendungsverlauf. Die Liste zeigt eine vorgegebene Meilensteinfolge und gegebenenfalls Zeitpunkte aus dem Aktenverlauf. Bei unbekannten oder neueren Aktenstatus kann keine Stufe als aktuell markiert sein.
Vergleichen Sie im Bereich Container Nummer und Typ mit Ihren Unterlagen. Die sichtbare Seite zeigt keine Seal-, Gewichts-, Volumen- oder Packstückwerte, obwohl diese im tokengebundenen Datensatz enthalten sein können.
Aktualisieren Sie die gesamte Browserseite nur, wenn Sie einen neuen Aktenstand abrufen möchten. Jeder erfolgreiche Ladevorgang zählt erneut als Aufruf.

AIS-Position einordnen

Ist ein Schiffsname an der Akte hinterlegt, startet die Seite automatisch die Abfrage im Bereich Live-Position (AIS).
Warten Sie auf AIS-Signal wird abgefragt …. Bei einer gefundenen Position erscheinen eine statische Karte, Koordinaten, Geschwindigkeit, Kurs, optional Zielhafen (AIS) und Letztes Signal.
Vergleichen Sie den angezeigten Schiffsnamen und die Reiseangabe mit Ihren Unterlagen. NeuraPort sucht derzeit ausschließlich nach dem Schiffsname und verwendet ungeprüft den ersten Treffer; eine in der Akte gespeicherte MMSI wird in diesem öffentlichen Ablauf nicht verwendet.
Bewerten Sie Letztes Signal als Zeitangabe der externen Quelle. Der Zeitpunkt neben Gecacht bezeichnet dagegen nur den Abruf der zwischengespeicherten Antwort im Browser.
Wählen Sie Aktualisieren, wenn bereits ein AIS-Ergebnis geladen wurde und Sie eine neue Abfrage auslösen möchten. Erfolgreiche Positionen können bis zu fünf Minuten aus dem Zwischenspeicher stammen.
Verwenden Sie AIS nie als alleinigen Nachweis für Ankunft, Abfahrt, ETA oder Ladungsstatus. Stimmen Position, Schiff oder Ziel nicht, lassen Sie den Vorgang durch den Absender und eine vereinbarte Carrier- oder AIS-Quelle prüfen.

Ungültigen oder verlorenen Link behandeln

Erscheint Kein Tracking-Token angegeben. Bitte prüfen Sie den Link in Ihrer E-Mail., fehlt der geheime Linkteil. Fordern Sie die vollständige URL erneut über einen sicheren Kanal an.
Erscheint Sendung nicht gefunden oder Link abgelaufen., prüfen Sie die URL nicht durch manuelles Verändern. Der Link kann unbekannt, deaktiviert, abgelaufen oder aufgrund einer Lizenzsperre nicht nutzbar sein.
Informieren Sie den Absender und nennen Sie nur Aktenreferenz, Zeitpunkt und sichtbare Fehlermeldung. Senden Sie den vollständigen Link nicht in einem ungeschützten Supportticket.
Nach einer Neuerzeugung verwenden Sie ausschließlich den neuen Link. Die alte URL wird nicht reaktiviert.

Feldreferenz

Feld	Pflicht	Bedeutung	Validierung
Vollständiger Tracking-Link	Ja	Geheimer Zugriff auf genau eine freigegebene Akte	Nur per HTTPS öffnen und wie ein Passwort behandeln; nicht manuell kürzen oder verändern.
Unternehmensname	Nein	Name der bereitstellenden Organisation	Gegen den bekannten Absender prüfen; ist nicht automatisch der Kunde oder Empfänger.
Aktennummer	Ja	Referenz der freigegebenen Seefrachtakte	Vor Nutzung aller weiteren Angaben mit dem erwarteten Vorgang abgleichen.
Status	Ja	Gespeicherter Aktenstatus oder zugeordnete öffentliche Bezeichnung	Das öffentliche Meilensteinmodell ist nicht vollständig mit dem aktuellen Aktenstatusmodell abgestimmt.
ETA	Nein	Geplantes Ankunftsdatum aus der Akte	Kein Live-Carrierbeleg; die öffentliche Seite erhält derzeit keine getrennte aktuelle und ursprüngliche ETA.
Route	Nein	Lade- und Löschhafen	Weitere Routenorte können im Datensatz vorhanden sein, werden aber nicht im Hauptlayout gezeigt.
Fortschritt	Systemseitig	Prozentanzeige zwischen Lade- und Löschhafen	Fehlender Wert fällt auf 0 % zurück; nicht als tatsächliche Schiffsposition interpretieren.
Meilenstein	Systemseitig	Vordefinierte Prozessstufe mit Zustand erledigt, Aktuell oder zukünftig	Bei Status außerhalb der öffentlichen Liste kann keine aktuelle Stufe markiert sein.
Meilensteinzeit	Nein	Zeitpunkt eines passenden Statuswechsels	Nur aus den zuletzt berücksichtigten Statuseinträgen; fehlender Zeitpunkt bedeutet nicht zwingend, dass das Ereignis nie stattfand.
Containernummer / Typ	Nein	Sichtbare Identifikation eines nummerierten Containers	Gegen Transportunterlagen prüfen; nur Container mit Nummer erscheinen.
Schiffsname / Reise	Für AIS erforderlich	Hauptlaufschiff und Reise aus der Akte	Die AIS-Suche nutzt den Namen, nicht die gespeicherte MMSI; Treffer fachlich gegenprüfen.
Position	Nein	Breiten- und Längengrad aus der externen AIS-Quelle	Nur bei vorhandenem Signal; wird für die externe statische Karte weitergegeben.
Geschwindigkeit / Kurs	Nein	Bewegungswerte des letzten ausgelesenen AIS-Signals	Können fehlen oder veraltet sein; keine operative Bestätigung.
Zielhafen (AIS)	Nein	Vom Schiff ausgesendete Zielangabe	Kann abgekürzt, veraltet oder von der Aktenroute abweichend sein.
Letztes Signal	Nein	Zeitangabe der externen AIS-Quelle	Nicht mit Seitenaufruf, Cachezeit oder aktueller Uhrzeit gleichsetzen.
Gecacht	Systemseitig	Position stammt aus einem bis zu fünf Minuten gehaltenen Zwischenspeicher	Eine manuelle Aktualisierung kann innerhalb dieses Zeitraums denselben Providerstand liefern.

Die sichtbare Tracking-Seite zeigt nur einen Teil des öffentlichen Datensatzes. Die tokengebundene Antwort kann zusätzlich Booking- und B/L-Nummer, Carrier, Incoterm, Warenbeschreibung, weitere Routenorte, ETD, ATD und ATA sowie Container-Seal, Gewicht, Volumen und Packstücke enthalten. Absender- und Empfängername werden nur bei einer gesonderten technischen Freigabe geliefert; diese Freigabe ist in der regulären Oberfläche nicht einstellbar. Kosten, Dokumente, E-Mails, Aufgaben und interne Notizen werden nicht ausgegeben.

Status und mögliche Übergänge

Tracking-Link

Ausgang	Ereignis	Ergebnis in der öffentlichen Ansicht
Vollständiger aktiver Link	Seite öffnen	Akte wird geladen; Aufrufzähler und letzter Abruf werden aktualisiert.
Kein oder unvollständiger Link	Seite öffnen	Kein Tracking-Token angegeben. Bitte prüfen Sie den Link in Ihrer E-Mail.
Unbekannt oder deaktiviert	Seite öffnen	Sendung nicht gefunden oder Link abgelaufen.
Ablaufzeitpunkt überschritten	Seite öffnen	Ebenfalls die zusammengefasste Meldung Sendung nicht gefunden oder Link abgelaufen.
Benötigte Lizenz gesperrt	Seite öffnen	Öffentliche Ansicht wird nicht geladen; das Frontend zeigt dieselbe zusammengefasste Fehlermeldung.
Aktiver Link	Absender deaktiviert oder ersetzt ihn	Alter Link ist nicht mehr verwendbar; neuer Link ist ein anderes Geheimnis.
Akte archiviert	Link erneut öffnen	Link kann weiterhin funktionieren, weil Archivierung keinen automatischen Widerruf auslöst.

AIS

Ausgang	Ereignis	Ergebnis in der öffentlichen Ansicht
Kein Schiffsname	Trackingdaten geladen	Noch kein Schiff für diese Sendung zugeordnet.
Schiffsname vorhanden	Trackingdaten geladen	AIS-Abfrage startet automatisch.
Kein Suchtreffer oder externer Fehler	AIS-Abfrage	Kein AIS-Signal für dieses Schiff gefunden. oder AIS-Daten konnten nicht geladen werden.
Schiffstreffer ohne Koordinaten	AIS-Abfrage	Keine Karte und keine Positionswerte; derzeit erscheint dafür keine eigene klare Leerzustandsmeldung.
Position vorhanden	AIS-Abfrage	Statische Karte und vorhandene Positionswerte erscheinen.
Position im Zwischenspeicher	Abfrage innerhalb von fünf Minuten	Gecacht wird angezeigt; Provider muss nicht erneut kontaktiert worden sein.
AIS-Ergebnis vorhanden	Aktualisieren	Tokengebundene AIS-Abfrage wird erneut ausgelöst.

Die öffentliche Meilensteinfolge enthält ältere Stufen wie Buchung angefragt, Buchung bestätigt, SI eingereicht, Cargo verladen, Abgefahren und Abgeschlossen. Aktuelle Aktenstufen wie Gebucht, VGM ausstehend, Zoll ausstehend, Verladung und Storniert fehlen. Bei einer solchen Stufe kann der technische Statuscode erscheinen, während sämtliche Meilensteine als zukünftig dargestellt werden.

Was im Hintergrund passiert

Beim Erzeugen eines Links erstellt NeuraPort ein zufälliges Geheimnis. In der Datenbank wird nur dessen Hash gespeichert; der vollständige Link lässt sich später nicht rekonstruieren. Beim öffentlichen Abruf wird der übermittelte Token gehasht, mit einem aktiven Datensatz verglichen und auf einen gegebenenfalls vorhandenen Ablaufzeitpunkt geprüft. Danach kontrolliert NeuraPort die Tracking- und Ocean-Lizenz der tatsächlichen Akteneinheit und lädt den freigegebenen Datensatz.

Der Hash schützt das Geheimnis in der Datenbank, nicht in Browserhistorie, Zwischenablage, E-Mail oder Zugriffsprotokollen. Die bereitgestellte Tracking-Konfiguration erzwingt HTTPS, verhindert Einbettung in fremde Seiten, fordert Suchmaschinen mit noindex, nofollow zum Ausschluss auf und kennzeichnet die öffentlichen Antworten als nicht zu speichern. noindex ist jedoch keine Zugriffskontrolle; die Geheimhaltung des Links bleibt entscheidend.

Der Statuspunkt, das Verspätungsbanner und der Fortschrittsbalken erwarten Werte, welche die öffentliche Datenquelle derzeit nicht liefert. Dadurch erscheint der Punkt auch bei nicht planmäßigen oder unbekannten Zuständen grün, die Verspätung bleibt verborgen und der Fortschritt fällt auf 0 %. Die Meilensteinliste wird aus einer separaten, veralteten Statusfolge und höchstens zehn jüngsten Statuseinträgen aufgebaut.

Für AIS sucht NeuraPort den in der Akte gespeicherten Schiffsname in einer externen öffentlichen Schiffswebseite, nimmt den ersten Treffer und liest dessen Positionsseite aus. Ein vertraglich stabiler AIS-API-Adapter oder zweiter Provider ist für diesen Ablauf nicht belegt. Erfolgreiche Positionen werden pro Serverprozess fünf Minuten zwischengespeichert. Die AIS-Abfrage ist auf 20 Aufrufe pro Minute und Absenderadresse begrenzt; für den öffentlichen Sendungsdatenabruf ist keine entsprechende eigene Grenze belegt.

Bei vorhandenen Koordinaten lädt der Browser das Kartenbild von einem externen OpenStreetMap-Kartendienst und übermittelt dafür die Position. Scheitert das Kartenbild, wird es ausgeblendet, ohne dass eine eigene Kartenfehlermeldung erscheint. Positionstext und AIS-Werte können trotzdem sichtbar bleiben.

Ein Demo-Link verwendet nur dann das getrennte Demo-Backend, wenn die vorgesehene Reverse-Proxy-Konfiguration installiert ist und der separate Dienst läuft. Der lokale Entwicklungsproxy unterstützt diesen Demo-Weg nicht. Es gibt keinen automatischen AIS-Simulationsfallback für fiktive Schiffe; eine sichere Demo kann daher bewusst Kein AIS-Signal zeigen.

Tests belegen Erzeugung, einmalige Geheimnisausgabe, Konflikt bei einem zweiten aktiven Link, Deaktivierung, Neuerzeugung, Managerzugriff sowie die Sperre eines öffentlichen Abrufs bei suspendiertem Ocean-Modul. Nicht belegt sind ein vollständiger erfolgreicher öffentlicher Datensatz, Ablaufverhalten, Aufrufzähler unter Parallelität, Archivierung, Datenschutzoptionen, alle Statusstufen, AIS-Trefferqualität, Kartenfehler, Ratenbegrenzung und der isolierte Demo-Ende-zu-Ende-Weg.

Typische Fehler und Lösungen

Meldung oder Beobachtung	Ursache	Lösung
Kein Tracking-Token angegeben. Bitte prüfen Sie den Link in Ihrer E-Mail.	Geheimer Linkteil fehlt oder die URL wurde gekürzt.	Vollständigen HTTPS-Link sicher erneut beim Absender anfordern; nicht selbst ergänzen.
Sendung nicht gefunden oder Link abgelaufen.	Link ist unbekannt, deaktiviert, abgelaufen oder eine benötigte Lizenz ist nicht verfügbar.	Absender mit Aktenreferenz und Zeitpunkt kontaktieren; vollständigen Link nicht in ein ungeschütztes Ticket kopieren.
Falsche Aktennummer oder falsches Unternehmen	Link gehört zu einem anderen Vorgang oder wurde falsch weitergeleitet.	Seite schließen, Link nicht weiterverwenden und Absender über sicheren Kanal informieren.
Grüner Punkt, obwohl eine Abweichung bekannt ist	Öffentliche Datenquelle liefert derzeit keine Verspätungswerte; Grün wird ohne weitere Prüfung verwendet.	ETA und Status beim Absender bestätigen lassen; Farbe nicht als Planmäßigkeitsnachweis nutzen.
Fortschritt bleibt 0 % absolviert	Der öffentliche Datensatz liefert keinen Routenfortschritt.	Position über AIS oder vereinbarte Carrierquelle prüfen; Fortschrittsbalken ignorieren.
Technischer Statuscode erscheint und kein Meilenstein ist Aktuell	Aktenstatus fehlt in der veralteten öffentlichen Meilensteinfolge.	Status direkt beim Absender bestätigen lassen; Anzeige als Produktlücke melden.
Noch kein Schiff für diese Sendung zugeordnet.	Kein ausreichender Schiffsname ist in der Akte gespeichert.	Absender um fachliche Ergänzung und erneute Prüfung bitten.
Kein AIS-Signal für dieses Schiff gefunden.	Kein Suchtreffer, kein Signal oder Fehler der externen Quelle.	Schiffsname vom Absender prüfen lassen und später die gesamte Seite neu laden.
AIS-Daten konnten nicht geladen werden.	Link, Lizenz, Ratenbegrenzung, Netzwerk oder externer Dienst hat die Abfrage verhindert.	Nicht wiederholt schnell aktualisieren; später erneut laden und bei Fortbestand den Absender informieren.
Kein AIS-Fehler, aber Karte und Positionswerte fehlen	Schiffstreffer enthält keine Koordinaten; eigener Leerzustand fehlt.	Nicht als Position werten; beim Absender eine alternative Quelle anfordern.
Aktualisieren fehlt nach einem AIS-Fehler	Die Schaltfläche erscheint erst, wenn bereits ein AIS-Objekt geladen wurde.	Gesamte Browserseite später neu laden; keine schnelle Wiederholungsschleife erzeugen.
AIS zeigt ein anderes Schiff oder eine unplausible Position	Namenssuche übernimmt den ersten Treffer statt einer gespeicherten MMSI.	Anzeige nicht verwenden; Schiff über eindeutige Kennung und freigegebene Quelle prüfen lassen.
Karte ist leer, Positionswerte bleiben sichtbar	Externer Kartendienst konnte das Bild nicht laden.	Koordinaten nur als AIS-Providerwert behandeln; Kartenfehler beim Absender melden.
Demo-Link lädt Produktionsdaten oder keine Daten	Demo-Proxy oder separates Backend ist nicht korrekt bereitgestellt.	Nutzung sofort stoppen und Deployment durch den Betrieb prüfen lassen; nicht auf einen Produktionslink ausweichen.