E-Invois LHDN: Panduan Konfigurasi Plugin WooCommerce untuk Malaysia

Lembaga Hasil Dalam Negeri (LHDN) telah mewajibkan pelaksanaan e-Invois bagi semua transaksi komersial di Malaysia melalui gerbang API MyInvois. Bagi pemilik kedai dalam talian yang menggunakan WooCommerce di WordPress, mengintegrasikan sistem cukai ini pada peringkat pembayaran adalah penting bagi memastikan pematuhan undang-undang perniagaan.

1. Pengesahan API melalui Portal MyInvois

Sistem WooCommerce anda perlu berhubung secara selamat dengan pelayan API MyInvois LHDN. Anda perlu mengkonfigurasi pengesahan protokol OAuth 2.0 menggunakan Client ID dan Client Secret yang dijana daripada portal MyInvois ERP/Invoicing syarikat anda.

Untuk mengelakkan masalah sekatan kadar panggilan API (rate limit) semasa lonjakan trafik jualan, token akses OAuth mestilah disimpan dalam memori cache pelayan (seperti Redis atau Memcached).

2. Pengesahan Nombor TIN Pembeli Semasa Checkout

Untuk mengeluarkan e-Invois sah bagi transaksi B2B, sistem mesti mengumpul dan mengesahkan Nombor Pengenalan Cukai (TIN) pembeli secara langsung sebelum pesanan dimuktamadkan.

Sesuaikan medan borang checkout WooCommerce anda dan hubungkan dengan titik akhir (endpoint) pengesahan TIN LHDN:

// Contoh fungsi pengesahan TIN pembeli melalui API LHDN
function validate_buyer_tin_lhdn( $tin_number ) {
    $api_url = 'https://preprod-api.myinvois.hasil.gov.my/api/v1.0/tin/validate?tin=' . urlencode( $tin_number );
    $response = wp_remote_get( $api_url, array(
        'headers' => array(
            'Authorization' => 'Bearer ' . get_cached_lhdn_token(),
            'Accept'        => 'application/json',
        ),
        'timeout' => 5,
    ) );

    if ( is_wp_error( $response ) || wp_remote_retrieve_response_code( $response ) !== 200 ) {
        wc_add_notice( __( 'Nombor TIN LHDN tidak sah. Sila semak semula nombor cukai syarikat anda.', 'jagaweb' ), 'error' );
    }
}
add_action( 'woocommerce_checkout_process', 'validate_buyer_tin_lhdn' );

3. Penjanaan Kod QR Patuh LHDN pada Resit Pesanan

Sebaik sahaja invois disahkan oleh API MyInvois, LHDN akan mengembalikan nombor UUID dan pautan pengesahan rasmi. LHDN mewajibkan pautan ini dipaparkan sebagai kod QR pada resit pesanan fizikal, invois PDF, dan emel pengesahan pembelian pelanggan.

---

Perlukan Bantuan Integrasi E-Invois Kedai Anda?

Pematuhan percukaian digital memerlukan integrasi kod yang teliti dan stabil. JagaWeb membantu perniagaan seperti TechFix Malaysia beroperasi dengan lancar dalam kerangka undang-undang percukaian. Dapatkan Semakan Pemilikan & Akses RM5,000 kami untuk mengaudit checkout kedai anda, atau langgan Pelan Penjagaan RM450/bulan untuk penyelenggaraan teknikal berterusan. Hubungi kami hari ini.