Generate Einvoice API

This page showcases how to generate einvoices with the 2 input format that we provide.

NOTE: This API expects the user to pass the seller address information as part of input payload. Incase you want us to add the information registered in our server during the onboarding you can follow the page with the input type indicated with "VAT IN URL".

The E-invoice endpoint is async in fashion i.e you will not get the fully generated invoice in the API response. Once the invoice is passed to us, we will add the document in our worker queue and process then via consumer threads. The reason to do this in a such a way is because of the ZATCA governance mandate to ensure no duplicate ICV and PIH are to be present. In order to obtain the signed invoice you will need to either poll the "Get Invoice Process Status" API or register a callback URL in our system through which we will send the invoice back to your system.

The process of registering a callback is a manual process where you have to contact use and provide the following information

  • Domain Name

  • Headers to be used (authentication, content-type)

  • Suggested API timeout

The response format of the callback API is mentioned in the Responses section.

pageUBL2.1 XMLpageUBL2.1 XML (VAT IN URL)pageJSONpageJSON (VAT IN URL)pageResponses

Last updated