erroren16931

BR-DEC-08:Allowance total: max 2 decimals

AllowanceTotalAmount allows max 2 decimal places.

Severity
Fatal
Rule set
en16931
Country
All EU
Fix type
BLOCKED

Engine Classification

Financial or legal field · Modification blocked by policy

Reason: Allowance total amounts must have maximum 2 decimal places. Automatic rounding could cause invoice calculation mismatches. Fix the allowance amounts in your source system to use proper 2-decimal precision.

What is BR-DEC-08?

BR-DEC-08 is a fatal validation rule defined in the en16931 specification. It validates the AllowanceTotalAmount element under Invoice > LegalMonetaryTotal in the UBL invoice XML.

When this rule fires, the invoice is non-compliant and will be rejected by Peppol access points and national validation services. The sending system receives a rejection response and the invoice does not reach the buyer.

Target path: XPath: /Invoice/cac:LegalMonetaryTotal/cbc:AllowanceTotalAmount

This error requires manual correction — financial fields are protected by policy.

Why This Error Matters

Document totals need standard precision.

BR-DEC-08 is a hard failure. Invoices that trigger this rule are rejected at the access point and never reach the recipient. In Peppol networks, this means your sending system receives an MLR (Message Level Response) with a rejection status. The invoice must be corrected and re-sent, adding delay to your payment cycle.

Validator Behavior

  • ·Causes invoice rejection
  • ·Fails EN 16931 business rule validation
  • ·Error returned: BR-DEC-08
  • ·Specification: en16931

How to Fix It

1.

Check total

AllowanceTotalAmount precision

2.

Round

2 decimal maximum

XML Example

Generic example based on the rule's target XPath. Your actual XML structure may differ.

Before
<!-- Missing or empty element triggers cbc:AllowanceTotalAmount error -->
<cbc:AllowanceTotalAmount></cbc:AllowanceTotalAmount>
After
<!-- Provide the required value -->
<cbc:AllowanceTotalAmount>VALID_VALUE</cbc:AllowanceTotalAmount>

Technical Reference

XPathXPath: /Invoice/cac:LegalMonetaryTotal/cbc:AllowanceTotalAmount
Specen16931

Common Causes

  • ·Sum creates extra decimals

Seeing this in production? The API handles BR-DEC-08 automatically. See the fix response →

Frequently Asked Questions

AllowanceTotalAmount allows max 2 decimal places.

Round allowance total to 2 decimals. Invoice Navigator can help identify and fix this issue.

Yes, BR-DEC-08 is a critical error that must be fixed.

See Also

Related Errors

Last updated: 18 January 2026

Share this guide:

Handle BR-DEC-08 Automatically in Your Pipeline

The compliance engine auto-remediates this error with controlled safety policies and evidence pack generation.