Resources
Inspect the integration before you create the account.
Ungated tools and guidance for teams evaluating Saudi infrastructure APIs. Public utilities run locally and state exactly what they do not prove.
Free developer tools
Invoice JSON Validator
Check the shape and basic arithmetic of a Saudi invoice request locally in your browser.
Open resource →
XML Invoice Inspector
Inspect invoice XML structure, namespaces, identifiers, totals, and common required elements locally.
Open resource →
Saudi Invoice QR Inspector
Decode a Base64 TLV invoice payload into visible tag, length, and value fields.
Open resource →
Sample Invoice Generator
Generate a synthetic standard or simplified invoice request for sandbox evaluation.
Open resource →
Fatoorah API Request Builder
Turn a synthetic invoice JSON object into a server-side cURL request with safe credential placeholders.
Open resource →
Saudi Address Parser
Separate common Saudi address labels, short-address tokens, postal codes, building numbers, and free-text segments.
Open resource →
Saudi Address Normalizer
Normalize Arabic and Latin digits, whitespace, punctuation, and common address labels with transformation provenance.
Open resource →
Webhook Signature Tester
Compute an HMAC-SHA256 signature from a timestamp, raw body, and temporary test secret in your browser.
Open resource →
Integration guides
ZATCA API Integration Guide
A practical guide to organization, entity, credential, idempotency, invoice state, webhooks, evidence, and production gating.
Open resource →
Idempotency for Invoice Submission
How stable operation identity, concurrency control, unknown outcomes, and reconciliation prevent duplicate invoice effects.
Open resource →
Saudi Address Operations Guide
A practical model for Saudi address capture, normalization, recovery, hold/release, mapping, and outcome evidence.
Open resource →
Developer operations
Fatoorah quickstart
Create a TechnoMinds Fatoorah sandbox and make your first synthetic invoice request.
Open resource →
Authentication
Use scoped developer keys without exposing them to browser runtime or logs.
Open resource →
Idempotency
Prevent repeated client or worker attempts from creating duplicate effects.
Open resource →
Webhooks
Receive signed lifecycle events and process duplicate delivery safely.
Open resource →
Unknown outcomes
Represent uncertainty explicitly instead of guessing success or failure.
Open resource →
Errors
Design around actionable error codes, request IDs, and retry classification.
Open resource →
Fatoorah API with PHP and Laravel
Make an idempotent synthetic Fatoorah request from a Laravel service and keep permanent credentials on the server.
Open resource →
Fatoorah API with Node.js and TypeScript
Call the synthetic Fatoorah API from a typed Node.js service with explicit request identity and error handling.
Open resource →
Fatoorah API with Python
Send a bounded synthetic Fatoorah request from Python and retain the correlation needed for reconciliation.
Open resource →
Fatoorah API with .NET
Integrate the synthetic Fatoorah API through HttpClientFactory with server-side credentials and stable operation identity.
Open resource →
Architecture comparisons
Build vs Integrate a Fatoorah API
Compare direct internal Fatoorah implementation with a TechnoMinds API platform approach without unsupported competitor claims.
Open resource →
Address Lookup vs Address Operations
Compare raw Saudi address lookup with normalization, recovery, hold/release, carrier mapping, and outcome evidence.
Open resource →