Kod penolakan e-Invois LHDN: maksud dan cara membetulkannya
Dikemas kini 18 Oktober 2026
Jawapan ringkas
Penolakan bermaksud pengesah MyInvois LHDN menolak dokumen itu, jadi ia tidak pernah menjadi e-Invois. LHDN memulangkan kod ralat seperti ERR236 atau CV317, ayat yang menerangkannya, dan laluan medan yang salah. Betulkan medan itu dan hantar dokumen yang telah dibetulkan. Dokumen yang ditolak tidak pernah disahkan, jadi tiada apa untuk dibatalkan.
Apa itu penolakan
Setiap dokumen yang dihantar ke MyInvois melalui beberapa pengesah LHDN: struktur, medan teras, butiran pembayar cukai, kod, mata wang, dokumen yang dirujuk dan pendua. Jika mana-mana pengesah gagal, dokumen itu dipulangkan sebagai Invalid bersama sebabnya. Ia bukan e-Invois, tiada kod QR yang disahkan, dan pembeli tidak boleh menggunakannya.
Penolakan berbeza daripada penghantaran yang gagal. Dokumen yang ditolak telah sampai ke LHDN dan melanggar peraturan, jadi menghantarnya semula tanpa perubahan akan gagal lagi. Penghantaran yang gagal tidak pernah sampai, biasanya kerana gangguan rangkaian atau LHDN, dan cubaan semula biasanya berjaya.
Cara membaca ralat LHDN
Setiap penemuan dalam respons LHDN membawa kod ralat, ayat dalam bahasa Inggeris (dan selalunya dalam Bahasa Melayu), dan laluan medan, contohnya kod negeri pembeli atau pengelasan baris 2. Huruf di hadapan kod memberitahu pengesah mana yang menolak dokumen itu:
| Awalan | Pengesah LHDN | Apa yang disemak |
|---|---|---|
| CF | Core Fields | Medan wajib dan formatnya |
| ERR | Taxpayer | TIN, ID pembekal dan pembeli serta peraturan TIN am |
| CV | Code | Nilai daripada jadual kod LHDN (unit, negeri, pengelasan) |
| DC | Currency | Kod mata wang dan kadar pertukaran |
| DR | Referenced Documents | Invois asal yang dirujuk oleh nota |
| DS | Signature | Tandatangan digital pada dokumen bertandatangan |
| DV | Duplicate Document | Dokumen yang sama dihantar dua kali |
Kod penolakan biasa
Ini kod yang mempunyai penjelasan khusus dalam envoice, dibina daripada penolakan sebenar. Setiap satu dipautkan ke halaman dengan ayat LHDN sendiri, punca dan cara membetulkannya.
| Kod | Pengesah LHDN | Apa maksudnya |
|---|---|---|
| ERR236 | Taxpayer | TIN am orang awam pada baris yang bukan pengelasan 004 |
| CV317 | Code | Kod negeri 17 digunakan pada alamat Malaysia |
| ERR250 dan ERR245 | Belum ada dalam rujukan LHDN | E-Invois yang disatukan membawa pembeli sebenar |
| ERR237 | Taxpayer | Pembeli bernama difailkan dengan TIN am orang awam |
| ERR219 | Belum ada dalam rujukan LHDN | Pembekal asing pada dokumen bil sendiri membawa TIN yang salah |
| DR308 | Referenced Documents | Pembeli pada nota bukan pembeli pada invois asal |
| DR319 | Referenced Documents | Dokumen yang dirujuk tidak wujud |
| DR313 | Referenced Documents | Nombor dokumen yang dirujuk tidak sepadan dengan UUIDnya |
| DR303 | Referenced Documents | Dokumen yang dirujuk tidak sah atau telah dibatalkan |
| CV302 | Code | Kod unit atau kod lain tiada dalam senarai kod LHDN |
Cara membetulkan sebarang penolakan
- Baca kod dan laluan medan. Kedua-duanya menyatakan medan mana yang melanggar peraturan mana.
- Buka halaman kod itu di bawah, atau panduan LHDN bagi kod itu, dan betulkan medan tersebut.
- Hantar dokumen yang telah dibetulkan sebagai e-Invois baharu. Jangan batalkan dokumen yang ditolak: ia tidak pernah disahkan.
- Jika kesilapan yang sama datang daripada POS, kedai atau katalog anda, betulkan di sana juga supaya jualan seterusnya tidak mengulanginya.
Cara envoice mengendalikannya
Apabila LHDN menolak dokumen, envoice memaparkan kotak Sebab penolakan padanya. Setiap baris menamakan medan yang salah, menerangkan punca dalam bahasa mudah, memberi cara membetulkannya jika envoice mengetahuinya, dan memetik ayat LHDN sendiri bersama pautan ke panduan LHDN bagi kod itu. Penjelasan dipaparkan dalam bahasa Inggeris atau Bahasa Melayu.
Klik Betulkan & hantar semula untuk membuka borang invois yang telah diisi daripada dokumen yang ditolak, betulkan medan itu, dan hantar sebagai e-Invois baharu. Pemilik kedai juga menerima satu e-mel apabila dokumen ditolak, jadi penolakan tidak hanya ditemui berminggu-minggu kemudian. Lihat panduan Why was my document rejected? (dalam bahasa Inggeris).
Soalan lazim
Apakah kod penolakan LHDN?
Ia kod yang dipulangkan oleh pengesah MyInvois LHDN apabila dokumen melanggar peraturan, seperti ERR236 atau CV317. Huruf menamakan pengesah dan nombor menamakan peraturan.
Perlukah saya membatalkan e-Invois yang ditolak?
Tidak. Dokumen yang ditolak tidak pernah disahkan, jadi ia bukan e-Invois dan tiada apa untuk dibatalkan. Betulkan medan itu dan hantar dokumen yang telah dibetulkan.
Apakah beza antara ditolak dan gagal?
Ditolak bermaksud LHDN menerima dokumen itu dan menolaknya di bawah peraturan pengesahan, jadi ia mesti dibetulkan. Gagal bermaksud ia tidak pernah sampai, biasanya kerana gangguan rangkaian atau LHDN, dan cubaan semula biasanya berjaya.
Di manakah LHDN menerangkan kod ralatnya?
Dalam MyInvois SDK, di bawah Document Validation Rules, LHDN menerbitkan satu halaman bagi setiap pengesah dengan kod ralat biasa, punca yang mungkin dan penyelesaian yang disyorkan.
Adakah envoice menerangkan penolakan dalam Bahasa Melayu?
Ya. envoice memaparkan punca dan cara membetulkannya dalam bahasa mudah, dalam bahasa Inggeris atau Bahasa Melayu, bersama ayat LHDN sendiri dan pautan ke panduan LHDN bagi kod itu.