Skip to content
/awraq · v1 ZATCA Phase 2 · cleared in real time

Issue.

a cleared, signed, ZATCA-grade tax invoice in one POST.

Awraq is the Saudi cloud e-invoicing API. Multi-branch, multi-user, REST + webhooks, UBL 2.1 and cryptographic stamps. Run your billing from your stack and let Awraq handle the regulator.

curl · live · 2026-09-09
$ curl -X POST https://api.awraq.cm.sa/v1/invoices \
  -H "Authorization: Bearer awraq_live_…" \
  -H "Idempotency-Key: 8af3-…" \
  -d '{
    "branch": "riyadh-01",
    "buyer":  "3001234567",
    "items":  [{ "sku":"A-1", "qty":2, "price":575.00 }],
    "vat_rate": 0.15
  }

→ HTTP/2 201
"uuid":    "a3f9-7c1d-…"
"cleared": "2026-04-27T11:42:18+03"
"qr":      "data:image/png;base64,iVBORw0…"
"stamp":   "ecdsa-secp256r1:MEUC…"
120k cleared / month
99.9% rolling 30-day uptime
~0.8s median clearance latency
SA-region data residency

02 · capabilities

A datasheet, not a feature list.

What ships in the box. No marketing-shaped synonyms, these are the surfaces your team will read in the docs.

// Compliance

  • ZATCA Phase 2 clearance
  • UBL 2.1 / XML envelopes
  • ECDSA cryptographic stamps

// Surface

  • REST + JSON · idempotent
  • Webhooks with HMAC SHA-256
  • PHP · Node · Python SDKs

// Operations

  • Multi-branch sequences
  • Scoped users & API keys
  • Append-only audit log

// Locality

  • Saudi-region hosting
  • Arabic + English templates
  • PDPL aligned · SOC 2 in flight

03 · surface

A small, sharp API.

Six endpoints carry most of the workload. Idempotent writes, signed webhooks, JSON in and out, paginated reads.

POST /v1/invoices Issue a tax invoice
GET /v1/invoices/:uuid Retrieve clearance status
POST /v1/invoices/:uuid/credit Issue a credit note
POST /v1/branches Register a branch + CSID
GET /v1/reports/vat VAT return for a period
POST /v1/webhooks Subscribe to events
auth: Bearer replay-safe: Idempotency-Key format: application/json docs.awraq.cm.sa →

TAX INVOICE

awraq.cm.sa

UUID

a3f9-7c1d-…

Branch
riyadh-01
Buyer VAT
3001234567
Subtotal
1,150.00
VAT (15%)
172.50
Total 1,322.50
CLEARED · ZATCA 2026-04-27 · 11:42:18
ecdsa-secp256r1:MEUCIQDxK… · stamp.cer

Rendered output of POST /v1/invoices · sample

04 · compliance

The regulator-facing facts.

Awraq is built around the ZATCA spec and ships every schema revision the day it lands. The configuration surface is a transcript, not a marketing claim.

status.awraq.cm.sa →
$ awraq config --section compliance read-only
phase          = ZATCA Phase 2: clearance + reporting
schema         = UBL 2.1 / EN-16931, rev 2024.1
stamp          = ECDSA secp256r1, certificate from ZATCA CA
qr             = TLV per Annex 2, base64-encoded
csid           = auto-onboarded per branch
rate-limit     = 100 req/s · burst 200 · per API key
sla.uptime     = 99.9% rolling 30-day · status.awraq.cm.sa
last-deploy    = 2026-04-22 · schema rev 2024.1 push

Plugs into your stack.

Either run Awraq as your back-end of record, or call it from the systems you already operate. Both are first-class.

[payments]

mada · STC Pay · Apple Pay · Visa · Mastercard · Moyasar · HyperPay

[erp · books]

Mueen · SAP · Odoo · Zoho Books · QuickBooks · Microsoft Dynamics

[commerce]

Salla · Zid · Shopify · WooCommerce · Foodics · Loyverse

06 · pricing

Simple, predictable pricing

Pay monthly or yearly, switch or cancel anytime.

Starter

99 /mo

Single branch · 500 invoices/mo · email support

Professional

// most teams pick this

299 /mo

Up to 5 branches · 5,000 invoices/mo · webhooks · priority support

Business

799 /mo

Unlimited branches & invoices · SAML SSO · 24/7 SLA · dedicated CSM

Sandbox NFR

0 /mo

Free sandbox · test clearance · not for production billing

All tiers include ZATCA Phase 2 clearance and the full REST API. · Annual billing saves 17%. Compare every line →

Detailed comparison

17 features, one column per plan, one row per question.

Feature Starter Professional ★ Business
E-invoicing
B2B simplified invoices
B2C invoices with QR
Credit / debit notes
Multi-tax (VAT + Excise)
Support
Support response ٢٤ ساعة ٢ ساعة ١ ساعة (SLA)
Dedicated account manager
On-site training
Issuance limits
Max invoices per month 500 5,000 بلا حد
Included users 1 5 بلا حد
Companies / entities 1 3 بلا حد
Integrations
Mueen POS integration
Full REST API
Custom ERP integration
Compliance
ZATCA Phase 1 (issuance)
ZATCA Phase 2 (integration)
7-year archive
Audit + compliance reports

● = included · ○ = not included · Upgrades are instant and free.

07 · questions

Questions before you buy

Is Awraq compliant with ZATCA Phase 2? +

Yes, full integration. Every invoice is cleared with ZATCA before being delivered to the customer, with QR codes, XML/UBL output, and cryptographic stamps applied automatically.

Do I need to install anything? +

No. Awraq is fully cloud-based, sign in from any device. We provide a web dashboard plus a REST API for POS / ERP integrations.

Can I import invoices from another system? +

Yes. Bulk CSV import, plus migration tooling for the most common Saudi accounting packages. Our team will help with the first migration on Professional and Business plans.

How is data secured? +

Hosted on Saudi-region cloud, encrypted at rest, daily backups for 90 days. Compliant with PDPL. SOC 2 Type II audit underway.

Can I cancel anytime? +

30-day money-back guarantee on yearly plans, monthly cancellable any time with no fees.

08 · ship it

POST one request.
Get a cleared, signed invoice back.

Awraq · Professional

From 299 SAR/mo · 14-day trial