Информация о занятости (Availabilities)

Мы будем отправлять цены, параметры занятости и ограничений на Площадку каждый раз, когда они будут изменены. После создания интеграции по Объекту происходит полная выгрузка данных (на год вперед). Далее мы отправляем интервалы, которые надо обновить. Так же ночью мы выгружаем динамические ограничения. Речь идет о об ограничениях вида: Если до начала заезда осталось менее двух дней, то минимальный срок 1 день. По этому правилу каждый день будет приходить новый минимальный срок на следующий день.

Запрос (Request)

URL: POST /availability

Запрос

Параметр	Положение	Тип	Описание
auth_token *****	query (url)	string	Идентификатор пользователя
sign *****	query (url)	string	Подпись сообщения (подробнее)
availabilities *****	body (json)	array[object]	Массив сообщений с информацией о занятости
∟ record_id *****		integer	Номер записи в сообщении
∟ date_from *****		date (`YYYY-MM-DD`)	Дата заезда
∟ date_to *****		date `(YYYY-MM-DD`)	Дата выезда
∟ accommodation_id *****		string	Идентификатор объекта размещения
∟ count *****		integer	Количество свободных номеров для бронирования
∟agency_id		integer	Идентификатор агентства. Необязательный параметр. Отправляется в случае, если площадке это необходимо.
prices_and_restrictions *****	body (json)	array[object]	Массив сообщений с информацией о ценах и ограничениях
∟ record_id *****		integer	Номер записи в сообщении
∟ date_from *****		date (`YYYY-MM-DD`)	Дата заезда
∟ date_to *****		date (`YYYY-MM-DD`)	Дата выезда
∟ accommodation_id *****		string	Идентификатор объекта размещения
∟ price		integer	Цена за ночь
∟ guest_count		integer	Кол-во основных мест
∟ extra_fee		integer	Наценка за доп. гостей
∟ min_stay		integer	Минимальный срок бронирования
∟agency_id		integer	Идентификатор агентства. Необязательный параметр. Отправляется в случае, если площадке это необходимо.

Примеры:

private_key = "ZvCq2iiqpEs4TJrjLBt"

cURL пример:
JS пример:

Описание примеров:

availabilities
1. Первое сообщение закрывает объект 1138 для бронирования с 9 до 15 августа.
2. Второе сообщение открывает объект 2000 для бронирования с 10 до 12 октября.
prices_and_restrictions
1. Первое сообщение устанавливает цену в 2000 руб. за сутки и минимальный срок проживания 2 дня для объекта 2021 с 9 по 15 сентября.
2. Второе сообщение устанавливает только минимальный срок в 4 дня для объекта 2021 с 11 по 20 ноября.

Ответ (Response)

В ответ приходит либо пустой объект, если не было никаких ошибок. Либо объект с полем errors в котором перечислены записи с ошибками и описание ошибки.

Параметр	Тип	Описание
availabilities	array[object]
∟ record_id	integer	Номер записи в сообщении
∟ error	string	Текст ошибки
prices_and_restrictions	array[object]
∟ record_id	integer	Номер записи в сообщении
∟ error	string	Текст ошибки

Пример