Einführung
In diesem Dokument beschreiben wir eine anzahl funktionaler Szenarien, die Sie testen können, um zu überprüfen, ob Ihre Verbindung aus Ihrer Position als terminal korrekt 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 anmeldung erforderlich. Bitte wenden Sie sich hierfür an unsere Abteilung Integration.
Prozessablauf dienst
Der Prozessablauf für die dienst 'Notification Import Documentation' für Fähr- und Containerterminals (V2):
Achtung! Berücksichtigen Sie die folgenden Ausnahmen im erwarteten Prozess:
- Terminals müssen zwingend an die 'Berichtenflow V2' angeschlossen sein.
- Der Intrekverzoek ist eine reine 'Web only'-Anwendung, die Bearbeitung eines Intrekverzoek kann sowohl per E-Mail als auch per EDI erfolgen. Teilen Sie Portbase mit, welches Verfahren Sie bevorzugen.
Szenario 1a: NID Dokument erhalten (Containerladung)
Für Containerladung können Sie diese Testnachrichten erwarten:
- Eine M2401-Nachricht steht im PCS bereit. Verwenden Sie hierfür die Beispielnachrichten 'ImportDocument In Container'.
- Im Element <receiverIdentifier> steht der Wert “TERM1LADING”. In der Produktion ist dies der name Ihres eigenen terminal.
- Im Element <importDocument><number> steht ein Szenariocode aus der untenstehenden Tabelle für die verschiedenen Szenarien. Gefolgt von einem eindeutigen Code, die Dokumentnummer und der Dokumenttyp müssen immer eine eindeutige Kombination bilden.
- Für Containerladung bedeutet dies, dass das Element <equipmentlist> ausgefüllt sein muss.
| 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 Empfangsbestätigung (Containerladung)
Nach Erhalt einer M2401-Nachricht wird eine Bestätigungsnachricht vom terminal erwartet. Siehe hierzu das Beispiel M2402-Nachricht 'ImportDocument Functional Acknowledgement In'.
- Erstellen Sie eine M2402-Nachricht
- Im Element <responseTypeCode> wird für den Empfang ein 'PR'-Code erwartet
| <receiverIdentifier> | kontrolle code | <responseTypeCode> | Statusbeschreibung |
| TERM1LADING | <none> | PR | <empty> |
| TERM1LADING | RE | PR | Nicht akzeptiert, Dokumenttyp unbekannt. |
Szenario 1c: NID Dokument Empfangsbestätigung (Containerladung)
Nach Erhalt und Verarbeitung einer M2401-Nachricht wird der akzeptierte status vom terminal erwartet. Siehe hierzu das Beispiel M2402-Nachricht 'ImportDocument Functional Acknowledgement In'.
- Erstellen Sie eine M2402-Nachricht
- Im Element <responseTypeCode> wird für den Empfang ein Code erwartet, der dem gewählten Szenario aus der M2401-Nachricht entspricht. Siehe die Tabelle unten für die Optionen:
| <receiverIdentifier> | kontrolle code | <responseTypeCode> | Statusbeschreibung |
| TERM1LADING | <none> | AP | <empty> |
| TERM1LADING | RE | RE | Nicht akzeptiert, Dokumenttyp unbekannt. |
Szenario 2a: NID Dokument einreichen (Fährladung)
Für Fährladung können Sie diese Testnachrichten erwarten:
- Eine M2401-Nachricht steht im PCS bereit. Verwenden Sie hierfür die Beispielnachrichten 'ImportDocument In Shipment'.
- Im Element <receiverIdentifier> steht der Wert “TERM1LADING”. In der Produktion ist dies der name Ihres eigenen terminal.
- Im Element <importDocument><number> steht ein Szenariocode aus der untenstehenden Tabelle für die verschiedenen Szenarien. Gefolgt von einem eindeutigen Code, die Dokumentnummer und der Dokumenttyp müssen immer eine eindeutige Kombination bilden.
- Füllen Sie alle Pflichtfelder für den Test aus. Für Fährladung bedeutet dies, dass das Element <shipmentId> ausgefüllt sein muss.
| 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. |
Szenario 2b: NID Dokument Empfangsbestätigung (Fährladung)
Nach Erhalt einer M2401-Nachricht wird eine Bestätigungsnachricht vom terminal erwartet. Siehe hierzu das Beispiel M2402-Nachricht 'ImportDocument Functional Acknowledgement In'.
- Erstellen Sie eine M2402-Nachricht
- Im Element <responseTypeCode> wird für den Empfang ein 'PR'-Code erwartet
| <receiverIdentifier> | kontrolle code | <responseTypeCode> | Statusbeschreibung |
| TERM1LADING | <none> | PR | <empty> |
| TERM1LADING | RE | PR | Nicht akzeptiert, Dokumenttyp unbekannt. |
Szenario 2c: NID Dokument Reaktion (Fährladung)
Nach Erhalt und Verarbeitung einer M2401-Nachricht wird der akzeptierte status vom terminal erwartet. Siehe hierzu das Beispiel M2402-Nachricht 'ImportDocument Functional Acknowledgement In'.
- Erstellen Sie eine M2402-Nachricht
- Im Element <responseTypeCode> wird für den Empfang ein Code erwartet, der dem gewählten Szenario aus der M2401-Nachricht entspricht. Siehe die Tabelle unten für die Optionen:
| <receiverIdentifier> | kontrolle code | <responseTypeCode> | Statusbeschreibung |
| TERM1LADING | <none> | AP | <empty> |
| TERM1LADING | RE | RE | Nicht akzeptiert, Dokumenttyp unbekannt. |
Verknüpfung mit