MyInvois LHDN dan Laman Web Anda: Apa yang Perlu Dilakukan oleh Integrasi yang Praktikal

Mulakan dengan siapa yang sebenarnya meminta

MyInvois bukan ciri laman web yang boleh ditambah begitu sahaja. Ia adalah sistem pentadbiran cukai yang dikendalikan oleh Lembaga Hasil Dalam Negeri (LHDN), badan hasil dalam negeri Malaysia — turut dirujuk sebagai IRBM. Setiap transaksi yang dibuat oleh sesebuah perniagaan yang termasuk dalam mandat e-Invois Malaysia perlu dilaporkan kepada LHDN, disahkan oleh mereka, dan dikembalikan dengan pengecam unik serta kod QR sebelum ia dikira sebagai invois cukai yang sah. Sama ada laman web terlibat atau tidak, kewajipan itu terletak pada perniagaan, bukan pada laman web. Apa yang integrasi laman web perlu lakukan ialah memastikan data jualan perniagaan itu masuk ke dalam aliran pelaporan tersebut dengan betul dan tepat pada masanya — tidak lebih, tidak kurang.

Ini wajar dinyatakan dengan jelas kerana banyak kekeliruan sekitar "e-Invois untuk laman web" berpunca daripada menganggapnya sebagai masalah reka bentuk atau checkout, sedangkan sebenarnya ia adalah masalah perakaunan dan pematuhan yang kebetulan memerlukan sambungan teknikal ke dalam platform yang menjalankan kedai tersebut.

Kedudukan semasa, setakat 31 Ogos 2026

Pelaksanaan berlaku secara berfasa berdasarkan perolehan tahunan, dan — penting untuk sesiapa yang membaca artikel lama tentang perkara ini — sempadan fasa dan ambang pengecualian telah disemak semula lebih daripada sekali sejak mandat ini pertama kali diumumkan. Berdasarkan halaman garis masa pelaksanaan rasmi LHDN sendiri (dikemas kini terakhir pada 30 Ogos 2026), fasa-fasanya adalah:

• Fasa 1 — perniagaan dengan perolehan tahunan melebihi RM100 juta: berkuat kuasa 1 Ogos 2024
• Fasa 2 — perolehan tahunan melebihi RM25 juta sehingga RM100 juta: berkuat kuasa 1 Januari 2025
• Fasa 3 — perolehan tahunan melebihi RM5 juta sehingga RM25 juta: berkuat kuasa 1 Julai 2025
• Fasa 4 — perolehan tahunan sehingga RM5 juta: berkuat kuasa 1 Januari 2026

Halaman yang sama menyatakan bahawa pembayar cukai dengan perolehan atau hasil tahunan di bawah RM3,000,000 dikecualikan sepenuhnya daripada pelaksanaan e-Invois. Memandangkan betapa kerapnya ambang ini berubah, anggap ini sebagai gambaran pada satu masa tertentu, bukan fakta kekal, dan semak sendiri halaman garis masa rasmi LHDN secara langsung untuk kedudukan terkini sebelum membuat keputusan berdasarkannya: hasil.gov.my — e-Invoice Implementation Timeline.

Jika perniagaan anda hampir dengan mana-mana ambang ini, atau perolehan anda baru-baru ini berpindah antara kumpulan (band), adalah wajar untuk mengesahkan fasa anda sendiri secara terus dengan LHDN atau penasihat cukai anda, dan bukan bergantung kepada ambang yang anda baca di tempat lain — termasuk artikel ini, beberapa bulan dari sekarang.

Portal MyInvois berbanding integrasi API — dua permintaan teknikal yang berbeza

LHDN menyediakan dua cara berbeza untuk menghantar e-Invois, dan kedua-duanya membawa kepada jumlah kerja pembangunan yang sangat berbeza.

Portal MyInvois adalah sistem berasaskan web yang disediakan terus oleh IRBM. Sesebuah perniagaan (atau kakitangannya) log masuk dan mencipta e-Invois secara manual, satu demi satu atau melalui templat muat naik pukal (bulk upload). Ia tidak memerlukan sebarang kerja integrasi langsung — tiada kod, tiada sambungan ke laman web atau sistem perakaunan anda — tetapi ini bermakna seseorang perlu memasukkan atau memuat naik semula data transaksi secara manual, yang tidak berskala dengan baik apabila jumlah pesanan meningkat.

Integrasi API menyambungkan sistem perniagaan itu sendiri — ERP, platform perakaunan, atau dalam konteks ini, sistem pesanan/checkout laman web — terus kepada MyInvois, supaya e-Invois dijana dan dihantar secara automatik semasa transaksi berlaku, tanpa kemasukan semula secara manual. Inilah pilihan yang benar-benar layak dipanggil "integrasi laman web": laman web anda (atau platform di sebaliknya) perlu membina rekod invois yang mematuhi keperluan dan menghantarnya kepada sistem LHDN melalui antara muka rasmi mereka, kemudian mengendalikan apa jua respons yang diterima — kejayaan, penolakan, atau permintaan pembetulan — sebagai sebahagian daripada aliran pesanan.

Mana satu yang sesuai untuk sesebuah perniagaan bergantung sepenuhnya kepada jumlah transaksi dan sistem sedia ada, bukan pada mana yang kedengaran lebih "betul". Perniagaan perkhidmatan bervolum rendah dengan beberapa invois sebulan mungkin benar-benar cukup dilayani oleh Portal manual. Kedai WooCommerce yang memproses berpuluh-puluh pesanan sehari pula tidak — kerja integrasi itu cepat berbaloi dari segi masa kakitangan yang dijimatkan.

Apa yang sebenarnya perlu dilakukan oleh integrasi laman web

Pada tahap praktikal, laluan API bermakna laman web (atau platform di sebaliknya) perlu dapat:

1. Menangkap data yang diperlukan oleh e-Invois — butiran pembeli dan penjual, item baris berperincian (itemised), layanan cukai, dan medan-medan lain yang dinyatakan dalam Garis Panduan e-Invois LHDN — pada titik jualan, bukan dibina semula selepas itu.
2. Menghantar data itu kepada sistem LHDN dalam format yang dikehendaki oleh garis panduan semasa mereka, dan mengendalikan respons pengesahan, yang menurut dokumentasi rasmi LHDN sendiri biasanya dikembalikan dengan pantas.
3. Menyimpan dan memaparkan hasil yang disahkan — pengecam unik dan kod QR yang dikeluarkan semula oleh LHDN — bersama pesanan berkenaan, supaya ia boleh ditunjukkan kepada pelanggan atau dilampirkan pada resit.
4. Mengendalikan penolakan dan pembatalan dengan betul. Garis panduan IRBM menerangkan tempoh terhad selepas penghantaran di mana e-Invois masih boleh ditolak atau dibatalkan; selepas tempoh itu, pembetulan perlu dilakukan melalui mekanisme berasingan (seperti nota kredit), bukan dengan menyunting rekod asal.
5. Membuat keputusan tentang cara mengendalikan jualan pengguna di mana pembeli tidak memerlukan invois individu. Garis Panduan Khusus e-Invois LHDN membenarkan pembekal meringkaskan transaksi ini ke dalam satu e-Invois konsolidasi yang meliputi sesuatu tempoh, dihantar selepas itu, dan bukannya mengeluarkan satu invois bagi setiap transaksi — dengan kategori transaksi tertentu dikecualikan daripada konsolidasi di bawah garis panduan tersebut. Sama ada ini terpakai kepada sesuatu kedai, dan transaksi mana yang layak, adalah keputusan perniagaan dan perakaunan yang perlu disahkan berdasarkan garis panduan semasa (atau bersama penasihat cukai) sebelum dibina ke dalam aliran checkout — bukan diandaikan daripada huraian umum seperti artikel ini.

Tiada satu pun daripada ini kejuruteraan yang eksotik, tetapi kesemuanya bergantung kepada versi terkini garis panduan LHDN, yang sudah pun disemak semula beberapa kali (Garis Panduan e-Invois dan Garis Panduan Khusus e-Invois kedua-duanya berada pada versi 4.x setakat pertengahan 2026). Integrasi laman web yang dibina berdasarkan versi lama spesifikasi tersebut, atau berdasarkan ambang yang sudah berubah, adalah risiko pematuhan yang senyap-senyap wujud dalam kod. Inilah jenis butiran yang sepatutnya diambil daripada garis panduan rasmi LHDN yang terkini semasa pembinaan, bukan daripada huraian yang ditulis beberapa bulan lebih awal — termasuk artikel ini.

Apa yang kami tidak akan teka

Kami sengaja tidak menyenaraikan spesifikasi teknikal penuh medan demi medan di sini, atau menegaskan angka tepat untuk perkara seperti ambang nilai yang melebihi had transaksi tidak boleh dimasukkan dalam e-Invois konsolidasi — tahap perincian itu berubah mengikut semakan garis panduan, dan tersilap dalam sesebuah artikel adalah jenis kesilapan yang cuba dielakkan oleh penulisan ini. Untuk versi rasmi dan terkini bagi mana-mana butiran ini, rujuk terus garis panduan e-Invois LHDN: hasil.gov.my/en/e-invoice.

Jika anda mahukan pendapat kedua

Jika anda cuba mengenal pasti kedudukan perniagaan anda dalam jadual fasa semasa, sama ada data pesanan laman web anda distrukturkan dengan cara yang boleh menyokong integrasi API, atau sama ada Portal itu sendiri sudah mencukupi untuk volum anda, Essential System Review JagaWeb (RM1,500, diturunkan kepada RM999 sehingga 16 September 2026, tidak termasuk SST) adalah semakan teknikal berskop tetap yang boleh melihat apa yang sebenarnya ditangkap oleh laman web semasa anda di checkout. Ia adalah salah satu pilihan antara beberapa cara untuk mendapatkan pandangan luar yang praktikal sebelum melabur dalam pembinaan — bukan pengganti nasihat daripada penasihat cukai anda tentang kewajipan mana yang sebenarnya terpakai kepada perniagaan anda.

Ini maklumat umum tentang kesan e-Invois terhadap laman web, bukan nasihat cukai. LHDN menyemak semula garis panduannya dari semasa ke semasa — sahkan obligasi anda sendiri terhadap garis panduan semasa di hasil.gov.my, atau dengan ejen cukai anda.