Skip to content
Omar Bahareth edited this page Dec 6, 2023 · 19 revisions

Welcome to the zatca wiki!

These docs are mostly complete, they cover the most basic cases of invoices. The goal of this SDK is to help you build e-invoices but you need to understand the underlying XML elements and how to tweak them according to your business needs.

Getting Started

  1. Generate a Private Key
  2. Generate a CSR and Compliance Certificate (this gives you credentials from ZATCA to run compliance checks)
  3. Generate a Certificate (You need the certificate to report invoices)
  4. Construct an Invoice
  5. Check the Compliance of an Invoice
  6. Report Simplified Invoice to ZATCA
  7. Clear Standard Invoice (This is signing from ZATCA's side and reporting, only for Standard invoices)
  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. Invoice Subtypes (Name Attribute)
  3. Payment Means