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 configurations behave as expected under different conditions.
Where to find it?
- You can search "Promotion checking tool" in search bar to immediately locate it.
- Alternatively, it's park under Customer Engagement > Promotion Checking Tool.
How to Use It?
1. Select Your Simulation Conditions
Under "Checking for", set the primary simulation conditions:
- Platform:
Choose where you're checking from (e.g., LiveOrder, Classic POS, etc.).
- Branch:
Pick the branch (e.g., MAIN BRANCH) the transaction is happening at.
- Fulfillment Type:
Choose the order type such as Delivery, Pickup, etc.
Once these 3 are selected, click the green "APPLY" button to activate the base conditions.
Make sure you add at least one item to simulate a transaction
2. (Optional) Refine with Advanced Conditions
Click + More conditions to test specific promotion scenarios by setting:
- Sales Person
- Customer Type
- Customer Group
- Xcard Type
- Priority
- Payment Method
- Sales Date (simulate future or past promotions)
This helps you mimic real-world customer profiles or time-specific promos (e.g., festive campaigns, VIP-only rewards, weekday-only discounts).
3. Add Test Items
In the lower section:
- Search by item code or scan a barcode
- Enter quantity
- Click ADD
This step mimics a cart or order entry, letting the system validate if the promotion will apply based on the items and quantity.
4. View Results
Once items are added:
- The system will return whether any promotions are triggered based on your setup.
- You can adjust conditions and try again to ensure all edge cases are covered.
Use Cases & Tips
- Simulate a future date to test upcoming holiday campaigns.
- Switch customer types to verify loyalty tier-based discounts.
- Try different payment methods to confirm method-specific offers.
- Test before major deployments to avoid promotion errors at live checkout.
Mode Indicator
Check the top-right corner for Mode: Retail / F&B, to ensure you're testing in the correct operational context.
Related Articles
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 ...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 ...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. ...