Getting started

XML and business rules
1

Dear members i don’t even know how to start with Zatca integration with my web app kindly give some clarification, like how i can incorporate zatca to generate bills please

2

Dear @omvaishya ,
Thank you for reaching out.
The following links are some documentation that might help you.

3

First you need to Onboard you Device with ZATCA with VAT Number…

Abbreviations used:

  • EGS: E-Invoice Generation Solution
  • ZATCA: General Authority for Zakat, Tax, and Customs Authority​
  • CSID: Cryptographic Stamp Identifier
  • CSR: Certificate signing request
  • TIN: Tax Identification Number
  • ICE: E-Invoice Clearance Engine

Integration procedure:

  • Onboarding EGS in Fatoora Portal
  • Reporting/Clearance with ZATCA through APIs
  • Renewal/Revocation of the Production CSID

EGS Onboarding in simple terms is registering your EGS unit(s) on the Fatoora Portal with the TIN and identifier details about the EGS unit. On successful completion of the onboarding process, you’ll receive a production CSID(Cryptographic Stamp Identifier).

Examples:

  • Taxpayers can onboard a single EGS unit(has invoicing operation in one branch) with the Fatoora Portal with the identifier details of the EGS.
  • Taxpayers(having one TIN) with multiple EGS(having invoicing operations in multiple branches) can onboard multiple EGS units with Fatoora Portal. Here, every EGS unit should be uniquely identifiable with the identifier details the taxpayer provides while onboarding.

Steps for onboarding the EGS unit with the Fatoora Portal:

  • Obtain OTP from the Fatoora Portal
  • Raise CSR request
  • Clear the EGS compliance check by uploading sample invoices/notes
  • Raise production CSID request
    You can log in to the Fatoora Portal using the TIN or your registered email address and navigate to the Onboarding tab.

Now, select the EGS onboarding option.

Enter the number of EGS units you need to onboard.

You’ll now be able to see the OTPs. Copy this OTP for usage in the next step.

Raise CSR(Certificate signing request):

For raising CSR, you need to provide the below details along with the OTP obtained from Fatoora Portal in the previous step.

  • Common Name
  • EGS Serial Number
  • Organization Identifier
  • Organization Unit Name
  • Organization Name
  • Country Name
  • Invoice Type
  • Location
  • Industry

You can provide the above details based on your EGS use case. The organization identifier is your TIN. Now, raise the CSR request and you should receive a compliance CSID.

Clear the EGS compliance check by uploading sample invoices/notes:

After receiving the compliance CSID, you should now clear the EGS compliance check by uploading a sample invoice/related note of the EGS with the compliance CSID.

Raise production CSID request:

With the compliance CSID, now raises a production CSID request to receive production CSID. This CSID will be valid for the next 1 year. You should securely store the production CSID and in case it is compromised/any security breach has occurred, you should not use it anymore for reporting/ clearance. Instead, a new production CSID should be raised and the old production CSID should be revoked. And, you should renew the CSID before it expires.