Black Friday
Skip to documentation content

Pricing, Payments & Tax

Configure advanced Pro tax rules

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.

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.

Was this article helpful?

Your feedback helps us improve the documentation.