Skip to content
BT-117

VAT category tax amount

The category's VAT: its taxable amount times its rate, rounded to two decimals.

BR-CO-17 defines it: category taxable amount × rate ÷ 100, rounded to two decimals. For zero-rated, exempt and out-of-scope categories it must be zero (BR-Z-09, BR-E-09, BR-O-09).

These amounts add up to the invoice VAT total (BR-CO-14). Because rounding happens per category, the result can differ by a halala from adding individually rounded line VAT amounts.

IdentifierBT-117
Path in the document/Invoice/cac:TaxTotal/cac:TaxSubtotal/cbc:TaxAmount
Cardinality1..1
Data typeAmount
Applies toStandard tax invoice and Simplified tax invoice
GroupBG-23 VAT breakdown

In JooDax

Partly built

The programs write the sum of the lines' VAT in the category rather than recomputing taxable amount × rate as BR-CO-17 describes; a one-halala difference can appear when line rounding differs.

crates/jdx-einvoice-sa/src/xml.rs

Applies to

Tax invoiceDebit noteCredit noteSimplifiedSimplified debitSimplified credit
MandatoryMandatoryMandatoryMandatoryMandatoryMandatory

Rules that check it

  • BR-CO-17 · Category tax = category taxable amount × rate ÷ 100, rounded to two decimals.
  • BR-S-09 · For category S, tax = taxable amount × rate ÷ 100, rounded.
  • BR-Z-09 · The tax amount of a Z breakdown shall be 0.
  • BR-E-09 · The tax amount of an E breakdown shall be 0.
  • BR-O-09 · The tax amount of an O breakdown shall be 0.
  • BR-CO-14 · Invoice total VAT = Σ category tax amounts.
  • BR-CO-18 · An invoice shall have at least one VAT breakdown group.

Related fields

Fields — E-invoicing in Saudi Arabia (FATOORA)

Sources

  1. Electronic Invoice XML Implementation Standard to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
  2. Electronic Invoice Data Dictionary to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA

Checked on: 4 November 2026. What concerns JooDax is taken from the programs’ own code.