AttestwireRule referenceBR-S-07

BR-S-07 A standard-rated charge must have a VAT rate above zero

noun · EN 16931 · fatal · BT-103

For a sample invoice, the library reports: The document level charge at charges[0] uses VAT category S (Standard rated), so its VAT rate (BT-103) must be greater than zero, but it is 0.

Business term
BT-103
Severity
fatal

The fix

Set charges[0].vatRate to the percentage the adjusted supply is taxed at, as a number (19 for the German standard rate, 7 for the reduced rate). If no VAT applies to this charge, change charges[0].vatCategory rather than the rate — Z, E, AE, K, G and O each say something different about why.

A passing value

the shape this field expects
"vatCategory": "S", "vatRate": 19

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": "BR-S-07",
  "field": "BT-103",
  "severity": "fatal",
  "message": "The document level charge at charges[0] uses VAT category S (Standard rated), so its VAT rate (BT-103) must be greater than zero, but it is 0. Category S means VAT is charged, and the rate is what selects which standard-rated breakdown group the adjustment nets into — the standard-rated category is the one category that may appear more than once in BG-23, once per distinct rate. A rate of zero would open a standard-rated group at 0%, which is a contradiction: \"taxed\" and \"at no rate\" cannot both hold.",
  "fix": "Set charges[0].vatRate to the percentage the adjusted supply is taxed at, as a number (19 for the German standard rate, 7 for the reduced rate). If no VAT applies to this charge, change charges[0].vatCategory rather than the rate — Z, E, AE, K, G and O each say something different about why.",
  "example": "\"vatCategory\": \"S\", \"vatRate\": 19",
  "xpath": "/ubl:Invoice/cac:AllowanceCharge[1]/cac:TaxCategory/cbc:Percent",
  "docsUrl": "https://attestwire.com/rules/BR-S-07"
}

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