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

В задаче написано: «добавить отели в поток покупки билетов, одна касса, один итог». Просьба продакт-менеджера разумная и звучит как работа на день, ведь поиск авиабилетов и страница оплаты у вас уже есть. Через три недели команда спорит, что делать, когда авиакомпания подтвердила, а отель — нет. API бронирования отелей и авиабилетов — это не одна интеграция с двумя видами результатов. Это две интеграции с общей корзиной.
Чем раньше код это признает, тем меньше придётся переписывать. Дальше — то, что обходят стороной руководства по интеграции: чем различаются две половины, какую подтверждать первой и чем должна быть поездка в вашей модели данных.
Две половины ведут себя по-разному
Обе приходят в JSON с ценой и ссылкой, поэтому в сети выглядят похоже. Но обещают они разное, как только ссылка у вас в руках.
| Вопрос | Перелёт | Отель |
|---|---|---|
| Что у вас на руках после брони | Бронь (PNR), которая ещё не билет | Подтверждение, которое обычно и есть проданный товар |
| Как долго действует цена | До переоценки тарифа при бронировании, а она может отличаться от поиска | До истечения тарифа; он может измениться между проверкой наличия и бронью |
| Что подтверждает бронь | Выписка билета, часто с лимитом по времени | Подтверждение поставщика — иногда мгновенное, иногда в ожидании |
| Как отменить | Void, если успели, иначе возврат по правилам тарифа, часто со штрафом | Отмена по условиям самого тарифа; у многих бесплатна до определённого срока |
| Что меняет сумму позже | Тариф, таксы, иногда валюта тарифа | Налоги и сборы на месте, тип питания, фактически выданный номер |
С отдельной строкой можно спорить, поставщики разные, но не с её формой: у одной половины есть этап выписки, у другой окно отмены, и по времени они не совпадают. Про перелётную часть последовательности мы писали в статье интеграция API бронирования авиабилетов, а про медленных поставщиков на стороне отеля — в статье проектирование клиента API доступности отелей. Этот материал начинается там, где они заканчиваются, — на стыке.
Что бронировать первым?
Никто не говорит, что это проектное решение, а именно оно определяет цену сбоя.
Клиент покупает перелёт и отель на одни даты. Вы отправляете одну бронь, затем другую. Возможны три исхода: обе прошли, одна сорвалась, или одна сорвалась уже после успеха другой. Первый — хороший день. Остальные два определяют очередь в поддержке.
Если сначала выписать билет, а отель потом откажет, у вас клиент с местом в самолёте до города, но без номера, с уже списанными деньгами и возвратом билета со штрафом. Если сначала забронировать отель, а перелёт потом сорвётся, у вас номер, который часто можно отменить бесплатно, и исправить это дёшево. Обратный риск тоже реален: невозвратный тариф отеля — худшее, что можно держать, поэтому до того, как пустить его первым, прочтите условия отмены.
Это практическое правило, а не закон; важно выбрать порядок осознанно. Подтверждайте сначала ту половину, которую проще отменить, проверяйте цену обеих прямо перед подтверждением любой из них и записывайте, что вы делаете в каждом из трёх исходов. Ревьюеры спрашивают редко. Клиенты узнают всегда.
Одна поездка, две брони
Устойчивая форма — запись поездки, которой принадлежат две брони, у каждой своя ссылка, свой статус и свои условия. Клиент видит один итог. База видит две строки, а итог — это сумма, которую считаете вы, а не то, что существует у поставщика.
Держите два статуса раздельно. «Подтверждён» для отеля и «выписан» для перелёта — не одно и то же состояние, и единый столбец статуса, который их сплющивает, рано или поздно напишет «забронировано» поверх наполовину забронированной поездки.
Условия изменения тоже держите раздельно и показывайте. Общий итог скрывает, что перенос дат бесплатен для одной половины и платный для другой. Если во фронтенде «изменить даты» — одна кнопка, решите, что она делает, когда сдвинуть можно только одну половину, раньше, чем это обнаружит клиент. То же с наценкой: если вы добавляете её на каждую услугу, как большинство, итог поездки — это две наценки, и возврат по одной половине должен знать, какую наценку он возвращает. Деньги — то место, где объединённая поездка дорожает: строки закрываются в разные сроки, и возврат за перелёт приходит не тогда, когда приходит отмена отеля.
Где здесь платформа
Прямо: платформа предоставляет API авиабилетов и отелей, а доступ начинается с разговора, а не с самообслуживаемого ключа. Услуги включаются для каждого арендатора, поэтому арендатор, который продаёт отели, а не туры, не несёт на себе поверхность туров. Единого вызова, атомарно бронирующего обе половины, здесь не обещается, и проектировать так, будто он есть, не стоит. Относитесь к ним как к двум броням под поездкой, которой владеете вы.
Если хотите увидеть реальные вызовы и условия, прежде чем что-то строить, начните со страницы API для путешествий и приходите с порядком, в котором собираетесь бронировать. Если вы ещё решаете, что даёт бесплатный доступ, в материале бесплатный API бронирования отелей описаны виды бесплатного.
Во сколько обходится ошибка
Дорогой вариант — тихий. Клиенту выписан билет в город, а номера уже нет, и первое, что вы слышите, — сообщение ночью из аэропорта. Дешевле, но тоже реально: касса показывает один успокаивающий итог, а после проверки цены — второе число, с которым клиент не соглашался; возврат, который вернул перелёт и забыл отель; статус «забронировано», когда поставщик говорит иное.
Ничего из этого не требует хитрого решения. Нужно, чтобы поездка была настоящим объектом, порядок — решением, которое кто-то записал, а обе цены перепроверялись в последний момент перед подтверждением любой из них. Постройте это один раз, и касса сможет выглядеть так просто, как просили в задаче.