Введение
Документация по API и интеграциям систем Shelter Cloud и Shelter PRO.
Shelter Cloud
API виджета бронирования
API для создания собственного модуля онлайн-бронирования на сайте отеля или сторонней платформе. Позволяет получать справочники (категории номеров, тарифы, опции), искать доступные варианты размещения по датам и составу гостей, оформлять и отменять бронирования, работать с оплатой. Требуется лицензия на модуль «Бронирование онлайн».
- API v1 (ExternalPrices) —
/externalPrices/. Поиск вариантов, проверка доступности по датам, справочники тарифов и доп. услуг, создание и отмена брони, проверка оплаты. Ответ в формате JavaScript-переменных или JSON. - API v2 (Cloud API) —
/api/online/. Параметры отеля, поиск вариантов с ценами, способы оплаты, создание брони, получение данных заказа. Все методы POST, ответ в JSON. - API v3 (Cloud API v3) —
/OnlineWidget3/online/v3/. Расширенная версия: данные отеля, поиск вариантов, доп. услуги, способы оплаты, создание и отмена брони, проверка промокодов, авторизация пользователя, доступные даты, заявки на бронирование. Все методы POST, ответ в JSON. Доступен Swagger.
Shelter Cloud API (ShelterCloudAPI)
REST API для серверной интеграции с Shelter Cloud. Предоставляет полный доступ к данным PMS: управление бронированиями (поиск, фильтрация, заселение/выселение), гостями, номерным фондом, тарифами, финансовыми операциями (начисления, платежи), контрагентами, дополнительными услугами, справочниками. Поддерживает вебхуки для уведомлений об изменениях в бронированиях.
- ShelterCloudAPI v1 —
/sheltercloudapi/. Все методы REST (GET/POST/PUT/DELETE), ответ в JSON, аутентификация по Bearer-токену. 69 эндпоинтов, 18 контроллеров. Доступен Swagger.
Shelter PRO
API Онлайн-сервера
XML API для интеграции внешних систем с локальной версией Shelter Pro. Онлайн-сервер работает как TCP-сервер и HTTP-сервер, развёртывается локально на сервере клиента. Позволяет получать справочники, работать с номерным фондом, бронированиями, гостями, тарифами, организациями. Поддерживает подписку на обновления.
- API Онлайн-сервера — XML over TCP/HTTP. Аутентификация через XML-команды, опциональная подпись SHA512. Более 70 методов. Тестирование через Shelter Online Server Test.
Интеграции
- Интеграция с 1С:Бухгалтерия — обмен данными между Shelter Cloud и 1С:Бухгалтерия