UBL2.1 XML (VAT IN URL)

We accept the UBL2.1 XML compliant directly as the input for the generate einvoice API. The xml input needs to be base64 encoded. Here are some attached documents for your reference

• Standard Invoice

• Standard Credit Note

• Standard Debit Note

• Simplified Invoice

• Simplified Credit Note

• Simplified Debit Note

As part of our responsibilities we will enrich the following elements within the document before sending it to ZATCA

• ProfileID

• UUID

• IssueDate

• IssueTime

• Previous Invoice Hash

• Invoice Counter Value

• Signature (Simplified Document Only)

• QR Code (Simplified Document Only)

• UBL Extensions (Simplified Document Only)

If you want to do a quick test without registering your company within our website you can try out the following ENV. Basic test can be done here to see if your document is compliant or not.

Request Method

POST

Request Path

{{API_URL}}/api/v2/ksa_einvoice/<VAT_NUM>/generate_einvoice/

NOTE: VAT_NUM is the vat number of your organization that you have onboarded in our website. For eg if you have onboarded vat number 399975588700003 then the full path would be

{{API_URL}}/api/v2/ksa_einvoice/online_service/399975588700003/generate_einvoice/

Request Headers

Parameter	Value	Description
Productid	einvoicing_global	Keep as is
Authorization/MiplApiKey	api_key/auth token	Value and header type is mentioned in the Authentication Page

Request Body

Parameter	Value	Description
invoice	""	Base64 Encoded XML document

The response for the API can be found here.