Skip to content
MyInvois Bridge
Persediaan sandbox

Sediakan sandbox preprod LHDN MyInvois sebelum anda menghantar satu invois langsung.

LHDN menjalankan dua persekitaran: preprod (preprod-api.myinvois.hasil.gov.my) untuk pengujian integrasi dan pengeluaran untuk penghantaran langsung. Segala yang anda bina perlu mendarat di preprod dahulu: aliran OAuth2 yang sama, skema UBL 2.1 yang sama, respons status yang sama, tetapi tiada akibat pematuhan untuk penghantaran yang salah format.

Lima langkah

Apa yang anda perlu buat, dalam susunan.

  1. 01

    Dapatkan kelayakan preprod LHDN

    Mohon melalui portal LHDN untuk kelayakan klien preprod. Mereka mengeluarkan client ID dan client secret. Ini berbeza daripada kelayakan pengeluaran anda: jangan campurkan.

  2. 02

    Konfigurasi persekitaran anda

    Tunjukkan integrasi anda ke `https://preprod-api.myinvois.hasil.gov.my`. Dalam MyInvois Bridge ini ialah pemboleh ubah persekitaran `LHDN_API_BASE_URL`. Kod QR pengesahan akan diselesaikan ke `preprod.myinvois.hasil.gov.my/<uuid>`, itu dijangkakan.

  3. 03

    Jalankan pertukaran token

    Akses hujung token dengan `grant_type=client_credentials` dan `scope=InvoicingAPI`. Jika anda mendapat token bearer kembali, kelayakan disambung dengan betul. Cache token: sah selama 60 minit.

  4. 04

    Hantar invois sampel

    Jana invois UBL 2.1 dengan TIN pembekal sintetik, TIN pelanggan, dan satu item baris. POST ke hujung penghantaran dokumen. LHDN memulangkan UUID serta-merta dan Long ID setelah pengesahan di server selesai.

  5. 05

    Sahkan kitaran-lengkap

    Semak hujung status sehingga status menjadi `approved` atau `rejected`. Buka URL pengesahan preprod LHDN untuk mengesahkan QR diselesaikan. Anda sedia untuk menukar URL asas ke pengeluaran apabila ini berfungsi.

Perangkap biasa

The four pitfalls every team hits.

  • Menggunakan semula kelayakan pengeluaran di preprod (persekitaran berbeza).
  • TIN `onBehalfOf` tidak sepadan apabila mengeluarkan untuk syarikat lain dalam persediaan berbilang syarikat.
  • Menganggap pulangan UUID sebagai pengesahan: Long ID hanya tiba selepas pengesahan di server.
  • Memasukkan URL asas preprod dalam kod: simpan sebagai pemboleh ubah persekitaran supaya peralihan ke pengeluaran adalah satu perubahan env, bukan penempatan semula.
Hubungi kami

Dikemas kini terakhir · Julai 2026

Rujukan bebas. MyInvois dikendalikan oleh LHDN. Kami bukan gabungan LHDN.