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

> URL: https://hotelmapping.org/ru/rukovodstvo/chto-takoe-xml-integratsiya-otelei/ · Язык: Русский · Последнее обновление: 2026-11-15

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

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

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

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

Подробнее о типах поставщиков можно прочитать в руководстве [что такое бедбанк](https://hotelmapping.org/ru/rukovodstvo/chto-takoe-bedbank/) и в глоссарии: [бедбанк](https://hotelmapping.org/ru/glossariy/bedbank/), [channel manager](https://hotelmapping.org/ru/glossariy/channel-manager/).

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

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

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

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

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

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

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

[Статические данные отелей](https://hotelmapping.org/ru/glossariy/staticheskie-dannye-oteley/) — это сведения, составляющие идентичность и описание объекта. Типичные поля:

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

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

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

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

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

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

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

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

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

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

```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, с другим названием и кодом:

```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" }
  ]
}
```

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

```json
{
  "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](https://hotelmapping.org/ru/glossariy/hm-id/) связывает оба [кода поставщика](https://hotelmapping.org/ru/glossariy/kod-postavshchika/) с одним отелем. Номера группируются по той же логике; эта задача относится к продукту [маппинг номеров](https://hotelmapping.org/ru/produkty/resheniya-dlya-mappinga-nomerov/).

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

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

- **Дублирование в списке:** один и тот же отель появляется в поиске несколькими карточками; клиент не может понять, какая из них верная. Влияние этой проблемы на бизнес мы рассматриваем в статье [стоимость дубликатов отелей](https://hotelmapping.org/ru/rukovodstvo/stoimost-dublikatov-otelei/).
- **Нарушенное сравнение цен:** цены, которые поставщики дают на один и тот же отель, не удаётся собрать в одну карточку.
- **Несогласованный контент:** у одного поставщика описание может быть неполным, у другого — координаты неверными. Чтобы объединить правильные поля, сначала нужно знать, что записи относятся к одному отелю.
- **Путаница с номерами и питанием:** «DBL ROOM SEAVIEW» и «Double Room Sea View» — один и тот же номер; «AI» и «All Inclusive» — один и тот же тип питания. Их тоже нужно привязать к стандартному коду.

Подробности процесса сопоставления мы описываем в руководстве [что такое маппинг отелей](https://hotelmapping.org/ru/rukovodstvo/chto-takoe-mapping-otelei/). В продуктах ему соответствуют страницы [маппинг отелей](https://hotelmapping.org/ru/produkty/resheniya-dlya-mappinga-oteley/), [маппинг типов питания](https://hotelmapping.org/ru/produkty/resheniya-dlya-mappinga-tipov-pitaniya/) и [контент отелей](https://hotelmapping.org/ru/produkty/resheniya-dlya-opisaniy-oteley/).

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

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

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

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

Поскольку это преобразование повторяется при каждом поиске, оно должно быть быстрым. Поэтому результаты маппинга чаще всего хранятся на вашей стороне в виде таблицы, и в момент поиска обращаются только к ней. Источником таблицы может быть API, ежедневный dump или их сочетание. Для запроса отдельных кодов можно использовать и [API сопоставления](https://hotelmapping.org/ru/produkty/reshenie-find-match-api/).

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

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

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

При подходе [delta dump](https://hotelmapping.org/ru/glossariy/delta-dump/) важно, чтобы удалённые или объединённые записи тоже сообщались явно. Иначе в вашей системе останется код отеля, которого уже не существует, и он будет вызывать ошибки при поиске.

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

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

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

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

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

Более подробные вопросы, которые стоит задать при выборе сервиса маппинга, мы собрали в статье [12 вопросов при выборе API маппинга отелей](https://hotelmapping.org/ru/rukovodstvo/vybor-api-mappinga-otelei-12-voprosov/). Список готовых подключений к поставщикам находится на странице [интеграции](https://hotelmapping.org/ru/integratsii/); например, страница [Hotelbeds](https://hotelmapping.org/ru/integratsii/resheniya-dlya-mappinga-oteley-hotelbeds/) показывает, какие поля в статических данных бедбанка мы сопоставляем.

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

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

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

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

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

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

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

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

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

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

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

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

## Источники

- [W3C: Extensible Markup Language (XML)](https://www.w3.org/XML/)

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

- [Решения для маппинга отелей](https://hotelmapping.org/ru/produkty/resheniya-dlya-mappinga-oteley/)
- [Решения для описаний отелей](https://hotelmapping.org/ru/produkty/resheniya-dlya-opisaniy-oteley/)
- [Решение Find Match API](https://hotelmapping.org/ru/produkty/reshenie-find-match-api/)

## Связанные статьи

- [Что такое маппинг отелей (сопоставление отелей) и как он работает? Подробное руководство](https://hotelmapping.org/ru/rukovodstvo/chto-takoe-mapping-otelei/)
- [Что такое бедбанк? Как агентства работают с бедбанками](https://hotelmapping.org/ru/rukovodstvo/chto-takoe-bedbank/)
- [12 вопросов, которые нужно задать при выборе API маппинга отелей](https://hotelmapping.org/ru/rukovodstvo/vybor-api-mappinga-otelei-12-voprosov/)

## Связанные термины

- [Статические данные отелей](https://hotelmapping.org/ru/glossariy/staticheskie-dannye-oteley/)
- [Delta dump](https://hotelmapping.org/ru/glossariy/delta-dump/)
- [Код поставщика](https://hotelmapping.org/ru/glossariy/kod-postavshchika/)
- [HM ID](https://hotelmapping.org/ru/glossariy/hm-id/)
- [Бэдбанк](https://hotelmapping.org/ru/glossariy/bedbank/)
- [Channel manager](https://hotelmapping.org/ru/glossariy/channel-manager/)
