# 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             | <p>Optional. Unique request ID.</p><p>Used for Debugging Support Issues</p>                     |
| Content-Type          | String    | application/json                               | application/json                                                                                |

### Request Path Params

There are no path params for this API.&#x20;

### 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     | <p>MinListLength: 1</p><p>MaxListLength: 10</p> | 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                | <p>Mandatory. Base64 of the document data in JSON format. <br><a href="../resources-and-masters/e-invoice-object">Details</a>. </p> |
| DocumentFormat | ENUM      | JSON              | Mandatory. Describes the data received is in the JSON Format                                                                        |
| CustomFields   | Object    | NA                | <p>Map of Custom fields with key-value pair eg : ( {<br>“Internal Number” : “INV000012”</p><p>})</p>                                |

**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:

```json
{
    "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                                |
| 404              | If Authentication token is not provided.                                       |
| 406              | Indicates failure in parsing of payload, e.g. due to invalid value for a field |
| 5XX              | Internal exception                                                             |

### Response Schema

| Parameter         | Data Type | Field Validations | Description                                                              |
| ----------------- | --------- | ----------------- | ------------------------------------------------------------------------ |
| Success           | Boolean   | true/false        | Always present. Indicates the request was successful or not              |
| DocumentResponses | Array     | -                 | List of document response objects corresponding to documents in request. |

#### Document Details Object

| Parameter      | Data Type             | Field Validations                            | Description                                                                          |
| -------------- | --------------------- | -------------------------------------------- | ------------------------------------------------------------------------------------ |
| DocumentId     | String                | <p>Can be "null" in Negative cases. <br></p> | <p>Unique document ID, generated by database.<br>To be used in Status Check API.</p> |
| UniqueId       | String                | <p><br>-</p>                                 | 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                                | <p>Optional.</p><p>Error list from ClearTax</p>                                      |
| WarningDetails | Array\<WarningDetail> | Warning details                              | <p>Optional.<br>Warning list from ClearTax</p>                                       |

**Error Details Object**

| Parameter    | Data Type | Field Validations | Description                                                                                                      |
| ------------ | --------- | ----------------- | ---------------------------------------------------------------------------------------------------------------- |
| ErrorCode    | String    | Cannot be null    | A code to identify the error. Error codes are published below.                                                   |
| ErrorMessage | String    | Cannot be null    | Human readable error message.                                                                                    |
| ErrorSource  | String    | CLEARTAX          | Source of the error.                                                                                             |
| Path         | String    | -                 | <p>If it is a validation error of a request data, it will point to the request data field.<br>Example below.</p> |

**Warning Details Object**

| Parameter | Data Type | Field Validations | Description                     |
| --------- | --------- | ----------------- | ------------------------------- |
| Code      | String    | Cannot be null    | A code to identify the warning. |
| Message   | String    | Cannot be null    | Human readable warning message. |

### Sample Request and Response

#### Request&#x20;

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

[Sample JSON(Decoded)](https://gist.github.com/shreyash-rai12/c8c017807a51f5178c2344328a767ff1)

**Response - Success:**

**HTTP Status Code - 200**

```json
{
    "ErrorDetails": null,
    "Success": "true",
    "DocumentResponses": [
        {
            "DocumentId": "68989ef23f1e05651d5a7271",
            "Success": "true",
            "UniqueId": "BE1234567890_INV-AUG-002_388_2025",
            "ErrorDetails": [],
            "WarningDetails": null
        }
    ]
}
```

**Response - Failure:**

**HTTP Status Code - 200**

{% tabs %}
{% tab title="Error - 1" %}

```json
{
    "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
        }
    ]
}
```

{% endtab %}

{% tab title="Error - 2" %}

```json
{
    "ErrorDetails": null,
    "Success": "true",
    "DocumentResponses": [
        {
            "DocumentId": "689c5712eaeedb6b81893deb",
            "Success": "false",
            "UniqueId": "BE1234567890_INV-001_388_2025",
            "ErrorDetails": [],
            "WarningDetails": [
                {
                    "Code": "DUP-202",
                    "Message": "Invoice is already submitted, we are returning the response from the Previously submitted Invoice"
                }
            ]
        }
    ]
}
```

{% endtab %}

{% tab title="Error - 3" %}

```json
{
    "ErrorDetails": null,
    "Success": "true",
    "DocumentResponses": [
        {
            "DocumentId": null,
            "Success": "false",
            "UniqueId": "BE0120240101_BELgium7_388_2025",
            "ErrorDetails": [
                {
                    "ErrorCode": "ERR-10001",
                    "ErrorMessage": "Supplier VAT \"BE0120240101\" is not matching the VAT present in the account",
                    "ErrorSource": "CLEARTAX",
                    "Path": null
                }
            ],
            "WarningDetails": null
        }
    ]
}
```

{% endtab %}
{% endtabs %}

**Response - Failure:**

**HTTP Status Code - 401**

If the value provided for the Authentication token is wrong. &#x20;

```json
{
    "ErrorDetails": [
        {
            "ErrorCode": "401",
            "ErrorMessage": "Unauthorized",
            "ErrorSource": "CLEARTAX",
            "Path": null
        }
    ]
}
```

**Response - Failure:**

**HTTP Status Code - 403**

If the value provided for the VAT is wrong.&#x20;

```json
{
    "ErrorDetails": [
        {
            "ErrorCode": "403",
            "ErrorMessage": "FORBIDDEN",
            "ErrorSource": "CLEARTAX",
            "Path": 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.