Enabling Staging Mode in Xilnex Classic

Enabling Staging Mode in Xilnex Classic

Introduction

The Staging Mode function provides a controlled environment for testing, configuration, and validation before applying changes to the live production system. It allows businesses to experiment with settings, workflows, and data without affecting actual sales or reports.

In Staging Mode, users can:

  • Work with staging data that simulates real transactions and inventory.

  • Test new configurations such as promotion rules, pricing schemes, UI settings, and device integrations.

  • Validate operational processes including payment flows, receipt printing, and stock movements.

  • Adjust and refine setups to ensure accuracy, usability, and compliance prior to go-live.

Use Cases
Staging Mode is particularly useful for:

  • Rolling out new features or system upgrades.

  • Training staff in a risk-free environment.

  • Testing third-party integrations (payment gateways, loyalty programs, online ordering platforms).

Benefits
By using Staging Mode, businesses can:

  • Reduce operational risks.

  • Shorten deployment cycles.

  • Maintain system reliability in live environments.

How to Enable Staging Mode in Xilnex ClassicPOS?

  1. Enable Xilnex POS to run in Staging Mode which is located in System Configuration > Staging DB > This Machine.


  1. After configuring from configuration above from Production Mode to Staging Mode, Xilnex will run a process to clone all the local database into a set of new staging local databases.



    Note: The Staging Mode configuration is applied at the machine level, not per user. To allow other users to switch to Staging Mode on the same machine, they must be granted the permission [Allow to access staging DB configuration].



  1. After enabling Staging Mode in Xilnex, the following changes will occur:
    1. A notification line will appear in the Main Menu displaying: “You are currently in ‘Staging’ mode.”


    2. While in Staging Mode, Xilnex will not sync any transactions or data to the Cloud (production server). All activity performed remains local to the staging environment.


    3. All the data created and updated in Master Data, such as creating and updating items, creating and updating clients, etc, will not take effect in the Production database.
    4. Besides Master Data, all the transactions created under Sales / Inventory section will not be recorded in Production database as well.
    5. All the printing under Staging Mode will come with 'Staging Outlet' watermark.
  1. After completing the action required in Staging Mode, in order to swap back to Production Mode, you can go to the same configuration location as System Configuration > Staging DB > This Machine.

Re-cloning to staging process

  1. The staging mode database will only capture the data when enabled the Staging Mode configuration and under staging mode will not trigger the synchronization process, which means the data will not updated while in Staging mode.
  2. In order to get the latest update from the server, users can go to the Staging DB configuration page and perform Re-clone to Staging action:


  • There will be a notification when process regeneration of staging table is complete.


Module Supported in Staging Mode

After enabling staging mode in Xilnex, the system will run in offline mode, which means:
  • Sync process will be skipped and no local data will sync up to server
  • Data created during staging mode enabled will impact the staging table only included:
    • Master Data (Item, Client, Vendor, Menu Management, Price Modifier)
    • Sales (Sales Invoice, Point Of Sale, F&B Point Of Sale, Sales Order, Sales Return, Quotation)
    • Inventory transaction (Purchase Order, Purchase Return, Goods Received Note, Transfer Note)
    • Others (Stock Request, Stock Adjustment, Bill of Materials, Reorder Point, Picking, Prepacking)
    • Promotion synced before enable staging mode will be supported.
  • Data created / updated during staging mode will be removed after swap to Production Mode, including master data, sales data and inventory data.

Module Not Supported in Staging Mode

Certain modules that require Online Mode to process will not function in Staging Mode, including:
  • User management
  • Stock Take
  • Stock Card
  • Live Order
  • E-invoice Posting
  • Online Redemption (Voucher, Point, Third-Party and etc.)

    • Related Articles

    • What is Menu Management in Xilnex Classic POS?

      What is Menu Management in Xilnex Classic POS? The Menu Management function provides a centralized and flexible platform to design, organize, and maintain your product catalog across all sales channels. It is built to streamline menu setup, ensure ...

    • Setting Up Credit Card Terminal in Xilnex ClassicPOS

      Introduction This guide explains how to configure and integrate credit card terminals with the POS system. The integration ensures smooth communication between the POS and payment devices, helping businesses process transactions securely and ...

    • 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 ...

    • 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. ...

    • User guide to configure biometric with ZK Finger Print

      Introduction The Xilnex system supports biometric authentication using fingerprint scanners to enhance security and streamline employee login processes. Our platform now supports both ZK Finger Print and Digital Persona fingerprint scanner devices, ...

    • Recent Articles

    • LiveOrder Dynamic QR - Setup Guide

      What is Dynamic QR? Dynamic QR generates a unique, per-session QR code at point of order — typically printed when a table is opened. The customer scans it to place or continues an order tied to that specific table session. Unlike Static QR ...

    • LiveKiosk Enablement - User Guide

      Overview LiveKiosk is a web-based self-ordering kiosk that runs on the same engine as LiveOrder. It allows customers to place orders independently via a kiosk device — available on Windows (via Classic POS) or Android (via the LiveKiosk APK). All ...

    • Production Release (2026-03-10)

      Release some feature for Live Order. LiveOrder v1.0.627.0310 LiveOrder v1.0.627.0310 Features - Added billing info configuration for Live order

    • Production Release (2026-03-04)

      Release some bugfixes for Live Order and Live Kiosk. Live Order v1.0.572.0304 Live Kiosk v1.0.572.0304 Live Order v1.0.572.0304 Bugfixes Fixed a case where LiveOrder payments got stuck Fixed the closure day/hour settings so they followed the ...

    • Production Release (2026-03-02)

      Release several bug fixes for Live Order and Live Kiosk. Additionally, there are some features and tweaks for Live Kiosk. LiveOrder v1.0.625.0302 LiveKiosk v1.0.625.0302 LiveOrder v1.0.625.0302 Bug Fixes - Fixed an issue where out-of-stock items were ...

    • 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 ...