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.

Request

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

    • days

    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>
Response

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

    • days

    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)

    • value

    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