ERROR
ZATCA-00031 Invalid Tax Subtotal Calculation
The tax subtotal amounts do not match the sum of line-level tax calculations, or the tax rate is incorrect.
⚠️ What Causes This Error?
Common reasons why you might see ZATCA-00031
- ✗ Rounding errors in tax calculation across multiple line items
- ✗ Tax category mismatch between line-level and document-level tax summary
- ✗ Incorrect VAT rate used (not using 15% for standard-rated items)
- ✗ Tax-exclusive and tax-inclusive amount confusion in calculations
✅ How to Fix This Error
Follow these steps to resolve ZATCA-00031
1
Sum Line-Level Taxes
Ensure line-level tax amounts sum exactly to the document tax subtotal.
2
Use Proper Rounding
Use 2-decimal precision with HALF_UP rounding for all tax calculations.
3
Verify VAT Rate
Confirm VAT rate is 15% (0.15) for standard-rated items in Saudi Arabia.
4
Check Tax-Inclusive Logic
Double-check whether prices are tax-inclusive or tax-exclusive and calculate accordingly.
Fix ZATCA Errors Automatically
Qeemah validates invoices before submission and prevents ZATCA-00031 errors from happening.