ERROR
ZATCA-00023 Invalid Invoice Type Code
The invoice type code does not match ZATCA's accepted values (388 for standard, 381 for credit, 383 for debit).
⚠️ What Causes This Error?
Common reasons why you might see ZATCA-00023
- ✗ Using an incorrect UNCL1001 type code number
- ✗ Confusing the type code with the invoice sub-type code
- ✗ Type code does not match the actual invoice content
- ✗ Missing InvoiceTypeCode element entirely from the XML
✅ How to Fix This Error
Follow these steps to resolve ZATCA-00023
1
Use Correct Type Codes
Use UNCL1001 codes: 388 for tax invoice, 381 for credit note, 383 for debit note.
2
Set Invoice Sub-Type
Set the name attribute: 0100000 for standard tax invoices, 0200000 for simplified tax invoices.
3
Match Type to Transaction
Ensure the type code matches the actual transaction — don't use credit note code for a regular sale.
Fix ZATCA Errors Automatically
Qeemah validates invoices before submission and prevents ZATCA-00023 errors from happening.