Reference

BR-38 Document level charge reason or reason code is required

Each Document level charge (BG-21) shall have a Document level charge reason (BT-104) or a Document level charge reason code (BT-105).

This is an EN 16931 core rule and the charge counterpart of BR-33. The buyer must understand what the charge is for, for example freight, insurance or packaging. The error appears when the export writes only the charge amount without a reason text or UNCL7161 code; provide at least one. If both are given, BR-CO-06 requires that they describe the same reason.

Solution

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

Quick actions

Validate XML Convert invoice

Valid Examples

BT-104 = "Freight"
BT-105 = FC (freight charge)

Invalid Examples

Document charge with amount only, no reason or reason code

Code Examples

Valid XML

<cac:AllowanceCharge>
  <cbc:ChargeIndicator>true</cbc:ChargeIndicator>
  <cbc:AllowanceChargeReasonCode>FC</cbc:AllowanceChargeReasonCode>
  <cbc:AllowanceChargeReason>Freight</cbc:AllowanceChargeReason>
  <cbc:Amount currencyID="EUR">9.90</cbc:Amount>
</cac:AllowanceCharge>

Invalid XML

<cac:AllowanceCharge>
  <cbc:ChargeIndicator>true</cbc:ChargeIndicator>
  <cbc:Amount currencyID="EUR">9.90</cbc:Amount>
</cac:AllowanceCharge>

Affected Fields

BT-104 Document level charge reason

BT-105 Document level charge 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.