Общие типы данных on Travel API - Документация

Гости

Mon, 01 Jan 0001 00:00:00 +0000

Гости#

Типы для работы с информацией о гостях отеля.

Guests#

Конфигурация гостей для поиска и ценообразования.

Поле	Тип	Обязательно	Описание
`adults`	integer	Да	Количество взрослых
`children`	Child[]	Нет	Массив детей с указанием возраста

Примеры#

2 взрослых:

1{
2 "adults": 2
3}

2 взрослых и 1 ребенок (5 лет):

1{
2 "adults": 2,
3 "children": [
4 { "age": 5 }
5 ]
6}

Child#

Ребенок с указанием возраста.

Предложение

Mon, 01 Jan 0001 00:00:00 +0000

Предложение#

Типы для описания предложений (номеров) отеля.

OfferBase#

Базовое предложение, используемое в результатах поиска.

Поле	Тип	Обязательно	Описание
`supplier`	string	Нет	Поставщик предложения. Возможные значения: `ostrovok`, `acase`
`contractId`	string	Нет	Идентификатор контракта (офиса) поставщика
`searchPresetId`	string	Нет	Идентификатор пресета поиска
`pricingPresetId`	string	Нет	Идентификатор пресета ценообразования
`amountExchange`	object	Нет	Курс обмена валюты на момент создания предложения
`roomId`	string	Да	Идентификатор номера
`roomName`	string	Да	Название номера
`allotment`	integer	Да	Доступное количество номеров
`features`	RoomFeature[]	Нет	Характеристики номера
`paymentType`	string	Да	Тип оплаты (`hotel`, `online`)
`isRefundable`	boolean	Нет	Возможность возврата
`roomAmenities`	RoomAmenity[]	Нет	Удобства номера
`roomImages`	RoomImages	Нет	Фотографии номера
`prices`	Prices	Да	Ценовая информация
`deposit`	Deposit	Нет	Депозит
`isPetAvailable`	boolean	Нет	Разрешено размещение с питомцами
`checkinRules`	CheckinRule[]	Нет	Правила заселения

RoomImages#

Фотографии номера.

Ценообразование

Mon, 01 Jan 0001 00:00:00 +0000

Ценообразование#

Типы для работы с ценами в операциях с отелями.

Money#

Денежная сумма с указанием валюты.

Поле	Тип	Обязательно	Описание
`amount`	decimal	Да	Сумма
`currency`	string	Да	Код валюты (ISO 4217, например `RUB`, `USD`, `EUR`)

Примеры#

1{
2 "amount": 15000.00,
3 "currency": "RUB"
4}

Prices#

Структура цен предложения.

Поле	Тип	Обязательно	Описание
`vat`	VatInfo	Нет	Информация о НДС
`cancellationRules`	CancellationRules	Нет	Правила отмены
`totalPrice`	TotalPrice	Да	Итоговая цена с разбивкой
`meals`	Meal[]	Нет	Информация о питании
`earlyCheckin`	CheckinCheckoutOption[]	Нет	Опции раннего заезда
`lateCheckout`	CheckinCheckoutOption[]	Нет	Опции позднего выезда

TotalPrice#

Разбивка итоговой цены.

Номер

Mon, 01 Jan 0001 00:00:00 +0000

Номер#

Типы для описания характеристик и удобств номера.

RoomFeature#

Характеристика номера (тип кровати, вид и т.д.).

Поле	Тип	Обязательно	Описание
`type`	string	Да	Тип характеристики (например `bedding`, `view`)
`value`	string	Да	Значение (например `double`, `sea_view`)

Примеры#

1{
2 "type": "bedding",
3 "value": "twin"
4}

RoomAmenity#

Удобство номера (Wi-Fi, кондиционер и т.д.).

Поле	Тип	Обязательно	Описание
`id`	string	Да	Идентификатор удобства
`name`	string	Да	Название удобства
`group`	string	Нет	Группа удобств
`included`	boolean	Нет	Включено в стоимость
`gross`	Money	Нет	Стоимость (если не включено)
`vat`	VatInfo	Нет	Информация о НДС

Примеры#

Включенное удобство:

Питание

Mon, 01 Jan 0001 00:00:00 +0000

Питание#

Типы для описания питания в отеле.

Meal#

Информация о питании.

Поле	Тип	Обязательно	Описание
`mealId`	string	Да	Идентификатор типа питания
`mealName`	string	Да	Название типа питания
`included`	boolean	Да	Включено в стоимость номера
`price`	ServicePrice	Нет	Стоимость (если не включено)

Примеры#

Включенный завтрак:

1{
2 "mealId": "breakfast",
3 "mealName": "Завтрак",
4 "included": true
5}

Платный полный пансион:

 1{
 2 "mealId": "full_board",
 3 "mealName": "Полный пансион",
 4 "included": false,
 5 "price": {
 6 "total": {
 7 "amount": 3000.00,
 8 "currency": "RUB"
 9 }
10 }
11}

Отмена

Mon, 01 Jan 0001 00:00:00 +0000

Отмена#

Типы для описания условий отмены бронирования.

CancellationRules#

Правила отмены бронирования.

Поле	Тип	Обязательно	Описание
`freeCancellationBefore`	datetime	Нет	Дата до которой возможна бесплатная отмена (ISO 8601)
`ruleList`	CancellationRule[]	Нет	Список правил отмены по периодам

Примеры#

 1{
 2 "freeCancellationBefore": "2025-12-10T12:00:00+00:00",
 3 "ruleList": [
 4 {
 5 "startAt": "2025-12-10T12:00:00+00:00",
 6 "endAt": "2025-12-14T14:00:00+00:00",
 7 "penalty": {
 8 "total": {
 9 "amount": 5000.00,
10 "currency": "RUB"
11 }
12 }
13 },
14 {
15 "startAt": "2025-12-14T14:00:00+00:00",
16 "penalty": {
17 "total": {
18 "amount": 15000.00,
19 "currency": "RUB"
20 }
21 }
22 }
23 ]
24}

Особенности#

freeCancellationBefore — если указано, отмена до этой даты бесплатна
Правила в ruleList описывают штрафы за отмену в определенные периоды
Если endAt не указан в последнем правиле — штраф действует до даты заезда

CancellationRule#

Отдельное правило отмены.

Дополнительные услуги

Mon, 01 Jan 0001 00:00:00 +0000

Дополнительные услуги#

Типы для работы с дополнительными услугами (ранний заезд, поздний выезд).

Upsell#

Запрос на дополнительную услугу при бронировании.

Поле	Тип	Обязательно	Описание
`id`	string	Нет	Идентификатор услуги
`type`	string	Нет	Тип услуги (`early_checkin`, `late_checkout`)
`checkinTime`	time	Нет	Время заезда (формат HH:mm, для раннего заезда)
`checkoutTime`	time	Нет	Время выезда (формат HH:mm, для позднего выезда)

Примеры#

Ранний заезд:

1{
2 "type": "early_checkin",
3 "checkinTime": "10:00"
4}

Поздний выезд: