Testscenario's voor Melding Import Documentatie (terminals)

Introductie

In dit document beschrijven we een aantal functionele scenario's die je kan testen om te zien of je verbinding goed werkt vanuit je positie als terminal. In de bijgevoegde download vind je de berichtspecificaties en voorbeeldberichten om de systeemkoppeling in te stellen waar we in dit artikel naar verwijzen.

Voor het testen op onze Klant Test omgeving (KT-omgeving) is een losse registratie nodig. Neem hierover contact op met onze afdeling Integration.

Procesflow service

De procesflow voor de service 'Melding Import Documentatie' voor  ferry- en containerterminals (V2):

Let op! Neem de volgende uitzonderingen op in het verwachte proces:

• Terminals zijn verplicht aan te sluiten op 'Berichtenflow V2'.
• Het intrekverzoek is indienen is een 'web only' toepassing, het verwerken van een intrekverzoek kan zowel via e-mail als via EDI afgehandeld worden. Maak aan Portbase een keuze bekend welk proces de voorkeur heeft.

Scenario 1a: MID document ontvangen (container lading)

Voor container lading kan je deze testberichten verwachten:

1. Een M2401-bericht staat klaar bij PCS. Gebruik hiervoor de voorbeeldberichten 'ImportDocument In Container'. 
2. In het element <receiverIdentifier> staat de waarde “TERM1LADING”. In productie is dit de naam van je eigen terminal.
3. In het element <importDocument><number> staat een scenario code uit het de onderstaande tabel voor de verschillende scenario's. Gevolgd met een uniek code, het documentnummer en documenttype moeten ten alle tijden een unieke combinatie vormen.
4. Voor container lading betekent dat het element <equipmentlist> ingevuld moet zijn.

Scenario 1b: MID document ontvangst bevestiging (container lading)

Na ontvangst van een M2401-bericht wordt een bevestigingsbericht verwacht vanuit de terminal. Zie hiervoor het voorbeeld M2402-bericht 'ImportDocument Functional Acknowledgement In'.

1. Creeër een M2402-bericht
2. In het element <responseTypeCode> wordt voor ontvangst een 'PR' code verwacht

Scenario 1c: MID document ontvangst bevestiging (container lading)

Na ontvangst en verwerking van een M2401-bericht wordt de acceptatie status verwacht vanuit de terminal. Zie hiervoor het voorbeeld M2402-bericht 'ImportDocument Functional Acknowledgement In'.

1. Creeër een M2402-bericht
2. In het element <responseTypeCode> wordt voor ontvangst een code verwacht die matcht aan het gekozen scenario uit het M2401-bericht. Zie de tabel hieronder voor de opties:

Scenario 2a: MID document insturen (ferry lading)

Voor ferry lading kan je deze testberichten verwachten:

1. Een M2401-bericht staat klaar bij PCS. Gebruik hiervoor de voorbeeldberichten 'ImportDocument In Shipment'. 
2. In het element <receiverIdentifier> staat de waarde “TERM1LADING”. In productie is dit de naam van je eigen terminal.
3. In het element <importDocument><number> staat een scenario code uit het de onderstaande tabel voor de verschillende scenario's. Gevolgd met een uniek code, het documentnummer en documenttype moeten ten alle tijden een unieke combinatie vormen.
4. Vul alle verplichte elementen in voor het testen. Voor ferry lading betekent dit dat het element <shipmentId> ingevuld moet zijn.

Scenario 2b: MID document ontvangst bevestiging (ferry lading)

Na ontvangst van een M2401-bericht wordt een bevestigingsbericht verwacht vanuit de terminal. Zie hiervoor het voorbeeld M2402-bericht 'ImportDocument Functional Acknowledgement In'.

1. Creeër een M2402-bericht
2. In het element <responseTypeCode> wordt voor ontvangst een 'PR' code verwacht

Scenario 2c: MID document reactie (ferry lading)

Na ontvangst en verwerking van een M2401-bericht wordt de acceptatie status verwacht vanuit de terminal. Zie hiervoor het voorbeeld M2402-bericht 'ImportDocument Functional Acknowledgement In'.

1. Creeër een M2402-bericht
2. In het element <responseTypeCode> wordt voor ontvangst een code verwacht die matcht aan het gekozen scenario uit het M2401-bericht. Zie de tabel hieronder voor de opties:

• Notification Import Documentation System Link.zip3 MB