Der Dienst Notification Export Documentation wurde neu aufgebaut und wird derzeit an alle Benutzer ausgerollt. Die Informationen in diesem Artikel gelten sowohl für den alten als auch für den neu aufgebauten Dienst (Notification Export Documentation). An der Systemintegration wurde nichts angepasst.
Einführung
In diesem Dokument beschreiben wir eine Anzahl funktionaler Szenarien, die Sie testen können, um zu prüfen, ob Ihre Systemintegration mit Notification Export Documentation korrekt funktioniert. Weitere Informationen über den Dienst finden Sie im Artikel Systemintegration erstellen mit Notification Export Documentation.
In diesem Artikel verwenden wir Nachrichtenspezifikationen und Beispielnachrichten, die Sie in diesem Download finden.
Der Dienst NED ist dazu bestimmt, Dokumente für Exportsendungen bei einem Terminal voranzumelden. Neue Dokumente können über den Bildschirm oder eine Systemintegration erfasst, aktualisiert und gelöscht werden. Außerdem können Sie über die Systemintegration Statusupdates erhalten – unabhängig davon, auf welche Weise Dokumente erfasst wurden.
Prozessablauf Dienst NED
Szenario 1: Neues NED-Dokument einreichen
- Erstellen Sie aus Ihrem eigenen System eine M114-Nachricht gemäß den Spezifikationen. Siehe dazu die Beispielnachrichten im Download.
- Wählen Sie als contentAction „original“.
- Verwenden Sie als documentType ausschließlich einen Type aus der Liste der NED-documentTypes.
- Füllen Sie <documentNumber> mit der MRN der Export- oder Transit-Anmeldung. Bei anderen documentTypes verwenden Sie bitte die Referenznummer dieses Dokuments.
- Möchten Sie eine funktionale Ablehnung testen, verwenden Sie dann 2x dieselbe MRN mit einem anderen Equipment in aufeinanderfolgenden Nachrichten. Da die MRN eindeutig sein muss, wird die 2. abgelehnt.
- Senden Sie die Nachricht an PCS in der KT-Umgebung von Portbase.
Mögliche Ergebnisse:
- Bei technischer Ablehnung: Sie erhalten eine TA07 Technical acknowledgement-Nachricht mit Code „NAK“.
- Bei technischer Akzeptanz: Sie erhalten eine TA07 Technical acknowledgement-Nachricht mit Code „AK“.
- Diese erhalten Sie nur, wenn Sie gewählt haben, immer eine „technical acknowledgement“ zu erhalten.
Anschließend
- Bei funktionaler Ablehnung: Sie erhalten eine M116-Nachricht mit responseTypeCode „RP“.
- Der Ablehnungsgrund ist im Feld <errorDescription> beschrieben.
- Siehe die M116-Nachrichtenspezifikationen im Download für die Liste der möglichen Ablehnungsgründe.
- Bei funktionaler Akzeptanz: Sie erhalten eine M116-Nachricht mit responseTypeCode „AR“.
- Das Dokument ist danach akzeptiert und wird an Terminals weitergeleitet, die die Buchung aus der Nachricht erwarten.
Anschließend
- Bei Dokument-Status Änderung: Sie erhalten eine M115-Nachricht mit einem statusCode des Dokuments.
- Siehe die M115-Nachrichtenspezifikationen im Download für die Liste der statusCodes und deren Bedeutung.
- M115-Nachrichten werden nur für Export- und Transit-Dokumente versendet. Andere documentTypes erhalten keine Statusupdates, da diese nicht von Portbase an den Zoll übermittelt werden.
- Sie erhalten M115-Nachrichten nur, wenn Sie hierfür bei Portbase angemeldet sind.
Szenario 2: Bestehendes NED-Dokument anpassen / ersetzen
- Führen Sie zuerst Szenario 1 aus.
- Erstellen Sie aus Ihrem eigenen System eine neue M114-Nachricht gemäß den Spezifikationen. Siehe dazu die Beispielnachrichten im Download.
- Füllen Sie <contentReference> mit einem neuen eindeutigen Wert.
- Wählen Sie als contentAction „replace“.
- Füllen Sie <previousContentReference> mit dem Wert von <contentReference> aus der M114-Nachricht aus Szenario 1.
- Passen Sie einen oder mehrere Werte im <contentBody> an.
- Dokument- oder Equipment-Details anpassen.
- Sie können Equipment hinzufügen oder löschen, sofern mindestens 1 Equipment pro Dokument verbleibt.
- Sie können ein Dokument (mit eigenem Equipment) hinzufügen oder löschen, sofern mindestens 1 Dokument verbleibt.
- Senden Sie die Nachricht an PCS in der KT-Umgebung von Portbase.
Mögliche Ergebnisse:
- Bei technischer Ablehnung: Sie erhalten eine TA07 Technical acknowledgement-Nachricht mit Code „NAK“.
- Bei technischer Akzeptanz: Sie erhalten eine TA07 Technical acknowledgement-Nachricht mit Code „AK“.
- Diese erhalten Sie nur, wenn Sie gewählt haben, immer eine „technical acknowledgement“ zu erhalten.
Anschließend
- Bei funktionaler Ablehnung: Sie erhalten eine M116-Nachricht mit responseTypeCode „RP“.
- Der Ablehnungsgrund ist im Feld <errorDescription> beschrieben.
- Siehe die M116-Nachrichtenspezifikationen im Download für die Liste der möglichen Ablehnungsgründe.
- Abhängig vom Status des Dokuments können Änderungen möglicherweise nicht mehr zulässig sein.
- Bei funktionaler Akzeptanz: Sie erhalten eine M116-Nachricht mit responseTypeCode „AR“.
- Die angeforderte Anpassung ist danach in NED gespeichert und wird an Terminals weitergeleitet, die die Buchung aus der Nachricht erwarten.
Anschließend
- Bei Dokument-Status Änderung: Sie erhalten eine M115-Nachricht mit einem statusCode des Dokuments.
- Siehe die M115-Nachrichtenspezifikationen im Download für die Liste der statusCodes und deren Bedeutung.
- M115-Nachrichten werden nur für Export- und Transit-Dokumente versendet. Andere documentTypes erhalten keine Statusupdates, da diese nicht von Portbase an den Zoll übermittelt werden.
- Sie erhalten M115-Nachrichten nur, wenn Sie hierfür bei Portbase angemeldet sind.
Szenario 3: Bestehendes NED-Dokument löschen
- Führen Sie zuerst Szenario 1 aus.
- Erstellen Sie aus Ihrem eigenen System eine neue M114-Nachricht gemäß den Spezifikationen. Siehe dazu die Beispielnachrichten im Download.
- Füllen Sie <contentReference> mit einem neuen eindeutigen Wert.
- Wählen Sie als contentAction „deletion“.
- Füllen Sie <previousContentReference> mit dem Wert von <contentReference> aus der M114-Nachricht aus Szenario 1.
- Wiederholen Sie die Werte aus dem <contentBody> der Nachricht aus Szenario 1.
- Senden Sie die Nachricht an PCS in der KT-Umgebung von Portbase.
Mögliche Ergebnisse:
- Bei technischer Ablehnung: Sie erhalten eine TA07 Technical acknowledgement-Nachricht mit Code „NAK“.
- Bei technischer Akzeptanz: Sie erhalten eine TA07 Technical acknowledgement-Nachricht mit Code „AK“.
- Diese erhalten Sie nur, wenn Sie gewählt haben, immer eine Technical acknowledgement zu erhalten.
Anschließend
- Bei funktionaler Ablehnung: Sie erhalten eine M116-Nachricht mit responseTypeCode „RP“.
- Der Ablehnungsgrund ist im Feld <errorDescription> beschrieben.
- Siehe die M116-Nachrichtenspezifikationen im Download für die Liste der möglichen Ablehnungsgründe.
- Abhängig vom Status des Dokuments können Löschungen möglicherweise nicht mehr zulässig sein, z. B. wenn das Dokument bereits in einem Exportmanifest aufgeführt ist.
- Bei funktionaler Akzeptanz: Sie erhalten eine M116-Nachricht mit responseTypeCode „AR“.
- Das Dokument ist danach aus NED gelöscht. Die Terminals, die die Buchung aus der Nachricht erwarten, erhalten ebenfalls die Löschung.
Anschließend
- Bei Dokument-Status Änderung: Sie erhalten eine M115-Nachricht mit einem statusCode des Dokuments.
- Siehe die M115-Nachrichtenspezifikationen im Download für die Liste der statusCodes und deren Bedeutung.
- M115-Nachrichten werden nur für Export- und Transit-Dokumente versendet. Andere documentTypes erhalten keine Statusupdates, da diese nicht von Portbase an den Zoll übermittelt werden.
- Sie erhalten M115-Nachrichten nur, wenn Sie hierfür bei Portbase angemeldet sind.