Daily Rates XML Samples

Daily Rates

Daily Rates allow for a more detailed rate breakdown of the reservation.

Consecutive dates that contain the same rate value should be bundled into a single Rate element, using the 'EffectiveDate' and 'ExpireDate' to specify the date range. The rate value should be an accumulative total of the dates and not the 'per night' pricing.

Daily Rates Samples:

1 Same Rate Value Per Night - No Extras or Tax
2 Same Rate Value Per Night - With Extras and Tax
3 Differing Rate Values Per Night - With Tax
4 Combining Differing Rate Values and Consecutive Rate Values Per Night - With Tax

Same Rate Value Per Night - No Extras or Tax

The example below shows daily rates when the same rate applies to both dates (2021-03-12 and 2021-03-13) and no extra fees and/or charges applies.

In the below example the 'Daily Rate' (AfterTax) would be 250.00 because the rate of 500.00 shown in Rates / Rate / Base is across a 2 day date span. For more information on handling 'Daily Rates' see - Reservation API / Rates / Rate.

<RoomStay>
	<RoomRates>
		<RoomRate RoomTypeCode="ROOM1" RatePlanCode="RATE1" NumberOfUnits="1">
			<Rates>
				<Rate UnitMultiplier="1" RateTimeUnit="Day" EffectiveDate="2021-03-12" ExpireDate="2021-03-14">
					<Base AmountAfterTax="500.00" CurrencyCode="AUD"/>
				</Rate>
			</Rates>
		</RoomRate>
	</RoomRates>
	<TimeSpan Start="2021-03-12" End="2021-03-14"/>
	<Total AmountAfterTax="500.00" CurrencyCode="AUD"/>
</RoomStay>

Same Rate Value Per Night - With Extras and Tax

The example below shows daily rates when the same rate applies to both dates (2021-03-12 and 2021-03-13) and there are extra fees and/or charges.

In the below example the 'Daily Rate' (Base AmountAfterTax) would be 225.00 because the rate of 550.00 shown in Rates / Rate / Base is across a 2 day date span. The 'Daily Rate' (Total AmountAfterTax) in Rates / Rate / Total is 295.00 as the base amount + extra charges have been spread across the 2 day date span. For more information on handling 'Daily Rates' see - Reservation API / Rates / Rate.

<RoomStay>
	<RoomRates>
		<RoomRate RoomTypeCode="ROOM1" RatePlanCode="RATE1" NumberOfUnits="1">
			<Rates>
				<Rate UnitMultiplier="1" RateTimeUnit="Day" EffectiveDate="2021-03-12" ExpireDate="2021-03-14">
					<Base AmountBeforeTax="495.50" AmountAfterTax="550.00" CurrencyCode="AUD"/>
					<Total AmountBeforeTax="531.00" AmountAfterTax="590.00" CurrencyCode="AUD"/>
				</Rate>
			</Rates>
		</RoomRate>
	</RoomRates>
	<TimeSpan Start="2021-03-12" End="2021-03-14"/>
	<Total AmountBeforeTax="531.00" AmountAfterTax="590.00" CurrencyCode="AUD">
		<Taxes>
			<Tax Amount="59.00" CurrencyCode="AUD"/>
		</Taxes>
	</Total>
</RoomStay>

Differing Rate Values Per Night - With Tax

The example below shows daily rates when the rate amount differs for the booked dates.

<RoomStay>
	<RoomRates>
		<RoomRate RoomTypeCode="ROOM1" RatePlanCode="RATE1" NumberOfUnits="1">
			<Rates>
				<Rate UnitMultiplier="1" RateTimeUnit="Day" EffectiveDate="2021-03-12" ExpireDate="2021-03-13">
					<Base AmountBeforeTax="252.00" AmountAfterTax="280.00" CurrencyCode="AUD"/>
				</Rate>
				<Rate UnitMultiplier="1" RateTimeUnit="Day" EffectiveDate="2021-03-13" ExpireDate="2021-03-14">
					<Base AmountBeforeTax="279.00" AmountAfterTax="310.00" CurrencyCode="AUD"/>
				</Rate>
			</Rates>
		</RoomRate>
	</RoomRates>
	<TimeSpan Start="2021-03-12" End="2021-03-14"/>
	<Total AmountBeforeTax="531.00" AmountAfterTax="590.00" CurrencyCode="AUD">
		<Taxes>
			<Tax Amount="59.00" CurrencyCode="AUD"/>
		</Taxes>
	</Total>
</RoomStay>

Combining Differing Rate Values and Consecutive Rate Values Per Night - With Tax

The example below shows a combination of rates, where a 4-night reservation is made containing consecutive rates for only 2 of the nights.