How to fix BR-01

What this rule checks

Every Peppol BIS 3.0 invoice must include a specification identifier that tells the receiver which standard the invoice conforms to. This element (BT-24, mapped to cbc:CustomizationID) is required so that automated systems know how to interpret the rest of the document. Without it, the invoice cannot be routed or validated correctly.

How to fix it

Add a cbc:CustomizationID element at the Invoice root level containing the correct Peppol BIS 3.0 specification identifier.

Common causes

• The cbc:CustomizationID element is completely missing from the invoice XML.
• The element is present but empty (no text content).
• A typo in the element name prevents it from being recognized.
• The element was accidentally placed inside the wrong parent element.

Example: before (broken)

<Invoice xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2"
         xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2">
  <!-- cbc:CustomizationID is missing -->
  <cbc:ID>INV-2024-001</cbc:ID>
  <cbc:IssueDate>2024-01-15</cbc:IssueDate>
</Invoice>

Example: after (fixed)

<Invoice xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2"
         xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2">
  <cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0</cbc:CustomizationID>
  <cbc:ID>INV-2024-001</cbc:ID>
  <cbc:IssueDate>2024-01-15</cbc:IssueDate>
</Invoice>

Related rules