Overzicht van Peppol DocumentType identifiers: URN's voor facturen, creditnota's, orders en meer.
Elk document op het Peppol-netwerk heeft een DocumentTypeId. Dit is een unieke URN (Uniform Resource Name) die precies aangeeft welk formaat en profiel het document volgt. Het DocumentTypeId wordt gebruikt bij SMP-registratie (om aan te geven welke documenten een organisatie kan ontvangen), bij routering en bij validatie.
Een DocumentTypeId ziet er op het eerste gezicht complex uit, maar volgt een vaste structuur. Neem het NLCIUS-factuur DocumentTypeId als voorbeeld:
urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#compliant#urn:fdc:nen.nl:nlcius:v1.0::2.1
Dit bevat drie onderdelen:
urn:oasis:names:specification:ubl:schema:xsd:Invoice-2urn:cen.eu:en16931:2017#compliant#urn:fdc:nen.nl:nlcius:v1.02.1De root namespace vertelt welk XML-schema wordt gebruikt. De customization vertelt welk profiel en welke landspecifieke invulling van toepassing is. De versie verwijst naar de UBL-specificatieversie.
De onderstaande tabel bevat de meest gebruikte DocumentTypeId's voor facturen en creditnota's.
urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::2.1urn:oasis:names:specification:ubl:schema:xsd:CreditNote-2::CreditNote##urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::2.1urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#compliant#urn:fdc:nen.nl:nlcius:v1.0::2.1urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#compliant#urn:fdc:nen.nl:nlcius:v1.0#conformant#urn:fdc:nen.nl:gaccount:v1.0::2.1urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:selfbilling:3.0::2.1urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0::2.1urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#conformant#urn:UBL.BE:1.0.0.20180214::2.1urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:peppol:pint:billing-1@eu-1::2.1urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#compliant#urn:fdc:nen.nl:nlcius:v1.0#compliant#urn:fdc:setu.nl:invoice:v2.2::2.1urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100::CrossIndustryInvoice##urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::D16Burn:oasis:names:specification:ubl:schema:xsd:Order-2::Order##urn:fdc:peppol.eu:poacc:trns:order:3::2.1urn:oasis:names:specification:ubl:schema:xsd:OrderResponse-2::OrderResponse##urn:fdc:peppol.eu:poacc:trns:order_response:3::2.1urn:oasis:names:specification:ubl:schema:xsd:OrderResponse-2::OrderResponse##urn:fdc:peppol.eu:poacc:trns:order_response_advanced:3::2.3urn:oasis:names:specification:ubl:schema:xsd:OrderChange-2::OrderChange##urn:fdc:peppol.eu:poacc:trns:order_change:3::2.3urn:oasis:names:specification:ubl:schema:xsd:OrderCancellation-2::OrderCancellation##urn:fdc:peppol.eu:poacc:trns:order_cancellation:3::2.3urn:oasis:names:specification:ubl:schema:xsd:ApplicationResponse-2::ApplicationResponse##urn:fdc:peppol.eu:poacc:trns:invoice_response:3::2.1urn:oasis:names:specification:ubl:schema:xsd:ApplicationResponse-2::ApplicationResponse##urn:peppol:edec:mls:1.0::2.1urn:oasis:names:specification:ubl:schema:xsd:DespatchAdvice-2::DespatchAdvice##urn:fdc:peppol.eu:poacc:trns:despatch_advice:3::2.1De eConnect PSB groepeert DocumentTypeId's in documentfamilies. Bij het configureren van SMP-capabilities of het opvragen van documenttypes via de API kun je deze familienamen als shorthand gebruiken in plaats van volledige URN's.
InvoiceInvoiceResponseReviewOrderOrderResponseOrderChangeOrderCancellationDespatchAdviceTimeCardTip: Via de PSB-API kun je met
queryRecipientPartyopvragen welke DocumentTypeId's een ontvanger ondersteunt. Dit is handig om vooraf te controleren of je document correct kan worden afgeleverd.
Enkele formaten zijn niet langer geldig op het Peppol-netwerk:
Let op: Als je facturen worden geweigerd met een fout over een ongeldig CustomizationID, controleer dan of je nog een verouderd formaat gebruikt. Upgrade naar NLCIUS/SI-UBL 2.0 of BIS Billing V3.
Nee. Het DocumentTypeId wordt niet in de factuur zelf opgenomen, maar door de PSB bepaald op basis van het CustomizationID in je XML. Het DocumentTypeId is een SMP-registratie en routeringsconcept. Je hoeft alleen het juiste CustomizationID in je factuur te gebruiken.
Dit betekent waarschijnlijk dat je een verouderd formaat gebruikt, zoals SI-UBL 1.2. Upgrade naar NLCIUS/SI-UBL 2.0 of Peppol BIS Billing V3. Controleer het CustomizationID-element in je XML en vergelijk het met de actuele waarden in dit overzicht.
Via de PSB API kun je met de functie queryRecipientParty opvragen welke DocumentTypeId's een ontvanger heeft geregistreerd in de SMP. Dit is handig om vooraf te controleren of je document correct kan worden afgeleverd.
Meer informatie over de volledige codelijsten vind je in de Peppol BIS Billing-specificatie op docs.peppol.eu/poacc/billing/3.0/.
Download voorbeeldbestanden