E-Invoicing for Malaysia API References

Registred Name of Supplier’s business

Tax Identification Number (TIN) of the entity that is being onboarded.

For all SST registrants, SST Number is Mandatory. For businesses, Business registration number is Mandatory. For Malaysian individuals, any of the NRIC Identification like MyKad/MyKAS/MyPR is necessary. If you are a non-Malaysian individual then Passport number is mandatory. If you have a MyTentera number, then it should also be shared. Tourism tax registration number for tourism tax registrant, which may consist of hotel operators and online travel operators.

  {
    "sst": "A01-2345-67891012", // SST Registeration Number
    "brn": "202001234567", // Business Registration Number
    "nric": "770305-02-1234", // MyKad/MyPR/MyKAS Number
    "passport": "A12345678", // Passport Number
    "army": "T123456789012", // MyTentera Number
    "ttx": "123-4567-89012345" // Tourism Tax Registration Number
  }

5-digit code that represent the Supplier’s business nature and activity. Please refer: (https://sdk.myinvois.hasil.gov.my/codes/msic-codes/)

Description of the Supplier’s business activity

Registered City of the supplier.

Street details of the supplier. If not available, provide 'NA'.

SubEntity/State Code. Please refer: (https://sdk.myinvois.hasil.gov.my/codes/state-codes/)

Country of the supplier. Please refer (https://sdk.myinvois.hasil.gov.my/codes/countries/)

The telephone number of the Supplier (e.g., office, mobile, fax). Following the E.164 standard (https://www.itu.int/rec/T-REC-E.164).

Client ID for the Service Provider.

Client secret for the Serviec Provider.

The Tax Identification Number to get the validity of the tin.

It can be NRIC, Passport number, Business registration number, army number etc

The actual value of the ID Type selected.

Unique Invoice Reference Number. This should be made in sequence.

Date on which the invoice was issued.

Time at which the invoice was issued. Keep it in UTC format.

Document Type to be specified.

If you want to make rounding to stay total aligned, please pass the total of Invoice including all taxes.

Currency in which Invoice was issued. Default value: MYR. Please see the list of currency code in LHDN Documentation

Rate at which non-Malaysian currency will be converted into Malaysian Ringgit. This is required when DocumentCurrencyCode is not MYR

In case of Credit Note, Debit Note and Refund Note, it is mandatory to reference which that dodcument relates to.

• UUID mandatory: IRBM Unique Identifier Number of the Invoice to which this credit note refers to.
• InternalID mandatory: Internal ID / e-Invoice Code / Number to which this credit note belongs to.

 "InvoiceDocumentReference": [{
   "UUID": "71E88663PY17SQ9JZ48NYM0J10",
   "InternalID": "INV12345"
 }]

Document level discounts need to be shown here. It is an optional tag and can be skipped if there is no discounts involved.

Document level charges or fees need to be shown here. It is an optional tag and can be skipped if there is no charges involved.

Prepayments related this specific invoice need to me mentioned here. It is an optional tag.

 [{
   "PaymentID": "REC1012", 
   "Amount": 100, 
   "Date": "2024-01-10", 
   "Time": "12:00:00Z", 
 }]

Unique identifier assigned on the Declaration of Goods Imported.The input of special characters is not allowed. (limit: 19 chars)

A set of international trade rules that define the responsibilities of buyers and suppliers.The input of special characters is not allowed. (limit: 3 chars)

Details of customers to which this Invoice is being issued to.

1. LegalName string: mandatory (limit: 300 chars): Official name of Customer
2. CustomerTIN string: mandatory (limit: 14 chars): TIN Number of Customer

• EI00000000010 - For General Public
• EI00000000020 - For Foreign Buyer’s/Foreign Shipping Recipient’s TIN

3. Any one of the below is mandatory

4. CustomerSST string: optional (limit: 35 chars): If they are SST Registered
5. CityName string: mandatory (limit: 300 chars): City of Customer
6. AddressLines[] mandatory: min 1, max 3: Address Details of the Customer. One line is mandatory. Provide 'NA' if not recognizable.
7. CountrySubentityCode string: mandatory (2 chars): Subentity Code from authority. 17 can be given if not applicable in case of foreign buyers. Please refer LHDN Documentation
8. CountryCode string: mandatory (3 chars): Country of Customer. For codes, please refer LHDN Documentation
9. Telephone string: mandatory (limit: 20 chars): Contact Number of Customer
10. Email string: optional (limit: 300 chars): Email Address of Customer

Details of receipient to which this Invoice is being delivered to.

1. RecipientName string: mandatory (limit: 300 chars): Official name of receipient
2. RecipientTIN string: mandatory (limit: 14 chars): TIN Number of receipient
3. Any one of the below is mandatory

4. RecipientSST string: optional (limit: 35 chars): If they are SST Registered
5. CityName string: mandatory (limit: 300 chars): City of receipient
6. AddressLines[] mandatory: min 1, max 3: Address Details of the receipient. One line is mandatory. Provide 'NA' if not recognizable.
7. CountrySubentityCode string: mandatory (2 chars): Subentity Code from authority. 17 can be given if not applicable in case of foreign buyers. Please refer LHDN Documentation
8. CountryCode string: mandatory (3 chars): Country of receipient. For codes, please refer LHDN Documentation
9. ShipmentID string: optional (limit: 50 chars): Shipping ID if any.
10. ShipmentCharges array: optional[if given, at least one]: Amount and Reason of such a charge need to be given.

Details of line items in the document as an array. At least one item is mandatory in an Invoice. Each elemnt in this array must have:

1. Description string: mandatory (limit: 300 chars): Item Name
2. InvoicedQuantity number: mandatory: Quantity of Items
3. UOM string: optional: Default: "C62". If you want to specify, then you can use any of the code given in: (https://sdk.myinvois.hasil.gov.my/codes/unit-types/)
4. PriceAmount number: mandatory: Unit Price of Items
5. LineTaxes array: mandatory: Taxes in each Line item

• TaxType enum: mandatory: Fixed codes as per: (https://sdk.myinvois.hasil.gov.my/files/TaxTypes.json)

• TaxExemptionReason string: mandatory if applicable: If TaxType is 'E', then TaxExemptionReason is mandatory.
• TaxRate number: optional: 0.10 for 10% of Tax Rate [Either TaxRate or TaxBaseUnit & TaxPerUnit together].
• TaxBaseUnit number: optional: Units that have Tax applied [Either TaxRate or TaxBaseUnit & TaxPerUnit together].
• TaxPerUnit number: mandatory: Per unit tax to be considered [Either TaxRate or TaxBaseUnit & TaxPerUnit together].

 [
   {
     "TaxType": "01",
     "TaxBaseUnit": 1,
     "TaxPerUnit": 10
   },
   {
     "TaxType": "E",
     "TaxRate": 0,
     "TaxExemptionReason": "Exempt New Means of Transport"
   }
 ]

6. ClassificationCode array: mandatory ([] each has limit of: 3 chars): The 3 digit number of classification. Please refer LHDN Documentation
7. Discounts array: optional: Line item level discounts need to be passed here. It is an optional tag and can be skipped if there is no discounts involved.
8. Charges array: optional: Line item level charges/fees need to be passed here. It is an optional tag and can be skipped if there is no charges/fees involved.

Both Discounts and Charges Should have the schema as specified below:

 [{
   "Amount": 100, // Amount to be adjusted from line total
   "Reason": "Discount / Item Service Fee", // Reason text
 }]

Unique Invoice Reference Number. This should be made in sequence.

Date on which the invoice was issued.

Time at which the invoice was issued. Keep it in UTC format.

Document Type to be specified.

If you want to make rounding to stay total aligned, please pass the total of Invoice including all taxes.

Currency in which Invoice was issued. Default value: MYR. Please see the list of currency code in LHDN Documentation

Rate at which non-Malaysian currency will be converted into Malaysian Ringgit. This is required when DocumentCurrencyCode is not MYR

In case of Credit Note, Debit Note and Refund Note, it is mandatory to reference which that dodcument relates to.

• UUID mandatory: IRBM Unique Identifier Number of the Invoice to which this credit note refers to.
• InternalID mandatory: Internal ID / e-Invoice Code / Number to which this credit note belongs to.

 "InvoiceDocumentReference": [{
   "UUID": "71E88663PY17SQ9JZ48NYM0J10",
   "InternalID": "INV12345"
 }]

Document level discounts need to be shown here. It is an optional tag and can be skipped if there is no discounts involved.

Document level charges or fees need to be shown here. It is an optional tag and can be skipped if there is no charges involved.

Prepayments related this specific invoice need to me mentioned here. It is an optional tag.

 [{
   "PaymentID": "REC1012", 
   "Amount": 100, 
   "Date": "2024-01-10", 
   "Time": "12:00:00Z", 
 }]

Unique identifier assigned on the Declaration of Goods Imported.The input of special characters is not allowed. (limit: 19 chars)

A set of international trade rules that define the responsibilities of buyers and suppliers.The input of special characters is not allowed. (limit: 3 chars)

Details of customers to which this Invoice is being issued to.

1. LegalName string: mandatory (limit: 300 chars): Official name of Customer
2. CustomerTIN string: mandatory (limit: 14 chars): TIN Number of Customer

• EI00000000010 - For General Public
• EI00000000020 - For Foreign Buyer’s/Foreign Shipping Recipient’s TIN

3. Any one of the below is mandatory

4. CustomerSST string: optional (limit: 35 chars): If they are SST Registered
5. CityName string: mandatory (limit: 300 chars): City of Customer
6. AddressLines[] mandatory: min 1, max 3: Address Details of the Customer. One line is mandatory. Provide 'NA' if not recognizable.
7. CountrySubentityCode string: mandatory (2 chars): Subentity Code from authority. 17 can be given if not applicable in case of foreign buyers. Please refer LHDN Documentation
8. CountryCode string: mandatory (3 chars): Country of Customer. For codes, please refer LHDN Documentation
9. Telephone string: mandatory (limit: 20 chars): Contact Number of Customer
10. Email string: optional (limit: 300 chars): Email Address of Customer

Details of receipient to which this Invoice is being delivered to.

1. RecipientName string: mandatory (limit: 300 chars): Official name of receipient
2. RecipientTIN string: mandatory (limit: 14 chars): TIN Number of receipient
3. Any one of the below is mandatory

4. RecipientSST string: optional (limit: 35 chars): If they are SST Registered
5. CityName string: mandatory (limit: 300 chars): City of receipient
6. AddressLines[] mandatory: min 1, max 3: Address Details of the receipient. One line is mandatory. Provide 'NA' if not recognizable.
7. CountrySubentityCode string: mandatory (2 chars): Subentity Code from authority. 17 can be given if not applicable in case of foreign buyers. Please refer LHDN Documentation
8. CountryCode string: mandatory (3 chars): Country of receipient. For codes, please refer LHDN Documentation
9. ShipmentID string: optional (limit: 50 chars): Shipping ID if any.
10. ShipmentCharges array: optional[if given, at least one]: Amount and Reason of such a charge need to be given.

Details of line items in the document as an array. At least one item is mandatory in an Invoice. Each elemnt in this array must have:

1. Description string: mandatory (limit: 300 chars): Item Name
2. InvoicedQuantity number: mandatory: Quantity of Items
3. UOM string: optional: Default: "C62". If you want to specify, then you can use any of the code given in: (https://sdk.myinvois.hasil.gov.my/codes/unit-types/)
4. PriceAmount number: mandatory: Unit Price of Items
5. LineTaxes array: mandatory: Taxes in each Line item

• TaxType enum: mandatory: Fixed codes as per: (https://sdk.myinvois.hasil.gov.my/files/TaxTypes.json)

• TaxExemptionReason string: mandatory if applicable: If TaxType is 'E', then TaxExemptionReason is mandatory.
• TaxRate number: optional: 0.10 for 10% of Tax Rate [Either TaxRate or TaxBaseUnit & TaxPerUnit together].
• TaxBaseUnit number: optional: Units that have Tax applied [Either TaxRate or TaxBaseUnit & TaxPerUnit together].
• TaxPerUnit number: mandatory: Per unit tax to be considered [Either TaxRate or TaxBaseUnit & TaxPerUnit together].

 [
   {
     "TaxType": "01",
     "TaxBaseUnit": 1,
     "TaxPerUnit": 10
   },
   {
     "TaxType": "E",
     "TaxRate": 0,
     "TaxExemptionReason": "Exempt New Means of Transport"
   }
 ]

6. ClassificationCode array: mandatory ([] each has limit of: 3 chars): The 3 digit number of classification. Please refer LHDN Documentation
7. Discounts array: optional: Line item level discounts need to be passed here. It is an optional tag and can be skipped if there is no discounts involved.
8. Charges array: optional: Line item level charges/fees need to be passed here. It is an optional tag and can be skipped if there is no charges/fees involved.

Both Discounts and Charges Should have the schema as specified below:

 [{
   "Amount": 100, // Amount to be adjusted from line total
   "Reason": "Discount / Item Service Fee", // Reason text
 }]

Unique Invoice Reference Number. This should be made in sequence.

Date on which the invoice was issued.

Time at which the invoice was issued. Keep it in UTC format.

Document Type to be specified.

If you want to make rounding to stay total aligned, please pass the total of Invoice including all taxes.

Currency in which Invoice was issued. Default value: MYR. Please see the list of currency code in LHDN Documentation

Rate at which non-Malaysian currency will be converted into Malaysian Ringgit. This is required when DocumentCurrencyCode is not MYR

In case of Credit Note, Debit Note and Refund Note, it is mandatory to reference which that dodcument relates to.

• UUID mandatory: IRBM Unique Identifier Number of the Invoice to which this credit note refers to.
• InternalID mandatory: Internal ID / e-Invoice Code / Number to which this credit note belongs to.

 "InvoiceDocumentReference": [{
   "UUID": "71E88663PY17SQ9JZ48NYM0J10",
   "InternalID": "INV12345"
 }]

Document level discounts need to be shown here. It is an optional tag and can be skipped if there is no discounts involved.

Document level charges or fees need to be shown here. It is an optional tag and can be skipped if there is no charges involved.

Prepayments related this specific invoice need to me mentioned here. It is an optional tag.

 [{
   "PaymentID": "REC1012", 
   "Amount": 100, 
   "Date": "2024-01-10", 
   "Time": "12:00:00Z", 
 }]

Unique identifier assigned on the Declaration of Goods Imported.The input of special characters is not allowed. (limit: 19 chars)

A set of international trade rules that define the responsibilities of buyers and suppliers.The input of special characters is not allowed. (limit: 3 chars)

Details of customers to which this Invoice is being issued to.

1. LegalName string: mandatory (limit: 300 chars): Official name of Customer
2. CustomerTIN string: mandatory (limit: 14 chars): TIN Number of Customer

• EI00000000010 - For General Public

3. CustomerTIN string: mandatory (limit: 14 chars): NA for General Public.

4. CityName string: mandatory (limit: 300 chars): NA for General Public

5. AddressLines[] mandatory: min 1, max 3: Provide 'NA' if not recognizable.

6. CountrySubentityCode string: mandatory (2 chars): Subentity Code from authority. 17 can be given if not applicable in case of General Public. Please refer LHDN Documentation

7. CountryCode string: mandatory (3 chars): Country of Customer. For codes, please refer LHDN Documentation

8. Telephone string: mandatory (limit: 20 chars): Contact Number of Customer

Details of line items in the document as an array. At least one item is mandatory in an Invoice. Each elemnt in this array must have:

1. Description string: mandatory (limit: 300 chars): Item Name
2. InvoicedQuantity number: mandatory: Quantity of Items
3. UOM string: optional: Default: "C62". If you want to specify, then you can use any of the code given in: (https://sdk.myinvois.hasil.gov.my/codes/unit-types/)
4. PriceAmount number: mandatory: Unit Price of Items
5. LineTaxes array: mandatory: Taxes in each Line item

• TaxType enum: mandatory: Fixed codes as per: (https://sdk.myinvois.hasil.gov.my/files/TaxTypes.json)

• TaxExemptionReason string: mandatory if applicable: If TaxType is 'E', then TaxExemptionReason is mandatory.
• TaxRate number: optional: 0.10 for 10% of Tax Rate [Either TaxRate or TaxBaseUnit & TaxPerUnit together].
• TaxBaseUnit number: optional: Units that have Tax applied [Either TaxRate or TaxBaseUnit & TaxPerUnit together].
• TaxPerUnit number: mandatory: Per unit tax to be considered [Either TaxRate or TaxBaseUnit & TaxPerUnit together].

 [
   {
     "TaxType": "01",
     "TaxBaseUnit": 1,
     "TaxPerUnit": 10
   },
   {
     "TaxType": "E",
     "TaxRate": 0,
     "TaxExemptionReason": "Exempt New Means of Transport"
   }
 ]

6. ClassificationCode array: mandatory ([] each has limit of: 3 chars): The 3 digit number of classification. Please refer LHDN Documentation
7. Discounts array: optional: Line item level discounts need to be passed here. It is an optional tag and can be skipped if there is no discounts involved.
8. Charges array: optional: Line item level charges/fees need to be passed here. It is an optional tag and can be skipped if there is no charges/fees involved.

Both Discounts and Charges Should have the schema as specified below:

 [{
   "Amount": 100, // Amount to be adjusted from line total
   "Reason": "Discount / Item Service Fee", // Reason text
 }]

Unique Invoice Reference Number. This should be made in sequence.

Date on which the invoice was issued.

Time at which the invoice was issued. Keep it in UTC format.

Document Type to be specified.

If you want to make rounding to stay total aligned, please pass the total of Invoice including all taxes.

Currency in which Invoice was issued. Default value: MYR. Please see the list of currency code in LHDN Documentation

Rate at which non-Malaysian currency will be converted into Malaysian Ringgit. This is required when DocumentCurrencyCode is not MYR

In case of Self-Billed Credit Note, Debit Note and Refund Note, it is mandatory to reference which that dodcument relates to.

• UUID mandatory: IRBM Unique Identifier Number of the Invoice to which this credit note refers to.
• InternalID mandatory: Internal ID / e-Invoice Code / Number to which this credit note belongs to.

 "InvoiceDocumentReference": [{
   "UUID": "71E88663PY17SQ9JZ48NYM0J10",
   "InternalID": "INV12345"
 }]

Document level discounts need to be shown here. It is an optional tag and can be skipped if there is no discounts involved.

Document level charges or fees need to be shown here. It is an optional tag and can be skipped if there is no charges involved.

Prepayments related this specific invoice need to me mentioned here. It is an optional tag.

 [{
   "PaymentID": "REC1012", 
   "Amount": 100, 
   "Date": "2024-01-10", 
   "Time": "12:00:00Z", 
 }]

Unique identifier assigned on the Declaration of Goods Imported.The input of special characters is not allowed. (limit: 19 chars)

A set of international trade rules that define the responsibilities of buyers and suppliers.The input of special characters is not allowed. (limit: 3 chars)

Details of supplier against whom which the document is being issued.

1. LegalName string: mandatory (limit: 300 chars): Official name of Supplier
2. SupplierTIN string: mandatory (limit: 14 chars): TIN Number of Supplier

• EI00000000010 - For General Public
• EI00000000030 - Foreign Supplier’s TIN

3. Any one of the below is mandatory

4. SupplierSST string: optional (limit: 35 chars): If they are SST Registered
5. CityName string: mandatory (limit: 300 chars): City of Supplier
6. AddressLines[] mandatory: min 1, max 3: Address Details of the Supplier. One line is mandatory. Provide 'NA' if not recognizable.
7. CountrySubentityCode string: mandatory (2 chars): Subentity Code from authority. 17 can be given if not applicable in case of foreign buyers. Please refer LHDN Documentation
8. CountryCode string: mandatory (3 chars): Country of Supplier. For codes, please refer LHDN Documentation
9. Telephone string: mandatory (limit: 20 chars): Contact Number of Supplier.
10. MSICCode string: mandatory (5 chars): MSCIC Code of Supplier. You can provide 00000 if not available.
11. Industry string: mandatory (limit: 300 chars): Industry of the supplier.
12. Email string: optional (limit: 300 chars): Email Address of Supplier

Details of receipient to which this Invoice is being delivered to.

1. RecipientName string: mandatory (limit: 300 chars): Official name of receipient
2. RecipientTIN string: mandatory (limit: 14 chars): TIN Number of receipient
3. Any one of the below is mandatory

4. RecipientSST string: optional (limit: 35 chars): If they are SST Registered
5. CityName string: mandatory (limit: 300 chars): City of receipient
6. AddressLines[] mandatory: min 1, max 3: Address Details of the receipient. One line is mandatory. Provide 'NA' if not recognizable.
7. CountrySubentityCode string: mandatory (2 chars): Subentity Code from authority. 17 can be given if not applicable in case of foreign buyers. Please refer LHDN Documentation
8. CountryCode string: mandatory (3 chars): Country of receipient. For codes, please refer LHDN Documentation
9. ShipmentID string: optional (limit: 50 chars): Shipping ID if any.
10. ShipmentCharges array: optional[if given, at least one]: Amount and Reason of such a charge need to be given.

Details of line items in the document as an array. At least one item is mandatory in an Invoice. Each elemnt in this array must have:

1. Description string: mandatory (limit: 300 chars): Item Name
2. InvoicedQuantity number: mandatory: Quantity of Items
3. UOM string: optional: Default: "C62". If you want to specify, then you can use any of the code given in: (https://sdk.myinvois.hasil.gov.my/codes/unit-types/)
4. PriceAmount number: mandatory: Unit Price of Items
5. LineTaxes array: mandatory: Taxes in each Line item

• TaxType enum: mandatory: Fixed codes as per: (https://sdk.myinvois.hasil.gov.my/files/TaxTypes.json)

• TaxExemptionReason string: mandatory if applicable: If TaxType is 'E', then TaxExemptionReason is mandatory.
• TaxRate number: optional: 0.10 for 10% of Tax Rate [Either TaxRate or TaxBaseUnit & TaxPerUnit together].
• TaxBaseUnit number: optional: Units that have Tax applied [Either TaxRate or TaxBaseUnit & TaxPerUnit together].
• TaxPerUnit number: mandatory: Per unit tax to be considered [Either TaxRate or TaxBaseUnit & TaxPerUnit together].

 [
   {
     "TaxType": "01",
     "TaxBaseUnit": 1,
     "TaxPerUnit": 10
   },
   {
     "TaxType": "E",
     "TaxRate": 0,
     "TaxExemptionReason": "Exempt New Means of Transport"
   }
 ]

6. ClassificationCode array: mandatory ([] each has limit of: 3 chars): The 3 digit number of classification. Please refer LHDN Documentation
7. Discounts array: optional: Line item level discounts need to be passed here. It is an optional tag and can be skipped if there is no discounts involved.
8. Charges array: optional: Line item level charges/fees need to be passed here. It is an optional tag and can be skipped if there is no charges/fees involved.

Both Discounts and Charges Should have the schema as specified below:

 [{
   "Amount": 100, // Amount to be adjusted from line total
   "Reason": "Discount / Item Service Fee", // Reason text
 }]

Unique Invoice Reference Number. This should be made in sequence.

Date on which the invoice was issued.

Time at which the invoice was issued. Keep it in UTC format.

Document Type to be specified.

If you want to make rounding to stay total aligned, please pass the total of Invoice including all taxes.

Currency in which Invoice was issued. Default value: MYR. Please see the list of currency code in LHDN Documentation

Rate at which non-Malaysian currency will be converted into Malaysian Ringgit. This is required when DocumentCurrencyCode is not MYR

In case of Self-Billed Credit Note, Debit Note and Refund Note, it is mandatory to reference which that dodcument relates to.

• UUID mandatory: IRBM Unique Identifier Number of the Invoice to which this credit note refers to.
• InternalID mandatory: Internal ID / e-Invoice Code / Number to which this credit note belongs to.

 "InvoiceDocumentReference": [{
   "UUID": "71E88663PY17SQ9JZ48NYM0J10",
   "InternalID": "INV12345"
 }]

Document level discounts need to be shown here. It is an optional tag and can be skipped if there is no discounts involved.

Document level charges or fees need to be shown here. It is an optional tag and can be skipped if there is no charges involved.

Prepayments related this specific invoice need to me mentioned here. It is an optional tag.

 [{
   "PaymentID": "REC1012", 
   "Amount": 100, 
   "Date": "2024-01-10", 
   "Time": "12:00:00Z", 
 }]

Unique identifier assigned on the Declaration of Goods Imported.The input of special characters is not allowed. (limit: 19 chars)

A set of international trade rules that define the responsibilities of buyers and suppliers.The input of special characters is not allowed. (limit: 3 chars)

Details of supplier against whom which the document is being issued.

1. LegalName string: mandatory (limit: 300 chars): Official name of Supplier
2. SupplierTIN string: mandatory (limit: 14 chars): TIN Number of Supplier

• EI00000000010 - For General Public
• EI00000000030 - Foreign Supplier’s TIN

3. Any one of the below is mandatory

4. SupplierSST string: optional (limit: 35 chars): If they are SST Registered
5. CityName string: mandatory (limit: 300 chars): City of Supplier
6. AddressLines[] mandatory: min 1, max 3: Address Details of the Supplier. One line is mandatory. Provide 'NA' if not recognizable.
7. CountrySubentityCode string: mandatory (2 chars): Subentity Code from authority. 17 can be given if not applicable in case of foreign buyers. Please refer LHDN Documentation
8. CountryCode string: mandatory (3 chars): Country of Supplier. For codes, please refer LHDN Documentation
9. Telephone string: mandatory (limit: 20 chars): Contact Number of Supplier.
10. MSICCode string: mandatory (5 chars): MSCIC Code of Supplier. You can provide 00000 if not available.
11. Industry string: mandatory (limit: 300 chars): Industry of the supplier.
12. Email string: optional (limit: 300 chars): Email Address of Supplier

Details of receipient to which this Invoice is being delivered to.

1. RecipientName string: mandatory (limit: 300 chars): Official name of receipient
2. RecipientTIN string: mandatory (limit: 14 chars): TIN Number of receipient
3. Any one of the below is mandatory

4. RecipientSST string: optional (limit: 35 chars): If they are SST Registered
5. CityName string: mandatory (limit: 300 chars): City of receipient
6. AddressLines[] mandatory: min 1, max 3: Address Details of the receipient. One line is mandatory. Provide 'NA' if not recognizable.
7. CountrySubentityCode string: mandatory (2 chars): Subentity Code from authority. 17 can be given if not applicable in case of foreign buyers. Please refer LHDN Documentation
8. CountryCode string: mandatory (3 chars): Country of receipient. For codes, please refer LHDN Documentation
9. ShipmentID string: optional (limit: 50 chars): Shipping ID if any.
10. ShipmentCharges array: optional[if given, at least one]: Amount and Reason of such a charge need to be given.

Details of line items in the document as an array. At least one item is mandatory in an Invoice. Each elemnt in this array must have:

1. Description string: mandatory (limit: 300 chars): Item Name
2. InvoicedQuantity number: mandatory: Quantity of Items
3. UOM string: optional: Default: "C62". If you want to specify, then you can use any of the code given in: (https://sdk.myinvois.hasil.gov.my/codes/unit-types/)
4. PriceAmount number: mandatory: Unit Price of Items
5. LineTaxes array: mandatory: Taxes in each Line item

• TaxType enum: mandatory: Fixed codes as per: (https://sdk.myinvois.hasil.gov.my/files/TaxTypes.json)

• TaxExemptionReason string: mandatory if applicable: If TaxType is 'E', then TaxExemptionReason is mandatory.
• TaxRate number: optional: 0.10 for 10% of Tax Rate [Either TaxRate or TaxBaseUnit & TaxPerUnit together].
• TaxBaseUnit number: optional: Units that have Tax applied [Either TaxRate or TaxBaseUnit & TaxPerUnit together].
• TaxPerUnit number: mandatory: Per unit tax to be considered [Either TaxRate or TaxBaseUnit & TaxPerUnit together].

 [
   {
     "TaxType": "01",
     "TaxBaseUnit": 1,
     "TaxPerUnit": 10
   },
   {
     "TaxType": "E",
     "TaxRate": 0,
     "TaxExemptionReason": "Exempt New Means of Transport"
   }
 ]

6. ClassificationCode array: mandatory ([] each has limit of: 3 chars): The 3 digit number of classification. Please refer LHDN Documentation
7. Discounts array: optional: Line item level discounts need to be passed here. It is an optional tag and can be skipped if there is no discounts involved.
8. Charges array: optional: Line item level charges/fees need to be passed here. It is an optional tag and can be skipped if there is no charges/fees involved.

Both Discounts and Charges Should have the schema as specified below:

 [{
   "Amount": 100, // Amount to be adjusted from line total
   "Reason": "Discount / Item Service Fee", // Reason text
 }]

Unique Invoice Reference Number. This should be made in sequence.

Date on which the invoice was issued.

Time at which the invoice was issued. Keep it in UTC format.

Document Type to be specified.

If you want to make rounding to stay total aligned, please pass the total of Invoice including all taxes.

Currency in which Invoice was issued. Default value: MYR. Please see the list of currency code in LHDN Documentation

Rate at which non-Malaysian currency will be converted into Malaysian Ringgit. This is required when DocumentCurrencyCode is not MYR

In case of Self-Billed Credit Note, Debit Note and Refund Note, it is mandatory to reference which that dodcument relates to.

• UUID mandatory: IRBM Unique Identifier Number of the Invoice to which this credit note refers to.
• InternalID mandatory: Internal ID / e-Invoice Code / Number to which this credit note belongs to.

  "InvoiceDocumentReference": [{
    "UUID": "71E88663PY17SQ9JZ48NYM0J10",
    "InternalID": "INV12345"
  }]

Document level discounts need to be shown here. It is an optional tag and can be skipped if there is no discounts involved.

Document level charges or fees need to be shown here. It is an optional tag and can be skipped if there is no charges involved.

Prepayments related this specific invoice need to me mentioned here. It is an optional tag.

 [{
   "PaymentID": "REC1012", 
   "Amount": 100, 
   "Date": "2024-01-10", 
   "Time": "12:00:00Z", 
 }]

Unique identifier assigned on the Declaration of Goods Imported.The input of special characters is not allowed. (limit: 19 chars)

A set of international trade rules that define the responsibilities of buyers and suppliers.The input of special characters is not allowed. (limit: 3 chars)

Details of supplier against whom which the document is being issued.

1. LegalName string: mandatory (limit: 300 chars): Official name of Supplier
2. SupplierTIN string: mandatory (limit: 14 chars): TIN Number of Supplier

• EI00000000010 - For General Public

3. SupplierBRN string: mandatory (limit: 14 chars): NA Can be given for General Public
4. CityName string: mandatory (limit: 300 chars): NA Can be given for General Public
5. AddressLines[] mandatory: min 1, max 3: NA Can be given for General Public
6. CountrySubentityCode string: mandatory (2 chars): Subentity Code from authority. 17 can be given if not applicable in case of foreign buyers. Please refer LHDN Documentation
7. CountryCode string: mandatory (3 chars): Country of Supplier. For codes, please refer LHDN Documentation
8. Telephone string: mandatory (limit: 20 chars): Contact Number of Supplier.
9. MSICCode string: mandatory (5 chars): MSCIC Code of Supplier. You can provide 00000 if not available.
10. Industry string: mandatory (limit: 300 chars): Industry of the supplier, NA if not available.

Details of line items in the document as an array. At least one item is mandatory in an Invoice. Each elemnt in this array must have:

1. Description string: mandatory (limit: 300 chars): Item Name
2. InvoicedQuantity number: mandatory: Quantity of Items
3. UOM string: optional: Default: "C62". If you want to specify, then you can use any of the code given in: (https://sdk.myinvois.hasil.gov.my/codes/unit-types/)
4. PriceAmount number: mandatory: Unit Price of Items
5. LineTaxes array: mandatory: Taxes in each Line item

• TaxType enum: mandatory: Fixed codes as per: (https://sdk.myinvois.hasil.gov.my/files/TaxTypes.json)

• TaxExemptionReason string: mandatory if applicable: If TaxType is 'E', then TaxExemptionReason is mandatory.
• TaxRate number: optional: 0.10 for 10% of Tax Rate [Either TaxRate or TaxBaseUnit & TaxPerUnit together].
• TaxBaseUnit number: optional: Units that have Tax applied [Either TaxRate or TaxBaseUnit & TaxPerUnit together].
• TaxPerUnit number: mandatory: Per unit tax to be considered [Either TaxRate or TaxBaseUnit & TaxPerUnit together].

 [
   {
     "TaxType": "01",
     "TaxBaseUnit": 1,
     "TaxPerUnit": 10
   },
   {
     "TaxType": "E",
     "TaxRate": 0,
     "TaxExemptionReason": "Exempt New Means of Transport"
   }
 ]

6. ClassificationCode array: mandatory ([] each has limit of: 3 chars): The 3 digit number of classification. Please refer LHDN Documentation
7. Discounts array: optional: Line item level discounts need to be passed here. It is an optional tag and can be skipped if there is no discounts involved.
8. Charges array: optional: Line item level charges/fees need to be passed here. It is an optional tag and can be skipped if there is no charges/fees involved.

Both Discounts and Charges Should have the schema as specified below:

 [{
   "Amount": 100, // Amount to be adjusted from line total
   "Reason": "Discount / Item Service Fee", // Reason text
 }]

UUID issued by LHDN for the document

UUID of the document that you want to cancel.

Desired status for the document. Must be "cancelled" always to cancel previously issued document, be it usual or self-billed.

Reason for cancelling the document.

Number of the page to retrieve. Typically this parameter value is derived from initial parameter less call when caller learns total amount of page of certain size

Number of the documents to retrieve per page. Page size cannot exceed system configured maximum page size for this API

The start date and time when the document was submitted to the e-Invoice API, Time to be supplied in UTC timezone. Mandatory when ‘submissionDateTo’ is provided.

The end date and time when the document was submitted to the e-Invoice API, Time to be supplied in UTC timezone. Mandatory when ‘submissionDateFrom’ is provided

The start date and time when the document was issued. Mandatory when ‘issueDateTo’ is provided

The end date and time when the document was issued. Mandatory when ‘issueDateFrom’ is provided

status of the document. Possible values: (Valid, Invalid, Cancelled, Submitted)

Document type code.

Document issuer identifier type. Possible values: (BRN, PASSPORT, NRIC, ARMY) This is mandatory in case the issuerId is provided.

Document issuer identifier.

Document issuer identifier. Possible values: (Business registration number, National ID(IC), Passport Number, Army ID)

UUID of the document that you want to reject.

Desired status for the document. Must be rejected to reject received document. 'rejected' is the only allowed value.

Reason for rejecting the document. Examples of reasons: Wrong buyer details or Wrong invoice details or any other reasons as the supplier deems appropriate

Type of Event happend

UUID of the document

LongId of the document

Internal Document ID

Current status of the document

Datetime when the document was cancelled.

Datetime when the rejection was requested.

Reason why a document has the current status of cancelled or invalid. This includes validation errors from LHDN.

UUID of the document

LongId of the document

Internal Document ID

Current status of the document

Datetime when the rejection was requested.

Reason why a document has the current status of cancelled or invalid. This includes validation errors from LHDN.

UUID of the document

LongId of the document

Internal Document ID

Current status of the document

Datetime when the document was cancelled.

Datetime when the rejection was requested.

Reason why a document has the current status of cancelled or invalid. This includes validation errors from LHDN.