Xilnex Tour Management

Xilnex Tour Management

Overview

The Tour Guide Module is designed to support tourism ticketing and commission tracking. It allows businesses to manage tour companies, tour guides, tour sessions, and commission payouts, with full integration into the POS for sales tracking.

Module Activation

Before using the Tour Guide Module, the user must enable the plugin:

Portal → Plugin → Tour Management
Once enabled, the Tour Management module will be available for setup and configuration.

Tour Management Setup

There are two setup steps in Tour Management:

Step 1: Create Tour Company

Users must first create a Tour Company.
Tour Company Settings include:
  • Outlet Commission Setting: Commission rate per outlet
  • Default Commission Setting: Applied to all outlets by default
Note: A payment-method-based commission calculation is planned and will be introduced in a future interface update. (Currently will insert data on backend and maintain it by engineer)

Step 2: Create Tour Guide

Next, users create Tour Guides by filling in the required information.
Important Notes:
  • There is no direct linkage between Tour Guides and Tour Companies.
  • This design allows a tour guide to work with multiple tour companies.

Data Sync to POS (Classic)

After setup, data will sync to the POS (Classic), enabling:

  • Tour Session Module
  • Tour Session List (Retail POS)

  • Retail Tourism Button in POS

Tour Session Management (Interface Improvement In Progress)

Tour Sessions are created in the Ticket System to register arrivals for the day.

Creating a Tour Session

When creating a tour session, the user will:
  • Enter a Tour Session Code
  • Select a Tour Company
  • Select a Tour Guide
  • Color Tagging (Coming Soon)
  • Optionally flag the session as Walk-in
Walk-in flags allow reporting on walk-in tours and walk-in customers by date.

Tour Session Create simplified Tour company/ Tour guide (Temporary Remove)

Tour Sessions able to create simplified tour company/ tour guide


Creating a simplified Tour company/ Tour guide

  • Only will fill in compulsory field
  • Other information will need to be updated on the portal

Tourist Registration

After selecting the tour company, users can register tourists for the session:
  • Enter number of tourists
  • Select nationality
  • Specify adult and child count
After saving, the system will:
  • Generate and print a QR code for the tour session
The QR code is used at the POS during sales.

Tour Session Status

Each tour session has one of the following statuses:
  • OPEN – Tour session is active and sales can be attached
  • COMPLETE – Tour session has ended. (In backend it will calculate based on commission setting for all the sales that flag the sales under this tour session)
  • PAYOUT – Commission for the session has been paid

POS Integration – Retail Tourism

In the POS, a Retail Tourism button is available.
When selected:

    














  • Cashier can scan the tour session QR code, or

  • Manually select a tour session with OPEN status
All sales performed will be:
  • Tagged to the selected tour session

Commission Calculation & Payout

Commission is calculated during payout based on:
  • Total sales linked to the tour session
  • Outlet commission setting
  • Payment method
Example:
  • Outlet commission: 15%
  • Commission = Total Tour Session Sales × 15% (Based on configuration set)
  • Non Cash = Total Tour Session Sales x 1% (Based on configuration set) (Currently there is no UI for this yet only insert by backend)
  • Total = Comission - Non Cash

Completing & Paying Out a Tour Session

After payment to the tour guide:
  1. User selects the tour session
  2. Performs Complete & Payout action
  3. Support bulk action
Once payout is completed:
  • The session status updates to PAYOUT
  • All related sales are finalized

Reporting

After payout, commission details can be printed via:
Report Printing → Payout Commission Report





Report Filters

The Payout Commission Report includes three filters:
  1. Tour Company Code (Compulsory)
    1. User must select a tour company code to generate the report.
  2. Outlet (Optional)
    1. If not selected, the system will automatically include all outlets.
  3. Tour Guide (Optional)
    1. If not selected, the system will automatically include all tour guides.

Printing Format Configuration

Users can customize printing formats as follows:

Tour Session QR Format

System Configuration → Current Outlet → Tour Session QR

Payout Commission Report Format

System Configuration → Current Outlet → Payout Commission Report


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

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

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

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

    • Centralized Secondary Screen Media (Coming Soon!)

      Secondary Screen Guidelines Current Setup (Local Media) Currently, the secondary screen relies on a local folder to display media on the POS. Xilnex POS automatically creates a folder named "SecondaryMonitorMedia" on the desktop, or users can ...

    • Recent Articles

    • How to Cancel an E-Invoice on Dashboard

      Overview Sometimes cancelling an e-invoice is inevitable. Common situations include: Incorrect buyer information (e.g., wrong name, TIN, or address) Transaction was voided or order was cancelled after invoice issuance Duplicate e-invoice issued for ...

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

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