Пересчет стоимости бронирования (PNR Reprice)#
Получение актуальной цены для существующего бронирования.
Описание#
Эндпоинт: POST /api/avia/pnr_reprice
Возвращает актуальную тарификацию для бронирования с учетом текущих условий перевозчика. Используется для проверки изменений цены перед выпиской билета.
Использование#
Используйте этот запрос для получения актуальной цены бронирования перед выпиской билетов или при необходимости проверить текущую стоимость.
Основной сценарий#
- Получите
bookingIdсуществующего бронирования - Запросите актуальную тарификацию
- Сравните с исходной ценой
- Если цена изменилась — информируйте пользователя
- При подтверждении — выписывайте билет
Базовый пример#
Минимальный запрос для пересчета стоимости:
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— его формат зависит от поставщика и не фиксирован.
Связанные операции#
- Создание PNR - создание бронирования
- Получение PNR - получение деталей бронирования
- Выписка билета - оформление билетов после проверки цены