Skip to main content

Reference

Markdown export

BT-140 Invoice Line Allowance Reason Code

Coded reason for an invoice line allowance.

Quick answer

Line items

The goods or services on each invoice line, including quantities, prices, and VAT.

Quick actions

Validate XMLConvert invoice

In plain language

Captures line-level discounts and surcharges so the invoice line net amount can be reconciled from quantity, price, allowances, and charges.

What you usually enter here

Code from the allowance reason code list

Typical valid values include: 95

Defined by EN 16931 for invoice line allowance and charge details; apply profile cardinality and the listed code list or calculation rules when the element is present.

Where the field sits

Lines
UBL 2.1 Syntax
  1. Invoice
  2. cac:InvoiceLine
  3. cac:AllowanceCharge[cbc:ChargeIndicator=false()]
  4. cbc:AllowanceChargeReasonCodeBT-140
CII (UN/CEFACT) Syntax
  1. rsm:CrossIndustryInvoice
  2. rsm:SupplyChainTradeTransaction
  3. ram:IncludedSupplyChainTradeLineItem
  4. ram:SpecifiedLineTradeSettlement
  5. ram:SpecifiedTradeAllowanceCharge[ram:ChargeIndicator/udt:Indicator=false()]
  6. ram:ReasonCodeBT-140
BT-140 belongs to the Lines part of the invoice. UBL 2.1 Syntax: Invoice › cac:InvoiceLine › cac:AllowanceCharge[cbc:ChargeIndicator=false()] › cbc:AllowanceChargeReasonCode. CII (UN/CEFACT) Syntax: rsm:CrossIndustryInvoice › rsm:SupplyChainTradeTransaction › ram:IncludedSupplyChainTradeLineItem › ram:SpecifiedLineTradeSettlement › ram:SpecifiedTradeAllowanceCharge[ram:ChargeIndicator/udt:Indicator=false()] › ram:ReasonCode.

What goes wrong often

Avoid values like: discount

Relevant rule codes: BR-CL-19

Valid Examples

  • 95

Invalid Examples

  • discount

XML mapping and field facts

Open the technical reference if you need XML paths, validator rule codes, legal wording, or schema-specific mapping details.

Field ID:

BT-140

Data Type:

code

Cardinality:

0..1

Requirement:

Optional

XML Implementation

UBL 2.1 Syntax
/Invoice/cac:InvoiceLine/cac:AllowanceCharge[cbc:ChargeIndicator=false()]/cbc:AllowanceChargeReasonCode
CII (UN/CEFACT) Syntax
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeSettlement/ram:SpecifiedTradeAllowanceCharge[ram:ChargeIndicator/udt:Indicator=false()]/ram:ReasonCode

Validation Rules

BR-CL-19

BR-CL-19

Next step

Check whether your XRechnung sets BT-140 correctly

Upload the XML file to the free validator. It applies the KoSIT rules for XRechnung 3.0 and names each finding with its rule ID, for this field for example BR-CL-19. Creating a new invoice instead? The converter checks the invoice against the same rules and shows the findings before download.

Validate XMLConvert invoice

Free, no account needed. XML file up to 2 MB.

Official sources and tools

KoSIT Validator
XRechnung Standard
Test Suite