The channel manager can use this method in order to retrieve information about the active contracts of a specific hotel.

Request

The query type (type) should be set to gethotelscontracts.

Let’s see an example of message the client could send.

<?xml version="1.0" encoding="UTF-8"?>
<envelope>
    <header>
        <actor>...</actor>
        <user>...</user>
        <password>...</password>   
        <version>01b</version>
        <timestamp>20211004113909</timestamp>
        <transaction>12345</transaction>
    </header>
    <query type="gethotelscontracts" product="hotel" hotel="12466"/>
</envelope>

If you want to receive information about derived or connected contracts too, you can populate an optional attribute extended . See the example below

<?xml version="1.0" encoding="UTF-8"?>
<envelope>
    <header>
        <actor>...</actor>
        <user>...</user>
        <password>...</password>   
        <version>01b</version>
        <timestamp>20211004113909</timestamp>
        <transaction>12345</transaction>
    </header>
    <query type="gethotelscontracts" product="hotel" hotel="12466" extended="true"/>
</envelope>
Response

The reply message contains, within tag response, the various fields that show the active contracts specifying the room type.

  • code

    hotel contract

  • board

    this field will be filled with the room and meal treatment configured for the contract at the time of the request. This value will be composed by a combination of roombasis and mealsis separated by the "|" character.

  • commission

    this field may be filled with the markup of our systems. The channel managers always consider the net price, so the commission can be useful for them to obtain it (discount).

  • description

    room name

  • room

    room type

  • update

    Optional element that will be returned if the request was performed with the extended attribute. Derived contracts will populate this element with value READ ONLY while contracts that share allotments will return with value RATES

Below you can find an example of response the client could receive.

<?xml version="1.0" encoding="UTF-8"?>
<envelope>
    <header>
        <actor>...</actor>
        <user>...</user>
        <version>0.1b</version>
        <timestamp>20210216114736</timestamp>
        <transaction>87479</transaction>
    </header>
    <response type="gethotelscontracts"/>
    <agrements>
        <agrement>
            <code>801</code>
            <commission>None</commission>
            <description>STANDARD ROOM</description>
            <rooms>
                <room>TWN</room>
                <room>SGL</room>
                <room>DBL</room>
            </rooms>
        </agrement>
        <agrement>
            <code>802</code>
            <board>RO|X</board>
            <description>SUPERIOR ROOM</description>
            <rooms>
                <room>TRP</room>
                <room>TWN</room>
                <room>SGL</room>
                <room>DBL</room>
                <room>QUD</room>
            </rooms>
            <update>READ ONLY</update>
        </agrement>
    </agrements>
</envelope>

From the response above, you can see the uploaded contracts (in this case 801, 802) for the required hotel and, for each contract, the available rooms:

  • STANDARD ROOM

    801: TWN, SGL, DBL

  • SUPERIOR ROOM

    802: TRP, TWN, SGL, DBL QUD

This is the meaning of all the codes:

  • SGL: single room
  • TWN: twin room
  • DBL: double room
  • TRP: triple room
  • QUD: quadruple room