Channel Manager API will send updates for rate using OTA_HotelRateAmountNotifRQ message. Channel Manager API will receive the OTA_NotifReportRS and will save the succes or failure of the update.

 

OTA_HotelRateAmountNotifRQ

The OTA_HotelRateAmountNotifRQ  message will be used to update the rate for one Room Type for a single hotel.

Each message will contain a single AvailStatusMessages element with the attribute @HotelCode with the Hotel Code assigned by the Channel Manager.

There can be several AvailStatusMessage child elements per request to hold a data range but the message will be limited to one hotel.

 

<OTA_HotelRateAmountNotifRQ EchoToken="b024c13c-3dd3-4df1-bb56-5f88ae0b5700" TimeStamp="2021-01-01T12:00:00.000Z" Version="1" xmlns="http://www.opentravel.org/OTA/2003/05">
    <POS>
        <Source>
            <RequestorID Type="22" ID="ULYSESCLOUD"/>
        </Source>
    </POS>
    <RateAmountMessages HotelCode="UC123">
        <RateAmountMessage>
            <StatusApplicationControl RatePlanCode="BB|2000|BARBBNR" InvTypeCode="DOB"/>
            <Rates>
                <Rate CurrencyCode="EUR" Start="2021-01-01" End="2021-01-10">
                    <BaseByGuestAmts>
                        <BaseByGuestAmt AmountAfterTax="305.10"/>
                    </BaseByGuestAmts>
                </Rate>
            </Rates>
        </RateAmountMessage>
    </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

Element

Number

Description

OTA_HotelRateAmountNotifRQ

1

Main 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

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

1

Identifies the rate to be updated

@InvTypeCode 

1

Identifies the room to be updated

RateAmountMessage / Rates / Rate

1..n

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

@CurrencyCode

1

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

@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.

Rate / BaseByGuestAmts

1

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

1

Contains the rate amounts per room

OTA_NotifReportRS

This message is returned to the PMS in response to the OTA_HotelRateAmountNotifRQ message. It notifies whether the OTA_HotelRateAmountNotifRQ message has been processed successfully.

Example of success Response

<OTA_NotifReportRS EchoToken="daafcc9e-c8c6-484e-87bc-acd7fedb2980" TimeStamp="2021-01-01T12:00:00Z" Version="1.0" xmlns="http://www.opentravel.org/OTA/2003/05">
    <Success/>
</OTA_NotifReportRS>

Example of error Response

<OTA_NotifReportRS EchoToken="daafcc9e-c8c6-484e-87bc-acd7fedb2980" TimeStamp="2021-01-01T12:00:00Z" Version="1.0" xmlns="http://www.opentravel.org/OTA/2003/05">
  <Errors>
    <Error Type="3" Code="392">Cannot finder hotelier DOB</Error>
  </Errors>
</OTA_HotelAvailNotifRS>

Element

Number

Description

OTA_NotifReportRS

1

Main element

@EchoToken

1

Return the EchoToken from the request message.

@Version

1

Current version is 1.0

@TimeStamp

1

Time of the transaction.

OTA_NotifReportRS / Success

0..1

Will only be present if the request processed successfully. The Errors node will not be present if the Success node is present

OTA_NotifReportRS / Errors

0..1

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

Errors / Error

1..n

Will be at least one node if there is an Errors Node.

@Type

1

Mandatory if Error present.
Any type from the OTA code table for 'Error Warning Type (EWT)' can be used. In particular, the following types are used

3: Biz rule (The business rules for the request message were not met)
4: Authentication error (If username and password are not authenticated)
6: Authorization error (If authenticated username is not authorized to alter hotel data)
10: Required field missing (If xml does not meet the schema, i.e missing request fields or invalid data types.)

@Code

0..1

OTA Error Codes