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}}/credit-notes' \
--header 'Authorization: ' \
--header 'Content-Type: application/json' \
--data-raw '{
"creditnote_number":"newjson7creditnote",
"creditnote_type":"standard",
"billing_reference": "Invoice Number: newjson6; Invoice Issue Date: 2025-02-10",
"issue_date":"2025-02-10",
"issue_time":"23:07:33",
"payment_means":"bank-payment",
"payment_means_instruction_note":"cancellation",
"actual_delivery_date":"2025-01-22",
"supplier_info":{
"vat_number":"300295616200003",
"tax_type":"VAT",
"registration_name":"Saudi Biotechnology Manufacturing Co.",
"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"
}
},
"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",
"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"
}
},
"tax_total":{
"currency":"SAR",
"tax_amount":0.0, //all categories total
"tax_subtotals":[
{
"taxable_amount":3000.0,
"tax_amount":0, //individual category total
"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":"2024-08-07",
"quantity":4.0
},
"2":{
"batchNo":"",
"expiryDate":"",
"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"
}
}
}
]
}'{}