本文へスキップ
ブログ

ホテルと航空券の予約API:一つの旅行、二つの予約

Tekravel 編集部
AI の支援を受けて執筆

チケットにはこう書いてあります。「航空券の予約フローにホテルを追加。決済は一回、合計金額も一つ」。プロダクトマネージャーとしてはもっともな依頼で、一日で終わる作業に聞こえます。航空券の検索はすでにあり、決済ページもすでにあるからです。ところが三週間後、チームは航空会社が確定したのにホテルが確定しなかったらどうするのかで揉めています。ホテルと航空券の予約APIは、結果が二種類ある一つの連携ではありません。一つのカートを共有する二つの連携です。

コードがその事実を早く認めるほど、書き直すコードは少なくなります。ここから先は、連携ガイドが飛ばしてしまう部分です。二つの半分がどう違うのか、どちらを先に確定させるべきか、そしてデータモデルの中で「旅行」が何であるべきかを扱います。

二つの半分は同じようには振る舞わない

どちらも価格と参照番号を含むJSONで返ってくるので、通信上は似て見えます。しかし参照番号を手にした後で、それぞれが約束してくれる内容はまったく似ていません。

問い航空券ホテル
予約後に手元にあるものまだ航空券になっていない予約記録(PNR)たいていは販売した商品そのものである予約確認
価格が有効な期間予約時に運賃が再計算されるまでで、検索時と異なることがある料金の有効期限までで、空室照会から予約までの間に料金が変わることがある
何をもって確定とするか発券。多くの場合、期限付きサプライヤーの確定。即時のこともあれば、保留になることもある
取り消し方早ければボイド(void)、それ以降は運賃規則に沿った払い戻しで、手数料がかかることが多いその料金自体のポリシーに沿ったキャンセル。多くの料金では締め切りまで無料
終盤で金額を変えるもの運賃、税金、ときに運賃の通貨現地払いの税金や手数料、食事条件、実際に割り当てられた部屋

サプライヤーによって違うので、個々の行には異論があるかもしれません。それでも全体の形に異論はまずないはずです。片方には発券という段階があり、もう片方にはキャンセル可能期間があり、その二つは時間軸の上で揃いません。航空券側の流れは航空券予約APIの連携で、ホテル側の遅いサプライヤーの問題はホテル空室照会APIのクライアント設計で取り上げました。この記事は、その二本が終わる場所、つまり継ぎ目から始まります。

どちらを先に予約するか

これが設計上の判断だと誰も教えてくれません。しかし失敗のコストを決めるのは、まさにこの判断です。

顧客が同じ日程で航空券とホテルを買うとします。一方の予約を送り、続いてもう一方を送ります。起こりうることは三つです。両方成功する、片方が失敗する、もう片方が成功した後で片方が失敗する。一つ目は良い日です。残りの二つが、サポート窓口の行列の長さを決めます。

先に航空券を発券し、その後ホテルに断られた場合、ある都市への座席はあるのに泊まる部屋がない顧客が生まれます。支払いはすでに済んでいて、払い戻す航空券には手数料がかかります。先にホテルを押さえ、その後航空券が失敗した場合、多くは無料でキャンセルできる部屋を持っているだけなので、後始末は安く済みます。逆向きのリスクも現実にあります。キャンセルできないホテル料金は抱えておくには最悪のものなので、ホテルを先に送る前に、その料金のキャンセル条件を読んでください。

これは経験則であって法則ではありません。要点は、順序を意図して選ぶことです。取り消しやすい方を取り消しにくい方より先に確定させる。どちらかを確定させる直前に両方の価格を再確認する。三つの結果それぞれで何をするかを書き残す。レビュアーはまず尋ねません。顧客は必ず気づきます。

一つの旅行、二つの予約

長持ちする形は、一つの旅行レコードが二つの予約を所有する構造です。それぞれの予約が、自分の参照番号、自分のステータス、自分の条件を持ちます。顧客には合計金額が一つ見えます。データベースには行が二つあり、合計はあなたが計算する和であって、サプライヤー側に存在するものではありません。

二つのステータスは分けておいてください。ホテルの「確定」と航空券の「発券済み」は同じ状態ではありません。二つを一つにまとめたステータス列は、いずれ半分しか予約できていない旅行の上に「予約済み」と表示することになります。

二つの変更条件も分けて保存し、分けて見せてください。表示された合計金額は、日程変更が片方では無料、もう片方では有料だという事実を覆い隠します。フロントエンドに「日程を変更」というボタンが一つしかないなら、片方しか動かせないときにそのボタンが何をするのかを、顧客が代わりに見つけてしまう前に決めておく必要があります。マークアップも同じです。多くの販売者のようにサービスごとにマークアップを乗せているなら、旅行の合計には二つのマークアップが含まれ、片方を払い戻すときにはどのマークアップを返すのかを知っていなければなりません。結合した旅行が高くつくのはお金の部分です。各項目は別々のスケジュールで精算され、航空券の払い戻しはホテルのキャンセルと同じタイミングでは届きません。

このプラットフォームの立ち位置

率直に言えば、このプラットフォームは航空券とホテルのAPIを提供しており、利用はセルフサービスのキー発行ではなく、相談から始まります。サービスはテナントごとに有効化されるので、ホテルは売るがツアーは売らないテナントがツアーの機能を抱え込むことはありません。両方の半分を一回の呼び出しでアトミックに予約することは約束しておらず、そうであるかのように設計すべきでもありません。二つを本来の姿である二件の予約として扱い、その上にあなたが所有する旅行を置いてください。

実際の呼び出しと条件を確認してから設計したい場合は、旅行APIのページから始め、予約する予定の順序を持ってきてください。無料のアクセスで何が得られるかをまだ検討中なら、無料のホテル予約APIが「無料」の種類を整理しています。

間違えたときのコスト

一番高くつくのは静かな失敗です。顧客はある都市への航空券を持っているのに部屋がなく、あなたがそれを最初に知るのは夜中に空港から届くメッセージです。それより安いものの現実に起きることもあります。安心させる合計金額を一つ見せておきながら、価格の再確認の後に顧客が同意していない二つ目の金額を出す決済画面。航空券は払い戻したのにホテルを忘れた返金。サプライヤーは違うことを言っているのに「予約済み」と表示するステータス。

どれも気の利いた解決策は要りません。必要なのは、旅行を実在するオブジェクトにすること、予約の順序を誰かが書き残した判断にすること、そしてどちらかが確定する直前に両方の価格を最後にもう一度確認することです。一度これを作ってしまえば、決済画面はチケットが求めたとおりシンプルに見えても構いません。

Tekravel 編集部

旅行テクノロジー担当

Tekravelの旅行テクノロジー担当は、業界の読者に向けて書いています。旅行会社の経営者、ホールセラー、そして両者をつなぐ開発者です。すべての記事は、公開前に記事が扱うプラットフォーム上で確認されます。