Generate E-Invoice for a Document
This API enables the submits the e-invoicing payload for generation of LHDN compliant e-invoices. This is a bulk API which supports submitting an array of documents in one call to LHDN. This API will also share the document through the PEPPOL network if it's enabled for sharing.
Request Method
POST
Request URL
{{HOST}}/einvoice/v1/documents/generate
Request Headers
x-cleartax-auth-token
String
Cannot be empty
Mandatory. User auth token.
x-clear-tin
String
Cannot be empty
Mandatory. TIN 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 TIN 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 parameters for this API.
Request Query Params
dry-run
Boolean
true/false
Default: false
Will only run Validations
einvoice-type
ENUM
SALES, PURCHASE, SALES_B2C
Default: SALES
Request Body
Documents
Array
MinListLength: 1
MaxListLength: 10
Mandatory. List of Documents
Version
String
NA
Mandatory. MY_GENERATE_UBL_2_1_V1
AllowCancelledDocumentsGeneration
Boolean
NA
Optional : If passed true
, will re-generate Cancelled documents if any in the given Documents list.
Documents Object
DocumentData
String
NA
Mandatory. Base64 of the document data shared below
DocumentFormat
ENUM
JSON, XML
Mandatory. Describes the data received is in the JSON Format or in the XML Format.
UniqueIdentifier
String
NA
Mandatory. Identifier provided by the user to distinctly identify the document at their end. Generally formed with concatenation of TIN, Document Number, Document Type, Fiscal Year fields with _
Example: C948329382_INV-101_INV_2024
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"
}
Sample Request
Request Body
{
"Documents": [
{
"DocumentData": "ewogICAgIkludm9pY2VUeXBlQ29kZSI6IHsKICAgICAgICAiVmFsdWUiOiAiMDEiCiAgICB9LAogICAgIkludm9pY2VQZXJpb2QiOiB7CiAgICAgICAgIlN0YXJ0RGF0ZSI6ICIyMDI0LTA2LTAzIiwKICAgICAgICAiRW5kRGF0ZSI6ICIyMDI0LTA2LTAzIiwKICAgICAgICAiRGVzY3JpcHRpb24iOiAiTW9udGhseSIKICAgIH0sCiAgICAiQmlsbGluZ1JlZmVyZW5jZSI6IFsKICAgICAgICB7CiAgICAgICAgICAgICJBZGRpdGlvbmFsRG9jdW1lbnRSZWZlcmVuY2UiOiB7CiAgICAgICAgICAgICAgICAiSWQiOiAiIgogICAgICAgICAgICB9CiAgICAgICAgfQogICAgXSwKICAgICJJc3N1ZURhdGUiOiAiMjAyNC0wNi0wMyIsCiAgICAiSXNzdWVUaW1lIjogIjE4OjMwOjAwIiwKICAgICJEb2N1bWVudEN1cnJlbmN5Q29kZSI6ICJNWVIiLAogICAgIklkIjogIlRFU1QtU0FMRVMtMDAxIiwKICAgICJBY2NvdW50aW5nQ3VzdG9tZXJQYXJ0eSI6IHsKICAgICAgICAiUGFydHkiOiB7CiAgICAgICAgICAgICJDb250YWN0IjogewogICAgICAgICAgICAgICAgIkVsZWN0cm9uaWNNYWlsIjogImluZm9AZ21haWwuY29tIiwKICAgICAgICAgICAgICAgICJUZWxlcGhvbmUiOiAiNjAzMjIzMDA5MCIKICAgICAgICAgICAgfSwKICAgICAgICAgICAgIlBhcnR5SWRlbnRpZmljYXRpb24iOiBbCiAgICAgICAgICAgICAgICB7CiAgICAgICAgICAgICAgICAgICAgIklkIjogewogICAgICAgICAgICAgICAgICAgICAgICAiU2NoZW1lSUQiOiAiVElOIiwKICAgICAgICAgICAgICAgICAgICAgICAgIlZhbHVlIjogIkM1ODk2MjM0MDQwIgogICAgICAgICAgICAgICAgICAgIH0KICAgICAgICAgICAgICAgIH0sCiAgICAgICAgICAgICAgICB7CiAgICAgICAgICAgICAgICAgICAgIklkIjogewogICAgICAgICAgICAgICAgICAgICAgICAiU2NoZW1lSUQiOiAiQlJOIiwKICAgICAgICAgICAgICAgICAgICAgICAgIlZhbHVlIjogIjE5OTUwMTAxMDY2NiIKICAgICAgICAgICAgICAgICAgICB9CiAgICAgICAgICAgICAgICB9LAogICAgICAgICAgICAgICAgewogICAgICAgICAgICAgICAgICAgICJJZCI6IHsKICAgICAgICAgICAgICAgICAgICAgICAgIlNjaGVtZUlEIjogIlNTVCIsCiAgICAgICAgICAgICAgICAgICAgICAgICJWYWx1ZSI6ICJOQSIKICAgICAgICAgICAgICAgICAgICB9CiAgICAgICAgICAgICAgICB9CiAgICAgICAgICAgIF0sCiAgICAgICAgICAgICJQYXJ0eUxlZ2FsRW50aXR5IjogewogICAgICAgICAgICAgICAgIlJlZ2lzdHJhdGlvbk5hbWUiOiAiRGVmbWFjcm8gU29mdHdhcmUgUHZ0IEx0ZCIKICAgICAgICAgICAgfSwKICAgICAgICAgICAgIlBvc3RhbEFkZHJlc3MiOiB7CiAgICAgICAgICAgICAgICAiQWRkcmVzc0xpbmUiOiBbCiAgICAgICAgICAgICAgICAgICAgewogICAgICAgICAgICAgICAgICAgICAgICAiTGluZSI6ICJMZXZlbCAzMyIKICAgICAgICAgICAgICAgICAgICB9LAogICAgICAgICAgICAgICAgICAgIHsKICAgICAgICAgICAgICAgICAgICAgICAgIkxpbmUiOiAiSWxoYW0gVG93ZXIiCiAgICAgICAgICAgICAgICAgICAgfSwKICAgICAgICAgICAgICAgICAgICB7CiAgICAgICAgICAgICAgICAgICAgICAgICJMaW5lIjogIiA4IEphbGFuIEJpbmphaSIKICAgICAgICAgICAgICAgICAgICB9CiAgICAgICAgICAgICAgICBdLAogICAgICAgICAgICAgICAgIkNpdHlOYW1lIjogIiA4IEphbGFuIEJpbmphaSIsCiAgICAgICAgICAgICAgICAiQ291bnRyeSI6IHsKICAgICAgICAgICAgICAgICAgICAiSWRlbnRpZmljYXRpb25Db2RlIjogewogICAgICAgICAgICAgICAgICAgICAgICAiQ291bnRyeUNvZGUiOiAiTVlTIgogICAgICAgICAgICAgICAgICAgIH0KICAgICAgICAgICAgICAgIH0sCiAgICAgICAgICAgICAgICAiQ291bnRyeVN1YmVudGl0eUNvZGUiOiAiMTQiLAogICAgICAgICAgICAgICAgIlBvc3RhbFpvbmUiOiAiNTA0NTAiCiAgICAgICAgICAgIH0KICAgICAgICB9CiAgICB9LAogICAgIkFjY291bnRpbmdTdXBwbGllclBhcnR5IjogewogICAgICAgICJQYXJ0eSI6IHsKICAgICAgICAgICAgIkNvbnRhY3QiOiB7CiAgICAgICAgICAgICAgICAiRWxlY3Ryb25pY01haWwiOiAiZ2VuZXJhbEBwbHVzLmNvbS5teSIsCiAgICAgICAgICAgICAgICAiVGVsZXBob25lIjogIjYwMzIyMzAwOTAiCiAgICAgICAgICAgIH0sCiAgICAgICAgICAgICJJbmR1c3RyeUNsYXNzaWZpY2F0aW9uQ29kZSI6IHsKICAgICAgICAgICAgICAgICJWYWx1ZSI6ICIwMTExMSIsCiAgICAgICAgICAgICAgICAiTmFtZSI6ICJPdGhlciBzZXJ2aWNlIGFjdGl2aXRpZXMgbi5lLmMuIgogICAgICAgICAgICB9LAogICAgICAgICAgICAiUGFydHlJZGVudGlmaWNhdGlvbiI6IFsKICAgICAgICAgICAgICAgIHsKICAgICAgICAgICAgICAgICAgICAiSWQiOiB7CiAgICAgICAgICAgICAgICAgICAgICAgICJTY2hlbWVJRCI6ICJUSU4iLAogICAgICAgICAgICAgICAgICAgICAgICAiVmFsdWUiOiAiQzU4NzQ2NzA4MDgwIgogICAgICAgICAgICAgICAgICAgIH0KICAgICAgICAgICAgICAgIH0sCiAgICAgICAgICAgICAgICB7CiAgICAgICAgICAgICAgICAgICAgIklkIjogewogICAgICAgICAgICAgICAgICAgICAgICAiU2NoZW1lSUQiOiAiQlJOIiwKICAgICAgICAgICAgICAgICAgICAgICAgIlZhbHVlIjogIjIwMjQwMTAyMTEyOCIKICAgICAgICAgICAgICAgICAgICB9CiAgICAgICAgICAgICAgICB9LAogICAgICAgICAgICAgICAgewogICAgICAgICAgICAgICAgICAgICJJZCI6IHsKICAgICAgICAgICAgICAgICAgICAgICAgIlNjaGVtZUlEIjogIlNTVCIsCiAgICAgICAgICAgICAgICAgICAgICAgICJWYWx1ZSI6ICJOQSIKICAgICAgICAgICAgICAgICAgICB9CiAgICAgICAgICAgICAgICB9LAogICAgICAgICAgICAgICAgewogICAgICAgICAgICAgICAgICAgICJJZCI6IHsKICAgICAgICAgICAgICAgICAgICAgICAgIlNjaGVtZUlEIjogIlRUWCIsCiAgICAgICAgICAgICAgICAgICAgICAgICJWYWx1ZSI6ICJOQSIKICAgICAgICAgICAgICAgICAgICB9CiAgICAgICAgICAgICAgICB9CiAgICAgICAgICAgIF0sCiAgICAgICAgICAgICJQYXJ0eUxlZ2FsRW50aXR5IjogewogICAgICAgICAgICAgICAgIlJlZ2lzdHJhdGlvbk5hbWUiOiAiWFlaIgogICAgICAgICAgICB9LAogICAgICAgICAgICAiUG9zdGFsQWRkcmVzcyI6IHsKICAgICAgICAgICAgICAgICJBZGRyZXNzTGluZSI6IFsKICAgICAgICAgICAgICAgICAgICB7CiAgICAgICAgICAgICAgICAgICAgICAgICJMaW5lIjogIk1lbmFyYSBLb3Jwb3JhdCIKICAgICAgICAgICAgICAgICAgICB9LAogICAgICAgICAgICAgICAgICAgIHsKICAgICAgICAgICAgICAgICAgICAgICAgIkxpbmUiOiAiUGVyc2FkYSBQTFVTIgogICAgICAgICAgICAgICAgICAgIH0sCiAgICAgICAgICAgICAgICAgICAgewogICAgICAgICAgICAgICAgICAgICAgICAiTGluZSI6ICJQZXJzaW1wYW5nYW4gQmVydGluZ2thdCBTdWJhbmcgS00xNSIKICAgICAgICAgICAgICAgICAgICB9CiAgICAgICAgICAgICAgICBdLAogICAgICAgICAgICAgICAgIkNpdHlOYW1lIjogIkxlYnVocmF5YSBCYXJ1IExlbWJhaCBLbGFuZyIsCiAgICAgICAgICAgICAgICAiQ291bnRyeSI6IHsKICAgICAgICAgICAgICAgICAgICAiSWRlbnRpZmljYXRpb25Db2RlIjogewogICAgICAgICAgICAgICAgICAgICAgICAiQ291bnRyeUNvZGUiOiAiTVlTIgogICAgICAgICAgICAgICAgICAgIH0KICAgICAgICAgICAgICAgIH0sCiAgICAgICAgICAgICAgICAiQ291bnRyeVN1YmVudGl0eUNvZGUiOiAiMTAiLAogICAgICAgICAgICAgICAgIlBvc3RhbFpvbmUiOiAiNDczMDEiCiAgICAgICAgICAgIH0KICAgICAgICB9CiAgICB9LAogICAgIkRlbGl2ZXJ5IjogewogICAgICAgICJEZWxpdmVyeVBhcnR5IjogewogICAgICAgICAgICAiQ29udGFjdCI6IHsKICAgICAgICAgICAgICAgICJFbGVjdHJvbmljTWFpbCI6ICJpbmZvQG9saXZlc3RvdWNoLmNvbSIsCiAgICAgICAgICAgICAgICAiVGVsZXBob25lIjogIjYwMzIyMzAwOTAiCiAgICAgICAgICAgIH0sCiAgICAgICAgICAgICJQYXJ0eUlkZW50aWZpY2F0aW9uIjogWwogICAgICAgICAgICAgICAgewogICAgICAgICAgICAgICAgICAgICJJZCI6IHsKICAgICAgICAgICAgICAgICAgICAgICAgIlNjaGVtZUlEIjogIlRJTiIsCiAgICAgICAgICAgICAgICAgICAgICAgICJWYWx1ZSI6ICJDNTg5NjIzNDA0MCIKICAgICAgICAgICAgICAgICAgICB9CiAgICAgICAgICAgICAgICB9LAogICAgICAgICAgICAgICAgewogICAgICAgICAgICAgICAgICAgICJJZCI6IHsKICAgICAgICAgICAgICAgICAgICAgICAgIlNjaGVtZUlEIjogIkJSTiIsCiAgICAgICAgICAgICAgICAgICAgICAgICJWYWx1ZSI6ICIxOTk1MDEwMTA2NjYiCiAgICAgICAgICAgICAgICAgICAgfQogICAgICAgICAgICAgICAgfSwKICAgICAgICAgICAgICAgIHsKICAgICAgICAgICAgICAgICAgICAiSWQiOiB7CiAgICAgICAgICAgICAgICAgICAgICAgICJTY2hlbWVJRCI6ICJTU1QiLAogICAgICAgICAgICAgICAgICAgICAgICAiVmFsdWUiOiAiTkEiCiAgICAgICAgICAgICAgICAgICAgfQogICAgICAgICAgICAgICAgfQogICAgICAgICAgICBdLAogICAgICAgICAgICAiUGFydHlMZWdhbEVudGl0eSI6IHsKICAgICAgICAgICAgICAgICJSZWdpc3RyYXRpb25OYW1lIjogIkNBTVBCRUxMIFNPVVAgU09VVEhFQVNUIEFTSUEgU0ROIEJIRCIKICAgICAgICAgICAgfSwKICAgICAgICAgICAgIlBvc3RhbEFkZHJlc3MiOiB7CiAgICAgICAgICAgICAgICAiQWRkcmVzc0xpbmUiOiBbCiAgICAgICAgICAgICAgICAgICAgewogICAgICAgICAgICAgICAgICAgICAgICAiTGluZSI6ICJMZXZlbCAzMyIKICAgICAgICAgICAgICAgICAgICB9LAogICAgICAgICAgICAgICAgICAgIHsKICAgICAgICAgICAgICAgICAgICAgICAgIkxpbmUiOiAiSWxoYW0gVG93ZXIiCiAgICAgICAgICAgICAgICAgICAgfSwKICAgICAgICAgICAgICAgICAgICB7CiAgICAgICAgICAgICAgICAgICAgICAgICJMaW5lIjogIiA4IEphbGFuIEJpbmphaSIKICAgICAgICAgICAgICAgICAgICB9CiAgICAgICAgICAgICAgICBdLAogICAgICAgICAgICAgICAgIkNpdHlOYW1lIjogIiA4IEphbGFuIEJpbmphaSIsCiAgICAgICAgICAgICAgICAiQ291bnRyeSI6IHsKICAgICAgICAgICAgICAgICAgICAiSWRlbnRpZmljYXRpb25Db2RlIjogewogICAgICAgICAgICAgICAgICAgICAgICAiQ291bnRyeUNvZGUiOiAiTVlTIgogICAgICAgICAgICAgICAgICAgIH0KICAgICAgICAgICAgICAgIH0sCiAgICAgICAgICAgICAgICAiQ291bnRyeVN1YmVudGl0eUNvZGUiOiAiMTQiLAogICAgICAgICAgICAgICAgIlBvc3RhbFpvbmUiOiAiNTA0NTAiCiAgICAgICAgICAgIH0KICAgICAgICB9CiAgICB9LAogICAgIkludm9pY2VMaW5lIjogWwogICAgICAgIHsKICAgICAgICAgICAgIklkIjogIjEiLAogICAgICAgICAgICAiSW52b2ljZWRRdWFudGl0eSI6IHsKICAgICAgICAgICAgICAgICJRdWFudGl0eSI6IDEsCiAgICAgICAgICAgICAgICAiVW5pdENvZGUiOiAiS0dTIgogICAgICAgICAgICB9LAogICAgICAgICAgICAiSXRlbSI6IHsKICAgICAgICAgICAgICAgICJDb21tb2RpdHlDbGFzc2lmaWNhdGlvbiI6IFsKICAgICAgICAgICAgICAgICAgICB7CiAgICAgICAgICAgICAgICAgICAgICAgICJJdGVtQ2xhc3NpZmljYXRpb25Db2RlIjogewogICAgICAgICAgICAgICAgICAgICAgICAgICAgIkxpc3RJRCI6ICJDTEFTUyIsCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAiVmFsdWUiOiAiMDExIgogICAgICAgICAgICAgICAgICAgICAgICB9CiAgICAgICAgICAgICAgICAgICAgfQogICAgICAgICAgICAgICAgXSwKICAgICAgICAgICAgICAgICJEZXNjcmlwdGlvbiI6ICJSZXBhaXIgYW5kIG1haW50ZW5hbmNlIiwKICAgICAgICAgICAgICAgICJPcmlnaW5Db3VudHJ5IjogewogICAgICAgICAgICAgICAgICAgICJJZGVudGlmaWNhdGlvbkNvZGUiOiB7CiAgICAgICAgICAgICAgICAgICAgICAgICJDb3VudHJ5Q29kZSI6ICJNWVMiCiAgICAgICAgICAgICAgICAgICAgfQogICAgICAgICAgICAgICAgfQogICAgICAgICAgICB9LAogICAgICAgICAgICAiSXRlbVByaWNlRXh0ZW5zaW9uIjogewogICAgICAgICAgICAgICAgIkFtb3VudCI6IHsKICAgICAgICAgICAgICAgICAgICAiQ3VycmVuY3lJRCI6ICJNWVIiLAogICAgICAgICAgICAgICAgICAgICJWYWx1ZSI6ICIxMjAwMDAiCiAgICAgICAgICAgICAgICB9CiAgICAgICAgICAgIH0sCiAgICAgICAgICAgICJBbGxvd2FuY2VDaGFyZ2UiOiBbCiAgICAgICAgICAgICAgICB7CiAgICAgICAgICAgICAgICAgICAgIkNoYXJnZUluZGljYXRvciI6IGZhbHNlLAogICAgICAgICAgICAgICAgICAgICJNdWx0aXBsaWVyRmFjdG9yTnVtZXJpYyI6IDAuMTAsCiAgICAgICAgICAgICAgICAgICAgIkFsbG93YW5jZUNoYXJnZVJlYXNvbiI6ICJTYW1wbGUiLAogICAgICAgICAgICAgICAgICAgICJBbW91bnQiOiB7CiAgICAgICAgICAgICAgICAgICAgICAgICJDdXJyZW5jeUlEIjogIk1ZUiIsCiAgICAgICAgICAgICAgICAgICAgICAgICJWYWx1ZSI6ICIxMjAwMC4wMCIKICAgICAgICAgICAgICAgICAgICB9CiAgICAgICAgICAgICAgICB9LAogICAgICAgICAgICAgICAgewogICAgICAgICAgICAgICAgICAgICJDaGFyZ2VJbmRpY2F0b3IiOiB0cnVlLAogICAgICAgICAgICAgICAgICAgICJNdWx0aXBsaWVyRmFjdG9yTnVtZXJpYyI6IDAsCiAgICAgICAgICAgICAgICAgICAgIkFsbG93YW5jZUNoYXJnZVJlYXNvbiI6ICJTYW1wbGUiLAogICAgICAgICAgICAgICAgICAgICJBbW91bnQiOiB7CiAgICAgICAgICAgICAgICAgICAgICAgICJDdXJyZW5jeUlEIjogIk1ZUiIsCiAgICAgICAgICAgICAgICAgICAgICAgICJWYWx1ZSI6ICIwLjAwIgogICAgICAgICAgICAgICAgICAgIH0KICAgICAgICAgICAgICAgIH0KICAgICAgICAgICAgXSwKICAgICAgICAgICAgIlByaWNlIjogewogICAgICAgICAgICAgICAgIlByaWNlQW1vdW50IjogewogICAgICAgICAgICAgICAgICAgICJDdXJyZW5jeUlEIjogIk1ZUiIsCiAgICAgICAgICAgICAgICAgICAgIlZhbHVlIjogIjEwODAwMC4wMCIKICAgICAgICAgICAgICAgIH0KICAgICAgICAgICAgfSwKICAgICAgICAgICAgIkxpbmVFeHRlbnNpb25BbW91bnQiOiB7CiAgICAgICAgICAgICAgICAiQ3VycmVuY3lJRCI6ICJNWVIiLAogICAgICAgICAgICAgICAgIlZhbHVlIjogIjEwODAwMCIKICAgICAgICAgICAgfSwKICAgICAgICAgICAgIlRheFRvdGFsIjogewogICAgICAgICAgICAgICAgIlRheEFtb3VudCI6IHsKICAgICAgICAgICAgICAgICAgICAiQ3VycmVuY3lJRCI6ICJNWVIiLAogICAgICAgICAgICAgICAgICAgICJWYWx1ZSI6ICI4NjQwLjAwIgogICAgICAgICAgICAgICAgfSwKICAgICAgICAgICAgICAgICJUYXhTdWJ0b3RhbCI6IFsKICAgICAgICAgICAgICAgICAgICB7CiAgICAgICAgICAgICAgICAgICAgICAgICJUYXhBbW91bnQiOiB7CiAgICAgICAgICAgICAgICAgICAgICAgICAgICAiQ3VycmVuY3lJRCI6ICJNWVIiLAogICAgICAgICAgICAgICAgICAgICAgICAgICAgIlZhbHVlIjogIjg2NDAuMDAiCiAgICAgICAgICAgICAgICAgICAgICAgIH0sCiAgICAgICAgICAgICAgICAgICAgICAgICJUYXhhYmxlQW1vdW50IjogewogICAgICAgICAgICAgICAgICAgICAgICAgICAgIkN1cnJlbmN5SUQiOiAiTVlSIiwKICAgICAgICAgICAgICAgICAgICAgICAgICAgICJWYWx1ZSI6ICIxMDgwMDAuMDAiCiAgICAgICAgICAgICAgICAgICAgICAgIH0sCiAgICAgICAgICAgICAgICAgICAgICAgICJUYXhDYXRlZ29yeSI6IHsKICAgICAgICAgICAgICAgICAgICAgICAgICAgICJJZCI6ICIwMSIKICAgICAgICAgICAgICAgICAgICAgICAgfQogICAgICAgICAgICAgICAgICAgIH0KICAgICAgICAgICAgICAgIF0KICAgICAgICAgICAgfQogICAgICAgIH0KICAgIF0sCiAgICAiQWxsb3dhbmNlQ2hhcmdlIjogWwogICAgICAgIHsKICAgICAgICAgICAgIkNoYXJnZUluZGljYXRvciI6IGZhbHNlLAogICAgICAgICAgICAiQWxsb3dhbmNlQ2hhcmdlUmVhc29uIjogIlNhbXBsZSBEZXNjcmlwdGlvbiIsCiAgICAgICAgICAgICJBbW91bnQiOiB7CiAgICAgICAgICAgICAgICAiVmFsdWUiOiA4MDAwLAogICAgICAgICAgICAgICAgIkN1cnJlbmN5SUQiOiAiTVlSIgogICAgICAgICAgICB9CiAgICAgICAgfSwKICAgICAgICB7CiAgICAgICAgICAgICJDaGFyZ2VJbmRpY2F0b3IiOiB0cnVlLAogICAgICAgICAgICAiQWxsb3dhbmNlQ2hhcmdlUmVhc29uIjogIlNlcnZpY2UgY2hhcmdlIiwKICAgICAgICAgICAgIkFtb3VudCI6IHsKICAgICAgICAgICAgICAgICJWYWx1ZSI6IDAsCiAgICAgICAgICAgICAgICAiQ3VycmVuY3lJRCI6ICJNWVIiCiAgICAgICAgICAgIH0KICAgICAgICB9CiAgICBdLAogICAgIlRheFRvdGFsIjogWwogICAgICAgIHsKICAgICAgICAgICAgIlRheEFtb3VudCI6IHsKICAgICAgICAgICAgICAgICJDdXJyZW5jeUlEIjogIk1ZUiIsCiAgICAgICAgICAgICAgICAiVmFsdWUiOiAiMTAwMDAuMDAiCiAgICAgICAgICAgIH0sCiAgICAgICAgICAgICJUYXhTdWJ0b3RhbCI6IFsKICAgICAgICAgICAgICAgIHsKICAgICAgICAgICAgICAgICAgICAiVGF4YWJsZUFtb3VudCI6IHsKICAgICAgICAgICAgICAgICAgICAgICAgIkN1cnJlbmN5SUQiOiAiTVlSIiwKICAgICAgICAgICAgICAgICAgICAgICAgIlZhbHVlIjogIjEwMDAwMC4wMCIKICAgICAgICAgICAgICAgICAgICB9LAogICAgICAgICAgICAgICAgICAgICJUYXhBbW91bnQiOiB7CiAgICAgICAgICAgICAgICAgICAgICAgICJDdXJyZW5jeUlEIjogIk1ZUiIsCiAgICAgICAgICAgICAgICAgICAgICAgICJWYWx1ZSI6ICIxMDAwMC4wMCIKICAgICAgICAgICAgICAgICAgICB9LAogICAgICAgICAgICAgICAgICAgICJUYXhDYXRlZ29yeSI6IHsKICAgICAgICAgICAgICAgICAgICAgICAgIklkIjogIjAxIgogICAgICAgICAgICAgICAgICAgIH0KICAgICAgICAgICAgICAgIH0KICAgICAgICAgICAgXQogICAgICAgIH0KICAgIF0sCiAgICAiTGVnYWxNb25ldGFyeVRvdGFsIjogewogICAgICAgICJMaW5lRXh0ZW5zaW9uQW1vdW50IjogewogICAgICAgICAgICAiQ3VycmVuY3lJRCI6ICJNWVIiLAogICAgICAgICAgICAiVmFsdWUiOiAiMTA4MDAwLjAwIgogICAgICAgIH0sCiAgICAgICAgIkFsbG93YW5jZVRvdGFsQW1vdW50IjogewogICAgICAgICAgICAiQ3VycmVuY3lJRCI6ICJNWVIiLAogICAgICAgICAgICAiVmFsdWUiOiAiODAwMC4wMCIKICAgICAgICB9LAogICAgICAgICJDaGFyZ2VUb3RhbEFtb3VudCI6IHsKICAgICAgICAgICAgIkN1cnJlbmN5SUQiOiAiTVlSIiwKICAgICAgICAgICAgIlZhbHVlIjogIjAuMDAiCiAgICAgICAgfSwKICAgICAgICAiVGF4RXhjbHVzaXZlQW1vdW50IjogewogICAgICAgICAgICAiQ3VycmVuY3lJRCI6ICJNWVIiLAogICAgICAgICAgICAiVmFsdWUiOiAiMTAwMDAwLjAwIgogICAgICAgIH0sCiAgICAgICAgIlRheEluY2x1c2l2ZUFtb3VudCI6IHsKICAgICAgICAgICAgIkN1cnJlbmN5SUQiOiAiTVlSIiwKICAgICAgICAgICAgIlZhbHVlIjogIjExMDAwMC4wMCIKICAgICAgICB9LAogICAgICAgICJQcmVwYWlkQW1vdW50IjogewogICAgICAgICAgICAiQ3VycmVuY3lJRCI6ICJNWVIiLAogICAgICAgICAgICAiVmFsdWUiOiAiMC4wMCIKICAgICAgICB9LAogICAgICAgICJQYXlhYmxlQW1vdW50IjogewogICAgICAgICAgICAiQ3VycmVuY3lJRCI6ICJNWVIiLAogICAgICAgICAgICAiVmFsdWUiOiAiMTEwMDAwLjAwIgogICAgICAgIH0sCiAgICAgICAgIlBheWFibGVSb3VuZGluZ0Ftb3VudCI6IHsKICAgICAgICAgICAgIlZhbHVlIjogIjAuMDAiCiAgICAgICAgfQogICAgfSwKICAgICJQYXltZW50TWVhbnMiOiB7CiAgICAgICAgIlBheW1lbnRNZWFuc0NvZGUiOiAiNCIKICAgIH0sCiAgICAiUGF5bWVudFRlcm1zIjogewogICAgICAgICJOb3RlIjogIlBheW1lbnQgTWV0aG9kIGlzIGNhc2giCiAgICB9Cn0=",
"DocumentFormat": "JSON",
"UniqueIdentifier": "C58746708080_TEST-SALES-001_01_2024",
"CustomFields": {
"Internal Number": "INV00001234561687"
},
"version": "MY_GENERATE_UBL_2_1_V1"
}
],
"AllowCancelledDocumentsGeneration" : "true"
}
Document Data - Sample JSON and XML
{
"InvoiceTypeCode": {
"Value": "01"
},
"InvoicePeriod": {
"StartDate": "2024-07-01",
"EndDate": "2024-07-30",
"Description": "Monthly"
},
"BillingReference": [
{
"AdditionalDocumentReference": {
"Id": ""
}
}
],
"IssueDate": "2025-07-01",
"IssueTime": "11:20:00",
"DocumentCurrencyCode": "MYR",
"Id": "TEST-CT-00001",
"AccountingCustomerParty": {
"Party": {
"Contact": {
"ElectronicMail": "[email protected]",
"Telephone": "+6032230090"
},
"PartyIdentification": [
{
"Id": {
"SchemeID": "TIN",
"Value": "C4853558030"
}
},
{
"Id": {
"SchemeID": "BRN",
"Value": "198801004020"
}
},
{
"Id": {
"SchemeID": "SST",
"Value": "W10-1809-32000158"
}
},
{
"Id": {
"SchemeID": "TTX",
"Value": "NA"
}
}
],
"PartyLegalEntity": {
"RegistrationName": "PACIFIC OILS & FATS INDUSTRIES SDN. BHD."
},
"PostalAddress": {
"AddressLine": [
{
"Line": "No 8, Jalan Besi Utama, Batu 24, Kelapa Sawit"
},
{
"Line": "line2"
},
{
"Line": "line3"
}
],
"CityName": "KULAI",
"Country": {
"IdentificationCode": {
"CountryCode": "MYS"
}
},
"CountrySubentityCode": "01",
"PostalZone": "81030"
}
}
},
"AccountingSupplierParty": {
"Party": {
"Contact": {
"ElectronicMail": "[email protected]",
"Telephone": "+6012345678"
},
"IndustryClassificationCode": {
"Value": "00000",
"Name": "NOT APPLICABLE"
},
"PartyIdentification": [
{
"Id": {
"SchemeID": "TIN",
"Value": "C58746708080"
}
},
{
"Id": {
"SchemeID": "BRN",
"Value": "202401021128"
}
},
{
"Id": {
"SchemeID": "SST",
"Value": "NA"
}
},
{
"Id": {
"SchemeID": "TTX",
"Value": "NA"
}
}
],
"PartyLegalEntity": {
"RegistrationName": "Defmacro Software Pvt Ltd"
},
"PostalAddress": {
"AddressLine": [
{
"Line": "PLO 2244 Jln Suasa,"
},
{
"Line": "Kaw. Perind. Pasir Gudang"
},
{
"Line": "KL"
}
],
"CityName": "Pasir Gudang",
"Country": {
"IdentificationCode": {
"CountryCode": "MYS"
}
},
"CountrySubentityCode": "01",
"PostalZone": "81750"
}
}
},
"Delivery": {
"DeliveryParty": {
"PartyIdentification": [
{
"Id": {
"SchemeID": "TIN",
"Value": "C5896234040"
}
},
{
"Id": {
"SchemeID": "BRN",
"Value": "199501010666"
}
},
{
"Id": {
"SchemeID": "SST",
"Value": "NA"
}
}
],
"PartyLegalEntity": {
"RegistrationName": "CAMPBELL SOUP SOUTHEAST ASIA SDN BHD"
},
"PostalAddress": {
"AddressLine": [
{
"Line": "Level 33"
},
{
"Line": "Ilham Tower"
},
{
"Line": " 8 Jalan Binjai"
}
],
"CityName": " 8 Jalan Binjai",
"Country": {
"IdentificationCode": {
"CountryCode": "MYS"
}
},
"CountrySubentityCode": "14",
"PostalZone": "50450"
}
}
},
"InvoiceLine": [
{
"Id": 1,
"InvoicedQuantity": {
"Quantity": 100000,
"UnitCode": "H87"
},
"Item": {
"AdditionalItemProperty": [
{
"Name": "Field1",
"Value": "A1"
},
{
"Name": "Field2",
"Value": "B1"
}
],
"CommodityClassification": [
{
"ItemClassificationCode": {
"ListID": "CLASS",
"Value": "022"
}
}
],
"ProductTariffCode": {
"ItemClassificationCode": {
"Value": "9800.0010"
}
},
"Description": "test description",
"OriginCountry": {
"IdentificationCode": {
"CountryCode": "MYS"
}
}
},
"ItemPriceExtension": {
"Amount": {
"CurrencyID": "MYR",
"Value": 50000000
}
},
"AllowanceCharge": [
{
"ChargeIndicator": "false",
"MultiplierFactorNumeric": 0,
"AllowanceChargeReason": "NA",
"Amount": {
"CurrencyID": "MYR",
"Value": 2000
}
},
{
"ChargeIndicator": "true",
"MultiplierFactorNumeric": 0,
"AllowanceChargeReason": "NA",
"Amount": {
"CurrencyID": "MYR",
"Value": 1000
}
}
],
"Price": {
"PriceAmount": {
"CurrencyID": "MYR",
"Value": 500
}
},
"LineExtensionAmount": {
"CurrencyID": "MYR",
"Value": 49999000
},
"TaxTotal": {
"TaxAmount": {
"CurrencyID": "MYR",
"Value": 3999920
},
"TaxSubtotal": [
{
"TaxAmount": {
"CurrencyID": "MYR",
"Value": 3999920
},
"TaxableAmount": {
"CurrencyID": "MYR",
"Value": 49999000
},
"TaxCategory": {
"Id": "01",
"TaxExemptionReason": ""
},
"Percent": "0.08"
}
]
}
}
],
"AllowanceCharge": [
{
"ChargeIndicator": "false",
"MultiplierFactorNumeric": 0,
"AllowanceChargeReason": "In store discount",
"Amount": {
"CurrencyID": "MYR",
"Value": 4000
}
},
{
"ChargeIndicator": "true",
"MultiplierFactorNumeric": 0,
"AllowanceChargeReason": "Convenience fee",
"Amount": {
"CurrencyID": "MYR",
"Value": 4000
}
}
],
"PrepaidPayment": {
"Id": "Clear-02",
"PaidAmount": {
"CurrencyID": "MYR",
"Value": "1500000"
},
"PaidDate": "2024-07-28",
"PaidTime": "13:00:00"
},
"TaxTotal": [
{
"TaxAmount": {
"CurrencyID": "MYR",
"Value": 3999920
},
"TaxableAmount": {
"CurrencyID": "MYR",
"Value": 49999000
},
"TaxSubtotal": [
{
"TaxAmount": {
"CurrencyID": "MYR",
"Value": 3999920
},
"TaxableAmount": {
"CurrencyID": "MYR",
"Value": 49999000
},
"TaxCategory": {
"Id": "01",
"TaxExemptionReason": ""
}
}
]
}
],
"LegalMonetaryTotal": {
"LineExtensionAmount": {
"CurrencyID": "MYR",
"Value": 49999000
},
"AllowanceTotalAmount": {
"CurrencyID": "MYR",
"Value": 4000
},
"ChargeTotalAmount": {
"CurrencyID": "MYR",
"Value": 4000
},
"TaxExclusiveAmount": {
"CurrencyID": "MYR",
"Value": 49999000
},
"TaxInclusiveAmount": {
"CurrencyID": "MYR",
"Value": 53998920
},
"PrepaidAmount": {
"CurrencyID": "MYR",
"Value": 1500000
},
"PayableAmount": {
"CurrencyID": "MYR",
"Value": 52498920
},
"PayableRoundingAmount": {
"CurrencyID": "MYR",
"Value": 0
}
},
"PaymentMeans": {
"PaymentMeansCode": "04",
"PayeeFinancialAccount": {
"Id": "1234567890123"
}
},
"PaymentTerms": {
"Note": "Payment Method is CARD"
},
"TaxExchangeRate": {
"CalculationRate": "1"
},
"AdditionalDocumentReference": [
{
"Id": "E12345678912",
"DocumentType": "CustomsImportForm"
},
{
"Id": "FTA",
"DocumentDescription": "",
"DocumentType": "FreeTradeAgreement"
},
{
"Id": "E12345678912",
"DocumentType": "K2"
},
{
"Id": "CIF"
}
]
}
Response Status Codes
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
429
Too many requests
Response Schema
Success
Boolean
true/false
Mandatory. Indicates the request was successful or not
DocumentResponses
Array
NA
NA
ErrorDetails
Array<ErrorDetail>
Error details
Optional.
Error list from ClearTax
Document Details Object
DocumentId
String
NA
Unique document id generated in database
UniqueId
String
NA
Mandatory. Same uniqueId as shared in the request
UniqueIdentifier
String
NA
Unique identifier provided in the input request.
Success
Boolean
true/false
Indicates, if the request for this document was successfully processed or not
Uuid
Boolean
true/false
Mandatory. Cleartax reference Id used for further actions. Should be persisted in ERP
ErrorDetails
Array<ErrorDetail>
Error details
Optional.
Error list from ClearTax/LHDN
WarningDetails
Array<ErrorDetail>
Warning details
Optional. Warning list from ClearTax
Sample Response (Success)
HTTP Status Code
200
Response Body
{
"ErrorDetails": null,
"Success": true,
"DocumentResponses": [
{
"DocumentId": "665f28c2f626dc2cac32abea",
"Success": "true",
"UniqueId": "C58746708080_TEST-SALES-001_01_2024",
"Uuid": "Y4K7SPNCBE8FAQSCWDEEVHZH10",
"InternalId": null,
"ErrorDetails": [],
"WarningDetails": null,
"UniqueIdentifier": null
}
]
}
Sample Response (Error)
HTTP Status Code: 400
Response Body
{
"ErrorDetails": null,
"Success": true,
"DocumentResponses": [
{
"DocumentId": null,
"Success": false,
"UniqueId": "C10709273050_20240410035_01_2024",
"Uuid": null,
"InternalId": null,
"ErrorDetails": [
{
"ErrorCode": "ERR-10001",
"ErrorMessage": "Supplier TIN null is not matching the TIN present in the account",
"ErrorSource": "CLEARTAX"
}
],
"WarningDetails": [
{
"Code": null,
"Message": null
}
]
}
]
}
API Validations
Currently there are no known validations.
API Constraints
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.
Each customer is allowed to send a limited number of requests per minute to prevent server overload. If the limit is exceeded, the server will respond with a 429 Too Many Requests status code.
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.
Rate Limit: The below rate limits are in line with those applied by LHDN.
Production - 100 API calls per minute with a burst capacity of 10 API calls
Sandbox - 10 API calls per minute with a burst capacity of 2 API calls
Last updated
Was this helpful?