# Upload E-Invoice Upload E-Invoice API is used for validation & persistence of Invoice Data with CT, additional actions on the Invoice can be done later using documentId. Particularly useful for B2C Invoice Flow, where Customer Details might not be available for E-Invoice Generation or the Invoice is to be consolidated. ### Request Method POST ### Request URL ``` {{HOST}}/einvoice/v1/documents/upload ``` ### Request Headers | Parameter | Data Type | Field Validations | Description | | --------------------- | --------- | ---------------------------------------------- | ----------------------------------------------------------------------------------------------- | | 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 paramaters for this API. ### Request Query Params | Parameter | Data Type | Field Validations | Description | | ------------- | --------- | --------------------------- | ----------------------------------------------------------------------------------------------- | | einvoice-type | ENUM | SALES, PURCHASE, SALES\_B2C |

Mandatory. API is available only for SALES\_B2C

Disabled for other E-Invoice Types

| ### Request Body | Parameter | Data Type | Field Validations | Description | | --------- | --------- | ----------------------------------------------- | -------------------------------------- | | Documents | Array |

MinListLength: 1

MaxListLength: 10

| Mandatory. List of Documents | | Version | String |


| Mandatory. MY\_GENERATE\_UBL\_2\_1\_V1 | #### Documents Object | Parameter | Data Type | Field Validations | Description | | ---------------- | --------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | DocumentData | String | NA | Mandatory. Base64 of the document data shared below | | DocumentFormat | ENUM | JSON | Mandatory. Describes the data received is in the JSON Format | | UniqueIdentifier | String | NA |

Mandatory. Unique identifier 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”

})

| {% hint style="info" %} DocumentData object is similar to the Generate E-Invoice Request Body. AccountingCustomerParty, Delivery Details are optional for SALES B2C Documents. If present, the Details are validated as per LHDN validations. {% endhint %} ### Sample Request Request Body ```json { "Documents": [ { "DocumentData": "ewogICAgIkludm9pY2VUeXBlQ29kZSI6IHsKICAgICAgICAiVmFsdWUiOiAiMDEiCiAgICB9LAogICAgIklzc3VlRGF0ZSI6ICIyMDI0LTA2LTAzIiwKICAgICJJc3N1ZVRpbWUiOiAiMTg6MzA6MDAiLAogICAgIkRvY3VtZW50Q3VycmVuY3lDb2RlIjogIk1ZUiIsCiAgICAiSWQiOiAiVEVTVC1TQUxFUy0wMDQiLAogICAgIkFjY291bnRpbmdTdXBwbGllclBhcnR5IjogewogICAgICAgICJQYXJ0eSI6IHsKICAgICAgICAgICAgIkNvbnRhY3QiOiB7CiAgICAgICAgICAgICAgICAiRWxlY3Ryb25pY01haWwiOiAiZ2VuZXJhbEBwbHVzLmNvbS5teSIsCiAgICAgICAgICAgICAgICAiVGVsZXBob25lIjogIjYwMzIyMzAwOTAiCiAgICAgICAgICAgIH0sCiAgICAgICAgICAgICJJbmR1c3RyeUNsYXNzaWZpY2F0aW9uQ29kZSI6IHsKICAgICAgICAgICAgICAgICJWYWx1ZSI6ICIwMTExMSIsCiAgICAgICAgICAgICAgICAiTmFtZSI6ICJPdGhlciBzZXJ2aWNlIGFjdGl2aXRpZXMgbi5lLmMuIgogICAgICAgICAgICB9LAogICAgICAgICAgICAiUGFydHlJZGVudGlmaWNhdGlvbiI6IFsKICAgICAgICAgICAgICAgIHsKICAgICAgICAgICAgICAgICAgICAiSWQiOiB7CiAgICAgICAgICAgICAgICAgICAgICAgICJTY2hlbWVJRCI6ICJUSU4iLAogICAgICAgICAgICAgICAgICAgICAgICAiVmFsdWUiOiAiQzU4NzQ2NzA4MDgwIgogICAgICAgICAgICAgICAgICAgIH0KICAgICAgICAgICAgICAgIH0sCiAgICAgICAgICAgICAgICB7CiAgICAgICAgICAgICAgICAgICAgIklkIjogewogICAgICAgICAgICAgICAgICAgICAgICAiU2NoZW1lSUQiOiAiQlJOIiwKICAgICAgICAgICAgICAgICAgICAgICAgIlZhbHVlIjogIjIwMjQwMTAyMTEyOCIKICAgICAgICAgICAgICAgICAgICB9CiAgICAgICAgICAgICAgICB9LAogICAgICAgICAgICAgICAgewogICAgICAgICAgICAgICAgICAgICJJZCI6IHsKICAgICAgICAgICAgICAgICAgICAgICAgIlNjaGVtZUlEIjogIlNTVCIsCiAgICAgICAgICAgICAgICAgICAgICAgICJWYWx1ZSI6ICJOQSIKICAgICAgICAgICAgICAgICAgICB9CiAgICAgICAgICAgICAgICB9LAogICAgICAgICAgICAgICAgewogICAgICAgICAgICAgICAgICAgICJJZCI6IHsKICAgICAgICAgICAgICAgICAgICAgICAgIlNjaGVtZUlEIjogIlRUWCIsCiAgICAgICAgICAgICAgICAgICAgICAgICJWYWx1ZSI6ICJOQSIKICAgICAgICAgICAgICAgICAgICB9CiAgICAgICAgICAgICAgICB9CiAgICAgICAgICAgIF0sCiAgICAgICAgICAgICJQYXJ0eUxlZ2FsRW50aXR5IjogewogICAgICAgICAgICAgICAgIlJlZ2lzdHJhdGlvbk5hbWUiOiAiWFlaIgogICAgICAgICAgICB9LAogICAgICAgICAgICAiUG9zdGFsQWRkcmVzcyI6IHsKICAgICAgICAgICAgICAgICJBZGRyZXNzTGluZSI6IFsKICAgICAgICAgICAgICAgICAgICB7CiAgICAgICAgICAgICAgICAgICAgICAgICJMaW5lIjogIk1lbmFyYSBLb3Jwb3JhdCIKICAgICAgICAgICAgICAgICAgICB9LAogICAgICAgICAgICAgICAgICAgIHsKICAgICAgICAgICAgICAgICAgICAgICAgIkxpbmUiOiAiUGVyc2FkYSBQTFVTIgogICAgICAgICAgICAgICAgICAgIH0sCiAgICAgICAgICAgICAgICAgICAgewogICAgICAgICAgICAgICAgICAgICAgICAiTGluZSI6ICJQZXJzaW1wYW5nYW4gQmVydGluZ2thdCBTdWJhbmcgS00xNSIKICAgICAgICAgICAgICAgICAgICB9CiAgICAgICAgICAgICAgICBdLAogICAgICAgICAgICAgICAgIkNpdHlOYW1lIjogIkxlYnVocmF5YSBCYXJ1IExlbWJhaCBLbGFuZyIsCiAgICAgICAgICAgICAgICAiQ291bnRyeSI6IHsKICAgICAgICAgICAgICAgICAgICAiSWRlbnRpZmljYXRpb25Db2RlIjogewogICAgICAgICAgICAgICAgICAgICAgICAiQ291bnRyeUNvZGUiOiAiTVlTIgogICAgICAgICAgICAgICAgICAgIH0KICAgICAgICAgICAgICAgIH0sCiAgICAgICAgICAgICAgICAiQ291bnRyeVN1YmVudGl0eUNvZGUiOiAiMTAiLAogICAgICAgICAgICAgICAgIlBvc3RhbFpvbmUiOiAiNDczMDEiCiAgICAgICAgICAgIH0KICAgICAgICB9CiAgICB9LAogICAgIkludm9pY2VMaW5lIjogWwogICAgICAgIHsKICAgICAgICAgICAgIklkIjogIjEiLAogICAgICAgICAgICAiSW52b2ljZWRRdWFudGl0eSI6IHsKICAgICAgICAgICAgICAgICJRdWFudGl0eSI6IDEsCiAgICAgICAgICAgICAgICAiVW5pdENvZGUiOiAiS0dTIgogICAgICAgICAgICB9LAogICAgICAgICAgICAiSXRlbSI6IHsKICAgICAgICAgICAgICAgICJDb21tb2RpdHlDbGFzc2lmaWNhdGlvbiI6IFsKICAgICAgICAgICAgICAgICAgICB7CiAgICAgICAgICAgICAgICAgICAgICAgICJJdGVtQ2xhc3NpZmljYXRpb25Db2RlIjogewogICAgICAgICAgICAgICAgICAgICAgICAgICAgIkxpc3RJRCI6ICJDTEFTUyIsCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAiVmFsdWUiOiAiMDExIgogICAgICAgICAgICAgICAgICAgICAgICB9CiAgICAgICAgICAgICAgICAgICAgfQogICAgICAgICAgICAgICAgXSwKICAgICAgICAgICAgICAgICJEZXNjcmlwdGlvbiI6ICJSZXBhaXIgYW5kIG1haW50ZW5hbmNlIiwKICAgICAgICAgICAgICAgICJPcmlnaW5Db3VudHJ5IjogewogICAgICAgICAgICAgICAgICAgICJJZGVudGlmaWNhdGlvbkNvZGUiOiB7CiAgICAgICAgICAgICAgICAgICAgICAgICJDb3VudHJ5Q29kZSI6ICJNWVMiCiAgICAgICAgICAgICAgICAgICAgfQogICAgICAgICAgICAgICAgfQogICAgICAgICAgICB9LAogICAgICAgICAgICAiSXRlbVByaWNlRXh0ZW5zaW9uIjogewogICAgICAgICAgICAgICAgIkFtb3VudCI6IHsKICAgICAgICAgICAgICAgICAgICAiQ3VycmVuY3lJRCI6ICJNWVIiLAogICAgICAgICAgICAgICAgICAgICJWYWx1ZSI6ICIxMjAwMDAiCiAgICAgICAgICAgICAgICB9CiAgICAgICAgICAgIH0sCiAgICAgICAgICAgICJBbGxvd2FuY2VDaGFyZ2UiOiBbCiAgICAgICAgICAgICAgICB7CiAgICAgICAgICAgICAgICAgICAgIkNoYXJnZUluZGljYXRvciI6IGZhbHNlLAogICAgICAgICAgICAgICAgICAgICJNdWx0aXBsaWVyRmFjdG9yTnVtZXJpYyI6IDAuMTAsCiAgICAgICAgICAgICAgICAgICAgIkFsbG93YW5jZUNoYXJnZVJlYXNvbiI6ICJTYW1wbGUiLAogICAgICAgICAgICAgICAgICAgICJBbW91bnQiOiB7CiAgICAgICAgICAgICAgICAgICAgICAgICJDdXJyZW5jeUlEIjogIk1ZUiIsCiAgICAgICAgICAgICAgICAgICAgICAgICJWYWx1ZSI6ICIxMjAwMC4wMCIKICAgICAgICAgICAgICAgICAgICB9CiAgICAgICAgICAgICAgICB9LAogICAgICAgICAgICAgICAgewogICAgICAgICAgICAgICAgICAgICJDaGFyZ2VJbmRpY2F0b3IiOiB0cnVlLAogICAgICAgICAgICAgICAgICAgICJNdWx0aXBsaWVyRmFjdG9yTnVtZXJpYyI6IDAsCiAgICAgICAgICAgICAgICAgICAgIkFsbG93YW5jZUNoYXJnZVJlYXNvbiI6ICJTYW1wbGUiLAogICAgICAgICAgICAgICAgICAgICJBbW91bnQiOiB7CiAgICAgICAgICAgICAgICAgICAgICAgICJDdXJyZW5jeUlEIjogIk1ZUiIsCiAgICAgICAgICAgICAgICAgICAgICAgICJWYWx1ZSI6ICIwLjAwIgogICAgICAgICAgICAgICAgICAgIH0KICAgICAgICAgICAgICAgIH0KICAgICAgICAgICAgXSwKICAgICAgICAgICAgIlByaWNlIjogewogICAgICAgICAgICAgICAgIlByaWNlQW1vdW50IjogewogICAgICAgICAgICAgICAgICAgICJDdXJyZW5jeUlEIjogIk1ZUiIsCiAgICAgICAgICAgICAgICAgICAgIlZhbHVlIjogIjEwODAwMC4wMCIKICAgICAgICAgICAgICAgIH0KICAgICAgICAgICAgfSwKICAgICAgICAgICAgIkxpbmVFeHRlbnNpb25BbW91bnQiOiB7CiAgICAgICAgICAgICAgICAiQ3VycmVuY3lJRCI6ICJNWVIiLAogICAgICAgICAgICAgICAgIlZhbHVlIjogIjEwODAwMCIKICAgICAgICAgICAgfSwKICAgICAgICAgICAgIlRheFRvdGFsIjogewogICAgICAgICAgICAgICAgIlRheEFtb3VudCI6IHsKICAgICAgICAgICAgICAgICAgICAiQ3VycmVuY3lJRCI6ICJNWVIiLAogICAgICAgICAgICAgICAgICAgICJWYWx1ZSI6ICI4NjQwLjAwIgogICAgICAgICAgICAgICAgfSwKICAgICAgICAgICAgICAgICJUYXhTdWJ0b3RhbCI6IFsKICAgICAgICAgICAgICAgICAgICB7CiAgICAgICAgICAgICAgICAgICAgICAgICJUYXhBbW91bnQiOiB7CiAgICAgICAgICAgICAgICAgICAgICAgICAgICAiQ3VycmVuY3lJRCI6ICJNWVIiLAogICAgICAgICAgICAgICAgICAgICAgICAgICAgIlZhbHVlIjogIjg2NDAuMDAiCiAgICAgICAgICAgICAgICAgICAgICAgIH0sCiAgICAgICAgICAgICAgICAgICAgICAgICJUYXhhYmxlQW1vdW50IjogewogICAgICAgICAgICAgICAgICAgICAgICAgICAgIkN1cnJlbmN5SUQiOiAiTVlSIiwKICAgICAgICAgICAgICAgICAgICAgICAgICAgICJWYWx1ZSI6ICIxMDgwMDAuMDAiCiAgICAgICAgICAgICAgICAgICAgICAgIH0sCiAgICAgICAgICAgICAgICAgICAgICAgICJUYXhDYXRlZ29yeSI6IHsKICAgICAgICAgICAgICAgICAgICAgICAgICAgICJJZCI6ICIwMSIKICAgICAgICAgICAgICAgICAgICAgICAgfQogICAgICAgICAgICAgICAgICAgIH0KICAgICAgICAgICAgICAgIF0KICAgICAgICAgICAgfQogICAgICAgIH0KICAgIF0sCiAgICAiQWxsb3dhbmNlQ2hhcmdlIjogWwogICAgICAgIHsKICAgICAgICAgICAgIkNoYXJnZUluZGljYXRvciI6IGZhbHNlLAogICAgICAgICAgICAiQWxsb3dhbmNlQ2hhcmdlUmVhc29uIjogIlNhbXBsZSBEZXNjcmlwdGlvbiIsCiAgICAgICAgICAgICJBbW91bnQiOiB7CiAgICAgICAgICAgICAgICAiVmFsdWUiOiA4MDAwLAogICAgICAgICAgICAgICAgIkN1cnJlbmN5SUQiOiAiTVlSIgogICAgICAgICAgICB9CiAgICAgICAgfSwKICAgICAgICB7CiAgICAgICAgICAgICJDaGFyZ2VJbmRpY2F0b3IiOiB0cnVlLAogICAgICAgICAgICAiQWxsb3dhbmNlQ2hhcmdlUmVhc29uIjogIlNhbXBsZSBEZXNjcmlwdGlvbiIsCiAgICAgICAgICAgICJBbW91bnQiOiB7CiAgICAgICAgICAgICAgICAiVmFsdWUiOiAwLAogICAgICAgICAgICAgICAgIkN1cnJlbmN5SUQiOiAiTVlSIgogICAgICAgICAgICB9CiAgICAgICAgfQogICAgXSwKICAgICJUYXhUb3RhbCI6IFsKICAgICAgICB7CiAgICAgICAgICAgICJUYXhBbW91bnQiOiB7CiAgICAgICAgICAgICAgICAiQ3VycmVuY3lJRCI6ICJNWVIiLAogICAgICAgICAgICAgICAgIlZhbHVlIjogIjEwMDAwLjAwIgogICAgICAgICAgICB9LAogICAgICAgICAgICAiVGF4U3VidG90YWwiOiBbCiAgICAgICAgICAgICAgICB7CiAgICAgICAgICAgICAgICAgICAgIlRheGFibGVBbW91bnQiOiB7CiAgICAgICAgICAgICAgICAgICAgICAgICJDdXJyZW5jeUlEIjogIk1ZUiIsCiAgICAgICAgICAgICAgICAgICAgICAgICJWYWx1ZSI6ICIxMDAwMDAuMDAiCiAgICAgICAgICAgICAgICAgICAgfSwKICAgICAgICAgICAgICAgICAgICAiVGF4QW1vdW50IjogewogICAgICAgICAgICAgICAgICAgICAgICAiQ3VycmVuY3lJRCI6ICJNWVIiLAogICAgICAgICAgICAgICAgICAgICAgICAiVmFsdWUiOiAiMTAwMDAuMDAiCiAgICAgICAgICAgICAgICAgICAgfSwKICAgICAgICAgICAgICAgICAgICAiVGF4U3VidG90YWwiOiBbCiAgICAgICAgICAgICAgICAgICAgICAgIHsKICAgICAgICAgICAgICAgICAgICAgICAgICAgICJUYXhBbW91bnQiOiB7CiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIkN1cnJlbmN5SUQiOiAiTVlSIiwKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAiVmFsdWUiOiAiMTAwMDAuMDAiCiAgICAgICAgICAgICAgICAgICAgICAgICAgICB9LAogICAgICAgICAgICAgICAgICAgICAgICAgICAgIlRheENhdGVnb3J5IjogewogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICJJZCI6ICIwMSIKICAgICAgICAgICAgICAgICAgICAgICAgICAgIH0KICAgICAgICAgICAgICAgICAgICAgICAgfQogICAgICAgICAgICAgICAgICAgIF0KICAgICAgICAgICAgICAgIH0KICAgICAgICAgICAgXQogICAgICAgIH0KICAgIF0sCiAgICAiTGVnYWxNb25ldGFyeVRvdGFsIjogewogICAgICAgICJMaW5lRXh0ZW5zaW9uQW1vdW50IjogewogICAgICAgICAgICAiQ3VycmVuY3lJRCI6ICJNWVIiLAogICAgICAgICAgICAiVmFsdWUiOiAiMTA4MDAwLjAwIgogICAgICAgIH0sCiAgICAgICAgIkFsbG93YW5jZVRvdGFsQW1vdW50IjogewogICAgICAgICAgICAiQ3VycmVuY3lJRCI6ICJNWVIiLAogICAgICAgICAgICAiVmFsdWUiOiAiODAwMC4wMCIKICAgICAgICB9LAogICAgICAgICJDaGFyZ2VUb3RhbEFtb3VudCI6IHsKICAgICAgICAgICAgIkN1cnJlbmN5SUQiOiAiTVlSIiwKICAgICAgICAgICAgIlZhbHVlIjogIjAuMDAiCiAgICAgICAgfSwKICAgICAgICAiVGF4RXhjbHVzaXZlQW1vdW50IjogewogICAgICAgICAgICAiQ3VycmVuY3lJRCI6ICJNWVIiLAogICAgICAgICAgICAiVmFsdWUiOiAiMTAwMDAwLjAwIgogICAgICAgIH0sCiAgICAgICAgIlRheEluY2x1c2l2ZUFtb3VudCI6IHsKICAgICAgICAgICAgIkN1cnJlbmN5SUQiOiAiTVlSIiwKICAgICAgICAgICAgIlZhbHVlIjogIjExMDAwMC4wMCIKICAgICAgICB9LAogICAgICAgICJQcmVwYWlkQW1vdW50IjogewogICAgICAgICAgICAiQ3VycmVuY3lJRCI6ICJNWVIiLAogICAgICAgICAgICAiVmFsdWUiOiAiMC4wMCIKICAgICAgICB9LAogICAgICAgICJQYXlhYmxlQW1vdW50IjogewogICAgICAgICAgICAiQ3VycmVuY3lJRCI6ICJNWVIiLAogICAgICAgICAgICAiVmFsdWUiOiAiMTEwMDAwLjAwIgogICAgICAgIH0sCiAgICAgICAgIlBheWFibGVSb3VuZGluZ0Ftb3VudCI6IHsKICAgICAgICAgICAgIlZhbHVlIjogIjAuMDAiCiAgICAgICAgfQogICAgfSwKICAgICJQYXltZW50TWVhbnMiOiB7CiAgICAgICAgIlBheW1lbnRNZWFuc0NvZGUiOiAiNCIKICAgIH0sCiAgICAiUGF5bWVudFRlcm1zIjogewogICAgICAgICJOb3RlIjogIlBheW1lbnQgTWV0aG9kIGlzIGNhc2giCiAgICB9Cn0=", "DocumentFormat": "JSON", "UniqueIdentifier": "C58746708080_TEST-SALES-001_01_2024", "CustomFields": { "Internal Number": "INV00001234561687" } } ], "version": "MY_GENERATE_UBL_2_1_V1" } ``` **Document Data - Sample JSON and XML** {% tabs %} {% tab title="JSON" %} ```json { "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": "e-invoice@pacificofats.com", "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": "jsphchong@yahoo.com", "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" } ] } ``` {% endtab %} {% tab title="XML" %} ```xml 01 2024-07-01 2024-07-30 Monthly 2025-07-01 11:19:36 MYR TEST-CT-00001 e-invoice@pacificofats.com +6032230090 TIN C4853558030 BRN 198801004020 SST W10-1809-32000158 TTX NA PACIFIC OILS & FATS INDUSTRIES SDN. BHD. No 8, Jalan Besi Utama, Batu 24, Kelapa Sawit line2 line3 KULAI MYS 01 81030 jsphchong@yahoo.com +6007252390 00000 NOT APPLICABLE TIN C58746708080 BRN 202401021128 SST NA TTX NA Defmacro Software Pvt Ltd PLO 2244 Jln Suasa, Kaw. Perind. Pasir Gudang KL Pasir Gudang MYS 01 81750 TIN C5896234040 BRN 199501010666 SST NA CAMPBELL SOUP SOUTHEAST ASIA SDN BHD Level 33 Ilham Tower 8 Jalan Binjai 8 Jalan Binjai MYS 14 50450 1 100000 H87 CLASS 022 9800.0010 test description MYS 0012000748 Customer Code 12345 VBKD-BSTKD MYR 5.0E7 false 0 NA MYR 2000 true 0 NA MYR 1000 MYR 500.0 MYR 4.9999E7 MYR 3999920.0 MYR 3999920.0 MYR 4.9999E7 01 0.08 false 0 In store discount MYR 4000.0 true 0 Convenience fee MYR 4000.0 Clear-02 MYR 1500000 2024-07-28 13:00:00 MYR 3999920.0 MYR 4.9999E7 MYR 3999920.0 MYR 4.9999E7 01 MYR 4.9999E7 MYR 4000.0 MYR 4000.0 MYR 4.9999E7 MYR 5.399892E7 MYR 1500000 MYR 5.249892E7 MYR 0.0 04 1234567890123 Payment Method is CARD 1 E12345678912 CustomsImportForm FTA FreeTradeAgreement E12345678912 K2 CIF ``` {% endtab %} {% endtabs %} ### 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 | | 429 | Too many requests | ### Response Schema | Parameter | Data Type | Field Validations | Description | | ----------------- | ------------------- | ----------------- | ------------------------------------------------------ | | Success | Boolean | true/false | Mandatory. Indicates the request was successful or not | | DocumentResponses | Array | NA | NA | | ErrorDetails | Array\ | Error details |

Optional.

Error list from ClearTax

| #### Document Details Object | Parameter | Data Type | Field Validations | Description | | -------------- | ------------------- | ----------------- | ----------------------------------------------------------------------------- | | DocumentId | String |


NA

| Unique document id generated in database | | UniqueId | String |

NA

| Mandatory. Same uniqueId as shared in the request | | Success | Boolean | true/false | Indicates, if the request for this document was successfully processed or not | | ErrorDetails | Array\ | Error details |

Optional.

Error list from ClearTax/LHDN

| | WarningDetails | Array\ | Warning details |

Optional.
Warning list from ClearTax

| **ErrorDetails** | Parameter | Data Type | Field Validations | Description | | ------------ | ----------- | ----------------- | ---------------------------- | | ErrorCode | String |

NA

|

Error Code

| | ErrorMessage | String |

NA

|

Error Message

| | ErrorSource | ErrorSource | CLEARTAX / GOVT |


Error Source

| | Path | String |

NA

|

Path of the Error

| **WarningDetails** | Parameter | Data Type | Field Validations | Description | | --------- | --------- | ----------------- | -------------------------- | | Code | String | NA | Warning Code | | Message | String | NA |

Warning Message

| ### Sample Response (Success) HTTP Status Code 200 Response Body ```json { "ErrorDetails": null, "Success": "true", "DocumentResponses": [ { "DocumentId": "66694ab91fe33e3be063dc57", "Success": "true", "UniqueId": "C58746708080_TEST-SALES-004_01_2024", "ErrorDetails": null, "WarningDetails": null } ] } ``` ### Sample Response (Error) HTTP Status Code: 400 Response Body ```json { "ErrorDetails": null, "Success": "true", "DocumentResponses": [ { "DocumentId": null, "Success": "false", "UniqueId": "C58746708080_TEST-SALES-004_01_2024", "ErrorDetails": [ { "ErrorCode": "ibr-cl-15", "ErrorMessage": "[ibr-cl-15]-Origin country codes in an invoice (ibt-159) MUST be coded using ISO code list 3166-1", "ErrorSource": "CLEARTAX", "Path": "Invoice.InvoiceLine[0].Item[0].OriginCountry[0].IdentificationCode" } ], "WarningDetails": null } ] } ``` ### API Validations Currently there are no known validations. ### 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. 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. 3. 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. 4. Rate Limit: The below rate limits are in line with those applied by LHDN. **Production - 500 API calls per minute with a burst capacity of 25 API calls** **Sandbox - 500 API calls per minute with a burst capacity of 25 API calls** --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.cleartax.in/cleartax-docs/e-invoicing-malaysia-api/e-invoicing-malaysia-api-reference/api-lists/upload-e-invoice.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.