Einführung
In diesem Dokument beschreiben wir eine anzahl funktionaler Szenarien, die Sie testen können, um zu sehen, ob Ihre Verbindung gut funktioniert. In dem beigefügten Download finden Sie die Nachrichtenspezifikationen und Beispielnachrichten, um die systemverknüpfung einzurichten, auf die wir in diesem Artikel verweisen.
Für das Testen in unserer Kunden-Testumgebung (KT-Umgebung) ist eine separate Registrierung erforderlich. Nehmen Sie diesbezüglich Kontakt mit unserer Abteilung Integration Services auf.
Prozessablauf dienst
Der Prozessablauf für die dienst 'Melding Import Documentatie' für Fähr- und Containerterminals (V2):
Let op! Nehmen Sie die folgenden Ausnahmen in den erwarteten Prozess auf:
- Terminals, die über einen 'Berichtenflow V1' angeschlossen sind, weichen vom obigen Prozess ab. Eine Übersicht der Terminals und Loodscodes finden Sie hier.
- Fährterminals sind über einen 'Berichtenflow V2' angeschlossen.
- Der Rückzugsantrag ist eine 'web only' Anwendung und ist daher nicht in diesem Flow für eine EDI-Systemverknüpfung enthalten.
Szenario 1a: NID-Dokument einreichen (Containerladung)
- Erstellen Sie eine M2400-Nachricht (ImportDocument In). Verwenden Sie hierfür die Beispielnachrichten.
- Füllen Sie im Element <receiverIdentifier> den Wert “TERM1LADING” ein.
- Füllen Sie im Element <importDocument><number> den Szenariocode aus der untenstehenden Tabelle für die verschiedenen Szenarien ein. Gefolgt von einem eindeutigen Code, das Dokumentnummer und Dokumenttyp müssen jederzeit eine eindeutige Kombination bilden.
- Füllen Sie alle Pflichtfelder für den Test aus. Für Containerladung bedeutet dies, dass das Element <equipmentlist> ausgefüllt sein muss.
- Senden Sie die Nachricht an PCS in der KT-Umgebung von Portbase.
| Szenario | <receiverIdentifier> | <importDocument><number> = Kontrolle code |
| Akzeptanz durch terminal | TERM1LADING | Regulärer Dokumenttyp und Nummer. Beginnen Sie nicht mit RE. Beispiel: FWV mit Nummer DOC123. |
| Ablehnung durch terminal | TERM1LADING | Regulärer Dokumenttyp und Nummer. Beginnen Sie mit RE. Beispiel: FWV mit Nummer RE132. |
| Keine Reaktion von terminal | 3199LD875 | Regulärer Dokumenttyp und Nummer. |
Szenario 1b: NID-Dokument Reaktion (Containerladung)
- Überprüfen Sie, ob eine M2403-Nachricht (ImportDocument Functional Acknowledgement Out) erhalten wurde.
- Überprüfen Sie das Element <importDocumentAcknowledgement><responseTypeCode> in Verbindung mit dem gewählten Szenario. Das Ergebnis muss dann mit einer der untenstehenden erwarteten Reaktionen übereinstimmen:
| <receiverIdentifier> | Kontrolle code | <responseTypeCode> | Statusbeschreibung |
| TERM1LADING | <none> | AP | <empty> |
| TERM1LADING | RE | RE | Nicht akzeptiert, Dokumenttyp unbekannt. |
| 3199LD875 | <none> | AQ/RP | Keine, der responseTypeCode hängt von den Nachrichtenspezifikationen ab. |
Szenario 2a: NID-Dokument einreichen (Frachtladung)
- Erstellen Sie eine M2400-Nachricht (ImportDocument In). Verwenden Sie hierfür die Beispielnachricht 'M2400_ImportDocument_In_ferry_AP.xml und M2400_ImportDocument_In_ferry_RE.xml'.
- Füllen Sie im Element <receiverIdentifier> den Wert “TERM1LADING” ein.
- Füllen Sie im Element <importDocument><number> den Szenariocode aus der untenstehenden Tabelle für die verschiedenen Szenarien ein. Gefolgt von einem eindeutigen Code, das Dokumentnummer und Dokumenttyp müssen jederzeit eine eindeutige Kombination bilden.
- Füllen Sie alle Pflichtfelder für den Test aus. Für Frachtladung bedeutet dies, dass das Element <shipmentId> ausgefüllt sein muss.
- Senden Sie die Nachricht an PCS in der KT-Umgebung von Portbase.
| Scenario | <receiverIdentifier> | <importDocument><number> = Kontrolle code |
| Akzeptanz durch terminal | TERM1LADING | Regulärer dokumenttyp und nummer. Beginnen Sie nicht mit RE. Beispiel: FWV mit nummer DOC123. |
| Ablehnung durch terminal | TERM1LADING | Regulärer dokumenttyp und nummer. Beginnen Sie mit RE. Beispiel: FWV mit nummer RE132. |
Szenario 2b: NID dokument reaktion (Fährladung)
- Überprüfen Sie, ob eine M2403-Nachricht (ImportDocument Functional Acknowledgement Out) erhalten wurde.
- Überprüfen Sie das Element <importDocumentAcknowledgement><responseTypeCode> in Verbindung mit dem gewählten Szenario. Das Ergebnis muss dann mit einer der unten erwarteten Reaktionen übereinstimmen:
| <receiverIdentifier> | Kontrolle code | <responseTypeCode> | Status beschreibung |
| TERM1LADING | <none> | AP | <empty> |
| TERM1LADING | RE | RE | Nicht akzeptiert, dokumenttyp unbekannt. |
Verknüpfung mit