Fatoorah API
Generate a synthetic invoice
ERP, POS, accounting and finance-system developers
Receive a canonical invoice, validation result, XML and mapping evidence through the documented route.
POST /v1/zatca/invoices/generate/simplifiedShow complete request
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": {}
}
JSONSynthetic sandbox available; external production traffic remains gated.
