Reference

BR-42 Invoice line allowance reason or reason code is required

Each Invoice line allowance (BG-27) shall have an Invoice line allowance reason (BT-139) or an Invoice line allowance reason code (BT-140).

This is an EN 16931 core rule and the line-level counterpart of BR-33. Each line allowance needs a reason so the buyer can check it, for example damaged packaging or a promotional price. The error appears when an ERP exports only the line discount amount without a reason text or UNCL5189 code; provide at least one. If both are given, BR-CO-07 requires that they describe the same reason.

Solution

Add cbc:AllowanceChargeReason text or cbc:AllowanceChargeReasonCode (UNCL5189) to the line allowance; if both are given they must describe the same reason.

Quick actions

Validate XML Convert invoice

Valid Examples

BT-139 = "Damaged packaging"
BT-140 = 95 (discount)

Invalid Examples

Line allowance with amount only, no reason or reason code

Code Examples

Valid XML

<cac:AllowanceCharge>
  <cbc:ChargeIndicator>false</cbc:ChargeIndicator>
  <cbc:AllowanceChargeReasonCode>95</cbc:AllowanceChargeReasonCode>
  <cbc:AllowanceChargeReason>Damaged packaging</cbc:AllowanceChargeReason>
  <cbc:Amount currencyID="EUR">3.00</cbc:Amount>
</cac:AllowanceCharge>

Invalid XML

<cac:AllowanceCharge>
  <cbc:ChargeIndicator>false</cbc:ChargeIndicator>
  <cbc:Amount currencyID="EUR">3.00</cbc:Amount>
</cac:AllowanceCharge>

Affected Fields

BT-139 Invoice line allowance reason

BT-140 Invoice line allowance reason code

Validation Tools

Official KoSIT Validator

Run the official KoSIT validator with the XRechnung configuration to check EN 16931 and XRechnung rules.

Convert PDF to XRechnung

Find validation errors during conversion and review each correction.