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

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_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 - получение номеров билетов
Обмен билета - изменение билета
Возврат билета - возврат билета

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

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

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

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

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

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

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

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

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

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

Структура TicketDocument#

Структура Ticket#

Структура Passenger#

Структура Document#

Структура BonusCard#

Структура Coupon#

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

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

Структура Price#

Структура Amount#

Структура Tax#

Структура IssueData#

Структура VendorLocator#

Структура Payment#

Структура BankCard#

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

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

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

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