Developer documentation
Fatoorah quickstart
A verified login provisions the organization, sandbox subscription, Fatoorah resource, scoped developer key, onboarding state, and audit records as one idempotent operation.
Implementation guide
What the integration should preserve.
- 01
Create an account and verify the email address.
- 02
Create the Saudi organization in the welcome flow.
- 03
Copy the first developer key when it is revealed once.
- 04
Send an invoice request with an idempotency key.
- 05
Inspect the request ID, artifacts, logs, and usage in the console.
Relevant paths
POST /v1/zatca/invoices/generate/simplifiedGET /v1/zatca/invoices/:idGET /v1/request-logsGET /v1/usageExample
curl "$TECHNOMINDS_API_URL/v1/zatca/invoices/generate/simplified" \
-X POST \
-H "Authorization: Bearer $TECHNOMINDS_API_KEY" \
-H "Idempotency-Key: invoice-demo-001" \
-H "Content-Type: application/json" \
--data @- <<JSON
{
"organization_id": "$TECHNOMINDS_ORGANIZATION_ID",
"egs_unit_id": null,
"taxpayer_profile_id": null,
"tax_calculation_mode": "TECHNOMINDS_CALCULATES",
"requested_invoice_type": "SIMPLIFIED_TAX_INVOICE",
"seller": {
"legal_name": "Synthetic Najd Retail",
"vat_number": "310000000000003",
"commercial_registration": null,
"address": null,
"branch": "Riyadh",
"additional_identifiers": []
},
"buyer": {
"legal_name": null,
"vat_number": null,
"commercial_registration": null,
"address": null,
"additional_identifiers": [],
"buyer_type": "individual"
},
"supply": {
"supply_date": "2026-08-10",
"end_date": null,
"purchase_order_reference": null,
"contract_reference": null,
"delivery_reference": null,
"payment_terms": null,
"payment_method": "card"
},
"line_items": [
{
"line_id": "line-1",
"name_ar": "عنصر تجريبي",
"name_en": "Synthetic sandbox item",
"description": "Fictional developer fixture",
"quantity": 1,
"unit_code": "PCE",
"unit_price": 10000,
"discounts": [],
"charges": [],
"tax_category": "standard_rated",
"tax_rate": 15,
"tax_exemption_reason": null
}
],
"notes": {}
}
JSONContinue reading