ERROR
ZATCA-00029 Duplicate Invoice UUID
An invoice with the same UUID has already been submitted to ZATCA.
⚠️ What Causes This Error?
Common reasons why you might see ZATCA-00029
- ✗ Resubmitting a previously cleared or reported invoice
- ✗ UUID generation algorithm not producing truly random values
- ✗ System retry logic submitting the same invoice twice
- ✗ Copy-paste error reusing a UUID from testing
✅ How to Fix This Error
Follow these steps to resolve ZATCA-00029
1
Generate New UUID v4
Generate a new UUID version 4 (random) for every invoice — never reuse UUIDs.
2
Implement Idempotency Checks
Check if a UUID has already been submitted before sending to ZATCA.
3
Maintain Submission Log
Keep a local log of all submitted UUIDs to prevent accidental duplicates.
4
New UUID for Resubmissions
If resubmitting a rejected invoice after fixes, always generate a new UUID.
Fix ZATCA Errors Automatically
Qeemah validates invoices before submission and prevents ZATCA-00029 errors from happening.