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

    • Managing Lark User Email Mapping in Xilnex for Lark

      Overview The Users card matches each Xilnex user to their Lark account by email. This is what lets features like Permission Approvals and Document Approvals deliver Lark cards to the right person. This article covers how to review the mapping and fix ...
    • E-Wallet and Credit Card Payment - Recheck Status & Force Complete

      This guide walks you through what to do when a payment goes through on the terminal or e-wallet, but Classic POS fails to commit sales. When Does This Happen? During payment, Classic POS will show a "Connecting to Ewallet party..." or processing ...
    • E-Journal for BIR Compliance (Philippines)

      Overview The E-Journal feature generates a .txt file that complies with BIR (Bureau of Internal Revenue) requirements in the Philippines. This feature is available only for the Philippines COM. Users from other countries' COMs will not be able to ...
    • Disconnecting or Reconnecting Xilnex for Lark

      This article covers how to disable a template, fully disconnect the integration from Lark, and reconnect it again. Disable a Template Turning a base off only stops that one base, everything else keeps syncing, and none of your existing data in Lark ...
    • Creating a Base in Xilnex for Lark

      Overview This article walks you through creating a base for a template, giving end users access to it in Lark, and verifying data is syncing correctly. Xilnex for Lark must already be connected before you start. If the Templates card isn't accessible ...
    • 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 ...
    • Intermediate - How to Configure and Use Approval Settings in Purchase Orders (PO)

      1.0 What is approval setting In general, "approval setting" refers to the configuration or process by which a request, action, or change must be reviewed and approved before it proceeds. The term is often used in business, software applications, and ...
    • Buy 2 for Special Price Promotion

      Use Case: Stock clearance, seasonal offers, or spotlight products. From the sample screenshot above, this promotion requires 2 items to trigger. If only 1 Milk Tea is added to the sales list, no discount will apply since the condition of 2 items is ...
    • Creating Delivery Type for Sales in Classic POS

      How to Create Delivery Type 1. Access to the [System Configuration] 2. Select the [Sales] section 3. In the [All Outlets] tab, look for the 'Delivery Type' 4. Click on the [Configure] In the Delivery Type Setup form: 1. Enter the Delivery Type. 2. ...