Пересчет стоимости бронирования (PNR Reprice)#

Получение актуальной цены для существующего бронирования.

Описание#

Эндпоинт: POST /api/avia/pnr_reprice

Возвращает актуальную тарификацию для бронирования с учетом текущих условий перевозчика. Используется для проверки изменений цены перед выпиской билета.

Использование#

Используйте этот запрос для получения актуальной цены бронирования перед выпиской билетов или при необходимости проверить текущую стоимость.

Основной сценарий#

  1. Получите bookingId существующего бронирования
  2. Запросите актуальную тарификацию
  3. Сравните с исходной ценой
  4. Если цена изменилась — информируйте пользователя
  5. При подтверждении — выписывайте билет

Базовый пример#

Минимальный запрос для пересчета стоимости:

1{
2  "bookingId": "019a0b6e-47eb-7157-926e-80691497ebfc"
3}

Ответ содержит актуальную тарификацию:

 1{
 2  "pricings": [
 3    {
 4      "paxType": "adt",
 5      "price": {
 6        "total": {
 7          "currencyCode": "RUB",
 8          "value": 9487
 9        },
10        "baseFare": {
11          "currencyCode": "RUB",
12          "value": 8950
13        },
14        "taxes": {
15          "total": {
16            "currencyCode": "RUB",
17            "value": 537
18          }
19        }
20      }
21    }
22  ]
23}

Детальная документация#


Когда использовать#

Перед выпиской билета#

Всегда проверяйте актуальность цены перед оформлением билетов:

1{
2  "bookingId": "019a0b6e-47eb-7157-926e-80691497ebfc"
3}

После длительного ожидания#

Если между созданием бронирования и оплатой прошло много времени.

Проверка изменений тарифа#

Когда необходимо убедиться, что условия тарифа не изменились.

Информирование пользователя#

Для отображения актуальной стоимости до момента оплаты.


Зачем нужен пересчет стоимости#

Изменение условий#

Между созданием бронирования и выпиской билета могут измениться:

  • Тарифы перевозчика
  • Таксы и сборы
  • Курсы валют
  • Топливные сборы

Снижение рисков#

Пересчет стоимости помогает избежать:

  • Отказов при выписке из-за несоответствия цены
  • Претензий от пассажиров по поводу изменения стоимости
  • Финансовых потерь при изменении тарифов

Прозрачность#

Показывайте пользователю актуальную цену перед оплатой.


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

Код ошибкиПричинаРешение
BOOKING_NOT_FOUNDБронирование не найдено или не принадлежит клиентуПроверьте bookingId
CURRENCY_RATE_NOT_AVAILABLEНет курса для конвертации сумм в валюту отображенияПовторите запрос позже
VALIDATION_ERRORОшибка валидации запроса (HTTP 400)Проверьте обязательные поля и форматы значений
NO_TARGETSПод запрос не нашлось ни одного поставщика: ни один не настроен либо все отсеяны на этапе подготовки запросаПроверьте настройки офисов и пресетов в личном кабинете; при сохранении ошибки обратитесь в поддержку
SUPPLIER_ERRORПоставщик вернул ошибку. Причина — текстом поставщика в поле messageРазберите message; при необходимости повторите запрос позже
SYSTEM_ERRORВнутренняя ошибка Travel APIПовторите запрос позже; при повторении обратитесь в поддержку с errorId

Ошибки, пришедшие от GDS/NDC-поставщика, возвращаются под кодом SUPPLIER_ERROR: отдельного кода на каждую причину отказа Travel API не формирует, причина передаётся текстом поставщика в поле message. Не завязывайте логику на разбор message — его формат зависит от поставщика и не фиксирован.

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