attestwireAttestwire › Rule reference › PEPPOL-COMMON-R056-1
PEPPOL-COMMON-R056-1 A Dutch VAT number under scheme 9944 should be NL, nine digits, B and two digits
noun · Peppol BIS · warning · BT-34
For a sample invoice, the library reports: The Seller electronic address (BT-34) is "NL123456789" under scheme "9944", which identifies the Dutch VAT number (Peppol scheme 9944). A value in that scheme must be "NL", nine digits, the letter "B" and two digits, as in NL123456789B01, and this one is not.
- Business term
BT-34- Severity
warning
The fix
Correct seller.electronicAddress, or change its scheme identifier if the value belongs to a different register. A failing check digit or length almost always means a digit was transposed, dropped or added in transcription — compare it against the source register rather than re-typing it.
A passing value
"electronicAddress": { "schemeId": "9944", "value": "NL123456789B01" }What the library returns
The full error returned by @attestwire/en16931. It includes the rule ID,
affected field and suggested correction. Developers can use this object in their application:
{
"rule": "PEPPOL-COMMON-R056-1",
"field": "BT-34",
"severity": "warning",
"message": "The Seller electronic address (BT-34) is \"NL123456789\" under scheme \"9944\", which identifies the Dutch VAT number (Peppol scheme 9944). A value in that scheme must be \"NL\", nine digits, the letter \"B\" and two digits, as in NL123456789B01, and this one is not. The Dutch VAT identification number (btw-identificatienummer) has exactly one written form. Without the \"B\", with spaces or dots, or with a lower-case prefix it is a different string, and a participant lookup on it finds nobody. Peppol flags this one as a warning rather than a rejection, so the document will be delivered — but a wrong identifier is delivered to the wrong place, or to nowhere. Peppol added this rule in BIS 3.0.21 as a warning, to give senders time to correct their data, and has said the Dutch identifier rules become fatal in a later release. This is a Peppol BIS Billing 3.0 profile rule: it applies because profile is \"peppol-bis-3\". It does not apply to the en16931, xrechnung-ubl or xrechnung-cii profiles, whose validators will accept the same document.",
"fix": "Correct seller.electronicAddress, or change its scheme identifier if the value belongs to a different register. A failing check digit or length almost always means a digit was transposed, dropped or added in transcription — compare it against the source register rather than re-typing it.",
"example": "\"electronicAddress\": { \"schemeId\": \"9944\", \"value\": \"NL123456789B01\" }",
"xpath": "/ubl:Invoice/cac:AccountingSupplierParty/cac:Party/cbc:EndpointID",
"docsUrl": "https://attestwire.com/rules/PEPPOL-COMMON-R056-1"
}
xpath is always a UBL path. On a CII invoice, look for the
matching CII field instead.