BR-CO-05: Allowance reason code and text agree
The reason code of a document-level allowance (BT-98, UNTDID 5189) and its reason text (BT-97) must describe the same kind of allowance. Below: the message, the cause and the fix.
- Specification: EN 16931 business rules, CEN EN 16931 validation artefacts 1.3.16
- Severity: error
- Business terms: BT-97, BT-98
- Reported by
POST /einvoice/validateand our free validators, with a link to this page
The message validators print
BR-CO-05 is a rule of the EN 16931 business rules (CEN validation artefacts 1.3.16) for UBL and CII. It is an error (fatal): a validator rejects the invoice.
[BR-CO-05]-Document level allowance reason code (BT-98) and Document level allowance reason (BT-97) shall indicate the same type of allowance.What it checks
The reason code of a document-level allowance (BT-98, UNTDID 5189) and its reason text (BT-97) must describe the same kind of allowance. The published validation files cannot test the meaning of a text: the rule is written as an assertion that always holds, so no validator reports it.
Why invoices fail it
A generic code (95 discount) sits next to a text that says something else (« early payment »), which a person reading the invoice will notice even if the validator does not.
How to fix it
Choose the code that matches the text (for example 64 special agreement, 95 discount, 100 special rebate), or send the text alone.
Why no validator reports it
The published files write the test as true(): whether a code and a text mean the same thing is beyond what a schematron rule can check. No invoice can fail it, so there is no checked example; the standard’s requirement holds all the same.
The rule as published
Where the rule applies (context) and what must hold (test), unmodified from CEN EN 16931 validation artefacts 1.3.16. An assert fails when its test is false.
Text and test: © CEN/TC 434, EN 16931 validation artefacts, EUPL 1.2. Quoted unmodified; the explanations on this page are Veriport’s.
context: /ubl:Invoice/cac:AllowanceCharge[cbc:ChargeIndicator = false()] | /cn:CreditNote/cac:AllowanceCharge[cbc:ChargeIndicator = false()]
test: true()context: //ram:ApplicableHeaderTradeSettlement/ram:SpecifiedTradeAllowanceCharge/ram:ChargeIndicator[udt:Indicator='false']
test: true()Check your own invoice
Drop your XRechnung, ZUGFeRD or Peppol file into a free validator (Peppol BIS, XRechnung, Factur-X): each runs the same rule files and links every finding to its rule page. From your own code, POST /einvoice/validate (reference) returns the same check as JSON, each finding with an explanation field pointing here (5 calls a check, anonymous within the daily allowance).
Sources
- EN 16931 validation artefacts 1.3.16 (UBL and CII schematron, the business rules BR-*) — CEN/TC 434, published with the European Commission (Connecting Europe), consulted 2026-10-28
- EN 16931 validation artefacts: licence, European Union Public Licence (EUPL) v1.2 (LICENSE.txt, the README « License » section and the release notes of validation-1.3.16) — European Commission (Connecting Europe), for CEN/TC 434, consulted 2026-11-17. The EUPL permits reproduction and communication to the public, with the licence, the copyright notices and the disclaimer kept; a modified copy must say so. The rule library quotes the rule ids and messages of the BR-*, UBL-* and CII-* rules unmodified, credits the artefacts and links the licence.