Invoices
Report Invoice
POST
/
{onboard_id}
/
invoices
Report Invoice
curl --request POST \
--url https://api.einvoice.sa.com:9090/v1/e-invoicing/{onboard_id}/invoicesimport requests
url = "https://api.einvoice.sa.com:9090/v1/e-invoicing/{onboard_id}/invoices"
response = requests.post(url)
print(response.text)const options = {method: 'POST'};
fetch('https://api.einvoice.sa.com:9090/v1/e-invoicing/{onboard_id}/invoices', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "9090",
CURLOPT_URL => "https://api.einvoice.sa.com:9090/v1/e-invoicing/{onboard_id}/invoices",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.einvoice.sa.com:9090/v1/e-invoicing/{onboard_id}/invoices"
req, _ := http.NewRequest("POST", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.einvoice.sa.com:9090/v1/e-invoicing/{onboard_id}/invoices")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.einvoice.sa.com:9090/v1/e-invoicing/{onboard_id}/invoices")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
response = http.request(request)
puts response.read_bodyWhat it does
Submits a simplified (B2C) invoice to ZATCA for reporting. Unlike clearance, reporting doesn’t happen in real-time before the invoice is issued — the invoice is issued immediately and reported to ZATCA within the compliance window.This uses the same endpoint as Clear Invoice. The only difference is
invoice_type: "simplified" instead of "standard".Authentication
Requires a valid token from Authenticate.Path Parameters
| Name | Type | Description |
|---|---|---|
| onboard_id | string | ID returned from the Onboard endpoint |
Request Body
Same structure as Clear Invoice, with these key differences:| Field | Value | Notes |
|---|---|---|
| invoice_type | simplified | Marks this as a B2C reported invoice |
| payment_means | Optional | Payment means is optional for simplified invoices |
Example Request
curl -X POST https://api.einvoice.sa.com:9090/v1/e-invoicing/{onboard_id}/invoices \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"invoice_number": "INV10",
"invoice_type": "simplified",
"issue_date": "2026-07-26",
"actual_delivery_date": "2026-06-15",
"issue_time": "10:00:00",
"note": "test invoice",
"doc_currency_code": "SAR",
"tax_currency_code": "SAR",
"customer_info": {
"vat_number": "300295616200003",
"tax_type": "VAT",
"registration_name": "Adnoc Oil and Gas Company",
"address": {
"street_name": "King Fahd Road",
"building_number": "4590",
"plot_identification": "4590",
"city_subdivision_name": "Jeddah",
"city_name": "Jeddah",
"postal_zone": "11311",
"country": "SA",
"country_subentity": ""
},
"party_identification": {
"scheme": "CRN",
"id": "7051298821"
}
},
"supplier_info": {
"vat_number": "311262046600003",
"tax_type": "VAT",
"registration_name": "Najma Al Hulool",
"address": {
"street_name": "Ghirnatah, Riyadh 13241",
"building_number": "2596",
"plot_identification": "2596",
"city_subdivision_name": "Ghirnatah",
"city_name": "Riyadh",
"postal_zone": "13241",
"country": "SA",
"country_subentity": ""
},
"party_identification": {
"scheme": "CRN",
"id": "1010171097"
}
},
"payment_means": "cash",
"payment_means_instruction_note": "will receive in cash",
"allowance_charge": {
"charge_indicator": false,
"reason": "discount",
"amount": 0,
"currency": "SAR",
"tax_category": {
"id": "S",
"percent": 15,
"tax_type": "VAT"
}
},
"tax_total": {
"currency": "SAR",
"tax_amount": 3.75,
"tax_subtotal": {
"taxable_amount": 25,
"tax_amount": 3.75,
"tax_category": {
"id": "S",
"percent": 15,
"tax_type": "VAT"
}
}
},
"legal_monitory_total": {
"total_amount": 25,
"tax_exclusive_amount": 25,
"tax_inclusive_amount": 28.75,
"payable_amount": 28.75
},
"invoice_lines": [
{
"id": "1",
"unit_code": "EA",
"quantity": 1,
"amount": 25,
"tax_total": {
"currency": "SAR",
"tax_amount": 3.75,
"rounding_amount": 28.75
},
"item": {
"name": "Butter",
"classified_tax_category": {
"id": "S",
"percent": 15,
"tax_type": "VAT"
}
},
"price": {
"currency": "SAR",
"price_per_unit": 25,
"base_unit_code": "EA",
"allowance_charge": {
"charge_indicator": false,
"reason": "discount",
"amount": 0,
"base_amount": 25,
"currency": "SAR"
}
}
}
]
}'
Example Response
{
"status": "Success",
"invoice_number": "INV10",
"invoice": "PD94bWwgdmVyc2lvbj0iMS4wIi...(base64-encoded signed UBL XML, truncated)",
"id": "8f1e2953-52e2-4704-98ae-a4b6ebc9d1de",
"qr_code": "AQ9OYWptYSBBbCBIdWxvb2wCDzMxMTI2MjA0NjYwMDAwMw...(truncated)",
"message": "simplified-invoice INV10 reported successfully",
"warnings": null,
"errors": null
}
The
invoice field is the full ZATCA-signed UBL 2.1 invoice, base64-encoded. The qr_code field is a base64-encoded ZATCA-compliant QR code.Response Fields
| Field | Description |
|---|---|
| status | Success or Failure |
| invoice_number | Echoes back your submitted invoice number |
| invoice | Base64-encoded, ZATCA-signed UBL XML |
| id | Unique UUID assigned to this invoice |
| qr_code | Base64-encoded QR code data |
| message | Human-readable result summary |
| warnings | Any non-blocking ZATCA warnings, or null |
| errors | Any blocking errors, or null |
Errors
| Code | Meaning |
|---|---|
| 400 | Invalid or missing required field |
| 401 | Missing or invalid auth token |
| 422 | ZATCA rejected the invoice — check errors field in response |
Was this page helpful?
⌘I
Report Invoice
curl --request POST \
--url https://api.einvoice.sa.com:9090/v1/e-invoicing/{onboard_id}/invoicesimport requests
url = "https://api.einvoice.sa.com:9090/v1/e-invoicing/{onboard_id}/invoices"
response = requests.post(url)
print(response.text)const options = {method: 'POST'};
fetch('https://api.einvoice.sa.com:9090/v1/e-invoicing/{onboard_id}/invoices', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "9090",
CURLOPT_URL => "https://api.einvoice.sa.com:9090/v1/e-invoicing/{onboard_id}/invoices",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.einvoice.sa.com:9090/v1/e-invoicing/{onboard_id}/invoices"
req, _ := http.NewRequest("POST", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.einvoice.sa.com:9090/v1/e-invoicing/{onboard_id}/invoices")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.einvoice.sa.com:9090/v1/e-invoicing/{onboard_id}/invoices")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
response = http.request(request)
puts response.read_body