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

API бронирования отелей и авиабилетов: одна поездка, две брони

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

В задаче написано: «добавить отели в поток покупки билетов, одна касса, один итог». Просьба продакт-менеджера разумная и звучит как работа на день, ведь поиск авиабилетов и страница оплаты у вас уже есть. Через три недели команда спорит, что делать, когда авиакомпания подтвердила, а отель — нет. API бронирования отелей и авиабилетов — это не одна интеграция с двумя видами результатов. Это две интеграции с общей корзиной.

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

Две половины ведут себя по-разному

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

ВопросПерелётОтель
Что у вас на руках после брониБронь (PNR), которая ещё не билетПодтверждение, которое обычно и есть проданный товар
Как долго действует ценаДо переоценки тарифа при бронировании, а она может отличаться от поискаДо истечения тарифа; он может измениться между проверкой наличия и бронью
Что подтверждает броньВыписка билета, часто с лимитом по времениПодтверждение поставщика — иногда мгновенное, иногда в ожидании
Как отменитьVoid, если успели, иначе возврат по правилам тарифа, часто со штрафомОтмена по условиям самого тарифа; у многих бесплатна до определённого срока
Что меняет сумму позжеТариф, таксы, иногда валюта тарифаНалоги и сборы на месте, тип питания, фактически выданный номер

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

Что бронировать первым?

Никто не говорит, что это проектное решение, а именно оно определяет цену сбоя.

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

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

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

Одна поездка, две брони

Устойчивая форма — запись поездки, которой принадлежат две брони, у каждой своя ссылка, свой статус и свои условия. Клиент видит один итог. База видит две строки, а итог — это сумма, которую считаете вы, а не то, что существует у поставщика.

Держите два статуса раздельно. «Подтверждён» для отеля и «выписан» для перелёта — не одно и то же состояние, и единый столбец статуса, который их сплющивает, рано или поздно напишет «забронировано» поверх наполовину забронированной поездки.

Условия изменения тоже держите раздельно и показывайте. Общий итог скрывает, что перенос дат бесплатен для одной половины и платный для другой. Если во фронтенде «изменить даты» — одна кнопка, решите, что она делает, когда сдвинуть можно только одну половину, раньше, чем это обнаружит клиент. То же с наценкой: если вы добавляете её на каждую услугу, как большинство, итог поездки — это две наценки, и возврат по одной половине должен знать, какую наценку он возвращает. Деньги — то место, где объединённая поездка дорожает: строки закрываются в разные сроки, и возврат за перелёт приходит не тогда, когда приходит отмена отеля.

Где здесь платформа

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

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

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

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

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

Редакция Tekravel

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

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