AttestwireRule referencePEPPOL-COMMON-R043

PEPPOL-COMMON-R043 A Belgian enterprise number must be ten digits with valid check digits

noun · Peppol BIS · fatal · BT-34

For a sample invoice, the library reports: The Seller electronic address (BT-34) is "0848934497" under scheme "0208", which identifies the Belgian enterprise number (KBO/BCE). A value in that scheme must be exactly ten digits, where the last two are 97 minus the first eight modulo 97, and this one is not.

Business term
BT-34
Severity
fatal

The fix

Correct seller.electronicAddress, or change its scheme identifier if the value belongs to a different register. A check digit failing almost always means one digit was transposed or dropped in transcription — compare it against the source register rather than re-typing it.

A passing value

the shape this field expects
"electronicAddress": { "schemeId": "0208", "value": "0848934496" }

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:

TeachingError
{
  "rule": "PEPPOL-COMMON-R043",
  "field": "BT-34",
  "severity": "fatal",
  "message": "The Seller electronic address (BT-34) is \"0848934497\" under scheme \"0208\", which identifies the Belgian enterprise number (KBO/BCE). A value in that scheme must be exactly ten digits, where the last two are 97 minus the first eight modulo 97, and this one is not. The Belgian ondernemingsnummer uses the same modulus-97 construction as an IBAN, which catches every single-digit error and almost every transposition. It only works if the number is stored with its leading zero — a value of nine digits is one that lost it somewhere. Peppol flags this fatal: the identifier is what an access point resolves to find your counterparty, so a value that fails its own check digit is undeliverable. 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 check digit failing almost always means one digit was transposed or dropped in transcription — compare it against the source register rather than re-typing it.",
  "example": "\"electronicAddress\": { \"schemeId\": \"0208\", \"value\": \"0848934496\" }",
  "xpath": "/ubl:Invoice/cac:AccountingSupplierParty/cac:Party/cbc:EndpointID",
  "docsUrl": "https://attestwire.com/rules/PEPPOL-COMMON-R043"
}

xpath is always a UBL path. On a CII invoice, look for the matching CII field instead.