# MyInvois Integration: Portal, API or Middleware

> Cara neutral-vendor untuk memilih antara Portal MyInvois yang percuma, integrasi API terus dan penyedia teknologi, berdasarkan volum transaksi dan apa yang telah dilakukan oleh ERP anda.

- Category: taxation
- Language: ms
- Status: published
- Updated: 2026-07-20
- Canonical: https://negaraku.md/taxation/myinvois-integration

---

Hampir semua yang ditulis tentang keputusan ini ditulis oleh seseorang yang
menjual salah satu daripada jawapannya. Jadi mulakan daripada dua mekanisme
sahaja yang diiktiraf oleh LHDN, dalam Table 2.1 Garis Panduan e-Invois:
**Portal MyInvois** dan **API**. Penyedia Peppol, penyedia teknologi
bukan-Peppol dan middleware bukan pilihan ketiga — ketiga-tiganya adalah cara
untuk sampai ke API.

## Dua mekanisme

| | Portal MyInvois | API |
| --- | --- | --- |
| Kos | Percuma, melalui log masuk **MyTax** | Bina atau lesenkan |
| Input | Borang individu, atau **muat naik kelompok hamparan Excel yang telah ditetapkan** | XML atau JSON mengikut **UBL 2.1** |
| Tandatangan | Diuruskan oleh Portal | **Sijil digital** anda (.cer atau .pfx) |
| Kesesuaian menurut LHDN | Boleh diakses oleh semua pembayar cukai; perniagaan yang sambungan API tidak tersedia | Volum tinggi; memerlukan pelaburan awal dan perubahan sistem |
| Laluan | Satu | ERP terus, penyedia **Peppol**, penyedia **bukan-Peppol** |

Kedua-duanya menghasilkan perkara yang sama: Nombor Pengenalan Unik IRBM,
cap masa pengesahan, dan kod QR pada perwakilan visual.

## Kira saiznya sebelum membeli-belah

Persoalannya bukan perolehan anda. Ia ialah **berapa banyak dokumen yang
mesti anda hantar dalam sebulan**, dan bilangannya biasanya lebih besar
daripada jangkaan orang:

1. e-Invois transaksi kepada pembeli yang memintanya
2. e-Invois disatukan — satu atau lebih sebulan, setiap cawangan jika anda
   memisahkannya
3. **e-Invois dibil sendiri** — komisen, pembekal luar negara, tuan tanah
   individu, kebanyakan faedah, dividen, bayaran balik modal
4. Nota kredit, nota debit dan nota bayaran balik

Kemudian gunakan dua pengecualian yang meruntuhkan anggaran naif. Sebarang
**transaksi tunggal melebihi RM10,000** mesti menjadi e-Invois transaksi,
merentasi semua industri, sejak 1 January 2026. Dan sembilan aktiviti dalam
Table 3.6 e-Invoice Specific Guideline tidak boleh sama sekali disatukan —
kenderaan bermotor, tiket penerbangan, kontrak pembinaan, bayaran ejen dan
pengedar, bayaran pertaruhan, elektrik, telekomunikasi.

Sebuah bengkel yang menjual tiga buah kereta sebulan mempunyai beban kerja
Portal yang remeh. Seorang peruncit semula telekomunikasi dengan 4,000
pelanggan pascabayar tidak, dan tiada jumlah penyatuan yang dapat
membantunya.

**Volum dibil sendiri biasanya menjadi kejutan.** Sebuah syarikat dengan 40
invois jualan sebulan dan 600 bayaran komisen ejen adalah perniagaan e-Invois
bervolum tinggi, apa pun yang dikatakan oleh lejar jualannya.

## Di mana Portal benar-benar tidak lagi memadai

- **Kos kemasukan data.** Setiap dokumen transaksi memerlukan nama pembeli,
  TIN, nombor pendaftaran, alamat, nombor hubungan dan nombor pendaftaran
  SST ditaip atau dimuat naik melalui hamparan.
- **Jam 72 jam.** Tempoh pembatalan dan penolakan berjalan daripada masa
  pengesahan. Proses manual yang menghantar secara mingguan tidak dapat
  menggunakannya.
- **Tumpuan penghujung bulan.** e-Invois disatukan wajib dihantar dalam
  tempoh **tujuh hari kalendar** selepas penghujung bulan, di atas
  segala-galanya yang lain.
- **Penyesuaian.** Portal memberikan anda capaian XML, JSON, metadata, grid
  dan PDF — tetapi memadankan dokumen yang disahkan kembali kepada lejar
  anda dilakukan secara manual.

## Di mana API memakan kos lebih daripada lesen

- **Sijil digital** mesti diperoleh, dipasang dan diputarkan.
- **Had penghantaran adalah ketat:** 100 dokumen dan 5MB setiap penghantaran,
  300KB setiap dokumen. Pengelompokan dan, jika perlu, pemampatan
  (minification) adalah masalah anda sendiri.
- **Pengesahan dua peringkat.** *Submitted* bukan *Valid*. Struktur, medan
  teras dan kod disemak serta-merta; tandatangan, pembayar cukai, dokumen
  rujukan dan pendua disemak di latar belakang. Sebarang integrasi yang
  menganggap pengakuan bergaya 202 sebagai kejayaan akan mengumpul dokumen
  tidak sah secara senyap.
- **Pengendalian token.** Token log masuk sah selama 60 minit dan sepatutnya
  digunakan semula, bukan dijana bagi setiap permintaan. Had kadar
  mengembalikan 429 dengan pengepala `Retry-After`.
- **Data induk.** TIN pembekal dan pembeli, BRN 12-digit yang baharu, kod
  MSIC dan nombor SST mesti betul sebelum semua ini dapat berjalan.

## Memilih laluan ke API

| Laluan | Sesuai untuk | Perhatikan |
| --- | --- | --- |
| **Integrasi ERP terus** | ERP yang mantap dengan penyetempatan Malaysia yang diselenggara, atau keupayaan kejuruteraan dalaman | Penyelenggaraan berterusan apabila versi garis panduan berubah — v4.7 dan v4.8 kedua-duanya dikeluarkan pada 7 July 2026 |
| **Penyedia perkhidmatan Peppol** | Perniagaan yang juga mahukan pertukaran dokumen boleh saling beroperasi dengan rakan niaga | Peppol bukan keperluan MyInvois; jangan bayar untuknya seolah-olah ia adalah satu |
| **Penyedia teknologi bukan-Peppol / middleware** | Berbilang sistem sumber, kumpulan POS, atau ERP tanpa penyetempatan | Penjagaan data, terma keluar, dan sama ada mereka menghantar di bawah kelayakan (credentials) mereka sendiri |

LHDN tidak mengiktiraf, mengakreditasi atau meluluskan mana-mana penyedia.
Jika sebuah vendor mendakwa status diluluskan LHDN, minta untuk melihat
buktinya.

## Persoalan perantara yang tiada sesiapa tanya

SDK menyatakan bahawa perantara menghantar menggunakan **Client ID dan
Client Secret mereka sendiri**, dan hanya dapat mengakses e-Invois yang
**mereka sendiri** hantar — mereka tidak dapat mendapatkan semula dokumen
yang dihantar sendiri oleh pembayar cukai secara berasingan.

Dua akibat yang wajar ditulis ke dalam kontrak:

- **Menukar penyedia tidak membawa sejarah penghantaran anda bersama.**
  Rancang untuk tempoh dijalankan selari (parallel-run) dan untuk arkib
  anda sendiri.
- **Liabiliti tidak berpindah.** Section 82C Income Tax Act 1967 meletakkan
  kewajipan itu pada pembayar cukai; s.120(1)(d) menjadikan pelanggaran
  sebagai suatu kesalahan. Gangguan sistem vendor tetap menjadi
  ketidakpatuhan anda.

Berkenaan gangguan sistem, LHDN menawarkan satu kelonggaran. Section 2.5.4
Garis Panduan e-Invois menyatakan bahawa apabila Sistem MyInvois sendiri
tidak berfungsi kerana penyelenggaraan atau sebab teknikal dan pembayar
cukai dapat membuktikan usaha pematuhannya, Ketua Pengarah akan menilai kes
itu secara berasingan dan mungkin tidak mengambil sebarang tindakan. Ini
meliputi masa gangguan LHDN, bukan gangguan vendor anda.

## Laluan keputusan

1. **Adakah anda dikecualikan?** Bawah perolehan tahunan RM1,000,000,
   berhenti di sini.
2. **Kira dokumen bulanan** merentasi keempat-empat kategori di atas.
3. **Kira-kira di bawah seratus, kebanyakannya disatukan?** Portal, dengan
   muat naik kelompok Excel. Semak semula setiap tahun.
4. **Ratusan hingga ribuan, satu sistem sumber?** Tanya vendor ERP anda apa
   yang diliputi oleh penyetempatan MyInvois mereka — khususnya jenis
   dibil sendiri 11 hingga 14 dan medan anexur bagi import.
5. **Ribuan, atau berbilang sistem sumber, atau kumpulan POS?** Middleware,
   dipilih berdasarkan penjagaan data dan terma keluar dan bukannya senarai
   ciri.
6. **Apa jua yang anda pilih, buktikan ia berfungsi hujung ke hujung sebelum
   tempoh pelonggaran anda tamat** — 31 December 2027 bagi fasa 4, dan
   sudah berlalu bagi fasa 1 hingga 3.

## Kesilapan biasa

- **Membeli sebelum mengira.** Bilangan dokumen, termasuk dibil sendiri,
  adalah keseluruhan input kepada keputusan ini.
- **Menganggap Peppol adalah wajib.** Ia hanya satu daripada tiga laluan
  API.
- **Mempercayai dakwaan akreditasi.** LHDN tidak menerbitkan sebarang
  senarai vendor yang diluluskan.
- **Menganggap pengesahan berlaku serentak.** Empat daripada tujuh
  validator berjalan di latar belakang.
- **Melangkau pembersihan data induk.** Nombor pendaftaran SSM yang lama
  dan TIN yang basi akan gagal validator pembayar cukai walau sebaik mana
  pun integrasi itu.
- **Menguji dengan data yang bersih.** Uji dengan pembekal luar negara,
  individu tanpa TIN, nota kredit dan volum penghujung bulan, kerana
  itulah yang akan rosak.

## Apa seterusnya

Keluarkan akaun belum bayar dan belum terima bulan lepas, kelaskan setiap
baris sebagai transaksi, disatukan atau dibil sendiri, dan kira. Angka itu
menentukan mekanisme yang akan digunakan. Kemudian semak senarai medan
berbanding data induk anda, kerana kerja pembersihan hampir selalu mengambil
masa lebih lama daripada integrasi itu sendiri.

## Sources

- e-Invoice Guideline (Version 4.7) — sections 2.2 to 2.5 — https://www.hasil.gov.my/wp-content/uploads/IRBM-e-Invoice-Guideline.pdf (LHDN)
- MyInvois SDK — https://sdk.myinvois.hasil.gov.my/ (LHDN)
- MyInvois SDK — frequently asked questions — https://sdk.myinvois.hasil.gov.my/faq/ (LHDN)
- MyInvois SDK — standard error response — https://sdk.myinvois.hasil.gov.my/standard-error-response/ (LHDN)
- e-Invoice Specific Guideline (Version 4.8) — https://www.hasil.gov.my/wp-content/uploads/IRBM-e-Invoice-Specific-Guideline.pdf (LHDN)

---
Source of truth: https://github.com/negaraku-md/NegaraKu.md
License: CC BY-SA 4.0