# Решения для фактшитов отелей

> URL: https://hotelmapping.org/ru/produkty/resheniya-dlya-faktshitov-oteley/ · Язык: Русский

Фактшит отеля передаёт основные сведения об отеле не свободным текстом, а в отдельных полях, доступных для фильтрации: тип объекта, звёзды, число номеров, время заезда и выезда, пляж и бассейны, правила для детей и животных, рестораны и контакты. Информация от всех поставщиков объединяется под HM ID отеля, противоречащие значения помечаются; данные передаются через API и dump-файлы.

## Что вы получаете

- **Готов к фильтрации:** Время заезда, правила для детей, тип пляжа и число номеров — отдельные поля, поэтому их можно сразу использовать в фильтрах и сравнении.
- **Один отель, одна правда:** Сведения об отеле от всех поставщиков собираются под одним HM ID. Страница отеля не меняется в зависимости от того, от какого поставщика пришёл пользователь.
- **Противоречия видны:** Если поставщики дают разные значения для одного поля, оно помечается. В ответе видно, какие сведения ждут проверки.
- **Согласован с описаниями:** Описания отелей создаются из тех же данных factsheet; текст и поля не противоречат друг другу.

## До и после

Необработанные сведения об объекте от двух поставщиков

**supplier_facts.txt**

```text
[A / HTL-88213]
Check-in 14:00 / Check-out 12:00. 412 rooms. Private sandy
beach 250m. 3 outdoor pools, 1 indoor pool. Kids 0-6.99 free.
Pets not allowed.

[B / 40917]
Giriş: 15.00, Çıkış: 12.00 - 410 oda - Otele ait kum plaj
(250 mt) - Açık havuz x3 - Çocuk 0-7 yaş arası ücretsiz
```

Стандартный factsheet под HM ID

**Factsheet HM-1048213**

```json
{
  "hm_id": "HM-1048213",
  "factsheet": {
    "check_in": "14:00",
    "check_out": "12:00",
    "room_count": 412,
    "beach": { "type": "sand", "private": true, "distance_m": 250 },
    "pools": { "outdoor": 3, "indoor": 1 },
    "child_policy": { "free_from_age": 0, "free_to_age": 6.99 },
    "pets_allowed": false,
    "review_flags": ["check_in", "room_count"]
  }
}
```

_Это пример данных; отель и коды не относятся к реальному объекту. Поля, по которым поставщики противоречат друг другу (здесь время заезда и число номеров), помечаются в review_flags._

## Как это работает

1. **Объединение источников:** Сведения об отеле из всех записей поставщиков, привязанных к одному HM ID, собираются вместе. Исходные данные хранятся как есть, изменения версионируются.
2. **Разбор на поля:** Время, числа, расстояния и правила из свободного текста преобразуются в отдельные поля; форматы времени, расстояния и возраста стандартизируются.
3. **Проверка противоречий:** Если источники дают разные сведения, значения сравниваются. Неоднозначные поля помечаются и попадают в очередь проверки команды данных.
4. **Передача и обновление:** Factsheet возвращается с эндпоинта GET /v1/hotels/{hm_id}/content; весь фонд поступает в ежедневных полных и delta dump-файлах.

## Пример API

**Запрос factsheet**

```bash
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/content?include=factsheet" \
  -H "X-API-Key: $HM_API_KEY"
```

**200 OK**

```json
{
  "hm_id": "HM-1048213",
  "factsheet": {
    "property": { "type": "resort", "stars": 5, "room_count": 412 },
    "policies": {
      "check_in": "14:00",
      "check_out": "12:00",
      "child_policy": { "free_from_age": 0, "free_to_age": 6.99 },
      "pets_allowed": false
    },
    "beach": { "type": "sand", "private": true, "distance_m": 250 },
    "pools": { "outdoor": 3, "indoor": 1 },
    "dining": [
      { "type": "restaurant", "cuisine": "turkish" },
      { "type": "bar", "location": "pool" }
    ],
    "contact": { "email": "info@sunsetbay.example" },
    "review_flags": ["check_in", "room_count"]
  },
  "updated_at": "2026-11-02T08:14:00Z"
}
```

_Примеры кода носят иллюстративный характер; названия полей могут измениться в релизе v1._

## Почему factsheet в отдельных полях?

Поставщики часто присылают сведения об отеле свободным текстом. Один поставщик пишет время заезда 14:00, другой — 15:00; один указывает 412 номеров, другой — 410. Информация о пляже теряется внутри предложения, возрастная граница для детей приходит в разных форматах. В таком виде нельзя построить фильтры «отели с собственным песчаным пляжем» или «дети 0–6 лет бесплатно».

Фактшит отеля выделяет эти сведения в отдельные поля и привязывает их к [HM ID](https://hotelmapping.org/ru/glossariy/hm-id/) отеля. Обязательное условие — правильное сопоставление отеля; метод описан в [руководстве по маппингу отелей](https://hotelmapping.org/ru/rukovodstvo/chto-takoe-mapping-otelei/), продукт — на странице [маппинга отелей](https://hotelmapping.org/ru/produkty/resheniya-dlya-mappinga-oteley/).

## Поля factsheet

| Группа | Поля | Пример значения |
| --- | --- | --- |
| Сведения об объекте | Тип объекта, звёзды, сеть и бренд, число номеров и этажей, год открытия и реновации | Резорт, 5 звёзд, 412 номеров |
| Правила | Время заезда и выезда; правила для детей, животных, курения и оплаты | 14:00 / 12:00, дети 0–6,99 лет бесплатно |
| Пляж и бассейн | Тип пляжа, принадлежность отелю, расстояние; число открытых и крытых бассейнов | Песок, собственный, 250 м; 3 открытых, 1 крытый |
| Питание и рестораны | Рестораны, бары, виды кухни, часы работы | Ресторан турецкой кухни, бар у бассейна |
| Контакты и адрес | Проверенный адрес, телефон, e-mail, сайт | info@sunsetbay.example |

Названия и значения полей не зависят от языка; в интерфейсе вы показываете подпись на своём языке.

## Противоречивые сведения

Если поставщики дают для одного отеля разные значения, они сравниваются. Неоднозначные поля помечаются в `review_flags` и проверяются командой данных. Так по ответу видно, какие сведения подтверждены, а какие ждут проверки.

## Описания и передача

[Описания отелей](https://hotelmapping.org/ru/produkty/resheniya-dlya-opisaniy-oteley/) создаются из тех же данных factsheet; время или расстояние в тексте не расходятся со значением в поле. Фотогалерея отеля находится в сервисе [фото отелей](https://hotelmapping.org/ru/produkty/resheniya-dlya-foto-oteley/); если в factsheet у отеля есть пляж, а фото с меткой «пляж» нет, вы можете отправить предупреждение команде контента.

Factsheet передаётся по отелям через REST API, а для всего фонда — ежедневными полными и [delta dump](https://hotelmapping.org/ru/glossariy/delta-dump/) файлами. Параметр `include` и названия полей в примере — черновик API v1; точная схема публикуется на [странице для разработчиков](https://hotelmapping.org/ru/razrabotchikam/). Для информации об охвате и стоимости [запросите предложение](https://hotelmapping.org/ru/zaprosit-predlozhenie/).

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

### Что такое фактшит отеля?

Это основные сведения об отеле (тип объекта, звёзды, число номеров, время заезда и выезда, правила, питание и рестораны, контакты), представленные в структурированных полях.

### Чем factsheet отличается от описания отеля?

Описание — это текст, написанный для чтения; factsheet — отдельные поля для фильтрации и сравнения. Оба основаны на одних и тех же проверенных данных.

### Какое значение используется, если поставщики дают разные сведения?

Значения сравниваются; неоднозначные поля помечаются и проверяются командой данных. В ответе поля, ожидающие проверки, видны в review_flags.

### В каких форматах можно получать данные factsheet?

По отелям — через REST API или для всего фонда — ежедневными полными и delta dump-файлами (CSV, JSON). Для уведомлений об изменениях планируется webhook.

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

- [Решения для описаний отелей](https://hotelmapping.org/ru/produkty/resheniya-dlya-opisaniy-oteley/)
- [Решения для маппинга отелей](https://hotelmapping.org/ru/produkty/resheniya-dlya-mappinga-oteley/)
- [Решения для фото отелей](https://hotelmapping.org/ru/produkty/resheniya-dlya-foto-oteley/)

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

- [Что такое XML-интеграция отелей? Статические и динамические данные](https://hotelmapping.org/ru/rukovodstvo/chto-takoe-xml-integratsiya-otelei/)
- [Что такое маппинг отелей (сопоставление отелей) и как он работает? Подробное руководство](https://hotelmapping.org/ru/rukovodstvo/chto-takoe-mapping-otelei/)
- [Стоимость дубликатов отелей для агентства: конверсия, отмены и жалобы клиентов](https://hotelmapping.org/ru/rukovodstvo/stoimost-dublikatov-otelei/)
