# 409 status code - Duplicate-Invoice error

**URL:** <https://zatca1.discourse.group/t/409-status-code-duplicate-invoice-error/3932>\
**Category:** Clearance and Reporting\
**Created:** [October 30, 2024, 11:11pm UTC](https://zatca1.discourse.group/t/409-status-code-duplicate-invoice-error/3932 "2024-10-30T23:11:55Z")\
**Posts on this page:** 20\
**Page:** 5

<div class="post-metadata">

**Author:** ![BEX](https://avatars.discourse-cdn.com/v4/letter/b/4bbf92/32.png) [@BEX](https://zatca1.discourse.group/u/BEX)\
**Post date:** [November 4, 2024, 11:13am UTC](https://zatca1.discourse.group/t/409-status-code-duplicate-invoice-error/3932/82 "2024-11-04T11:13:23Z")

</div>

@psinclair Great, thank you, if the check API returns the signed B2B invoice that would solve everything.

---

<div class="post-metadata">

**Author:** ![Malik](https://dub1.discourse-cdn.com/flex013/user_avatar/zatca1.discourse.group/malik/32/708_2.png) [@Malik](https://zatca1.discourse.group/u/Malik)\
**Post date:** [November 4, 2024, 11:27am UTC](https://zatca1.discourse.group/t/409-status-code-duplicate-invoice-error/3932/83 "2024-11-04T11:27:58Z")

</div>

Hi,  
In addition to API if portal status page can show reported invoice still one can check but at the moment user end is blind. thanks

---

<div class="post-metadata">

**Author:** ![mohdzeeshan5c0](https://avatars.discourse-cdn.com/v4/letter/m/f05b48/32.png) [@mohdzeeshan5c0](https://zatca1.discourse.group/u/mohdzeeshan5c0)\
**Post date:** [November 4, 2024, 11:32am UTC](https://zatca1.discourse.group/t/409-status-code-duplicate-invoice-error/3932/84 "2024-11-04T11:32:40Z")

</div>

@psinclair  
API to check if hash exists would be helpful but it would much transparent if you can return the QR Code as well in the response of this API since people here are doubtful that they are submitting the invoice first time and getting 409 conflict response.  
So in this API if you could return the QR Code as well, would clear the doubt since QR code can be decoded and its data can be matched with internal system data.

Thanks,

---

<div class="post-metadata">

**Author:** ![y.khraishi](https://avatars.discourse-cdn.com/v4/letter/y/eada6e/32.png) [@y.khraishi](https://zatca1.discourse.group/u/y.khraishi)\
**Post date:** [November 4, 2024, 12:55pm UTC](https://zatca1.discourse.group/t/409-status-code-duplicate-invoice-error/3932/85 "2024-11-04T12:55:57Z")

</div>

@idaoud @psinclair Thanks you for considering my suggestions, but still this won’t resolve the issue, i.e. we need the cleared invoice in case we weren’t able to get it the first time due to whatever reason.

---

<div class="post-metadata">

**Author:** ![abin](https://avatars.discourse-cdn.com/v4/letter/a/3d9bf3/32.png) [@abin](https://zatca1.discourse.group/u/abin)\
**Post date:** [November 5, 2024, 5:10am UTC](https://zatca1.discourse.group/t/409-status-code-duplicate-invoice-error/3932/86 "2024-11-05T05:10:11Z")

</div>

It’s better to add invoice status/cleared invoice along with 409 response of B2C and B2B invoices. So, we can easily identify the status of invoice.  
Also consider the @Malik suggestion. It’s good for taxpayers.

---

<div class="post-metadata">

**Author:** ![Malik](https://dub1.discourse-cdn.com/flex013/user_avatar/zatca1.discourse.group/malik/32/708_2.png) [@Malik](https://zatca1.discourse.group/u/Malik)\
**Post date:** [November 5, 2024, 5:36am UTC](https://zatca1.discourse.group/t/409-status-code-duplicate-invoice-error/3932/87 "2024-11-05T05:36:48Z")

</div>

Hi, Very right there should be API not only to check status but also if signed xml need to download just a GET call b passing a parameter. Technology is very good if all working fine but sometimes an unknown thing can hit you badly and tax matters are legal matters.  
I am sure ZATCA team might say every system need to follow instructions and keep a copy and archive sure that is happening but still technical glitches can happen any time and there should be an option. For example Portal status page always having issues till date ZATCA unable to sort it out and always reply if you contact that you just keep API responses. Please consider requests from user side and try to provide enhancements. thanks

---

<div class="post-metadata">

**Author:** ![Malik](https://dub1.discourse-cdn.com/flex013/user_avatar/zatca1.discourse.group/malik/32/708_2.png) [@Malik](https://zatca1.discourse.group/u/Malik)\
**Post date:** [November 11, 2024, 8:39am UTC](https://zatca1.discourse.group/t/409-status-code-duplicate-invoice-error/3932/88 "2024-11-11T08:39:53Z")

</div>

Hi Philip,  
Any update on this matter hope not again will stop with errors. thanks

---

<div class="post-metadata">

**Author:** ![Adithya\_Raviraja](https://avatars.discourse-cdn.com/v4/letter/a/91b2a8/32.png) [@Adithya\_Raviraja](https://zatca1.discourse.group/u/Adithya_Raviraja)\
**Post date:** [November 19, 2024, 8:39am UTC](https://zatca1.discourse.group/t/409-status-code-duplicate-invoice-error/3932/89 "2024-11-19T08:39:00Z")

</div>

Hi @psinclair ,

When would we be planning to have the developer session walkthroughs? Just wanted to know so that we can be proactive and avoid unnecessary hiccups.

---

<div class="post-metadata">

**Author:** ![Ankit.K.Tiwari](https://avatars.discourse-cdn.com/v4/letter/a/9d8465/32.png) [@Ankit.K.Tiwari](https://zatca1.discourse.group/u/Ankit.K.Tiwari)\
**Post date:** [November 21, 2024, 10:09am UTC](https://zatca1.discourse.group/t/409-status-code-duplicate-invoice-error/3932/90 "2024-11-21T10:09:00Z")

</div>

Dear All,  
ZATCA is arranging a 1 hour session - on 26 Nov, 2024 from 10am to 11am KSA time - to discuss specific scenarios regarding 409 errors (duplicate invoices validation). Kindly prepare your questions in advance and share with sp\_support@zatca.gov.sa with subject “409 Errors” latest by 25 Nov, 2024 evening.

Meeting schedule:  
**26 Nov, 2024 Tuesday from 10am to 11am KSA Time.**

Below is the meeting link for  
[Meeting Link](https://teams.microsoft.com/l/meetup-join/19%3ameeting_NWM1OTBiNjAtZGI3Ni00MTNkLWFkNjctOWQzODYyMzUxOWIx%40thread.v2/0?context=%7b%22Tid%22%3a%2263996317-3453-4be2-b104-0eee31c91811%22%2c%22Oid%22%3a%224c60589d-08cd-4ee3-94a7-86f5110b0dd8%22%7d)  
Meeting ID: 347 282 177 290  
Passcode: Nn9Xv22p

---

<div class="post-metadata">

**Author:** ![Ankit.K.Tiwari](https://avatars.discourse-cdn.com/v4/letter/a/9d8465/32.png) [@Ankit.K.Tiwari](https://zatca1.discourse.group/u/Ankit.K.Tiwari)\
**Post date:** [November 21, 2024, 10:52am UTC](https://zatca1.discourse.group/t/409-status-code-duplicate-invoice-error/3932/91 "2024-11-21T10:52:22Z")

</div>

@eCloud@Adithya_Raviraja@mkw@Malik @sameer @Maala @pmohdameen @mohdzeeshan5c0 @Hadi @rudyzidan @Arratech @BEX @plasker @y.khraishi @abin @m.alnoursi @sameer @mohammad.mt

Request all to please block the calendar with above invite.

@idaoud @psinclair

---

<div class="post-metadata">

**Author:** ![Malik](https://dub1.discourse-cdn.com/flex013/user_avatar/zatca1.discourse.group/malik/32/708_2.png) [@Malik](https://zatca1.discourse.group/u/Malik)\
**Post date:** [November 26, 2024, 10:15am UTC](https://zatca1.discourse.group/t/409-status-code-duplicate-invoice-error/3932/93 "2024-11-26T10:15:23Z")

</div>

**Dear Philip and Ankit,**

It was a pleasure to attend the recent online session discussing the challenges related to 409 errors and other issues encountered by both service providers and taxpayers. Below are the key points noted during the meeting:

1. **API for Hash Verification**  
ZATCA will release an API enabling users to verify whether a hash is already present in their database, cleared, or reported.
2. **Timeline for 409 Check Implementation**  
The 409 error check is scheduled for implementation by the end of December 2024. However, the aforementioned API will be released before this date.
3. **Notification of Implementation Changes**  
Any changes requiring implementation by stakeholders will be communicated by the ZATCA team at least one week prior to deployment.
4. **Portal Statistics and Scalability**  
Due to the large volume of transactions, portal statistics will be addressed in the first or second quarter of the upcoming year.
5. **Support Contact**  
For any required support, users are advised to generate a ticket by contacting **sp\_support@zatca.gov.sa**.
6. **Workaround of 409 for B2B**

- In case where users could not receive or could not store the cleared signed XML of B2B invoices and not able to share this invoice with customer then current workaround is to generate a credit note against this invoice and create a new invoice, get it cleared by zatca and share it with customer.

1. **Request for Signed XML API**  
An API for retrieving signed XML as a response was discussed. While this involves significant effort, ZATCA has assured that it will be provided, likely in the first or second quarter of the upcoming year.
2. **Handling Missing Signed XML**  
If, for any reason, the signed XML is not received, it is advisable to:

- Retain the error details as a log for reference.
- Share the XML with the client as proof of submission.
- However, the preferred approach is to adjust the existing entry and submit a new one where possible.

1. **B2C 24-Hour Time Limit Concern**  
A concern was raised regarding the 24-hour time limit for B2C transactions. Specifically, if a transaction is pushed to ZATCA and an error occurs due to data issues that take longer than 24 hours to resolve: ZATCA clarified that the initial push must be completed within 24 hours.  
Retain the submission proof and present it as evidence in case of subsequent inquiries or audits.

ZATCA emphasized its commitment to resolving technical challenges and improving the overall tax system in KSA.

Please feel free to add if any missed and were discussed.  
@Ankit.K.Tiwari @psinclair

---

<div class="post-metadata">

**Author:** ![mohdzeeshan5c0](https://avatars.discourse-cdn.com/v4/letter/m/f05b48/32.png) [@mohdzeeshan5c0](https://zatca1.discourse.group/u/mohdzeeshan5c0)\
**Post date:** [November 26, 2024, 10:37am UTC](https://zatca1.discourse.group/t/409-status-code-duplicate-invoice-error/3932/94 "2024-11-26T10:37:21Z")

</div>

@Malik  
Very good documentation of concluded points in today’s session.  
Appreciated.

Point no. 6 might need a slight modification as below:-

- In case where users could not receive or could not store the cleared signed XML of B2B invoices and not able to share this invoice with customer then current workaround is to generate a credit note against this invoice and create a new invoice, get it cleared by zatca and share it with customer.

---

<div class="post-metadata">

**Author:** ![Malik](https://dub1.discourse-cdn.com/flex013/user_avatar/zatca1.discourse.group/malik/32/708_2.png) [@Malik](https://zatca1.discourse.group/u/Malik)\
**Post date:** [November 26, 2024, 11:06am UTC](https://zatca1.discourse.group/t/409-status-code-duplicate-invoice-error/3932/95 "2024-11-26T11:06:58Z")

</div>

thanks and updated. Jazakallah khair

---

<div class="post-metadata">

**Author:** ![kogabr](https://avatars.discourse-cdn.com/v4/letter/k/958977/32.png) [@kogabr](https://zatca1.discourse.group/u/kogabr)\
**Post date:** [November 28, 2024, 4:53pm UTC](https://zatca1.discourse.group/t/409-status-code-duplicate-invoice-error/3932/96 "2024-11-28T16:53:19Z")

</div>

Hi everyone! Our team is also facing the issues mentioned on this thread. @psinclair @Ankit.K.Tiwari do you have an ETA for this new endpoint for hash verification?

---

<div class="post-metadata">

**Author:** ![Malik](https://dub1.discourse-cdn.com/flex013/user_avatar/zatca1.discourse.group/malik/32/708_2.png) [@Malik](https://zatca1.discourse.group/u/Malik)\
**Post date:** [December 15, 2024, 9:58am UTC](https://zatca1.discourse.group/t/409-status-code-duplicate-invoice-error/3932/97 "2024-12-15T09:58:56Z")

</div>

Dear all, any update or progress in this regard. Thanks

---

<div class="post-metadata">

**Author:** ![anusv](https://avatars.discourse-cdn.com/v4/letter/a/dc4da7/32.png) [@anusv](https://zatca1.discourse.group/u/anusv)\
**Post date:** [December 17, 2024, 12:03pm UTC](https://zatca1.discourse.group/t/409-status-code-duplicate-invoice-error/3932/98 "2024-12-17T12:03:12Z")

</div>

Dear @Aturkistani  
Saw the announcement about [Invoice Frontend Validation] . Its clearly explained about 409 and 208 status codes but nothing is specified about the API to check whether the invoice hash is already submitted or not , so that your concern regarding excessive usage of reporting and clearance API can be minimized. Please comment on this.

---

<div class="post-metadata">

**Author:** ![mohdzeeshan5c0](https://avatars.discourse-cdn.com/v4/letter/m/f05b48/32.png) [@mohdzeeshan5c0](https://zatca1.discourse.group/u/mohdzeeshan5c0)\
**Post date:** [December 17, 2024, 12:15pm UTC](https://zatca1.discourse.group/t/409-status-code-duplicate-invoice-error/3932/99 "2024-12-17T12:15:08Z")

</div>

Saw the announcement about [**Release of 409 and 208 Enhancement**].  
It would be appreciated if we could also have the clarification from zatca regarding the invoices which were being submitted first time but received 409 response.

Thanks,

---

<div class="post-metadata">

**Author:** ![Aturkistani](https://avatars.discourse-cdn.com/v4/letter/a/8baadc/32.png) [@Aturkistani](https://zatca1.discourse.group/u/Aturkistani)\
**Post date:** [December 22, 2024, 7:52am UTC](https://zatca1.discourse.group/t/409-status-code-duplicate-invoice-error/3932/101 "2024-12-22T07:52:15Z")

</div>

Dear @mohdzeeshan5c0,

Thank you for reaching out.

This is not possible, as 409,208 responses are being returned only if the InvoiceHash of the invoice has been submitted already before, and having a duplicated hash for different e-invoices is also not possible due to the presence of “UUID” and other unique identifiers fields.

That means no different 2 invoices can have the same invoiceHash.

---

<div class="post-metadata">

**Author:** ![anusv](https://avatars.discourse-cdn.com/v4/letter/a/dc4da7/32.png) [@anusv](https://zatca1.discourse.group/u/anusv)\
**Post date:** [December 30, 2024, 6:44am UTC](https://zatca1.discourse.group/t/409-status-code-duplicate-invoice-error/3932/102 "2024-12-30T06:44:58Z")

</div>

Dear @Aturkistani ,  
Please comment on this .

---

<div class="post-metadata">

**Author:** ![mkw](https://avatars.discourse-cdn.com/v4/letter/m/e79b87/32.png) [@mkw](https://zatca1.discourse.group/u/mkw)\
**Post date:** [December 30, 2024, 2:05pm UTC](https://zatca1.discourse.group/t/409-status-code-duplicate-invoice-error/3932/103 "2024-12-30T14:05:10Z")

</div>

Referring to the announcement available [here](https://zatca1.discourse.group/t/invoice-frontend-validation-announcement/4611). **Is there any information on when this change will be introduced in the simulation environment?** As I understand, the production release date is not yet confirmed.

Currently, we were unable to receive the 208 status code for clearance invoices, on simulation environment which prevents us from testing the changes in our solution. Additionally, the sandbox documentation ([Zatca](https://sandbox.zatca.gov.sa/IntegrationSandbox)) lacks an example of such a response.

[Previous page](https://zatca1.discourse.group/t/409-status-code-duplicate-invoice-error/3932.md?page=4)

[Next page](https://zatca1.discourse.group/t/409-status-code-duplicate-invoice-error/3932.md?page=6)
