e-Invois LHDN untuk Magento 2: module MyInvois percuma (Malaysia)
Dikemas kini 9 November 2026
Jawapan ringkas
Magento Open Source dan Adobe Commerce tidak boleh menghantar e-Invois ke LHDN MyInvois dengan sendirinya. Module Magento 2 percuma daripada envoice melakukannya: ia menghantar pesanan berbayar, jualan B2C disatukan dan credit memo ke MyInvois di latar belakang melalui cron Magento. Tiada yuran pembinaan. Anda hanya membayar pelan envoice bulanan, dari RM0.
Adakah Magento menyokong MyInvois?
Tidak. Magento Open Source mahupun Adobe Commerce tidak menyambung ke sistem MyInvois Malaysia secara lalai. Invois Magento ialah rekod bayaran dalam kedai anda, bukan e-Invois LHDN yang disahkan. Untuk mematuhi peraturan, setiap jualan perlu sampai ke LHDN dalam format yang ditetapkan dan kembali dengan kod QR pengesahan.
Apakah pilihan e-Invois untuk Magento?
| Portal MyInvois | Module yang dibina khas | Module envoice percuma | |
|---|---|---|---|
| Kos module | Tiada | Yuran pembinaan sekali | RM0 |
| Kos bulanan | RM0, ditambah masa kakitangan | Masa pembangun untuk setiap pembaikan | Pelan envoice, RM0 hingga RM500 |
| Penghantaran | Anda menaip setiap jualan | Automatik, seperti yang dibina | Automatik, melalui cron Magento |
| e-Invois yang Disatukan B2C | Anda sediakan setiap bulan | Hanya jika dibina | Terbina dalam |
| Nota Kredit untuk bayaran balik | Secara manual | Hanya jika dibina | Dihantar daripada credit memo |
| Perubahan peraturan LHDN | Anda pantau sendiri | Anda bayar untuk mengemas kini | Dikemas kini oleh envoice |
Bagaimana menyambungkan Magento ke LHDN MyInvois?
- Pasang module percuma dengan Composer (composer require envoice/module-einvoice) atau ekstrak muat turun dari envoice.my ke dalam app/code, kemudian jalankan bin/magento setup:upgrade.
- Di Stores > Configuration > envoice > LHDN e-Invoice, klik Connect to envoice, log masuk, dan pilih kedai envoice anda. Mulakan secara percuma jika anda belum mempunyai akaun.
- Masukkan Client ID dan Client Secret LHDN MyInvois anda dalam envoice. Sijil digital tidak diperlukan. Anda boleh menguji dalam sandbox dahulu.
- Pilih cara pesanan berbayar dihantar: setiap satu sebagai e-Invois individu, atau pesanan tanpa TIN pembeli ke dalam e-Invois yang Disatukan bulanan.
- Apabila pesanan diinvois sebagai berbayar, cron Magento menghantarnya ke envoice dalam masa seminit. Status LHDN, UUID, link pengesahan dan resit dipaparkan pada halaman pesanan, dengan butang Retry jika ada yang gagal.
Cron Magento mesti berjalan (bin/magento cron:install). envoice tidak dipanggil semasa checkout. Panggilan yang gagal dicuba semula dengan selang yang semakin panjang, dari 1 minit hingga sehari, jadi gangguan sekejap tidak menyebabkan pesanan hilang. Module ini menyokong Magento 2.4.7 hingga 2.4.9 dengan PHP 8.2 hingga 8.5.
Setiap langkah dengan tangkapan skrin, termasuk halaman pesanan dan penyelesaian masalah: panduan Connect Magento (dalam bahasa Inggeris).
e-Invois yang Disatukan Magento untuk pesanan B2C
Kebanyakan pesanan Magento ialah B2C, dan pembeli tidak memerlukan e-Invois atas nama sendiri. Tetapkan auto-submit kepada disatukan dan pesanan itu dikumpulkan ke dalam satu e-Invois yang Disatukan bagi bulan itu, yang envoice hantar dalam 7 hari pertama bulan berikutnya. Lihat e-Invois yang Disatukan berbanding individu.
Peraturan LHDN yang perlu dipatuhi setiap kedai Magento
- 7 hari: e-Invois yang Disatukan bulanan mesti dihantar dalam tempoh 7 hari selepas akhir bulan.
- RM10,000: satu jualan melebihi RM10,000 tidak boleh dimasukkan ke dalam e-Invois yang Disatukan. Ia memerlukan e-Invois individu dengan butiran pembeli. Module menghantarnya secara individu.
- TIN dan BRN: pembeli perniagaan dikenal pasti melalui TIN dan nombor pendaftaran perniagaan (BRN), dan sejak 1 Ogos 2026 MyInvois menyemak kedua-duanya bersama.
- 72 jam: e-Invois yang disahkan boleh dibatalkan dalam tempoh 72 jam. Selepas itu, pembetulan dibuat dengan Nota Kredit, yang module hantar daripada credit memo.
Bagaimana pembeli perniagaan mendapat e-Invois sendiri?
Pesanan dengan TIN pembeli sentiasa dihantar sebagai e-Invois individu. Semasa checkout, pembeli perniagaan memberikan TIN dalam field VAT number Magento (hidupkan Show VAT Number on Storefront) dan BRN atau nombor IC dalam field pilihan module, yang diperlukan LHDN bersama TIN. Pada halaman pesanan anda boleh menambah atau membetulkan butiran pembeli, klik Look up TIN untuk mendapatkan TIN daripada LHDN menggunakan BRN atau IC mereka, dan membatalkan e-Invois yang telah disahkan dalam tempoh 72 jam LHDN.
Bagaimana bayaran balik dan credit memo Magento dikendalikan?
Buat credit memo seperti biasa. Bagi pesanan yang telah difailkan sebagai e-Invois tersendiri, module menghantar Nota Kredit ke LHDN yang merujuk e-Invois itu, dan halaman pesanan memaparkan statusnya. Bagi pesanan walk-in yang masih menunggu e-Invois disatukan bulanan, bayaran balik itu ditolak daripada jumlah bulan tersebut, jadi Nota Kredit tidak diperlukan. Anda boleh mematikan Nota Kredit dalam setting module jika anda mengendalikan bayaran balik dengan cara lain.
Bolehkah satu pemasangan Magento menghantar untuk beberapa kedai atau perniagaan?
Boleh. Setiap URL kedai dipasangkan dengan kedai envoice sendiri. Store view dengan domain sendiri, atau dengan kod kedai dalam URL, boleh menghantar di bawah perniagaan dan TIN yang berbeza. Store view yang berkongsi satu URL berkongsi satu pasangan. Setting automasi boleh ditetapkan bagi setiap website atau store view.
Berapakah kos e-Invois untuk Magento?
Module ini percuma dengan lesen MIT. Anda hanya membayar pelan envoice, dan semua sambungan dalam akaun anda berkongsi pelan yang sama. Tiada yuran pembinaan dan tiada caj untuk kemas kini module.
| Pelan | Harga | e-Invois sebulan | Jualan disatukan sebulan |
|---|---|---|---|
| Free | RM0 | 50 | 150 |
| Starter | RM35 sebulan | 500 | 750 |
| Pro | RM90 sebulan | 3,000 | 3,000 |
| Enterprise | Dari RM500 sebulan | Tanpa had | Tanpa had |
Setiap pelan termasuk satu kedai. Kedai tambahan berharga RM15 sebulan setiap satu. Butiran penuh di halaman harga.
Perlukah saya mengubah persediaan Magento?
Tidak. Kedai, checkout, kaedah pembayaran dan aliran pesanan anda kekal sama. Module membaca invois berbayar dan credit memo, kemudian menulis keputusan LHDN semula pada pesanan. Langkah persediaan dan soalan lazim ada di halaman envoice untuk Magento.
Soalan lazim
Adakah terdapat extension Magento untuk LHDN MyInvois?
Ya. envoice mempunyai module Magento 2 percuma yang menghantar pesanan berbayar dan credit memo ke LHDN MyInvois. Muat turun dari envoice.my dan sambungkan kepada akaun envoice. Pelan Free sudah cukup untuk bermula.
Adakah ia berfungsi dengan Adobe Commerce dan juga Magento Open Source?
Ya. Module yang sama berfungsi dengan Magento Open Source dan Adobe Commerce, termasuk kedai dengan beberapa website dan store view.
Versi Magento manakah yang disokong?
Magento 2.4.7 hingga 2.4.9, dengan PHP 8.2 hingga 8.5.
Adakah module ini melambatkan checkout?
Tidak. envoice tidak dipanggil semasa checkout atau semasa invois disimpan. Invois berbayar dan credit memo masuk ke dalam baris gilir, dan cron Magento menghantarnya dalam masa seminit.
Bilakah kedai Magento perlu menghantar e-Invois yang Disatukan?
LHDN menetapkan e-Invois yang Disatukan bulanan dihantar dalam tempoh 7 hari selepas akhir bulan. envoice menghantarnya dalam tempoh itu, dan sebarang jualan melebihi RM10,000 dihantar sebagai e-Invois individu.
Bagaimana pembeli perniagaan mendapat e-Invois sendiri daripada kedai Magento?
Pembeli memberikan TIN semasa checkout melalui field VAT number, atau anda menambah TIN dan nombor pengenalan mereka pada halaman pesanan. Pesanan itu kemudian dihantar sebagai e-Invois individu. MyInvois menyemak TIN dan BRN bersama, jadi kedua-duanya mesti milik perniagaan yang sama.
Apa berlaku apabila saya membuat bayaran balik dengan credit memo?
Jika pesanan itu mempunyai e-Invois sendiri, module menghantar Nota Kredit ke LHDN yang merujuknya dan memaparkan statusnya pada halaman pesanan. Jika ia pesanan walk-in yang menunggu e-Invois disatukan bulanan, bayaran balik itu ditolak daripada jumlah bulan tersebut.
Bolehkah beberapa kedai atau store view menggunakan satu pemasangan?
Boleh. Setiap URL kedai dipasangkan dengan kedai envoice sendiri, jadi store view pada domain berbeza boleh menghantar di bawah perniagaan yang berbeza. Kedai tambahan berharga RM15 sebulan setiap satu.
Berapakah kos module Magento ini?
Module ini percuma, tanpa yuran pembinaan. Anda hanya membayar pelan envoice. Free merangkumi 50 e-Invois dan 150 jualan disatukan sebulan, Starter berharga RM35 sebulan dan Pro RM90 sebulan.
Adakah ia di Packagist atau Adobe Commerce Marketplace?
Ia ada di Packagist, jadi composer require envoice/module-einvoice memasangnya. Ia juga boleh dimuat turun secara percuma sebagai zip dari envoice.my. Ia belum disenaraikan di Adobe Commerce Marketplace.