The short answer
PEPPOL-EN16931-R042 fails for any cac:AllowanceCharge that has cbc:BaseAmount but no cbc:MultiplierFactorNumeric. If the amount is a percentage of that base, add the percentage, placed before cbc:Amount.
If the amount is a fixed sum, the base amount has no job to do: remove cbc:BaseAmount.
What the rule checks
The rule selects cac:AllowanceCharge elements directly under the document root or directly under a line that contain cbc:BaseAmount and lack cbc:MultiplierFactorNumeric. Being selected is the failure; no values are compared.
Allowances and charges are handled identically, and the size of the base amount is irrelevant.
Sending only cbc:Amount, with no base amount and no percentage, passes.
| Term | Meaning | UBL element |
|---|---|---|
| BG-20 | Document level allowances | cac:AllowanceCharge[cbc:ChargeIndicator = false] |
| BG-21 | Document level charges | cac:AllowanceCharge[cbc:ChargeIndicator = true] |
| BG-27 | Invoice line allowances | cac:InvoiceLine/cac:AllowanceCharge[cbc:ChargeIndicator = false] |
| BG-28 | Invoice line charges | cac:InvoiceLine/cac:AllowanceCharge[cbc:ChargeIndicator = true] |
How an integration ends up here
Possible causes, from the shape of the rule rather than from measured usage:
- The mapping always writes a base amount, such as the line or document subtotal, including for fixed-sum discounts and fees that have no percentage.
- The percentage is null in the source record because the user keyed the discount as an amount.
- A percentage of 0 is treated as empty by the serialiser and dropped, while the base amount is kept.
- The percentage is held on a price list or customer agreement and never copied onto the invoice record.
How to fix it
- Find the
cac:AllowanceChargenamed in the finding, at document level or inside a line. - Establish whether the amount was derived from a percentage. If it was, add
cbc:MultiplierFactorNumericwith that percentage, written as 10 for ten per cent. In UBL it sits beforecbc:Amount. - If it was not, remove
cbc:BaseAmount. Do not back-calculate a percentage from the amount and base just to fill the element unless that is how the amount really arose. - Once both are present, check the three figures against each other:
PEPPOL-EN16931-R040requires the amount to equal base amount x percentage / 100 within 0.02.
Validate your corrected invoice
Before and after
These are fragments, not complete documents. The complete synthetic documents they come from are linked below.
Fragment of the failing invoice: a charge with a base amount of 35.00 and no percentage
<cac:AllowanceCharge>
<cbc:ChargeIndicator>true</cbc:ChargeIndicator>
<cbc:AllowanceChargeReasonCode>CG</cbc:AllowanceChargeReasonCode>
<cbc:AllowanceChargeReason>Example document charge</cbc:AllowanceChargeReason>
<cbc:Amount currencyID="GBP">3.50</cbc:Amount>
<cbc:BaseAmount currencyID="GBP">35.00</cbc:BaseAmount>
<!-- tax category omitted from this fragment -->
</cac:AllowanceCharge>Fragment of the corrected invoice: the 10 per cent that produced 3.50 is stated
<cac:AllowanceCharge>
<cbc:ChargeIndicator>true</cbc:ChargeIndicator>
<cbc:AllowanceChargeReasonCode>CG</cbc:AllowanceChargeReasonCode>
<cbc:AllowanceChargeReason>Example document charge</cbc:AllowanceChargeReason>
<cbc:MultiplierFactorNumeric>10</cbc:MultiplierFactorNumeric>
<cbc:Amount currencyID="GBP">3.50</cbc:Amount>
<cbc:BaseAmount currencyID="GBP">35.00</cbc:BaseAmount>
<!-- tax category omitted from this fragment -->
</cac:AllowanceCharge>The corrected document adds cbc:MultiplierFactorNumeric of 10 before cbc:Amount; nothing else differs. The failing document reports only PEPPOL-EN16931-R042. No amount or total changes, so the calculation rules are untouched.
What the validator reported
- The failing invoice reports PEPPOL-EN16931-R042. The corrected document passes every layer with no findings.Download the failing XMLDownload the corrected XML
Recorded on phive 12.1.0 / phive-rules-peppol 4.5.6 / Saxon-HE 12.10, the engine behind the free validator, using synthetic data. A recorded result is regression evidence for these documents; it is not a certification.
Where it applies
- Applies to UBL
InvoiceandCreditNote, at document level and oncac:InvoiceLineorcac:CreditNoteLine. Confirmed with the validator on a line-level allowance in both document types. - The allowance inside
cac:Priceis not selected. Therecbc:BaseAmountis the gross price, no percentage is expected, andPEPPOL-EN16931-R046applies instead. - While the percentage is missing,
PEPPOL-EN16931-R040does not compare the figures for that element, so an arithmetic problem can surface only after this rule is fixed.
Related rules
- PEPPOL-EN16931-R041 is the mirror image: a percentage sent without a base amount
- PEPPOL-EN16931-R040 checks amount, base amount and percentage against each other once all three are present
- PEPPOL-EN16931-R046 covers the base amount of the allowance inside the price, which is the gross price
- Browse every rule in the reference
Scope and source
Written for Peppol BIS Billing 3.0.21 (May 2026), EN 16931 1.3.16, as applied to UBL 2.1 Invoice and CreditNote documents. Other profiles, syntaxes and releases can define this identifier differently. Guidance version 2026-09-20.1: source checked 2026-09-20, explanation last updated 2026-09-20.
The official definition of PEPPOL-EN16931-R042 carries the normative wording and test. This page is our explanation of it, not a copy.
Guidance does not change the engine verdict. Fixing this finding does not mean the document passes every layer, and validation does not certify legal or tax compliance or transmit a document over Peppol.
