Service Equality Template β Fractional Multiplier Validation
Zenoti checks whether any currently active or frozen memberships use a service equality template with an equivalence factor that rounds to 0.33 or 0.67 before you make changes that would affect fractional-multiplier redemption behavior. This article explains what the check does, when it runs, and how to interpret its result.
Note: For conceptual background on service equality templates, see Service Equality Templates β Master Data Management.
On this page
- Before you begin
- How the fractional multiplier check works
- What the check returns
- Steps
- Tips
- Troubleshooting
- Related articles
Before you begin
- Your organization must have at least one service equality template configured. For setup instructions, see Service Equality Templates β Master Data Management.
- You need access to membership configuration settings. Navigate to Configuration > Memberships > Membership actions to reach the relevant settings area.
- The check runs automatically when the system detects a configuration change that could affect how fractional equivalence factors are applied at redemption. You do not trigger it manually.
How the fractional multiplier check works
When you make a change to a service equality template or to a setting that governs redemption behavior, Zenoti evaluates whether any memberships currently in an Active or Frozen state are using a service equality template whose equivalence factor rounds to 0.33 or 0.67.
These two values are significant because they represent one-third and two-thirds fractions. When a guest redeems a service credit against a template with such a factor, the system must round the credit calculation. If the rounding behavior changes β for example, because the template definition is updated β guests with active or frozen memberships could receive a different number of credits than they expect.
The check examines all memberships with:
- Membership Status = Active (status value 1), or
- Membership Status = Frozen (status value 3)
It then determines whether any of those memberships are linked to a service equality template whose equivalence factor rounds to 0.33 or 0.67.
Important: The check covers only Active and Frozen memberships. Cancelled, Expired, Closed, and other statuses are not evaluated. This is intentional β only memberships where redemption is currently possible or will resume after unfreeze are affected by a change to fractional multiplier behavior.
What the check returns
The check returns a single indicator:
| Result | Meaning |
|---|---|
HasActiveFractionalMemberships = 1 |
One or more Active or Frozen memberships are using a service equality template with an equivalence factor that rounds to 0.33 or 0.67. Proceed with caution β the change you are about to make will affect redemption calculations for those members. |
HasActiveFractionalMemberships = 0 |
No Active or Frozen memberships are currently using a fractional-multiplier template. The change you are about to make will not affect any live redemption calculations. |
When the result is 1, Zenoti displays a warning to the administrator before the change is applied. This gives you the opportunity to review the affected memberships and communicate with members if necessary before proceeding.
Steps
The fractional multiplier check runs automatically as part of the system's pre-change validation. The steps below describe what happens and what you should do at each stage.
Review the warning
- Navigate to the service equality template or membership setting you intend to change.
- Make your intended configuration change.
- Before the change is saved, Zenoti evaluates whether any Active or Frozen memberships use a template with a 0.33 or 0.67 equivalence factor.
- If the check returns a result of
1, a warning appears on screen. Read the warning carefully β it indicates that at least one currently active or frozen membership will be affected by the change.
Decide whether to proceed
- Review the affected memberships to understand the scope of impact:
- Identify which service equality templates have equivalence factors that round to 0.33 or 0.67.
- Identify which memberships are currently Active or Frozen and linked to those templates.
- If the impact is acceptable, confirm the change. The system applies the update and the new redemption behavior takes effect for subsequent redemptions.
- If you need more time to assess the impact, select Cancel or navigate away without saving. No change is applied.
Tip: Before making changes to a service equality template that has fractional equivalence factors, consider notifying affected members. Guests with Active memberships may notice a difference in the number of credits applied at their next redemption.
Tips
- Identify fractional templates before making changes. Review your service equality templates and note which ones have equivalence factors of approximately 0.33 (one-third) or 0.67 (two-thirds). These are the templates most likely to trigger the warning.
- Check membership counts before proceeding. When the warning appears, use the membership reports to identify how many Active and Frozen memberships are linked to the affected template. This helps you gauge the scope of the change before confirming.
- Coordinate with front-desk staff. If you proceed with a change that affects fractional multiplier behavior, brief your front-desk team so they can answer guest questions about any difference in credit calculations at the next redemption.
Troubleshooting
The warning appeared but I cannot identify which memberships are affected.
Navigate to the membership reports and filter by Membership Status = Active or Frozen. Cross-reference the results against the service equality templates that have equivalence factors near 0.33 or 0.67. If you need a more targeted view, use the Membership Benefits Detail report to see which memberships are linked to specific service equality templates.
I made a change and no warning appeared, but I expected one.
The check only evaluates memberships in Active (status 1) or Frozen (status 3) states. If all memberships linked to the fractional-multiplier template are in a different state β such as Cancelled, Expired, or Not Started β the check returns 0 and no warning is shown. Verify the current status of the memberships you expected to be flagged.
The warning appeared even though I did not change a service equality template.
The check can be triggered by any configuration change that affects redemption behavior for memberships using service equality templates, not only direct edits to the template itself. Review the change you were making to confirm it touches a setting that governs how service credits are calculated or applied.