# e-Invoice Data Fields Reference

> Kesemua 55 medan e-Invois yang diperlukan berserta status wajib atau pilihan, medan anexur, senarai kod LHDN, dan validator yang menolak setiap jenis ralat.

- Category: taxation
- Language: ms
- Status: published
- Updated: 2026-07-20
- Canonical: https://negaraku.md/taxation/e-invoice-data-fields

---

Setiap penyerahan yang ditolak boleh dikesan kembali kepada salah satu daripada
dua perkara: medan yang dianggap wajib oleh LHDN tetapi dianggap pilihan oleh
ERP anda, atau nilai kod yang tiada dalam senarai LHDN. Halaman ini ialah
senarai medan tersebut, sebagaimana diterbitkan dalam Appendix 1 dan Appendix 2
Garis Panduan e-Invois versi 4.7.

Formatnya ialah **XML atau JSON**, kedua-duanya mesti mematuhi **UBL 2.1**.
LHDN mengelompokkan 55 medan ini kepada lapan kategori: Address, Business
Details, Contact Number, Invoice Details, Parties, Party Details, Payment
Info, dan Products / Services.

## 55 medan

**M** = wajib · **C** = wajib bersyarat · **O** = pilihan

### Pihak dan butiran pihak

| # | Medan | Status | Nota |
| --- | --- | --- | --- |
| 1 | Nama Pembekal | M | |
| 2 | Nama Pembeli | M | General Public pada e-Invois konsolidasi |
| 3 | TIN Pembekal | M | Kod TIN am terpakai jika tiada |
| 4 | Nombor Pendaftaran / Pengenalan / Pasport Pembekal | M | Pendaftar SSM hanya menggunakan **BRN 12-aksara baharu** |
| 5 | Nombor Pendaftaran SST Pembekal | **C** | Wajib bagi pendaftar SST |
| 6 | Nombor Pendaftaran Cukai Pelancongan Pembekal | **C** | Wajib bagi pendaftar cukai pelancongan |
| 7 | E-mel Pembekal | O | |
| 8 | Kod MSIC Pembekal | M | 5 digit angka; 00000 jika tiada bagi pembekal asing |
| 9 | Perihalan Aktiviti Perniagaan Pembekal | M | |
| 10 | TIN Pembeli | M | |
| 11 | Nombor Pendaftaran / Pengenalan / Pasport Pembeli | M | |
| 12 | Nombor Pendaftaran SST Pembeli | **C** | Wajib bagi pendaftar SST |
| 13 | E-mel Pembeli | O | |

### Alamat dan hubungan

| # | Medan | Status |
| --- | --- | --- |
| 14 | Alamat Pembekal | M |
| 15 | Alamat Pembeli | M |
| 16 | Nombor Telefon Pembekal | M |
| 17 | Nombor Telefon Pembeli | M |

### Butiran invois

| # | Medan | Status | Nota |
| --- | --- | --- | --- |
| 18 | Versi e-Invois | M | SVDP 1.2 / 1.3 hanya untuk pendedahan sukarela |
| 19 | Jenis e-Invois | M | Lihat senarai kod di bawah |
| 20 | Kod / Nombor e-Invois | M | Rujukan sendiri pembekal |
| 21 | Nombor Rujukan e-Invois Asal | **C** | Wajib pada nota kredit, nota debit dan nota bayaran balik |
| 22 | Tarikh dan Masa e-Invois | M | **Mesti tarikh dan masa semasa** |
| 23 | Tandatangan Digital Pengeluar | M | Sijil penyedia perkhidmatan jika digunakan |
| 24 | Kod Mata Wang Invois | M | |
| 25 | Kadar Pertukaran Mata Wang | **C** | Wajib jika mata wang bukan ringgit |
| 26 | Kekerapan Pengebilan | O | |
| 27 | Tempoh Pengebilan | O | |

### Produk dan perkhidmatan

| # | Medan | Status | Nota |
| --- | --- | --- | --- |
| 28 | Klasifikasi | M | Kod 3 digit daripada katalog LHDN |
| 29 | Perihalan Produk atau Perkhidmatan | M | Nombor rujukan resit pada e-Invois konsolidasi |
| 30 | Harga Seunit | M | |
| 31 | Jenis Cukai | M | Peringkat baris dan invois |
| 32 | Kadar Cukai | **C** | |
| 33 | Jumlah Cukai | M | Peringkat baris dan invois |
| 34 | Butiran Pengecualian Cukai | **C** | Wajib jika pengecualian terpakai |
| 35 | Jumlah Dikecualikan Cukai | **C** | Wajib jika pengecualian terpakai |
| 36 | Jumlah Kecil | M | Peringkat baris sahaja |
| 37 | Jumlah Tidak Termasuk Cukai | M | Peringkat baris dan invois |
| 38 | Jumlah Termasuk Cukai | M | Peringkat invois sahaja |
| 39 | Jumlah Bersih Keseluruhan | O | Peringkat invois sahaja |
| 40 | Jumlah Perlu Dibayar | M | Peringkat invois sahaja |
| 41 | Jumlah Pembundaran | O | Peringkat invois sahaja |
| 42 | Jumlah Boleh Cukai Mengikut Jenis Cukai | O | Peringkat invois sahaja |
| 43 | Kuantiti | O | |
| 44 | Ukuran | O | |
| 45 | Kadar Diskaun | O | |
| 46 | Jumlah Diskaun | O | |
| 47 | Kadar Fi / Caj | O | |
| 48 | Jumlah Fi / Caj | O | |

### Maklumat pembayaran

| # | Medan | Status |
| --- | --- | --- |
| 49 | Cara Bayaran | O |
| 50 | Nombor Akaun Bank Pembekal | O |
| 51 | Terma Pembayaran | O |
| 52 | Jumlah Prabayaran | O |
| 53 | Tarikh Prabayaran | O |
| 54 | Nombor Rujukan Prabayaran | O |
| 55 | Nombor Rujukan Bil | O |

## Medan anexur

| Medan | Status | Berkenaan dengan |
| --- | --- | --- |
| Nombor Rujukan Borang Kastam No. 1, 9 dan lain-lain | **Wajib** | Import barangan |
| Nombor Rujukan Borang Kastam No. 2 | Pilihan | Eksport barangan |
| Nama / Alamat / TIN / Nombor Pendaftaran atau Pasport Penerima Penghantaran | Pilihan | Barangan dihantar kepada seseorang selain pembeli |
| Incoterms | Pilihan | Import dan eksport barangan |
| Kod Tarif Produk | Pilihan | Barangan sahaja |
| Maklumat Perjanjian Perdagangan Bebas | Pilihan | Eksport sahaja, jika berkenaan |
| Nombor Kebenaran untuk Pengeksport Bertauliah, contohnya nombor ATIGA | Pilihan | Eksport sahaja, jika berkenaan |
| Negara Asal | Pilihan | Import dan eksport barangan |
| Butiran caj lain | Pilihan | Import dan eksport barangan |

LHDN menyatakan keperluan anexur ini boleh dikemas kini dari semasa ke semasa.

## Senarai kod

**Jenis e-Invois**

| Kod | Jenis | | Kod | Jenis |
| --- | --- | --- | --- | --- |
| 01 | Invoice | | 11 | Self-billed Invoice |
| 02 | Credit Note | | 12 | Self-billed Credit Note |
| 03 | Debit Note | | 13 | Self-billed Debit Note |
| 04 | Refund Note | | 14 | Self-billed Refund Note |

**Jenis Cukai**

| Kod | Jenis |
| --- | --- |
| 01 | Cukai Jualan |
| 02 | Cukai Perkhidmatan |
| 03 | Cukai Pelancongan |
| 04 | Cukai Barangan Bernilai Tinggi |
| 05 | Cukai Jualan atas Barangan Bernilai Rendah |
| 06 | Tidak Berkenaan |
| E | Pengecualian cukai, jika berkenaan |

**TIN Am** (e-Invoice Specific Guideline, Appendix 1)

| Kod | Kegunaan |
| --- | --- |
| EI00000000010 | General Public — individu Malaysia yang hanya memiliki MyKad; pembeli pada e-Invois konsolidasi; pembekal pada e-Invois konsolidasi dikeluarkan sendiri (self-billed) |
| EI00000000020 | Pembeli asing atau penerima penghantaran asing |
| EI00000000030 | Pembekal asing, dikeluarkan sendiri (self-billed) |
| EI00000000040 | Kerajaan, pihak berkuasa negeri dan tempatan, badan berkanun, institusi dikecualikan |

SDK turut menerbitkan kod klasifikasi, kod negara, kod mata wang, kod MSIC,
cara bayaran, kod negeri dan unit ukuran.

## Validator dan punca ia tercetus

| Validator | Masa | Punca biasa kegagalan |
| --- | --- | --- |
| **Structure** | Serta-merta | XML atau JSON yang tidak sah format, atau dokumen yang tidak sepadan dengan struktur yang diperlukan bagi jenis dan versi itu di bawah UBL 2.1 |
| **Core Fields** | Serta-merta | Satu medan wajib tiada |
| **Code** | Serta-merta dan latar belakang | Nilai kod mata wang, jenis cukai atau kod lain yang tiada dalam senarai LHDN |
| **Signature** | Latar belakang | Tandatangan digital gagal disahkan |
| **Taxpayer** | Latar belakang | TIN yang dirujuk dalam dokumen tidak sah pada tarikh dokumen itu dikeluarkan |
| **Referenced Documents** | Latar belakang | Nota kredit, nota debit atau nota bayaran balik merujuk kepada dokumen yang bukan e-Invois sah pada masa ia dikeluarkan |
| **Duplicate Document** | Latar belakang | Dokumen yang hampir serupa telahpun dihantar — kod ralat **DS302** |

Status dokumen berubah daripada **Submitted → Valid** atau **Invalid**.
*Submitted* hanya bermaksud semakan struktur dan medan teras telah lulus;
validator latar belakang masih boleh menggagalkannya.

Ralat peringkat pengangkutan menggunakan pemetaan HTTP standard: `BadRequest`
dan `BadArgument` (400), `Unauthorized` (401), `Forbidden` (403), `NotFound`
(404), `TooManyRequests` (429, dengan header `Retry-After`),
`InternalServerError` (500), `NotImplemented` (501), `ServiceUnavailable`
(503).

## Membetulkan dokumen yang bermasalah

- **Dalam tempoh 72 jam selepas pengesahan** — pembekal boleh membatalkan,
  atau pembeli boleh memohon penolakan dan pembekal kemudian membatalkannya.
  Selepas 72 jam, kedua-duanya tidak lagi boleh dilakukan.
- **Dalam tempoh tiga hari selepas mengeluarkan e-Invois yang rosak** —
  s.82C(8) Akta Cukai Pendapatan 1967 membenarkan **e-Invois gantian**.
- **Selepas itu** — keluarkan e-Invois nota kredit, nota debit atau nota
  bayaran balik yang merujuk kepada yang asal pada medan 21.

## Kesilapan lazim

- **Menghantar nombor pendaftaran SSM yang lama.** Medan 4 memerlukan BRN 12
  digit yang baharu bagi pendaftar SSM.
- **Mengundurkan tarikh medan 22.** LHDN memerlukan tarikh dan masa semasa;
  dokumen yang tarikhnya diundurkan akan gagal.
- **Membiarkan MSIC kosong bagi pembekal asing.** Gunakan 00000, bukan nilai
  kosong.
- **Menggunakan jenis cukai 06 untuk maksud dikecualikan.** 06 ialah *Tidak
  Berkenaan*; pengecualian ialah E, dan ia menjadikan medan 34 dan 35 wajib.
- **Menghantar semula penyerahan yang gagal tanpa perubahan.** Validator
  pendua akan mencetuskan DS302, bukan menerimanya.
- **Menganggap respons Submitted sebagai berjaya.** Hanya *Valid* bermaksud
  berjaya.

## Apa seterusnya

Petakan medan 3, 4, 5, 8, 10, 11 dan 12 terhadap data induk pelanggan dan
pembekal anda sebelum menulis sebarang kod — tujuh medan itulah yang
sebenarnya menghabiskan masa pembersihan data. Kemudian tentukan laluan
penghantaran, kerana Portal mengisi medan-medan ini melalui borang manakala
API menjadikannya masalah anda sendiri.

## Sources

- e-Invoice Guideline (Version 4.7) — Appendices 1 and 2 — https://www.hasil.gov.my/wp-content/uploads/IRBM-e-Invoice-Guideline.pdf (LHDN)
- MyInvois SDK — document validation rules — https://sdk.myinvois.hasil.gov.my/document-validation-rules/ (LHDN)
- MyInvois SDK — code lists — https://sdk.myinvois.hasil.gov.my/codes/ (LHDN)
- MyInvois SDK — standard error response — https://sdk.myinvois.hasil.gov.my/standard-error-response/ (LHDN)
- e-Invoice Specific Guideline (Version 4.8) — Appendix 1, list of general TIN — https://www.hasil.gov.my/wp-content/uploads/IRBM-e-Invoice-Specific-Guideline.pdf (LHDN)

---
Source of truth: https://github.com/negaraku-md/NegaraKu.md
License: CC BY-SA 4.0