Cara Membuat Akaun Pra-produksi LHDN MyInvois
Perkara penting
- Pra-produksi ialah persekitaran ujian LHDN. Kerja integrasi anda kekal berasingan daripada penghantaran produksi secara langsung.
- Anda mencipta sambungan ERP LHDN daripada MyInvois melalui Lihat Profil Pembayar Cukai → Daftar ERP.
- Nilai yang diperlukan ialah Client ID dan Client Secret LHDN. Kedua-duanya berbeza daripada kelayakan produksi dan kelayakan API MyInvois Bridge.
- Dalam MyInvois Bridge, simpan nilai itu di bawah kelayakan MyInvois syarikat dan pilih Sandbox (ujian) sebelum membuat ujian.
Jika anda mahu menguji integrasi e-Invois LHDN tanpa menyentuh produksi, mulakan dengan persekitaran pra-produksi MyInvois. Persediaannya mudah apabila anda tahu portal yang perlu dibuka, profil pembayar cukai yang perlu dipilih dan tempat kelayakan ERP dijana.
Jawapan ringkas
Log masuk ke persekitaran ujian MyTax, pilih MyInvois → Preprod, tukar kepada pembayar cukai yang betul, kemudian buka Lihat Profil Pembayar Cukai dan daftarkan sistem ERP. LHDN akan menjana Client ID dan Client Secret untuk sambungan ERP itu. Masukkan kelayakan LHDN tersebut dalam MyInvois Bridge sebagai kelayakan Sandbox (ujian), bukan kelayakan produksi.
Sediakan perkara ini dahulu
- Akses kepada persekitaran ujian/pra-produksi MyTax.
- Profil pembayar cukai atau syarikat yang betul untuk mengeluarkan e-Invois.
- Peranan pengguna yang boleh melihat profil pembayar cukai dan mendaftarkan sistem ERP.
- Tempat yang selamat untuk menyimpan Client ID dan Client Secret selepas dijana.
Pra-produksi bukan produksi
Gunakan pra-produksi untuk belajar, menyambung, mengesahkan dan menguji. Ia bukan tempat untuk dokumen cukai pelanggan sebenar, dan kelayakan pra-produksi tidak akan digunakan untuk mengesahkan sambungan kepada API produksi.
Langkah 1: Buka MyInvois Preprod
Log masuk ke persekitaran ujian MyTax. Daripada menu MyTax, buka MyInvois dan pilih Preprod. Ini akan membawa anda ke versi ujian Portal MyInvois, bukan portal produksi langsung.
Langkah 2: Pilih pembayar cukai yang betul
Selepas portal dibuka, tukar kepada pembayar cukai atau perniagaan yang akan memiliki integrasi. Semak nama perniagaan dan TIN sebelum mendaftarkan apa-apa. Kelayakan itu terikat kepada pembayar cukai tersebut, jadi memilih profil yang salah boleh menyebabkan ralat pengesahan atau ketidakpadanan penerbit kemudian.
Semak TIN sebelum menyalin kelayakan
Pembayar cukai yang dipilih dalam MyInvois mesti sama dengan perniagaan yang anda konfigurasikan dalam MyInvois Bridge. Client ID dan Client Secret yang sah untuk pembayar cukai lain tetap salah untuk syarikat ini.
Langkah 3: Daftarkan sistem ERP anda
- 1Buka Lihat Profil Pembayar Cukai daripada menu profil.
- 2Tatal ke bahagian ERP atau pilih Lihat dan Daftar ERP, bergantung pada label portal semasa.
- 3Pilih Daftar ERP dan lengkapkan pendaftaran yang dipaparkan oleh portal.
Ini ialah langkah layan diri yang mencipta kelayakan mesin-ke-mesin untuk ERP atau alat integrasi mengesahkan diri dengan MyInvois. Jika pilihan ERP tidak kelihatan, semak peranan anda atau minta pentadbir pembayar cukai melengkapkan langkah ini.
Langkah 4: Salin Client ID dan Client Secret
Apabila pendaftaran ERP selesai, salin nilai Client ID dan Client Secret ke pengurus kata laluan atau stor rahsia yang selamat. Anggap secret itu seperti kata laluan. Jangan tampalnya dalam tiket awam, commit ke source control atau hantar melalui sembang yang tidak selamat.
| Persekitaran | Kegunaan | Hos API | Kelayakan |
|---|---|---|---|
| Sandbox / pra-produksi | Ujian dan kerja integrasi | preprod-api.myinvois.hasil.gov.my | Client ID + Client Secret pra-produksi |
| Produksi | Penghantaran e-Invois langsung | api.myinvois.hasil.gov.my | Client ID + Client Secret produksi |
Langkah 5: Tambah kelayakan ke MyInvois Bridge
Dalam MyInvois Bridge, buka tetapan MyInvois syarikat anda dan tambah satu set kelayakan. Pilih Sandbox (ujian), kemudian masukkan Client ID dan Client Secret LHDN yang anda jana dalam pra-produksi. Simpan set kelayakan sebelum mencuba penghantaran.
Jangan kelirukan dua pasangan kelayakan
Kelayakan LHDN membolehkan MyInvois Bridge mengesahkan diri dengan LHDN. Kelayakan API MyInvois Bridge ialah pasangan berasingan yang digunakan apabila ERP atau perisian anda sendiri memanggil API Bridge. Untuk persediaan papan pemuka dalam panduan ini, masukkan pasangan LHDN di bawah kelayakan MyInvois.
Langkah 6: Uji sambungan
- 1Pastikan persekitaran masih Sandbox (ujian).
- 2Jalankan semakan sambungan atau pengesahan dalam MyInvois Bridge.
- 3Cipta atau hantar dokumen ujian yang mewakili penggunaan sebenar dan tunggu status LHDN.
- 4Jika ujian diterima atau ditolak dengan sebab pengesahan yang jelas, catat pembelajaran itu sebelum menyediakan pemindahan ke produksi.
Masalah biasa dan pembaikan pantas
- 403 atau client tidak sah: pastikan Client ID dan Client Secret datang daripada portal pra-produksi, bukan produksi.
- TIN penerbit tidak sepadan: tukar kepada pembayar cukai yang betul dalam MyInvois dan semak syarikat yang dipilih dalam MyInvois Bridge.
- Daftar ERP tidak kelihatan: minta pentadbir pembayar cukai menyemak peranan dan kebenaran MyInvois anda.
- Secret tidak lagi berfungsi: semak sama ada ia tamat tempoh, diputar atau dijana semula. Kemas kini set kelayakan dengan nilai semasa.
- Permintaan API pergi ke hos yang salah: pra-produksi menggunakan preprod-api.myinvois.hasil.gov.my; produksi menggunakan api.myinvois.hasil.gov.my.
Rujukan rasmi
Gunakan arahan LHDN semasa jika label portal berubah
Adakah e-Invois pra-produksi ialah dokumen cukai sebenar?
Tidak. Pra-produksi digunakan untuk menguji integrasi dan aliran dokumen. Asingkan kelayakan produksi dan penghantaran langsung.
Bolehkah saya menggunakan kelayakan produksi dalam sandbox?
Tidak. LHDN menggunakan kelayakan berasingan untuk setiap persekitaran. Daftarkan ERP dalam pra-produksi dan gunakan Client ID serta Client Secret itu untuk ujian sandbox.
Bagaimana jika saya tidak nampak Daftar ERP?
Pilihan itu mungkin bergantung pada peranan pembayar cukai anda. Minta pentadbir pembayar cukai membuka profil atau mengesahkan bahawa pengguna anda dibenarkan mendaftarkan sistem ERP.
Apakah kelayakan yang perlu saya masukkan dalam MyInvois Bridge?
Untuk sambungan papan pemuka, masukkan Client ID dan Client Secret yang dikeluarkan LHDN untuk pembayar cukai dan persekitaran yang sepadan. Jangan masukkan kelayakan klien API MyInvois Bridge yang berasingan dalam borang ini.
Sedia menguji aliran kerja LHDN anda?
Sambungkan kelayakan pra-produksi kepada MyInvois Bridge, jalankan ujian yang mewakili penggunaan sebenar dan berpindah ke produksi hanya apabila pasukan anda yakin.