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

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

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