The supplier sends this message to get base rates for an hotel or a specific agreement. The query type (type) is set to getbaserate.
Below you can see the fields you can find in the message body and their meanings.
hotel (Mandatory) Hotel id to ask for
agreement (Optional) Get only base rates for this agreement id
roomtype (Optional)
Room type. It collects all data relating to a room type.
roomcode (Mandatory if roomtype element is added)
Parameter that identifies the room type
SGL single room TSU twin single use room TWN twin room DBL double room TRP triple room QUD quadruple room STR big accommodations cot (small letters) extrabed (small letters)
startdate
Date from which you want to receive rates
number of days. (You can add this number to the effective date to get the end of the period. If these two dates correspond the value is set to 0).
Let’s see an example of message the client could send.
<envelope>
<header>
<actor>...</actor>
<user>...</user>
<password>...</password>
<version>1.0.0</version>
<timestamp>20250516162719</timestamp>
<transaction>00000001</transaction>
</header>
<query type="getbaserate" product="hotel" hotel="12345" agreement="4321">
<roomtype roomcode="SGL">
<startdate>2025-05-17</startdate>
<days>365</days>
</roomtype>
</query>
</envelope>
The reply message contains within each tag agreement the various fields that describe the tariffs for each type of room.
roomtype
Room type. It collects all data relating to a room type.
roomcode
Parameter that identifies the room type. Possible values: SGL single room, TSU twin for sole use room, TWN twin room, DBL double room, TRP triple room, QUD quadruple room, STR big accommodations
dates
date
number of day. (You can add this number to the start date to get the end of the period. If these two dates correspond this value is set to 0)
rate of room
Let’s see an example of message the client could receive.
<envelope>
<header>
<actor>...</actor>
<user>...</user>
<version>1.0</version>
<timestamp>20250708160524</timestamp>
<transaction>00000001</transaction>
</header>
<response type="getbaserate" />
<agreement id="5796">
<roomtype roomcode="QUD">
<dates>
<date value="2022-02-15">
<days>3652</days>
<value>1000.0</value>
</date>
</dates>
</roomtype>
<roomtype roomcode="SGL">
<dates>
<date value="2022-02-15">
<days>3652</days>
<value>1000.0</value>
</date>
</dates>
</roomtype>
<roomtype roomcode="TSU">
<dates>
<date value="2022-02-15">
<days>3652</days>
<value>1000.0</value>
</date>
</dates>
</roomtype>
<roomtype roomcode="TWN">
<dates>
<date value="2022-02-15">
<days>3652</days>
<value>1000.0</value>
</date>
</dates>
</roomtype>
<roomtype roomcode="TRP">
<dates>
<date value="2022-02-15">
<days>3652</days>
<value>1000.0</value>
</date>
</dates>
</roomtype>
<roomtype roomcode="DBL">
<dates>
<date value="2022-02-15">
<days>3652</days>
<value>1000.0</value>
</date>
</dates>
</roomtype>
</agreement>
<agreement id="5770">
<roomtype roomcode="TWN">
<dates>
<date value="2022-02-09">
<days>294</days>
<value>300.0</value>
</date>
</dates>
</roomtype>
<roomtype roomcode="DBL">
<dates>
<date value="2022-02-09">
<days>294</days>
<value>200.0</value>
</date>
</dates>
</roomtype>
</agreement>
<agreement id="5775">
<roomtype roomcode="TWN">
<dates>
<date value="2022-02-09">
<days>294</days>
<value>300.0</value>
</date>
</dates>
</roomtype>
<roomtype roomcode="DBL">
<dates>
<date value="2022-02-09">
<days>294</days>
<value>200.0</value>
</date>
</dates>
</roomtype>
</agreement>
<agreement id="5783">
<roomtype roomcode="TWN">
<dates>
<date value="2022-02-09">
<days>294</days>
<value>300.0</value>
</date>
</dates>
</roomtype>
<roomtype roomcode="DBL">
<dates>
<date value="2022-02-09">
<days>294</days>
<value>200.0</value>
</date>
</dates>
</roomtype>
</agreement>
<agreement id="5789">
<roomtype roomcode="TWN">
<dates>
<date value="2022-02-09">
<days>294</days>
<value>300.0</value>
</date>
</dates>
</roomtype>
<roomtype roomcode="DBL">
<dates>
<date value="2022-02-09">
<days>294</days>
<value>200.0</value>
</date>
</dates>
</roomtype>
</agreement>
<agreement id="5758">
<roomtype roomcode="TWN">
<dates>
<date value="2022-02-09">
<days>294</days>
<value>300.0</value>
</date>
</dates>
</roomtype>
<roomtype roomcode="DBL">
<dates>
<date value="2022-02-09">
<days>294</days>
<value>200.0</value>
</date>
</dates>
</roomtype>
</agreement>
</envelope>
In case of error the reply message contains, within tag response, the string "error code XX (description)", where XX represents an error code