Benefits are non-monetary incentives issued to or claimed by customers. They represent specific entitlements — a percentage discount, a free product, an event RSVP, a competition entry, or a service entitlement.Documentation Index
Fetch the complete documentation index at: https://docs.omneo.io/llms.txt
Use this file to discover all available pages before exploring further.
Key characteristics
- Benefits are profile-specific — they must be assigned to a known profile and cannot be applied generically
- Benefits have an expiry date and a maximum redemption count
- A benefit can be redeemed multiple times within its limits (e.g., 3 VIP lounge visits, unlimited 20% off knitwear until expiry)
- Benefits are stand-alone — a single benefit is a single entitlement, not part of a balance
- The main distinction from rewards: Benefits are percentage or product-based; Rewards are dollar-value
Issued vs claimed
Benefits have two distinct entry mechanics:| Mechanic | Description |
|---|---|
| Issued | Omneo creates a benefit instance on a profile automatically (via reaction, tier attainment, etc.) |
| Claimed | The customer requests the benefit themselves — Omneo checks eligibility via JSON conditions before granting |
Benefit categories
Product discount
A percentage off specific products or categories:- “10% off all full-price items”
- “15% off the denim category”
Free product (gift with purchase)
The benefit unlocks a 100% discount on a specified product, or enables “buy X get Y” or “gift with purchase” mechanics.General entitlement
Service or access entitlements not directly tied to a product purchase:- Free alterations
- Early access to sale
- VIP lounge access
- Event RSVP
How benefits work at POS/eCommerce
The promotional rules for benefits are configured in the POS or eCommerce system independently of how the customer earns the benefit. Once a benefit is issued to a profile, the promotional rule becomes unlocked via the Omneo integration when the customer is identified at purchase.Redemption conditions
For a benefit to be redeemable:- The benefit’s redemption window must still be open (end date in the future)
- The benefit must be active (not expired)
- The benefit has not reached its maximum redemption count
- The benefit definition’s global redemption count has not been exceeded