Getting Started with Xilnex Promotion

Introduction

Welcome to the Xilnex Promotion Engine, designed to equip you with the knowledge and skills to configure and manage powerful, rule-based promotions in the Xilnex system. This article will guide you through the key concepts, setup procedures, and best practices for creating targeted, dynamic promotions that drive sales, improve customer engagement, and align with your business strategies.

Whether you're setting up simple discounts or complex conditional offers, you'll learn how to structure your promotions effectively using the tools and flexibility of the Xilnex promotion engine. Let's get started with transforming your pricing strategy into a competitive advantage.

---

Supported Products

Currently, the Xilnex Promotion module is supported in the following product modules:

Products supported	Modules related
Xilnex Classic POS	Modules: Retail POS, F&B POS, Sales Invoice Supported Functions: Fully supports all promotion rules, including item combinations, bill-level discounts, and customer-specific logic. Able to apply vouchers with discount or item promotion during checkout. Real-time validation and reward application at the point of sale. Handles promotion stacking and prioritization logic.
Xilnex F&B GO	Modules: Sales Module with add voucher supported Supported Functions: Supports automatic promotion application based on configured rules. Allows users to manually key in or scan voucher codes during transaction. Optimized for mobile retail or field sales scenarios. Lightweight implementation designed for on-the-go usage with direct API promotion checking.
Xilnex iPad POS	Modules: F&B equivalent to Classic POS Supported Functions: Full promotion engine compatibility, similar to Classic POS. Ability to apply rule-based promotions and add vouchers at checkout. Designed with a touch-friendly interface, ideal for retail counters and table-side service. Real-time sync with central promotion setup.
Xilnex Live Order	Modules: supported for Static QR Order with direct payment Supported Functions: Automatically applies valid promotions based on order content and customer status. Customers can enter voucher codes manually at checkout. Supports time-based or location-specific campaign logic. Customers can check discounts applied to the item at checkout page before making any payment. Integrates with loyalty programs for eligible promo offers.
Xilnex Live Kiosk	Modules: In-store customer-facing Kiosk Supported Functions: Capable of triggering promotion logic automatically during checkout. Customers can enter voucher codes before payment to trigger promotion and order will update automatically. Designed for minimal interaction with smooth UX for self-checkout scenarios.
Xilnex Loyalty Apps Xilnex Loyalty Lite	Modules: Mobile or Web-Based Loyalty Platform with Built-in Ordering Supported Functions: Customers can enjoy loyalty-based promotions during online purchases. Can redeem vouchers earned through loyalty points or rewards and use them in the order platform. Ensures consistent application of rules (e.g., member-only discounts, tier-based rewards).
Xilnex API	Endpoints & Capabilities: Check promotions based on item content, outlet, and customer info. Add voucher code with validation in order to directly apply voucher into the sales. Generate sales transactions via external platforms while applying eligible promotions. Enables third-party platforms (e.g., ecommerce, ERP, CRM) to interact with the Xilnex promotion engine.

Summary of Capabilities Across Modules

Platform / Module	Auto Promo	Manual Voucher	Customer Filter	Rule-Based Logic	API-related
Classic POS (Windows)	✅	✅	✅	✅	-
Android Sales App	✅	✅	-	✅	✅
iPad POS	✅	✅	✅	✅	-
Online Order (Web/App)	✅	✅	✅	✅	✅
Kiosk	✅	✅	✅	✅	✅
Loyalty App with Online Order	✅	✅	✅	✅	✅

---

Core Structure of Promotion Engine

Base Structure of Promotion Setup

Xilnex's promotion engine is architected to offer maximum flexibility with business logic clarity. The structure of a promotion is intentionally split into two major layers: Campaign Info and Promotion Rules. This separation ensures that configuration remains modular, manageable, and scalable—especially important for businesses running multiple overlapping campaigns across regions, brands, or customer tiers.

Campaign – The Promotion Shell

The Campaign acts as the container for the promotion. It governs the overall scope, visibility, and scheduling of the promotion inside it.

Key Components:

• Campaign Name & Description: Identifier for the promotion across systems and reports.
• Start/End Date & Time: Controls when the promotion becomes effective. Time-specific setup supports flash sales, peak-hour discounts, or limited-time bundles.
• Day-of-Week Filters & Time Slots: Enable recurring schedules (Example: "Monday Lunch Deals" from 12pm–2pm).
• Branch Assignment: Determines which outlets will run the promotion. This supports localized campaigns (Example: outlet anniversary specials) without affecting other branches.
  

Campaign Info answers:

"When does this promotion apply?" "Where should it run?"

"Is this campaign currently active?"

Interactions Between Campaign Info & Promotion Rules

These two layers are decoupled but interdependent:

1. Campaign info controls the environment, while
   
2. Promotion Rules define transaction logic.
   

This architecture allows:

1. Reusing the same promotion rules across different campaigns (such as seasonal vs. loyalty-based).
   
2. Running parallel campaigns with distinct scheduling but similar rule logic.
   
3. Isolating configuration issues when a campaign behaves incorrectly (such as timing error vs. logic error).
   

---

Summary

As summary, the promotion setup structure in Xilnex is designed for:

1. Configurability: Adapt to retail, F&B, services, and franchise models.
   
2. Scalability: Manage hundreds of promotions across outlets without complexity.
   
3. Control: Ensure promotions apply precisely when and where intended.
   
4. Efficiency: Modular configuration reduces repetition and streamlines operations.
   

This layered approach ensures promotions are strategically targeted, operationally reliable, and commercially effective.

• Related Articles

• Setting Up a Xilnex Promotion

  How to Set Up a Xilnex In order to start promotion setup, you need to login to our Xilnex Portal, which is https://portal.xilnex.com/ to continue to setup. The promotion management module is located under the Customer engagement section. You can use ...

• What is Promotion Checking Tools in Xilnex?

  Introduction Use case This tool helps you simulate and test your promotion setups in Xilnex. It's especially useful for verifying time-sensitive, branch-specific, or customer-specific promotions before they go live — ensuring that all your ...

• Buy 1 Free 1 Promotion

  Use Case: New item promotion, upsell for specific item. From the sample above, there are 2 rows of items added into the rules item list. This means that the promotion will be triggered when any 2 items are added into the sales. With the promotion ...

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

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

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