Core owns the final calculation and saved financial snapshot. Free supplies one room percentage rule; entitled Pro can add advanced prices, room coupons, services and multiple tax rules without making browser-supplied totals authoritative.
Calculation order
- Calculate the room subtotal from the applicable nightly prices and room quantity.
- Deduct the eligible coupon discount from room charges only.
- Add selected service charges using their defined units.
- Evaluate eligible taxes on discounted room charges, services or both.
- Add exclusive tax lines to obtain the grand total; disclose included tax without adding it again.
| Example with exclusive 10% room tax | Amount |
|---|---|
| Room subtotal | 300.00 |
| Room coupon | -30.00 |
| Services | 120.00 |
| Tax on discounted room basis of 270.00 | 27.00 |
| Grand total | 417.00 |
If that 10% rule instead covers room plus services, its basis is 390.00, tax is 39.00 and total is 429.00. The example assumes no other rules. Service scope requires Pro.
Inclusive, fixed and multiple rules
Exclusive percentage tax is basis × rate / 100. Included percentage tax is basis × rate / (100 + rate): 110.00 including 10% contains 10.00 tax and stays 110.00. Fixed booking/night/guest-night taxes are exclusive only.
Rules are non-compound: one tax is not added to another’s basis. Each tax line rounds to two decimals before aggregation. Fixed guest/night units use guests × occupied nights; room quantity is not an extra fixed-tax multiplier. Priority orders rules rather than enabling tax-on-tax behavior.
Display preference, entered-price mode and saved financial history are separate concepts. A different catalogue label does not authorize recalculating an existing reservation.
Quote and snapshot boundaries
Book Now checks a server quote before the native POST. Changed selections or totals require explicit review. Final submission rechecks availability, pricing and the quote; it can still reject later changes safely.
Successful creation saves room, discount, service, tax and nightly financial records. Receipts and collection read those amounts rather than live rules. Room photos/names may use current presentation and are not the same snapshot guarantee.
An active required provider that is unavailable causes calculation to fail closed; a partial tax total is not accepted as a safe fallback. See tax mismatch diagnosis.
