Что такое 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-интеграции отелей
Хотя названия и детали у разных поставщиков различаются, большинство интеграций проходит схожие этапы:
- Загрузка статического контента: список отелей, описания, изображения и типы номеров получают и сохраняют массово.
- Поиск (availability): направление, даты и данные о гостях пользователя отправляются поставщику; в ответ возвращаются свободные отели с ценами.
- Повторная проверка (recheck или prebook): когда пользователь выбирает вариант, цена и наличие подтверждаются заново; условия отмены фиксируются.
- Бронирование (book): создаётся бронь с данными гостей; поставщик возвращает номер брони.
- Запрос статуса и отмена: запрашивается статус брони или она отменяется.
Первый этап относится к статическим данным, остальные — к динамическим. 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-интеграции полезно прояснить ответы на следующие вопросы:
- В каком формате и по какому каналу приходят статические данные (API, файл, FTP)?
- Как часто публикуются полный dump и delta; сообщаются ли удалённые записи?
- Типы номеров и питания кодированы или это свободный текст?
- Какую иерархию отражают коды направлений?
- Совпадают ли коды в поисковом ответе со статическими данными один к одному?
- Каковы правила кэширования и повторной проверки?
Более подробные вопросы, которые стоит задать при выборе сервиса маппинга, мы собрали в статье 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 работает только со статическими данными об отелях: маппинг отелей, номеров, типов питания и направлений, а также контент отелей. Цены, наличие и процесс бронирования остаются между вами и вашим поставщиком.
Источники
Редакция hotelmapping.org
Команда отельных данных DIJI.TECH
Команда DIJI.TECH, работающая в области маппинга отелей, интеграции поставщиков и туристического программного обеспечения.
Связанные продукты
Решения для маппинга отелей
Постоянный HM ID для каждого объекта; коды поставщиков и перекрёстные ID в одной записи.
Решения для описаний отелей
Краткое, среднее и полное описание каждого отеля на TR, EN, DE, RU и AR, готовое к продаже.
Решение Find Match API
Отправьте название, адрес и координаты, получите HM ID и оценку уверенности. Код поставщика не нужен.
Связанные статьи
- Что такое маппинг отелей (сопоставление отелей) и как он работает? Подробное руководство Что такое маппинг отелей: как записи поставщиков объединяются в один ID, 9 шагов процесса, пороги оценки, маппинг номеров и питания, контроль качества.
- Что такое бедбанк? Как агентства работают с бедбанками Что такое бедбанк и как он работает? Подключение агентств по XML/API, статические и динамические данные, коммерческая модель и проблема дубликатов.
- 12 вопросов, которые нужно задать при выборе API маппинга отелей 12 вопросов при выборе API маппинга отелей: точность, охват, постоянство ID, номера и питание, поставка и цена, а также способы проверки ответов.