Line amount with VAT (KSA-12) missing

What does this mean?

The place is cac:InvoiceLine/cac:TaxTotal/cbc:RoundingAmount, beside cbc:TaxAmount in the same block. The family is the same one BR-KSA-52 names: the tax invoice and its credit and debit notes, KSA-2 carrying 01 in positions 1 and 2.

The element name misleads, and it is worth saying plainly: RoundingAmount in UBL is a rounding field, and the Saudi specification reuses it as the home of KSA-12 — the line total including VAT. Read the name at face value and you either write a rounding difference into it or leave it out because there is no rounding on your invoice, and both give you this rejection.

Its value is set by BR-KSA-51: the invoice line net amount (BT-131) plus the line VAT amount (KSA-11). It is not the quantity times a VAT-inclusive unit price — once a line carries a discount of its own, or the price was entered inclusive of VAT, those two calculations part by halalas.

One case turns the requirement into a zero: BR-KSA-82 requires KSA-12 — together with KSA-11, the line net and the item price — to be zero on a prepayment line. Zero there is a value to write, not a field to drop.

Why does it happen?

Ordered from the most common to the least — your cause is most likely the first or the second.

• Reading RoundingAmount at face value: left out because the document has no rounding, or filled with the halala difference instead of the line total.
• The same European template that drops BR-KSA-52: an EN 16931 line carries no tax block at all, so both fields go missing together.
• Computing it as the quantity times a VAT-inclusive price rather than the line net plus its VAT — which passes on a plain invoice and drifts by a halala the moment a line discount exists.
• Dropping it from a zero-rated or exempt line on the reasoning that it equals the net and adds nothing.
• Emitting it with more than two decimals, which is a separate warning — BR-KSA-DEC-04, not this code — but arrives in the same list and confuses the reading.

How to fix it

3 steps, then send the invoice again.

1. 1
   Emit it beside the VAT amount

   In the cac:TaxTotal block inside the line: cbc:TaxAmount, then cbc:RoundingAmount, both with the attribute currencyID="SAR". Two elements in one block, not one.

2. 2
   Make it the line net plus its VAT, literally

   Take the two numbers you already wrote on that line — cbc:LineExtensionAmount and cbc:TaxAmount — and add them, to two decimals. Do not re-derive it from the unit price or from the document total: a derived figure lands a halala away from the sum, and the schema adds rather than derives.

3. 3
   Then check both fields on every line before sending

   Walk the lines and confirm both numbers are there, because a file that dropped one usually dropped the other — BR-KSA-52 is the matching code. And if the document is a credit or debit note the requirement stands on it exactly as on an invoice; notes are covered in credit and debit notes.

Once corrected, send the invoice again. A rejected invoice was never recorded with the Authority, so it needs no credit note — send the corrected invoice itself.

Frequently asked questions