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

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_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	Сумма данного сбора

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

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

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

Расчет возврата билета on Travel API - Документация