How to issue ZATCA e-invoices from your own system through the API

Your own system sends the invoice; Aqid ERP numbers it, signs it, sends it to ZATCA and returns the answer. Start with a test key, which saves nothing.

Steps

  1. Open the Invoicing API

    Choose Sales → Invoicing API: it shows the Base URL, the ZATCA gateway your server issues through, and this month's live and test calls.

  2. Create a test key

    Under API keys choose Test and Allow writes, then Create key. Copy the secret now: it is never shown again.

  3. Send a test invoice

    Send the Example request with an Idempotency-Key; repeating a key returns the first answer. Fix anything the answer lists under zatca.issues.

  4. Go live

    With a ZATCA device onboarded (Onboard in Compliance), create a Live key: its invoices are issued, posted and sent to ZATCA. Add a webhook endpoint to hear the answer.

Was this guide helpful?

More guides

About E-invoicing (ZATCA)Plans and prices in Saudi ArabiaHow to connect your company to ZATCA (Fatoora)How to send an invoice by email or WhatsAppHow to turn a quote into a sales order and an invoiceHow to correct an issued invoice with a credit noteHow to fix an invoice ZATCA rejected and send it againHow to export your e-invoice archive for an auditorHow to keep selling at the till when the internet is downAll guides

Aqid ERP in Saudi Arabia

Set up for Saudi Arabia's rules from the first day.

  • Plans from  79 a month
  • ZATCA Phase 2
  • VAT 15 %
  • GOSI & Mudad WPS
Aqid ERP for Saudi ArabiaPrices in Saudi ArabiaVAT registration in Saudi Arabia: the thresholds, the 30-day deadline and the fineGetting a VAT refund from ZATCA: the credit balance, the request and the bank accountCancelling VAT registration in Saudi Arabia: when you must, when you may, and what follows