Malaysia

LHDN eInvoicing + Peppol

Malaysia’s e-invoicing system, managed by LHDN via MyInvois, requires businesses to submit e-invoices in XML or JSON format for validation, with APIs supporting authentication, submission, retrieval, cancellation, and compliance tracking. To facilitate global interoperability, Malaysia also adopts the Peppol framework, a standardized e-invoicing network widely used in Europe and the Asia-Pacific. Peppol enables businesses to exchange invoices securely across borders through accredited Peppol Service Providers, ensuring compliance with both domestic and international standards. By integrating with Peppol, Malaysian businesses can seamlessly transact with global partners while adhering to local tax regulations.

SchemasCopied!

We currently support Malaysia’s LHDN e-Invoicing requirement, which is mandated by the Inland Revenue Board of Malaysia (LHDN).

"reporting_schema": [
  {
    "origin": "MY",
    "scheme_id": "MY:LHDNM"
  }
]

Additionally, we support PEPPOL e-invoicing, which is managed by MDEC (Malaysia Digital Economy Corporation).

"exchange_schema": [
  {
    "origin": "MY",
    "network": "PEPPOL",
    "recipient_id": "0230:1231241421"
    
  }
]

PEPPOL provides a standardized framework for electronic document exchange, enabling seamless B2B and B2G transactions. Malaysia's e-invoicing framework comes with its own intricacies, including specific data formats, compliance rules, and submission processes. Let’s go through each of these in detail to ensure seamless integration and compliance.

Public Identifiers in MalaysiaCopied!

1. MY:TIN

Its the Tax Identification Number assigned by LHDN/Hasil for tax compliance and e-Invoicing in Malaysia. Apart from the issued TINs, LHDN allows some generic ones like:

  1. General Public’s TIN → "EI00000000010"

    • Used for Malaysian individuals when only MyKad/MyTentera identification is provided.

    • Appears in:

      • Supplier, Buyer, Shipping Recipient TIN fields for individual transactions.

      • Buyer’s TIN in a consolidated e-Invoice.

      • Supplier’s TIN in a consolidated self-billed e-Invoice.

  2. Foreign Buyer’s / Foreign Shipping Recipient’s TIN → "EI00000000020"

    • Assigned to foreign buyers or shipping recipients.

  3. Foreign Supplier’s TIN → "EI00000000030"

    • Used for foreign suppliers in e-Invoicing.

  4. Buyer’s TIN for Government and Other Entities → "EI00000000040"

    • Applicable for transactions involving:

      • Government & State Authorities

      • Government Agencies & Local Authorities

      • Statutory Bodies & Exempt Institutions (that are not assigned a regular TIN)

2. MY:SST – Sales & Service Tax ID used for businesses registered under Malaysia’s SST framework.

3. MY:BRN – Business Registration Number assigned to companies and entities in Malaysia.

4. MY:NRIC – National Registration Identity Card number for Malaysian individuals.

5. MY:Passport – Identification number for foreign individuals without an NRIC.

6. MY:ARMY – MyTentera ID used for military personnel.

7. MY:TTX – Malaysian Tourism Tax (TTX) identification number used for entities registered under the Tourism Tax System.


ReferencesCopied!

  1. For Notes, show references pointing to its original document:

//Document Level
{
  "reference_type": "invoice",
  "reference_id": "INV-011",
  "additional_reference_id": "71E88663PY17SQ9JZ48NYM0J10"
}

2. For import and export transactions, it need certain documents to be mentioned:

 //Document Level
{
  "reference_type": "my_customs_import_form",
  "reference_id": "E23456789123"
},
{
  "reference_type": "my_incoterms",
  "reference_id": "E23"
}

3. When we specify party details in Malaysia, we need to provide 2 specific references:

//Party Level
{ 
  "reference_type":"my_msic",
  "reference_id":"98200"
},
{
  "reference_type": "my_industry_description",
  "reference_id": "E23456789123"
}

4. For each items, there need to be a Classification provided:

//Line Item level
{
  "reference_type": "my_item_classification_code",
  "reference_id": "003"
}

Other allowed values

  1. Allowed tax_type in Malaysia

Code

Description

01

Sales Tax

02

Service Tax

03

Tourism Tax

04

High-Value Goods Tax

05

Sales Tax on Low Value Goods

06

Not Applicable

E

Tax exemption (where applicable)

2. Allowed document_code in Malaysia:

Code

Description

01

Invoice

02

Credit Note

03

Debit Note

04

Refund Note

11

Self-billed Invoice

12

Self-billed Credit Note

13

Self-billed Debit Note

14

Self-billed Refund Note

3. Allowed uom in Malaysia

4. Allowed document_currency in Malaysia

5. Allowed county code in Malaysia

6. Allowed country in Malaysia

SamplesCopied!

1. Standard eInvoice

{
  "reporting_schema": [
    {
      "origin": "MY",
      "scheme_id": "MY:LHDNM"
    }
  ],
  "documents": [
    {
      "document_nature": "post_award",
      "document_type": "invoice",
      "document_code": "01",
      "document_currency": "MYR",
      "document_identifier": "INV12555-130",
      "issue_date": "2025-02-21",
      "issue_time": "14:12:33",
      "timezone": "+0000",
      "due_date": "2025-03-17",
      "issuing_party": {
        "party": {
          "name": "Issuing Co.",
          "address": {
            "street_1": "Lot 66",
            "street_2": "Bangunan Merdeka",
            "city": "Kuala Lumpur",
            "zip": "50480",
            "county": "14",
            "country": "MY"
          },
          "contact": {
            "email": "general.ams@issuer.com",
            "first_name": "Jony",
            "last_name": "Ponski",
            "phone": "+60-123456789"
          }
        },
        "references": [
          {
            "reference_type": "my_msic",
            "reference_id": "98200"
          },
          {
            "reference_type": "my_industry_description",
            "reference_id": "Industry"
          }
        ],
        "public_identifiers": [
          {
            "scheme_id": "MY:TIN",
            "identifier": "01201901234567"
          },
          {
            "scheme_id": "MY:BRN",
            "identifier": "412342131231"
          },
          {
            "scheme_id": "MY:SST",
            "identifier": "W00001111111111"
          }
        ]
      },
      "receiving_party": {
        "party": {
          "name": "Hebat Group 2",
          "address": {
            "street_1": "Lot 66",
            "street_2": "Bangunan Merdeka",
            "city": "Kuala Lumpur",
            "zip": "50480",
            "county": "14",
            "country": "MY"
          },
          "contact": {
            "email": "name@receiver.com",
            "first_name": "First",
            "last_name": "Last",
            "phone": "+60-123456789"
          }
        },
        "public_identifiers": [
          {
            "scheme_id": "MY:TIN",
            "identifier": "C58662356060"
          },
          {
            "scheme_id": "MY:BRN",
            "identifier": "198001005849"
          }
        ]
      },
      "invoice_line": [
        {
          "line_id": 1,
          "description": "Office Chair - Ergonomic",
          "quantity": 5,
          "uom": "H87",
          "unit_price": 250,
          "taxes": [
            {
              "tax_type": "01",
              "tax_rate": 6
            }
          ],
          "references": [
            {
              "reference_type": "my_item_classification_code",
              "reference_id": "003"
            }
          ]
        },
        {
          "line_id": 2,
          "description": "Standing Desk",
          "quantity": 2,
          "unit_price": 700,
          "taxes": [
            {
              "tax_type": "02",
              "tax_base_unit": 6,
              "tax_per_unit": 84
            },
            {
              "tax_type": "E",
              "tax_rate": 0,
              "exemption_reason": "reason",
              "exemption_reason_code": "NA"
            }
          ],
          "references": [
            {
              "reference_type": "my_item_classification_code",
              "reference_id": "003"
            }
          ]
        }
      ]
    }
  ]
}

2. Self-Billed eInvoice

{
  "reporting_schema": [
    {
      "origin": "MY",
      "scheme_id": "MY:LHDNM"
    }
  ],
  "documents": [
    {
      "document_nature": "post_award",
      "document_type": "invoice",
      "document_code": "11",
      "document_currency": "MYR",
      "document_identifier": "INV12555-130",
      "issue_date": "2025-02-21",
      "issue_time": "14:12:33",
      "timezone": "+0000",
      "due_date": "2025-03-17",
      "issuing_party": {
        "party": {
          "name": "Issuing Co.",
          "address": {
            "street_1": "Lot 66",
            "street_2": "Bangunan Merdeka",
            "city": "Kuala Lumpur",
            "zip": "50480",
            "county": "14",
            "country": "MY"
          },
          "contact": {
            "email": "general.ams@issuer.com",
            "first_name": "Jony",
            "last_name": "Ponski",
            "phone": "+60-123456789"
          }
        },
        "references": [
          {
            "reference_type": "my_msic",
            "reference_id": "98200"
          },
          {
            "reference_type": "my_industry_description",
            "reference_id": "Industry"
          }
        ],
        "public_identifiers": [
          {
            "scheme_id": "MY:TIN",
            "identifier": "01201901234567"
          },
          {
            "scheme_id": "MY:BRN",
            "identifier": "412342131231"
          },
          {
            "scheme_id": "MY:SST",
            "identifier": "W00001111111111"
          }
        ]
      },
      "receiving_party": {
        "party": {
          "name": "Hebat Group 2",
          "address": {
            "street_1": "Lot 66",
            "street_2": "Bangunan Merdeka",
            "city": "Kuala Lumpur",
            "zip": "50480",
            "county": "14",
            "country": "MY"
          },
          "contact": {
            "email": "name@receiver.com",
            "first_name": "First",
            "last_name": "Last",
            "phone": "+60-123456789"
          }
        },
        "public_identifiers": [
          {
            "scheme_id": "MY:TIN",
            "identifier": "C58662356060"
          },
          {
            "scheme_id": "MY:BRN",
            "identifier": "198001005849"
          }
        ]
      },
      "invoice_line": [
        {
          "line_id": 1,
          "description": "Office Chair - Ergonomic",
          "quantity": 5,
          "uom": "H87",
          "unit_price": 250,
          "taxes": [
            {
              "tax_type": "01",
              "tax_rate": 6
            }
          ],
          "references": [
            {
              "reference_type": "my_item_classification_code",
              "reference_id": "003"
            }
          ]
        },
        {
          "line_id": 2,
          "description": "Standing Desk",
          "quantity": 2,
          "unit_price": 700,
          "taxes": [
            {
              "tax_type": "02",
              "tax_base_unit": 6,
              "tax_per_unit": 84
            },
            {
              "tax_type": "E",
              "tax_rate": 0,
              "exemption_reason": "reason",
              "exemption_reason_code": "NA"
            }
          ],
          "references": [
            {
              "reference_type": "my_item_classification_code",
              "reference_id": "003"
            }
          ]
        }
      ]
    }
  ]
}

3. Notes

{
  "reporting_schema": [
    {
      "origin": "MY",
      "scheme_id": "MY:LHDNM"
    }
  ],
  "documents": [
    {
      "document_nature": "post_award",
      "document_type": "invoice",
      "document_code": "02",
      "document_currency": "MYR",
      "document_identifier": "INV12555-130",
      "issue_date": "2025-02-21",
      "issue_time": "14:12:33",
      "timezone": "+0000",
      "due_date": "2025-03-17",
      "references": [
        {
          "reference_type": "invoice",
          "reference_id": "INV-011",
          "additional_reference_id": "71E88663PY17SQ9JZ48NYM0J10"
        }
      ],
      "issuing_party": {
        "party": {
          "name": "Issuing Co.",
          "address": {
            "street_1": "Lot 66",
            "street_2": "Bangunan Merdeka",
            "city": "Kuala Lumpur",
            "zip": "50480",
            "county": "14",
            "country": "MY"
          },
          "contact": {
            "email": "general.ams@issuer.com",
            "first_name": "Jony",
            "last_name": "Ponski",
            "phone": "+60-123456789"
          }
        },
        "references": [
          {
            "reference_type": "my_msic",
            "reference_id": "98200"
          },
          {
            "reference_type": "my_industry_description",
            "reference_id": "Industry"
          }
        ],
        "public_identifiers": [
          {
            "scheme_id": "MY:TIN",
            "identifier": "01201901234567"
          },
          {
            "scheme_id": "MY:BRN",
            "identifier": "412342131231"
          },
          {
            "scheme_id": "MY:SST",
            "identifier": "W00001111111111"
          }
        ]
      },
      "receiving_party": {
        "party": {
          "name": "Hebat Group 2",
          "address": {
            "street_1": "Lot 66",
            "street_2": "Bangunan Merdeka",
            "city": "Kuala Lumpur",
            "zip": "50480",
            "county": "14",
            "country": "MY"
          },
          "contact": {
            "email": "name@receiver.com",
            "first_name": "First",
            "last_name": "Last",
            "phone": "+60-123456789"
          }
        },
        "public_identifiers": [
          {
            "scheme_id": "MY:TIN",
            "identifier": "C58662356060"
          },
          {
            "scheme_id": "MY:BRN",
            "identifier": "198001005849"
          }
        ]
      },
      "invoice_line": [
        {
          "line_id": 1,
          "description": "Office Chair - Ergonomic",
          "quantity": 5,
          "uom": "H87",
          "unit_price": 250,
          "taxes": [
            {
              "tax_type": "01",
              "tax_rate": 6
            }
          ],
          "references": [
            {
              "reference_type": "my_item_classification_code",
              "reference_id": "003"
            }
          ]
        },
        {
          "line_id": 2,
          "description": "Standing Desk",
          "quantity": 2,
          "unit_price": 700,
          "taxes": [
            {
              "tax_type": "02",
              "tax_base_unit": 6,
              "tax_per_unit": 84
            },
            {
              "tax_type": "E",
              "tax_rate": 0,
              "exemption_reason": "reason",
              "exemption_reason_code": "NA"
            }
          ],
          "references": [
            {
              "reference_type": "my_item_classification_code",
              "reference_id": "003"
            }
          ]
        }
      ]
    }
  ]
}

4. Export eInvoice

{
  "reporting_schema": [
    {
      "origin": "MY",
      "scheme_id": "MY:LHDNM"
    }
  ],
  "documents": [
    {
      "document_nature": "post_award",
      "document_type": "invoice",
      "document_code": "01",
      "document_currency": "AED",
      "exchange_rate": 1.2,
      "document_identifier": "INV12555-130",
      "issue_date": "2025-02-21",
      "issue_time": "14:12:33",
      "timezone": "+0000",
      "due_date": "2025-03-17",
      "references": [
        {
          "reference_type": "my_incoterms",
          "reference_id": "E23"
        }
      ],
      "issuing_party": {
        "party": {
          "name": "Issuing Co.",
          "address": {
            "street_1": "Lot 66",
            "street_2": "Bangunan Merdeka",
            "city": "Kuala Lumpur",
            "zip": "50480",
            "county": "14",
            "country": "MY"
          },
          "contact": {
            "email": "general.ams@issuer.com",
            "first_name": "Jony",
            "last_name": "Ponski",
            "phone": "+60-123456789"
          }
        },
        "references": [
          {
            "reference_type": "my_msic",
            "reference_id": "98200"
          },
          {
            "reference_type": "my_industry_description",
            "reference_id": "Industry"
          }
        ],
        "public_identifiers": [
          {
            "scheme_id": "MY:TIN",
            "identifier": "01201901234567"
          },
          {
            "scheme_id": "MY:BRN",
            "identifier": "412342131231"
          },
          {
            "scheme_id": "MY:SST",
            "identifier": "W00001111111111"
          }
        ]
      },
      "receiving_party": {
        "party": {
          "name": "Receiving Company ",
          "address": {
            "street_1": "Karama",
            "city": "Dubai",
            "county": "17",
            "country": "AE"
          },
          "contact": {
            "email": "name@receiver.com",
            "first_name": "First",
            "last_name": "Last",
            "phone": "+60-123456789"
          }
        },
        "public_identifiers": [
          {
            "scheme_id": "MY:TIN",
            "identifier": "EI00000000020"
          },
          {
            "scheme_id": "MY:BRN",
            "identifier": "NA"
          }
        ]
      },
      "invoice_line": [
        {
          "line_id": 1,
          "description": "Office Chair - Ergonomic",
          "quantity": 5,
          "uom": "H87",
          "unit_price": 250,
          "taxes": [
            {
              "tax_type": "01",
              "tax_rate": 6
            }
          ],
          "references": [
            {
              "reference_type": "my_item_classification_code",
              "reference_id": "003"
            }
          ]
        },
        {
          "line_id": 2,
          "description": "Standing Desk",
          "quantity": 2,
          "unit_price": 700,
          "taxes": [
            {
              "tax_type": "02",
              "tax_base_unit": 6,
              "tax_per_unit": 84
            },
            {
              "tax_type": "E",
              "tax_rate": 0,
              "exemption_reason": "reason",
              "exemption_reason_code": "NA"
            }
          ],
          "references": [
            {
              "reference_type": "my_item_classification_code",
              "reference_id": "003"
            }
          ]
        }
      ]
    }
  ]
}
{

5. Consolidated eInvoice

{
  "reporting_schema": [
    {
      "origin": "MY",
      "scheme_id": "MY:LHDNM"
    }
  ],
  "documents": [
    {
      "document_nature": "post_award",
      "document_type": "invoice",
      "document_code": "01",
      "document_currency": "MYR",
      "document_identifier": "INV12555-130",
      "issue_date": "2025-02-21",
      "issue_time": "14:12:33",
      "timezone": "+0000",
      "due_date": "2025-03-17",
      "references": [
        {
          "reference_type": "my_incoterms",
          "reference_id": "E23"
        }
      ],
      "issuing_party": {
        "party": {
          "name": "Issuing Co.",
          "address": {
            "street_1": "Lot 66",
            "street_2": "Bangunan Merdeka",
            "city": "Kuala Lumpur",
            "zip": "50480",
            "county": "14",
            "country": "MY"
          },
          "contact": {
            "email": "general.ams@issuer.com",
            "first_name": "Jony",
            "last_name": "Ponski",
            "phone": "+60-123456789"
          }
        },
        "references": [
          {
            "reference_type": "my_msic",
            "reference_id": "98200"
          },
          {
            "reference_type": "my_industry_description",
            "reference_id": "Industry"
          }
        ],
        "public_identifiers": [
          {
            "scheme_id": "MY:TIN",
            "identifier": "01201901234567"
          },
          {
            "scheme_id": "MY:BRN",
            "identifier": "412342131231"
          },
          {
            "scheme_id": "MY:SST",
            "identifier": "W00001111111111"
          }
        ]
      },
      "receiving_party": {
        "party": {
          "name": "General Public ",
          "address": {
            "street_1": "Lot 66",
            "street_2": "Bangunan Merdeka",
            "city": "Kuala Lumpur",
            "zip": "50480",
            "county": "14",
            "country": "MY"
          }
        },
        "public_identifiers": [
          {
            "scheme_id": "MY:TIN",
            "identifier": "EI00000000010"
          },
          {
            "scheme_id": "MY:NRIC",
            "identifier": "NA"
          }
        ]
      },
      "invoice_line": [
        {
          "line_id": 1,
          "description": "Office Chair - Ergonomic",
          "quantity": 5,
          "uom": "H87",
          "unit_price": 250,
          "taxes": [
            {
              "tax_type": "01",
              "tax_rate": 6
            }
          ],
          "references": [
            {
              "reference_type": "my_item_classification_code",
              "reference_id": "004"
            }
          ]
        }
      ]
    }
  ]
}