Getting Started with Xilnex E-Invoicing

Getting Started with Xilnex E-Invoicing

Read Me First

Alert
Before we begin, please review the following important points:
  1. Xilnex product is directly integrated with IRBM's API.
  2. Upon complete setup, your document may be submitted to IRBM via the API.
  3. All testing should be conducted in the staging environment.
  4. Ensure that all configurations are correctly set up before submitting documents.
  5. All testing is advisable to be commenced in the staging environment until official decision is made for switch.
  6. Once the environment is switched to production, it cannot be reverted to staging.
  7. Ensure data accuracy to prevent discrepancies in submission.
  8. Verify your business details and check with your tax agent/finance department to ensure compliance before submitting any official documents.
  9. We recommend contacting our Xilnex team for an e-invoicing training session to help you understand the system effortlessly


Terminology

Term
Description
LHDNM
Lembaga Hasil Dalam Negeri Malaysia
IRBM
Inland Revenue Board Malaysia (English equivalent of LHDNM)
Supplier
Also known as the Seller; receives payment from the Buyer
Buyer
Also known as the Purchaser; makes payment to the Supplier
B2C
Business-to-Customer; typically refers to a retail model
B2B
Business-to-Business; typically involves invoicing rather than receipts
B2G
Business-to-Government; follows the same invoicing model as B2B in Malaysia
Pre-production
IRBM's staging environment where e-invoices can be submitted for testing purposes
Production
The live environment where submitted e-invoices are considered official
TIN
Tax Identification Number


Our Design Approach

POS systems with built-in E-Invoicing capabilities are still rare in the industry. Typically, this functionality is handled separately by accounting software in a SaaS setup. At Xilnex, we break the mold by offering an integrated E-Invoicing module right within our POS solution since the first day of Malaysia E-Invoicing implementation. 

When E‑Invoicing was first announced, many business owners felt it added an extra burden just to stay compliant. Our goal from the beginning has been to design a system that requires the least operational effort from the business owner. Once configured, the system should run on its own with minimal user intervention and allow businesses to focus on what they do best.

Of course, it all comes down to how a business wants to integrate E‑Invoicing into its daily operations. For those who prefer minimal to no disruption to their existing, says, POS usage, we make this possible. For example, when a walk‑in customer requests an E‑Invoice, the business owner can complete the transaction as usual, then request the walk-in customer to proceed claiming the E-Invoice via E-Receipt portal. This serves as a strong testament that no additional effort is needed from the business owner to remain compliant.
    • Related Articles

    • How to Resolve Invalid E-Invoices in E-Invoicing Dashboard

      E-Invoices are validated directly by the LHDN Malaysia server. When a submission is marked as invalid, the server will return an error message (also known as the “Invalid Reason”). Taxpayers are expected to review this message and take corrective ...
    • Xilnex E-Invoicing Document Split

      Type Descriptions Product Xilnex E-Invoicing New Features E-Invoice Document Splitting Document Splitting Function Type Toggle Configuration E-Invoice Settings Required DB Upgrade No Release Date 13 August 2025 Background When a generated payload ...
    • How to Stop Xilnex E-Invoicing

      Scenarios Requiring Xilnex E-Invoicing Deactivation Deactivate Xilnex E-Invoicing when a business falls below mandatory thresholds or ceases operations, ensuring compliance with IRBM guidelines while avoiding unnecessary module activity. This ...
    • Enable E-Invoicing via Xilnex Portal

      Xilnex Portal is the central platform where all configurations and settings for your system can be managed. Designed for flexibility and ease of use, the portal allows you to set up, monitor, and maintain various aspects of your business operations ...
    • Sales Type & Delivery Type Exclusion for E-Invoicing

      Why do these exclusion lists exist if all transactions are meant to be submitted with an e-invoice? Location in X3 Portal: Integration >Malaysia LHDN E-Invoice > E-Invoice Settings > Maintainence According to LHDN Malaysia, the Technology Provider or ...
    • Recent Articles

    • OAuth Project & Client Permission Management

      Overview The OAuth Project & Client Permission module controls which roles can access, configure, and manage OAuth projects and client credentials within the system. Permissions are managed under System Configuration > User Roles Permission > All ...
    • Xilnex Auth Integration Guide

      Introduction Xilnex Auth implements OAuth 2.0, a widely adopted authorization framework that enables secure access to protected resources by issuing access tokens to client applications. This document provides a comprehensive guide on how to use ...
    • Managing OAuth Client Credentials

      Overview Xilnex Auth implements the OAuth 2.0 protocol to govern service-to-service authorization. Client credentials serve as the authentication identity for backend services, enabling them to authorize, or be authorized by, other services within ...
    • Downloading Store Sample CSV Template File in Xilnex Portal

      Overview The Download Store Sample CSV Template File feature in Store Management Import and Log allows staff to download a sample template, containing all necessary fields and proper format for importing data into the system. Preparing imported files ...
    • Importing Store Details in Xilnex Portal

      Overview The Import Store Details in Xilnex Portal is a function that allows users to import store data in bulk using CSV files. Users have the option to import the store details either With updating the existing records or Without updating the ...
    • Popular Articles

    • Basic - How to create a voucher-coupon

      Voucher and coupon definition Voucher can be generated in bulk and can be used once Coupon can only be created one at a time (reusable code) and can be use multiple times Pre-voucher / coupon setup There are 2 things need to be prepared before we can ...
    • Understanding DuitNow QR Payment in ClassicPOS

      Introduction This document introduces the DuitNow QR payment feature available in the Xilnex Retail POS, enabling merchants to accept payments conveniently through Malaysia's national QR payment standard. The integration of DuitNowQR simplifies the ...
    • Basic - How to change custom cost to another branch that don’t have custom cost

      Change custom cost to another branch that don’t have custom cost 1. Get the item list from the location with custom cost (Item Code, Name, Custom Cost) 2. Make sure the Show Location Price are selected 3. Export the item list in Excel 4. The file ...
    • Intermediate - How to Bill & Post to Sales from Transfer Note

      1.0 Purpose A bill is required from transfer note when an inventory transfer involves financial transactions, cost allocation, or compliance with tax and accounting regulations. It is used when stock is moved between outlets that operate as separate ...
    • Basic - How to enable E-Receipt Portal and QR Code Setup on Printing format in Xilnex

      Enable E-Receipt Portal Enable the E-receipt functionality Once Enabled, you will be getting the E-Receipt portal link Continue under Theme & Styling, enabled for the E-Invoice (LHDN) You can customize the look and feel of the E-Receipt portal ...