Dear Community Members,
Further to the previous announcements, please note that the front-end duplication check has been deployed to the Production Environment with response code 208 for duplicates on Clearance API for B2B invoices and response code 409 for duplicates on Reporting API for B2C invoices. Taxpayers should expect API responses indicating duplicated hash submissions.
Below are the key details:
1.Objective :
To enhance overall system performance and efficiency by identifying duplicate invoices submitted via Clearance APIs and Reporting APIs by comparing the hash values of invoices submitted within a 24-hour period.
2.Functionality Overview:
Clearance API :
Scenario : When taxpayers submit B2B invoices using the Clearance API, the hash of the invoice will be stored in a dedicated database for 24 hours to identify duplicates.
Validation : Subsequent submissions of invoices with the same hash value within 24 hours will trigger the response code “208 - Invoice Hash Previously Submitted.”
Response : The response will include the Cleared Invoice along with ZATCA’s signature and QR code.
Investigation : Repeated instances of sending duplicate invoices will be flagged for investigation.
Reporting API :
Scenario : When taxpayers submit B2C invoices via the Reporting API, the hash of the invoice will be stored in a dedicated database for 24 hours to identify duplicates.
Validation : Subsequent submissions of invoices with the same hash value within 24 hours will trigger a rejection.
Response: code “409 - Invoice was already reported successfully earlier.”
Successful Reporting : When taxpayers receive a 409 response, it implies that the B2C invoice with the same hash value was successfully reported in the first instance and saved at ZATCA’s end.
Investigation: Repeated instances of sending duplicate invoices will be flagged for investigation.
3.Impacted Components:
Reporting API on Production Environment
Clearance API on Production Environment
4.Deployment Status :
Production Environment: Deployed on 6th of August 2025 at 9:00 P.M
For questions or clarifications, please contact sp_support@zatca.gov.sa
Best regards,
Fatoora Development Team