errorpeppol-bis-3

BR-33:Document level allowance reason required

A document level allowance (discount) is missing both a reason text (BT-97) and reason code (BT-98). At least one must be provided to explain why this discount exists.

We can fix this automatically

AUTO-FIX

Auto-fix: Add default reason code "95" (Discount) or reason text "Discount" if no reason provided. This is a generic but valid reason that covers most allowances.

No manual changes needed
Upload and Fix Now

Why This Error Matters

Invoice rejected. Buyer needs to understand what the allowance is for.

How to Fix It

1

Find allowance

Locate the cac:AllowanceCharge with ChargeIndicator=false that is missing reason

2

Add reason code

Insert <cbc:AllowanceChargeReasonCode>95</cbc:AllowanceChargeReasonCode> (95 = Discount)

3

Or add reason text

Alternatively add <cbc:AllowanceChargeReason>Discount</cbc:AllowanceChargeReason>

Code Example

<cac:InvoiceLine>
  <cbc:ID>1</cbc:ID>
  <!-- line content -->
</cac:InvoiceLine>
<cac:InvoiceLine>
  <cbc:ID>2</cbc:ID>
  <!-- next line -->
</cac:InvoiceLine>

Technical Details

XPath: /Invoice/cac:AllowanceCharge[cbc:ChargeIndicator='false']/cbc:AllowanceChargeReasonCode or cbc:AllowanceChargeReason. Code 95 = Discount (UNCL5189).

Common Causes

  • Document allowance has no reason text or code
  • AllowanceChargeReason and ReasonCode both empty
  • Generic discount applied without categorization
  • Export template missing reason field mapping
  • Allowance reason not mandatory in source system

Commonly Seen In

All invoicing software

Frequently Asked Questions

Each invoice line must have a unique identifier.
Add unique ID to each invoice line. You can also use Invoice Navigator's automatic Fixer tool to correct this instantly.
Yes, BR-33 is a critical error that will cause invoice rejection. It must be fixed before submission to ensure your invoice is accepted by the recipient's system.
Many instances of BR-33 can be automatically corrected using Invoice Navigator's Fixer tool. Upload your invoice and the tool will identify and fix common issues, including invoice line identifier required.
BR-33 is commonly seen in exports from All invoicing software. These software packages sometimes generate invoices that need adjustment to meet full compliance standards.

Related Errors

BR-14

Invoice line net amount required

UBL-CR-003

Duplicate invoice line ID

Last updated: 16 January 2026

Share this guide: