Perfect. Here’s a full documentation draft in the Mangobeds style based on all the info and screenshots you shared:
Understanding how Mangobeds calculates prices helps you predict totals accurately—especially when seasonal rates and long-stay discounts overlap. Here’s a clear breakdown of how it all works behind the scenes.
1. How the system calculates the nightly price
When you create or receive a booking, Mangobeds looks at each calendar day of the stay and applies these rules:
- It first checks for a Seasonal Rate that matches that date.
- If multiple seasonal rates overlap, the highest rate takes priority.
- If no seasonal rate applies, the system uses the Base Rate of the accommodation.
- Once all daily prices are found, Mangobeds computes an average per-night price for the entire stay.
That’s the “Price / night” you see on the booking page.
Example:
If two nights cost 2,300 MXN and the third costs 1,700 MXN, the average price shown is (2,300 + 2,300 + 1,700) ÷ 3 = 2,100 MXN.
2. Applying long-stay discounts (like Weekly or Monthly)
After calculating the blended average, Mangobeds applies any active long-stay promotions—for example, “Monthly −50%”.
This discount is applied after averaging all nights (including seasonal ones).
This means the order is:
Seasonal rates → blended average → long-stay discount → rounding.
3. Why the totals might show slightly different numbers
The interface rounds the per-night price to the nearest whole, while the internal calculation keeps two decimals.
Because of this, small changes (like 100 MXN in a seasonal rate) can lead to slightly bigger visible differences in the total, usually just rounding effects.
Example from a 28-night stay:
– You change one night’s rate by 100 MXN.
– That’s 100 ÷ 28 = 3.57 MXN per-night difference before discount.
– After applying the monthly −50% discount, it’s 1.78 MXN.
– Rounded up, that can display as about 4 MXN per night × 28 = 112 MXN total difference.
So the math checks out, it’s just rounding and averaging.
Conclusion
Mangobeds takes all nightly rates, finds the highest valid one per day, averages them across the stay, then applies any active long-stay discounts. Small rounding differences are expected, and everything you see in totals matches that internal calculation.
