Panduan · Pemetaan CSV

Rujukan lajur CSV: pemetaan dirancang yang penghurai jambatan terima.

Nota: import CSV dalam pelan hala tuju — belum aktif. Panduan ini menunjukkan rujukan lajur yang dirancang supaya anda boleh sediakan pemetaan eksport lebih awal. Hari ini, hantar invois dengan API REST (pelan Pro) atau masukkan dalam papan pemuka. Di bawah ialah rujukan lajur penuh, dikumpulkan mengikut tujuan, dengan medan LHDN yang setiap lajur petakan.

Medan asas wajib

8 lajur yang setiap baris mesti bawa.

Lapan lajur ini tidak boleh dirunding untuk setiap jenis dokumen. Hilang mana-mana satu dan penghurai menolak baris sebelum ia tiba di LHDN.

Invoice No: nombor invois dalaman anda (mana-mana string).
Invoice Type: salah satu daripada 8 kod LHDN (01, 02, 03, 04, 11, 12, 13, 14).
Invoice Date: format ISO (YYYY-MM-DD).
Currency Code: ISO 4217 (MYR untuk Ringgit, USD, dll).
Line No: nombor item baris dalam invois.
Qty Inv: kuantiti diinvois untuk baris.
Unit Price: harga seunit sebelum cukai.
Total Including Tax: jumlah termasuk cukai yang digulung.

Medan rakan niaga

Diperlukan untuk invois standard (01–04).

Invois standard yang dikeluarkan pembekal memerlukan pihak pelanggan dikenal pasti. Jenis self-billed (11 hingga 14) memperoleh pelanggan daripada rekod DB syarikat, jadi kedua-dua lajur ini menjadi pilihan dalam kes itu.

Customer Name: nama perniagaan berdaftar rakan niaga.
Customer TIN No: TIN LHDN rakan niaga.
Customer Address, City, State, Postcode, Country: medan alamat.
Customer SST No, BRN: pilihan tetapi disyorkan untuk B2B.

Medan self-billed

Tiga tambahan diperlukan untuk jenis 11–14.

Jenis self-billed membawa invarian tambahan di atas asas lapan: pihak pembekal (yang dibayar) mesti dikenal pasti sepenuhnya, termasuk kod klasifikasi industri MSIC yang LHDN gunakan untuk layanan cukai.

Customer Name (pihak yang dibayar): medan sama, peranan berbeza.
Customer TIN No (pihak yang dibayar).
Customer MSIC Code: MSIC 5-digit, disahkan terhadap regex /^\d{5}$/.

Medan dokumen nota

Dua tambahan diperlukan untuk jenis 02, 03, 04, 12, 13, 14.

Setiap dokumen nota (kredit, debit, bayar balik; dikeluarkan pembekal atau self-billed) mesti merujuk invois induk yang diubahsuainya.

Original Invoice No: rujukan dalaman anda kepada induk.
Reference Invoice No: UUID LHDN dokumen induk.

Medan berangka + pilihan

Segala-galanya yang penghurai terima.

Pengimport yang dirancang akan mengesahkan medan berangka dan khusus LHDN sebelum penghantaran. Lajur dan had tepat akan diterbitkan apabila import CSV dilancarkan; ia bukan jaminan produk hari ini.

Hubungi kami

Dikemas kini terakhir · Julai 2026

Rujukan bebas. MyInvois dikendalikan oleh LHDN. Kami bukan gabungan LHDN.