Issue invoice

Issues a simplified invoice and automatically queues reporting to ZATCA.

Uses the same payload and local validation rules as report. Returns 202 Accepted after saving the signed XML and QR code, without waiting for ZATCA. Use the returned document ID with the existing download endpoint (type=xml or type=pdf). PDF rendering runs on demand or in the background; it is not part of issuance latency.

Local validation does not mean ZATCA has accepted the document. Follow reporting using the document retrieval endpoint or webhooks. The signed XML and QR code remain unchanged during retries and stay downloadable if reporting is delayed or rejected. Sending through channels is queued after issuance and does not wait for successful reporting. Delivery retries preserve completed channels.

Available only for simplified documents. The existing report endpoint continues to wait for a ZATCA response.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

The payload to report a simplified tax invoice to ZATCA and optionally send it to its recipients.

channels
array of objects
length ≤ 1

The channels to send the document

channels
document
object
required

The document data

string
enum
Defaults to en

The language of the document

View the enum reference

Allowed:
metadata
object

The metadata of the document. Keys cannot contain . or start with $.

string

The reference of the document

template
object

The template of the document

Headers
string

If the account is under a Group VAT, then it is required to be the TIN of the instance under the Group VAT. Otherwise it is optional and can be used as a branch name

string

The unique identifier of the connected account you're operating on behalf of

string
required

The zatca environment to use, available options are ['production', 'simulation']

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json