Function setRates (rates and availability)
- Hans van Rijt
- Wouter van Gessel
The function setRates is designed for external channels to update the Hoteliers.com internal availability and rates of the requested rooms and/or packages. Availability and rates can be updated until 11 months after the current date.
Extchannel Push
request setRates
<?xml version="1.0" encoding="UTF-8" ?>
<request function="setRates">
<extChannel ID="15" name="test" password="F@k3Pa$4"/>
<hotelID>8</hotelID>
<rooms>
<room ID="3113" rateID="3417">
<rateData date="2018-04-27">
<rate curr="EUR">65</rate>
<available>10</available>
<minimumNights>1</minimumNights>
<maximumNights>0</maximumNights>
</rateData>
</room>
<room ID="3113" corporateRateID="693">
<rateData date="2018-04-27">
<rate curr="EUR">51</rate>
<available>1</available>
<minimumNights>1</minimumNights>
<maximumNights>0</maximumNights>
</rateData>
</room>
</rooms>
<packages>
<package ID="10997">
<rateData date="2018-04-27">
<rate curr="EUR">75</rate>
</rateData>
</package>
</packages>
</request>request setRates
Element | Number | Required | Description |
extChannel | 1 | Required | Required element, indicates the channel ID and gives authentication information for hoteliers.com |
@ID | 1 | Required | channel ID supplied by Hoteliers.com. |
@name | 1 | Required | Extchannel name supplied by Hoteliers.com |
@password | 1 | Required | Password supplied by Hoteliers.com |
hotelID | 1 | Required | hotelID |
rooms | 1 | Optional | Rooms container (Required when packages are absent) |
rooms / room | 1..n | Required | Room information |
@ID | 1 | Required | roomID |
@rateID | 1 | Required | rateID |
@corporateRateID | 1 | Required | corporateRateID |
rooms / room / rateData | 1..n | Required | Rate container |
@date | 1 | Required | The date of the rate to be set in format YYYY-MM-DD |
rooms / room / rateData / rate | 1 | Optional | Rate element |
@curr | 1 | Required | Currency of the rate |
rooms / room / rateData / available | 1 | Optional | Availability of the rate |
rooms / room / rateData / minimumNigts | 1 | Optional | Minimun nights of stay -1 is ‘locked for arrival’, if applicable |
rooms / room / rateData / maximumNights | 1 | Optional | Maximum nihgts of stay. -1 is ‘locked for departure’, if applicable |
packages | 1 | Optional | Packages container (Required when rooms are absent) |
packages / package | 1..n | Required | Package element |
@ID | 1 | Required | PackagedealID |
packages / package / rateData | 1..n | Required | Rate container |
@date | 1 | Required | The date of the rate to be set in format YYYY-MM-DD |
packages / package / rateData / rate | 1 | Optional | Rate element |
@curr | 1 | Required | Currency of the rate |
Hoteliers.com response
The response can give an OK response, an OK response with errors or an Error response, see: