Coming Soon: Promotion Hierarchy

Coming Soon: Promotion Hierarchy

What is Promotion Hierarchy?

Promotion Hierarchy is a new feature in the Xilnex Portal that allows users to define promotion eligibility by combining multiple item attributes within a single rule.

Instead of creating multiple separate promotion rules, users can configure a single row with multiple conditions using AND logic. For example:

  • Item Brand = Nike
  • Item Category = Running Shoes

The system will evaluate an item against all configured conditions. The promotion will only be applied when the item satisfies every condition in the rule.


Supported Conditions

Promotion Hierarchy currently supports the following item attributes:

  • Item Code
  • Item Category
  • Item Brand
  • Item Type
  • Item Group
  • Item Department
  • Item Division
  • Item Model
  • Promotion Group

Rule Limitation

Within a single rule, each condition type can only be selected once.

Example (Supported):

  • Item Brand = Nike
  • Item Category = Running Shoes

Example (Not Supported):

  • Item Brand = Nike
  • Item Brand = Adidas

This limitation prevents duplicate condition types from being configured within the same rule.

Condition Operators

Promotion Hierarchy currently supports the following operators for each condition:

  • Is – The item must match the selected value.
    • Example: Item Brand is Nike
    • Result: Only items with the Nike brand are eligible.
  • Is Not – The item must not match the selected value.
    • Example: Item Brand is not Nike
    • Result: All item brands are eligible except Nike.

Note: Each condition type can only be configured once within a single rule. For example, you cannot configure both Item Brand = Nike and Item Brand = Adidas in the same rule.

Xilnex Classic POS Behaviour

For Xilnex Classic POS, promotion validation is performed based on all configured hierarchy conditions.

For example, if the promotion is configured with:

  • Item Brand = Nike
  • Item Category = Running Shoes

The POS will verify that the selected item belongs to the Nike brand and the Running Shoes category before applying the promotion.

requently Asked Questions (FAQ)

Does Promotion Hierarchy support OR conditions?

Currently, no. Promotion Hierarchy currently supports AND conditions only.

Support for OR conditions is currently under consideration for a future release. We will share updates if this capability is added to the product roadmap.

Does Promotion Hierarchy support comparison operators such as Greater Than (>), Less Than (<), or other flexible operators?

Currently, no.

Promotion Hierarchy currently supports Is and Is Not operators only. Support for additional comparison operators, such as Greater Than (>), is planned for a future enhancement.

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

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

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

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

    • Recent Articles

    • How to create stock request in Xilnex Classic

      Stock Request Stock Request is the function allowing the outlets to make request stocks from HQ or other outlets. Basic Stock Request Go to Inventory > Stock Request Select Request Stock From outlet. Select ETA (Expected Time Arrival) if any. a) Add ...

    • Coming Soon: Promotion Hierarchy

      What is Promotion Hierarchy? Promotion Hierarchy is a new feature in the Xilnex Portal that allows users to define promotion eligibility by combining multiple item attributes within a single rule. Instead of creating multiple separate promotion ...

    • SecondaryScreen

      Secondary Screen (Customer-Facing Display) A product-knowledge guide for support and internal staff. 1. What is it? The Secondary Screen turns a second display — connected to the iPad by cable — into a customer-facing screen. While the cashier keeps ...

    • PaymentTerminal

      Payment Terminal (Card Machine Integration) A product-knowledge guide for support and internal staff. 1. What is it? A payment terminal is the card machine a customer taps, inserts, or swipes their card on. iPadPOS can connect to a payment terminal ...

    • OutOfStock

      Out of Stock (Marking Items Unavailable) A product-knowledge guide for support and internal staff. 1. What is it? Out of Stock (OOS) lets a cashier mark a menu item as temporarily unavailable — the "we've run out" / "86'd" button. Once an item is ...

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