Send E-Invoice to Buyer

Create a valid E-Invoice with JSON payload and send it to the Buyer Endpoint via PEPPOL network.

Request Method

POST

Request URL

{{HOST}}/be/einvoice/v1/documents/send

Request Headers

Parameter	Data Type	Field Validations	Description
x-cleartax-auth-token	String	Cannot be empty	Mandatory. User auth token.
x-clear-vat	String	Cannot be empty	Mandatory. VAT of the entity.
x-clear-branch	String	Should be a valid branch from the user account	Optional. Branch name (store name) added in the user account which maps to a VAT of the entity.
x-request-id	UUID	Should be unique for every request	Optional. Unique request ID. Used for Debugging Support Issues
Content-Type	String	application/json	application/json

Request Path Params

There are no path params for this API.

Request Query Params

Parameter	Data Type	Field Validations	Description
einvoice-type	ENUM	Currently, only SALES is supported	Default: SALES

Request Body

Parameter	Data Type	Field Validations	Description
Documents	Array	MinListLength: 1 MaxListLength: 10	Mandatory. List of Documents
Version	String	NA	Mandatory, "BE_GENERATE_UBL_2_1_V1"

Documents Object

Parameter	Data Type	Field Validations	Description
DocumentData	String	NA	Mandatory. Base64 of the document data in JSON format. Details.
DocumentFormat	ENUM	JSON	Mandatory. Describes the data received is in the JSON Format
CustomFields	Object	NA	Map of Custom fields with key-value pair eg : ( { “Internal Number” : “INV000012” })

Custom Fields Object

This is a custom object of key-value pairs that can be used to display custom fields in custom output PDF templates or in certain reports. For example:

{
    "country_of_origin": "IN",
    "total_containers": "3"
}

Response Status Codes

HTTP Status Code	Description
200	For successfully submitted document or with validation errors
400	For any kind of Invalid Payload issues
401	If the user is not authenticated for the operation
403	If the user is not authorized for the operation

Response Schema

Parameter	Data Type	Field Validations	Description
Success	Boolean	true/false	Always present. Indicates the request was successful or not
DocumentResponses	Array	-	-

Document Details Object

Parameter	Data Type	Field Validations	Description
DocumentId	String		Unique document ID, generated by database. To be used in Status Check API.
UniqueId	String		Unique ID generated by ClearTax to distinctly identify the document.
Success	Boolean	true/false	Indicates, if the request for this document was successfully processed or not
ErrorDetails	Array<ErrorDetail>	Error details	Optional. Error list from ClearTax
WarningDetails	Array<ErrorDetail>	Warning details	Optional. Warning list from ClearTax

Sample Request and Response

Request

{
    "Documents": [
        {
            "DocumentData": "ewogICJJRCI6ICJCRUxnaXVtMiIsCiAgIklzc3VlRGF0ZSI6ICIyMDI1LTA4LTA3IiwKICAiSW52b2ljZVR5cGVDb2RlIjogIjM4OCIsCiAgIk5vdGUiOiAiU2FtcGxlIG5vdGUiLAogICJEb2N1bWVudEN1cnJlbmN5Q29kZSI6ICJVU0QiLAogICJUYXhDdXJyZW5jeUNvZGUiOiAiSU5SIiwKICAiQnV5ZXJSZWZlcmVuY2UiOiAiQlVZRVItUkVGLTAwMSIsCiAgIkludm9pY2VQZXJpb2QiOiB7CiAgICAiU3RhcnREYXRlIjogIjIwMjUtMDgtMDUiLAogICAgIkVuZERhdGUiOiAiMjAyNS0wOC0wNyIKICB9LAogICJPcmRlclJlZmVyZW5jZSI6IHsKICAgICJJRCI6ICJPUkQtMjAyNS0wMDEiCiAgfSwKICAiQmlsbGluZ1JlZmVyZW5jZSI6IFsKICAgIHsKICAgICAgIkludm9pY2VEb2N1bWVudFJlZmVyZW5jZSI6IHsKICAgICAgICAiSUQiOiAiTElOS0VELTAwMSIsCiAgICAgICAgIklzc3VlRGF0ZSI6ICIyMDI1LTA4LTAxIgogICAgICB9CiAgICB9CiAgXSwKICAiQ29udHJhY3REb2N1bWVudFJlZmVyZW5jZSI6IHsKICAgICJJRCI6ICJDT05UUkFDVC0wMDEiCiAgfSwKICAiUHJvamVjdFJlZmVyZW5jZSI6IHsKICAgICJJRCI6ICJQUk9KRUNULTAwMSIKICB9LAogICJBY2NvdW50aW5nU3VwcGxpZXJQYXJ0eSI6IHsKICAgICJQYXJ0eSI6IHsKICAgICAgIkVuZHBvaW50SUQiOiB7CiAgICAgICAgIlZhbHVlIjogIkJFMTIzNDU2Nzg5MCIsCiAgICAgICAgIlNjaGVtZUlEIjogIjk5MjUiCiAgICAgIH0sCiAgICAgICJQYXJ0eUlkZW50aWZpY2F0aW9uIjogWwogICAgICAgIHsKICAgICAgICAgICJJRCI6IHsKICAgICAgICAgICAgIlZhbHVlIjogIlBhcnR5LWlkZW50aWZpY2F0aW9uLXN1cHBsaWVyIiwKICAgICAgICAgICAgIlNjaGVtZUlEIjogIjAwMDIiCiAgICAgICAgICB9CiAgICAgICAgfQogICAgICBdLAogICAgICAiUG9zdGFsQWRkcmVzcyI6IHsKICAgICAgICAiU3RyZWV0TmFtZSI6ICJTYW1wbGUgc3RyZWV0IiwKICAgICAgICAiQWRkaXRpb25hbFN0cmVldE5hbWUiOiAiU2FtcGxlIGFkZGl0aW9uYWwgc3RyZWV0IiwKICAgICAgICAiQ2l0eU5hbWUiOiAiQmVsZ2l1bSIsCiAgICAgICAgIlBvc3RhbFpvbmUiOiAiMjAwMCIsCiAgICAgICAgIkNvdW50cnlTdWJlbnRpdHkiOiAiU2FtcGxlIHNlbGxlciBzdGF0ZSIsCiAgICAgICAgIkFkZHJlc3NMaW5lIjogWwogICAgICAgICAgewogICAgICAgICAgICAiTGluZSI6ICJBZGRyZXNzIGxpbmUgMyIKICAgICAgICAgIH0KICAgICAgICBdLAogICAgICAgICJDb3VudHJ5IjogewogICAgICAgICAgIklkZW50aWZpY2F0aW9uQ29kZSI6ICJCRSIKICAgICAgICB9CiAgICAgIH0sCiAgICAgICJQYXJ0eVRheFNjaGVtZSI6IFsKICAgICAgICB7CiAgICAgICAgICAiQ29tcGFueUlEIjogIkJFMDEyMDI0MDEwMiIsCiAgICAgICAgICAiVGF4U2NoZW1lIjogewogICAgICAgICAgICAiSUQiOiAiVkFUIgogICAgICAgICAgfQogICAgICAgIH0KICAgICAgXSwKICAgICAgIlBhcnR5TGVnYWxFbnRpdHkiOiB7CiAgICAgICAgIlJlZ2lzdHJhdGlvbk5hbWUiOiAiU2FtcGxlIHNlbGxlciBuYW1lIgogICAgICB9LAogICAgICAiQ29udGFjdCI6IHsKICAgICAgICAiTmFtZSI6ICJTYW1wbGUgc2VsbGVyIGNvbnRhY3QgbmFtZSIsCiAgICAgICAgIlRlbGVwaG9uZSI6ICIzMjMyMzI4MjEwIiwKICAgICAgICAiRWxlY3Ryb25pY01haWwiOiAic2VsbGVyQGNsZWFyLmluIgogICAgICB9CiAgICB9CiAgfSwKICAiQWNjb3VudGluZ0N1c3RvbWVyUGFydHkiOiB7CiAgICAiUGFydHkiOiB7CiAgICAgICJFbmRwb2ludElEIjogewogICAgICAgICJWYWx1ZSI6ICIwMTIwMjQwMTAyMTEyOSIsCiAgICAgICAgIlNjaGVtZUlEIjogIjAxOTMiCiAgICAgIH0sCiAgICAgICJQYXJ0eUlkZW50aWZpY2F0aW9uIjogWwogICAgICAgIHsKICAgICAgICAgICJJRCI6IHsKICAgICAgICAgICAgIlZhbHVlIjogIkJFOTg3MjIyMjIyMiIsCiAgICAgICAgICAgICJTY2hlbWVJRCI6ICIwMDAzIgogICAgICAgICAgfQogICAgICAgIH0KICAgICAgXSwKICAgICAgIlBvc3RhbEFkZHJlc3MiOiB7CiAgICAgICAgIlN0cmVldE5hbWUiOiAiU2FtcGxlIGJ1eWVyIHN0cmVldCIsCiAgICAgICAgIkFkZGl0aW9uYWxTdHJlZXROYW1lIjogIlNhbXBsZSBidXllciBhZGQuIHN0cmVldCIsCiAgICAgICAgIkNpdHlOYW1lIjogIlNhbXBsZSBidXllciBjaXR5IiwKICAgICAgICAiUG9zdGFsWm9uZSI6ICI5MDAwIiwKICAgICAgICAiQ291bnRyeVN1YmVudGl0eSI6ICJTYW1wbGUgYnV5ZXIgc3RhdGUiLAogICAgICAgICJBZGRyZXNzTGluZSI6IFsKICAgICAgICAgIHsKICAgICAgICAgICAgIkxpbmUiOiAiQnV5ZXIgYWRkcmVzcyBsaW5lIDMiCiAgICAgICAgICB9CiAgICAgICAgXSwKICAgICAgICAiQ291bnRyeSI6IHsKICAgICAgICAgICJJZGVudGlmaWNhdGlvbkNvZGUiOiAiVVMiCiAgICAgICAgfQogICAgICB9LAogICAgICAiUGFydHlMZWdhbEVudGl0eSI6IHsKICAgICAgICAiUmVnaXN0cmF0aW9uTmFtZSI6ICJTYW1wbGUgYnV5ZXIgbmFtZSIKICAgICAgfSwKICAgICAgIkNvbnRhY3QiOiB7CiAgICAgICAgIk5hbWUiOiAiU2FtcGxlIGJ1eWVyIGNvbnRhY3QgbmFtZSIsCiAgICAgICAgIlRlbGVwaG9uZSI6ICIzMiA4OSA4NCA1MiA1OCIsCiAgICAgICAgIkVsZWN0cm9uaWNNYWlsIjogImJ1eWVyQGNsZWFyLmluIgogICAgICB9CiAgICB9CiAgfSwKICAiRGVsaXZlcnkiOiB7CiAgICAiQWN0dWFsRGVsaXZlcnlEYXRlIjogIjIwMjUtMDgtMDQiLAogICAgIkRlbGl2ZXJ5TG9jYXRpb24iOiB7CiAgICAgICJJRCI6IHsKICAgICAgICAiVmFsdWUiOiAiMjI4NzMiLAogICAgICAgICJTY2hlbWVJRCI6ICIwMDg1IgogICAgICB9LAogICAgICAiQWRkcmVzcyI6IHsKICAgICAgICAiU3RyZWV0TmFtZSI6ICJEZWxpdmVyeSBzdHJlZXQiLAogICAgICAgICJBZGRpdGlvbmFsU3RyZWV0TmFtZSI6ICJEZWxpdmVyeSBhZGQuIHN0cmVldCIsCiAgICAgICAgIkNpdHlOYW1lIjogIlNhbXBsZSBkZWxpdmVyeSBjaXR5IiwKICAgICAgICAiUG9zdGFsWm9uZSI6ICIxMDAwIiwKICAgICAgICAiQ291bnRyeVN1YmVudGl0eSI6ICJTYW1wbGUgZGVsaXZlcnkgc3RhdGUiLAogICAgICAgICJBZGRyZXNzTGluZSI6IFsKICAgICAgICAgIHsKICAgICAgICAgICAgIkxpbmUiOiAiRGVsaXZlcnkgbGluZSAzIgogICAgICAgICAgfQogICAgICAgIF0sCiAgICAgICAgIkNvdW50cnkiOiB7CiAgICAgICAgICAiSWRlbnRpZmljYXRpb25Db2RlIjogIkJFIgogICAgICAgIH0KICAgICAgfQogICAgfSwKICAgICJEZWxpdmVyeVBhcnR5IjogewogICAgICAiUGFydHlOYW1lIjogewogICAgICAgICJOYW1lIjogIlNhbXBsZSBkZWxpdmVyeSByZWNwLiBuYW1lIgogICAgICB9CiAgICB9CiAgfSwKICAiUGF5bWVudE1lYW5zIjogewogICAgIlBheW1lbnRNZWFuc0NvZGUiOiAiMTAiLAogICAgIlBheWVlRmluYW5jaWFsQWNjb3VudCI6IHsKICAgICAgIklEIjogIkJFODggNDU2NyA4OTAxIDIzNDUiLAogICAgICAiTmFtZSI6ICJTdXBwbGllciBUaGV0YSBMdGQiLAogICAgICAiRmluYW5jaWFsSW5zdGl0dXRpb25CcmFuY2giOiB7CiAgICAgICAgIklEIjogIktSRURCRUJCIgogICAgICB9CiAgICB9CiAgfSwKICAiUGF5bWVudFRlcm1zIjogewogICAgIk5vdGUiOiAiUGF5bWVudCB3aXRoaW4gMTQgZGF5cyIKICB9LAogICJBbGxvd2FuY2VDaGFyZ2UiOiBbCiAgICB7CiAgICAgICJDaGFyZ2VJbmRpY2F0b3IiOiBmYWxzZSwKICAgICAgIkFsbG93YW5jZUNoYXJnZVJlYXNvbkNvZGUiOiAiNDEiLAogICAgICAiTXVsdGlwbGllckZhY3Rvck51bWVyaWMiOiAwLjAsCiAgICAgICJBbW91bnQiOiB7CiAgICAgICAgIlZhbHVlIjogMC4wMAogICAgICB9LAogICAgICAiQmFzZUFtb3VudCI6IHsKICAgICAgICAiVmFsdWUiOiAwLjAwMAogICAgICB9LAogICAgICAiVGF4Q2F0ZWdvcnkiOiB7CiAgICAgICAgIklEIjogIlMiLAogICAgICAgICJQZXJjZW50IjogMTIuMDAsCiAgICAgICAgIlRheFNjaGVtZSI6IHsKICAgICAgICAgICJJRCI6ICJWQVQiCiAgICAgICAgfQogICAgICB9CiAgICB9LAogICAgewogICAgICAiQ2hhcmdlSW5kaWNhdG9yIjogdHJ1ZSwKICAgICAgIkFsbG93YW5jZUNoYXJnZVJlYXNvbkNvZGUiOiAiWlpaIiwKICAgICAgIk11bHRpcGxpZXJGYWN0b3JOdW1lcmljIjogMC4wMCwKICAgICAgIkFtb3VudCI6IHsKICAgICAgICAiVmFsdWUiOiAwLjAwMDAKICAgICAgfSwKICAgICAgIkJhc2VBbW91bnQiOiB7CiAgICAgICAgIlZhbHVlIjogMC4wMDAwMDAwCiAgICAgIH0sCiAgICAgICJUYXhDYXRlZ29yeSI6IHsKICAgICAgICAiSUQiOiAiUyIsCiAgICAgICAgIlBlcmNlbnQiOiAyMS4wMCwKICAgICAgICAiVGF4U2NoZW1lIjogewogICAgICAgICAgIklEIjogIlZBVCIKICAgICAgICB9CiAgICAgIH0KICAgIH0KICBdLAogICJUYXhUb3RhbCI6IFsKICAgIHsKICAgICAgIlRheEFtb3VudCI6IHsKICAgICAgICAiVmFsdWUiOiAzMTguMwogICAgICB9LAogICAgICAiVGF4U3VidG90YWwiOiBbCiAgICAgICAgewogICAgICAgICAgIlRheGFibGVBbW91bnQiOiB7CiAgICAgICAgICAgICJWYWx1ZSI6IDk5MC4wMAogICAgICAgICAgfSwKICAgICAgICAgICJUYXhBbW91bnQiOiB7CiAgICAgICAgICAgICJWYWx1ZSI6IDExOC44CiAgICAgICAgICB9LAogICAgICAgICAgIlRheENhdGVnb3J5IjogewogICAgICAgICAgICAiSUQiOiAiUyIsCiAgICAgICAgICAgICJQZXJjZW50IjogMTIuMDAsCiAgICAgICAgICAgICJUYXhTY2hlbWUiOiB7CiAgICAgICAgICAgICAgIklEIjogIlZBVCIKICAgICAgICAgICAgfQogICAgICAgICAgfQogICAgICAgIH0sCiAgICAgICAgewogICAgICAgICAgIlRheGFibGVBbW91bnQiOiB7CiAgICAgICAgICAgICJWYWx1ZSI6IDk1MC4wMAogICAgICAgICAgfSwKICAgICAgICAgICJUYXhBbW91bnQiOiB7CiAgICAgICAgICAgICJWYWx1ZSI6IDE5OS41CiAgICAgICAgICB9LAogICAgICAgICAgIlRheENhdGVnb3J5IjogewogICAgICAgICAgICAiSUQiOiAiUyIsCiAgICAgICAgICAgICJQZXJjZW50IjogMjEuMDAsCiAgICAgICAgICAgICJUYXhTY2hlbWUiOiB7CiAgICAgICAgICAgICAgIklEIjogIlZBVCIKICAgICAgICAgICAgfQogICAgICAgICAgfQogICAgICAgIH0KICAgICAgXQogICAgfSwKICAgIHsKICAgICAgIlRheEFtb3VudCI6IHsKICAgICAgICAiVmFsdWUiOiAzMTgzMC4wLAogICAgICAgICJDdXJyZW5jeUlEIjogIklOUiIKICAgICAgfQogICAgfQogIF0sCiAgIkxlZ2FsTW9uZXRhcnlUb3RhbCI6IHsKICAgICJMaW5lRXh0ZW5zaW9uQW1vdW50IjogewogICAgICAiVmFsdWUiOiAxOTQwLjAwCiAgICB9LAogICAgIlRheEV4Y2x1c2l2ZUFtb3VudCI6IHsKICAgICAgIlZhbHVlIjogMTk0MC4wMAogICAgfSwKICAgICJUYXhJbmNsdXNpdmVBbW91bnQiOiB7CiAgICAgICJWYWx1ZSI6IDIyNTguMzAKICAgIH0sCiAgICAiQWxsb3dhbmNlVG90YWxBbW91bnQiOiB7CiAgICAgICJWYWx1ZSI6IDAuMDAKICAgIH0sCiAgICAiQ2hhcmdlVG90YWxBbW91bnQiOiB7CiAgICAgICJWYWx1ZSI6IDAuMDAKICAgIH0sCiAgICAiUHJlcGFpZEFtb3VudCI6IHsKICAgICAgIlZhbHVlIjogMTAwLjAwCiAgICB9LAogICAgIlBheWFibGVSb3VuZGluZ0Ftb3VudCI6IHsKICAgICAgIlZhbHVlIjogLTAuMwogICAgfSwKICAgICJQYXlhYmxlQW1vdW50IjogewogICAgICAiVmFsdWUiOiAyMTU4LjAwCiAgICB9CiAgfSwKICAiSW52b2ljZUxpbmUiOiBbCiAgICB7CiAgICAgICJJRCI6ICIxIiwKICAgICAgIkludm9pY2VkUXVhbnRpdHkiOiB7CiAgICAgICAgIlF1YW50aXR5IjogMi4wMCwKICAgICAgICAiVW5pdENvZGUiOiAiQUUiCiAgICAgIH0sCiAgICAgICJMaW5lRXh0ZW5zaW9uQW1vdW50IjogewogICAgICAgICJWYWx1ZSI6IDk1MC4wMAogICAgICB9LAogICAgICAiQWxsb3dhbmNlQ2hhcmdlIjogWwogICAgICAgIHsKICAgICAgICAgICJDaGFyZ2VJbmRpY2F0b3IiOiBmYWxzZSwKICAgICAgICAgICJBbGxvd2FuY2VDaGFyZ2VSZWFzb25Db2RlIjogIjQxIiwKICAgICAgICAgICJNdWx0aXBsaWVyRmFjdG9yTnVtZXJpYyI6IDEwLjAsCiAgICAgICAgICAiQW1vdW50IjogewogICAgICAgICAgICAiVmFsdWUiOiAxMDAuMDAKICAgICAgICAgIH0sCiAgICAgICAgICAiQmFzZUFtb3VudCI6IHsKICAgICAgICAgICAgIlZhbHVlIjogMTAwMC4wMAogICAgICAgICAgfQogICAgICAgIH0sCiAgICAgICAgewogICAgICAgICAgIkNoYXJnZUluZGljYXRvciI6IHRydWUsCiAgICAgICAgICAiQWxsb3dhbmNlQ2hhcmdlUmVhc29uQ29kZSI6ICJaWloiLAogICAgICAgICAgIk11bHRpcGxpZXJGYWN0b3JOdW1lcmljIjogNS4wLAogICAgICAgICAgIkFtb3VudCI6IHsKICAgICAgICAgICAgIlZhbHVlIjogNTAuMDAKICAgICAgICAgIH0sCiAgICAgICAgICAiQmFzZUFtb3VudCI6IHsKICAgICAgICAgICAgIlZhbHVlIjogMTAwMC4wMAogICAgICAgICAgfQogICAgICAgIH0KICAgICAgXSwKICAgICAgIkl0ZW0iOiB7CiAgICAgICAgIkRlc2NyaXB0aW9uIjogIkl0ZW0gMSBkZXNjcmlwdGlvbiIsCiAgICAgICAgIk5hbWUiOiAiSXRlbSAxIG5hbWUiLAogICAgICAgICJPcmlnaW5Db3VudHJ5IjogewogICAgICAgICAgIklkZW50aWZpY2F0aW9uQ29kZSI6ICJKUCIKICAgICAgICB9LAogICAgICAgICJDb21tb2RpdHlDbGFzc2lmaWNhdGlvbiI6IFsKICAgICAgICAgIHsKICAgICAgICAgICAgIkl0ZW1DbGFzc2lmaWNhdGlvbkNvZGUiOiB7CiAgICAgICAgICAgICAgIlNjaGVtZUlEIjogIkFBIiwKICAgICAgICAgICAgICAiVmFsdWUiOiAiMDkzNDgwMjMiCiAgICAgICAgICAgIH0KICAgICAgICAgIH0KICAgICAgICBdLAogICAgICAgICJDbGFzc2lmaWVkVGF4Q2F0ZWdvcnkiOiBbCiAgICAgICAgICB7CiAgICAgICAgICAgICJJRCI6ICJTIiwKICAgICAgICAgICAgIlBlcmNlbnQiOiAyMS4wMCwKICAgICAgICAgICAgIlRheFNjaGVtZSI6IHsKICAgICAgICAgICAgICAiSUQiOiAiVkFUIgogICAgICAgICAgICB9CiAgICAgICAgICB9CiAgICAgICAgXQogICAgICB9LAogICAgICAiUHJpY2UiOiB7CiAgICAgICAgIlByaWNlQW1vdW50IjogewogICAgICAgICAgIlZhbHVlIjogNTAwCiAgICAgICAgfQogICAgICB9CiAgICB9LAogICAgewogICAgICAiSUQiOiAiMiIsCiAgICAgICJJbnZvaWNlZFF1YW50aXR5IjogewogICAgICAgICJRdWFudGl0eSI6IDUuMDAsCiAgICAgICAgIlVuaXRDb2RlIjogIkFFIgogICAgICB9LAogICAgICAiTGluZUV4dGVuc2lvbkFtb3VudCI6IHsKICAgICAgICAiVmFsdWUiOiA5OTAuMDAKICAgICAgfSwKICAgICAgIkFsbG93YW5jZUNoYXJnZSI6IFsKICAgICAgICB7CiAgICAgICAgICAiQ2hhcmdlSW5kaWNhdG9yIjogZmFsc2UsCiAgICAgICAgICAiQWxsb3dhbmNlQ2hhcmdlUmVhc29uQ29kZSI6ICI0MSIsCiAgICAgICAgICAiTXVsdGlwbGllckZhY3Rvck51bWVyaWMiOiAyLjAsCiAgICAgICAgICAiQW1vdW50IjogewogICAgICAgICAgICAiVmFsdWUiOiAyMC4wMAogICAgICAgICAgfSwKICAgICAgICAgICJCYXNlQW1vdW50IjogewogICAgICAgICAgICAiVmFsdWUiOiAxMDAwLjAwCiAgICAgICAgICB9CiAgICAgICAgfSwKICAgICAgICB7CiAgICAgICAgICAiQ2hhcmdlSW5kaWNhdG9yIjogdHJ1ZSwKICAgICAgICAgICJBbGxvd2FuY2VDaGFyZ2VSZWFzb25Db2RlIjogIlpaWiIsCiAgICAgICAgICAiTXVsdGlwbGllckZhY3Rvck51bWVyaWMiOiAxLjAsCiAgICAgICAgICAiQW1vdW50IjogewogICAgICAgICAgICAiVmFsdWUiOiAxMC4wMAogICAgICAgICAgfSwKICAgICAgICAgICJCYXNlQW1vdW50IjogewogICAgICAgICAgICAiVmFsdWUiOiAxMDAwLjAwCiAgICAgICAgICB9CiAgICAgICAgfQogICAgICBdLAogICAgICAiSXRlbSI6IHsKICAgICAgICAiRGVzY3JpcHRpb24iOiAiSXRlbSAyIGRlc2NyaXB0aW9uIiwKICAgICAgICAiTmFtZSI6ICJJdGVtIDIgbmFtZSIsCiAgICAgICAgIk9yaWdpbkNvdW50cnkiOiB7CiAgICAgICAgICAiSWRlbnRpZmljYXRpb25Db2RlIjogIkpQIgogICAgICAgIH0sCiAgICAgICAgIkNvbW1vZGl0eUNsYXNzaWZpY2F0aW9uIjogWwogICAgICAgICAgewogICAgICAgICAgICAiSXRlbUNsYXNzaWZpY2F0aW9uQ29kZSI6IHsKICAgICAgICAgICAgICAiU2NoZW1lSUQiOiAiQUIiLAogICAgICAgICAgICAgICJWYWx1ZSI6ICIwOTM0ODAyMyIKICAgICAgICAgICAgfQogICAgICAgICAgfQogICAgICAgIF0sCiAgICAgICAgIkNsYXNzaWZpZWRUYXhDYXRlZ29yeSI6IFsKICAgICAgICAgIHsKICAgICAgICAgICAgIklEIjogIlMiLAogICAgICAgICAgICAiUGVyY2VudCI6IDEyLjAwLAogICAgICAgICAgICAiVGF4U2NoZW1lIjogewogICAgICAgICAgICAgICJJRCI6ICJWQVQiCiAgICAgICAgICAgIH0KICAgICAgICAgIH0KICAgICAgICBdCiAgICAgIH0sCiAgICAgICJQcmljZSI6IHsKICAgICAgICAiUHJpY2VBbW91bnQiOiB7CiAgICAgICAgICAiVmFsdWUiOiAyMDAKICAgICAgICB9CiAgICAgIH0KICAgIH0KICBdCn0=",
            "DocumentFormat": "JSON",
            "CustomFields": {
                "Internal Number": "INVBELGIUM1"
            }
        }
    ]
}

Response - Success:

HTTP Status Code - 200

{
    "ErrorDetails": null,
    "Success": "true",
    "DocumentResponses": [
        {
            "DocumentId": "68a2c61d2086c615843fd5b0",
            "Success": "true",
            "UniqueId": "BE1234567890_BELgium2_388_2025",
            "ErrorDetails": [],
            "WarningDetails": [
                {
                    "Code": "DUP-202",
                    "Message": "Invoice is already submitted, we are returning the response from the Previously submitted Invoice"
                }
            ]
        }
    ]
}

Response - Failure:

HTTP Status Code - 200

{
    "ErrorDetails": null,
    "Success": "true",
    "DocumentResponses": [
        {
            "DocumentId": "68a470572b3ac34d630779e2",
            "Success": "false",
            "UniqueId": "BE1234567890__388_2025",
            "ErrorDetails": [
                {
                    "ErrorCode": "BR-02",
                    "ErrorMessage": "[BR-02]-An Invoice shall have an Invoice number (BT-1).",
                    "ErrorSource": "CLEARTAX",
                    "Path": "Invoice"
                }
            ],
            "WarningDetails": null
        }
    ]
}

API Validations

Currently there are no known validations for this API.

API Constraints

1. This API needs to be authenticated with a valid user authentication token. If the auth token is not present or is invalid, the API will return HTTP Status Code 401.

2. If the auth token is valid, but the user does not have the authorization to generate an e-invoice for a document, then the API will return HTTP Status Code 403. The user, whose auth token is used, should have an Admin role for the particular TIN used in the request.