ZATCA Device Onboarding: Compliance Invoice Submission Clarification

Onboarding, renewal and revocation
1

I have a few questions regarding the ZATCA device onboarding process and compliance invoice submission to the API:

1. Can we submit a common dummy XML for compliance?

  • We have multiple ERP systems with small variations in invoice structure (e.g., row-wise allowances, document-level charges, tax-exempt products, etc.).
  • When submitting XML to the compliance API (https://gw-fatoora.zatca.gov.sa/e-invoicing/simulation/compliance/invoices) for PCSID, do we need to submit the exact same XML format used in the ERP?
  • Or can we use a generic dummy invoice XML that meets ZATCA’s format requirements?
  • Can we use the sample invoices from ZATCA’s SDK for compliance submission, or do we need to modify them based on each ERP system?

2. First Invoice’s PIH Usage

  • After receiving PCSID, the first legal invoice generated in the ERP needs to be signed using it.
  • The PIH of the first invoice (e.g., NWZlY2ViNjZmZmM4NmYzOGQ5NTI3ODZjNmQ2OTZjNzljMmRiYzIzOWRkNGU5MWI0NjcyOWQ3M2EyN2ZiNTdlOQ==)—
    • Should this PIH be included in the first dummy invoice submitted to the compliance API (https://gw-fatoora.zatca.gov.sa/e-invoicing/simulation/compliance/invoices)?
    • Or is it only required when generating the first legal invoice in the ERP using the PCSID?

I’d appreciate any insights from those who have completed the ZATCA onboarding process. Thanks!

2

Dear @arjun_tech24

Thanks for reaching out,

Please find the below clarifications based on your concerns:

  1. Regarding the compliance check API, during the onboarding process you need to send samples to ensure compliance for your VAT, It’s only for security checks you can send the samples in the SDK with replacing the companyID tag value in the XML with your VAT number. Additionally, it is a mandetory step which means you will not grant the PCSID unless you finished all the security checks.
  2. Regarding the PIH: You will use the PIH of zero that shared on ZATCA docs, when sending your first actual invoice after receiving the PCSID, and the PIH for the second actual invoice will be the Hash for the last submitted invoice.

I hope it’s clear enough now, For any further assistant please do not hesitate to reach out.

Thanks,
Ibrahem Daoud.

1 Like
3

@idaoud
Thank you so much for your detailed response.

1 Like