Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

...

Note

Either Rate or RateDescription must be present.
If Rate is missing then rates for the given InvTypeCode and RatePlanCode will not be updated.
If RateDescription is missing then inclusions for the given InvTypeCode and RatePlanCode will not be updated.

Choosing a Destination Booking Agent (No longer supported)

To specify which booking agent a rate update is for use the DestinationSystemCodes node. The example below is limiting the update to Expedia and LateRooms. To see the list of booking agent codes, please see Booking Agent Code Table.

...

Element

Number

Description

OTA_HotelRateAmountNotifRQ

1

Root node

@EchoToken

1

Globally unique identifier for the request, the value will be returned in the response EchoToken.

@Version

1

Current version is 1.0

@Timestamp

1

Timestamp of the request in xml dateTime format. Format like yyyy-MM-dd'T'HH:mm:ssZZ, (i.e '2021-03-09T20:05:52+08:00')

OTA_HotelRateAmountNotifRQ / POS / Source / RequestorID

1

This identifies the system which is sending the Rates. This element must appear in the first Source element.

@Type

1

Fixed at 22 (ESRP)

@ID

1

The ID used will be agreed by the trading partners and remain the same throughout the messages.

OTA_HotelRateAmountNotifRQ /
RateAmountMessages

1

Contains rates for a given hotel

@HotelCode

1

Hotel code of the property whose rate is being updated

RateAmountMessages / RateAmountMessage

1..n

Rates to be updated

RateAmountMessage / StatusApplicationControl

1

Contains room identification information

@RatePlanCode

0..1

Identifies the rate to be updated

@InvTypeCode 

1

Identifies the room to be updated

StatusApplicationControl / DestinationSystemCodes

0..1

Contains a list of BookingAgent/Channel codes that you want to change the rates or inclusions for.
This is optional, by default if it is not present the rate update is assumed to be for all BookingAgents / Channels mapped to the hotel.

DestinationSystemCodes / DestinationSystemCode

1..n

Required if DestinationSystemCodes is present. This is the BookingAgent/Channel code. Please refer to the code table provided.
If an update is sent for a BookingAgent/Channel that is not mapped to the hotel, it will return a validation error.

RateAmountMessage / Rates / Rate

1..n

Contains the timespan the update applies to and the currency code if this is a rate update

@CurrencyCode

0..1

Required if BaseByGuestAmts is present, ie if you are updating the rate amount.
Standard 3 character ISO currency code of the rate eg "AUD"

@Start, @End

1

The start and end date of the rate plan in xml date format. End date is inclusive.
End date cannot be more than 750 days in the future.

@ Sun, Mon, Tue, Weds, Thur, Fri, Sat

0..1

"0" or "1". Optional, if not set all are assumed to be set to true
The day of the week indicators are used to communicate which days of the week the update pertains to. For example, if mon, tue and weds are set to "1", and the other days are set to "0", the rate will only be updated for Monday, Tuesday and Wednesday.
If one is sent they must all be sent.

Rate / BaseByGuestAmts

0..1

Optional. Contains information about the rates. Can be omitted if the update is only for inclusions.

BaseByGuestAmts / BaseByGuestAmt

1

Contains the rate amounts per room

@AmountAfterTax

0..1

One and only one of @AmountAfterTax and @AmountBeforeTax must be included if BaseByGuestAmts is present. Must be a positive decimal value. i.e. a rate of 200 should be 200.00

@AmountBeforeTax

0..1

One and only one of @AmountAfterTax and @AmountBeforeTax must be included if BaseByGuestAmts is present. Must be a positive decimal value. i.e. a rate of 200 should be 200.00

RateDescription / Text

0..1

Inclusions. If available this is a description of the rate being uploaded. Max Length is 255 characters.

...