Sections and articles

Подключение канала Ozon Travel (Озон Путешествия)

Ozon Travel

Версия: v1 | Статус: Beta | Лицензия: Channel Manager | Продукт: Shelter Cloud | Уровень: Пользовательский | Дата: 2025-07-27

Оглавление

Введение

Ozon Travel — сервис бронирования отелей от маркетплейса Ozon. Позволяет гостям бронировать номера через сайт и приложение Ozon. Подключение канала расширяет охват и увеличивает продажи за счёт многомиллионной аудитории покупателей Ozon.

Особенности сервиса

  • Цены указываются только в рублях
  • Цены выгружаются отдельно на каждый тип размещения (основное место, доп. место, без места) с учётом возрастных диапазонов — это позволяет Ozon корректно показывать цены для разных составов гостей
  • Для каждого тарифа можно настроить политику аннулирования в экране тарифов Shelter Cloud — если политика не выбрана, Ozon считает, что отмена возможна без штрафа в любой момент
  • Каталог категорий и тарифов передаётся в Ozon из Shelter Cloud — Shelter Cloud выступает источником справочников, Ozon забирает их через наш Content API
  • Цены, доступность и ограничения выгружаются на 12 месяцев вперёд — данные за пределами этого окна в Ozon не отправляются
  • Для подключения канала требуется код отеля в Ozon, выданный при регистрации в партнёрской программе Ozon

Настройка в Shelter Cloud

Получение кода отеля в Ozon

Перед подключением канала получите код отеля от Ozon Travel. Этот код выдаётся при регистрации вашего объекта в партнёрской программе Ozon.

  1. Откройте партнёрский кабинет Ozon Travel (Ozon для бизнеса → Отели)
  2. При регистрации выберите Shelter Cloud в качестве менеджера каналов — это ускорит подключение

Выбор менеджера каналов в Ozon Travel

  1. После выбора менеджера каналов откройте раздел синхронизации и скопируйте код отеля (ID объекта)

Получение кода отеля в Ozon Travel

Если в учётной записи Ozon зарегистрировано несколько отелей — выберите нужный отель в переключателе.

Добавление канала продаж

  1. В Shelter Cloud перейдите в раздел Channel Manager. В правой колонке Доступные каналы найдите Ozon Travel и нажмите Добавить

Ozon Travel в списке доступных каналов

  1. В открывшемся окне введите Код отеля (полученный на предыдущем шаге) и нажмите Добавить

Модальное окно добавления канала Ozon Travel

Канал добавлен, но обмен ещё не начался. Прежде чем включать канал, настройте справочники на следующих шагах — иначе в Ozon выгрузятся все категории и тарифы, и отключить их позже будет нельзя.

Настройки Shelter Cloud

Вкладка «Настройки Shelter Cloud»

На вкладке Настройки Shelter Cloud доступны следующие параметры:

Параметр Описание
Контрагент Контрагент, к которому привязываются бронирования из Ozon Travel. Выберите из выпадающего списка. Можно оставить незаполненным — тогда подставится значение по умолчанию.
Договор Договор контрагента, по которому учитываются бронирования из канала.
Способ оплаты Способ оплаты для бронирований из канала. Можно оставить незаполненным — тогда подставится значение по умолчанию.
Индивидуальные настройки наличия мест Флаг включает отдельный расчёт доступности номеров и ограничений для канала Ozon Travel, независимый от общих настроек. Если флаг снят — используется общая доступность отеля.

Сопоставление справочников

Списки категорий, тарифов и типов питания на вкладках канала берутся из справочников Shelter Cloud — они появляются автоматически, никаких дополнительных действий не требуется. Настройте, какие из них передавать в Ozon:

  1. На вкладке Категории отметьте категории номеров, которые нужно передавать в Ozon. У категорий, которые не должны появляться в Ozon, поставьте галочку «Отключить передачу в канал»

Сопоставление категорий

  1. На вкладке Тарифы отметьте тарифы для передачи. Поставьте галочку «Отключить передачу в канал» у тарифов, которые не нужно выгружать

Сопоставление тарифов

  1. На вкладке Типы питания укажите коды типов питания Ozon (например, breakfast, half_board, all_inclusive) для соответствующих типов питания из Shelter Cloud

Сопоставление типов питания

Настройка тарифов

На вкладке Тарифы для каждого тарифа доступны дополнительные настройки:

Параметр Описание
Передавать питание в канал Чекбокс (по умолчанию включён). Если включён — стоимость питания прибавляется к цене для гостя, и в Ozon передаётся реальный тип питания тарифа. Если выключен — цена идёт без надбавки за питание, в Ozon передаётся тип «Только проживание».
Отключить передачу в канал Чекбокс — отметьте тарифы, которые не нужно выгружать в Ozon.

Размещения с ценой 0 или без заведённой цены в канал не выгружаются. Если категория или тариф не появляются в Ozon — проверьте, что для них в разделе «Цены» заведена цена больше нуля.

Завершение настройки

  1. Переведите тумблер канала в положение Вкл — это запускает обмен данными с Ozon

Ozon Travel в списке подключённых каналов

  1. Нажмите Выгрузить всё — Shelter Cloud: - Передаст в Ozon привязку отеля (какому отелю в Ozon соответствует ваш отель) - Отправит каталог категорий и тарифов в Ozon - Выгрузит всю текущую доступность, цены и ограничения за период «сегодня и 12 месяцев вперёд»

  2. Проверьте данные в кабинете Ozon Travel — убедитесь, что цены и статусы номеров загрузились корректно

При успешной выгрузке отобразится сообщение об успешном выполнении. Обновление данных в кабинете Ozon может занять несколько минут.

Ограничения продаж

Ограничения управляют доступностью номеров для бронирования в Ozon Travel.

Виды ограничений

Ограничение Описание Поддержка
Stop Sales Полное закрытие продаж на дату/период ✅
CTA (Close To Arrival) Запрет на заезд в указанную дату ✅
CTD (Close To Departure) Запрет на выезд в указанную дату ✅
MinLOS Минимальное количество ночей проживания ✅
MaxLOS Максимальное количество ночей проживания ✅
MinAdvanceBooking Минимальный срок бронирования до заезда ✅
MaxAdvanceBooking Максимальный срок бронирования до заезда ✅

Настройка ограничений

Ограничения настраиваются в экране Тарифы и цены:

  1. Выберите тариф, подключённый к каналу Ozon Travel
  2. На вкладке Ограничения укажите значения для каждой даты
  3. Изменения автоматически выгружаются в Ozon Travel

Бронирования

Получение бронирований

Бронирования из Ozon Travel автоматически создаются в Shelter Cloud:

  • Новые бронирования появляются с источником «OzonTravel»
  • Изменения (модификация, аннуляция) синхронизируются автоматически
  • Ozon уведомляет канал сразу при каждом изменении брони — импорт запускается немедленно
  • Резервно канал запрашивает новые и изменённые брони каждые 2 минуты

Информация в бронировании

В комментарии бронирования указывается: - Номер брони в Ozon (bookingOzonId) - Дополнительная информация от Ozon (брутто/нетто, программа лояльности) или комментарий гостя

В карточке бронирования заполняются: - Даты заезда и выезда - Стоимость для отеля (сумма от Ozon за вычетом комиссии) - Комиссия канала - Гости с именем, отчеством, фамилией, возрастом и признаком ребёнка - Контактные данные (email, телефон) — сопоставляются с одним из гостей по совпадению ФИО

Особенности

  • Изменения бронирований, сделанные в Shelter Cloud, не передаются обратно в Ozon
  • Условия отмены (штрафы) от Ozon фиксируются в истории выгрузок канала, но не переносятся в карточку бронирования автоматически

Синхронизация данных

Автоматическая выгрузка

Система автоматически выгружает в Ozon Travel:

Данные Периодичность
Доступность При изменении (каждые 60 секунд)
Цены При изменении
Ограничения При изменении
Бронирования Push-уведомления + каждые 2 минуты

При изменении настроек на вкладках «Категории» или «Тарифы» ближайшая фоновая выгрузка автоматически обновит каталог в Ozon, а затем доотправит цены и ограничения. Вручную ничего делать не нужно.

Горизонт выгрузки

Цены, доступность и ограничения выгружаются в Ozon на 12 месяцев вперёд. Данные с датами за пределами этого окна не отправляются — это штатное поведение, не ошибка.

Ручная синхронизация

При необходимости выполните:

  1. Выгрузить всё — полная выгрузка цен, доступности, ограничений и каталога за период «сегодня и 12 месяцев вперёд». Используйте после крупных изменений (новый тариф, новая категория) или при подозрении на рассинхронизацию.
  2. Обновить бронирования — загрузить изменения по бронированиям

Устранение неполадок

Бронирование не создаётся

  1. Проверьте сопоставление категорий номеров
  2. Убедитесь, что тариф сопоставлен корректно
  3. Проверьте статус канала — должен быть включён
  4. Убедитесь, что код отеля указан верно
  5. Проверьте историю выгрузок канала — там отображаются все попытки импорта с причиной отказа

Цены в Ozon отличаются от ожидаемых

  1. Проверьте значение поля «Цена за» (за номер / за человека) в разделе «Цены»
  2. Проверьте, указан ли «Тип питания» в строке цены и совпадает ли он с типом питания тарифа
  3. Проверьте, есть ли отдельные возрастные строки в «Ценах»
  4. Убедитесь, что для нужной комбинации «категория + тариф + дата» заведена цена больше нуля

Категория или тариф не появляются в Ozon

  1. Проверьте, что в карточке канала у них не стоит галочка «Отключить передачу в канал»
  2. Убедитесь, что для них заведена цена больше нуля — размещения с ценой 0 или без цены не выгружаются
  3. Нажмите «Выгрузить всё»

Ошибки авторизации при обмене с Ozon

Если канал не может обмениваться данными с Ozon (ошибки авторизации в истории выгрузок):

  1. Убедитесь, что код отеля указан верно на вкладке «Настройки авторизации»
  2. Обратитесь в техподдержку Shelter для проверки сервисных учётных данных

Ссылки