ホテルAPI連携
Hotelbeds API連携：リアルタイム料金、予約、バウチャー
HotelbedsのアカウントをPHPTRAVELSに接続し、自社ホテルと並べて販売できます。リアルタイムの料金と空室、決済前の料金再確認、即時確定、PDFバウチャー、変更とキャンセルに対応します。
- リアルタイム料金と空室
- 決済前の料金再確認
- バウチャーとキャンセル
- マッピングとキャッシュ
仕組み
ホテル予約エンジンの中で動くHotelbeds
Hotelbedsは独立系のB2Bベッドバンクで、契約ホテルの在庫をAPI経由で旅行会社に提供しています。PHPTRAVELSはお客様自身の認証情報でこのAPIを呼び出し、検索と料金再確認から確定、バウチャー、キャンセルまでの一連の流れを実行します。ログ、リトライ、idempotencyキーを備えているため、タイムアウトが重複予約になることはありません。
- HotelbedsのAPI keyとシークレット、利用可能なマーケットと通貨を取得
- 管理画面にキーを登録し、マーケットやチャネル別にマークアップを設定
- 目的地、ホテル、客室・食事コードをマッピングし、コンテンツをキャッシュ
- テスト環境で検索、料金再確認、予約、バウチャー、キャンセルを検証
- 契約で必要な場合は認定を完了し、本番環境に切り替え
- 環境
- テスト
- エンドポイント
- api.test.hotelbeds.com
- 認証情報
- API key：•••• · Secret：••••
- マークアップ
- ネット料金に12%
- マーケットと通貨
- ES, AE · EUR
検索と予約
食事条件、料金タイプ、キャンセル規定付きのHotelbeds客室
Hotelbedsの各検索結果には、宿泊客やエージェントが比較する情報と、予約フローに必要なルールが含まれます。
- 4★Rambla Garden Hotelダブルルーム · 朝食付き$486滞在合計
- 5★Port Vell Suitesジュニアスイート · 2食付き$742滞在合計
- Eixample Apartments1ベッドルームアパートメント · 素泊まり$395滞在合計
マッピングとキャッシュ
目的地、ホテル、客室タイプのマッピングと有効期限付きコンテンツキャッシュ。予約確定時にクリアされます。
料金再確認
再確認が必要な料金は決済前に再計算され、宿泊客はHotelbedsが確定した金額を支払います。
備考と規定
料金の備考、キャンセル期限と手数料を予約前に表示し、バウチャーにも記載します。
リトライとidempotency
指数バックオフ、サーキットブレーカー、idempotencyキーでタイムアウトによる重複予約を防ぎます。
サプライヤーログ
リクエストとレスポンスのログ、エラートレース、レート制限への対応。監査証跡としてエクスポートできます。
多通貨表示
Hotelbedsのネット料金を、為替と端数処理のルールに沿って宿泊客の通貨で表示します。
予約フロー
Hotelbedsの検索からバウチャー、キャンセルまで
PHPTRAVELSがHotelbedsの予約ごとに実行する手順です。一般向けサイトでもエージェントでも同じ流れです。
検索
目的地、日程、人数で空室を検索し、自社ホテルと合わせて表示。
料金再確認
再確認対象の料金を再計算し、規定を最新化。
決済
宿泊者情報と決済。カードの売上確定はHotelbedsの確定まで保留。
確定
idempotencyキー付きで予約を送信し、Hotelbedsの予約番号を保存。
バウチャー
サプライヤー番号と備考入りのPDFバウチャーを宿泊客にメール送信。
変更・キャンセル
料金規定に沿って変更とキャンセルを処理し、管理画面から返金。
在庫
ほかのホテル仕入れ先と並ぶHotelbeds
Hotelbedsは宿泊モジュールのサプライヤーの一つなので、その客室は自社契約や他のベッドバンクと同じ検索に表示されます。
Hotelbedsのホテル
お客様のHotelbedsアカウントのホテルコンテンツ、客室、食事条件、料金、規定。
送迎とアクティビティ
契約でAPIが有効になっていれば、Hotelbedsの送迎とアクティビティも追加できます。
他のサプライヤーと直契約
自社契約ホテルと他のホテルAPI。それぞれ独自のマークアップルールを設定できます。
接続できるホテルサプライヤー：
Agoda
Amadeus
Booking.com
Hotelbeds
Hotelston
RateHawk
Stuba
TBO Holidays
Travelport
Wanderbeds
バックオフィス
Hotelbedsの販売を一つの管理画面で
Hotelbeds予約の利益、エージェント、決済、サプライヤー記録を、他のすべての商品と同じダッシュボードで管理します。
マークアップと手数料
Hotelbedsのネット料金に、マーケット、都市、ホテル、チャネル別の定額または定率で設定。
エージェントとサブエージェント
与信枠、手数料、承認ルールを備えたHotelbeds予約用のB2Bポータル。
決済
カード、保存済みトークン、オフライン決済。確定時に売上確定、キャンセル時に返金。
サプライヤー番号
Hotelbedsの番号で予約を検索し、バウチャーの再送や変更の追跡が可能。
アラート
予約失敗、料金再確認時の価格変動、サプライヤーエラーを通知。
レポート
Hotelbedsの予約、利益、支払予定額をすぐにエクスポート可能。
比較
Hotelbedsコネクターの自社開発とPHPTRAVELSの比較
多くのチームはHotelbeds APIの自社実装から始めます。既製の連携と比べて、一般的に必要になる作業は次のとおりです。
| 項目 | 自社開発 | PHPTRAVELS |
|---|---|---|
| 予約フロー | 自社開発検索、再確認、予約、キャンセルの呼び出しを開発者が実装・検証 | PHPTRAVELS検索、料金再確認、確定、バウチャー、キャンセルをホテルモジュールに搭載 |
| コンテンツのマッピング | 自社開発客室・食事コードをプロジェクトごとに手作業でマッピング | PHPTRAVELS目的地、ホテル、客室のマッピングとコンテンツキャッシュ |
| タイムアウトとエラー | 自社開発リトライを設計しないと重複予約のおそれ | PHPTRAVELS全予約にリトライ、バックオフ、idempotencyキー |
| サイトとエージェント | 自社開発予約サイトとエージェントポータルは別途構築が必要 | PHPTRAVELSB2CサイトとB2Bエージェントポータルを同じ環境で提供 |
| 運用 | 自社開発ログやアラートは後回しになりがち | PHPTRAVELSサプライヤーログ、アラート、エクスポート可能な監査証跡 |
| サプライヤー追加 | 自社開発新しいサプライヤーごとに別プロジェクト | PHPTRAVELS同じ管理画面から他のホテル、航空券、レンタカーAPIを追加 |
活用例
PHPTRAVELSでHotelbedsを販売する企業
オンライン旅行会社
自社ブランドで大規模なホテルカタログを提供し、Hotelbedsの客室を直契約の特価と並べて販売。
B2B旅行会社
サブエージェントが自分の料金でHotelbedsのホテルを予約し、与信枠やウォレットで支払い。
DMCとツアーオペレーター
Hotelbedsのホテル、送迎、アクティビティをパッケージや旅程に組み合わせ。
PHPTRAVELSを選ぶ理由
契約もプラットフォームもコードもお客様のもの
ソースコード付き
商用ライセンスでセルフホスト。開発者がHotelbedsのフローを拡張できます。
お客様のHotelbedsアカウント
契約、ネット料金、キーはお客様が保有し、自社環境に保存されます。
24言語
右から左に書く言語も含め、各市場の言語と通貨でHotelbedsのホテルを販売。
B2CとB2B
一般向けサイトとエージェントポータルを一つの環境で運用。
HotelbedsのアカウントをPHPTRAVELSのホテルモジュールに接続し、宿泊客やエージェントがHotelbedsのリアルタイム料金と空室を検索できるようにします。料金再確認、予約、バウチャー、変更、キャンセルはPHPTRAVELSが処理します。
はい。Hotelbedsと契約し、お客様専用のAPI key、シークレット、利用可能なマーケットと通貨を受け取ります。一部のマーケットでは本番アクセスの前に認定が必要です。
いいえ。Hotelbedsは独立系のB2Bベッドバンクです。PHPTRAVELSはHotelbedsとExpediaにそれぞれ個別に連携しており、同じ環境で両方を使えます。
BedsonlineはHotelbedsグループの旅行会社向けブランドです。PHPTRAVELSはHotelbedsのAPI経由で接続し、コンテンツをホテルモジュールにマッピングします。
はい。Hotelbedsとの契約でそれらのAPIが有効になっていれば対応します。単独でもホテルと組み合わせても販売できます。
プランと、有効にするHotelbeds商品や決済フローによって異なります。プランはStartupの$2499（買い切りライセンス）から。料金ページをご覧いただくか、営業に見積もりをご依頼ください。