attestwire, n.Get an API key

Attestwire › Rule reference › PEPPOL-EN16931-R042

PEPPOL-EN16931-R042 An allowance or charge base amount requires a percentage

noun · Peppol BIS · fatal · BT-100 / BT-101

For a sample invoice, the library reports: The document level charge states a base amount of 1000 but no percentage. Peppol requires the pair to travel together in both directions: a base amount with no percentage names a figure the document then does nothing with, which reads as an incomplete edit rather than a statement.

Business term
BT-100 / BT-101
Severity
fatal

The fix

Set charges[0].percentage to the rate applied to the base, or drop charges[0].baseAmount if the adjustment is a flat amount rather than a proportion.

A passing value

the shape this field expects
{ "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:

TeachingError
{
  "rule": "PEPPOL-EN16931-R042",
  "field": [
    "BT-100",
    "BT-101"
  ],
  "severity": "fatal",
  "message": "The document level charge states a base amount of 1000 but no percentage. Peppol requires the pair to travel together in both directions: a base amount with no percentage names a figure the document then does nothing with, which reads as an incomplete edit rather than a statement. If the adjustment is a flat sum, it has no base — the amount is the whole of it. 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 charges[0].percentage to the rate applied to the base, or drop charges[0].baseAmount if the adjustment is a flat amount rather than a proportion.",
  "example": "{ \"amount\": 50.00, \"baseAmount\": 1000.00, \"percentage\": 5, \"reason\": \"Volume discount\" }",
  "xpath": "/ubl:Invoice/cac:AllowanceCharge[1]/cbc:MultiplierFactorNumeric",
  "docsUrl": "https://attestwire.com/rules/PEPPOL-EN16931-R042"
}

xpath is always a UBL path. On a CII invoice, look for the matching CII field instead.

All 306 rule pages

Nearby: PEPPOL-EN16931-R046 — The item net price must equal the gross price less the discount; PEPPOL-EN16931-R041 — An allowance or charge percentage requires a base amount; PEPPOL-EN16931-R055 — The VAT total and its accounting-currency amount must share a sign.

Want a worked example for PEPPOL-EN16931-R042? Ask, and it gets written.

Check your invoice in the browser, or over the API. Something wrong on this page?