The supplier sends this message to set the value of “maximum stay” parameter: with this method you can set the maximum number of nights that can be booked by the client for a specific combination (period, contract and, if you want, also room type). For this function we enable only single operation, we are not accept multy operations. The query type (type) is set to setmaximumstay.

PAY ATTENTION: A period of allotment must be already entered in order to process the request. The period must exist, it doesn’t matter with which values.

PAY ATTENTION: it is recommended to use this instruction AFTER the allotments setting in order to avoid overwritings.

Below you can see the fields you can find in the message body and their meanings.

Request

• startdate

  effective date of the period with maximum stay

• enddate

  end date of the period with maximum stay

• nights

  number of nights

• roomtype

  this is an optional field, that you can use if you want to set a specific maximum stay only for a specific room type (and not for all the room types bound to the contract).

  Parameter which identifies the room type:

• • SGL single room

• • TSU twin for sole use room

    If present, it has to be specified. The TSU doesn't inherit the maximum stay of the TWN.

• • TWN twin room
• • DBL double room
• • TRP triple room
• • QUD quadruple room
• • STR big accommodations

• checkindays

  this field has to be set to 0,1,2 etc; the values refer to the days of the week ('MON':0, 'TUE':1, 'WED':2, 'THU':3, 'FRI':4, 'SAT':5, 'SUN':6).

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>1.0.0</version>
        <timestamp>20210808162849</timestamp>
        <transaction>52791</transaction>
    </header>
    <query type="setmaximumstay" product="hotel" agrement="1299">
    <!-- new template with night = 3 -->
                <date>
            <startdate>2022-06-10</startdate>
            <enddate>2022-06-25</enddate>
<!-- not mandatory -->
          <roomtype>DBL</roomtype>
    <-- -->
            <nights>3</nights>          
            <checkindays>
                <checkinday>0</checkinday>
                <checkinday>1</checkinday>
            </checkindays>
        </date>     
    </query>
</envelope>

Response

The reply message contains, within tag response, the string "OK" or in case of error the string "error code XX (description)", where XX represents an error code (error code list)