Overview of Peppol DocumentType identifiers: URNs for invoices, credit notes, orders and more.
Every document on the Peppol network has a DocumentTypeId. This is a unique URN (Uniform Resource Name) that precisely indicates which format and profile the document follows. The DocumentTypeId is used for SMP registration (to indicate which documents an organisation can receive), for routing and for validation.
A DocumentTypeId looks complex at first glance but follows a fixed structure. Take the NLCIUS invoice DocumentTypeId as an example:
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
This contains three parts:
urn:oasis:names:specification:ubl:schema:xsd:Invoice-2urn:cen.eu:en16931:2017#compliant#urn:fdc:nen.nl:nlcius:v1.02.1The root namespace tells which XML schema is used. The customization tells which profile and country-specific implementation applies. The version refers to the UBL specification version.
The table below contains the most commonly used DocumentTypeIds for invoices and credit notes.
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.1The eConnect PSB groups DocumentTypeIds into document families. When configuring SMP capabilities or querying document types via the API, you can use these family names as shorthand instead of full URNs.
InvoiceInvoiceResponseReviewOrderOrderResponseOrderChangeOrderCancellationDespatchAdviceTimeCardTip: via the PSB API you can use
queryRecipientPartyto query which DocumentTypeIds a receiver supports. This is useful for checking in advance whether your document can be delivered correctly.
Some formats are no longer valid on the Peppol network:
Note: if your invoices are being rejected with an error about an invalid CustomizationID, check whether you are still using a deprecated format. Upgrade to NLCIUS/SI-UBL 2.0 or BIS Billing V3.
More information about the complete code lists can be found in the Peppol BIS Billing specification at docs.peppol.eu/poacc/billing/3.0/.
Download sample files