Xilnex E-Invoicing Document Split

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 exceeds the threshold set by LHDN Malaysia, the system validator will reject the e-invoice submission.
Warning
Error returns by LHDN Malaysia
Invalid structured submission. Maximum allowed document size '300' KB exceeded.

Workflow Rules

When the generated document exceeds a certain threshold, the document will be split into multiple payloads, each payload will be treated as an individual e-invoices for submission. 

E-Invoicing Dashboard


The image demonstrates that two documents (INVB1013 and INVB1014) have been split into four documents each. The dashboard has also been updated to support this change.
New Fields:
  1. Row ID: Unique identifier for each row.
  2. Document Split ID: E-Invoice number used for submission.

Split Document Tag


Added a yellow “Split Document” tag in the E-Invoice summary to indicate when a document has been split.

Unified Item Details

A new tab, Unified Item Details, has been added to display all associated e-invoices in a single view. For a seamless experience, users can click on a Document ID to navigate directly to the E-Invoice summary of the selected document for more details.


Email Notification and E-Invoice PDF


Some necessary changes have also been made to the email delivery of PDFs. If a document has been split into four documents, four separate emails will be sent, each containing its respective PDF.

Enabling Document Splitting

Path: /Integration/MalaysiaLHDNEInvoicing/EInvoiceSetting/Maintenance
The Document Splitting configuration has been added under Maintenance Settings.
Alert
Requirement:
The prerequisite for enabling this feature is configuring the default tax type and classification code. This helps mitigate the risk of submissions being rejected during processing.
Notes
Is this compliant?
Compliance is a key concern. To ensure this approach is compliant, our team engaged directly with LHDN Malaysia, who confirmed that this approach is acceptable.

The Trade-Offs

The cancellation action made on Split Document is blocked to mitigate the risk of cascading issues in the system. Therefore, sales return or a purchase return is suggested.

Warning
Out of Scope
Last Update: 01 December 2025
E‑Invoice Reports currently do not support split‑document records, so some report entries may appear incomplete or inaccurate. Please anticipate these discrepancies when reviewing the data. A future update will be released once this is supported.

    • 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 ...
    • Getting Started with Xilnex E-Invoicing

      Read Me First Before we begin, please review the following important points: Xilnex product is directly integrated with IRBM's API. Upon complete setup, your document may be submitted to IRBM via the API. All testing should be conducted in the ...
    • 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 ...
    • 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 ...
    • 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

    • Guidelines to Set Up Promotion for Walk-in (System Default)

      Guidelines to Set Up Promotion for Walk-in (System Default) Previously, the system did not have a specific indicator for walk-in customers. As a result, all promotion rules applied equally to all customer types, including walk-in customers. However, ...
    • How to Update Client Record in Classic POS

      Overview Updating client information is an essential function in ClassicPOS, enabling users to maintain and update existing client records. This ensures that client data remains accurate and up to date for daily operations, reporting, and effective ...
    • How to Create a New Client in Classic POS

      Overview This function is created to centralize and manage client information in ClassicPOS. The Client Form allows users to create, update, and maintain customer records, supporting the management of personal information, transaction history, ...
    • POS Hold Bill Feature (Coming Soon!)

      Hold Bill Feature – Retail POS 1. Overview The Hold Bill feature allows cashier to temporarily save an ongoing transaction and resume it later. ✅ Enabled by default for Retail POS Designed to improve queue efficiency Prevents loss of sales when ...
    • 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 ...
    • 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 ...