Перейти до вмісту
Блог

API бронювання готелів і авіаквитків: одна подорож, два бронювання

Редакція Tekravel
Написано за допомогою ШІ

У тікеті написано: "додати готелі до сценарію рейсів, один checkout, одна сума". Розумне прохання від продакт-менеджера, і звучить як робота на день, бо пошук рейсів у вас уже є і сторінка оплати теж. Через три тижні команда сперечається, що має статися, коли авіакомпанія підтверджує, а готель ні. API бронювання готелів і авіаквитків — це не одна інтеграція з двома видами результатів. Це дві інтеграції, що ділять один кошик.

Що раніше код це визнає, то менше його доведеться переписувати. Далі — частина, яку посібники з інтеграції пропускають: чим відрізняються дві половини, яку з них фіксувати першою і чим має бути подорож у вашій моделі даних.

Дві половини поводяться по-різному

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

ПитанняРейсГотель
Що у вас після бронюванняБронювання (PNR), яке ще не є квиткомПідтвердження, яке зазвичай уже і є проданим продуктом
Скільки діє цінаДоки тариф не перерахують під час бронювання, і він може відрізнятися від пошукуДоки не спливе тариф, а тариф може змінитися між доступністю та бронюванням
Що його підтверджуєВиписка квитка, часто з обмеженням у часіПідтвердження постачальника, іноді миттєве, іноді в очікуванні
Як його скасуватиVoid, якщо встигнути рано, інакше повернення за правилами тарифу, часто зі штрафомСкасування за політикою самого тарифу, у багатьох тарифах безкоштовне до певного строку
Що змінює суму наприкінціТариф, збори, іноді валюта тарифуПодатки й збори, що сплачуються в готелі, тип харчування, фактично наданий номер

Ви можете не погодитися з якимось рядком, бо постачальники різні, але не з формою: одна половина має крок виписки квитка, інша має вікно скасування, і в часі вони не збігаються. Авіаційний бік цієї послідовності ми розібрали в інтеграції API бронювання авіаквитків, а проблему повільного постачальника на боці готелів — у дизайні клієнта API доступності готелів. Цей текст починається там, де ті закінчуються: на стику.

Що бронювати першим?

Ніхто не скаже вам, що це рішення дизайну, а саме воно визначає, скільки коштує збій.

Припустімо, клієнт купує рейс і готель на ті самі дати. Ви надсилаєте одне бронювання, потім інше. Може статися три речі: обидва вдаються, або одне не вдається, або одне не вдається після того, як інше вже вдалося. Перше — гарний день. Два інші визначають вашу чергу підтримки.

Якщо спершу виписати квиток, а готель потім відмовить, у вас клієнт із місцем у літаку до міста і без номера, з якого вже списали гроші, і повернення за квиток зі штрафом. Якщо спершу забронювати готель, а рейс потім не вдасться, ви тримаєте номер, який часто можна скасувати безкоштовно, тож виправлення дешеве. Зворотний ризик теж реальний, бо неповоротний тариф готелю — найгірше, що можна тримати, тож прочитайте умови скасування тарифу, перш ніж пускати його першим.

Це практичне правило, а не закон, і суть у тому, щоб обрати порядок свідомо. Фіксуйте половину, яку легше скасувати, перед тією, яку важче, перевіряйте ціну обох безпосередньо перед фіксацією будь-якої і запишіть, що ви робите в кожному з трьох випадків. Рев'юери рідко питають. Клієнти завжди дізнаються.

Одна подорож, два бронювання

Форма, що витримує навантаження, — це запис подорожі, якому належать два бронювання, кожне з власним референсом, власним статусом і власними умовами. Клієнт бачить одну суму. Ваша база бачить два рядки, а сума — це те, що ви обчислюєте, а не те, що існує в постачальника.

Тримайте два статуси окремо. "Підтверджено" для готелю і "виписано" для рейсу — не один і той самий стан, і одна колонка статусу, яка їх сплющує, рано чи пізно напише "заброньовано" над наполовину заброньованою подорожжю.

Тримайте окремо й два набори умов зміни, і показуйте їх. Показана сума приховує, що перенести дати в одній половині безкоштовно, а в іншій платно. Якщо ваш front-end показує "змінити дати" однією кнопкою, вирішіть, що вона робить, коли зрушити можна лише одну половину, перш ніж клієнт з'ясує це за вас. Те саме стосується націнки: якщо ви додаєте її за кожною послугою, як роблять більшість продавців, сума подорожі — це дві націнки, і повернення за одну половину має знати, яку націнку воно повертає. Гроші — це місце, де поєднана подорож стає дорогою, бо позиції розраховуються в різні строки, а повернення за рейс приходить не тоді, коли приходить скасування готелю.

Де ця платформа

Прямо: платформа надає API рейсів і готелів, а доступ починається з розмови, а не з ключа самообслуговування. Сервіси вмикаються для кожного tenant окремо, тож tenant, що продає готелі, а не тури, не несе з собою турової частини. Ніщо тут не обіцяє одного виклику, який атомарно бронює обидві половини, і не проєктуйте так, ніби обіцяє. Ставтеся до них як до двох бронювань, якими вони є, у межах подорожі, що належить вам.

Якщо хочете побачити справжні виклики й умови, перш ніж будувати на них, почніть зі сторінки travel API і принесіть порядок, у якому збираєтеся бронювати. Якщо ще вирішуєте, що дає безкоштовний доступ, безкоштовний API бронювання готелів розкладає види "безкоштовного".

Скільки коштує помилка

Дорога версія — тиха. Клієнт має квиток до міста, номера вже немає, і перше, що ви про це чуєте, — повідомлення вночі з аеропорту. Дешевше, але все одно реально: checkout, що показує одну заспокійливу суму, а потім, після перевірки ціни, другу, на яку клієнт не погоджувався; повернення, яке повертає рейс і забуває про готель; і статус "заброньовано", тоді як постачальник каже інше.

Ніщо з цього не потребує хитрого рішення. Потрібно, щоб подорож була справжнім об'єктом, щоб порядок був рішенням, яке хтось записав, і щоб обидві ціни перевірялися ще раз в останню мить перед фіксацією будь-якої. Збудуйте це один раз, і checkout може виглядати так просто, як просив тікет.

Редакція Tekravel

Відділ travel-технологій

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