Skip to content
Omar Bahareth edited this page Jun 7, 2023 · 19 revisions

Welcome to the zatca wiki!

These docs are a work in progress and are based on an unmerged pull request (pending to verify some things from ZATCA's side)

Getting Started

  1. Generate a Private Key
  2. Generate a CSR (this gives you credentials from ZATCA)
  3. Generate a Certificate (You need the certificate in all invoices and API requests)
  4. Construct an Invoice
  5. Check the Compliance of an Invoice
  6. Report the Invoice to ZATCA
  7. Clear the Invoice (the documentation implies this step is optional if you reported a cleared invoice above)
  8. Render the QR Code(to show it in your app/website)

Other Actions

  1. TODO: Renew the Certificate

Invoice Codes

Invoices have quite a few codes, some that behave like masks.

  1. Invoice type codes
  2. TODO: Invoice Type Code Masks (Name Attribute)
  3. TODO: Payment Means