Attestwire

Rule reference

BR-DEC-17 The rounding amount (BT-114) is 0.005, which carries 3 decimals; EN 16931 allows at most 2

The rounding amount (BT-114) is 0.005, which carries 3 decimals; EN 16931 allows at most 2. BT-114 is the small correction added to make the payable amount a convenient figure — a few cents up or down, or the five-cent rounding some cash regimes require — so a rounding amount that is itself unrounded is a contradiction in terms, and one that leaves BT-115 no rounder than it started. The value may be negative; only the precision is constrained.

This rule is implemented and its error payload below is real, but the long-form write-up — normative text, worked example, divergence note — is not written yet. Everything the library knows about this rule is on this page. Ask and we will prioritise it.

Business term
BT-114
Severity
fatal

What the library returns

The exact object in result.errors when this rule fires. Generated by running @attestwire/en16931, not transcribed:

TeachingError
{
  "rule": "BR-DEC-17",
  "field": "BT-114",
  "severity": "fatal",
  "message": "The rounding amount (BT-114) is 0.005, which carries 3 decimals; EN 16931 allows at most 2. BT-114 is the small correction added to make the payable amount a convenient figure — a few cents up or down, or the five-cent rounding some cash regimes require — so a rounding amount that is itself unrounded is a contradiction in terms, and one that leaves BT-115 no rounder than it started. The value may be negative; only the precision is constrained.",
  "fix": "Round roundingAmount to 2 decimals. Derive it as the difference between the rounded payable figure and BT-112 minus BT-113, rather than carrying an unrounded remainder into the field.",
  "example": "\"roundingAmount\": -0.03",
  "xpath": "/ubl:Invoice/cac:LegalMonetaryTotal/cbc:PayableRoundingAmount",
  "docsUrl": "https://attestwire.com/rules/BR-DEC-17"
}

xpath locates the element in the generated UBL document, which is where a KoSIT or Peppol validator will report the same problem.

A passing value

the shape this field expects
"roundingAmount": -0.03

The fix

Round roundingAmount to 2 decimals. Derive it as the difference between the rounded payable figure and BT-112 minus BT-113, rather than carrying an unrounded remainder into the field.

All 292 rules →

Nearby: BR-DEC-18 — The allowed maximum number of decimals for the Amount due for payment (BT-115) is 2, but you declared 1785.0011, which has 4; BR-DEC-16 — The paid amount (BT-113) is 10.005, which carries 3 decimals; EN 16931 allows at most 2; BR-DEC-19 — The sum of line net amounts, at two decimals.

Check this rule against your invoice via the hosted API → https://api.attestwire.com/docs

Arrived from a stack trace? The docsUrl on every error links straight here. Something wrong on this page — tell us.