ZATCA E-Invoicing API Test Suite

Onboarding & API Settings

Seller VAT Number Must be exactly 15 digits starting with 3.

ZATCA Portal OTP OTP generated from Fatoora Portal.

API Execution Type

Invoice UUID

Sequence & Time Metadata

Invoice Counter Value (ICV)

Previous Invoice Hash (PIH)

Issue Date & Time

Seller Party Details (KSA Entity)

Company Registered Name

CRN (Commercial Registration)

Building Number

Street Name

City Subdivision

City Name

Postal Zone (Zip Code)

Buyer Party Details (Customer)

Customer Registered Name

Buyer VAT Number (If B2B)

Building Number

Street Name

City Name

Postal Zone

Invoice Line Items

ID	Item Description	Qty	Unit	Unit Price	VAT %	Action

Endpoint Response Console

// Submit the form on the left to see the direct response from your API...

ℹ️ ZATCA Parameter Reference Guide

A breakdown of required fields and types for third-party developers calling this API.

OnboardRequest.Otp

The 6-digit One-Time Password requested from the Fatoora portal. Required to issue the initial Compliance CSID.

icv (Invoice Counter Value)

Sequential index integer tracking invoices per device. Must match your sequence sequence database counter.

pih (Previous Invoice Hash)

Base64 SHA-256 hash of the preceding invoice XML. For icv = 1, use the default PIH: NWZlY2ViNjZmZmM4NmYzOGQ5NTI3ODZjNmQ2OTZjNzljMmRiYzIzOWRkNGU5MWI0NjcyOWQ3M2EyN2ZiNTdlOQ==

InvoiceSubmissionModel.APIType

Values: "clearance" (B2B invoices subjected to upfront verification) or "reporting" (B2C invoices reported within 24h).

LineItem.TaxPercent

Standard rate in KSA is 15.00%. Must be formatted to two decimal points in the generated XML structure.