Выписка и управление билетами on Travel API - Документация

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

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_cancel.

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

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

1{}

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

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

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

Войдирование билета (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`	Войдирование запрещено	Проверьте условия тарифа

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

Важно: