What Makes these APIs special ?
You can onboard your entity with ZATCA and be compliant in 5 minutes!
curl --location -g --request POST 'http://{{hostname}}:/v1/e-invoicing/{{onboard_id}}/invoices' \
--header 'Authorization: ' \
--header 'Content-Type: application/json' \
--data-raw '{
"invoice_number": "31124569872002",
"invoice_type": "standard",
"issue_date": "2025-02-10",
"issue_time": "23:07:33",
"payment_means": "bank-payment",
"payment_means_instruction_note": "",
"actual_delivery_date": "2025-01-22",
"supplier_info": {
"vat_number": "300295616200003",
"tax_type": "VAT",
"registration_name": "Saudi Biotechnology Manufacturing Co.",
"localized_registration_name": "الشركة السعودية لتصنيع التقنية الحيوية",
"party_identification": {
"scheme": "CRN",
"id": "1010296893"
},
"address": {
"street_name": "Northern Ring Road",
"building_number": "3357",
"plot_identification": "8392",
"city_subdivision_name": "Riyadh",
"city_name": "Riyadh",
"postal_zone": "11211",
"country": "SA"
},
"localized_address": {
"street_name": "بعض الشوارع",
"building_number": "1232",
"plot_identification": "123",
"city_subdivision_name": "3232112",
"city_name": "الرياض",
"postal_zone": "54321",
"country": "المملكة العربية السعودية"
}
},
"customer_info": {
"custom_info": {
"customer_reference": "KKL00",
"Due_Date": "2025-07-21",
"customer_number": "C0001"
},
"email": "syez@novonordisk.com",
"vat_number": "310807135100003",
"tax_type": "VAT",
"registration_name": "Novo Nordisk Saudi for Trading Company",
"localized_registration_name": "شركة نوفو نورديسك السعودية للتجارة",
"party_identification": {
"scheme": "CRN",
"id": "123456789"
},
"address": {
"street_name": "Prince Mohammad Ibn Salman",
"building_number": "1234",
"plot_identification": "5678",
"city_subdivision_name": "Riyadh",
"city_name": "Riyadh",
"postal_zone": "11211",
"country": "SA"
},
"localized_address": {
"street_name": "بعض الشوارع",
"building_number": "1232",
"plot_identification": "123",
"city_subdivision_name": "3232112",
"city_name": "الرياض",
"postal_zone": "54321",
"country": "المملكة العربية السعودية"
}
},
"tax_total": {
"currency": "SAR",
"tax_amount": 0.0,
"tax_subtotals": [
{
"taxable_amount": 3000.0,
"tax_amount": 0,
"tax_percent": 0,
"tax_category": {
"id": "Z",
"percent": 0,
"tax_type": "VAT",
"tax_exemption_reason_code": "VATEX-SA-33",
"tax_exemption_reason": "Export of Goods"
}
}
]
},
"allowance_charge": {
"charge_indicator": false,
"reason": "discount",
"amount": 0.0,
"currency": "SAR",
"tax_category": {
"id": "Z",
"percent": 0.0,
"tax_type": "VAT"
}
},
"legal_monitory_total": {
"total_amount": 3000.0,
"tax_exclusive_amount": 3000.0,
"tax_inclusive_amount": 3000.00,
"allowance_total_amount": 0,
"prepaid_amount": 0,
"payable_amount": 3000.00
},
"invoice_lines": [
{
"custom_info": {
"0": {
"batchNo": "PT6EA59S1",
"expiryDate": "2026-03-01",
"productionDate": "2024-08-07",
"quantity": 4.0
},
"1": {
"batchNo": "PT0001",
"expiryDate": "2025-01-31",
"productionDate": "",
"quantity": 2.0
},
"2": {
"batchNo": "PT000092",
"expiryDate": "2025-01-31",
"productionDate": "",
"quantity": 4.0
},
"itemId": "10000",
"itemCode": "50010",
"barCode": ""
},
"id": "10000",
"unit_code": "Each",
"quantity": 10.0,
"amount": 3000.0,
"tax_total": {
"currency": "SAR",
"tax_amount": 0.0,
"rounding_amount": 3000.0
},
"item": {
"name": "NOVOMIX 30 FLEXPEN 100UML",
"classified_tax_category": {
"id": "Z",
"percent": 0.0,
"tax_type": "VAT"
}
},
"price": {
"currency": "SAR",
"price_per_unit": 300.0,
"allowance_charge": {
"charge_indicator": false,
"reason": "discount",
"amount": 0,
"base_amount": 300.0,
"currency": "SAR"
}
}
}
]
}'{}