-
Настройка UDF-полей бронирования и профиля гостя в АСУ Opera
- Перед настройкой: обратитесь в HRS
- Какие значения можно передавать
- Как настроить передачу данных бронирования
- Как настроить передачу данных профиля гостя
- Как пользоваться переменными
- Проверка после настройки
UDF (User Defined Field) — настраиваемое поле в АСУ Opera. В нем удобно хранить то, чего нет в стандартной карточке брони или профиля гостя: комиссию агента, метку рекламного источника, сведения из онлайн-регистрации.
В личном кабинете TravelLine вы выбираете, какое значение отправлять, и указываете код поля Opera. При доставке данных через OXI значение заполняет это поле. Название поля и место, где оно показывается в Opera, настраиваются на стороне Opera.
В личном кабинете TravelLine в разделе «Интеграция с АСУ» → «Доставка броней» вы можете настроить UDF-поля для передачи в Opera:
- на вкладке «Передача данных бронирований» для передачи комиссии, валюты, рекламной метки по конкретному бронированию;
- на вкладке «Передача данных профиля гостя» для передачи сведений из онлайн-регистрации или другой информации.
Обратите внимание. Заполнение UDF-поля на одной вкладке не создаст такое же поле на другой вкладке. Одинаковый код, например UDFc19, в бронировании и профиле обозначает поля разных объектов.
Перед настройкой: обратитесь в HRS
1. Определите, какие данные нужны отелю и куда их передавать: в бронирование или в профиль гостя.
2. Попросите HRS подготовить UDF-поле и настроить прием данных через OXI.
3. Согласуйте с HRS название поля и место его отображения в Opera — например, в карточке бронирования или профиля гостя.
4. Получите в HRS точный код поля и его тип. Убедитесь, что поле не используется для других данных.
Примечание. Коды на скриншотах в статье — примеры: используйте тот код, который сообщил HRS.
Какие значения можно передавать
В бронирование
Вариант в списке «Данные» Что передается Что заполнить Вставить переменную Данные конкретного бронирования или проживания по коду из таблицы переменных Код переменной в фигурных скобках и код поля Opera Свое значение Постоянный текст, одинаковый при каждой передаче Сам текст и код поля Opera utm_source Источник рекламного перехода Код поля Opera utm_medium Тип рекламного трафика Код поля Opera utm_campaign Название рекламной кампании Код поля Opera utm_term Ключевое слово или значение соответствующей метки Код поля Opera utm_content Содержание или вариант объявления по соответствующей метке Код поля Opera Roistat Идентификатор Roistat из данных бронирования Код поля Opera Примечание. UTM-метки и Roistat берутся из данных бронирования: настройка UDF их не создает. Если исходного значения нет, поле останется пустым.
В профиль гостя
На вкладке «Передача данных профиля гостя» всегда есть возможность «Вставить переменную» или добавить «Свое значение».
Если у средства размещения включена онлайн-регистрация, в списке появляются поля анкеты гостя: ФИО, пол, адрес электронной почты, телефон, гражданство, дата и место рождения, адрес регистрации, данные документа.
Группа Значение в списке Гость Имя; Фамилия; Отчество; Пол; Email; Телефон; Гражданство Рождение Дата рождения; Место рождения; Место рождения. Страна; Место рождения. Регион; Место рождения. Город, населенный пункт; Место рождения. Поселение; Место рождения. Область, республика Адрес Адрес. Дата регистрации; Адрес. Почтовый индекс; Адрес. Регион; Адрес. Область, республика; Адрес. Город, населенный пункт; Адрес. Поселение; Адрес. Улица; Адрес. Дом; Адрес. Корпус; Адрес. Квартира Документ Документ; Документ ID; Серия; Номер; Дата выдачи; Код подразделения; Кем выдан HRS Passport manager PropertyId; Check-in token — используются только при работе с HRS Passport manager Обратите внимание. Значения онлайн-регистрации подставляются из анкеты конкретного гостя и не заменяются данными заказчика брони. Если анкета не заполнена или нет данных документа, значение может остаться пустым. UTM-метки и Roistat на вкладке профиля недоступны. UTM-метки и Roistat как отдельные варианты на вкладке профиля недоступны.
Как настроить передачу данных бронирования
1. Откройте «Интеграция с АСУ» → «Доставка броней» → «Передача данных бронирований».
2. Нажмите «Создать поле».
3. В списке «Данные» выберите, что отправлять.
4. Для «Вставить переменную» вставьте код из таблицы переменных. Для «Свое значение» введите текст. Для UTM-метки или Roistat дополнительное значение не нужно.
5. В правом поле укажите код, который прислал HRS.
6. При необходимости добавьте другие строки и нажмите «Сохранить».
Пример: комиссия агента
Настройка Значение Вкладка Передача данных бронирований Данные Вставить переменную Переменная {RES_AGENT_COMMISSION_AMOUNT}Поле Opera Код, подготовленный HRS для комиссии агента, например UDFc19 Примечание. Переменная передает сумму комиссии, а не процент. Если сумма в исходных данных не больше нуля, переменная возвращает пустое значение.
Как настроить передачу данных профиля гостя
1. Откройте «Интеграция с АСУ» → «Доставка броней» → «Передача данных профиля гостя».
2. Нажмите «Создать поле».
3. Выберите «Свое значение», «Вставить переменную» или нужный параметр онлайн-регистрации.
4. Введите текст или переменную, если для выбранного варианта появилось поле значения.
5. Справа укажите код поля профиля, полученный от HRS, и нажмите «Сохранить».
Пример для онлайн-регистрации. Дата рождения передается в поле типа UDFd, например UDFd05, email — в UDFc06, постоянный текст — в UDFc07. Номера приведены для примера; используйте коды, выделенные HRS для вашего средства размещения.
Пример постоянного значения. Выберите «Свое значение», введите TravelLine и укажите согласованное поле профиля типа UDFc. В него будет отправляться именно этот текст.
Пример заполнения профиля. Дата рождения передаётся в UDFd05, Email — в UDFc06, постоянный текст — в UDFc07. Используйте коды, выделенные HRS для вашего средства размещения.
Если вы работаете с HRS Passport manager
Параметры Check-in token и PropertyId настраиваются на вкладке «Передача данных профиля гостя» и нужны только для работы с HRS Passport manager. Они передают служебные значения для работы с данными онлайн-регистрации.
Параметр Значение PropertyId Идентификатор отеля в TravelLine. Это не код UDF-поля и не номер бронирования Check-in token Токен доступа к данным онлайн-регистрации соответствующего гостя 1. Убедитесь, что у вашего средства размещения включена онлайн-регистрация.
2. Согласуйте с HRS два отдельных текстовых UDF-поля профиля и получите их коды.
3. Добавьте строку Check-in token и укажите код первого поля.
4. Добавьте строку PropertyId и укажите код второго поля.
5. Нажмите «Сохранить» и проверьте передачу вместе с HRS.
Обратите внимание. Токен и идентификатор средства размещения вручную вводить не нужно — TravelLine подставляет их сам. Не используйте для них режим «Свое значение» и не копируйте токен из другого профиля гостя. Без данных онлайн-регистрации эти значения не заполнятся.
Как пользоваться переменными
1. Выберите «Вставить переменную».
2. Откройте ссылку «таблица переменных» под полем ввода — актуальные коды и описания находятся в личном кабинете.
3. Скопируйте нужный код целиком, вместе с фигурными скобками, и вставьте в поле значения.
4. Укажите код UDF-поля, согласованный с HRS, и сохраните настройку.
Обратите внимание. В одну строку вставляется одна переменная. Не добавляйте подписи, второй код и условия — они не сработают. В режиме «Свое значение» код переменной передается буквальным текстом: для подстановки данных нужен режим «Вставить переменную».
Ограничения
Правило Что учитывать Код поля Префикс и две цифры от 01 до 99, например UDFc19. Допустимый формат в TravelLine не значит, что такое поле уже есть в Opera Тип поля UDFc — текст, переменные, UTM и большинство параметров. UDFd — даты из онлайн-регистрации. Тип подставляет интерфейс Числовые поля Префикс UDFn не поддерживается: даже сумма комиссии передаётся в UDFc Количество строк До 20 на каждой вкладке Повторение кода Внутри одной вкладки у каждой строки свой код Повторение варианта UTM-метка, Roistat и параметр онлайн-регистрации выбираются один раз на вкладке Длина ввода Поле значения ограничено 100 символами Длина результата Перед отправкой значение обрезается до 200 байт UTF-8 — это не 200 символов, кириллица занимает больше Обратите внимание. Номер и тип поля согласуйте с HRS. Не используйте код, уже занятый другой настройкой интеграции.
Проверка после настройки
1. Повторно откройте вкладку и убедитесь, что заполненные поля сохранились.
2. Возьмите тестовое бронирование, в котором есть нужные исходные данные; для проверки онлайн-регистрации нужны заполненные данные гостя.
3. После доставки откройте бронь или профиль в Opera и проверьте значение в согласованном поле.
Если поле пустое, проверьте исходные данные, выбранную вкладку, режим «Вставить переменную» / «Свое значение», код UDF и доставку брони. Если значение передано, но поле не видно на экране Opera, уточните в HRS настройку его отображения.
Сохранение настройки не значит, что значение уже в Opera. При удалении строки через значок корзины тоже нажмите «Сохранить»: правило передачи в TravelLine удалится, а уже записанное значение в Opera нужно проверить отдельно.
