Attestwire › Rule reference › BR-AF-06

BR-AF-06 A Canary Islands IGIC allowance must state a rate of zero or more

noun · EN 16931 · fatal · BT-96

For a sample invoice, the library reports: The document level allowance at allowances[0] uses VAT category L (Canary Islands general indirect tax (IGIC)), so its VAT rate (BT-96) must be 0 (zero) or greater than zero, but it is missing.

Business term

BT-96

Severity

fatal

The fix

Set allowances[0].vatRate to the IGIC percentage the adjusted supply bears, as a number. Zero is a legal value here — unlike category S — but the term must be present, because a missing rate and a rate of zero are different claims about a tax that is genuinely levied.

A passing value

"vatCategory": "L", "vatRate": 7

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": "BR-AF-06",
  "field": "BT-96",
  "severity": "fatal",
  "message": "The document level allowance at allowances[0] uses VAT category L (Canary Islands general indirect tax (IGIC)), so its VAT rate (BT-96) must be 0 (zero) or greater than zero, but it is missing. IGIC is charged, so the adjustment carries a rate — and unlike category S that rate may be exactly 0, because the Canarian regime relieves a number of supplies by applying a zero rate rather than by exempting them. What it may not be is absent or negative.",
  "fix": "Set allowances[0].vatRate to the IGIC percentage the adjusted supply bears, as a number. Zero is a legal value here — unlike category S — but the term must be present, because a missing rate and a rate of zero are different claims about a tax that is genuinely levied.",
  "example": "\"vatCategory\": \"L\", \"vatRate\": 7",
  "xpath": "/ubl:Invoice/cac:AllowanceCharge[1]/cac:TaxCategory/cbc:Percent",
  "docsUrl": "https://attestwire.com/rules/BR-AF-06"
}

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