BR-CO-07: Line allowance reason code and text agree
The reason code (BT-140) and reason text (BT-139) of a line allowance must describe the same 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-139, BT-140
- Reported by
POST /einvoice/validateand our free validators, with a link to this page
The message validators print
BR-CO-07 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-07]-Invoice line allowance reason code (BT-140) and Invoice line allowance reason (BT-139) shall indicate the same type of allowance reason.What it checks
The reason code (BT-140) and reason text (BT-139) of a line allowance must describe the same allowance. The published files cannot test meaning and hold this rule as always true, so validators never report it.
Why invoices fail it
A line discount carries a code copied from a template and a text written by hand.
How to fix it
Make the UNTDID 5189 code match the text, 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: //cac:InvoiceLine/cac:AllowanceCharge[cbc:ChargeIndicator = false()] | //cac:CreditNoteLine/cac:AllowanceCharge[cbc:ChargeIndicator = false()]
test: true()context: //ram:SpecifiedLineTradeSettlement/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.