Cara Integrasi LHDN e-Invoice ke POS Offline Murah
Panduan praktikal integrasi LHDN e-Invoice ke sistem POS offline berasaskan kos sekali bayar. Sesuai untuk kedai runcit, restoran, dan kantin kilang.
UntungPOS Team
5 min read
Integrasi LHDN e-Invoice ke POS offline murah dicapai dengan memilih sistem yang menyimpan transaksi secara lokal dan menyinkronkan data ke MyInvois apabila internet tersedia. Pendekatan ini mengelakkan kos langganan bulanan tinggi dan memastikan operasi terus berjalan walau talian putus. This guide is for anyone searching for lhdn e invoice offline pos integrasi murah.
Kenapa POS Offline Adalah Pilihan Bijak untuk e-Invoice
Banyak pemilik usaha kecil tertipu dengan tawaran "percuma" atau kos rendah awal dari POS awan, tetapi tersembunyi dengan fee bulanan, fee transaksi, dan kos peningkatan storan. POS offline berasaskan lesen sekali bayar (perpetual license) memberikan kawalan penuh ke atas kos jangka panjang.
Kelebihan Utama POS Offline untuk Pematuhan LHDN
| Ciri | POS Awan (Subscription) | POS Offline (Sekali Bayar) |
|---|---|---|
| Kos Bulanan | RM 150 - RM 500+ | RM 0 |
| Operasi Tanpa Internet | Tidak (terhenti) | Ya (penuh) |
| Milik Data | Penyedia perkhidmatan | Anda (100%) |
| Sinkron MyInvois | Automatik (perlukan internet) | Batch/Manual (fleksibel) |
| Kos 3 Tahun | RM 5,400 - RM 18,000 | RM 1,500 - RM 3,500 (sekali) |
POS offline seperti UntungPOS dibina untuk konteks Malaysia: sokong SST, e-Invoice MyInvois, laci tunai, kawalan shift, dan QR ordering tanpa bergantung pada keupayaan pelayan internet yang tidak stabil di banyak premis.
Langkah-Langkah Integrasi e-Invoice ke POS Offline
Proses integrasi biasanya melibatkan tiga fasa utama. Ikuti langkah ini untuk elak penangguhan semasa audit LHDN.
1. Daftar dan Konfigurasi Akaun MyInvois
Sebelum sentuh POS, pastikan pendaftaran di portal MyInvois (preprod.myinvois.hasil.gov.my untuk ujian, myinvois.hasil.gov.my untuk pengeluaran) sudah siap.
- Daftar menggunakan nombor pendaftaran Cukai Pendapatan (Nombor Cukai) syarikat/perniagaan.
- Tetapkan profil e-Invoice: jenis perniagaan, alamat berdaftar, SST number (jika berdaftar SST), dan kod MSIC.
- Jana Client ID dan Client Secret di bahagian API Integration. Simpan kedua-duanya dengan selamat; ini kunci untuk POS anda "bercakap" dengan LHDN.
- Uji koneksi API menggunakan Postman atau cURL untuk pastikan kredensial berfungsi sebelum masukkan ke POS.
2. Konfigurasi POS Offline untuk e-Invoice
Buka tetapan e-Invoice di dalam POS anda. Masukkan maklumat berikut:
- Client ID dan Client Secret dari langkah 1.
- Environment: Pilih "Sandbox/Pre-production" untuk ujian, "Production" untuk hidup.
- TIN Validation: Aktifkan semakan TIN pelanggan (jika POS sokong) untuk mengelakkan e-Invoice ditolak LHDN.
- Batch Sync Schedule: Tetapkan masa sinkronisasi automatik (contoh: 2:00 pagi setiap hari) atau tetapkan manual "Sync Now" di akhir hari.
- Fallback Handling: Pastikan POS simpan e-Invoice yang gagal hantar ke antrian tempatan (local queue) untuk cuba semula nanti.
3. Ujian Penuh (End-to-End Test)
Jangan lompat terus ke transaksi sebenar. Lakukan ujian ini:
- Buat 3-5 transaksi ujian (jualan tunai, kad kredit, QR order).
- Tekan Sync Now atau tunggu jadual automatik.
- Log masuk ke portal MyInvois > Submissions > semak status setiap e-Invoice.
- Status mesti "Valid" atau "Accepted". Jika "Rejected", baca kod ralat (contoh:
INV-001TIN tidak sah,INV-005SST number tidak padan). - Cetak/emel e-Invoice ujian ke pelanggan ujian untuk pastikan kod QR dan UUID papar dengan betul.
- Lakukan Void/Refund ujian dan pastikan Credit Note e-Invoice terhasil dan tersinkron.
Hanya selepas semua ujian lulus, tukar Environment ke Production dan mula guna untuk jualan sebenar.
Mod Sinkronisasi: Pilih Yang Sesuai Operasi Anda
POS offline yang baik memberikan pilihan mod sinkronisasi. Pilih berdasarkan realiti premis anda:
- Manual Sync (Disyorkan untuk kawalan penuh): Kakitangan tekan butang "Sync to LHDN" di akhir shift/hari. Membolehkan semakan sebelum hantar.
- Scheduled Auto Sync: POS hantar batch pada masa ditetapkan (contoh: 3:00 pagi). Sesuai jika internet stabil di malam hari.
- Hybrid: Auto sync untuk transaksi kecil, manual untuk transaksi besar/korporat yang memerlukan semakan TIN pelanggan terlebih dahulu.
Untuk restaurant POS dengan volume transaksi tinggi, Scheduled Auto Sync mengurangkan beban kakitangan. Untuk canteen POS yang mungkin hanya ada WiFi pejabat, Manual Sync di akhir hari lebih realistis.
Ralat Biasa dan Cara Betulkan
| Kod Ralat LHDN | Maksud | Penyelesaian di POS |
|---|---|---|
AUTH-001 |
Client ID/Secret salah | Semak semula kredensial di tetapan POS, pastikan tiada ruang tambahan |
INV-001 |
TIN Pelanggan tidak sah | Aktifkan semakan TIN masa transaksi; minta pelanggan periksa kad MyKad/SSM |
INV-005 |
SST Number tidak padan | Kemaskini profil syarikat di POS dan MyInvois supaya sama persis |
SYS-002 |
Masa tamat (timeout) | Tingkatkan masa tamat API di POS (contoh: 60 saat); cuba semula sync |
DUP-001 |
Duplicate Invoice UUID | POS mesti jana UUID unik (v4) untuk setiap e-Invoice; elak reset nombor seri |
Simpan log ralat (error log) di POS sekurang-kurangnya 7 hari untuk rujukan jika LHDN soal siasat.
Kawalan Dalam (Internal Control) untuk Pematuhan Berterusan
Integrasi bukan sekali selesai. Tetapkan rutin mingguan dan bulanan:
- Harian: Kakitangan sync e-Invoice, semak status "Accepted" penuh, failkan yang "Rejected" untuk dibetulkan esoknya.
- Mingguan: Pengurus semak laporan Reconciliation POS berbanding portal MyInvois (bilangan e-Invoice, jumlah amaun, bilangan Credit Note/Debit Note).
- Bulanan: Eksport data e-Invoice (JSON/CSV) dari POS untuk simpanan rekod 7 tahun mengikut Akta Cukai Pendapatan 1967.
- Tahunan: Semak lesen POS masih aktif, versi firmware POS terkini (untuk patch keperluan LHDN baharu), dan backup database POS ke storan luaran.
Kos Sebenar: Sekali Bayar vs Bulanan
Anggaran kasar untuk setup POS offline e-Invoice bersedia:
- Lesen POS offline (sekali bayar): RM 1,500 - RM 3,500 bergantung modul (restoran, runcit, kantin).
- Perkakasan (PC/mini PC + printer thermal + laci tunai + scanner): RM 2,000 - RM 4,000.
- Pemasangan & latihan (sekali): RM 500 - RM 1,000.
- Jumlah permulaan: RM 4,000 - RM 8,500 (tiada bayaran bulanan).
Bandingkan dengan POS awan RM 300/bulan + fee transaksi 0.5%: pada volume RM 100k/bulan, kos tahunan = RM 3,600 + RM 6,000 = RM 9,600/setahun. POS offline breakeven biasanya di bulan ke-6 hingga ke-10.
Keselamatan Data dan Backup
Kerana data e-Invoice sensitif (mengandungi TIN, butiran pelanggan, jumlah jualan), POS offline mesti:
- Enkripsi database tempatan (AES-256 minimum).
- Sokong backup automatik harian ke USB/NAS/cloud storage (pilihan anda).
- Log audit trail: siapa buka shift, siapa void bil, siapa sync e-Invoice, pada masa bila.
- Kawalan akses berperanan (Role-based): Kasir tidak boleh buka laporan untung rugi; Admin sahaja boleh ubah tetapan e-Invoice.
Bottom line
Integrasi LHDN e-Invoice ke POS offline murah bermula dengan pemilihan sistem lesen sekali bayar yang sokong MyInvois secara native, diikuti pendaftaran MyInvois, konfigurasi API, dan ujian penuh sebelum hidup. Pilih mod sinkronisasi yang padan realiti internet premis anda, tetapkan rutin semakan mingguan, dan simpan backup 7 tahun. Mulakan dengan daftar akaun MyInvois hari ini, kemudian bandingkan lesen POS offline yang sesuai untuk jenis perniagaan anda — restoran, runcit, atau kantin kilang.
Frequently asked questions
Adakah POS offline boleh hantar e-Invoice ke LHDN tanpa internet?
Tidak. POS offline menyimpan e-Invoice secara tempatan (local queue) dan memerlukan internet untuk menyinkronkan data ke portal MyInvois. Sinkronisasi boleh dilakukan secara manual atau automatik pada masa yang ditetapkan apabila sambungan internet tersedia.
Berapa kos integrasi LHDN e-Invoice ke POS offline?
Kos utama adalah lesen POS offline sekali bayar (RM 1,500 - RM 3,500) dan perkakasan (RM 2,000 - RM 4,000). Tiada kos langganan bulanan atau fee transaksi ke penyedia POS, berbeza dengan model POS awan.
Apa yang berlaku jika e-Invoice ditolak (rejected) oleh LHDN?
POS offline yang baik akan mengekalkan e-Invoice yang gagal dalam antrian tempatan (local queue) dengan kod ralat. Anda perlu betulkan data (contoh: TIN pelanggan, nombor SST) di POS, kemudian cuba sinkron semula (re-sync) secara manual.
Perlu ke beli perisian baharu jika sudah ada POS lama?
Bergantung pada vendor POS lama. Banyak POS lama tidak sokong e-Invoice MyInvois native dan memerlukan middleware mahal. Seringkali lebih murah dan stabil menukar ke POS offline moden yang dibina untuk e-Invoice sejak asal.
Bagaimana nak pastikan TIN pelanggan sah sebelum hantar e-Invoice?
Guna POS yang sokong semakan TIN masa transaksi (real-time validation) ke API MyInvois. Jika internet tidak ada, POS boleh simpan TIN dan validasi kemudian semasa sinkronisasi, atau minta pelanggan tunjukkan kad MyKad/SSM untuk semakan manual.
Want this running at your counter?
UntungPOS handles dine-in, retail and canteen subsidies offline-first, then syncs automatically. Tell us how you sell and we will show you the exact setup.
