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-001
fatal ASSERTION · NL-R-001 Peppol BIS Billing 3.0 (UBL-2.1) Jurisdiction: EU

NL-R-001: For suppliers in the Netherlands, if the document is a creditnote, the document MUST contain an invoice reference (cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID)

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

NL-R-001 is a Dutch national rule (Peppol BIS Billing 3.0, UBL-2.1) that enforces the legal requirement that a credit note issued by a Dutch supplier must reference the original invoice it corrects. The context XPath `cbc:CreditNoteTypeCode[$supplierCountryIsNL]` selects the CreditNoteTypeCode element (BT-3) only when the supplier's country (BT-40, derived from cac:AccountingSupplierParty/cac:Party/cac:PostalAddress/cbc:Country/cac:IdentificationCode or cbc:IdentificationCode) is 'NL'. The rule fires when the document is a credit note (CreditNoteTypeCode = 381) and the required BillingReference/InvoiceDocumentReference/ID (BT-25, the referenced invoice number) is absent. The assertion is fatal because without the original invoice reference the credit note cannot be legally matched to the corrected invoice, breaking VAT auditability. The XPath test evaluates the presence of `cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID` relative to the document root; if the node-set is empty, the assertion fails.

Evaluated XPath Location:
cbc:CreditNoteTypeCode[$supplierCountryIsNL]
Deterministic Remediation Steps

1. Identify the original invoice number that the credit note corrects. 2. In the UBL CreditNote document, add a cac:BillingReference element as a direct child of the CreditNote root (after cbc:DocumentCurrencyCode and before cac:AccountingSupplierParty). 3. Inside cac:BillingReference, add cac:InvoiceDocumentReference. 4. Inside cac:InvoiceDocumentReference, add cbc:ID with the original invoice number as its text content. 5. Ensure the supplier's country code is correctly set to 'NL' in cac:AccountingSupplierParty/cac:Party/cac:PostalAddress/cbc:Country/cbc:IdentificationCode. 6. Validate the document against the Peppol BIS Billing 3.0 Schematron to confirm the rule passes.

02. Side-by-Side UBL-2.1 Payload Diff (Rejected vs. Compliant)
--- a/invoice-rejected.xml (NL-R-001) FAIL
1 <!-- Credit note from a Dutch supplier missing the mandatory invoice reference -->
2 <CreditNote xmlns="urn:oasis:names:specification:ubl:schema:xsd:CreditNote-2"
3 xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2"
4 xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2">
5 <cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0</cbc:CustomizationID>
6 <cbc:ProfileID>urn:fdc:peppol.eu:2017:poacc:billing:01:1.0</cbc:ProfileID>
7 <cbc:ID>CN-2024-001</cbc:ID>
8 <cbc:IssueDate>2024-05-01</cbc:IssueDate>
9 <cbc:CreditNoteTypeCode>381</cbc:CreditNoteTypeCode>
10 <cbc:DocumentCurrencyCode>EUR</cbc:DocumentCurrencyCode>
11 - <!-- ERROR: No cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID present -->
12 <cac:AccountingSupplierParty>
13 <cac:Party>
14 <cac:PostalAddress>
15 <cbc:Country>
16 <cbc:IdentificationCode>NL</cbc:IdentificationCode>
17 </cbc:Country>
18 </cac:PostalAddress>
19 </cac:Party>
20 </cac:AccountingSupplierParty>
21 <!-- ... rest of credit note ... -->
22 </CreditNote>
+++ b/invoice-compliant.xml (EN 16931 VALID) PASS
1 + <!-- Compliant credit note with mandatory invoice reference -->
2 <CreditNote xmlns="urn:oasis:names:specification:ubl:schema:xsd:CreditNote-2"
3 xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2"
4 xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2">
5 <cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0</cbc:CustomizationID>
6 <cbc:ProfileID>urn:fdc:peppol.eu:2017:poacc:billing:01:1.0</cbc:ProfileID>
7 <cbc:ID>CN-2024-001</cbc:ID>
8 <cbc:IssueDate>2024-05-01</cbc:IssueDate>
9 <cbc:CreditNoteTypeCode>381</cbc:CreditNoteTypeCode>
10 <cbc:DocumentCurrencyCode>EUR</cbc:DocumentCurrencyCode>
11 + <cac:BillingReference>
12 + <cac:InvoiceDocumentReference>
13 + <cbc:ID>INV-2024-0001</cbc:ID>
14 + </cac:InvoiceDocumentReference>
15 + </cac:BillingReference>
16 <cac:AccountingSupplierParty>
17 <cac:Party>
18 <cac:PostalAddress>
19 <cbc:Country>
20 <cbc:IdentificationCode>NL</cbc:IdentificationCode>
21 </cbc:Country>
22 </cac:PostalAddress>
23 </cac:Party>
24 </cac:AccountingSupplierParty>
25 <!-- ... rest of credit note ... -->
26 </CreditNote>
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 (1 FATAL, 1 WARN)· 1ms
Peppol BIS Billing 3.0
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 →