Inhoudsopgave
Inhoud pagina
Message Level Response
De NPa Peppol Test Tool ondersteunt het Peppol BIS 3 Message Level Response profiel.
Dit hoofdstuk beschrijft hoe de MLR is geïmplementeerd, en hoe je kunt controleren of je access point MLRs correct afhandelt.
MLR Specificatie
- Peppol BIS Message Level Response 3.0 profile
- Peppol BIS Message Level Response 3.0 syntax
- Peppol BIS Message Level Response 3.0 business rules
MLRs versturen naar jouw access point
MLRs worden automatisch verstuurd
Wanneer de Test Tool een document, zoals een factuur, ontvangt, zal het controleren of de verzender (zoals aangegeven in de SBDH envelop) ondersteuning heeft voor message level responses. Dit wordt gedaan door middel van een SMP lookup op het proces (ProfileID) urn:fdc:peppol.eu:poacc:bis:mlr:3 en documenttype (CustomizationID) urn:fdc:peppol.eu:poacc:trns:mlr:3.
Als deze lookup succesvol is zal de Test Tool automatisch een MLR genereren en versturen.
De test tool zal maar eenmalig proberen deze MLR te versturen. Het zal een fout rapporteren wanneer de MLR niet met succes verzonden wordt, maar het zal geen nieuwe pogingen doen om de MLR opnieuw te verzenden. Wanneer je aan het testen bent of jouw access point MLR’s met success kan verwerken, en het verwerken van de MLR resulteerde in een fout op transportniveau, dan zul je een nieuw oorspronkelijk document moeten versturen om het opnieuw te proberen.
De MLR die door de test tool wordt verstuurd bevat de schematron validatie-meldingen. De MLR rapporteert ofwel Rejected (er waren schematron-validatie fouten) ofwel Accepted (er waren geen schematron-validatiefouten, maar er kunnen wel waarschuwingen in staan).
Let op: wanneer het oorspronkelijke document niet valide is, wordt deze nog steeds geaccepteerd en opgeslagen door de test tool. Een MLR-bericht met als response ‘rejected’ betekent dat het document geweigerd had kunnen worden als dit een echte access point was geweest.
Resultaat van MLR versturen bekijken
Je kunt controleren of de MLR met succes is verzonden in de ‘MLR’ kolom van het Ontvangen documenten overzicht.
De iconen geven als volgt de status weer;
| Icoon | Resultaat |
|---|---|
 |
Er is geen MLR verstuurd; ofwel de verstuurder van het document ondersteunt geen MLR, ofwel het document is ontvangen voordat MLR-ondersteuning is toegevoegd aan de test tool |
 |
De MLR is met succes verstuurd |
 |
Er is een fout opgetreden bij het versturen van de MLR |
Merk op dat dit icoon aangeeft of het versturen is gelukt, en niet of de MLR zelf aangeeft dat er document-fouten zijn.
Je kunt de MLR inzien door op het icoon te klikken.
Merk op dat het ‘Document gevalideerd’-bericht over de MLR zelf gaat; zoals je in de screenshot kun zien betreft dit niet het oorspronkelijke document dat is ontvangen, en waar de MLR over rapporteert.
MLR documenten van je access point verwerken
Wanneer jouw access point een MLR document naar de Test Tool verstuurt (oftewel, naar de Peppol Identifier die aan je account is gelinkt, in de vorm 0106:sitestXXXXX), zoekt de test tool naar de transaction identifier die aangegeven is in de MLR.
Wanneer deze niet gevonden kan worden in de verzonden documenten zal de MLR op transportniveau geweigerd worden. In deze situatie wordt de MLR niet opgeslagen of verwerkt door de test tool.
Wanneer de transactie wel gevonden wordt, wordt de MLR verwerkt en getoond in de kolom ‘MLR’ in het Verzonder Documenten overzicht.
Deze kolom bevat twee iconen: De eerste geeft aan wat de respons was zoals aangegeven in de MLR, oftwel ‘accepted’, ‘acknowledged’ of ‘rejected’. Het tweede icoon geeft aan of de MLR zelf correct is (correct, incorrect, correct maar met waarschuwingen). Dit geeft de volgende mogelijkheden:
| Iconen | Resultaat | Resultaat |
|---|---|---|
|
Er is geen MLR ontvangen | |
|
Een MLR met de status ‘geaccepteerd’ (AP) is ontvangen | De MLR zelf is correct |
|
Een MLR met de status ‘geaccepteerd’ (AP) is ontvangen | De MLR zelf is niet correct |
 |
Een MLR met de status ‘geaccepteerd’ (AP) is ontvangen | De MLR zelf is correct, maar er zijn wel validatie-waarschuwingen |
|
Een MLR met de status ‘geweigerd’ (RE) is ontvangen | De MLR zelf is correct |
|
Een MLR met de status ‘geweigerd’ (RE) is ontvangen | De MLR zelf is niet correct |
|
Een MLR met de status ‘geweigerd’ (RE) is ontvangen | De MLR zelf is correct, maar er zijn wel validatie-waarschuwingen |
|
Een MLR met de status ‘bevestigd’ (AB) is ontvangen | De MLR zelf is correct |
|
Een MLR met de status ‘bevestigd’ (AB) is ontvangen | De MLR zelf is niet correct |
|
Een MLR met de status ‘bevestigd’ (AB) is ontvangen | De MLR zelf is correct, maar er zijn wel validatie-waarschuwingen |
Je kunt het MLR-bericht zelf en een validatie-rapport van het MLR-document inzien door op een van de iconen te klikken.
Implementatie-notities en ondergespecificeerde zaken
Incorrecte MLR berichten
De specificatie van MLR 3.0 geeft niet aan hoe om te gaan met de validatie van de MLR berichten zelf; er zijn validatie-regels, en natuurlijk zouden access points altijd valide documenten moeten versturen, maar in de praktijk worden er regelmatig documenten verstuurd die niet aan alle validatie-regels voldoen. Dit is een van de redenen dat de MLR überhaupt bestaat.
De test tool gaat als volgt om met validatie:
- Wanneer het MLR bericht niet voldoet aan het XML Schema, wordt deze op transportniveau geweigerd
- Wanneer het MLR bericht niet voldoet aan Schematron validation, wordt deze geaccepteerd zo lang de test tool de benodigde informatie erin kan vinden. Problemen worden gerapporteerd in de document-overzichten.
Wanneer een MLR verstuurd wordt
De specificatie behandelt niet hoe MLR-documenten opgevraagd worden; oftewel hoe een access point te weten komt of het een MLR moet versturen. De Test Tool zal automatisch een MLR aanmaken en versturen als de verzender in de SBDH-envelop ondersteuning voor MLRs in de SMP-registratie heeft gepubliceerd.
Namespace prefixes in LineReference xpaths
De specificatie gebruikt een voorbeeld van een xpath met cac: en cbc: prefixes. Dit zijn veelgebruikte namespace prefixes, maar een implementatie zou in principe ofwel de namespace prefixes van het oorspronkelijke document moeten gebruiken, ofwel de namespaces voluit moeten neerzetten. De test tool gebruikt hiervoor namespace-uri() calls in de xpath selectors.
Onbekende transaction identifiers
De specificatie noemt niet hoe om te gaan met het geval dat er een MLR binnenkomt met een transactie-identifier die onbekend is bij het access point. De test tool zal deze op transportniveau weigeren.
NPa Peppol Test Tool documentatie
Inhoudsopgave
Inhoud pagina
Message Level Response
De NPa Peppol Test Tool ondersteunt het Peppol BIS 3 Message Level Response profiel.
Dit hoofdstuk beschrijft hoe de MLR is geïmplementeerd, en hoe je kunt controleren of je access point MLRs correct afhandelt.
MLR Specificatie
- Peppol BIS Message Level Response 3.0 profile
- Peppol BIS Message Level Response 3.0 syntax
- Peppol BIS Message Level Response 3.0 business rules
MLRs versturen naar jouw access point
MLRs worden automatisch verstuurd
Wanneer de Test Tool een document, zoals een factuur, ontvangt, zal het controleren of de verzender (zoals aangegeven in de SBDH envelop) ondersteuning heeft voor message level responses. Dit wordt gedaan door middel van een SMP lookup op het proces (ProfileID) urn:fdc:peppol.eu:poacc:bis:mlr:3 en documenttype (CustomizationID) urn:fdc:peppol.eu:poacc:trns:mlr:3.
Als deze lookup succesvol is zal de Test Tool automatisch een MLR genereren en versturen.
De test tool zal maar eenmalig proberen deze MLR te versturen. Het zal een fout rapporteren wanneer de MLR niet met succes verzonden wordt, maar het zal geen nieuwe pogingen doen om de MLR opnieuw te verzenden. Wanneer je aan het testen bent of jouw access point MLR’s met success kan verwerken, en het verwerken van de MLR resulteerde in een fout op transportniveau, dan zul je een nieuw oorspronkelijk document moeten versturen om het opnieuw te proberen.
De MLR die door de test tool wordt verstuurd bevat de schematron validatie-meldingen. De MLR rapporteert ofwel Rejected (er waren schematron-validatie fouten) ofwel Accepted (er waren geen schematron-validatiefouten, maar er kunnen wel waarschuwingen in staan).
Let op: wanneer het oorspronkelijke document niet valide is, wordt deze nog steeds geaccepteerd en opgeslagen door de test tool. Een MLR-bericht met als response ‘rejected’ betekent dat het document geweigerd had kunnen worden als dit een echte access point was geweest.
Resultaat van MLR versturen bekijken
Je kunt controleren of de MLR met succes is verzonden in de ‘MLR’ kolom van het Ontvangen documenten overzicht.
De iconen geven als volgt de status weer;
| Icoon | Resultaat |
|---|---|
|
Er is geen MLR verstuurd; ofwel de verstuurder van het document ondersteunt geen MLR, ofwel het document is ontvangen voordat MLR-ondersteuning is toegevoegd aan de test tool |
|
De MLR is met succes verstuurd |
|
Er is een fout opgetreden bij het versturen van de MLR |
Merk op dat dit icoon aangeeft of het versturen is gelukt, en niet of de MLR zelf aangeeft dat er document-fouten zijn.
Je kunt de MLR inzien door op het icoon te klikken.
Merk op dat het ‘Document gevalideerd’-bericht over de MLR zelf gaat; zoals je in de screenshot kun zien betreft dit niet het oorspronkelijke document dat is ontvangen, en waar de MLR over rapporteert.
MLR documenten van je access point verwerken
Wanneer jouw access point een MLR document naar de Test Tool verstuurt (oftewel, naar de Peppol Identifier die aan je account is gelinkt, in de vorm 0106:sitestXXXXX), zoekt de test tool naar de transaction identifier die aangegeven is in de MLR.
Wanneer deze niet gevonden kan worden in de verzonden documenten zal de MLR op transportniveau geweigerd worden. In deze situatie wordt de MLR niet opgeslagen of verwerkt door de test tool.
Wanneer de transactie wel gevonden wordt, wordt de MLR verwerkt en getoond in de kolom ‘MLR’ in het Verzonder Documenten overzicht.
Deze kolom bevat twee iconen: De eerste geeft aan wat de respons was zoals aangegeven in de MLR, oftwel ‘accepted’, ‘acknowledged’ of ‘rejected’. Het tweede icoon geeft aan of de MLR zelf correct is (correct, incorrect, correct maar met waarschuwingen). Dit geeft de volgende mogelijkheden:
| Iconen | Resultaat | Resultaat |
|---|---|---|
|
Er is geen MLR ontvangen | |
|
Een MLR met de status ‘geaccepteerd’ (AP) is ontvangen | De MLR zelf is correct |
|
Een MLR met de status ‘geaccepteerd’ (AP) is ontvangen | De MLR zelf is niet correct |
|
Een MLR met de status ‘geaccepteerd’ (AP) is ontvangen | De MLR zelf is correct, maar er zijn wel validatie-waarschuwingen |
|
Een MLR met de status ‘geweigerd’ (RE) is ontvangen | De MLR zelf is correct |
|
Een MLR met de status ‘geweigerd’ (RE) is ontvangen | De MLR zelf is niet correct |
|
Een MLR met de status ‘geweigerd’ (RE) is ontvangen | De MLR zelf is correct, maar er zijn wel validatie-waarschuwingen |
|
Een MLR met de status ‘bevestigd’ (AB) is ontvangen | De MLR zelf is correct |
|
Een MLR met de status ‘bevestigd’ (AB) is ontvangen | De MLR zelf is niet correct |
|
Een MLR met de status ‘bevestigd’ (AB) is ontvangen | De MLR zelf is correct, maar er zijn wel validatie-waarschuwingen |
Je kunt het MLR-bericht zelf en een validatie-rapport van het MLR-document inzien door op een van de iconen te klikken.
Implementatie-notities en ondergespecificeerde zaken
Incorrecte MLR berichten
De specificatie van MLR 3.0 geeft niet aan hoe om te gaan met de validatie van de MLR berichten zelf; er zijn validatie-regels, en natuurlijk zouden access points altijd valide documenten moeten versturen, maar in de praktijk worden er regelmatig documenten verstuurd die niet aan alle validatie-regels voldoen. Dit is een van de redenen dat de MLR überhaupt bestaat.
De test tool gaat als volgt om met validatie:
- Wanneer het MLR bericht niet voldoet aan het XML Schema, wordt deze op transportniveau geweigerd
- Wanneer het MLR bericht niet voldoet aan Schematron validation, wordt deze geaccepteerd zo lang de test tool de benodigde informatie erin kan vinden. Problemen worden gerapporteerd in de document-overzichten.
Wanneer een MLR verstuurd wordt
De specificatie behandelt niet hoe MLR-documenten opgevraagd worden; oftewel hoe een access point te weten komt of het een MLR moet versturen. De Test Tool zal automatisch een MLR aanmaken en versturen als de verzender in de SBDH-envelop ondersteuning voor MLRs in de SMP-registratie heeft gepubliceerd.
Namespace prefixes in LineReference xpaths
De specificatie gebruikt een voorbeeld van een xpath met cac: en cbc: prefixes. Dit zijn veelgebruikte namespace prefixes, maar een implementatie zou in principe ofwel de namespace prefixes van het oorspronkelijke document moeten gebruiken, ofwel de namespaces voluit moeten neerzetten. De test tool gebruikt hiervoor namespace-uri() calls in de xpath selectors.
Onbekende transaction identifiers
De specificatie noemt niet hoe om te gaan met het geval dat er een MLR binnenkomt met een transactie-identifier die onbekend is bij het access point. De test tool zal deze op transportniveau weigeren.