attestwireAttestwire › Rule reference › PEPPOL-EN16931-R041
PEPPOL-EN16931-R041 An allowance or charge percentage requires a base amount
noun · Peppol BIS · fatal · BT-93 / BT-94
For a sample invoice, the library reports: The document level allowance states a percentage of 5% but no base amount. Peppol requires the base whenever the percentage is present, because a percentage on its own is not checkable: the reader can see that you claim 5% and cannot see 5% *of what*, so the amount has to be taken on trust.
- Business term
BT-93 / BT-94- Severity
fatal
The fix
Set allowances[0].baseAmount to the figure the percentage is applied to, or drop allowances[0].percentage and state the amount alone. Note that the base is not necessarily the line or document total — it is whatever your commercial agreement computes the discount on.
A passing value
{ "amount": 50.00, "baseAmount": 1000.00, "percentage": 5, "reason": "Volume discount" }What the library returns
The full error returned by @attestwire/en16931. It includes the rule ID,
affected field and suggested correction. Developers can use this object in their application:
{
"rule": "PEPPOL-EN16931-R041",
"field": [
"BT-93",
"BT-94"
],
"severity": "fatal",
"message": "The document level allowance states a percentage of 5% but no base amount. Peppol requires the base whenever the percentage is present, because a percentage on its own is not checkable: the reader can see that you claim 5% and cannot see 5% *of what*, so the amount has to be taken on trust. With both terms present, PEPPOL-EN16931-R040 can verify that the amount is what the percentage produces. Core EN 16931 leaves both optional and independent; this is a genuine tightening. This is a Peppol BIS Billing 3.0 profile rule: it applies because profile is \"peppol-bis-3\". It does not apply to the en16931, xrechnung-ubl or xrechnung-cii profiles, whose validators will accept the same document.",
"fix": "Set allowances[0].baseAmount to the figure the percentage is applied to, or drop allowances[0].percentage and state the amount alone. Note that the base is not necessarily the line or document total — it is whatever your commercial agreement computes the discount on.",
"example": "{ \"amount\": 50.00, \"baseAmount\": 1000.00, \"percentage\": 5, \"reason\": \"Volume discount\" }",
"xpath": "/ubl:Invoice/cac:AllowanceCharge[1]/cbc:BaseAmount",
"docsUrl": "https://attestwire.com/rules/PEPPOL-EN16931-R041"
}
xpath is always a UBL path. On a CII invoice, look for the
matching CII field instead.