ERROR
ZATCA-00028 XML Schema Validation Error
The invoice XML does not conform to ZATCA's UBL 2.1 schema definition.
⚠️ What Causes This Error?
Common reasons why you might see ZATCA-00028
- ✗ Missing required XML elements in the invoice structure
- ✗ Incorrect element namespace or namespace URI
- ✗ Wrong data type used (e.g., string instead of decimal for amounts)
- ✗ Invalid XML structure or incorrect element nesting
✅ How to Fix This Error
Follow these steps to resolve ZATCA-00028
1
Validate Against XSD
Validate your XML against ZATCA's official XSD schema before submission.
2
Check Required Elements
Ensure all mandatory UBL 2.1 elements are present in the invoice.
3
Verify Namespaces
Use correct namespace URIs: urn:oasis:names:specification:ubl:schema:xsd:Invoice-2.
4
Use ZATCA Validator
Run the invoice through a ZATCA SDK or validator tool to catch schema errors.
Fix ZATCA Errors Automatically
Qeemah validates invoices before submission and prevents ZATCA-00028 errors from happening.