Einführung
In diesem Dokument beschreiben wir eine Anzahl funktionaler Szenarien, die Sie testen können, um zu sehen, ob Ihre systemverknüpfung mit Melding Export Documentatie gut funktioniert. Mehr Informationen über die dienst finden Sie im Artikel Systeemkoppeling maken met Melding Export Documentatie.
In diesem Artikel verwenden wir Nachrichtenspezifikationen und Beispielnachrichten, die Sie in diesem Download finden können.
Die dienst MED ist dazu gedacht, Dokumente für Exportsendungen bei einem terminal voranzumelden. Neue Dokumente können über den Bildschirm oder eine systemverknüpfung eingereicht, aktualisiert und gelöscht werden. Darüber hinaus können Sie über die systemverknüpfung Statusaktualisierungen erhalten, unabhängig davon, auf welche Weise Dokumente eingereicht wurden.
Prozessablauf dienst MED
Szenario 1: Neues MED-Dokument einreichen
- Erstellen Sie eine M114-Nachricht aus Ihrem eigenen System gemäß den Spezifikationen. Siehe hierzu die Beispielnachrichten im Download.
- Wählen Sie als contentAction 'original'
- Verwenden Sie als documentType ausschließlich ein type aus der Liste der MED-documentTypes.
- Füllen Sie <documentNumber> mit der MRN der Export- oder Transitmeldung. Im Falle anderer documentTypes verwenden Sie die Referenznummer dieses Dokuments.
- Möchten Sie eine funktionale Ablehnung testen, verwenden Sie 2x dieselbe MRN mit einem anderen equipment in aufeinanderfolgenden Nachrichten. Da die MRN einzigartig 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 Annahme. Sie erhalten eine TA07 Technical acknowledgement Nachricht mit Code 'AK'
- Diese erhalten Sie nur, wenn Sie gewählt haben, immer ein 'technical acknowledgement' zu erhalten.
Anschließend
- Bei Funktionaler Ablehnung. Sie erhalten eine M116 Nachricht mit responseTypeCode 'RP'.
- Der Grund der Ablehnung ist im Feld <errorDescription> beschrieben.
- Siehe die M116 Nachrichtenspezifikationen im Download für die Liste der möglichen Ablehnungsgründe.
- Bei Funktionaler Annahme. Sie erhalten eine M116 Nachricht mit responseTypeCode 'AR'.
- Das Dokument wird danach akzeptiert und an terminals weitergeleitet, die die Buchung aus der Nachricht erwarten.
Anschließend
- Bei Document 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 Transitdokumente gesendet. Andere documentTypes erhalten keine Statusaktualisierungen, da diese nicht von Portbase an den Zoll gesendet werden.
- Sie erhalten M115 Nachrichten nur, wenn Sie dafür bei Portbase angemeldet sind.
Szenario 2: bestehendes MED-Dokument anpassen / ersetzen
- Führen Sie zuerst Szenario 1 aus.
- Erstellen Sie eine neue M114-Nachricht aus Ihrem eigenen System gemäß den Spezifikationen. Siehe hierzu die Beispielnachrichten im Download.
- Füllen Sie <contentReference> mit einem neuen einzigartigen 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 ein 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 Annahme. Sie erhalten eine TA07 Technical acknowledgement Nachricht mit Code 'AK'
- Diese erhalten Sie nur, wenn Sie gewählt haben, immer ein 'technical acknowledgement' zu erhalten.
Anschließend
- Bei Funktionaler Ablehnung. Sie erhalten eine M116 Nachricht mit responseTypeCode 'RP'.
- Der Grund der Ablehnung ist im Feld <errorDescription> beschrieben.
- Siehe die M116 Nachrichtenspezifikationen im Download für die Liste der möglichen Ablehnungsgründe.
- Abhängig von der status des Dokuments können änderungen nicht mehr erlaubt sein.
- Bei Funktionaler Annahme. Sie erhalten eine M116 Nachricht mit responseTypeCode 'AR'.
- Die angeforderte änderung wird danach in MED gespeichert und an terminals weitergeleitet, die die Buchung aus der Nachricht erwarten.
Anschließend
- Bei Document Status änderung. Sie erhalten ein M115-Nachricht mit einem statusCode des Dokuments.
- Siehe die M115-Nachrichtspezifikationen im Download für die Liste der statusCodes und deren Bedeutung.
- M115-Nachrichten werden nur für Export- und Transitdokumente gesendet. Andere documentTypes erhalten keine Statusaktualisierungen, da diese nicht von Portbase an den Zoll gesendet werden.
- Sie erhalten M115-Nachrichten nur, wenn Sie dafür bei Portbase angemeldet sind.
Szenario 3: bestehendes NED-Dokument löschen
- Führen Sie zuerst Szenario 1 aus.
- Erstellen Sie eine neue M114-Nachricht aus Ihrem eigenen System gemäß den Spezifikationen. Siehe dazu die Beispielnachrichten im Download.
- Füllen Sie <contentReference> mit einem neuen eindeutigen Wert aus
- Wählen Sie als contentAction 'deletion'
- Füllen Sie <previousContentReference> mit dem Wert von <contentReference> aus der M114-Nachricht aus Szenario 1 aus.
- 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 Technische Ablehnung. Sie erhalten eine TA07 Technical acknowledgement Nachricht mit Code 'NAK'
- Bei Technische Annahme. Sie erhalten eine TA07 Technical acknowledgement Nachricht mit Code 'AK'
- Diese erhalten Sie nur, wenn Sie gewählt haben, immer ein Technical acknowledgement zu erhalten.
Anschließend
- Bei Funktionale Ablehnung. Sie erhalten eine M116-Nachricht mit responseTypeCode 'RP'.
- Der Grund für die Ablehnung ist im Feld <errorDescription> beschrieben.
- Siehe die M116-Nachrichtspezifikationen im Download für die Liste der möglichen Ablehnungsgründe.
- Abhängig von der status des Dokuments können Löschungen nicht mehr erlaubt sein. Zum Beispiel, wenn das Dokument bereits auf einem Export Manifest vermerkt ist.
- Bei Funktionale Annahme. Sie erhalten eine M116-Nachricht mit responseTypeCode 'AR'.
- Das Dokument wird danach aus NED gelöscht. Die Terminals, die die Buchung aus der Nachricht erwarten, werden auch die Löschung erhalten.
Anschließend
- Bei Document Status änderung. Sie erhalten ein M115-Nachricht mit einem statusCode des Dokuments.
- Siehe die M115-Nachrichtspezifikationen im Download für die Liste der statusCodes und deren Bedeutung.
- M115-Nachrichten werden nur für Export- und Transitdokumente gesendet. Andere documentTypes erhalten keine Statusaktualisierungen, da diese nicht von Portbase an den Zoll gesendet werden.
- Sie erhalten M115-Nachrichten nur, wenn Sie dafür bei Portbase angemeldet sind.