WARNING
ZATCA-00025 Rate Limit Exceeded
Too many API requests sent to ZATCA in a short period. The system enforces rate limiting to prevent server overload.
⚠️ What Causes This Error?
Common reasons why you might see ZATCA-00025
- ✗ Submitting bulk invoices too quickly without throttling
- ✗ Retry logic sending duplicate requests without backoff delay
- ✗ Multiple EGS units hitting the same ZATCA endpoint simultaneously
- ✗ No request throttling implemented in the integration code
✅ How to Fix This Error
Follow these steps to resolve ZATCA-00025
1
Implement Exponential Backoff
Wait progressively longer between retries: 2 seconds, 4 seconds, 8 seconds, and so on.
2
Batch with Delays
Add a delay between invoice submissions when processing bulk invoices.
3
Check Rate Limit Headers
Monitor X-RateLimit-Remaining response headers to know when you're approaching the limit.
Fix ZATCA Errors Automatically
Qeemah validates invoices before submission and prevents ZATCA-00025 errors from happening.