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.
effective date of the period with maximum stay
end date of the period with maximum stay
number of nights
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:
TSU twin for sole use room
If present, it has to be specified. The TSU doesn't inherit the maximum stay of the TWN.
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>
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)