Technical Issue – Credit Note Submitted via Incorrect Endpoint

I would like to report a technical issue related to the submission of a Credit Note for an old invoice from 2022.

Due to a technical error in our system, the Credit Note XML was submitted using the reporting endpoint instead of the clearance endpoint. As a result.

Could you please confirm if any corrective action is required from our side to resolve this issue?

We would appreciate your guidance on the appropriate steps to ensure the Credit Note is properly aligned with ZATCA’s records.

1 Like

You have to reverse transaction by passing debit note using the report endpoint, then send correct credit note using the clearance endpoint.

2 Likes

Thanks for the clarification earlier.

@mnuaimi

Just one more question — when I create the Debit Note to reverse the incorrect Credit Note:

  • Should the InvoiceDocumentReference point to the original invoice or the wrong Credit Note?

  • And should the Debit Note be B2B or B2C?

Appreciate your help!

1 Like

Hi @alialjabal,
For reversing credit or debit notes, you can resend the same document you want to reverse, but make sure to change the following fields:

  • InvoiceTypeCode
  • UUID
  • ICV
  • PIH
  • IRN

If the original invoice was B2B, then all related notes must also be B2B.
If the original invoice was B2C, then all related notes must also be B2C.

Thanks a lot, @mnuaimi — appreciate your help.

I understand the general process of reversing a Credit Note by resending it with the updated fields.
However, in my case there was a technical error in our system, and the Credit Note was accidentally submitted to the reporting endpoint, so it ended up being treated as B2C, while the original invoice is B2B.

Now I want to cancel this wrong Credit Note.

So just to confirm:
Should the Debit Note I send to reverse this wrong Credit Note also be submitted as B2C (to match the incorrect Credit Note)?

Hi @alialjabal

In this case, you have two options:

  1. If the buyer has already accepted the Credit Note that was submitted as a simplified invoice (B2C), then there is no issue and you are not required to take any further action.

  2. If the buyer requires a standard Credit Note, then you must first reverse the incorrect one by issuing a simplified Debit Note, and afterwards submit a standard Credit Note.

If you choose the second option and all your accounting and inventory records in your system are already correct—and you do not want to affect them—you may issue these corrective notes through an external intermediary tool that does not impact your accounting entries. You can later explain this approach when submitting your tax return if ZATCA requests clarification.

1 Like