Площадка может напрямую отправить бронирование в Realty Calendar
URL: POST extranet/bookings
| Параметр | Положение | Тип | Описание |
|---|---|---|---|
| auth_token ***** | query (url) | string | Идентификатор пользователя |
| sign ***** | query (url) | string | Подпись сообщения (подробнее) |
| booking ***** | body (json) | object | Объект с данными о бронировании |
| ∟ booking_id ***** | string | Номер бронирования | |
| ∟ accommodation_id ***** | string | Идентификатор объекта размещения со стороны площадки | |
| ∟date_from ***** | string | Дата заезда (YYYY-MM-DD) |
|
| ∟ date_to ***** | string | Дата выезда (YYYY-MM-DD) |
|
| ∟ guests ***** | integer | Гостей | |
| ∟ price ***** | integer | Общая цена бронирования | |
| ∟ last_update ***** | datetime (iso8601) | Дата и время последнего изменения в часовом поясе, переданном в запросе как timezone |
|
| ∟ booking_date ***** | datetime (iso8601) | Дата и время бронирования в часовом поясе, переданном в запросе как timezone |
|
| ∟ payment_amount | decimal (#.##) | Оплаченная сумма гостем | |
| ∟ payment_datetime | datetime (iso8106) | Дата и время оплаты брони гостем в часовом поясе, переданном в запросе как timezone |
|
| ∟ commission | integer | Комиссия площадки | |
| ∟ contact_name | string | Имя контактного лица | |
| ∟ contact_phone | string | Телефон контактного лица | |
| ∟ contact_email | string | Email контактного лица | |
| ∟ notes | string | Примечания по бронированию | |
| ∟ canceled | boolean | Если присутствует и имеет значение true, значит гость отменил бронирования |
Примечания:
contact_name, contact_phone и contact_email являются контактными. Необходимо, чтобы хотя бы одно из них было заполненоdate_to должна быть больше, чем в date_from. Они не могут быть равныlast_update является ключевым для обновления бронирования (дописать)| Поле | Тип | Описание |
|---|---|---|
| success | boolean | Успех сохранения бронирования в Realty Calendar |
| overbooked | boolean | Бронирование встало поверх другого (овербукинг) |
| error | object | Объект, содержащий информацию об ошибке при сохранении бронирования |
| ∟ code | integer | Код ошибки |
| ∟ message | string | Краткое описание ошибки |
| Code | Описание |
|---|---|
| 1001 | Отсутствует обязательное поле в объекте бронирования |
| 1002 | Поле содержит невалидное значение |
| 1003 | Дата начала бронирования совпадает с датой окончания бронирования |
| 1004 | Дата окончания бронирования в прошлом |
| 1005 | В бронировании отсутствует информация о контактах и имени клиента |
Дописать рекомендации, что делать в связи с ошибками