Технические вопросы

Что такое XML-интеграция отелей? Статические и динамические данные

XML-интеграция отелей — это подключение агентства или платформы бронирования к системе поставщика через веб-сервис для автоматического получения данных об отелях. Статические данные (название, адрес, координаты, типы номеров, изображения) меняются редко и загружаются и хранятся заранее. Динамические данные (наличие, цена, условия отмены) запрашиваются в реальном времени при каждом поиске и привязываются к статической записи по коду поставщика.

Автор
Редакция hotelmapping.org
Последнее обновление:
8 мин чтения

Что значит XML-интеграция отелей?

Онлайн-агентства не вводят информацию и цены на продаваемые отели вручную, а подключаются к поставщикам — бедбанкам, оптовикам, платформам бронирования или channel manager — через веб-сервис. Информация об отеле, цены и наличие поступают по этому подключению автоматически. В отрасли такое подключение коротко называют XML-интеграцией.

У интеграции два конца. На одном конце поставщик предоставляет свой номерной фонд и цены в виде сервиса. На другом конце агентство, туроператор или метапоисковый сайт вызывает этот сервис, преобразует ответ в формат своей системы и показывает его клиенту. С ростом числа поставщиков объём этой работы по преобразованию растёт, потому что каждый поставщик передаёт один и тот же отель со своим названием, своим кодом и своей структурой данных.

Подробнее о типах поставщиков можно прочитать в руководстве что такое бедбанк и в глоссарии: бедбанк, channel manager.

Почему это называют «XML»?

XML (Extensible Markup Language) — это текстовый формат, в котором данные структурируются с помощью тегов; он стандартизирован W3C. Большинство первых веб-сервисов в туристической отрасли строились на SOAP и XML. Поэтому и закрепилось выражение «XML-интеграция».

Сегодня многие поставщики предлагают REST API на JSON, а некоторые по-прежнему работают с XML. В деловой речи оба варианта чаще всего называют «XML-интеграцией». С технической точки зрения важен не формат, а содержание данных и то, узнают ли обе стороны один и тот же отель как один и тот же отель.

Разница между статическими и динамическими данными

Данные, приходящие при XML-интеграции отелей, делятся на две группы. Это различие — основа проектирования системы: оно определяет, какие данные хранить, какие запрашивать каждый раз и где выполнять сопоставление.

Характеристика Статические данные Динамические данные
Примеры полей Название отеля, адрес, координаты, звёзды, описание, изображения, удобства, список типов номеров Наличие, цена, квота, условия отмены, актуальные варианты питания
Скорость изменения Медленная; в течение дней или недель Быстрая; в течение минут и даже секунд
Как получают Массовая загрузка (полный dump), затем изменившиеся записи (delta) Живой запрос при каждом поиске
Где хранятся В вашей базе данных В кратковременном кэше или не хранятся вовсе
Потребность в маппинге Высокая; один и тот же отель у каждого поставщика пишется по-разному Косвенная; коды в ответе привязываются к статической записи
Последствия ошибки Дубликат отеля, неверное местоположение, неполный контент Показ неверной цены, ошибка бронирования

Что входит в статические данные?

Статические данные отелей — это сведения, составляющие идентичность и описание объекта. Типичные поля:

  • Код отеля у поставщика и название отеля
  • Адрес, город, страна и код направления у поставщика
  • Координаты (широта, долгота)
  • Звёзды или категория
  • Тексты описаний и изображения
  • Удобства объекта и номеров
  • Список типов номеров, а иногда и список типов питания
  • Телефон, e-mail, веб-адрес

Поскольку эти данные меняются редко, их не запрашивают заново при каждом поиске. Агентство заранее загружает их, хранит в своей базе и показывает на экране.

Что входит в динамические данные?

Динамические данные — это информация, действующая в данный момент для определённой даты, номера и числа гостей: свободен ли номер, какая цена, какие есть варианты питания, каковы условия отмены. Эта информация запрашивается у поставщика в реальном времени при каждом поисковом запросе. В ответе присутствуют идентификаторы, такие как код отеля, код номера и код питания; чтобы вывести на экран осмысленный результат, эти коды нужно объединить со статическими данными.

Типовой сценарий XML-интеграции отелей

Хотя названия и детали у разных поставщиков различаются, большинство интеграций проходит схожие этапы:

  1. Загрузка статического контента: список отелей, описания, изображения и типы номеров получают и сохраняют массово.
  2. Поиск (availability): направление, даты и данные о гостях пользователя отправляются поставщику; в ответ возвращаются свободные отели с ценами.
  3. Повторная проверка (recheck или prebook): когда пользователь выбирает вариант, цена и наличие подтверждаются заново; условия отмены фиксируются.
  4. Бронирование (book): создаётся бронь с данными гостей; поставщик возвращает номер брони.
  5. Запрос статуса и отмена: запрашивается статус брони или она отменяется.

Первый этап относится к статическим данным, остальные — к динамическим. hotelmapping.org очищает и сопоставляет только данные, порождаемые первым этапом; поиск, бронирование и отмена остаются между вашей системой и вашим поставщиком.

Пример: один отель, два поставщика, два формата

В примере ниже вымышленный «Lara Palm Hotel» приходит от двух поставщиков. Первый поставщик передаёт XML:

<Hotel code="LPH-20931">
  <Name>LARA PALM HTL</Name>
  <Address>Guzeloba Mah., Lara Cad. No:112</Address>
  <City code="AYT">Antalya</City>
  <Position lat="36.8571" lng="30.7962"/>
  <Category>5</Category>
  <Rooms>
    <Room code="DBL-SV">Double Room Sea View</Room>
    <Room code="FAM-2B">Family Room 2 Bedrooms</Room>
  </Rooms>
</Hotel>

Второй поставщик передаёт тот же отель в JSON, с другим названием и кодом:

{
  "hotelId": "770512",
  "hotelName": "Lara Palm Hotel - Adults Friendly",
  "destination": "Lara / Antalya",
  "latitude": 36.8569,
  "longitude": 30.7965,
  "stars": "5*",
  "roomTypes": [
    { "id": "R1", "name": "DBL ROOM SEAVIEW" },
    { "id": "R4", "name": "Family Suite 2 Bdr" }
  ]
}

Если использовать эти две записи без сопоставления, отель появится в списке дважды. После сопоставления они собираются под одним постоянным идентификатором:

{
  "hm_id": "HM-1052207",
  "name": "Lara Palm Hotel",
  "destination_id": "TR-07-MURATPASA-LARA",
  "destination": ["TR", "Antalya", "Muratpaşa", "Lara"],
  "geo": { "lat": 36.8570, "lng": 30.7963 },
  "supplier_codes": {
    "A": "LPH-20931",
    "B": "770512"
  },
  "rooms": [
    { "hm_room_id": "HM-1052207-R02", "name": "Double Room, Sea View", "supplier_codes": { "A": "DBL-SV", "B": "R1" } },
    { "hm_room_id": "HM-1052207-R04", "name": "Family Room, 2 Bedrooms", "supplier_codes": { "A": "FAM-2B", "B": "R4" } }
  ]
}

Это примерные данные; название отеля, адрес и коды не принадлежат реальному объекту. Здесь HM ID связывает оба кода поставщика с одним отелем. Номера группируются по той же логике; эта задача относится к продукту маппинг номеров.

Почему статическим данным нужен маппинг?

Для агентства, работающего с одним поставщиком, проблема сопоставления невелика. Как только добавляется второй поставщик, появляются две записи одного и того же отеля. С ростом числа поставщиков проблема растёт:

  • Дублирование в списке: один и тот же отель появляется в поиске несколькими карточками; клиент не может понять, какая из них верная. Влияние этой проблемы на бизнес мы рассматриваем в статье стоимость дубликатов отелей.
  • Нарушенное сравнение цен: цены, которые поставщики дают на один и тот же отель, не удаётся собрать в одну карточку.
  • Несогласованный контент: у одного поставщика описание может быть неполным, у другого — координаты неверными. Чтобы объединить правильные поля, сначала нужно знать, что записи относятся к одному отелю.
  • Путаница с номерами и питанием: «DBL ROOM SEAVIEW» и «Double Room Sea View» — один и тот же номер; «AI» и «All Inclusive» — один и тот же тип питания. Их тоже нужно привязать к стандартному коду.

Подробности процесса сопоставления мы описываем в руководстве что такое маппинг отелей. В продуктах ему соответствуют страницы маппинг отелей, маппинг типов питания и контент отелей.

Как динамический ответ привязывается к статической записи?

Поисковый ответ обычно содержит только коды. Например, ответ поставщика B о наличии может содержать такой фрагмент:

{
  "hotelId": "770512",
  "offers": [
    { "roomId": "R1", "board": "AI", "price": { "amount": 412.50, "currency": "EUR" }, "refundable": true }
  ]
}

Чтобы вывести этот ответ на экран, ваша система должна ответить на вопросы: что за отель «770512»? Что за номер «R1»? Какому стандартному типу питания соответствует «AI»? Если статическая сторона сопоставлена, ответ находится одним запросом: код поставщика преобразуется в HM ID, код номера — в идентификатор номера HM, код питания — в стандартный код. Так предложения от разных поставщиков можно показать рядом в одной карточке отеля, под одним заголовком номера и питания.

Поскольку это преобразование повторяется при каждом поиске, оно должно быть быстрым. Поэтому результаты маппинга чаще всего хранятся на вашей стороне в виде таблицы, и в момент поиска обращаются только к ней. Источником таблицы может быть API, ежедневный dump или их сочетание. Для запроса отдельных кодов можно использовать и API сопоставления.

Как поддерживать статические данные актуальными?

Статические данные меняются медленно, но меняются: отели открываются, закрываются, меняют название или владельца; поставщики удаляют коды или выдают новые. Для отслеживания этих изменений есть три распространённых метода:

Метод Как работает Когда подходит
Полный dump Весь каталог загружается заново через определённые интервалы Первоначальная настройка, небольшой каталог, периодическая полная проверка
Delta dump Получаются только записи, добавленные, изменённые и удалённые с момента последней выгрузки Большой каталог, регулярное обновление
Webhook Другая сторона отправляет вам уведомление при изменении Изменения кодов, требующие быстрой реакции

При подходе delta dump важно, чтобы удалённые или объединённые записи тоже сообщались явно. Иначе в вашей системе останется код отеля, которого уже не существует, и он будет вызывать ошибки при поиске.

Частые ошибки в проектах интеграции

  • Совсем не обновлять статические данные: после первой загрузки данные устаревают; закрытые отели остаются в продаже, а новые не видны.
  • Считать код поставщика единым идентификатором: код поставщика имеет смысл только для этого поставщика. Если поставщиков несколько, нужен собственный постоянный идентификатор.
  • Сопоставлять только по названию: бывают разные отели с одинаковым названием, а один и тот же отель приходит под разными названиями. Координаты, адрес, телефон и веб-адрес нужно оценивать вместе.
  • Оставлять коды номеров и питания свободным текстом: на экране рядом оказываются «DBL ROOM SEAVIEW» и «Double Room Sea View»; сравнение нарушается.
  • Не проверять координаты: поставщики иногда передают координаты центра города или ошибочной точки. Это нарушает и отображение на карте, и сопоставление.
  • Не отслеживать изменения кодов: когда поставщик удаляет код и выдаёт новый, прежнее соответствие молча ломается.

Контрольный список при подключении нового поставщика

Перед началом новой XML-интеграции полезно прояснить ответы на следующие вопросы:

  1. В каком формате и по какому каналу приходят статические данные (API, файл, FTP)?
  2. Как часто публикуются полный dump и delta; сообщаются ли удалённые записи?
  3. Типы номеров и питания кодированы или это свободный текст?
  4. Какую иерархию отражают коды направлений?
  5. Совпадают ли коды в поисковом ответе со статическими данными один к одному?
  6. Каковы правила кэширования и повторной проверки?

Более подробные вопросы, которые стоит задать при выборе сервиса маппинга, мы собрали в статье 12 вопросов при выборе API маппинга отелей. Список готовых подключений к поставщикам находится на странице интеграции; например, страница Hotelbeds показывает, какие поля в статических данных бедбанка мы сопоставляем.

Какое место в этой схеме занимает hotelmapping.org?

hotelmapping.org работает на статической стороне XML-интеграции. Он получает статические данные ваших поставщиков, нормализует их и привязывает один и тот же отель к одному постоянному HM ID. Названия номеров, типы питания и коды направлений он преобразует в стандартные соответствия. Результат передаётся в виде REST API и ежедневного полного или delta dump.

Цены, наличие, бронирование и отмена остаются между вашей системой и вашим поставщиком; эти данные hotelmapping.org не передаёт и не хранит. Так, не добавляя нового промежуточного слоя в динамический поток, вы можете объединять коды из поисковых ответов с таблицей сопоставления на своей стороне. Конечные точки API и примеры ответов находятся на странице для разработчиков.

Часто задаваемые вопросы

XML-интеграция и API-интеграция — это одно и то же?

В отрасли чаще всего эти понятия используются в одном значении. Выражение «XML-интеграция» осталось с тех времён, когда первые веб-сервисы использовали XML. Сегодня многие поставщики предлагают REST API на основе JSON; тем не менее в деловой речи такие подключения по-прежнему обычно называют XML-интеграцией.

Как часто нужно обновлять статические данные?

Единой правильной частоты не существует; она зависит от скорости изменений у поставщика и от размера вашего каталога. Распространённый подход — сначала получить полный dump, а затем с регулярными интервалами обрабатывать только изменившиеся записи (delta).

Правильно ли кэшировать данные о ценах и наличии?

Кратковременный кэш может ускорить поиск, но поскольку цены и наличие быстро меняются, перед бронированием необходимо повторно проверить их у поставщика (recheck). Срок кэша и правила повторной проверки могут быть указаны в условиях интеграции поставщика; проверьте их на этапе заключения договора.

Предоставляет ли hotelmapping.org и динамические данные?

Нет. hotelmapping.org работает только со статическими данными об отелях: маппинг отелей, номеров, типов питания и направлений, а также контент отелей. Цены, наличие и процесс бронирования остаются между вами и вашим поставщиком.

Источники

  1. W3C: Extensible Markup Language (XML)

Редакция hotelmapping.org

Команда отельных данных DIJI.TECH

Команда DIJI.TECH, работающая в области маппинга отелей, интеграции поставщиков и туристического программного обеспечения.

Связанные продукты

  • Решение Find Match API

    Отправьте название, адрес и координаты, получите HM ID и оценку уверенности. Код поставщика не нужен.