Malaysia (MY) Field Mapping

Country: MY
Compliance: LHDN e-invoicing
Last Updated: 2026

Requirement Legend

M: Mandatory
CM: Conditional Mandatory (required only when condition applies)
O: Optional

Field Mapping Reference

1) Core Invoice Information

Malaysia Field	GETS Schema Path	Mandatory	Notes
e-Invoice Type Code	`header.documentType`	M	Hierarchical object
e-Invoice Code / Number	`header.documentNumber`	M	Unique identifier
Original e-Invoice Reference Number	`header.referenceId`	CM	Required for credit/debit/refund notes
e-Invoice Date	`header.issueDate`	M	`YYYY-MM-DD`
e-Invoice Time	`header.issueTime`	M	`HH:MM:SSZ`
Issuer's Digital Signature	`extensions.my_digitalSignature`	CM	System-generated
Invoice Currency Code	`header.currency`	M	ISO 4217
Currency Exchange Rate	`header.exchangeRate.rate`	CM	Required if currency != `MYR`
Frequency of Billing	`header.invoicePeriod.frequency`	O	Billing frequency
Billing Period Start Date	`header.invoicePeriod.startDate`	O	`YYYY-MM-DD`
Billing Period End Date	`header.invoicePeriod.endDate`	O	`YYYY-MM-DD`

2) Supplier (Seller) Details

Malaysia Field	GETS Schema Path	Mandatory	Notes
Supplier ID	`parties.seller.partyId`	O	Internal identifier
Seller Peppol ID	`parties.seller.peppolId`	O	For Peppol network
Supplier's Name	`parties.seller.name`	M	Legal name
Supplier's TIN	`parties.seller.taxIds[type="TIN"].value`	M	`C` + 10 digits
Supplier's Registration scheme ID	`parties.seller.registrationNumbers[].type`	M	`BRN`, `NRIC`, `Passport`, etc.
Supplier's Registration Number	`parties.seller.registrationNumbers[].value`	M	Registration value
Supplier's SST Registration Number	`parties.seller.registrationNumbers[type="SST"].value`	M	SST number
Supplier's Tourism Tax Registration	`parties.seller.registrationNumbers[type="TTR"].value`	M	Tourism tax registration
Supplier's e-mail	`parties.seller.contact.email`	O	Contact email
Supplier's MSIC Code	`parties.seller.industryClassification.code`	M	5-digit MSIC
Supplier's Business Activity	`parties.seller.businessActivityDescription`	M	Business activity text
Supplier's Contact Number	`parties.seller.contact.phone`	M	Phone number
Address Line 1	`parties.seller.address.addressLine1`	M	Primary address
Address Line 2	`parties.seller.address.addressLine2`	O	Secondary address
Address Line 3	`parties.seller.address.addressLine3`	O	Additional address
Postal Zone	`parties.seller.address.postalCode`	O	Postal code
City Name	`parties.seller.address.city`	M	City/town
State	`parties.seller.address.stateOrProvince`	M	Malaysian state
Country	`parties.seller.address.country`	M	ISO code (usually `MY`)

3) Buyer Details

Malaysia Field	GETS Schema Path	Mandatory	Notes
Buyer ID	`parties.buyer.partyId`	O	Internal identifier
Buyer Peppol ID	`parties.buyer.peppolId`	O	For Peppol network
Buyer's Name	`parties.buyer.name`	CM	Mandatory except receipts
Buyer's TIN	`parties.buyer.taxIds[type="TIN"].value`	CM	Mandatory except receipts
Buyer's Registration Scheme ID	`parties.buyer.registrationNumbers[].type`	M	`BRN`, `NRIC`, etc.
Buyer's Registration Number	`parties.buyer.registrationNumbers[].value`	M	Registration value
Buyer's SST Registration Number	`parties.buyer.registrationNumbers[type="SST"].value`	CM	When applicable
Buyer's e-mail	`parties.buyer.contact.email`	O	Contact email
Buyer's Contact Number	`parties.buyer.contact.phone`	M	Phone number
Address Line 1	`parties.buyer.address.addressLine1`	M	Primary address
Address Line 2	`parties.buyer.address.addressLine2`	O	Secondary address
Address Line 3	`parties.buyer.address.addressLine3`	O	Additional address
Postal Zone	`parties.buyer.address.postalCode`	O	Postal code
City Name	`parties.buyer.address.city`	M	City/town
State	`parties.buyer.address.stateOrProvince`	M	Malaysian state
Country	`parties.buyer.address.country`	M	ISO code

4) Invoice Line Items

Malaysia Field	GETS Schema Path	Mandatory	Notes
Line ID	`lineItems[].id`	O	Line identifier
Classification	`lineItems[].commodityClassification.code`	M	`001`-`022` or `PTC`
Product Tariff Code	`lineItems[].commodityCode`	O	For goods only
Country of Origin	`lineItems[].countryOfOrigin`	O	ISO country code
Description	`lineItems[].description`	M	Line description
Unit Price	`lineItems[].price.amount`	M	Price per unit
Measurement	`lineItems[].unitCode`	O	Unit code
Quantity	`lineItems[].quantity`	O	Invoiced quantity
Discount Rate	`lineItems[].discountsOrCharges[isCharge=false].percent`	O	Discount %
Discount Amount	`lineItems[].discountsOrCharges[isCharge=false].amount`	O	Discount amount
Charge Rate	`lineItems[].discountsOrCharges[isCharge=true].percent`	O	Charge %
Charge Amount	`lineItems[].discountsOrCharges[isCharge=true].amount`	O	Charge amount
Total Excluding Tax	`lineItems[].lineTaxableValue`	M	Net amount before tax
Tax Type	`lineItems[].taxCategory`	CM	Blank for consolidated
Tax Rate	`lineItems[].taxRate`	CM	Tax percentage
Tax Amount	`lineItems[].taxAmount`	M	Tax amount
Details of Tax Exemption	`lineItems[].taxExemptionReason`	O	Exemption reason
Amount Exempted from Tax	`lineItems[].extensions.my_taxExemptionAmount`	CM	MY-specific extension
Line Total	`lineItems[].lineTotal`	O	Including tax

5) Summary (Totals)

Malaysia Field	GETS Schema Path	Mandatory	Notes
Sum of Line Level Taxable Amounts	`totals.totalLineTaxableAmount`	O	Sum of taxable values
Total Discount Value	`totals.totalAllowances`	O	Total discounts
Total Fee / Charge Amount	`totals.totalCharges`	O	Total charges
Invoice Additional Discount	`allowancesAndCharges[isCharge=false].amount`	O	Document-level discount
Invoice Additional Charge	`allowancesAndCharges[isCharge=true].amount`	O	Document-level charge
Total Excluding Tax	`totals.totalAmountExcludingTax`	M	Amount before tax
Tax Type	`taxTotals[].taxSubtotals[].taxCategory`	M	Tax category
Total Taxable Amount Per Tax Type	`taxTotals[].taxSubtotals[].taxableAmount`	O	By tax type
Total Tax Amount Per Tax Type	`taxTotals[].taxSubtotals[].taxAmount`	M	By tax type
Details of Tax Exemption	`taxTotals[].taxSubtotals[].taxExemptionReason`	O	Exemption details
Amount Exempted from Tax	`extensions.my_totalTaxExemption`	CM	MY-specific extension
Total Tax Amount	`totals.totalTaxAmount`	M	Total tax
Invoice Total Including Tax	`totals.totalAmountIncludingTax`	M	Grand total
PrePayment Amount	`totals.prepaidAmount`	O	Prepaid amount
Total Payable Amount	`totals.amountDue`	M	Final due
Rounding Amount	`totals.roundingAmount`	O	Rounding adjustment

6) Payment Details

Malaysia Field	GETS Schema Path	Mandatory	Notes
Payment Mode	`payment.paymentMeans[].paymentMeansCode`	O	`01`, `02`, `03`, `08`
Supplier's Bank Account	`payment.paymentMeans[].creditTransferInfo.payeeFinancialAccountId`	O	Account number
Payment Terms	`payment.paymentTerms[].note`	O	Terms text
PrePayment Date	`extensions.my_prepaymentDate`	O	MY-specific
PrePayment Time	`extensions.my_prepaymentTime`	O	MY-specific
PrePayment Reference	`payment.paymentMeans[].paymentId`	O	Reference
Bill Reference Number	`supportingDocuments[documentType="bill"].id`	O	Bill reference

7) Export Details

Malaysia Field	GETS Schema Path	Mandatory	Notes
Customs Form Reference	`supportingDocuments[documentType="customs_form"].id`	O	Customs K1/K2
Incoterms	`parties.delivery.deliveryTerms[].incoterms`	O	FOB/CIF etc.
FTA Information	`supportingDocuments[documentType="FTA"].id`	O	FTA reference
Certified Exporter Auth	`supportingDocuments[documentType="export_auth"].id`	O	Authorization number
Customs Form No.2	`supportingDocuments[documentType="customs_form_2"].id`	O	Additional customs doc
Shipment ID	`supportingDocuments[documentType="shipment"].id`	O	Shipment identifier
Shipment Amount	`extensions.my_shipmentAmount`	O	MY extension
Shipment Charge Reason	`extensions.my_shipmentChargeReason`	O	MY extension

Code Lists Reference

Malaysia Document Types (MyInvois)

Code	Document Type	GETS `base`	GETS `variant`
01	Invoice	`tax_invoice`	—
02	Credit Note	`credit_note`	—
03	Debit Note	`debit_note`	—
04	Refund Note	`credit_note`	`refund`

Malaysia Modifiers (Transaction Scenarios)

Modifier	Applies To	Cannot Combine With
`self_billed`	All base types	`export`
`export`	All base types	`self_billed`
`summary`	All base types	—

Malaysia Tax Category Codes

Code	Description
01	Standard rate (SST)
00	Zero-rated

Malaysia Payment Means Codes

Code	Description
01	Cash
02	Cheque
03	Credit Transfer
08	GIRO

Malaysia Classification Codes

Code	Description
001	Goods
002	Services
...	Other valid `001`-`022` codes
PTC	Person to Consumer

See Also