---
title: 'Set maximum stays'
url: 'https://documentation.netstorming.net/channel-manager/channel-manager-protocol/set-maximum-stays'
markdown: 'https://documentation.netstorming.net/channel-manager/channel-manager-protocol/set-maximum-stays.md'
date: '2026-11-10'
description: '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,…'
taxonomy:
  category:
    - docs
---

# Set maximum stays

[](#)  [ Channel Manager ](https://documentation.netstorming.net/channel-manager)     [ Channel Manager Protocol ](https://documentation.netstorming.net/channel-manager/channel-manager-protocol)      Set maximum stays    

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
<?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)

 [ ](https://documentation.netstorming.net/channel-manager/channel-manager-protocol/set-minimum-stays) [](https://documentation.netstorming.net/channel-manager/channel-manager-protocol/set-all)

---

## Navigation

- Parent: [Channel Manager Protocol](https://documentation.netstorming.net/channel-manager/channel-manager-protocol.md)
- Previous: [Set minimum stays](https://documentation.netstorming.net/channel-manager/channel-manager-protocol/set-minimum-stays.md)
- Next: [Set all](https://documentation.netstorming.net/channel-manager/channel-manager-protocol/set-all.md)