Rates

OTA_HotelRateAmountNotifRQ

1

Root node

@TimeStamp

1

DateTime

Time of the transaction in xml schema dateTime format.

Format like yyyy-MM-dd'T'HH:mm:ssZZ (without fraction of a second)
i.e '2022-08-01T09:30:47+02:00'

See TimeStamp.

@Version

1

Decimal

Always "1.0"

@EchoToken

1

String

Globally unique identifier for the request, this will be reflected as an EchoToken in the response. See EchoTokens.

OTA_HotelRateAmountNotifRQ /
RateAmountMessages

1

Contains the rate messages for a given hotel.

@HotelCode

1

String

The code for the property whose availability is being updated. See HotelCode.

RateAmountMessages / RateAmountMessage

1..n

Contain details of a rate update for a time span.

RateAmountMessage / StatusApplicationControl

1

Contains date and room identification information.
This element must appear once in each RateAmountMessage element.
The StatusApplicationControl element is used to specify the room type, rate code and dates for which the update applies. The dates affected by the update are controlled by the mandatory @Start and @End attributes.

@InvTypeCode

1

String

Identifies the room.

@RatePlanCode

0..1

String

Identifies the rate.

@Start

1

Date

The start date for which the rate update is being set. This date is inclusive.

@End

1

Date

The end date for which the rate update is being set. This date is inclusive.

RateAmountMessage / Rates

1

Rates / Rate

1

Rate / BaseByGuestAmts

1

Base charge for a given number of guests.

BaseByGuestAmts / BaseByGuestAmt

1..n

Contains information about the rates.

@AmountAfterTax

1

Decimal

Rate Amount after tax. Positive decimal value.

@NumberOfGuests

0..1

Integer

Number of guests in room.

Mandatory when Occupancy Based Pricing is enabled.

@AgeQualifyingCode

0..1

Integer

SiteMinder supports the following values:
10 = Adult

Mandatory when Occupancy Based Pricing is enabled.

@CurrencyCode

0..1

String

The currency of the rate. This is an optional attribute can be enabled if requested.
This feature is configured at the channel level. Once it’s enabled, the @CurrencyCode will applies to all rate messages

Rate / AdditionalGuestAmounts

0..1

Additional charges for extra guests for a given age qualifying code.

AdditionalGuestAmounts /
AdditionalGuestAmount

1..2

Mandatory if AdditionalGuestAmounts is present

@AgeQualifyingCode

1

Integer

SiteMinder supports the following values:
10 = Adult
8   = Child

Note: If Occupancy Based Pricing is enabled, the AdditionalGuestAmount for AgeQualifyingCode=’10’ is no longer included in the XML

@Amount

1

Decimal

Extra charge amount.

@CurrencyCode

0..1

String

The currency of the extra guest amount. This is an optional attribute can be enabled if requested.
This feature is configured at the channel level. Once it’s enabled, the @CurrencyCode will applies to all rate messages.

Rate / RateDescription

0..1

Description of what the rate includes.

RateDescription / Text

1

String

The inclusion text. Max Length is 255 characters.

OTA_HotelRateAmountNotifRS

1

Root element

@EchoToken

1

String

Return the EchoToken from the request message. See EchoTokens.

@Version

1

Decimal

Always "1.0"

@TimeStamp

1

DateTime

Time of the transaction in xml schema dateTime format.

Format like yyyy-MM-dd'T'HH:mm:ssZZ (without fraction of a second)
i.e '2022-08-01T09:30:47+02:00'

See TimeStamp.

OTA_HotelRateAmountNotifRS / Success

0..1

Must be present ONLY if it was a successful response.
The Errors node must not be present if the Success node is present.

OTA_HotelRateAmountNotifRS / Errors

0..1

Contains a list of errors if the request failed to process.

Errors / Error

1..n

Mandatory if Errors present.

@Type

1

String

Mandatory if Errors present.
Any type from the OTA Error Warning Types (EWT) table can be used. In particular, the following types are recommended:

1: Unknown
12: Processing exception

The use of the following types under their respective conditions is mandatory:

4: Authentication (If username and password are not authenticated)
The text must be “Invalid Username and/or Password” in English language.

6: Authorisation (If authenticated username is not authorised to alter hotel data)
The text must be “Hotel not found for HotelCode=XXXXXX” in English language, replacing XXXXXX with HotelCode received in the OTA_HotelAvailRQ.

@Code

0..1

String

Any code from the OTA Error Codes (ERR) table can be used. Using the following codes under their respective conditions is mandatory:

448: System error
392: Invalid hotel code
402: Invalid room type
783: Room or rate not found
249: Invalid rate code

For PDP only:
137: Adult occupancy mismatch
This must be returned when an Per Day Pricing Based Pricing OTA_HotelRateAmountNotifRQ is sent where the higher NumberOfGuests sent is either below or above the included occupancy of the room. The text must be “Invalid included occupancy” in English language.

For OBP only:
397: Invalid number of adults
This must be returned when an Occupancy Based Pricing OTA_HotelRateAmountNotifRQ is sent where the total NumberOfGuests sent is either below or above the maximum adult occupancy of the room. The text must be “Invalid number of adults” in English language.