Разделы и статьи

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

Оглавление

  • Введение

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

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

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

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

    • Настройки Shelter Cloud

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

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

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

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

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

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

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

  • Ссылки


Введение

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 в качестве менеджера каналов — это ускорит подключение

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

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

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

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

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

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

Настройки Shelter Cloud

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

Параметр

Описание

Контрагент

Контрагент, к которому привязываются бронирования из Ozon Travel. Выберите из выпадающего списка. Можно оставить незаполненным — тогда подставится значение по умолчанию.

Договор

Договор контрагента, по которому учитываются бронирования из канала.

Способ оплаты

Способ оплаты для бронирований из канала. Можно оставить незаполненным — тогда подставится значение по умолчанию.

Индивидуальные настройки наличия мест

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

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

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

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

2. На вкладке Тарифы отметьте тарифы для передачи. Поставьте галочку «Отключить передачу в канал» у тарифов, которые не нужно выгружать
3. На вкладке Типы питания укажите коды типов питания Ozon (например, breakfast, half_board, all_inclusive) для соответствующих типов питания из Shelter Cloud

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

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

Параметр

Описание

Передавать питание в канал

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

Отключить передачу в канал

Чекбокс — отметьте тарифы, которые не нужно выгружать в Ozon.

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


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

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

2. Нажмите Выгрузить всё — Shelter Cloud:
    • Передаст в Ozon привязку отеля (какому отелю в Ozon соответствует ваш отель)

    • Отправит каталог категорий и тарифов в Ozon

    • Выгрузит всю текущую доступность, цены и ограничения за период «сегодня и 12 месяцев вперёд»

  1. Проверьте данные в кабинете 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 для проверки сервисных учётных данных


Ссылки