Introductie
In dit document beschrijven we een aantal functionele scenario's die je kan testen om te zien of je systeemkoppeling met Melding Export Documentatie goed werkt. Meer informatie over de service vind je in het artikel Systeemkoppeling maken met Melding Export Documentatie.
In dit artikel gebruiken we berichtspecificaties en voorbeeldberichten die je kunt vinden in deze download.
De service MED is bedoeld om documenten voor Export zendingen voor te melden bij een terminal. Nieuwe documenten kunnen via het scherm of een systeemkoppeling worden opgevoerd, ge-update en verwijderd. Daarnaast kun je via de systeemkoppeling statusupdates ontvangen, ongeacht via welke manier documenten zijn opgevoerd.
Procesflow service MED
Scenario 1: Nieuw MED document insturen
- Maak een M114-bericht aan vanuit jouw eigen systeem, volgens de specificaties. Zie hiervoor de voorbeeldberichten in de download.
- Kies als contentAction 'original'
- Gebruik als documentType uitsluitend een types uit de lijst van MED-documentTypes.
- Vul <documentNumber> met het MRN van de Export of Transit aangifte. In geval van andere documentTypes, gebruik dan het referentienummer van dat document.
- Wil je een functionele afkeur testen, gebruik dan 2x hetzelfde MRN met een ander equipment in opvolgende berichten. Omdat het MRN uniek moet zijn, zal de 2e afgekeurd worden.
- Stuur het bericht naar PCS in de KT-omgeving van Portbase.
Mogelijke resultaten:
- Bij Technische afkeur. Je ontvangt een TA07 Technical acknowledgement bericht met code 'NAK'
- Bij Technische acceptatie. Je ontvangt een TA07 Technical acknowledgement bericht met code 'AK'
- Deze ontvang je alleen indien je gekozen hebt om altijd een 'technical acknowledgement' te ontvangen.
Vervolgens
- Bij Functionele afkeur. Je ontvangt een M116 bericht met responseTypeCode 'RP'.
- De reden van afkeur staat omschreven in het veld <errorDescription>.
- Zie de M116 bericht specificaties in de download voor de lijst van mogelijke afkeur redenen.
- Bij Functionele acceptatie. Je ontvangt een M116 bericht met responseTypeCode 'AR'.
- Het document is hierna geaccepteerd en zal doorgestuurd worden naar terminals die de boeking uit het bericht verwachten.
Vervolgens
- Bij Document Status wijziging. Je ontvangt een M115 bericht met daarin een statusCode van het document.
- Zie de M115 bericht specificaties in de download voor de lijst van statusCodes en hun betekenis.
- M115 berichten worden alleen verstuurd voor Export en Transit documenten. Overige documentTypes krijgen geen status updates, omdat deze niet door Portbase naar de Douane verstuurd worden.
- Je ontvangt M115 berichten alleen als je hiervoor bent aangemeld bij Portbase.
Scenario 2: bestaand MED document aanpassen / vervangen
- Voer eerst Scenario 1 uit.
- Maak een nieuw M114-bericht aan vanuit jullie eigen systeem, volgens de specificaties. Zie hiervoor de voorbeeldberichten in de download.
- Vul <contentReference> met een nieuwe unieke waarde.
- Kies als contentAction 'replace'.
- Vul <previousContentReference> met de waarde van <contentReference> uit het M114 bericht uit Scenario 1.
- Pas een of meerdere waarden aan in de <contentBody>.
- Document of equipment details aanpassen.
- Je kunt een equipment toevoegen of verwijderen, mits er ten minste 1 equipment per document overblijft.
- Je kunt een document, met eigen equipment, toevoegen of verwijderen, mits er ten minste 1 document overblijft.
- Stuur het bericht naar PCS in de KT-omgeving van Portbase.
Mogelijke resultaten:
- Bij technische afkeur. Je ontvangt een TA07 Technical acknowledgement bericht met code 'NAK'
- Bij technische acceptatie. Je ontvangt een TA07 Technical acknowledgement bericht met code 'AK'
- Deze ontvang je alleen als je gekozen hebt om altijd een 'technical acknowledgement' te ontvangen.
Vervolgens
- Bij Functionele afkeur. Je ontvangt een M116 bericht met responseTypeCode 'RP'.
- De reden van afkeur staat omschreven het veld <errorDescription>.
- Zie de M116 bericht specificaties in de download voor de lijst van mogelijke afkeur redenen.
- Afhankelijk van de status van het document, kunnen aanpassingen niet meer toegestaan zijn.
- Bij Functionele acceptatie. Je ontvangt een M116 bericht met responseTypeCode 'AR'.
- De gevraagde aanpassing is hierna opgeslagen in MED en zal doorgestuurd worden naar terminals die de boeking uit het bericht verwachten.
Vervolgens
- Bij Document Status wijziging. Je ontvangt een M115 bericht met daarin een statusCode van het document.
- Zie de M115 bericht specificaties in de download voor de lijst van statusCodes en hun betekenis.
- M115 berichten worden alleen verstuurd voor Export en Transit documenten. Overige documentTypes kijgen geen status updates, omdat deze niet door Portbase naar de Douane verstuurd worden.
- Je ontvangt M115 berichten alleen als je hiervoor bent aangemeld bij Portbase.
Scenario 3: bestaand MED document verwijderen
- Voer eerst Scenario 1 uit.
- Maak een nieuw M114-bericht aan vanuit jullie eigen systeem, volgens de specificaties. Zie hiervoor de voorbeeldberichten in de download.
- Vul <contentReference> met een nieuwe unieke waarde
- Kies als contentAction 'deletion'
- Vul <previousContentReference> met de waarde van <contentReference> uit het M114 bericht uit Scenario 1.
- Herhaal de waarden uit de <contentBody> van het bericht uit Scenario 1.
- Stuur het bericht naar PCS in de KT-omgeving van Portbase.
Mogelijke resultaten:
- Bij Technische afkeur. Je ontvangt een TA07 Technical acknowledgement bericht met code 'NAK'
- Bij Technische acceptatie. Je ontvangt een TA07 Technical acknowledgement bericht met code 'AK'
- Deze ontvang je alleen als je gekozen hebt om altijd een Technical acknowledgement te ontvangen.
Vervolgens
- Bij Functionele afkeur. Je ontvangt een M116 bericht met responseTypeCode 'RP'.
- De reden van afkeur staat omschreven het veld <errorDescription>.
- Zie de M116 bericht specificaties in de download voor de lijst van mogelijke afkeur redenen.
- Afhankelijk van de status van het document, kunnen verwijderingen niet meer toegestaan zijn. Bijvoorbeeld wanneer het document al op een Export Manifest vermeld is.
- Bij Functionele acceptatie. Je ontvangt een M116 bericht met responseTypeCode 'AR'.
- Het document is hierna verwijderd uit MED. De terminals die de boeking uit het bericht verwachten zullen ook de verwijdering doorkrijgen.
Vervolgens
- Bij Document Status wijziging. Je ontvangt een M115 bericht met daarin een statusCode van het document.
- Zie de M115 bericht specificaties in de download voor de lijst van statusCodes en hun betekenis.
- M115 berichten worden alleen verstuurd voor Export en Transit documenten. Overige documentTypes kijgen geen status updates, omdat deze niet door Portbase naar de Douane verstuurd worden.
- Je ontvangt M115 berichten alleen als je hiervoor bent aangemeld bij Portbase.