Rule reference

BR-CO-04 A line has no invoiced item VAT category code (BT-151)

Line 1 has no invoiced item VAT category code (BT-151). Every invoice line must be categorized, without exception — there is no "default" VAT treatment in EN 16931, because the category is what determines whether VAT is charged, who accounts for it, and what evidence the exemption rests on. An uncategorized line also cannot be placed in any VAT breakdown group (BG-23).

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-151
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-CO-04",
  "field": "BT-151",
  "severity": "fatal",
  "message": "Line 1 has no invoiced item VAT category code (BT-151). Every invoice line must be categorized, without exception — there is no \"default\" VAT treatment in EN 16931, because the category is what determines whether VAT is charged, who accounts for it, and what evidence the exemption rests on. An uncategorized line also cannot be placed in any VAT breakdown group (BG-23).",
  "fix": "Set line.vatCategory to one of \"S\" standard rated, \"Z\" zero rated, \"E\" exempt, \"AE\" reverse charge, \"K\" intra-community supply, \"G\" export outside the EU, \"O\" not subject to VAT, \"L\" IGIC (Canary Islands) or \"M\" IPSI (Ceuta and Melilla). If tax is charged, set line.vatRate alongside it.",
  "example": "\"vatCategory\": \"S\", \"vatRate\": 19",
  "xpath": "/ubl:Invoice/cac:InvoiceLine[1]/cac:Item/cac:ClassifiedTaxCategory/cbc:ID",
  "docsUrl": "https://attestwire.com/rules/BR-CO-04"
}

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
"vatCategory": "S", "vatRate": 19

The fix

Set line.vatCategory to one of "S" standard rated, "Z" zero rated, "E" exempt, "AE" reverse charge, "K" intra-community supply, "G" export outside the EU, "O" not subject to VAT, "L" IGIC (Canary Islands) or "M" IPSI (Ceuta and Melilla). If tax is charged, set line.vatRate alongside it.

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