Обмен билета on Travel API - Документация

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

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_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`	Предложение истекло	Выполните новый расчет обмена

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

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