EN 16931 · PEPPOL 3.0.17 CERTIFIED ENGINE
Pay-As-You-Go API Credits ($0.05/op) →
InvoiceSpec / Rules Registry / peppol-bis-3 / NL-R-003
fatal ASSERTION · NL-R-003 Peppol BIS Billing 3.0 (UBL-2.1) Jurisdiction: EU

NL-R-003: For suppliers in the Netherlands, the legal entity identifier MUST be either a KVK or OIN number (schemeID 0106 or 0190)

Official Peppol BIS Billing 3.0 Spec ↗
01. Technical Specification & XPath Evaluation Context

This rule enforces the Dutch national extension of EN 16931 for Peppol BIS Billing 3.0. It applies to the supplier's legal entity identifier (BT-30) when the supplier's country (BT-40) is 'NL'. The context XPath selects the CompanyID element within the PartyLegalEntity of the AccountingSupplierParty, but only if the variable $supplierCountryIsNL evaluates to true (i.e., the supplier's country code is 'NL'). The assertion requires that the CompanyID element has a schemeID attribute with value '0106' (KVK number) or '0190' (OIN number). If the schemeID is missing or has any other value, the rule fails with fatal severity. This ensures that Dutch suppliers provide a valid legal identifier as mandated by Dutch law.

Evaluated XPath Location:
cac:AccountingSupplierParty/cac:Party/cac:PartyLegalEntity/cbc:CompanyID[$supplierCountryIsNL]
Deterministic Remediation Steps

1. Identify the supplier's legal entity identifier (cbc:CompanyID within cac:PartyLegalEntity). 2. Check the schemeID attribute. If the supplier's country (cbc:IdentificationCode in cac:Country) is 'NL', ensure the schemeID is either '0106' (for KVK number) or '0190' (for OIN number). 3. If the schemeID is missing or incorrect, update it to the appropriate value. 4. Ensure the CompanyID value is a valid KVK or OIN number as per Dutch regulations. 5. Validate the updated XML against the Peppol BIS Billing 3.0 Schematron to confirm compliance.

02. Side-by-Side UBL-2.1 Payload Diff (Rejected vs. Compliant)
--- a/invoice-rejected.xml (NL-R-003) FAIL
1 <cac:AccountingSupplierParty>
2 <cac:Party>
3 <cac:PartyLegalEntity>
4 <!-- Error: schemeID is '0088' (EAN) instead of required '0106' or '0190' for Dutch supplier -->
5 <cbc:CompanyID schemeID="0088">1234567890123</cbc:CompanyID>
6 </cac:PartyLegalEntity>
7 <cac:PostalAddress>
8 <cbc:CountrySubentity>Amsterdam</cbc:CountrySubentity>
9 <cac:Country>
10 <cbc:IdentificationCode>NL</cbc:IdentificationCode>
11 </cac:Country>
12 </cac:PostalAddress>
13 </cac:Party>
14 </cac:AccountingSupplierParty>
+++ b/invoice-compliant.xml (EN 16931 VALID) PASS
1 <cac:AccountingSupplierParty>
2 <cac:Party>
3 <cac:PartyLegalEntity>
4 + <!-- Correct: schemeID is '0106' (KVK) for Dutch supplier -->
5 + <cbc:CompanyID schemeID="0106">12345678</cbc:CompanyID>
6 </cac:PartyLegalEntity>
7 <cac:PostalAddress>
8 <cbc:CountrySubentity>Amsterdam</cbc:CountrySubentity>
9 <cac:Country>
10 <cbc:IdentificationCode>NL</cbc:IdentificationCode>
11 </cac:Country>
12 </cac:PostalAddress>
13 </cac:Party>
14 </cac:AccountingSupplierParty>
03. Interactive Peppol BIS Billing 3.0 Validation & Auto-Fix Workbench
BALANCE:3 CREDITS
invoice.xmlUBL-2.1
ORIGINCustom ERP / Billing Engine
BT-131 LINE SUM0.00 EUR
BT-106 HEADER0.00 EUR
STATUS: FAIL (2 FATAL, 1 WARN)· 1ms
Peppol BIS Billing 3.0
BR-01An Invoice shall have a valid EN 16931 Specification identifier (BT-24)
Spec & Diff
xpath: /ubl:Invoice/cbc:CustomizationID

Missing <cbc:CustomizationID> or value does not declare EN 16931 CIUS compliance.

fix: Insert <cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0</cbc:CustomizationID>.

PEPPOL-EN16931-R020Seller electronic address (BT-34) MUST be provided with a valid EAS @schemeID
Spec & Diff
xpath: /ubl:Invoice/cac:AccountingSupplierParty/cac:Party/cbc:EndpointID

Missing <cbc:EndpointID schemeID="..."> inside <cac:AccountingSupplierParty>/<cac:Party>.

fix: Add <cbc:EndpointID schemeID="9930">DE123456789</cbc:EndpointID> as the first child of Seller <cac:Party>.

BR-DE-15Buyer reference / Leitweg-ID (BT-10) is missing
Spec & Diff
xpath: /ubl:Invoice/cbc:BuyerReference

No <cbc:BuyerReference> (BT-10) found. Mandatory in XRechnung 3.0 (BR-DE-15) and required in Peppol BIS 3.0 (PEPPOL-EN16931-R003) when OrderReference is absent.

fix: Insert <cbc:BuyerReference>991-12849-74</cbc:BuyerReference> in the document header.

Deploy Direct Custom ERP / Billing Engine → Peppol BIS Billing 3.0 AP Bridge

Automated Peppol Access Point & ZUGFeRD delivery without manual XML maintenance

04. Adjacent Peppol BIS Billing 3.0 Assertions Browse All 1,145 Rules →