Метод createMatching
📌 Описание
Метод используется для передачи сопоставлений между номерами и тарифами отеля в системе Inn-Book и OTA.
Объект data в данном методе не используется, все данные передаются на верхнем уровне JSON.
🎯 Назначение
Метод вызывается для передачи актуальных соответствий (matching) между сущностями в Inn-Book и их аналогами в OTA:
- категорий номеров (
roomsArr) - тарифов (
ratesArr)
Это необходимо для корректной синхронизации данных между системами.
Варианты размещения (seats) не участвуют в сопоставлении между Inn-Book и OTA.
То есть, если у одного тарифа в Inn-Book предусмотрены разные варианты размещения (например, на 1, 2 или 3 гостей), они не сопоставляются отдельно.
Сопоставление выполняется только на уровне тарифа и категории номера.
Информацию о доступных вариантах размещения для каждого тарифа можно получить через метод:
📘 prices — Цены на даты (см. раздел REST API Inn-Book)
📤 Пример запроса
{
"auth": {},
"action": "createMatching",
"hid": 36,
"ratesArr": [
{
"idInnBook": "42",
"idOta": "473"
}
],
"roomsArr": [
{
"idInnBook": "94",
"idOta": "5"
}
]
}
🔎 Пояснение к полям запроса
| Поле | Тип | Описание |
|---|---|---|
| auth | object | Объект авторизации/идентификации отеля |
| action | string | Название метода (createMatching) |
| hid | integer | ID отеля в системе Inn-Book |
| ratesArr | array | Массив сопоставлений тарифов |
| roomsArr | array | Массив сопоставлений категорий номеров |
| idInnBook | string | ID тарифа или категории номера в Inn-Book |
| idOta | string | ID тарифа или категории номера в OTA |
📥 Пример ответа OTA
{
"status": "ok"
}
✅ Запрос выполнен успешно, сопоставления сохранены.
🔐 Рекомендации по реализации на стороне OTA
- Передавать полный актуальный список сопоставлений
roomsArrиratesArr - Сохранять неизменность
idInnBookиidOtaдля корректного matching - Проверять статус ответа и обрабатывать ошибки при необходимости