Mana-mana aplikasi yang menghantar e-Invois kepada LHDN bagi pihak anda memerlukan dua kelayakan daripada Portal MyInvois: Client ID dan Client Secret. Anda mendapatkannya dengan mendaftarkan aplikasi tersebut sebagai ERP System Representative. Prosesnya mengambil masa kira-kira sepuluh minit, dan inilah langkah yang paling kerap menyebabkan kedai tersekat.

Sebelum anda bermula

  • Anda memerlukan log masuk MyTax pengarah — akaun yang digunakan oleh syarikat anda untuk penghantaran cukai.
  • Terdapat dua persekitaran yang berasingan:
    • Live: mytax.hasil.gov.my, untuk invois sebenar
    • Staging: preprod-mytax.hasil.gov.my, untuk ujian
  • Log masuk yang sama boleh digunakan untuk kedua-duanya, tetapi kelayakannya tidak. Anda perlu mengulangi langkah di bawah sekali untuk Staging dan sekali untuk Live.

Langkah 1: Log masuk pertama ke Portal MyInvois

  1. Log masuk ke MyTax dengan akaun pengarah.
  2. Klik MyInvois dalam menu.
  3. Baca dan terima terma dan syarat, kemudian klik Continue.
  4. Lengkapkan Taxpayer profile dan User profile. Semak setiap butiran dengan teliti — butiran ini akan dipaparkan pada e-Invois anda.

Halaman pengesahan akan dipaparkan sebaik sahaja kedua-dua profil disimpan.

Langkah 2: Daftarkan sistem ERP

  1. Dalam Portal MyInvois, buka menu profil di bahagian atas sebelah kanan dan pilih View Taxpayer Profile.
  2. Tatal ke bawah ke Representatives dan buka tab ERP.
  3. Klik Register ERP dan isikan:
    • ERP Name: nama yang mudah dikenali, seperti “E-invoice API”
    • Client Secret Expiration: pilihan anda (lihat di bawah)
    • Tandakan Primary ERP System
  4. Klik Register.

Langkah 3: Salin Client ID dan Client Secret

Portal memaparkan Client ID dan Client Secret sekali sahaja. Salin kedua-duanya ke dalam pengurus kata laluan, tandakan kotak yang mengesahkan anda telah menyalinnya, dan klik Done. Kemudian tampalkannya ke halaman persediaan aplikasi e-Invois anda.

Tiga peraturan untuk mengelakkan gangguan

1. Masukkan tarikh luput ke dalam kalendar anda. Apabila Client Secret luput, penghantaran akan terhenti sehingga anda menjana yang baharu dan mengemas kini aplikasi. Tetapkan peringatan seminggu lebih awal.

2. Satu pasangan bagi setiap aplikasi. Jangan gunakan semula Client ID dan Client Secret yang sama dalam sistem kedua. Jika perisian perakaunan anda juga perlu menghantar e-Invois, daftarkan sistem ERP yang berasingan untuknya.

3. Jangan sekali-kali menjana semula secret yang sedang digunakan oleh aplikasi lain. Client Secret hanya sah di satu tempat pada satu masa. Sebaik sahaja anda menjananya semula, salinan yang disimpan oleh aplikasi e-Invois anda berhenti berfungsi — dan e-Invois yang dihantar dengannya, termasuk yang telah diminta oleh pelanggan, turut terjejas.

Staging dahulu, kemudian Live

Gunakan kelayakan Staging untuk menjalankan beberapa pesanan ujian melalui keseluruhan aliran: permintaan pelanggan, borang, dan pengesahan LHDN. Semak hasilnya dalam portal praproduksi. Setelah semuanya berfungsi, jana kelayakan Live dan tukar aplikasi kepada Live.

Senarai semak

Langkah Selesai apabila
Log masuk pertama Profil pembayar cukai dan profil pengguna disimpan
Daftar ERP Sistem ERP tersenarai di bawah Representatives
Salin kelayakan Client ID dan Secret disimpan dengan selamat
Ujian Staging e-Invois ujian disahkan dalam portal praproduksi
Mula Live Kelayakan Live dimasukkan, persekitaran ditetapkan kepada Live
Peringatan Catatan kalendar sebelum secret luput

Setelah anda memperoleh kelayakan, sambungkan kedai anda menggunakan integrasi e-Invois kami, atau lihat senarai semak e-Invois lengkap untuk kedai dalam talian.

Soalan Lazim

Bagaimana saya mendapatkan Client ID dan Client Secret MyInvois?

Log masuk ke Portal MyInvois dengan akaun MyTax pengarah, buka View Taxpayer Profile, dan klik Register ERP dalam tab ERP di bawah Representatives. Portal kemudian memaparkan kedua-dua kelayakan. Prosesnya mengambil masa kira-kira sepuluh minit.

Adakah MyInvois memaparkan Client Secret lebih daripada sekali?

Tidak. Portal memaparkan Client ID dan Client Secret sekali sahaja, jadi salin kedua-duanya ke dalam pengurus kata laluan sebelum anda mengklik Done.

Adakah Staging dan Live menggunakan kelayakan yang sama?

Tidak. Log masuk MyTax yang sama boleh digunakan untuk kedua-duanya, tetapi kelayakannya tidak. Daftarkan sistem ERP sekali dalam Staging dan sekali dalam Live.

Apa yang berlaku apabila Client Secret MyInvois saya luput?

Penghantaran akan terhenti sehingga anda menjana yang baharu dan mengemas kini aplikasi. Tetapkan peringatan kalendar seminggu sebelum tarikh luput.

Bolehkah saya menggunakan satu Client ID dan Client Secret dalam dua sistem?

Tidak. Daftarkan sistem ERP yang berasingan bagi setiap aplikasi. Client Secret hanya sah di satu tempat pada satu masa, jadi menjananya semula akan menyebabkan salinan yang disimpan oleh aplikasi lain berhenti berfungsi.