Entitled Pro extends the shared Tax Engine with multiple rules, fixed charges, service scope and conditions. Core still calculates and saves the authoritative tax result for each new booking.
Build and test one rule at a time
Open the Advanced Tax Rules screen with the appropriate settings permission. Set a clear name, type, rate/amount, scope, price mode, priority and Active status. Check the shared Tax Settings enablement and any existing Free rule to avoid accidental duplicate taxes.
| Type | Charge units | Price mode |
|---|---|---|
| Percentage | Discounted room basis, services basis or both | Exclusive or inclusive |
| Fixed per booking | Once per booking | Exclusive only |
| Fixed per night | Occupied nights | Exclusive only |
| Fixed per guest / night | Guests × occupied nights | Exclusive only |
Fixed units are the contract’s booking/stay units; they are not automatically multiplied by room quantity. Scope and eligibility determine whether the rule applies. Verify the intended economics with a multi-room test instead of treating a fixed-per-night rule as fixed-per-room-per-night.
Add conditions
Optional conditions include minimum/maximum nights, minimum guests, a check-in date range and selected room IDs. Leave a room filter blank only when the rule should cover every room. Test both matching and non-matching stays.
Priority orders applicable rules; it does not enable compound taxation. Percentage rules use their eligible bases, not a previous tax line. Fixed taxes cannot be configured as inclusive. Each line is rounded to two decimals before aggregation.
Check saved totals and provider readiness
Use a synthetic quote containing a room discount and a selected service. Compare room/service scope, included and added taxes, total and the saved booking lines. For example, a 3.00 fixed guest/night charge for two guests over three nights contributes 18.00 when eligible.
Existing bookings keep immutable tax snapshots after a rule is edited or deleted. Do not recalculate them using current rules during payment or receipt rendering. If active Pro tax rules require an unavailable provider or entitlement, new booking calculation fails closed rather than using a partial tax total.
Back up before changing the configuration and retain the intended previous rules for recovery. Restore provider readiness or a reviewed future configuration; do not delete historical booking tax rows. See tax mismatch recovery.
