attestwireAttestwire › Rule reference › PEPPOL-COMMON-R056-2
PEPPOL-COMMON-R056-2 A VAT identifier that starts with NL should be NL, nine digits, B and two digits
noun · Peppol BIS · warning · BT-48
For a sample invoice, the library reports: The buyer VAT identifier (BT-48) is "NL123456789". It starts with "NL", so Peppol reads it as a Dutch VAT number, and a Dutch VAT number has exactly one written form: "NL", nine digits, the letter "B" and two digits, as in NL123456789B01. This one does not match it.
- Business term
BT-48- Severity
warning
The fix
Write buyer.vatId in the form the Dutch tax administration issued it: "NL", the nine digits, "B" and the two-digit suffix, with no spaces, dots or hyphens. If the party is not Dutch, the value should not start with "NL": use the prefix of the country that issued the number.
A passing value
"vatId": "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-2",
"field": "BT-48",
"severity": "warning",
"message": "The buyer VAT identifier (BT-48) is \"NL123456789\". It starts with \"NL\", so Peppol reads it as a Dutch VAT number, and a Dutch VAT number has exactly one written form: \"NL\", nine digits, the letter \"B\" and two digits, as in NL123456789B01. This one does not match it. PEPPOL-COMMON-R056-1 asks the same of an electronic address under scheme 9944; this rule asks it of every VAT identifier, whatever scheme the party is addressed under. Peppol flags this one as a warning rather than a rejection, so the document will be delivered, but a VAT number in any other form fails a VIES lookup and the buyer's own checks against it. 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": "Write buyer.vatId in the form the Dutch tax administration issued it: \"NL\", the nine digits, \"B\" and the two-digit suffix, with no spaces, dots or hyphens. If the party is not Dutch, the value should not start with \"NL\": use the prefix of the country that issued the number.",
"example": "\"vatId\": \"NL123456789B01\"",
"xpath": "/ubl:Invoice/cac:AccountingCustomerParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyID",
"docsUrl": "https://attestwire.com/rules/PEPPOL-COMMON-R056-2"
}
xpath is always a UBL path. On a CII invoice, look for the
matching CII field instead.