Travel API 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

Денежные операции#

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

MonetaryAmount#

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

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

Примеры#

1{
2 "currencyCode": "RUB",
3 "value": 15000.50
4}

1{
2 "currencyCode": "USD",
3 "value": 199.99
4}

Использование#

Этот тип используется во всех операциях, где требуется указать денежную сумму:

Параметры запроса

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

Параметры запроса#

Детальное описание всех параметров для запроса /auth/token.

Параметры#

Параметр	Тип	Обязательно	Описание
`clientId`	string	Да	Идентификатор клиента
`clientSecret`	string	Да	Секрет клиента (client secret)

clientId#

Уникальный идентификатор клиента, выданный администратором системы. Используется для идентификации клиента в системе аутентификации.

clientSecret#

Секретный ключ клиента (client secret), выданный вместе с clientId. Должен храниться в безопасном месте и не передаваться третьим лицам.

Пример запроса#

1curl -X POST https://test.travel-api.ru/auth/token \
2 -H "Content-Type: application/json" \
3 -d '{
4 "clientId": "your-client-id",
5 "clientSecret": "your-client-secret"
6 }'

Тело запроса (JSON):

Параметры запроса

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

Параметры запроса#

Детальное описание всех параметров для запроса /avia/pnr_cancel.

Обязательные параметры#

Параметр	Тип	Описание
`bookingId`	guid	Идентификатор бронирования для отмены (формат UUID)

Примеры запросов#

Минимальный запрос#

curl

1curl -X POST https://test.travel-api.ru/avia/pnr_cancel \
2 -H "Authorization: Bearer YOUR_TOKEN" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "bookingId": "019a0b6e-47eb-7157-926e-80691497ebfc"
6 }'

 1var request = new PnrCancelRequest
 2{
 3 BookingId = "019a0b6e-47eb-7157-926e-80691497ebfc"
 4};
 5
 6var response = await httpClient.PostAsJsonAsync(
 7 "https://test.travel-api.ru/avia/pnr_cancel",
 8 request
 9);
10
11if (response.IsSuccessStatusCode)
12{
13 Console.WriteLine("Бронирование успешно отменено");
14}

Когда использовать#

Истечение срока оплаты#

Автоматически отменяйте бронирования, если пассажир не оплатил в срок:

Параметры запроса

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

Параметры запроса#

Детальное описание всех параметров для запроса /avia/pnr_create.

Обязательные параметры#

Параметр	Тип	Описание
`searchId`	string	Идентификатор из `/avia/search`
`offerItemId`	string	Идентификатор выбранного предложения
`passengers`	array	Данные пассажиров

Структура passengers#

Поле	Тип	Обязательно	Описание
`id`	string	Да	Идентификатор пассажира в запросе
`lastName`	string	Да	Фамилия латиницей
`firstName`	string	Да	Имя латиницей
`middleName`	string	Нет	Отчество
`gender`	string	Нет	Пол (`male`, `female`)
`type`	string	Нет	Тип пассажира (`adt`, `chd`, `inf`)
`title`	string	Нет	Обращение (`MR`, `MRS`, `MS`)
`documents`	Document[]	Да	Документы пассажира
`contacts`	array	Нет	Контакты пассажира
`frequentFlyers`	array	Нет	Программы лояльности

Структура documents#

Поле	Тип	Обязательно	Описание
`type`	DocumentType	Да	Тип документа (`internationalPassport`, `nationalPassport`, `birthCertificate`, `identityCard`, `notSet`)
`number`	string	Да	Номер документа
`lastName`	string	Да	Фамилия в документе (латиницей)
`firstName`	string	Да	Имя в документе (латиницей)
`middleName`	string	Нет	Отчество в документе
`series`	string	Нет	Серия документа (если применимо)
`birthDate`	date	Нет	Дата рождения (формат: YYYY-MM-DD)
`issueDate`	date	Нет	Дата выдачи (формат: YYYY-MM-DD)
`expireDate`	date	Нет	Срок действия (формат: YYYY-MM-DD)
`country`	string	Да	Страна выдачи (ISO 3166-1 alpha-2)

Структура contacts#

Поле	Тип	Обязательно	Описание
`type`	ContactType	Нет	Тип контакта
`value`	string	Да	Значение

ContactType — возможные значения:

Параметры запроса

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

Параметры запроса#

Детальное описание всех параметров для запроса /avia/pnr_reprice.

Обязательные параметры#

Параметр	Тип	Описание
`bookingId`	guid	Идентификатор бронирования для пересчета стоимости (формат UUID)

Опциональные параметры#

Параметр	Тип	Описание
`requestAdditions`	RequestAdditions	Дополнительные параметры запроса

Структура RequestAdditions#

Поле	Тип	Обязательно	Описание
`corporateCode`	CorporateCode	Нет	Корпоративный код скидки

Структура CorporateCode#

Поле	Тип	Обязательно	Описание
`code`	string	Да	Код корпоративной скидки
`carrierCode`	string	Да	Код авиакомпании (IATA, 2 символа)
`metadata`	map<string, string>	Нет	Дополнительные системные метаданные (GDS/NDC)

Примеры запросов#

Минимальный запрос#

curl

1curl -X POST https://test.travel-api.ru/avia/pnr_reprice \
2 -H "Authorization: Bearer YOUR_TOKEN" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "bookingId": "019a0b6e-47eb-7157-926e-80691497ebfc"
6 }'

 1var request = new PnrRepriceRequest
 2{
 3 BookingId = "019a0b6e-47eb-7157-926e-80691497ebfc"
 4};
 5
 6var response = await httpClient.PostAsJsonAsync(
 7 "https://test.travel-api.ru/avia/pnr_reprice",
 8 request
 9);
10
11var result = await response.Content.ReadFromJsonAsync<PnrRepriceResponse>();

Когда использовать#

Перед выпиской билета#

Всегда проверяйте актуальность цены перед выпиской:

Параметры запроса

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

Параметры запроса#

Детальное описание всех параметров для запроса /avia/pnr_retrieve.

Обязательные параметры#

Параметр	Тип	Описание
`bookingId`	guid	Идентификатор бронирования из `/avia/pnr_create` (формат UUID)

Примеры запросов#

Минимальный запрос#

curl

1curl -X POST https://test.travel-api.ru/avia/pnr_retrieve \
2 -H "Authorization: Bearer YOUR_TOKEN" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "bookingId": "019a0c82-5d2b-7a5e-84fe-56357a57df66"
6 }'

 1var request = new PnrRetrieveRequest
 2{
 3 BookingId = "019a0c82-5d2b-7a5e-84fe-56357a57df66"
 4};
 5
 6var response = await httpClient.PostAsJsonAsync(
 7 "https://test.travel-api.ru/avia/pnr_retrieve",
 8 request
 9);
10
11var result = await response.Content.ReadFromJsonAsync<PnrRetrieveResponse>();

Когда использовать#

После создания бронирования#

Сразу после создания бронирования получите полные детали:

Параметры запроса

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

Параметры запроса#

Детальное описание всех параметров для запроса /avia/fare_rules.

Обязательные параметры#

Параметр	Тип	Описание
`searchId`	string	Идентификатор из `/avia/search`
`offerItemId`	string	Идентификатор предложения для получения правил

Пример запроса#

curl

1curl -X POST https://test.travel-api.ru/avia/fare_rules \
2 -H "Authorization: Bearer YOUR_TOKEN" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "searchId": "0E8AC7882BECA40467A7047BEDCE3FEC",
6 "offerItemId": "571B2E9333EA93F9365BB4FB0C1492A2"
7 }'

Типичные ошибки#

Код ошибки	Причина	Решение
`SEARCH_EXPIRED`	Поиск устарел	Выполните новый поиск
`OFFER_NOT_AVAILABLE`	Предложение недоступно	Выберите другое предложение
`INVALID_OFFER_ITEM_ID`	Некорректный ID	Проверьте offerItemId

Связанные операции#

Поиск рейсов - получение searchId и offerItemId
Проверка цены - проверка актуальной цены предложения
Создание бронирования - создание PNR после проверки правил

Параметры запроса

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

Параметры запроса#

Детальное описание всех параметров для запроса /avia/offer_price.

Обязательные параметры#

Параметр	Тип	Описание
`searchId`	string	Идентификатор из `/avia/search`
`offerItemId`	string	Идентификатор предложения для проверки цены

Пример запроса#

curl

1curl -X POST https://test.travel-api.ru/avia/offer_price \
2 -H "Authorization: Bearer YOUR_TOKEN" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "searchId": "AAF6301E87DD7C73E7A8A636FDC77ED5",
6 "offerItemId": "1691A9FCFD85DC8DB9D6093D7E75C5C0"
7 }'

Типичные ошибки#

Код ошибки	Причина	Решение
`SEARCH_EXPIRED`	Поиск устарел	Выполните новый поиск
`OFFER_NOT_AVAILABLE`	Предложение недоступно	Выберите другое предложение
`INVALID_OFFER_ITEM_ID`	Некорректный ID	Проверьте offerItemId

Связанные операции#

Поиск рейсов - получение searchId
Создание бронирования - создание PNR после проверки цены
Правила тарифа - проверка условий тарифа

Параметры запроса

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

Параметры запроса#

Детальное описание всех параметров для запроса /avia/search.

Параметры запроса#

Поле	Тип	Обязательно	Описание
`originDestinations`	OriginDestination[]	Да	Сегменты маршрута (минимум 1)
`passengers`	PassengerTypeQuantity[]	Да	Типы и количество пассажиров
`searchCriteria`	SearchCriteria	Нет	Дополнительные критерии и фильтры поиска

Структура originDestinations#

Поле	Тип	Обязательно	Описание
`odId`	string	Да	Идентификатор сегмента
`origin`	Location	Да	Пункт отправления
`destination`	Location	Да	Пункт назначения
`departureDate`	date	Да	Дата вылета (формат: YYYY-MM-DD)
`connectionPoint`	Location	Нет	Точка пересадки

Структура passengers#

Поле	Тип	Обязательно	Описание
`ptc`	PassengerType	Да	Тип пассажира (взрослый/ребенок/младенец)
`quantity`	integer	Да	Количество пассажиров данного типа (1-9)

Структура searchCriteria#

Поле	Тип	Обязательно	Описание
`searchConstraints`	SearchConstraints	Нет	Общие параметры поиска
`fareConstraints`	FareConstraints	Нет	Ограничения по тарифам
`flightConstraints`	FlightConstraints	Нет	Ограничения по рейсам
`odConstraints`	map<string, ODConstraints>	Нет	Ограничения по конкретным сегментам (ключ — odId)

searchConstraints — общие параметры поиска

Поле	Тип	Обязательно	Описание
`currencyCode`	string	Нет	Валюта для возврата цен (ISO 4217)
`maxResults`	integer	Нет	Максимальное количество результатов
`dateSearchScope`	DateSearchScope	Нет	Точная дата или ±1 день
`tags`	string[]	Нет	Произвольные теги запроса для матчинга пресетов Revenue Manager

DateSearchScope — возможные значения:

Параметры запроса

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

Параметры запроса#

Детальное описание параметров для запроса /avia/ticket_cancel.

Обязательные параметры#

Параметр	Тип	Описание
`bookingId`	guid	Идентификатор бронирования (формат UUID)
`ticketNumber`	string	Номер билета для войдирования в формате `{vendor}-{number}` (например, `555-6170036872`)

Пример запроса#

curl

1curl -X POST https://test.travel-api.ru/avia/ticket_cancel \
2 -H "Authorization: Bearer YOUR_TOKEN" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "bookingId": "019a0b6e-47eb-7157-926e-80691497ebfc",
6 "ticketNumber": "555-6170036872"
7 }'

 1var request = new TicketCancelRequest
 2{
 3 BookingId = "019a0b6e-47eb-7157-926e-80691497ebfc",
 4 TicketNumber = "555-6170036872"
 5};
 6
 7var response = await httpClient.PostAsJsonAsync(
 8 "https://test.travel-api.ru/avia/ticket_cancel",
 9 request
10);
11
12if (response.IsSuccessStatusCode)
13{
14 var content = await response.Content.ReadAsStringAsync();
15
16 // Пустой ответ {} означает успех
17 if (content.Trim() == "{}")
18 {
19 Console.WriteLine("Билет успешно войдирован");
20 }
21}

Процесс войдирования#

Отмена выписанного билета без штрафов в день выписки.

Параметры запроса

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

Параметры запроса#

Детальное описание параметров для запроса /avia/ticket_exchange_calculation.

Обязательные параметры#

Параметр	Тип	Описание
`bookingId`	guid	Идентификатор бронирования (формат UUID)
`ticketNumber`	string	Номер билета для обмена (может включать префикс vendor)
`legs`	Leg[]	Массив новых маршрутов с сегментами

Структура Leg (маршрут)#

Параметр	Тип	Обязательно	Описание
`segments`	Segment[]	Да	Массив сегментов маршрута

Структура Segment (сегмент перелета)#

Параметр	Тип	Обязательно	Описание
`flight`	FlightDesignator	Да	Информация о рейсе (код авиакомпании и номер рейса)
`origin`	Location	Да	Пункт отправления
`destination`	Location	Да	Пункт назначения
`departureAt`	datetime	Да	Дата и время вылета (ISO 8601)
`arrivalAt`	datetime	Да	Дата и время прилета (ISO 8601)
`fareBasis`	string	Да	Код тарифа
`originalSegmentId`	string	Да	Ссылка на оригинальный сегмент

Структура FlightDesignator#

Параметр	Тип	Обязательно	Описание
`carrierCode`	string	Да	IATA код авиакомпании (2 символа)
`flightNumber`	string	Да	Номер рейса

Структура Location#

Параметр	Тип	Обязательно	Описание
`code`	string	Да	IATA код аэропорта или города (3 символа)
`codeType`	integer	Да	Тип кода (0 = IATA)
`type`	integer	Да	Тип локации (0 = Airport, 1 = City)

Пример запроса#

curl

 1curl -X POST https://test.travel-api.ru/avia/ticket_exchange_calculation \
 2 -H "Authorization: Bearer YOUR_TOKEN" \
 3 -H "Content-Type: application/json" \
 4 -d '{
 5 "bookingId": "019a0ce7-b2b1-7670-9bb0-0823c0853344",
 6 "ticketNumber": "425-6170037301",
 7 "legs": [
 8 {
 9 "segments": [
10 {
11 "flight": {
12 "carrierCode": "DP",
13 "flightNumber": "6841"
14 },
15 "origin": {
16 "code": "SVO",
17 "codeType": 0,
18 "type": 0
19 },
20 "destination": {
21 "code": "KZN",
22 "codeType": 0,
23 "type": 0
24 },
25 "departureAt": "2025-11-29T07:40:00",
26 "arrivalAt": "2025-11-29T09:20:00"
27 }
28 ]
29 }
30 ]
31 }'

 1var request = new
 2{
 3 bookingId = "019a0ce7-b2b1-7670-9bb0-0823c0853344",
 4 ticketNumber = "425-6170037301",
 5 legs = new[]
 6 {
 7 new
 8 {
 9 segments = new[]
10 {
11 new
12 {
13 flight = new
14 {
15 carrierCode = "DP",
16 flightNumber = "6841"
17 },
18 origin = new
19 {
20 code = "SVO",
21 codeType = 0,
22 type = 0
23 },
24 destination = new
25 {
26 code = "KZN",
27 codeType = 0,
28 type = 0
29 },
30 departureAt = "2025-11-29T07:40:00",
31 arrivalAt = "2025-11-29T09:20:00"
32 }
33 }
34 }
35 }
36};
37
38var response = await httpClient.PostAsJsonAsync(
39 "https://test.travel-api.ru/avia/ticket_exchange_calculation",
40 request
41);
42
43if (response.IsSuccessStatusCode)
44{
45 var result = await response.Content.ReadFromJsonAsync<ExchangeCalculationResponse>();
46
47 if (result?.Error == null && result.Offers?.Length > 0)
48 {
49 Console.WriteLine($"Найдено вариантов: {result.Offers.Length}");
50 var cheapest = result.Offers.MinBy(o => o.OfferItems[0].ForExchange.Value);
51 Console.WriteLine($"Минимальная доплата: {cheapest.OfferItems[0].ForExchange.Value} RUB");
52 }
53}

Обработка ошибок#

При расчете обмена могут возникнуть следующие ошибки:

Параметры запроса

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

Параметры запроса#

Детальное описание параметров для запроса /avia/ticket_exchange.

Обязательные параметры#

Параметр	Тип	Описание
`exchangeId`	string	Идентификатор обмена из `/avia/ticket_exchange_calculation`
`offerItemId`	string	ID выбранного варианта обмена
`bookingId`	guid	Идентификатор бронирования (формат UUID)
`ticketNumber`	string	Номер билета для обмена (может включать префикс vendor)
`forExchange`	Money	Сумма к оплате за обмен
`legs`	Leg[]	Массив новых маршрутов
`passengers`	Passenger[]	Массив пассажиров

Структуры данных#

Money#

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

Leg (маршрут)#

Параметр	Тип	Обязательно	Описание
`segments`	Segment[]	Да	Массив сегментов маршрута

Segment (сегмент)#

Параметр	Тип	Обязательно	Описание
`id`	string	Да	ID сегмента из варианта обмена
`class`	string	Да	Класс бронирования (буква, например: Y, C, F)
`destination`	BoardOffPoint	Да	Пункт назначения с датой/временем
`flight`	FlightDesignator	Да	Информация о рейсе
`origin`	BoardOffPoint	Да	Пункт отправления с датой/временем

BoardOffPoint#

Параметр	Тип	Обязательно	Описание
`airport`	string	Да	IATA код аэропорта (3 символа)
`dateTime`	datetime	Да	Дата и время (ISO 8601)

FlightDesignator#

Параметр	Тип	Обязательно	Описание
`carrierCode`	string	Да	IATA код авиакомпании (2 символа)
`flightNumber`	string	Да	Номер рейса

Passenger (пассажир)#

Параметр	Тип	Обязательно	Описание
`lastName`	string	Да	Фамилия (латиница, как в документе)
`firstName`	string	Да	Имя (латиница, как в документе)
`type`	PassengerType	Нет	Тип пассажира (`adt`, `chd`, `inf`)
`documents`	Document[]	Да	Массив документов пассажира

Пример запроса#

JSON

 1{
 2 "exchangeId": "DC0BED1AEF4D9CE789DDBBA384A9593C",
 3 "offerItemId": "fa94ea6a-ac07-49d7-a810-a4640f2774fd",
 4 "bookingId": "019a0ce7-b2b1-7670-9bb0-0823c0853344",
 5 "ticketNumber": "425-6170037301",
 6 "forExchange": {
 7 "currencyCode": "RUB",
 8 "value": 5000
 9 },
10 "legs": [
11 {
12 "segments": [
13 {
14 "id": "NLc0EJEsw0GJer9QRFb4Sg",
15 "class": "P",
16 "destination": {
17 "airport": "KZN",
18 "dateTime": "2025-11-29T09:20:00"
19 },
20 "flight": {
21 "carrierCode": "DP",
22 "flightNumber": "6841"
23 },
24 "origin": {
25 "airport": "SVO",
26 "dateTime": "2025-11-29T07:40:00"
27 }
28 }
29 ]
30 }
31 ],
32 "passengers": [
33 {
34 "lastName": "KOZLOV",
35 "firstName": "IVAN",
36 "type": "adt"
37 }
38 ]
39}

Обработка ошибок#

При обмене билета могут возникнуть следующие ошибки:

Параметры запроса

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

Параметры запроса#

Детальное описание всех параметров для запроса /avia/ticket_info.

Обязательные параметры#

Параметр	Тип	Описание
`bookingId`	guid	Идентификатор бронирования (формат UUID)
`ticketNumber`	string	Номер билета в формате `{vendor}-{number}` (например, `425-6170037281`)

Пример запроса#

curl

1curl -X POST https://test.travel-api.ru/avia/ticket_info \
2 -H "Authorization: Bearer YOUR_TOKEN" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "bookingId": "019a0c82-5d2b-7a5e-84fe-56357a57df66",
6 "ticketNumber": "425-6170037281"
7 }'

Типичные ошибки#

Код ошибки	Причина	Решение
`TICKET_NOT_FOUND`	Билет не найден	Проверьте номер билета и bookingId
`BOOKING_NOT_FOUND`	Бронирование не найдено	Проверьте bookingId
`INVALID_TICKET_NUMBER`	Некорректный номер билета	Используйте формат `{vendor}-{number}`
`ACCESS_DENIED`	Нет доступа к билету	Проверьте права доступа

Связанные операции#

Выписка билета - создание билета
Обмен билета - обмен билета на новый
Возврат билета - оформление возврата
Получение PNR - получение списка билетов

Параметры запроса

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

Параметры запроса#

Детальное описание параметров для запроса /avia/ticket_issue.

Обязательные параметры#

Параметр	Тип	Описание
`bookingId`	guid	Идентификатор бронирования (формат UUID)
`payment`	Payment	Информация об оплате

Опциональные параметры#

Параметр	Тип	Описание
`tourCode`	string	Код тура для специальных тарифов
`supplierSpecific`	map<string, string>	Специфичные для поставщика параметры

Структура Payment#

Параметр	Тип	Обязательно	Описание
`type`	string	Да	Тип оплаты. Возможные значения: `Invoice`
`commission`	Commission	Нет	Информация о комиссии
`vat`	map<string, Money>	Нет	НДС по типам пассажиров (ключ: PassengerType)

Структура Commission#

Параметр	Тип	Обязательно	Описание
`amount`	decimal	Да	Сумма комиссии (или процентное значение)
`percentage`	boolean	Да	Указывает, является ли комиссия процентной

Пример запроса#

curl

1curl -X POST https://test.travel-api.ru/avia/ticket_issue \
2 -H "Authorization: Bearer YOUR_TOKEN" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "bookingId": "019a0ce5-4890-7e2f-a0b1-28bae0a30d6d",
6 "payment": {
7 "type": "invoice"
8 }
9 }'

 1var request = new
 2{
 3 bookingId = "019a0ce5-4890-7e2f-a0b1-28bae0a30d6d",
 4 payment = new
 5 {
 6 type = "invoice"
 7 }
 8};
 9
10var response = await httpClient.PostAsJsonAsync(
11 "https://test.travel-api.ru/avia/ticket_issue",
12 request
13);
14
15if (response.IsSuccessStatusCode)
16{
17 var result = await response.Content.ReadFromJsonAsync<TicketIssueResponse>();
18
19 if (result?.Error == null)
20 {
21 Console.WriteLine("Билеты успешно выписаны:");
22 foreach (var ticket in result.Tickets)
23 {
24 Console.WriteLine($" {ticket.Vendor}-{ticket.Number}");
25 }
26 }
27}

Связанные операции#

Информация о билете - проверка выписанного билета
Войдирование билета - отмена билета
Получение PNR - информация о бронировании

Параметры запроса

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

Параметры запроса#

Детальное описание параметров для запроса /avia/ticket_refund_calculation.

Обязательные параметры#

Параметр	Тип	Описание
`bookingId`	guid	Идентификатор бронирования (формат UUID)
`ticketNumber`	string	Номер билета для расчёта возврата в формате `{vendor}-{number}` (например, `555-6170036806`)

Пример запроса#

curl

1curl -X POST https://test.travel-api.ru/avia/ticket_refund_calculation \
2 -H "Authorization: Bearer YOUR_TOKEN" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "bookingId": "019a0b29-8fc8-703a-9845-50c7ce2b1322",
6 "ticketNumber": "555-6170036806"
7 }'

 1var request = new
 2{
 3 bookingId = "019a0b29-8fc8-703a-9845-50c7ce2b1322",
 4 ticketNumber = "555-6170036806"
 5};
 6
 7var response = await httpClient.PostAsJsonAsync(
 8 "https://test.travel-api.ru/avia/ticket_refund_calculation",
 9 request
10);
11
12if (response.IsSuccessStatusCode)
13{
14 var result = await response.Content.ReadFromJsonAsync<RefundCalculationResponse>();
15
16 if (result?.Error == null)
17 {
18 Console.WriteLine($"К возврату: {result.ForRefund.Value} {result.ForRefund.CurrencyCode}");
19 Console.WriteLine($"Штраф: {result.RefundDetails.Penalty.Value} {result.RefundDetails.Penalty.CurrencyCode}");
20 }
21}

Сценарии использования#

Сценарий 1: Расчет перед возвратом#

Действия:

Параметры запроса

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

Параметры запроса#

Детальное описание параметров для запроса /avia/ticket_refund.

Обязательные параметры#

Параметр	Тип	Описание
`bookingId`	guid	Идентификатор бронирования (формат UUID)
`ticketNumber`	string	Номер билета для возврата (может включать префикс vendor)
`forRefund`	Money	Сумма к возврату из расчета возврата

Структура Money#

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

Пример запроса#

curl

 1curl -X POST https://test.travel-api.ru/avia/ticket_refund \
 2 -H "Authorization: Bearer YOUR_TOKEN" \
 3 -H "Content-Type: application/json" \
 4 -d '{
 5 "bookingId": "019a0ce6-2633-787f-a6bc-5dbddc02cc1f",
 6 "ticketNumber": "425-6170037294",
 7 "forRefund": {
 8 "currencyCode": "RUB",
 9 "value": 5499
10 }
11 }'

 1var request = new
 2{
 3 bookingId = "019a0ce6-2633-787f-a6bc-5dbddc02cc1f",
 4 ticketNumber = "425-6170037294",
 5 forRefund = new
 6 {
 7 currencyCode = "RUB",
 8 value = 5499
 9 }
10};
11
12var response = await httpClient.PostAsJsonAsync(
13 "https://test.travel-api.ru/avia/ticket_refund",
14 request
15);
16
17if (response.IsSuccessStatusCode)
18{
19 var content = await response.Content.ReadAsStringAsync();
20
21 // Пустой ответ {} означает успех
22 if (content.Trim() == "{}")
23 {
24 Console.WriteLine("Возврат билета успешно оформлен");
25 }
26}

Обработка ошибок#

При возврате билета могут возникнуть следующие ошибки:

Параметры запроса

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

Параметры запроса#

Детальное описание всех параметров для запроса /hotels/cancel_booking.

Параметры запроса#

Поле	Тип	Обязательно	Описание
`bookingId`	guid	Да	Идентификатор бронирования для отмены (формат UUID)
`language`	string	Да	Язык ответа (например `ru`, `en`)

Примеры запросов#

curl

1curl -X POST https://test.travel-api.ru/hotels/cancel_booking \
2 -H "Authorization: Bearer YOUR_TOKEN" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "bookingId": "019a0c82-5d2b-7a5e-84fe-56357a57df66",
6 "language": "ru"
7 }'

 1var request = new CancelBookingRequest
 2{
 3 BookingId = Guid.Parse("019a0c82-5d2b-7a5e-84fe-56357a57df66"),
 4 Language = "ru"
 5};
 6
 7var response = await httpClient.PostAsJsonAsync(
 8 "https://test.travel-api.ru/hotels/cancel_booking",
 9 request
10);
11
12var result = await response.Content.ReadFromJsonAsync<CancelBookingResponse>();

Параметры запроса

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

Параметры запроса#

Детальное описание всех параметров для запроса /hotels/create_booking.

Обязательные параметры#

Параметр	Тип	Описание
`searchId`	string	Идентификатор из `/hotels/hotel_pricing` или `/hotels/offer_pricing`
`offerId`	string	Идентификатор выбранного предложения
`partnerInfo`	PartnerInfo	Информация о заказе партнера
`paymentType`	PaymentInfo	Информация об оплате
`guests`	BookingGuest[]	Данные гостей
`customer`	Customer	Контактное лицо
`language`	string	Язык ответа (например `ru`, `en`)

Опциональные параметры#

Параметр	Тип	Описание
`partnerManager`	PartnerManager	Менеджер партнера
`upsells`	Upsell[]	Дополнительные услуги (ранний заезд, поздний выезд)
`bookingTags`	string[]	Теги бронирования для категоризации

Структура PartnerInfo#

Поле	Тип	Обязательно	Описание
`partnerOrderId`	string	Да	Идентификатор заказа в системе партнера
`comment`	string	Нет	Комментарий к заказу
`amountSellB2b2c`	Money	Нет	Сумма продажи B2B2C

Структура PaymentInfo#

Поле	Тип	Обязательно	Описание
`type`	string	Да	Тип оплаты (`hotel`, `online`)

Структура PartnerManager#

Поле	Тип	Обязательно	Описание
`firstName`	string	Нет	Имя
`lastName`	string	Нет	Фамилия
`email`	string	Нет	Email
`phone`	string	Нет	Телефон
`comment`	string	Нет	Комментарий

Как использовать параметры#

Минимальное бронирование#

 1{
 2 "searchId": "search-xyz789",
 3 "offerId": "offer-001",
 4 "language": "ru",
 5 "partnerInfo": {
 6 "partnerOrderId": "ORDER-12345"
 7 },
 8 "paymentType": {
 9 "type": "online"
10 },
11 "guests": [
12 {
13 "firstName": "IVAN",
14 "lastName": "IVANOV",
15 "isChild": false
16 }
17 ],
18 "customer": {
19 "firstName": "Ivan",
20 "lastName": "Ivanov",
21 "email": "ivan@example.com",
22 "phone": "+79991234567"
23 }
24}

Бронирование с несколькими гостями#

 1{
 2 "searchId": "search-xyz789",
 3 "offerId": "offer-001",
 4 "language": "ru",
 5 "partnerInfo": {
 6 "partnerOrderId": "ORDER-12345",
 7 "comment": "VIP клиент"
 8 },
 9 "paymentType": {
10 "type": "online"
11 },
12 "guests": [
13 {
14 "firstName": "IVAN",
15 "lastName": "IVANOV",
16 "citizenship": "RU",
17 "isChild": false,
18 "gender": "male"
19 },
20 {
21 "firstName": "MARIA",
22 "lastName": "IVANOVA",
23 "citizenship": "RU",
24 "isChild": false,
25 "gender": "female"
26 },
27 {
28 "firstName": "PETR",
29 "lastName": "IVANOV",
30 "isChild": true,
31 "age": 7
32 }
33 ],
34 "customer": {
35 "firstName": "Ivan",
36 "lastName": "Ivanov",
37 "email": "ivan@example.com",
38 "phone": "+79991234567"
39 }
40}

Бронирование с ранним заездом#

 1{
 2 "searchId": "search-xyz789",
 3 "offerId": "offer-001",
 4 "language": "ru",
 5 "partnerInfo": {
 6 "partnerOrderId": "ORDER-12345"
 7 },
 8 "paymentType": {
 9 "type": "online"
10 },
11 "guests": [
12 {
13 "firstName": "IVAN",
14 "lastName": "IVANOV",
15 "isChild": false
16 }
17 ],
18 "customer": {
19 "firstName": "Ivan",
20 "lastName": "Ivanov",
21 "email": "ivan@example.com",
22 "phone": "+79991234567"
23 },
24 "upsells": [
25 {
26 "type": "early_checkin",
27 "checkinTime": "10:00"
28 }
29 ]
30}

С указанием менеджера#

1{
2 "partnerManager": {
3 "firstName": "Olga",
4 "lastName": "Petrova",
5 "email": "olga@travel-agency.com",
6 "phone": "+79997654321"
7 }
8}

Примеры запросов#

Минимальный запрос#

curl

 1curl -X POST https://test.travel-api.ru/hotels/create_booking \
 2 -H "Authorization: Bearer YOUR_TOKEN" \
 3 -H "Content-Type: application/json" \
 4 -d '{
 5 "searchId": "search-xyz789",
 6 "offerId": "offer-001",
 7 "language": "ru",
 8 "partnerInfo": {
 9 "partnerOrderId": "ORDER-12345"
10 },
11 "paymentType": {
12 "type": "online"
13 },
14 "guests": [
15 {
16 "firstName": "IVAN",
17 "lastName": "IVANOV",
18 "isChild": false
19 }
20 ],
21 "customer": {
22 "firstName": "Ivan",
23 "lastName": "Ivanov",
24 "email": "ivan@example.com",
25 "phone": "+79991234567"
26 }
27 }'

 1var request = new CreateBookingRequest
 2{
 3 SearchId = "search-xyz789",
 4 OfferId = "offer-001",
 5 Language = "ru",
 6 PartnerInfo = new PartnerInfo
 7 {
 8 PartnerOrderId = "ORDER-12345"
 9 },
10 PaymentType = new PaymentInfo
11 {
12 Type = "online"
13 },
14 Guests = new[]
15 {
16 new BookingGuest
17 {
18 FirstName = "IVAN",
19 LastName = "IVANOV",
20 IsChild = false
21 }
22 },
23 Customer = new Customer
24 {
25 FirstName = "Ivan",
26 LastName = "Ivanov",
27 Email = "ivan@example.com",
28 Phone = "+79991234567"
29 }
30};
31
32var response = await httpClient.PostAsJsonAsync(
33 "https://test.travel-api.ru/hotels/create_booking",
34 request
35);
36
37var result = await response.Content.ReadFromJsonAsync<CreateBookingResponse>();

Параметры запроса

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

Параметры запроса#

Детальное описание всех параметров для запроса /hotels/search_bookings.

Параметры запроса#

Поле	Тип	Обязательно	Описание
`supplierOrderIds`	string[]	Да	Идентификаторы заказов поставщика для поиска
`language`	string	Да	Язык ответа (например `ru`, `en`)
`partnerOrderIds`	string[]	Нет	Фильтр по идентификаторам заказов партнера
`createdFrom`	date	Нет	Начальная дата создания (формат: YYYY-MM-DD)
`createdTo`	date	Нет	Конечная дата создания (формат: YYYY-MM-DD)
`statusFilter`	BookingStatusFilter	Нет	Фильтр по статусу (по умолчанию `active`)

BookingStatusFilter#

Значение	Описание
`active`	Только активные бронирования (по умолчанию)
`all`	Все бронирования, включая отмененные

Как использовать параметры#

Все активные бронирования#

1{
2 "supplierOrderIds": ["SUP-001", "SUP-002"],
3 "language": "ru",
4 "statusFilter": "Active"
5}

Поиск по идентификаторам заказов#

1{
2 "supplierOrderIds": ["SUP-001"],
3 "language": "ru",
4 "partnerOrderIds": ["ORDER-12345", "ORDER-67890"]
5}

Поиск по периоду создания#

1{
2 "supplierOrderIds": ["SUP-001", "SUP-002", "SUP-003"],
3 "language": "ru",
4 "createdFrom": "2025-12-01",
5 "createdTo": "2025-12-31",
6 "statusFilter": "All"
7}

Примеры запросов#

curl

 1curl -X POST https://test.travel-api.ru/hotels/search_bookings \
 2 -H "Authorization: Bearer YOUR_TOKEN" \
 3 -H "Content-Type: application/json" \
 4 -d '{
 5 "supplierOrderIds": ["SUP-001", "SUP-002"],
 6 "language": "ru",
 7 "createdFrom": "2025-12-01",
 8 "createdTo": "2025-12-31",
 9 "statusFilter": "Active"
10 }'

 1var request = new SearchBookingsRequest
 2{
 3 SupplierOrderIds = new[] { "SUP-001", "SUP-002" },
 4 Language = "ru",
 5 CreatedFrom = new DateOnly(2025, 12, 1),
 6 CreatedTo = new DateOnly(2025, 12, 31),
 7 StatusFilter = BookingStatusFilter.Active
 8};
 9
10var response = await httpClient.PostAsJsonAsync(
11 "https://test.travel-api.ru/hotels/search_bookings",
12 request
13);
14
15var result = await response.Content.ReadFromJsonAsync<SearchBookingsResponse>();

Параметры запроса

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

Параметры запроса#

Детальное описание всех параметров для запроса /hotels/view_booking.

Параметры запроса#

Поле	Тип	Обязательно	Описание
`bookingId`	guid	Да	Идентификатор бронирования (формат UUID)
`language`	string	Да	Язык ответа (например `ru`, `en`)

Примеры запросов#

curl

1curl -X POST https://test.travel-api.ru/hotels/view_booking \
2 -H "Authorization: Bearer YOUR_TOKEN" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "bookingId": "019a0c82-5d2b-7a5e-84fe-56357a57df66",
6 "language": "ru"
7 }'

 1var request = new ViewBookingRequest
 2{
 3 BookingId = Guid.Parse("019a0c82-5d2b-7a5e-84fe-56357a57df66"),
 4 Language = "ru"
 5};
 6
 7var response = await httpClient.PostAsJsonAsync(
 8 "https://test.travel-api.ru/hotels/view_booking",
 9 request
10);
11
12var result = await response.Content.ReadFromJsonAsync<ViewBookingResponse>();

Параметры запроса

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

Параметры запроса#

Детальное описание всех параметров для запроса /hotels/hotel_pricing.

Параметры запроса#

Поле	Тип	Обязательно	Описание
`hotelId`	string	Да	Идентификатор отеля
`checkin`	date	Да	Дата заезда (формат: YYYY-MM-DD)
`checkout`	date	Да	Дата выезда (формат: YYYY-MM-DD)
`currency`	string	Да	Валюта цен (ISO 4217)
`language`	string	Да	Язык ответа (например `ru`, `en`)
`onlyAvailableOffers`	boolean	Да	Показывать только доступные предложения
`guests`	Guests	Да	Конфигурация гостей
`residency`	string	Нет	Резидентство гостя (ISO 3166-1 alpha-2, например `RU`)
`earlyCheckin`	time	Нет	Желаемое время раннего заезда (формат HH:mm)
`lateCheckout`	time	Нет	Желаемое время позднего выезда (формат HH:mm)
`paymentTypes`	string[]	Нет	Фильтр по типам оплаты (`hotel`, `online`)
`searchTags`	string[]	Нет	Теги поиска
`pricingTags`	string[]	Нет	Теги прайсинга

Как использовать параметры#

Базовый запрос#

 1{
 2 "hotelId": "hotel-001",
 3 "checkin": "2025-12-15",
 4 "checkout": "2025-12-18",
 5 "currency": "RUB",
 6 "language": "ru",
 7 "onlyAvailableOffers": true,
 8 "guests": {
 9 "adults": 2
10 }
11}

С ранним заездом и поздним выездом#

Укажите earlyCheckin и lateCheckout для получения опций:

Параметры запроса

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

Параметры запроса#

Детальное описание всех параметров для запроса /hotels/offer_pricing.

Параметры запроса#

Поле	Тип	Обязательно	Описание
`searchId`	string	Да	Идентификатор поиска (из ответа `/hotels/hotel_pricing`)
`offerId`	string	Да	Идентификатор предложения (из ответа `/hotels/hotel_pricing`)
`language`	string	Да	Язык ответа (например `ru`, `en`)

Примеры запросов#

Базовый запрос#

curl

1curl -X POST https://test.travel-api.ru/hotels/offer_pricing \
2 -H "Authorization: Bearer YOUR_TOKEN" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "searchId": "search-xyz789",
6 "offerId": "offer-001",
7 "language": "ru"
8 }'

 1var request = new OfferPricingRequest
 2{
 3 SearchId = "search-xyz789",
 4 OfferId = "offer-001",
 5 Language = "ru"
 6};
 7
 8var response = await httpClient.PostAsJsonAsync(
 9 "https://test.travel-api.ru/hotels/offer_pricing",
10 request
11);
12
13var result = await response.Content.ReadFromJsonAsync<OfferPricingResponse>();

Параметры запроса

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

Параметры запроса#

Детальное описание всех параметров для запроса /hotels/search.

Параметры запроса#

Поле	Тип	Обязательно	Описание
`regionId`	string	Да	Идентификатор региона для поиска
`checkin`	date	Да	Дата заезда (формат: YYYY-MM-DD)
`checkout`	date	Да	Дата выезда (формат: YYYY-MM-DD)
`currency`	string	Да	Валюта цен (ISO 4217, например `RUB`, `USD`)
`language`	string	Да	Язык ответа (например `ru`, `en`)
`guests`	Guests	Да	Конфигурация гостей
`hotelsLimit`	integer	Нет	Максимальное количество отелей в ответе
`timeout`	integer	Нет	Таймаут поиска в секундах
`earlyCheckin`	time	Нет	Желаемое время раннего заезда (формат HH:mm)
`lateCheckout`	time	Нет	Желаемое время позднего выезда (формат HH:mm)
`paymentTypes`	string[]	Нет	Фильтр по типам оплаты (`hotel`, `online`)
`pricingTags`	string[]	Нет	Теги ценообразования
`searchTags`	string[]	Нет	Теги поиска

Как использовать параметры#

Поиск с ограничением количества#

Используйте hotelsLimit для ограничения результатов:

Параметры запроса

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

Параметры запроса#

Детальное описание всех параметров для запроса /hotels/static/hotel-static/.

Параметры запроса#

Поле	Тип	Обязательно	Описание
`hotelId`	integer	Да	Идентификатор отеля

Особенности запроса#

Метод используется для получения статической информации по конкретному отелю.
В запросе передается только идентификатор отеля.
Тело запроса отсутствует.

Примеры запросов#

cURL#

1curl -X GET "https://test.travel-api.ru/hotels/12345/static" \
2 -H "Authorization: Bearer <token>" \
3 -H "Accept: application/json"

Локации

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

Локации#

Типы для работы с географическими точками (аэропорты, города).

Location#

Географическая точка — аэропорт или город.

Поле	Тип	Обязательно	Описание
`code`	string	Да	Код аэропорта или города (3 буквы)
`codeType`	LocationCodeType	Да	Тип кода
`type`	LocationType	Да	Тип локации

Примеры#

Аэропорт Шереметьево:

1{
2 "code": "SVO",
3 "codeType": "iata",
4 "type": "airport"
5}

Город Москва:

1{
2 "code": "MOW",
3 "codeType": "iata",
4 "type": "city"
5}

Использование#

Используется для указания:

Предложение

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

Структура ответа#

Детальное описание структуры ответа от /auth/token.

Основная структура#

Поле	Тип	Обязательно	Описание
`token`	string	Нет	JWT токен доступа
`expiresAt`	string	Нет	Время истечения токена в формате ISO 8601 (UTC)
`error`	Error	Нет	Информация об ошибке (присутствует только при ошибке)

Успешный ответ#

При успешной аутентификации возвращаются поля token и expiresAt:

Поле	Тип	Обязательно	Описание
`token`	string	Да	JWT токен доступа для использования в последующих запросах
`expiresAt`	string	Да	Дата и время истечения токена в формате ISO 8601 (UTC)

Пример успешного ответа#

1{
2 "token": "eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJxWXo4...",
3 "expiresAt": "2025-12-29T12:00:00Z"
4}

Поле token#

JWT токен доступа для использования в заголовке Authorization: Bearer {token} при всех запросах к API.

Структура ответа

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

Структура ответа#

Детальное описание структуры ответа от /avia/pnr_cancel.

Успешный ответ#

При успешной отмене бронирования возвращается пустой объект:

1{}

Типичные ошибки#

Код ошибки	Причина	Решение
`BOOKING_NOT_FOUND`	Бронирование не найдено	Проверьте bookingId
`BOOKING_ALREADY_CANCELLED`	Уже отменено	Бронирование уже отменено ранее
`TICKETS_ISSUED`	Билеты выписаны	Используйте возврат билетов
`CANCELLATION_NOT_ALLOWED`	Отмена запрещена	Перевозчик не разрешает отмену
`INVALID_BOOKING_ID`	Некорректный ID	Проверьте формат bookingId
`ACCESS_DENIED`	Нет доступа	Проверьте авторизацию

Связанные операции#

Создание PNR - создание бронирования
Получение PNR - проверка статуса перед отменой
Возврат билета - возврат выписанных билетов

Структура ответа

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

Структура ответа#

Детальное описание структуры ответа от /avia/pnr_create.

Основная структура#

Ответ содержит идентификатор созданного бронирования и основные данные PNR.

Поле	Тип	Описание
`bookingId`	guid	Идентификатор созданного бронирования (формат UUID)
`pnrLocator`	string	Локатор PNR (код бронирования в GDS)
`pnrKey`	string	Ключ PNR (используется в Sirena)
`pnrOrderId`	string	Идентификатор заказа у поставщика
`supplier`	Supplier	Поставщик, через которого создано бронирование (см. Supplier)

Примеры ответов#

Успешный ответ#

1{
2 "bookingId": "019a0c82-5d2b-7a5e-84fe-56357a57df66",
3 "pnrLocator": "28C2D3",
4 "pnrOrderId": "69120-251022-OTT5447"
5}

Типичные ошибки#

Код ошибки	Причина	Решение
`OFFER_NOT_AVAILABLE`	Предложение недоступно	Выполните новый поиск
`INVALID_PASSENGER_DATA`	Некорректные данные пассажира	Проверьте формат данных
`SEARCH_EXPIRED`	Поиск устарел	Выполните новый поиск

Связанные операции#

Выписка билета - оформление билетов
Получение PNR - получение деталей бронирования
Отмена PNR - отмена бронирования

Структура ответа

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

Структура ответа#

Детальное описание структуры ответа от /avia/pnr_reprice.

Основная структура#

Ответ содержит актуальную тарификацию бронирования.

Поле	Тип	Описание
`pricings`	array	Массив тарификаций по типам пассажиров

Структура Pricing#

Поле	Тип	Описание
`paxType`	string	Тип пассажира (adt, chd, inf)
`price`	object	Ценовая информация
`segments`	array	Детали по сегментам
`fareType`	string	Тип тарифа (public, private, etc.)
`validatingCarrier`	string	Валидирующий перевозчик

Структура Price#

Поле	Тип	Описание
`total`	object	Полная стоимость
`baseFare`	object	Базовый тариф
`taxes`	object	Таксы и сборы

Структура Amount#

Поле	Тип	Описание
`currencyCode`	string	Код валюты (ISO 4217)
`value`	number	Сумма

Структура Taxes#

Поле	Тип	Описание
`total`	object	Общая сумма такс
`breakdown`	array	Детализация по кодам такс

Структура TaxBreakdown#

Поле	Тип	Описание
`code`	string	Код таксы/сбора
`amount`	object	Сумма

Структура Segment#

Поле	Тип	Описание
`segRefId`	string	Идентификатор сегмента из бронирования
`flight`	object	Информация о рейсе
`origin`	object	Пункт отправления
`destination`	object	Пункт прибытия
`fareBasis`	string	Код базового тарифа
`cabin`	string	Класс обслуживания
`class`	string	Код бронирования (RBD)
`baggageAllowance`	object	Норма багажа

Структура Flight#

Поле	Тип	Описание
`carrierCode`	string	Код перевозчика
`flightNumber`	string	Номер рейса

Структура Location (Origin/Destination)#

Поле	Тип	Описание
`location`	object	Информация о локации
`dateTime`	string	Дата и время (ISO 8601)

Структура Location.location#

Поле	Тип	Описание
`code`	string	Код аэропорта
`codeType`	string	Тип кода (iata, icao)
`type`	string	Тип локации (airport, city)

Структура BaggageAllowance#

Поле	Тип	Описание
`type`	string	Тип багажа (carryOn, checked)
`pieceAllowance`	object	Норма по количеству мест
`weightAllowance`	object	Норма по весу

Примеры ответов#

Успешный ответ#

 1{
 2 "pricings": [
 3 {
 4 "paxType": "adt",
 5 "price": {
 6 "baseFare": {
 7 "currencyCode": "RUB",
 8 "value": 8950
 9 },
10 "taxes": {
11 "total": {
12 "currencyCode": "RUB",
13 "value": 537
14 },
15 "breakdown": [
16 {
17 "code": "YR",
18 "amount": {
19 "currencyCode": "RUB",
20 "value": 120
21 }
22 },
23 {
24 "code": "RI",
25 "amount": {
26 "currencyCode": "RUB",
27 "value": 417
28 }
29 }
30 ]
31 },
32 "total": {
33 "currencyCode": "RUB",
34 "value": 9487
35 }
36 },
37 "segments": [
38 {
39 "baggageAllowance": {
40 "type": "carryOn",
41 "pieceAllowance": {
42 "totalPieces": 1
43 }
44 },
45 "cabin": "economy",
46 "class": "R",
47 "destination": {
48 "location": {
49 "code": "KZN",
50 "codeType": "iata",
51 "type": "airport"
52 },
53 "dateTime": "2025-11-21T23:40:00"
54 },
55 "fareBasis": "RCOR",
56 "flight": {
57 "carrierCode": "SU",
58 "flightNumber": "1278"
59 },
60 "origin": {
61 "location": {
62 "code": "SVO",
63 "codeType": "iata",
64 "type": "airport"
65 },
66 "dateTime": "2025-11-21T21:55:00"
67 },
68 "segRefId": "2c2dbf78-da30-46bd-9e18-a1f9f8e7fec7"
69 }
70 ],
71 "fareType": "public",
72 "validatingCarrier": "SU"
73 }
74 ]
75}

Бронирование с несколькими пассажирами#

 1{
 2 "pricings": [
 3 {
 4 "paxType": "adt",
 5 "price": {
 6 "total": {
 7 "currencyCode": "RUB",
 8 "value": 9487
 9 }
10 }
11 },
12 {
13 "paxType": "chd",
14 "price": {
15 "total": {
16 "currencyCode": "RUB",
17 "value": 7115
18 }
19 }
20 },
21 {
22 "paxType": "inf",
23 "price": {
24 "total": {
25 "currencyCode": "RUB",
26 "value": 949
27 }
28 }
29 }
30 ]
31}

Ответ с ошибкой#

1{
2 "error": {
3 "code": "BOOKING_NOT_FOUND",
4 "message": "Бронирование не найдено",
5 "description": "Бронирование с указанным ID не существует",
6 "errorId": "018c5f2e-9b3a-7f4d-8e2c-1a2b3c4d5e6f"
7 }
8}

Использование данных#

Расчет общей стоимости#

 1var repricing = await RepriceBooking(bookingId);
 2var booking = await RetrieveBooking(bookingId);
 3
 4var totalPrice = 0m;
 5
 6foreach (var pricing in repricing.Pricings)
 7{
 8 // Подсчитываем количество пассажиров этого типа
 9 var passengerCount = booking.Pnr.Passengers
10 .Count(p => p.Type == pricing.PaxType);
11
12 // Добавляем к общей сумме
13 totalPrice += pricing.Price.Total.Value * passengerCount;
14}
15
16Console.WriteLine($"Общая стоимость: {totalPrice} RUB");

Сравнение с исходной ценой#

 1var repricing = await RepriceBooking(bookingId);
 2var booking = await RetrieveBooking(bookingId);
 3
 4var originalPrice = booking.Pnr.FareInfo.Fares
 5 .Sum(f => f.Price.Total.Value);
 6
 7var actualPrice = repricing.Pricings
 8 .Sum(p => p.Price.Total.Value);
 9
10if (actualPrice > originalPrice)
11{
12 var increase = actualPrice - originalPrice;
13 Console.WriteLine($"Цена увеличилась на {increase} RUB");
14}
15else if (actualPrice < originalPrice)
16{
17 var decrease = originalPrice - actualPrice;
18 Console.WriteLine($"Цена уменьшилась на {decrease} RUB");
19}
20else
21{
22 Console.WriteLine("Цена не изменилась");
23}

детализация по таксам#

 1var pricing = repricing.Pricings[0];
 2
 3Console.WriteLine($"Базовый тариф: {pricing.Price.BaseFare.Value} {pricing.Price.BaseFare.CurrencyCode}");
 4Console.WriteLine("Таксы и сборы:");
 5
 6foreach (var tax in pricing.Price.Taxes.Breakdown)
 7{
 8 Console.WriteLine($" {tax.Code}: {tax.Amount.Value} {tax.Amount.CurrencyCode}");
 9}
10
11Console.WriteLine($"Итого таксы: {pricing.Price.Taxes.Total.Value} {pricing.Price.Taxes.Total.CurrencyCode}");
12Console.WriteLine($"ВСЕГО: {pricing.Price.Total.Value} {pricing.Price.Total.CurrencyCode}");

Проверка изменения тарифа#

 1var repricing = await RepriceBooking(bookingId);
 2var booking = await RetrieveBooking(bookingId);
 3
 4foreach (var pricing in repricing.Pricings)
 5{
 6 var originalFare = booking.Pnr.FareInfo.Fares
 7 .FirstOrDefault(f => f.PaxType == pricing.PaxType);
 8
 9 if (originalFare == null) continue;
10
11 foreach (var segment in pricing.Segments)
12 {
13 var originalSegment = originalFare.Itinerary
14 .FirstOrDefault(s => s.SegRefId == segment.SegRefId);
15
16 if (originalSegment?.FareBasis != segment.FareBasis)
17 {
18 Console.WriteLine($"Изменился код тарифа для сегмента {segment.SegRefId}:");
19 Console.WriteLine($" Было: {originalSegment?.FareBasis}");
20 Console.WriteLine($" Стало: {segment.FareBasis}");
21 }
22 }
23}

Формирование отчета об изменениях#

 1public class PriceChangeReport
 2{
 3 public string BookingId { get; set; }
 4 public decimal OriginalPrice { get; set; }
 5 public decimal ActualPrice { get; set; }
 6 public decimal Difference { get; set; }
 7 public List<PriceChangeDetail> Details { get; set; }
 8}
 9
10public async Task<PriceChangeReport> GeneratePriceChangeReport(string bookingId)
11{
12 var repricing = await RepriceBooking(bookingId);
13 var booking = await RetrieveBooking(bookingId);
14
15 var report = new PriceChangeReport
16 {
17 BookingId = bookingId,
18 Details = new List<PriceChangeDetail>()
19 };
20
21 foreach (var pricing in repricing.Pricings)
22 {
23 var originalFare = booking.Pnr.FareInfo.Fares
24 .FirstOrDefault(f => f.PaxType == pricing.PaxType);
25
26 if (originalFare != null)
27 {
28 var originalPrice = originalFare.Price.Total.Value;
29 var actualPrice = pricing.Price.Total.Value;
30
31 report.Details.Add(new PriceChangeDetail
32 {
33 PassengerType = pricing.PaxType,
34 OriginalPrice = originalPrice,
35 ActualPrice = actualPrice,
36 Difference = actualPrice - originalPrice
37 });
38
39 report.OriginalPrice += originalPrice;
40 report.ActualPrice += actualPrice;
41 }
42 }
43
44 report.Difference = report.ActualPrice - report.OriginalPrice;
45
46 return report;
47}

Уведомление пользователя об изменении#

 1public async Task NotifyPriceChangeIfNeeded(string bookingId)
 2{
 3 var repricing = await RepriceBooking(bookingId);
 4 var booking = await RetrieveBooking(bookingId);
 5
 6 var originalPrice = GetTotalPrice(booking);
 7 var actualPrice = GetTotalPrice(repricing);
 8
 9 if (actualPrice != originalPrice)
10 {
11 var difference = actualPrice - originalPrice;
12 var percentChange = (difference / originalPrice) * 100;
13
14 var message = difference > 0
15 ? $"Цена вашего бронирования {booking.Pnr.PnrLocator} увеличилась на {difference:F2} ₽ ({percentChange:F1}%)"
16 : $"Цена вашего бронирования {booking.Pnr.PnrLocator} уменьшилась на {Math.Abs(difference):F2} ₽ ({Math.Abs(percentChange):F1}%)";
17
18 await SendNotification(booking.UserId, message);
19 }
20}

Типичные ошибки#

Код ошибки	Причина	Решение
`BOOKING_NOT_FOUND`	Бронирование не найдено	Проверьте bookingId
`BOOKING_CANCELLED`	Бронирование отменено	Создайте новое
`REPRICING_NOT_AVAILABLE`	Пересчет стоимости недоступен	Используйте текущую цену
`INVALID_BOOKING_ID`	Некорректный ID	Проверьте формат

Связанные операции#

Создание PNR - создание бронирования
Получение PNR - получение исходной цены
Выписка билета - оформление билетов после проверки

Структура ответа

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

Структура ответа#

Детальное описание структуры ответа от /avia/pnr_retrieve.

Основная структура#

Ответ содержит полную информацию о бронировании.

Поле	Тип	Описание
`bookingId`	guid	Идентификатор бронирования (формат UUID)
`pnr`	object	Полная информация о PNR

Структура PNR#

Поле	Тип	Описание
`pnrLocator`	string	Локатор бронирования (код PNR)
`pnrKey`	string	Ключ PNR (используется в Sirena)
`pnrOrderId`	string	Идентификатор заказа у поставщика
`supplier`	Supplier	Поставщик (см. Supplier)
`cancelled`	boolean	Признак отмены бронирования
`groupBooking`	boolean	Признак группового бронирования
`bookData`	object	Данные о системе бронирования
`bookingRefs`	array	Ссылки на бронирования у перевозчиков
`passengers`	array	Список пассажиров
`itinerary`	array	Маршрут перевозки
`fareInfo`	object	Информация о тарифах и ценах
`contacts`	array	Контактные данные
`remarks`	array	Ремарки бронирования
`specialServices`	array	Специальные услуги (SSR)
`otherServices`	array	Прочие сервисы (OSI)
`emd`	array	Электронные документы (EMD)
`tickets`	array	Информация о билетах (если выписаны)

Структура BookData#

Поле	Тип	Описание
`crs`	string	Код системы бронирования
`bookDate`	datetime	Дата создания бронирования (ISO 8601)
`officeId`	string	Идентификатор офиса продаж

Структура BookingRef#

Поле	Тип	Описание
`bookingID`	string	Идентификатор бронирования у перевозчика
`carrier`	string	Код перевозчика
`bookingKey`	string	Ключ бронирования (record locator)
`leadPassenger`	string	Имя ведущего пассажира
`crs`	string	Система бронирования

Структура Passenger#

Поле	Тип	Описание
`id`	string	Идентификатор пассажира в бронировании
`lastName`	string	Фамилия
`firstName`	string	Имя
`middleName`	string	Отчество
`gender`	string	Пол (`male`, `female`)
`code`	string	Код типа пассажира (ADT, CHD, INF)
`type`	string	Тип пассажира (`adt`, `chd`, `inf`)
`title`	string	Обращение (MR, MRS, MS)
`documents`	Document[]	Документы пассажира

Структура Document#

Поле	Тип	Описание
`lastName`	string	Фамилия в документе
`firstName`	string	Имя в документе
`middleName`	string	Отчество в документе
`type`	DocumentType	Тип документа
`series`	string	Серия документа
`number`	string	Номер документа
`birthDate`	date	Дата рождения
`issueDate`	date	Дата выдачи
`expireDate`	date	Срок действия
`country`	string	Страна выдачи (ISO 3166-1 alpha-2)

Структура Contact#

Поле	Тип	Описание
`id`	string	Идентификатор контакта
`type`	string	Тип контакта (email, mobilePhone, etc.)
`value`	string	Значение контакта
`passengerId`	string	Ссылка на пассажира

Структура Itinerary#

Поле	Тип	Описание
`segments`	array	Сегменты перевозки
`duration`	string	Общая длительность (ISO 8601 duration)

Структура Segment#

Поле	Тип	Описание
`id`	string	Идентификатор сегмента
`marketingCarrier`	FlightDesignator	Маркетинговый перевозчик
`operatingCarrier`	FlightDesignator	Оперирующий перевозчик (при codeshare)
`origin`	BoardOffPoint	Пункт отправления
`destination`	BoardOffPoint	Пункт прибытия
`duration`	string	Длительность сегмента (ISO 8601)
`cabin`	CabinType	Класс обслуживания (`economy`, `premiumEconomy`, `business`, `first`)
`class`	string	Код бронирования (RBD)
`equipment`	string	Тип воздушного судна
`status`	string	Статус сегмента (HK, OK, WL, etc.)
`openSegment`	boolean	Признак открытого сегмента
`technicalStops`	number	Количество технических остановок
`technicalStopsDetails`	TechnicalStop[]	Детали технических остановок
`meal`	string	Питание на борту

Структура Location (Origin/Destination)#

Поле	Тип	Описание
`location`	object	Информация о локации
`dateTime`	string	Дата и время (ISO 8601)
`terminal`	string	Терминал

Структура Location.location#

Поле	Тип	Описание
`code`	string	Код аэропорта/города
`codeType`	string	Тип кода (iata, icao)
`type`	string	Тип локации (airport, city)

Структура FareInfo#

Поле	Тип	Описание
`fares`	Fare[]	Информация о тарифах по типам пассажиров
`timeLimit`	datetime	Срок действия бронирования (тайм-лимит на выписку)

Структура Fare#

Поле	Тип	Описание
`paxType`	string	Тип пассажира (adt, chd, inf)
`validatingCarrier`	string	Валидирующий перевозчик
`price`	object	Ценовая информация
`itinerary`	array	Детали тарифа по сегментам

Структура Price#

Поле	Тип	Описание
`total`	MonetaryAmount	Полная стоимость
`baseFare`	MonetaryAmount	Базовый тариф
`equivFare`	MonetaryAmount	Эквивалент тарифа (в валюте оплаты, если отличается)
`taxes`	Taxes	Таксы и сборы

Структура Amount#

Поле	Тип	Описание
`currencyCode`	string	Код валюты (ISO 4217)
`value`	number	Сумма

Структура Taxes#

Поле	Тип	Описание
`total`	object	Общая сумма такс
`breakdown`	array	Детализация по кодам такс

Структура TaxBreakdown#

Поле	Тип	Описание
`code`	string	Код таксы/сбора
`amount`	object	Сумма

Структура FareItinerary (SegmentDetails)#

Поле	Тип	Описание
`segRefId`	string	Ссылка на сегмент
`fareBasis`	string	Код базового тарифа
`tkDesignator`	string	Тикет-десигнатор
`baggage`	BaggageAllowance	Норма багажа

Структура Baggage#

Поле	Тип	Описание
`type`	string	Тип багажа (carryOn, checked)
`pieceAllowance`	object	Норма по количеству мест
`weightAllowance`	object	Норма по весу

Структура Ticket#

Поле	Тип	Описание
`number`	string	Номер билета
`lastNumber`	string	Последний номер билета в конъюнкции
`exchange`	string	Номер билета, на который обменян текущий
`original`	string	Номер оригинального билета (до обмена)
`issueDate`	datetime	Дата выписки (ISO 8601)
`paxRefId`	string	Ссылка на пассажира
`segRefId`	string[]	Ссылки на сегменты
`vendor`	string	Код BSP/ARC

Примеры ответов#

Успешный ответ#

Развернуть полный пример

 1{
 2 "bookingId": "019a0c82-5d2b-7a5e-84fe-56357a57df66",
 3 "pnr": {
 4 "bookData": {
 5 "crs": "1H",
 6 "officeId": "TCH"
 7 },
 8 "bookingRefs": [
 9 {
 10 "bookingID": "28C2D3",
 11 "carrier": "15"
 12 },
 13 {
 14 "bookingID": "0D1MD9",
 15 "carrier": "DP"
 16 }
 17 ],
 18 "cancelled": false,
 19 "contacts": [
 20 {
 21 "id": "Contact-1",
 22 "type": "mobilePhone",
 23 "value": "+79623387344",
 24 "passengerId": "Pax-1"
 25 },
 26 {
 27 "id": "Contact-1",
 28 "type": "email",
 29 "value": "test.user+1761146456225@example.com",
 30 "passengerId": "Pax-1"
 31 }
 32 ],
 33 "fareInfo": {
 34 "fares": [
 35 {
 36 "paxType": "adt",
 37 "price": {
 38 "total": {
 39 "currencyCode": "RUB",
 40 "value": 7949
 41 },
 42 "baseFare": {
 43 "currencyCode": "RUB",
 44 "value": 2849
 45 },
 46 "taxes": {
 47 "total": {
 48 "currencyCode": "RUB",
 49 "value": 5100
 50 },
 51 "breakdown": [
 52 {
 53 "code": "CP",
 54 "amount": {
 55 "currencyCode": "RUB",
 56 "value": 5000
 57 }
 58 },
 59 {
 60 "code": "YR",
 61 "amount": {
 62 "currencyCode": "RUB",
 63 "value": 100
 64 }
 65 }
 66 ]
 67 }
 68 },
 69 "validatingCarrier": "DP",
 70 "itinerary": [
 71 {
 72 "segRefId": "0593d1c1-6ed6-417c-9247-435850993dda",
 73 "fareBasis": "PAD",
 74 "baggage": {
 75 "type": "carryOn",
 76 "pieceAllowance": {
 77 "totalPieces": 1
 78 }
 79 }
 80 }
 81 ]
 82 }
 83 ]
 84 },
 85 "groupBooking": false,
 86 "itinerary": [
 87 {
 88 "segments": [
 89 {
 90 "id": "0593d1c1-6ed6-417c-9247-435850993dda",
 91 "cabin": "economy",
 92 "class": "P",
 93 "destination": {
 94 "location": {
 95 "code": "KZN",
 96 "codeType": "iata",
 97 "type": "airport"
 98 },
 99 "dateTime": "2025-11-22T09:20:00",
100 "terminal": "1"
101 },
102 "duration": "01:40:00",
103 "equipment": "73H",
104 "marketingCarrier": {
105 "carrierCode": "DP",
106 "flightNumber": "6841"
107 },
108 "openSegment": false,
109 "origin": {
110 "location": {
111 "code": "SVO",
112 "codeType": "iata",
113 "type": "airport"
114 },
115 "dateTime": "2025-11-22T07:40:00",
116 "terminal": "D"
117 },
118 "status": "HK",
119 "technicalStops": 0
120 }
121 ],
122 "duration": "01:40:00"
123 }
124 ],
125 "passengers": [
126 {
127 "id": "Pax-1",
128 "lastName": "IVANOV",
129 "firstName": "SVETLANA",
130 "gender": "female",
131 "documents": [
132 {
133 "lastName": "IVANOV",
134 "firstName": "SVETLANA",
135 "type": "internationalPassport",
136 "number": "411649833",
137 "birthDate": "1981-07-12",
138 "issueDate": "2008-08-16",
139 "expireDate": "2026-10-22",
140 "country": "RU"
141 }
142 ],
143 "code": "ADT",
144 "type": "adt"
145 }
146 ],
147 "pnrLocator": "28C2D3",
148 "pnrOrderId": "69120-251022-OTT5447|69120-251022-MTT5446",
149 "tickets": [
150 {
151 "exchange": "6170037265",
152 "issueDate": "2025-10-22T00:00:00",
153 "number": "6170037281",
154 "paxRefId": "Pax-1",
155 "segRefId": ["0593d1c1-6ed6-417c-9247-435850993dda"],
156 "vendor": "425"
157 }
158 ]
159 }
160}

Бронирование без билетов#

Если билеты еще не выписаны, массив tickets будет пустым:

Структура ответа

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

Структура ответа#

Детальное описание структуры ответа от /avia/fare_rules.

Основная структура#

Ответ содержит массив правил для запрошенного предложения.

Поле	Тип	Описание
`rules`	array	Массив правил тарифа

Структура Rule#

Каждый элемент массива rules содержит:

Поле	Тип	Описание
`fareBasis`	string	Код базового тарифа
`ticketDesignator`	string	Дескриптор билета
`categories`	array	Массив категорий правил

Структура RuleCategory#

Каждая категория содержит:

Поле	Тип	Описание
`category`	string	Номер категории (от 0 до 33)
`caption`	string	Название категории на русском языке
`text`	string	Детальное описание правил категории

Примеры ответов#

Успешный ответ#

 1{
 2 "rules": [
 3 {
 4 "fareBasis": "ILTOW",
 5 "categories": [
 6 {
 7 "category": "0",
 8 "caption": "Применение",
 9 "text": "НАЗВАНИЕ УПТ - ТАРИФЫ ГРУППЫ SMART LIGHT\nДАННЫЕ ТАРИФЫ ПРИМЕНЯЮТСЯ ДЛЯ ЭКОНОМИЧЕСКОГО КЛАССА ОБСЛУЖИВАНИЯ..."
10 },
11 {
12 "category": "5",
13 "caption": "Бронирование и оформление билета",
14 "text": "Бронирование разрешается не позднее чем за 7 сут до отправления воздушного судна..."
15 },
16 {
17 "category": "16",
18 "caption": "Сборы при расторжении договора",
19 "text": "ДОБРОВОЛЬНОЕ ИЗМЕНЕНИЕ УСЛОВИЙ ДОГОВОРА ПЕРЕВОЗКИ РАЗРЕШАЕТСЯ..."
20 }
21 ]
22 }
23 ]
24}

Структура с несколькими базовыми тарифами#

Если предложение содержит несколько участков с разными тарифами:

Структура ответа

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

Структура ответа#

Детальное описание структуры ответа от /avia/offer_price.

Основная структура#

Ответ содержит актуальную информацию о запрошенном предложении.

Поле	Тип	Описание
`error`	Error	Информация об ошибке (при наличии)
`searchId`	string	Новый идентификатор поиска
`offers`	array	Массив с одним предложением
`flights`	object	Словарь с информацией о рейсах
`fareFamilies`	object	Словарь с информацией о тарифных семействах

Структура Offer#

Поле	Тип	Описание
`offerId`	string	Идентификатор предложения
`legs`	array	Маршрутные плечи
`offerItems`	array	Варианты тарифа для предложения
`ticketingRequirements`	object	Требования к выписке билетов
`validatingCarrier`	string	Валидирующий перевозчик

Структура Leg#

Поле	Тип	Описание
`segments`	array	Сегменты маршрута

Структура Segment#

Поле	Тип	Описание
`segmentId`	string	Идентификатор сегмента
`flightId`	string	Ссылка на рейс в словаре flights

Структура OfferItem#

Поле	Тип	Описание
`offerItemId`	string	Идентификатор варианта тарифа
`totalAmount`	object	Полная стоимость
`fareAmount`	object	Стоимость тарифа
`taxAmount`	object	Сумма такс и сборов
`details`	object	Детали по типам пассажиров
`miniRules`	MiniRule[]	Правила изменения, отмены и возврата билетов (см. MiniRule)
`timeLimit`	string	Срок оплаты (ISO 8601)
`offerExpiration`	string	Срок действия предложения (ISO 8601)
`supplier`	Supplier	Код поставщика
`ticketingFee`	TicketingFee	Сбор за оформление билета (см. TicketingFee)

Структура Details#

Объект с ключами по типам пассажиров (adt, chd, inf):

Структура ответа

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

Структура ответа#

Детальное описание структуры ответа от /avia/search.

Основная структура#

Поле	Тип	Обязательно	Описание
`error`	Error	Нет	Информация об ошибке (при наличии)
`searchId`	string	Да	Идентификатор поиска для последующих операций
`offers`	Offer[]	Нет	Список доступных предложений
`flights`	map<string, FlightInfo>	Нет	Словарь с деталями рейсов (ключ — flightId)
`fareFamilies`	map<string, FareFamily>	Нет	Словарь тарифных семейств (ключ — fareFamilyRefId)

Структура Offer#

Каждое предложение в массиве offers:

Поле	Тип	Обязательно	Описание
`offerId`	string	Да	Идентификатор предложения
`legs`	Leg[]	Да	Сегменты маршрута
`offerItems`	OfferItem[]	Да	Варианты цен для разных тарифов
`validatingCarrier`	string	Да	Код авиакомпании-валидатора (IATA)
`ticketingRequirements`	TicketingRequirements	Да	Требования к выписке билета

Структура Leg#

Каждый сегмент маршрута в legs:

Структура ответа

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

Структура ответа#

Детальное описание структуры ответа для запроса /avia/ticket_cancel.

Успешный ответ#

При успешном войдировании билета API возвращает пустой объект:

1{}

Пустой ответ с HTTP статусом 200 OK означает, что операция выполнена успешно.

Типичные ошибки#

Код ошибки	Причина	Решение
`VOID_TIME_EXPIRED`	Истекло время для войдирования	Используйте возврат билета
`TICKET_NOT_FOUND`	Билет не найден	Проверьте номер билета и bookingId
`TICKET_USED`	Билет уже использован	Войдирование невозможно
`INVALID_TICKET_STATE`	Недопустимое состояние билета	Проверьте статус билета
`BOOKING_NOT_FOUND`	Бронирование не найдено	Проверьте bookingId
`ACCESS_DENIED`	Недостаточно прав	Проверьте права доступа

Структура ответа

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

Структура ответа#

Детальное описание структуры ответа от /avia/ticket_exchange_calculation.

Успешный ответ#

При успешном расчете API возвращает HTTP 200 и объект с вариантами обмена.

Основная структура#

Поле	Тип	Описание
`exchangeId`	string	Уникальный идентификатор расчета обмена
`offers`	Offer[]	Массив доступных вариантов обмена
`flights`	Dictionary<string, Flight>	Словарь с детальной информацией о рейсах
`fareFamilies`	Dictionary<string, FareFamily>	Информация о тарифных семействах
`passenger`	string	Тип пассажира (`adt`, `chd`, `inf`)

Структура Offer#

Каждый вариант обмена содержит:

Поле	Тип	Описание
`legs`	Leg[]	Массив маршрутов
`offerItems`	OfferItem[]	Массив вариантов цен
`validatingCarrier`	string	IATA код валидирующего перевозчика

Структура Leg#

Поле	Тип	Описание
`segments`	Segment[]	Массив сегментов маршрута
`duration`	string	Общая продолжительность маршрута (формат: `HH:MM:SS`)

Структура Segment#

Поле	Тип	Описание
`key`	string	Уникальный ключ сегмента
`flightKey`	string	Ключ рейса для поиска в словаре `flights`
`technicalStops`	integer	Количество технических остановок
`technicalStopsDetails`	TechnicalStop[]	Детали технических остановок

Структура OfferItem#

Детальная информация о ценах и условиях обмена:

Структура ответа

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

Структура ответа#

Детальное описание структуры ответа от /avia/ticket_exchange.

Успешный ответ#

При успешном обмене API возвращает HTTP 200 и объект с новыми билетами.

Основная структура#

Поле	Тип	Описание
`tickets`	Ticket[]	Массив новых выписанных билетов

Структура Ticket#

Каждый билет содержит:

Поле	Тип	Описание
`id`	string	Идентификатор билета
`number`	string	Номер билета (без префикса vendor)
`vendor`	string	Код BSP/ARC (префикс билета, например: “425”)
`passenger`	TicketPassenger	Информация о пассажире

Структура TicketPassenger#

Поле	Тип	Описание
`id`	string	Идентификатор пассажира в бронировании
`firstName`	string	Имя пассажира
`lastName`	string	Фамилия пассажира
`middleName`	string	Отчество пассажира
`type`	string	Тип пассажира (`adt`, `chd`, `inf`)
`title`	string	Обращение (MR, MRS, MS и т.д.)

Примеры ответов#

Успешный обмен одного пассажира#

 1{
 2 "tickets": [
 3 {
 4 "id": "ticket-id-1",
 5 "number": "6170037302",
 6 "vendor": "425",
 7 "passenger": {
 8 "id": "Pax-1",
 9 "firstName": "IVAN",
10 "lastName": "KOZLOV",
11 "middleName": "PETROVICH",
12 "type": "adt",
13 "title": "MR"
14 }
15 },
16 {
17 "id": "ticket-id-2",
18 "number": "6160004938",
19 "vendor": "425",
20 "passenger": {
21 "id": "Pax-1",
22 "firstName": "IVAN",
23 "lastName": "KOZLOV",
24 "middleName": "PETROVICH",
25 "type": "adt",
26 "title": "MR"
27 }
28 }
29 ]
30}

Обмен с несколькими пассажирами#

 1{
 2 "tickets": [
 3 {
 4 "id": "ticket-id-1",
 5 "number": "6170037302",
 6 "vendor": "425",
 7 "passenger": {
 8 "id": "Pax-1",
 9 "firstName": "IVAN",
10 "lastName": "KOZLOV",
11 "middleName": "PETROVICH",
12 "type": "adt",
13 "title": "MR"
14 }
15 },
16 {
17 "id": "ticket-id-2",
18 "number": "6170037303",
19 "vendor": "425",
20 "passenger": {
21 "id": "Pax-2",
22 "firstName": "MARIA",
23 "lastName": "KOZLOVA",
24 "middleName": "IVANOVNA",
25 "type": "adt",
26 "title": "MRS"
27 }
28 },
29 {
30 "id": "ticket-id-3",
31 "number": "6170037304",
32 "vendor": "425",
33 "passenger": {
34 "id": "Pax-3",
35 "firstName": "ANNA",
36 "lastName": "KOZLOVA",
37 "middleName": "IVANOVNA",
38 "type": "chd",
39 "title": "MISS"
40 }
41 }
42 ]
43}

Типичные ошибки#

Код ошибки	Причина	Решение
`TICKET_NOT_FOUND`	Билет не найден	Проверьте номер билета и bookingId
`EXCHANGE_NOT_ALLOWED`	Обмен запрещен тарифом	Обмен невозможен по правилам тарифа
`INSUFFICIENT_BALANCE`	Недостаточно средств	Пополните баланс на сумму обмена
`INVALID_EXCHANGE_DATA`	Неверные данные обмена	Проверьте exchangeId и offerItemId из расчета
`OFFER_EXPIRED`	Предложение истекло	Выполните новый расчет обмена

Связанные операции#

Расчёт обмена - получение вариантов и стоимости обмена
Информация о билете - проверка статуса билета
Расчёт возврата - альтернатива обмену

Структура ответа

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

Структура ответа#

Детальное описание структуры ответа от /avia/ticket_info.

Основная структура#

Ответ содержит полный документ билета.

Поле	Тип	Описание
`error`	Error	Информация об ошибке (при наличии)
`ticketDocument`	object	Полная информация о билете
`ticketingFee`	TicketingFee	Сбор за оформление билета, загруженный из бронирования (см. TicketingFee)

Структура TicketDocument#

Поле	Тип	Описание
`ticket`	object	Информация о билете
`passenger`	object	Данные пассажира
`coupons`	array	Купоны (сегменты) билета
`price`	object	Ценовая информация
`issueData`	object	Данные о выписке
`payment`	object	Информация об оплате
`fareCalculation`	string	Строка расчета тарифа
`endorsements`	string	Ограничения и условия
`agency`	object	Информация об агентстве

Структура Ticket#

Поле	Тип	Описание
`number`	string	Номер билета
`vendor`	string	Код BSP/ARC
`exchange`	string	Номер обмененного билета (если применимо)
`lastNumber`	string	Последний номер билета в conjunction
`original`	string	Оригинальный номер билета

Структура Passenger#

Поле	Тип	Описание
`id`	string	Идентификатор пассажира
`firstName`	string	Имя
`lastName`	string	Фамилия
`type`	string	Тип пассажира (adt, chd, inf)
`title`	string	Обращение (MR, MRS, MS и т.д.)
`document`	object	Документ пассажира
`bonusCard`	object	Карта программы лояльности

Структура Document#

Поле	Тип	Описание
`number`	string	Номер документа

Структура BonusCard#

Поле	Тип	Описание
`number`	string	Номер бонусной карты
`vendor`	string	Код авиакомпании

Структура Coupon#

Поле	Тип	Описание
`flight`	object	Информация о рейсе
`operatedBy`	object	Оперирующий перевозчик
`departure`	object	Пункт отправления
`arrival`	object	Пункт прибытия
`duration`	string	Длительность сегмента (ISO 8601)
`fareBasis`	string	Код базового тарифа
`class`	string	Код бронирования (RBD)
`cabinClass`	string	Класс салона
`baggage`	string	Норма багажа
`meal`	string	Питание на борту
`seat`	string	Номер места
`segmentStatus`	string	Статус сегмента
`ticketDesignator`	string	Дескриптор билета
`notValidBefore`	string	Не действителен до (ISO 8601)
`notValidAfter`	string	Не действителен после (ISO 8601)
`technicalStops`	number	Количество технических остановок
`technicalStopsDetails`	array	Детали технических остановок

Структура Flight / OperatedBy#

Поле	Тип	Описание
`carrierCode`	string	Код перевозчика
`flightNumber`	string	Номер рейса

Структура Departure / Arrival#

Поле	Тип	Описание
`airport`	string	Код аэропорта (IATA)
`date`	string	Дата и время (ISO 8601)
`terminal`	string	Терминал

Структура Price#

Поле	Тип	Описание
`baseFare`	object	Базовый тариф
`baseFareIndicator`	string	Индикатор базового тарифа
`equivFare`	object	Эквивалент тарифа в другой валюте
`penalty`	object	Сумма штрафа
`taxes`	array	Таксы и сборы
`total`	object	Общая сумма такс
`totalIndicator`	string	Индикатор итоговой суммы
`vat`	object	НДС

Структура Amount#

Поле	Тип	Описание
`currencyCode`	string	Код валюты (ISO 4217)
`value`	number	Сумма

Структура Tax#

Поле	Тип	Описание
`code`	string	Код таксы/сбора
`amount`	object	Сумма

Структура IssueData#

Поле	Тип	Описание
`office`	string	Код офиса продаж
`issueDate`	string	Дата выписки (ISO 8601)
`owningCRS`	string	Код системы бронирования
`recordLocator`	string	Локатор бронирования
`recordKey`	string	Ключ PNR (используется в Сирене)
`vendorLocators`	array	Локаторы у перевозчиков

Структура VendorLocator#

Поле	Тип	Описание
`recordLocator`	string	Локатор у перевозчика
`vendor`	string	Код перевозчика

Структура Payment#

Поле	Тип	Описание
`type`	string	Тип оплаты (invoice, card, etc.)
`bankCard`	BankCard	Данные банковской карты (при оплате картой)
`tourCode`	string	Туркод

Структура BankCard#

Поле	Тип	Описание
`number`	string	Номер карты
`vendor`	string	Тип карты (VI, MC, AX и т.д.)
`expireDate`	string	Срок действия карты (формат MMYY)

Примеры ответов#

Успешный ответ#

Развернуть полный пример

 1{
 2 "ticketDocument": {
 3 "agency": {},
 4 "coupons": [
 5 {
 6 "arrival": {
 7 "airport": "KZN",
 8 "date": "2025-11-22T09:20:00",
 9 "terminal": "1"
10 },
11 "baggage": "1PC",
12 "cabinClass": "Y",
13 "class": "P",
14 "departure": {
15 "airport": "SVO",
16 "date": "2025-11-22T07:40:00",
17 "terminal": "D"
18 },
19 "duration": "01:40:00",
20 "fareBasis": "PAD",
21 "flight": {
22 "carrierCode": "DP",
23 "flightNumber": "6841"
24 },
25 "operatedBy": {
26 "carrierCode": "DP",
27 "flightNumber": "6841"
28 },
29 "technicalStops": 0
30 }
31 ],
32 "endorsements": "НДСА/К275.67/БАГАЖ 1М ДО 10КГ 203СМ,ВЕЩИ В САЛОН (СУММАРНО) ГАБАРИТЫ НЕ ДОЛЖНЫ ПРЕВЫШАТЬ 36X30X27СМ ",
33 "fareCalculation": "MOW DP KZN2849RUB2849END",
34 "issueData": {
35 "office": "TCH",
36 "issueDate": "2025-10-22T19:22:00",
37 "owningCRS": "1H",
38 "recordLocator": "28C2D3",
39 "vendorLocators": [
40 {
41 "recordLocator": "28C2D3",
42 "vendor": "15"
43 },
44 {
45 "recordLocator": "0D1MD9",
46 "vendor": "DP"
47 }
48 ]
49 },
50 "passenger": {
51 "id": "Pax-1",
52 "document": {
53 "number": "411649833"
54 },
55 "firstName": "SVETLANA",
56 "lastName": "IVANOV",
57 "type": "adt"
58 },
59 "payment": {
60 "type": "invoice"
61 },
62 "price": {
63 "baseFare": {
64 "currencyCode": "RUB",
65 "value": 2849
66 },
67 "taxes": [
68 {
69 "code": "YR",
70 "amount": {
71 "currencyCode": "RUB",
72 "value": 100
73 }
74 }
75 ],
76 "total": {
77 "currencyCode": "RUB",
78 "value": 100
79 },
80 "vat": {
81 "currencyCode": "RUB",
82 "value": 275.67
83 }
84 },
85 "ticket": {
86 "exchange": "6170037265",
87 "number": "6170037281",
88 "vendor": "425"
89 }
90 }
91}

Типичные ошибки#

Код ошибки	Причина	Решение
`TICKET_NOT_FOUND`	Билет не найден	Проверьте номер
`BOOKING_NOT_FOUND`	Бронирование не найдено	Проверьте bookingId
`INVALID_TICKET_NUMBER`	Некорректный формат	Проверьте формат
`ACCESS_DENIED`	Нет доступа	Проверьте права

Связанные операции#

Выписка билета - оформление билетов
Получение PNR - получение номеров билетов
Обмен билета - изменение билета
Возврат билета - возврат билета

Структура ответа

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

Структура ответа#

Детальное описание структуры ответа от /avia/ticket_issue.

Основная структура#

Ответ содержит список выписанных билетов.

Поле	Тип	Описание
`tickets`	array	Массив выписанных билетов

Структура Ticket#

Поле	Тип	Описание
`id`	string	Идентификатор билета
`number`	string	Номер билета
`vendor`	string	Код BSP/ARC
`passenger`	object	Информация о пассажире

Структура Passenger#

Поле	Тип	Описание
`id`	string	Идентификатор пассажира из бронирования
`firstName`	string	Имя пассажира
`lastName`	string	Фамилия пассажира
`middleName`	string	Отчество пассажира
`type`	string	Тип пассажира (adt, chd, inf)
`title`	string	Обращение (MR, MRS, MS и т.д.)

Примеры ответов#

Успешная выписка для одного пассажира#

 1{
 2 "tickets": [
 3 {
 4 "number": "2469982473",
 5 "vendor": "555",
 6 "passenger": {
 7 "id": "PAX_12",
 8 "firstName": "IVAN",
 9 "lastName": "EGOROV",
10 "type": "adt"
11 }
12 }
13 ]
14}

Выписка для нескольких пассажиров#

 1{
 2 "tickets": [
 3 {
 4 "number": "2469982473",
 5 "vendor": "555",
 6 "passenger": {
 7 "id": "PAX_1",
 8 "firstName": "IVAN",
 9 "lastName": "EGOROV",
10 "type": "adt"
11 }
12 },
13 {
14 "number": "2469982474",
15 "vendor": "555",
16 "passenger": {
17 "id": "PAX_2",
18 "firstName": "MARIA",
19 "lastName": "EGOROVA",
20 "type": "adt"
21 }
22 },
23 {
24 "number": "2469982475",
25 "vendor": "555",
26 "passenger": {
27 "id": "PAX_3",
28 "firstName": "PETR",
29 "lastName": "EGOROV",
30 "type": "chd"
31 }
32 }
33 ]
34}

Ответ с ошибкой - бронирование не найдено#

1{
2 "error": {
3 "code": "BOOKING_NOT_FOUND",
4 "message": "Бронирование не найдено",
5 "description": "Бронирование с указанным ID не существует",
6 "errorId": "018c5f2e-9b3a-7f4d-8e2c-1a2b3c4d5e6f"
7 }
8}

Ответ с ошибкой - билеты уже выписаны#

1{
2 "error": {
3 "code": "TICKETS_ALREADY_ISSUED",
4 "message": "Билеты уже выписаны",
5 "description": "Для данного бронирования билеты уже были выписаны ранее",
6 "errorId": "018c5f2e-9b3a-7f4d-8e2c-1a2b3c4d5e6f"
7 }
8}

Ответ с ошибкой - цена изменилась#

1{
2 "error": {
3 "code": "PRICE_CHANGED",
4 "message": "Цена изменилась",
5 "description": "Стоимость бронирования изменилась. Требуется подтверждение новой цены",
6 "errorId": "018c5f2e-9b3a-7f4d-8e2c-1a2b3c4d5e6f"
7 }
8}

Использование данных#

Получение номеров билетов#

 1var response = await IssueTicket(bookingId, "invoice");
 2
 3Console.WriteLine("Билеты успешно выписаны:");
 4
 5foreach (var ticket in response.Tickets)
 6{
 7 Console.WriteLine($"Билет: {ticket.Number}");
 8 Console.WriteLine($"Пассажир: {ticket.Passenger.LastName} {ticket.Passenger.FirstName}");
 9 Console.WriteLine($"Тип: {ticket.Passenger.Type.ToUpper()}");
10 Console.WriteLine($"Vendor: {ticket.Vendor}");
11 Console.WriteLine();
12}

Сохранение билетов в базу данных#

 1public async Task SaveTicketsToDatabase(string bookingId, TicketIssueResponse response)
 2{
 3 foreach (var ticket in response.Tickets)
 4 {
 5 await _database.Tickets.InsertAsync(new TicketEntity
 6 {
 7 BookingId = bookingId,
 8 TicketNumber = ticket.Number,
 9 Vendor = ticket.Vendor,
10 PassengerId = ticket.Passenger.Id,
11 PassengerFirstName = ticket.Passenger.FirstName,
12 PassengerLastName = ticket.Passenger.LastName,
13 PassengerType = ticket.Passenger.Type,
14 IssuedAt = DateTime.UtcNow
15 });
16 }
17
18 await _database.SaveChangesAsync();
19
20 LogInfo($"Saved {response.Tickets.Count} tickets for booking {bookingId}");
21}

Отправка билетов пассажирам#

 1public async Task SendTicketsToPassengers(
 2 string bookingId,
 3 TicketIssueResponse ticketResponse)
 4{
 5 // Получаем полную информацию о бронировании
 6 var booking = await RetrieveBooking(bookingId);
 7
 8 // Группируем билеты по пассажирам
 9 var ticketsByPassenger = ticketResponse.Tickets
10 .GroupBy(t => t.Passenger.Id)
11 .ToList();
12
13 foreach (var group in ticketsByPassenger)
14 {
15 var passengerId = group.Key;
16 var passengerTickets = group.ToList();
17
18 // Находим контакты пассажира
19 var email = booking.Pnr.Contacts
20 .FirstOrDefault(c => c.PassengerId == passengerId && c.Type == "email")?.Value;
21
22 if (!string.IsNullOrEmpty(email))
23 {
24 await SendTicketEmail(email, booking, passengerTickets);
25 LogInfo($"Tickets sent to {email}");
26 }
27 else
28 {
29 LogWarning($"No email for passenger {passengerId}");
30 }
31 }
32}

Формирование списка для отображения#

 1public class TicketDisplayModel
 2{
 3 public string TicketNumber { get; set; }
 4 public string PassengerName { get; set; }
 5 public string PassengerType { get; set; }
 6 public string Route { get; set; }
 7 public string DepartureDate { get; set; }
 8}
 9
10public async Task<List<TicketDisplayModel>> GetTicketDisplayModels(
11 string bookingId,
12 TicketIssueResponse ticketResponse)
13{
14 var booking = await RetrieveBooking(bookingId);
15 var result = new List<TicketDisplayModel>();
16
17 foreach (var ticket in ticketResponse.Tickets)
18 {
19 var route = GetRouteDescription(booking.Pnr.Itinerary);
20 var departureDate = booking.Pnr.Itinerary[0].Segments[0].Origin.DateTime;
21
22 result.Add(new TicketDisplayModel
23 {
24 TicketNumber = ticket.Number,
25 PassengerName = $"{ticket.Passenger.LastName} {ticket.Passenger.FirstName}",
26 PassengerType = GetPassengerTypeDescription(ticket.Passenger.Type),
27 Route = route,
28 DepartureDate = departureDate
29 });
30 }
31
32 return result;
33}
34
35private string GetPassengerTypeDescription(string type)
36{
37 return type switch
38 {
39 "adt" => "Взрослый",
40 "chd" => "Ребенок",
41 "inf" => "Младенец",
42 _ => type.ToUpper()
43 };
44}

Проверка выписки#

 1public async Task<bool> VerifyTicketIssue(
 2 string bookingId,
 3 TicketIssueResponse ticketResponse)
 4{
 5 // Получаем обновленное бронирование
 6 var booking = await RetrieveBooking(bookingId);
 7
 8 // Проверяем количество билетов
 9 var expectedTicketCount = booking.Pnr.Passengers.Count;
10 var actualTicketCount = ticketResponse.Tickets.Count;
11
12 if (expectedTicketCount != actualTicketCount)
13 {
14 LogError($"Ticket count mismatch: expected {expectedTicketCount}, got {actualTicketCount}");
15 return false;
16 }
17
18 // Проверяем, что билеты появились в бронировании
19 if (booking.Pnr.Tickets.Count == 0)
20 {
21 LogError("Tickets not found in booking after issue");
22 return false;
23 }
24
25 // Проверяем соответствие номеров
26 var responseNumbers = ticketResponse.Tickets
27 .Select(t => t.Number)
28 .OrderBy(n => n)
29 .ToList();
30
31 var bookingNumbers = booking.Pnr.Tickets
32 .Select(t => t.Number)
33 .OrderBy(n => n)
34 .ToList();
35
36 if (!responseNumbers.SequenceEqual(bookingNumbers))
37 {
38 LogError("Ticket numbers mismatch between response and booking");
39 return false;
40 }
41
42 LogInfo($"Ticket issue verified for booking {bookingId}");
43 return true;
44}

Генерация отчета о выписке#

 1public class TicketIssueReport
 2{
 3 public string BookingId { get; set; }
 4 public string PnrLocator { get; set; }
 5 public DateTime IssuedAt { get; set; }
 6 public List<TicketInfo> Tickets { get; set; }
 7 public decimal TotalAmount { get; set; }
 8 public string PaymentType { get; set; }
 9}
10
11public async Task<TicketIssueReport> GenerateTicketIssueReport(
12 string bookingId,
13 TicketIssueResponse ticketResponse,
14 string paymentType)
15{
16 var booking = await RetrieveBooking(bookingId);
17
18 var report = new TicketIssueReport
19 {
20 BookingId = bookingId,
21 PnrLocator = booking.Pnr.PnrLocator,
22 IssuedAt = DateTime.UtcNow,
23 PaymentType = paymentType,
24 Tickets = new List<TicketInfo>()
25 };
26
27 foreach (var ticket in ticketResponse.Tickets)
28 {
29 var fare = booking.Pnr.FareInfo.Fares
30 .FirstOrDefault(f => f.PaxType == ticket.Passenger.Type);
31
32 report.Tickets.Add(new TicketInfo
33 {
34 Number = ticket.Number,
35 Vendor = ticket.Vendor,
36 PassengerName = $"{ticket.Passenger.LastName} {ticket.Passenger.FirstName}",
37 PassengerType = ticket.Passenger.Type,
38 Amount = fare?.Price.Total.Value ?? 0
39 });
40
41 report.TotalAmount += fare?.Price.Total.Value ?? 0;
42 }
43
44 return report;
45}

Типичные ошибки#

Код ошибки	HTTP статус	Причина	Решение
`BOOKING_NOT_FOUND`	404	Бронирование не найдено	Проверьте bookingId
`BOOKING_CANCELLED`	400	Бронирование отменено	Создайте новое бронирование
`TICKETS_ALREADY_ISSUED`	400	Билеты уже выписаны	Используйте существующие
`PAYMENT_REQUIRED`	400	Требуется оплата	Подтвердите оплату
`PRICE_CHANGED`	400	Цена изменилась	Проверьте новую цену
`TIME_LIMIT_EXPIRED`	400	Истек срок выписки	Создайте новое бронирование
`INVALID_PASSENGER_DATA`	400	Некорректные данные	Исправьте данные
`INVALID_PAYMENT_TYPE`	400	Некорректный тип оплаты	Проверьте тип оплаты

Обработка ответа#

Успешная выписка#

 1var response = await httpClient.PostAsJsonAsync(
 2 "https://test.travel-api.ru/avia/ticket_issue",
 3 new { bookingId, payment = new { type = "invoice" } }
 4);
 5
 6if (response.IsSuccessStatusCode)
 7{
 8 var result = await response.Content
 9 .ReadFromJsonAsync<TicketIssueResponse>();
10
11 Console.WriteLine($"Выписано билетов: {result.Tickets.Count}");
12
13 // Сохраняем билеты
14 await SaveTickets(bookingId, result.Tickets);
15
16 // Отправляем пассажирам
17 await SendTicketsToPassengers(bookingId, result);
18
19 // Обновляем статус
20 await UpdateBookingStatus(bookingId, "ticketed");
21}

Обработка ошибок с повторной попыткой#

 1public async Task<TicketIssueResponse> IssueTicketWithRetry(
 2 string bookingId,
 3 string paymentType,
 4 int maxRetries = 3)
 5{
 6 for (int attempt = 1; attempt <= maxRetries; attempt++)
 7 {
 8 try
 9 {
10 var response = await IssueTicket(bookingId, paymentType);
11 return response;
12 }
13 catch (ApiException ex) when (ex.Code == "PRICE_CHANGED")
14 {
15 if (attempt == maxRetries)
16 {
17 throw;
18 }
19
20 LogInfo($"Price changed on attempt {attempt}, retrying...");
21
22 // Получаем новую цену и подтверждаем
23 var repricing = await RepriceBooking(bookingId);
24 var confirmed = await ConfirmNewPrice(repricing);
25
26 if (!confirmed)
27 {
28 throw new OperationCanceledException("Price change not confirmed");
29 }
30 }
31 catch (ApiException ex) when (ex.Code == "TIME_LIMIT_EXPIRED")
32 {
33 LogError("Time limit expired, cannot retry");
34 throw;
35 }
36 }
37
38 throw new Exception("Failed to issue ticket after retries");
39}

Связанные операции#

Создание PNR - создание бронирования
Пересчет стоимости PNR - проверка цены
Получение PNR - просмотр выписанных билетов
Обмен билета - изменение билета
Возврат билета - возврат билета

Структура ответа

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

Структура ответа#

Детальное описание структуры ответа от /avia/ticket_refund_calculation.

Успешный ответ#

При успешном расчёте возврата API возвращает HTTP 200 и объект с детализацией возврата.

Основная структура#

Поле	Тип	Описание
`forRefund`	Money	Итоговая сумма к возврату (используйте в `/avia/ticket_refund`)
`refundDetails`	RefundDetails	Детализация расчёта возврата

Структура RefundDetails#

Поле	Тип	Описание
`fare`	Money	Стоимость тарифа
`taxes`	TaxInfo	Информация о сборах и таксах
`penalty`	Money	Штраф за возврат согласно правилам тарифа

Структура TaxInfo#

Поле	Тип	Описание
`total`	Money	Общая сумма возвратных сборов
`breakdown`	Tax[]	Детализация сборов по кодам

Структура Tax#

Поле	Тип	Описание
`code`	string	Код сбора/таксы (например, “RI”, “YQ”)
`amount`	Money	Сумма данного сбора

Примеры ответов#

Успешный расчёт#

Стандартный ответ с детализацией:

Структура ответа

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

Структура ответа#

Детальное описание структуры ответа от /avia/ticket_refund.

Успешный ответ#

При успешном оформлении возврата API возвращает HTTP 200 и пустой объект.

1{}

Типичные ошибки#

Код ошибки	Причина	Решение
`TICKET_NOT_FOUND`	Билет не найден	Проверьте номер билета и bookingId
`REFUND_NOT_ALLOWED`	Возврат запрещен тарифом	Проверьте условия тарифа
`TICKET_ALREADY_REFUNDED`	Билет уже возвращен	Операция уже выполнена
`INVALID_REFUND_AMOUNT`	Неверная сумма возврата	Пересчитайте сумму согласно тарифу
`TICKET_USED`	Все сегменты использованы	Возврат невозможен

Связанные операции#

Войдирование билета - отмена без штрафов
Информация о билете - проверка статуса билета
Правила тарифа - просмотр условий возврата

Структура ответа

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

Структура ответа#

Детальное описание структуры ответа от /hotels/cancel_booking.

Основная структура#

Поле	Тип	Обязательно	Описание
`canceledAtUtc`	datetime	Да	Дата и время отмены (ISO 8601, UTC)
`amounts`	CancellationAmounts	Нет	Разбивка сумм по отмене

Структура CancellationAmounts#

Поле	Тип	Описание
`original`	Money	Исходная стоимость бронирования
`refunded`	Money	Сумма возврата
`penalty`	Money	Сумма штрафа за отмену

Примеры ответов#

Бесплатная отмена#

 1{
 2 "canceledAtUtc": "2025-11-25T14:30:00+00:00",
 3 "amounts": {
 4 "original": {
 5 "amount": 15000.00,
 6 "currency": "RUB"
 7 },
 8 "refunded": {
 9 "amount": 15000.00,
10 "currency": "RUB"
11 }
12 }
13}

Отмена со штрафом#

 1{
 2 "canceledAtUtc": "2025-12-14T10:00:00+00:00",
 3 "amounts": {
 4 "original": {
 5 "amount": 15000.00,
 6 "currency": "RUB"
 7 },
 8 "refunded": {
 9 "amount": 10000.00,
10 "currency": "RUB"
11 },
12 "penalty": {
13 "amount": 5000.00,
14 "currency": "RUB"
15 }
16 }
17}

Невозвратная отмена#

 1{
 2 "canceledAtUtc": "2025-12-15T08:00:00+00:00",
 3 "amounts": {
 4 "original": {
 5 "amount": 15000.00,
 6 "currency": "RUB"
 7 },
 8 "penalty": {
 9 "amount": 15000.00,
10 "currency": "RUB"
11 }
12 }
13}

Ответ с ошибкой#

1{
2 "error": {
3 "code": "BOOKING_NOT_FOUND",
4 "message": "Бронирование не найдено",
5 "description": "Бронирование с указанным идентификатором не найдено",
6 "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
7 }
8}

Типичные ошибки#

Код ошибки	Причина	Решение
`BOOKING_NOT_FOUND`	Бронирование не найдено или не принадлежит клиенту	Проверьте корректность `bookingId`
`VALIDATION_FAILED`	Ошибка валидации запроса	Проверьте обязательные поля
`CANCEL_FAILED`	Поставщик не смог отменить бронирование	Повторите запрос позже
`CANCELLATION_FAILED`	Отмена отклонена поставщиком	Повторите запрос позже или обратитесь в поддержку
`SUPPLIER_ERROR`	Поставщик вернул ошибку	Повторите запрос позже
`TIMEOUT`	Превышено время ожидания ответа от поставщика	Повторите запрос позже
`INTERNAL_ERROR`	Внутренняя ошибка сервера	Обратитесь в поддержку

Связанные операции#

Просмотр бронирования — проверка условий отмены до отмены
Поиск бронирований — поиск бронирований по статусу

Структура ответа

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

Структура ответа#

Детальное описание структуры ответа от /hotels/create_booking.

Основная структура#

Поле	Тип	Описание
`bookingId`	guid	Идентификатор созданного бронирования (формат UUID)
`supplierOrderId`	string	Идентификатор заказа у поставщика
`partnerOrderId`	string	Идентификатор заказа партнера

Примеры ответов#

Успешный ответ#

1{
2 "bookingId": "019a0c82-5d2b-7a5e-84fe-56357a57df66",
3 "supplierOrderId": "SUP-12345",
4 "partnerOrderId": "ORDER-12345"
5}

Типичные ошибки#

Код ошибки	Причина	Решение
`VALIDATION_FAILED`	Ошибка валидации запроса	Проверьте обязательные поля и форматы значений
`BOOKING_FAILED`	Поставщик не смог создать бронирование	Повторите запрос или выполните новый поиск
`SUPPLIER_ERROR`	Поставщик вернул ошибку	Повторите запрос позже
`TIMEOUT`	Превышено время ожидания ответа от поставщика	Повторите запрос позже
`INTERNAL_ERROR`	Внутренняя ошибка сервера	Обратитесь в поддержку

Связанные операции#

Просмотр бронирования — получение деталей бронирования
Отмена бронирования — отмена бронирования
Поиск бронирований — поиск бронирований

Структура ответа

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

Структура ответа#

Детальное описание структуры ответа от /hotels/search_bookings.

Основная структура#

Поле	Тип	Обязательно	Описание
`bookings`	BookingSummary[]	Нет	Список найденных бронирований

Структура BookingSummary#

Поле	Тип	Обязательно	Описание
`supplierBookingNumber`	string	Да	Номер бронирования у поставщика
`partnerOrderId`	string	Да	Идентификатор заказа партнера
`status`	BookingStatus	Да	Статус бронирования
`createdAt`	datetime	Да	Дата создания (ISO 8601)
`checkinAt`	date	Да	Дата заезда (YYYY-MM-DD)
`reservationKey`	string	Нет	Ключ бронирования

BookingStatus#

Значение	Описание
`completed`	Бронирование подтверждено
`cancelled`	Бронирование отменено
`failed`	Ошибка при бронировании

Примеры ответов#

Успешный ответ#

 1{
 2 "bookings": [
 3 {
 4 "supplierBookingNumber": "SUP-12345",
 5 "partnerOrderId": "ORDER-12345",
 6 "status": "Completed",
 7 "createdAt": "2025-11-20T10:30:00+00:00",
 8 "checkinAt": "2025-12-15",
 9 "reservationKey": "RES-ABC"
10 },
11 {
12 "supplierBookingNumber": "SUP-67890",
13 "partnerOrderId": "ORDER-67890",
14 "status": "Cancelled",
15 "createdAt": "2025-11-18T14:20:00+00:00",
16 "checkinAt": "2025-12-20"
17 }
18 ]
19}

Пустой результат#

1{
2 "bookings": []
3}

Ответ с ошибкой#

1{
2 "error": {
3 "code": "VALIDATION_FAILED",
4 "message": "Ошибка валидации",
5 "description": "supplierOrderIds: At least one SupplierOrderId is required",
6 "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
7 }
8}

Типичные ошибки#

Код ошибки	Причина	Решение
`VALIDATION_FAILED`	Ошибка валидации запроса	Проверьте обязательные поля и форматы значений
`SUPPLIER_ERROR`	Поставщик вернул ошибку	Повторите запрос позже
`TIMEOUT`	Превышено время ожидания ответа от поставщика	Повторите запрос позже
`INTERNAL_ERROR`	Внутренняя ошибка сервера	Обратитесь в поддержку

Структура ответа

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

Структура ответа#

Детальное описание структуры ответа от /hotels/view_booking.

Основная структура#

Поле	Тип	Обязательно	Описание
`supplierOrderId`	string	Нет	Идентификатор заказа у поставщика
`partner`	ViewBookingPartnerInfo	Нет	Информация о заказе партнера
`hotel`	ViewBookingHotelInfo	Нет	Информация об отеле и номере
`guests`	ViewBookingGuestsInfo	Нет	Информация о гостях
`prices`	ViewBookingPriceInfo	Нет	Ценовая информация
`bookingInfo`	ViewBookingInfo	Нет	Статус и даты бронирования
`checkin`	date	Да	Дата заезда (YYYY-MM-DD)
`checkout`	date	Да	Дата выезда (YYYY-MM-DD)
`upsells`	ViewBookingUpsellInfo[]	Нет	Дополнительные услуги
`customer`	ViewBookingCustomerInfo	Нет	Контактное лицо
`hostContacts`	ViewBookingHostInfo	Нет	Контактная информация владельца квартиры
`extraInfo`	ViewBookingExtraInfo	Нет	Дополнительная информация по проживанию

Структура ViewBookingPartnerInfo#

Поле	Тип	Описание
`partnerOrderId`	string	Идентификатор заказа партнера
`comment`	string	Комментарий
`amountSellB2b2c`	Money	Сумма продажи B2B2C

Структура ViewBookingHotelInfo#

Поле	Тип	Описание
`hotelId`	string	Идентификатор отеля
`room`	ViewBookingRoomInfo	Информация о номере

Структура ViewBookingRoomInfo#

Поле	Тип	Описание
`name`	string	Название номера
`mealName`	string	Тип питания
`beddingNames`	string[]	Типы кроватей

Структура ViewBookingGuestsInfo#

Поле	Тип	Описание
`count`	integer	Общее количество гостей
`adultCount`	integer	Количество взрослых
`childrenCount`	integer	Количество детей
`guests`	ViewBookingGuestDetails[]	Детали гостей

Структура ViewBookingGuestDetails#

Поле	Тип	Описание
`firstName`	string	Имя
`lastName`	string	Фамилия
`isChild`	boolean	Ребенок
`age`	integer	Возраст (для детей)
`citizenship`	string	Гражданство (ISO 3166-1 alpha-2)
`gender`	string	Пол

Структура ViewBookingPriceInfo#

Поле	Тип	Описание
`supplier`	string	Код поставщика
`contractId`	string	Идентификатор контракта (офиса) поставщика
`searchPresetId`	string	Идентификатор пресета поиска
`pricingPresetId`	string	Идентификатор пресета ценообразования
`payable`	Money	Сумма к оплате
`amountSell`	Money	Сумма продажи
`paymentType`	string	Тип оплаты
`cancellationRules`	CancellationRules	Правила отмены

Структура ViewBookingInfo#

Поле	Тип	Описание
`status`	string	Статус бронирования (`Completed`, `Cancelled`, `Failed`)
`isCancellable`	boolean	Возможность отмены
`createdAt`	datetime	Дата создания (ISO 8601)
`updatedAt`	datetime	Дата обновления (ISO 8601)
`cancelledAt`	datetime	Дата отмены (ISO 8601)

Структура ViewBookingUpsellInfo#

Поле	Тип	Описание
`type`	string	Тип услуги (`early_checkin`, `late_checkout`)
`name`	string	Название услуги
`value`	Money	Стоимость

Структура ViewBookingCustomerInfo#

Поле	Тип	Описание
`firstName`	string	Имя
`lastName`	string	Фамилия
`email`	string	Email
`phone`	string	Телефон
`comment`	string	Комментарий

Структура ViewBookingHostInfo#

Поле	Тип	Описание
`name`	string	Имя
`email`	string	Email
`phone`	string	Телефон
`comment`	string	Комментарий

Структура ViewBookingExtraInfo#

Поле	Тип	Описание
`entrance`	string	Номер подъезда
`apartmentNumber`	string	Номер квартиры
`entranceCode`	string	Код от домофона
`howToFind`	string	Как найти дом
`howToGetIn`	string	Как попасть в квартиру
`lockCode`	string	Код от сейфа или двери
`checkInRules`	string	Правила заселения
`checkOutRules`	string	Правила выселения
`accommodationRules`	string	Правила проживания
`wifiName`	string	Название сети Wi-Fi
`wifiPassword`	string	Пароль от Wi-Fi

Примеры ответов#

Успешный ответ#

Развернуть пример

 1{
 2 "supplierOrderId": "SUP-12345",
 3 "partner": {
 4 "partnerOrderId": "ORDER-12345",
 5 "comment": "VIP клиент"
 6 },
 7 "hotel": {
 8 "hotelId": "hotel-001",
 9 "room": {
10 "name": "Стандартный двухместный",
11 "mealName": "Завтрак",
12 "beddingNames": ["Двуспальная кровать"]
13 }
14 },
15 "guests": {
16 "count": 2,
17 "adultCount": 2,
18 "childrenCount": 0,
19 "guests": [
20 {
21 "firstName": "IVAN",
22 "lastName": "IVANOV",
23 "isChild": false,
24 "citizenship": "RU",
25 "gender": "male"
26 },
27 {
28 "firstName": "MARIA",
29 "lastName": "IVANOVA",
30 "isChild": false,
31 "citizenship": "RU",
32 "gender": "female"
33 }
34 ]
35 },
36 "prices": {
37 "supplier": "ostrovok",
38 "contractId": "uy123u8213y2j",
39 "searchPresetId": "87123eh22323",
40 "pricingPresetId": "ed23uhds223f",
41 "payable": {
42 "amount": 1500,
43 "currency": "string"
44 },
45 "amountSell": {
46 "amount": 1500,
47 "currency": "string"
48 },
49 "paymentType": "online",
50 "cancellationRules": {
51 "freeCancellationBefore": "2025-12-13T12:00:00+00:00"
52 }
53 },
54 "bookingInfo": {
55 "status": "Completed",
56 "isCancellable": true,
57 "createdAt": "2025-11-20T10:30:00+00:00",
58 "updatedAt": "2025-11-20T10:30:05+00:00"
59 },
60 "checkin": "2025-12-15",
61 "checkout": "2025-12-18",
62 "customer": {
63 "firstName": "Ivan",
64 "lastName": "Ivanov",
65 "email": "ivan@example.com",
66 "phone": "+79991234567"
67 },
68 "hostContacts": {
69 "name": "Petr",
70 "email": "petr@example.com",
71 "phone": "+12345678",
72 "comment": "comment"
73 },
74 "extraInfo": {
75 "entrance": "1",
76 "apartmentNumber": "1",
77 "entranceCode": "111",
78 "howToFind": "red roof",
79 "howToGetIn": "apartment number 1",
80 "lockCode": "789123",
81 "checkInRules": "after 16:00",
82 "checkOutRules": "before 12:00",
83 "accommodationRules": "string",
84 "wifiName": "wifi name",
85 "wifiPassword": "123qwerty"
86 }
87}

Ответ с ошибкой#

1{
2 "error": {
3 "code": "BOOKING_NOT_FOUND",
4 "message": "Бронирование не найдено",
5 "description": "Бронирование с указанным идентификатором не найдено",
6 "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
7 }
8}

Типичные ошибки#

Код ошибки	Причина	Решение
`BOOKING_NOT_FOUND`	Бронирование не найдено, не принадлежит клиенту или не является отельным	Проверьте корректность `bookingId`
`VALIDATION_FAILED`	Не передан обязательный параметр (`bookingId` или `language`)	Проверьте наличие всех обязательных полей
`SUPPLIER_ERROR`	Поставщик вернул ошибку	Повторите запрос позже
`INTERNAL_ERROR`	Неизвестный или невалидный ответ от поставщика	Обратитесь в поддержку
`TIMEOUT`	Превышено время ожидания ответа от поставщика	Повторите запрос позже

Структура ответа

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

Структура ответа#

Детальное описание структуры ответа от /hotels/hotel_pricing.

Основная структура#

Поле	Тип	Обязательно	Описание
`hotelId`	string	Нет	Идентификатор отеля
`checkinDate`	date	Да	Дата заезда (YYYY-MM-DD)
`checkoutDate`	date	Да	Дата выезда (YYYY-MM-DD)
`searchId`	string	Нет	Идентификатор для проверки цены и бронирования
`offers`	Offer[]	Нет	Список доступных предложений

Примеры ответов#

Успешный ответ#

Развернуть пример

 1{
 2 "hotelId": "hotel-001",
 3 "checkinDate": "2025-12-15",
 4 "checkoutDate": "2025-12-18",
 5 "searchId": "search-xyz789",
 6 "offers": [
 7 {
 8 "offerId": "offer-001",
 9 "supplier": "ostrovok",
 10 "contractId": "tywu2374u2dhs2ui",
 11 "searchPresetId": "334ferf4545y3",
 12 "pricingPresetId": "3454tf4454545",
 13 "roomId": "room-101",
 14 "roomName": "Стандартный двухместный",
 15 "allotment": 5,
 16 "paymentType": "online",
 17 "isRefundable": true,
 18 "features": [
 19 { "type": "bedding", "value": "double" }
 20 ],
 21 "roomAmenities": [
 22 {
 23 "id": "wifi",
 24 "name": "Wi-Fi",
 25 "group": "internet",
 26 "included": true,
 27 "amount": 0,
 28 "currency": "RUB",
 29 "vat": {
 30 "isVatFree": true,
 31 "included": true,
 32 "value": {
 33 "amount": 0,
 34 "currency": "RUB"
 35 },
 36 "percent": "0"
 37 }
 38 },
 39 {
 40 "id": "ac",
 41 "name": "Кондиционер",
 42 "group": "comfort",
 43 "included": true,
 44 "amount": 0,
 45 "currency": "RUB",
 46 "vat": {
 47 "isVatFree": true,
 48 "included": true,
 49 "value": {
 50 "amount": 0,
 51 "currency": "RUB"
 52 },
 53 "percent": "0"
 54 }
 55 }
 56 ],
 57 "roomImages": [
 58 "https://url/photo.JPEG",
 59 "https://url/photo_2.JPEG"
 60 ],
 61 "prices": {
 62 "vat": {
 63 "isVatFree": true,
 64 "included": true,
 65 "value": {
 66 "amount": 0,
 67 "currency": "RUB"
 68 },
 69 "percent": "0"
 70 },
 71 "totalPrice": {
 72 "total": {
 73 "amount": 1500.00,
 74 "currency": "RUB"
 75 },
 76 "discount": {
 77 "amount": 100.00,
 78 "currency": "RUB"
 79 },
 80 "markup": {
 81 "amount": 100,
 82 "currency": "RUB"
 83 },
 84 "serviceFee": {
 85 "amount": 0,
 86 "currency": "RUB"
 87 },
 88 "supplier": {
 89 "bar": {
 90 "amount": 1400,
 91 "currency": "RUB"
 92 },
 93 "gross": {
 94 "amount": 1600,
 95 "currency": "RUB"
 96 },
 97 "netto": {
 98 "amount": 1400,
 99 "currency": "RUB"
100 },
101 "rack": {
102 "amount": 0,
103 "currency": "RUB"
104 }
105 },
106 "commission": {
107 "margin": "100",
108 "subagent": {
109 "amount": 0,
110 "currency": "RUB"
111 },
112 "supplier": {
113 "amount": 200,
114 "currency": "RUB"
115 }
116 }
117 },
118 "meals": [
119 {
120 "mealId": "breakfast",
121 "mealName": "Завтрак",
122 "included": true,
123 "price": {
124 "total": {
125 "amount": 0,
126 "currency": "RUB"
127 },
128 "discount": {
129 "amount": 0,
130 "currency": "RUB"
131 },
132 "markup": {
133 "amount": 0,
134 "currency": "RUB"
135 },
136 "serviceFee": {
137 "amount": 0,
138 "currency": "RUB"
139 },
140 "supplier": {
141 "amount": 0,
142 "currency": "RUB"
143 },
144 "commission": {
145 "margin": "0",
146 "subagent": {
147 "amount": 0,
148 "currency": "RUB"
149 },
150 "supplier": {
151 "amount": 0,
152 "currency": "RUB"
153 }
154 },
155 "vat": {
156 "isVatFree": true,
157 "included": true,
158 "value": {
159 "amount": 0,
160 "currency": "RUB"
161 },
162 "percent": "0"
163 }
164 }
165 }
166 ],
167 "cancellationRules": {
168 "freeCancellationBefore": "2025-12-13T12:00:00+00:00",
169 "ruleList": [
170 {
171 "startAt": "2025-12-13T12:00:00+00:00",
172 "endAt": "2025-12-15T10:32:04.853Z",
173 "penalty": {
174 "total": {
175 "amount": 5000.00,
176 "currency": "RUB"
177 },
178 "discount": {
179 "amount": 0,
180 "currency": "RUB"
181 },
182 "markup": {
183 "amount": 0,
184 "currency": "RUB"
185 },
186 "serviceFee": {
187 "amount": 0,
188 "currency": "RUB"
189 },
190 "supplier": {
191 "amount": 5000,
192 "currency": "RUB"
193 }
194 },
195 "commission": {
196 "margin": "0",
197 "subagent": {
198 "amount": 0,
199 "currency": "RUB"
200 },
201 "supplier": {
202 "amount": 0,
203 "currency": "RUB"
204 }
205 },
206 "vat": {
207 "isVatFree": true,
208 "included": true,
209 "value": {
210 "amount": 0,
211 "currency": "RUB"
212 },
213 "percent": "0"
214 }
215 }
216 ]
217 },
218 "earlyCheckin": [
219 {
220 "time": "10:00",
221 "availableStatus": "Available",
222 "price": {
223 "total": {
224 "amount": 2000.00,
225 "currency": "RUB"
226 },
227 "discount": {
228 "amount": 0,
229 "currency": "RUB"
230 },
231 "markup": {
232 "amount": 0,
233 "currency": "RUB"
234 },
235 "serviceFee": {
236 "amount": 0,
237 "currency": "RUB"
238 },
239 "supplier": {
240 "amount": 0,
241 "currency": "RUB"
242 },
243 "commission": {
244 "margin": "0",
245 "subagent": {
246 "amount": 0,
247 "currency": "RUB"
248 },
249 "supplier": {
250 "amount": 0,
251 "currency": "RUB"
252 }
253 },
254 "vat": {
255 "isVatFree": true,
256 "included": true,
257 "value": {
258 "amount": 0,
259 "currency": "RUB"
260 },
261 "percent": "0"
262 }
263 }
264 }
265 ],
266 "lateCheckout": [
267 {
268 "time": "18:00",
269 "availableStatus": "OnRequest",
270 "price": {
271 "total": {
272 "amount": 3000.00,
273 "currency": "RUB"
274 },
275 "discount": {
276 "amount": 0,
277 "currency": "RUB"
278 },
279 "markup": {
280 "amount": 0,
281 "currency": "RUB"
282 },
283 "serviceFee": {
284 "amount": 0,
285 "currency": "RUB"
286 },
287 "supplier": {
288 "amount": 0,
289 "currency": "RUB"
290 },
291 "commission": {
292 "margin": "0",
293 "subagent": {
294 "amount": 0,
295 "currency": "RUB"
296 },
297 "supplier": {
298 "amount": 0,
299 "currency": "RUB"
300 }
301 },
302 "vat": {
303 "isVatFree": true,
304 "included": true,
305 "value": {
306 "amount": 0,
307 "currency": "RUB"
308 },
309 "percent": "0"
310 }
311 }
312 }
313 ]
314 },
315 "deposit": {
316 "value": {
317 "amount": 500,
318 "currency": "RUB"
319 },
320 "isRefundable": true
321 },
322 "isPetAvailable": true,
323 "checkinRules": [
324 {
325 "frontDeskTimeStart": "10:00",
326 "frontDeskTimeEnd": "20:00",
327 "keysPickup": "123",
328 "phone": "+123456",
329 "email": "email@gmail.com",
330 "address": "address 7/3",
331 "isContactless": true,
332 "comment": "Код замка 123"
333 }
334 ]
335 },
336 {
337 "offerId": "offer-002",
338 "roomId": "room-201",
339 "roomName": "Люкс с видом на море",
340 "allotment": 2,
341 "paymentType": "online",
342 "isRefundable": true,
343 "features": [
344 { "type": "bedding", "value": "king" },
345 { "type": "view", "value": "sea" }
346 ],
347 "roomImages": [
348 "https://url/photo.JPEG",
349 "https://url/photo_2.JPEG"
350 ],
351 "prices": {
352 "totalPrice": {
353 "total": {
354 "amount": 35000.00,
355 "currency": "RUB"
356 }
357 },
358 "meals": [
359 {
360 "mealId": "half_board",
361 "mealName": "Полупансион",
362 "included": true
363 }
364 ],
365 "cancellationRules": {
366 "freeCancellationBefore": "2025-12-10T12:00:00+00:00"
367 }
368 },
369 "deposit": {
370 "value": {
371 "amount": 500,
372 "currency": "RUB"
373 },
374 "isRefundable": true
375 },
376 "isPetAvailable": true,
377 "checkinRules": [
378 {
379 "frontDeskTimeStart": "00:00"
380 }
381 ]
382 }
383 ]
384}

Ответ с ошибкой#

1{
2 "error": {
3 "code": "HOTEL_NOT_FOUND",
4 "message": "Отель не найден",
5 "description": "Отель с указанным идентификатором не найден",
6 "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
7 }
8}

Типичные ошибки#

Код ошибки	Причина	Решение
`VALIDATION_FAILED`	Ошибка валидации запроса	Проверьте обязательные поля и форматы значений
`NO_PRODUCTS`	Нет доступных продуктов для отеля	Попробуйте другой отель
`NO_RATES`	Нет доступных тарифов для заданных параметров	Измените даты или параметры поиска
`SUPPLIER_ERROR`	Поставщик вернул ошибку	Повторите запрос позже
`TIMEOUT`	Превышено время ожидания ответа от поставщика	Повторите запрос позже
`INTERNAL_ERROR`	Внутренняя ошибка сервера	Обратитесь в поддержку

Структура ответа

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

Структура ответа#

Детальное описание структуры ответа от /hotels/offer_pricing.

Основная структура#

Поле	Тип	Обязательно	Описание
`hotelId`	string	Нет	Идентификатор отеля
`checkinDate`	date	Да	Дата заезда (YYYY-MM-DD)
`checkoutDate`	date	Да	Дата выезда (YYYY-MM-DD)
`searchId`	string	Нет	Идентификатор поиска
`offer`	Offer	Нет	Актуальное предложение с подтвержденной ценой

Примеры ответов#

Успешный ответ#

Развернуть пример

 1{
 2 "hotelId": "hotel-001",
 3 "checkinDate": "2025-12-15",
 4 "checkoutDate": "2025-12-18",
 5 "searchId": "search-xyz789",
 6 "offer": {
 7 "offerId": "offer-001",
 8 "supplier": "ostrovok",
 9 "contractId": "tywu2374u2dhs2ui",
 10 "searchPresetId": "334ferf4545y3",
 11 "pricingPresetId": "3454tf4454545",
 12 "roomId": "room-101",
 13 "roomName": "Стандартный двухместный",
 14 "allotment": 5,
 15 "paymentType": "online",
 16 "isRefundable": true,
 17 "features": [
 18 { "type": "bedding", "value": "double" }
 19 ],
 20 "roomAmenities": [
 21 {
 22 "id": "wifi",
 23 "name": "Wi-Fi",
 24 "group": "internet",
 25 "included": true,
 26 "amount": 0,
 27 "currency": "RUB",
 28 "vat": {
 29 "isVatFree": true,
 30 "included": true,
 31 "value": {
 32 "amount": 0,
 33 "currency": "RUB"
 34 },
 35 "percent": "0"
 36 }
 37 }
 38 ],
 39 "roomImages": [
 40 "https://url/photo.JPEG",
 41 "https://url/photo_2.JPEG"
 42 ],
 43 "prices": {
 44 "vat": {
 45 "isVatFree": true,
 46 "included": true,
 47 "value": {
 48 "amount": 0,
 49 "currency": "RUB"
 50 },
 51 "percent": "0"
 52 },
 53 "totalPrice": {
 54 "total": {
 55 "amount": 15000.00,
 56 "currency": "RUB"
 57 },
 58 "discount": {
 59 "amount": 100.00,
 60 "currency": "RUB"
 61 },
 62 "markup": {
 63 "amount": 100,
 64 "currency": "RUB"
 65 },
 66 "serviceFee": {
 67 "amount": 0,
 68 "currency": "RUB"
 69 },
 70 "supplier": {
 71 "bar": {
 72 "amount": 1400,
 73 "currency": "RUB"
 74 },
 75 "gross": {
 76 "amount": 1600,
 77 "currency": "RUB"
 78 },
 79 "netto": {
 80 "amount": 1400,
 81 "currency": "RUB"
 82 },
 83 "rack": {
 84 "amount": 0,
 85 "currency": "RUB"
 86 }
 87 },
 88 "commission": {
 89 "margin": "100",
 90 "subagent": {
 91 "amount": 0,
 92 "currency": "RUB"
 93 },
 94 "supplier": {
 95 "amount": 200,
 96 "currency": "RUB"
 97 }
 98 }
 99 },
100 "meals": [
101 {
102 "mealId": "breakfast",
103 "mealName": "Завтрак",
104 "included": true,
105 "price": {
106 "total": {
107 "amount": 0,
108 "currency": "RUB"
109 },
110 "discount": {
111 "amount": 0,
112 "currency": "RUB"
113 },
114 "markup": {
115 "amount": 0,
116 "currency": "RUB"
117 },
118 "serviceFee": {
119 "amount": 0,
120 "currency": "RUB"
121 },
122 "supplier": {
123 "amount": 0,
124 "currency": "RUB"
125 },
126 "commission": {
127 "margin": "0",
128 "subagent": {
129 "amount": 0,
130 "currency": "RUB"
131 },
132 "supplier": {
133 "amount": 0,
134 "currency": "RUB"
135 }
136 },
137 "vat": {
138 "isVatFree": true,
139 "included": true,
140 "value": {
141 "amount": 0,
142 "currency": "RUB"
143 },
144 "percent": "0"
145 }
146 }
147 }
148 ],
149 "cancellationRules": {
150 "freeCancellationBefore": "2025-12-13T12:00:00+00:00",
151 "ruleList": [
152 {
153 "startAt": "2025-12-13T12:00:00+00:00",
154 "endAt": "2025-12-15T10:32:04.853Z",
155 "penalty": {
156 "total": {
157 "amount": 5000.00,
158 "currency": "RUB"
159 },
160 "discount": {
161 "amount": 0,
162 "currency": "RUB"
163 },
164 "markup": {
165 "amount": 0,
166 "currency": "RUB"
167 },
168 "serviceFee": {
169 "amount": 0,
170 "currency": "RUB"
171 },
172 "supplier": {
173 "amount": 5000,
174 "currency": "RUB"
175 }
176 },
177 "commission": {
178 "margin": "0",
179 "subagent": {
180 "amount": 0,
181 "currency": "RUB"
182 },
183 "supplier": {
184 "amount": 0,
185 "currency": "RUB"
186 }
187 },
188 "vat": {
189 "isVatFree": true,
190 "included": true,
191 "value": {
192 "amount": 0,
193 "currency": "RUB"
194 },
195 "percent": "0"
196 }
197 }
198 ]
199 },
200 "earlyCheckin": [
201 {
202 "time": "10:00",
203 "availableStatus": "Available",
204 "price": {
205 "total": {
206 "amount": 2000.00,
207 "currency": "RUB"
208 },
209 "discount": {
210 "amount": 0,
211 "currency": "RUB"
212 },
213 "markup": {
214 "amount": 0,
215 "currency": "RUB"
216 },
217 "serviceFee": {
218 "amount": 0,
219 "currency": "RUB"
220 },
221 "supplier": {
222 "amount": 0,
223 "currency": "RUB"
224 },
225 "commission": {
226 "margin": "0",
227 "subagent": {
228 "amount": 0,
229 "currency": "RUB"
230 },
231 "supplier": {
232 "amount": 0,
233 "currency": "RUB"
234 }
235 },
236 "vat": {
237 "isVatFree": true,
238 "included": true,
239 "value": {
240 "amount": 0,
241 "currency": "RUB"
242 },
243 "percent": "0"
244 }
245 }
246 }
247 ],
248 "lateCheckout": [
249 {
250 "time": "18:00",
251 "availableStatus": "OnRequest",
252 "price": {
253 "total": {
254 "amount": 3000.00,
255 "currency": "RUB"
256 },
257 "discount": {
258 "amount": 0,
259 "currency": "RUB"
260 },
261 "markup": {
262 "amount": 0,
263 "currency": "RUB"
264 },
265 "serviceFee": {
266 "amount": 0,
267 "currency": "RUB"
268 },
269 "supplier": {
270 "amount": 0,
271 "currency": "RUB"
272 },
273 "commission": {
274 "margin": "0",
275 "subagent": {
276 "amount": 0,
277 "currency": "RUB"
278 },
279 "supplier": {
280 "amount": 0,
281 "currency": "RUB"
282 }
283 },
284 "vat": {
285 "isVatFree": true,
286 "included": true,
287 "value": {
288 "amount": 0,
289 "currency": "RUB"
290 },
291 "percent": "0"
292 }
293 }
294 }
295 ]
296 },
297 "deposit": {
298 "value": {
299 "amount": 500,
300 "currency": "RUB"
301 },
302 "isRefundable": true
303 },
304 "isPetAvailable": true,
305 "checkinRules": [
306 {
307 "frontDeskTimeStart": "10:00",
308 "frontDeskTimeEnd": "20:00",
309 "keysPickup": "123",
310 "phone": "+123456",
311 "email": "email@gmail.com",
312 "address": "address 7/3",
313 "isContactless": true,
314 "comment": "Код замка 123"
315 }
316 ]
317 }
318}

Ответ с ошибкой#

1{
2 "error": {
3 "code": "OFFER_NOT_AVAILABLE",
4 "message": "Предложение недоступно",
5 "description": "Выбранное предложение больше недоступно",
6 "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
7 }
8}

Типичные ошибки#

Код ошибки	Причина	Решение
`VALIDATION_FAILED`	Ошибка валидации запроса	Проверьте обязательные поля `searchId` и `offerId`
`OFFER_NOT_AVAILABLE`	Предложение недоступно	Выполните новый поиск
`RATE_UNAVAILABLE`	Тариф недоступен у поставщика	Выполните новый поиск
`SUPPLIER_ERROR`	Поставщик вернул ошибку	Повторите запрос позже
`TIMEOUT`	Превышено время ожидания ответа от поставщика	Повторите запрос позже
`INTERNAL_ERROR`	Внутренняя ошибка сервера	Обратитесь в поддержку

Структура ответа

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

Структура ответа#

Детальное описание структуры ответа от /hotels/search.

Основная структура#

Поле	Тип	Обязательно	Описание
`totalHotels`	integer	Нет	Общее количество найденных отелей
`searchId`	string	Нет	Идентификатор поиска для последующих операций
`hotels`	HotelSearchItem[]	Нет	Список найденных отелей

Структура HotelSearchItem#

Каждый отель в массиве hotels:

Поле	Тип	Обязательно	Описание
`hotelId`	string	Да	Идентификатор отеля
`checkinDate`	date	Да	Дата заезда (YYYY-MM-DD)
`checkoutDate`	date	Да	Дата выезда (YYYY-MM-DD)
`offers`	OfferBase	Да	Доступные предложения по отелю

Примеры ответов#

Успешный ответ#

Развернуть пример

 1{
 2 "totalHotels": 2,
 3 "searchId": "search-abc123",
 4 "hotels": [
 5 {
 6 "hotelId": "hotel-001",
 7 "checkinDate": "2025-12-15",
 8 "checkoutDate": "2025-12-18",
 9 "offers": [
10 {
11 "roomId": "room-101",
12 "roomName": "Стандартный двухместный",
13 "allotment": 5,
14 "paymentType": "online",
15 "isRefundable": true,
16 "features": [
17 { "type": "bedding", "value": "double" }
18 ],
19 "prices": {
20 "totalPrice": {
21 "total": {
22 "amount": 12000.00,
23 "currency": "RUB"
24 }
25 },
26 "meals": [
27 {
28 "mealId": "breakfast",
29 "mealName": "Завтрак",
30 "included": true
31 }
32 ],
33 "cancellationRules": {
34 "freeCancellationBefore": "2025-12-13T12:00:00+00:00"
35 }
36 }
37 }
38 ]
39 },
40 {
41 "hotelId": "hotel-002",
42 "checkinDate": "2025-12-15",
43 "checkoutDate": "2025-12-18",
44 "offers": [
45 {
46 "roomId": "room-201",
47 "roomName": "Эконом",
48 "allotment": 3,
49 "paymentType": "hotel",
50 "isRefundable": false,
51 "prices": {
52 "totalPrice": {
53 "total": {
54 "amount": 8500.00,
55 "currency": "RUB"
56 }
57 }
58 }
59 }
60 ]
61 }
62 ]
63}

Ответ с ошибкой#

1{
2 "error": {
3 "code": "NO_AVAILABILITY",
4 "message": "Нет доступных отелей",
5 "description": "Для заданных параметров поиска не найдено отелей"
6 }
7}

Типичные ошибки#

Код ошибки	Причина	Решение
`VALIDATION_FAILED`	Ошибка валидации запроса	Проверьте обязательные поля и форматы значений
`SUPPLIER_ERROR`	Поставщик вернул ошибку	Повторите запрос позже
`TIMEOUT`	Превышено время ожидания ответа от поставщика	Повторите запрос позже
`INTERNAL_ERROR`	Внутренняя ошибка сервера	Обратитесь в поддержку

Структура ответа

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

Структура ответа#

Детальное описание структуры ответа от /hotels/{hotelId}/static.

Основная структура#

title: “Структура ответа” weight: 2 bookToc: true#

Структура ответа#

Детальное описание структуры ответа от /hotels/{hotelId}/static.

Основная структура#

Поле	Тип	Обязательно	Описание
hotel	HotelStaticInfo	Нет	Статическая информация по отелю
error	Error	Нет	Информация об ошибке

Структура HotelStaticInfo#

Поле	Тип	Обязательно	Описание
id	integer	Да	Идентификатор отеля
isDeleted	boolean	Да	Признак удаления отеля
name	LocalizedName	Нет	Название отеля
category	Category	Нет	Категория отеля
address	Address	Нет	Адрес отеля
city	City	Нет	Город и страна
coordinates	Coordinates	Нет	Координаты отеля
email	string	Нет	Email отеля
phones	string[]	Да	Список телефонов
website	string	Нет	Сайт отеля
stars	integer	Да	Количество звезд
registryCertificate	RegistryCertificate	Нет	Данные о реестровом сертификате
checkInTime	string	Нет	Время заезда
checkOutTime	string	Нет	Время выезда
description	LocalizedName	Нет	Описание отеля
amenities	Amenity[]	Да	Список удобств
photos	Photo[]	Да	Список фотографий

Структура LocalizedName#

Поле	Тип	Описание
ru	string	Значение на русском языке
en	string	Значение на английском языке

Структура Category#

Поле	Тип	Описание
id	integer	Идентификатор категории
name	LocalizedName	Название категории

Структура Address#

Поле	Тип	Описание
addressText	LocalizedName	Текст адреса
zipCode	string	Почтовый индекс

Структура City#

Поле	Тип	Описание
id	integer	Идентификатор города
name	LocalizedName	Название города
timeZone	string	Часовой пояс
country	Country	Страна

Структура Country#

Поле	Тип	Описание
id	integer	Идентификатор страны
name	LocalizedName	Название страны

Структура Coordinates#

Поле	Тип	Описание
latitude	string	Широта
longitude	string	Долгота

Структура RegistryCertificate#

Поле	Тип	Описание
registryNumber	string	Номер записи в реестре
registryUrl	string	Ссылка на запись в реестре
registryStatus	string	Статус записи в реестре
registryExpiredAt	datetime	Дата окончания действия записи (ISO 8601)
isRegistryVerified	boolean	Признак верификации записи
registryType	string	Тип записи в реестре
starCertificateValidTo	datetime	Срок действия сертификата категории (ISO 8601)

Структура Amenity#

Поле	Тип	Описание
id	integer	Идентификатор удобства
name	LocalizedName	Название удобства
category	Category	Категория удобства

Структура Photo#

Поле	Тип	Описание
url	string	Ссылка на изображение
isMain	boolean	Признак главной фотографии

Структура Error#

Поле	Тип	Описание
code	string	Код ошибки
message	string	Текст ошибки
description	string	Детальное описание ошибки

Примеры ответов#

Успешный ответ#

Развернуть пример

 1{
 2 "hotel": {
 3 "id": 12345,
 4 "isDeleted": false,
 5 "name": {
 6 "ru": "Отель Москва",
 7 "en": "Hotel Moscow"
 8 },
 9 "category": {
 10 "id": 5,
 11 "name": {
 12 "ru": "Пятизвездочный отель",
 13 "en": "Five-star hotel"
 14 }
 15 },
 16 "address": {
 17 "addressText": {
 18 "ru": "ул. Тверская, д. 1",
 19 "en": "1 Tverskaya St."
 20 },
 21 "zipCode": "125009"
 22 },
 23 "city": {
 24 "id": 1,
 25 "name": {
 26 "ru": "Москва",
 27 "en": "Moscow"
 28 },
 29 "timeZone": "Europe/Moscow",
 30 "country": {
 31 "id": 643,
 32 "name": {
 33 "ru": "Россия",
 34 "en": "Russia"
 35 }
 36 }
 37 },
 38 "coordinates": {
 39 "latitude": "55.7558",
 40 "longitude": "37.6176"
 41 },
 42 "email": "info@hotel.example",
 43 "phones": [
 44 "+7 495 000-00-00",
 45 "+7 495 111-11-11"
 46 ],
 47 "website": "https://hotel.example",
 48 "stars": 5,
 49 "registryCertificate": {
 50 "registryNumber": "77/AA/123456",
 51 "registryUrl": "https://registry.example/hotels/12345",
 52 "registryStatus": "active",
 53 "registryExpiredAt": "2026-12-31T00:00:00Z",
 54 "isRegistryVerified": true,
 55 "registryType": "hotel",
 56 "starCertificateValidTo": "2026-12-31T00:00:00Z"
 57 },
 58 "checkInTime": "14:00",
 59 "checkOutTime": "12:00",
 60 "description": {
 61 "ru": "Отель в центре города рядом с метро.",
 62 "en": "A hotel in the city center near the metro station."
 63 },
 64 "amenities": [
 65 {
 66 "id": 101,
 67 "name": {
 68 "ru": "Wi-Fi",
 69 "en": "Wi-Fi"
 70 },
 71 "category": {
 72 "id": 10,
 73 "name": {
 74 "ru": "Интернет",
 75 "en": "Internet"
 76 }
 77 }
 78 },
 79 {
 80 "id": 102,
 81 "name": {
 82 "ru": "Парковка",
 83 "en": "Parking"
 84 },
 85 "category": {
 86 "id": 11,
 87 "name": {
 88 "ru": "Услуги",
 89 "en": "Services"
 90 }
 91 }
 92 }
 93 ],
 94 "photos": [
 95 {
 96 "url": "https://cdn.example.com/hotels/12345/main.jpg",
 97 "isMain": true
 98 },
 99 {
100 "url": "https://cdn.example.com/hotels/12345/lobby.jpg",
101 "isMain": false
102 }
103 ]
104 }
105}

Окружения

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

Окружения#

Travel API предоставляет различные окружения для разработки и production использования.

Доступные окружения#

Test (Тестовое)#

Base URL:

https://test.travel-api.ru/

Назначение:

Разработка и тестирование интеграции
Отладка запросов и ответов
Изучение API без риска реальных бронирований

Характеристики:

Доступ к тестовым GDS окружениям
Авиабронирования не создаются в реальных GDS
Тестовые данные и офисы
Расширенное логирование
Стабильное окружение для разработки

Рекомендуется для:

Первоначальной интеграции

Разработки новых функций

Тестирования edge cases

Обучения и экспериментов

Важно для отелей: Бронирования отелей в тестовом окружении создаются у реальных поставщиков и могут повлечь штрафы при несоблюдении правил отмены.

Пассажиры

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

Пассажиры#

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

PassengerType#

Тип пассажира по возрастной категории.

Возможные значения#

Значение	Описание	Возраст
`adt`	Взрослый (Adult)	12+ лет
`chd`	Ребенок (Child)	2-11 лет
`inf`	Младенец (Infant)	0-2 года

Примеры#

1"ptc": "adt"

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

Младенец (inf) обычно не занимает отдельное место
Ребенок (chd) занимает отдельное место
Цены различаются по типам пассажиров

PassengerTypeQuantity#

Количество пассажиров определенного типа.

Поле	Тип	Обязательно	Описание
`ptc`	PassengerType	Да	Тип пассажира
`quantity`	integer	Да	Количество пассажиров данного типа (1-9)

Примеры#

2 взрослых:

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

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

Рейсы#

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

FlightDesignator#

Обозначение рейса — комбинация кода авиакомпании и номера рейса.

Поле	Тип	Обязательно	Описание
`carrierCode`	string	Да	Код авиакомпании (IATA, 2 буквы)
`flightNumber`	string	Нет	Номер рейса

Примеры#

Рейс Аэрофлота SU 1234:

1{
2 "carrierCode": "SU",
3 "flightNumber": "1234"
4}

Рейс S7 Airlines S7 5:

1{
2 "carrierCode": "S7",
3 "flightNumber": "5"
4}

Использование#

marketingCarrier — авиакомпания, продающая билет
operatingCarrier — авиакомпания, фактически выполняющая рейс (может отличаться при codeshare)
preferredFlights — предпочитаемые рейсы при поиске

FlightType#

Тип рейса.

Багаж

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

Багаж#

Типы для описания норм багажа.

BaggageAllowance#

Норма багажа для тарифа.

Поле	Тип	Обязательно	Описание
`type`	BaggageType	Да	Тип багажа
`pieceAllowance`	PieceAllowance	Нет	Норма по количеству мест
`weightAllowance`	WeightAllowance	Нет	Норма по весу

Примечание: Указывается либо pieceAllowance, либо weightAllowance в зависимости от типа нормы.

BaggageType#

Тип багажа.

Возможные значения:

carryOn — ручная кладь
checked — зарегистрированный багаж

PieceAllowance#

Норма багажа по количеству мест (PC concept).

Поле	Тип	Обязательно	Описание
`totalPieces`	integer	Да	Количество мест багажа
`weightPerPiece`	Weight	Нет	Вес одного места
`dimensions`	Dimensions	Нет	Размеры багажа

WeightAllowance#

Норма багажа по весу (weight concept).

Питание

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

Тарифы#

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

CabinType#

Класс обслуживания в самолете.

Возможные значения#

Значение	Описание	Буквенный код
`economy`	Эконом класс	Y
`premiumEconomy`	Премиум эконом	W
`business`	Бизнес класс	C
`first`	Первый класс	F

Примеры#

1"cabin": "business"

Использование#

В поиске для ограничения класса обслуживания:

1{
2 "searchCriteria": {
3 "fareConstraints": {
4 "cabin": "business"
5 }
6 }
7}

TariffType#

Вид тарифа по условиям доступа.

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

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}

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

Таксы и сборы

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

Таксы и сборы#

Типы для работы с таксами и сборами.

Taxes#

Структура такс с разбивкой по видам.

Поле	Тип	Обязательно	Описание
`total`	MonetaryAmount	Да	Общая сумма такс
`breakdown`	TaxBreakdown[]	Нет	Разбивка по видам такс

TaxBreakdown#

Детализация таксы по коду.

Поле	Тип	Обязательно	Описание
`code`	string	Да	Код таксы (YQ, YR, и т.д.)
`amount`	MonetaryAmount	Да	Сумма

Примеры кодов такс#

Наиболее распространенные коды такс:

YQ — топливный сбор авиакомпании
YR — сбор за обслуживание в аэропорту
XT — прочие сборы
RU — российские сборы

Пример#

 1{
 2 "total": {
 3 "currencyCode": "RUB",
 4 "value": 1300
 5 },
 6 "breakdown": [
 7 {
 8 "code": "YQ",
 9 "amount": {
10 "currencyCode": "RUB",
11 "value": 1000
12 }
13 },
14 {
15 "code": "YR",
16 "amount": {
17 "currencyCode": "RUB",
18 "value": 300
19 }
20 }
21 ]
22}

Время

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

Время#

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

TimeRange#

Временной диапазон в пределах дня.

Поле	Тип	Обязательно	Описание
`from`	string	Да	Начало диапазона в формате HH:MM (24-часовой формат)
`to`	string	Да	Конец диапазона в формате HH:MM (24-часовой формат)

Примеры#

Время вылета с 10:00 до 18:00:

1{
2 "from": "10:00",
3 "to": "18:00"
4}

Утренние рейсы с 06:00 до 12:00:

1{
2 "from": "06:00",
3 "to": "12:00"
4}

Использование#

Используется для ограничения времени вылета при поиске:

Документы

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

Документы#

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

Document#

Документ, удостоверяющий личность пассажира.

Поле	Тип	Обязательно	Описание
`lastName`	string	Да	Фамилия как в документе
`firstName`	string	Да	Имя как в документе
`middleName`	string	Нет	Отчество как в документе
`type`	DocumentType	Да	Тип документа
`series`	string	Нет	Серия документа (если применимо)
`number`	string	Да	Номер документа
`birthDate`	date	Нет	Дата рождения
`issueDate`	date	Нет	Дата выдачи документа
`expireDate`	date	Нет	Дата окончания срока действия
`country`	string	Да	Код страны (ISO 3166-1 alpha-2)

DocumentType#

Тип документа, удостоверяющего личность.

Системные типы

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

Системные типы#

Системные типы данных API.

Error#

Информация об ошибке.

Поле	Тип	Обязательно	Описание
`code`	string	Да	Код ошибки
`message`	string	Да	Сообщение об ошибке
`description`	string	Нет	Детальное описание ошибки
`errorId`	string (GUID v7)	Да	Уникальный идентификатор ошибки

Примеры#

1{
2 "error": {
3 "code": "NO_AVAILABILITY",
4 "message": "Нет доступных рейсов",
5 "description": "Для заданных параметров поиска не найдено доступных предложений",
6 "errorId": "018c5f2e-9b3a-7f4d-8e2c-1a2b3c4d5e6f"
7 }
8}

1{
2 "error": {
3 "code": "AUTHENTICATION_FAILED",
4 "message": "Authentication failed",
5 "errorId": "018c5f2e-9b3a-7f4d-8e2c-1a2b3c4d5e6f"
6 }
7}

Использование#

Поле error присутствует в ответе при возникновении ошибки. API возвращает HTTP 200 даже при ошибках, поэтому необходимо проверять наличие поля error в теле ответа.

Войдирование билета (Ticket Cancel)

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

Войдирование билета#

Отмена (войдирование/void) выписанного билета в течение 24 часов после выписки.

Эндпоинт: POST /avia/ticket_cancel

Описание#

Операция позволяет отменить (войдировать) выписанный билет без штрафов в течение установленного временного окна (обычно 24 часа). Войдирование доступно только для неиспользованных билетов.

Когда использовать#

Аннуляция ошибочно выписанного билета
Отмена билета сразу после выписки
Исправление ошибок в данных билета
Возврат средств без штрафов (в пределах временного окна)

Параметры запроса#

Обязательные параметры#

Параметр	Тип	Описание
`bookingId`	string (UUID)	Идентификатор бронирования
`ticketNumber`	string	Номер билета для отмены (13 цифр)

Пример запроса#

1{
2 "bookingId": "b1234567-89ab-cdef-0123-456789abcdef",
3 "ticketNumber": "5552123456789"
4}

Примеры ответов#

Успешный ответ#

Развернуть пример

1{
2 "success": true,
3 "voidedAt": "2025-12-10T17:45:00Z"
4}

Ответ с ошибкой - истекло время#

1{
2 "success": false,
3 "error": {
4 "code": "VOID_TIME_EXPIRED",
5 "message": "Время для войдирования истекло",
6 "description": "Билет может быть войдирован только в течение 24 часов после выписки"
7 }
8}

Ответ с ошибкой - билет использован#

1{
2 "success": false,
3 "error": {
4 "code": "TICKET_USED",
5 "message": "Билет уже использован",
6 "description": "Невозможно войдировать билет с использованными купонами"
7 }
8}

Структура ответа#

TicketCancelResponse#

Поле	Тип	Описание
`success`	boolean	Признак успешного войдирования
`voidedAt`	string (datetime)	Дата и время войдирования
`error`	Error	Информация об ошибке (если есть)

Типичные ошибки#

Код ошибки	Причина	Решение
`TICKET_NOT_FOUND`	Билет не найден	Проверьте номер билета
`VOID_TIME_EXPIRED`	Истекло время для войдирования	Используйте операцию возврата
`TICKET_USED`	Билет уже использован	Войдирование невозможно
`ALREADY_VOIDED`	Билет уже войдирован	Билет был отменен ранее
`VOID_NOT_ALLOWED`	Войдирование запрещено	Проверьте условия тарифа

Важные замечания#

Важно: