Перейти к содержимому
Блог

API цен на авиабилеты: цифра в выдаче ещё не тариф

Редакция Tekravel
Написано с помощью ИИ

Демо работает. Разработчик подключает API цен на авиабилеты к календарю самых дешёвых дней для вылета, сетка заполняется числами, все в комнате довольны. Потом первый настоящий клиент выбирает дату, видит на странице результатов сумму меньше, чем на странице оплаты, и пишет в поддержку со скриншотом. Ничего не сломано. API сделал то, о чём его просили: ответил на вопрос о цене, а сайт принял ответ за обещание.

Цена — это предложение с короткой памятью

Авиатариф не наклейка, приклеенная к креслу. Это класс бронирования, который открывается и закрывается по мере продажи мест, а его сумма зависит от состава пассажиров, точных рейсов, сборов задействованных аэропортов и валюты котировки. Ответ с ценой — снимок, сделанный в один момент для одного набора входных данных. Отнеситесь к нему как к факту о прошлом — и построите правильную вещь; как к факту о настоящем — и месяц уйдёт на возвраты.

Поэтому полезный вопрос для разработчика никогда не сводится к тому, какая цена. Он в том, что это за цена, насколько она стара и что система сделает, если она окажется неверной.

Три числа, которые все называют ценой

Большинство поставщиков возвращает все три где-то в документации, нередко под одним и тем же именем поля. Разделите их в своей модели данных с первого дня.

СостояниеОткуда берётсяСвежестьМожно продавать?Что показывать
Цена для просмотраКешированный или агрегированный поиск, рассчитанный на скорость и охватМожет быть устаревшей, не посчитана для ваших пассажировНетФормулировка «от» и пометка, что цена может измениться
Рассчитанное предложениеЖивой запрос по точному маршруту, типам пассажиров и тарифуСвежее в момент вызова, с сроком действия или сигналом пересчётаДа, пока не истечётИтог, налоги отдельно, правила тарифа
Выписанная суммаЧто авиакомпания или система выписки реально списала при заказеОкончательнаяУже проданоКвитанция, сверенная с предложением

Цена для просмотра делает возможными календари и плашки «от», и строить её полезно. Но это не тот же объект, что во второй строке. Ошибка — одно поле price, в которое стекаются все три.

На практике это три типа или три таблицы в коде, а не один с флагом. Цене для просмотра позволено ошибаться по мелочи, ведь она лишь приглашение нажать. Рассчитанное предложение — обязательство, которое вы собираетесь принять от своего имени, поэтому оно хранится со временем получения, с входными данными, которые его породили, и с идентификатором, который поставщик потребует при заказе. Выписанная сумма — это бухгалтерия. Когда поддержка спрашивает, почему клиент заплатил не то число, что было в письме, ответ лежит в зазоре между строками, и прочесть его можно только если вы сохранили все три.

Что должен нести ответ с ценой

Голое число не годится для построения оплаты. Читая пример ответа поставщика, ищите следующее и с подозрением относитесь ко всему, что приходит свободным текстом.

  • Валюта, указанная в самом ответе, а не предположенная по вашему аккаунту.
  • Базовый тариф и налоги раздельно, чтобы показать расшифровку и чтобы смена налога не выглядела сменой тарифа.
  • Типы пассажиров, для которых посчитана цена. Цена взрослого, умноженная на три, — не семейный тариф.
  • Правила тарифа и багаж как структурированные данные, ведь именно они решают, действительно ли дешёвый вариант дешевле для вашего клиента.
  • Срок действия или сигнал пересчёта: метка времени либо явное указание, что перед заказом нужно пересчитать цену.

Последний пункт пропускают чаще всего. Если ничто в ответе не говорит, сколько живёт предложение, вы гадаете, а гадание происходит в продакшене.

Пересчитывайте цену до заказа, а не после

В самом безопасном ритме есть правило. Поиск — для просмотра. Когда клиент выбирает маршрут, запросите живое рассчитанное предложение именно для этого маршрута и этих пассажиров. Покажите клиенту этот итог. Только после этого создавайте заказ. Если живая цена отличается от цены на странице результатов, скажите об этом клиенту до оплаты, простыми словами, а не после неё.

Пропустите средний шаг — и вы унаследуете разницу. Либо вы спишете больше, чем видел клиент, и потеряете продажу на странице оплаты, либо выполните меньшую сумму, и разрыв выйдет из вашей маржи. Небольшое агентство способно пережить это несколько раз, но не как принцип проекта.

О чём спросить в письменном виде до интеграции

Документация описывает счастливый путь. Поведение, которое стоит вам денег, прячется в ответах на короткий список вопросов, и лучше иметь их в письме, чем в разговоре.

  1. Цена в ответе поиска живая или из кеша, и указано ли это в самом ответе?
  2. Есть ли отдельный вызов расчёта цены для точного маршрута и обязателен ли он перед заказом?
  3. Что происходит при заказе, если цена сдвинулась: отказ, новая цена в ответе или молчаливая выписка по новой сумме?
  4. Как расшифрованы налоги и сборы перевозчика и могут ли они меняться между расчётом и выпиской?
  5. В какой валюте считается цена и где происходит конвертация, если клиент видит другую?
  6. Сколько остаётся действительным рассчитанное предложение и как вы об этом узнаете?

Поставщик, отвечающий точно, думал об оплате. Тот, кто отвечает «всё всегда актуально», не дал вам ничего, что можно проверить. Если проверить поведение самостоятельно нельзя, это повод посмотреть на всю систему иначе, прежде чем строить на ней.

Во сколько обходится ошибка

Редко она проявляется громко. Она выглядит как небольшой провал на шаге оплаты, который никто не связывает с ценой, как обращения в поддержку, начинающиеся словами «цена изменилась», как клиент, поверивший странице результатов и больше не верящий. Сотрудники в итоге вручную перепроверяют тарифы перед выпиской. Кто-то в конце предлагает правило, округляющее цены вверх для подстраховки, и сайт становится дорогим на единственном экране, где люди сравнивают. Каждая из этих статей — налог на решение, которое в начале было дёшево принять правильно.

Где находится эта платформа

Платформа предоставляет API авиабилетов и отелей, которые включаются для каждого арендатора отдельно. Доступ начинается с разговора, а не с ключа самообслуживания: нет формы, которая выдаст вам токен и таблицу лимитов. Мы не публикуем здесь задержки, охват или число тарифов, потому что число, проверку которого мы не можем показать, не стоит печатать. Что вы можете, так это принести перечисленные вопросы в этот разговор и попросить показать ответ для рассчитанного предложения, а не только для поиска. Если вы на этом этапе, всё начинается со страницы API для путешествий.

Редакция Tekravel

Отдел travel-технологий

Отдел travel-технологий Tekravel пишет для профессионалов рынка: владельцев агентств, консолидаторов и разработчиков, которые их интегрируют. Каждая статья проверяется на той самой платформе, которую описывает, до публикации.