tick.
Launch App

Home/ZATCA e-invoicing integration

ZATCA e-invoicing integration

Native Saudi Arabia VAT e-invoicing — device onboarding, UBL generation, and clearance queue for Phase 2 workflows.

Last updated: June 2026

Regulatory context

The Zakat, Tax and Customs Authority (ZATCA) mandates electronic invoicing for VAT-registered businesses in Saudi Arabia. Phase 2 (integration phase) requires compliant e-invoices with specific data fields, cryptographic stamping, and reporting through approved Fatoorah solutions.

Official guidance: ZATCA E-Invoicing portal.

What tick. provides (native integration)

  • EGS device onboarding — register sandbox/production e-invoicing devices, generate secp256k1 keys and CSR, and complete OTP-based Fatoorah compliance CSID onboarding (Settings → ZATCA for SA entities).
  • UBL invoice generation — structured AR invoices with seller/buyer VAT TINs, line items, and tax categories are converted to UBL 2.1 XML when an invoice is sent.
  • B2B vs B2C routing — invoices to VAT-registered buyers are queued for clearance; simplified B2C invoices are queued for reporting per ZATCA rules.
  • Clearance monitor — track queue status (pending, cleared, reported, failed) from the Payments hub for KSA entities.
  • Credential vault — private keys and compliance certificates are stored in Supabase Vault; never exposed to the browser.
  • Audit trails for invoice issuance and evidence attachment via Capture.

Availability

ZATCA features are enabled when your entity country is set to Saudi Arabia (SA) during onboarding. Sandbox onboarding is available immediately; production clearance requires ZATCA-approved production CSIDs and environment configuration (ZATCA_API_BASE_PRODUCTION).

What you remain responsible for

  • Maintaining a valid VAT registration and accurate seller VAT TIN on invoices.
  • Validating invoice XML/UBL formats against current ZATCA schemas before go-live.
  • Filing VAT returns with your tax advisor based on tick. trial balance and tax reports.

References