サイトコントローラー・PMS との連携

VibeBooking は、貴社システムから施設の部屋タイプ・料金・在庫を取得し、AI アシスタント経由の予約を貴社システムに登録します。貴社の API に合わせたアダプター（接続部分）は、当社が作ります。

貴社システムに求める機能

タイムアウトとサーバーエラーは、予約が登録された可能性があるものとして扱います。

予約が入るまでの流れ

sequenceDiagram
    autonumber
    participant G as 宿泊者・AI アシスタント
    participant V as VibeBooking
    participant S as Stripe（施設のアカウント）
    participant P as 貴社システム
    G->>V: 予約を申し込む
    V->>P: 最新の料金と在庫を確認
    V->>S: カードの与信を取る
    V->>P: 予約を登録（当社の予約番号つき）
    P-->>V: 予約 ID
    V->>S: 売上を確定
    V-->>G: 予約確定のメール

決済

決済の主体は施設で、代金は施設ご自身の Stripe アカウントに入ります。当社は代金を預からず、手数料もいただきません。貴社システムに登録できなかった予約は、与信を取り消し、請求しません。

当社側で担保すること

• すべての API 呼び出しは冪等です。再送しても結果は変わりません。
• 同じ予約を二重に登録しません。
• 決済に失敗した予約は、貴社システム上でもキャンセルします。
• 予約データを定期的に突合し、差異があればお知らせします。
• 宿泊者情報は予約専用のデータベースにのみ保存し、貴社には必要な項目だけを送ります。

貴社システムから応答がないときは、次のように処理します。

sequenceDiagram
    participant V as VibeBooking
    participant P as 貴社システム
    participant S as Stripe
    V-xP: 予約を登録
    Note over V,P: タイムアウト。再送しない
    V->>P: 当社の予約番号で検索
    alt 予約あり
        V->>S: 売上を確定
    else 予約なし
        V->>S: 与信を取り消す
    end

送信する予約データ

予約 1 件ごとに、当社から貴社システムへ次の項目を送ります。

項目を受け取れる欄が貴社システムにないときは、備考に 1 行ずつ書きます。旅券の確認は、チェックイン時に施設が対面で行います。カード情報は送りません。

API の方式

貴社の API がどの方式でも、必要であれば当社が貴社専用のアダプターを作ります。予約の仕組みはそのままで、貴社ごとに接続部分だけを足すつくりです。

OpenTravel との対応

当社は OpenTravel（OTA）のメッセージを標準ではやり取りしません。貴社の API が OTA の XML（http://www.opentravel.org/OTA/2003/05）を使うときは、OTA_HotelResNotifRQ で次のように送ります。要素名とコードは OpenTravel 2017B に基づきます。

カード情報（PaymentCard）は送りません。

対応済みのシステム

Channex

ふりがなと宿泊者名簿の項目は、フロントで読めるよう、予約の備考（notes）に日本語で 1 行ずつ書きます。

• Channex に Booking CRS アプリをインストールしておく必要があります。
• 在庫を戻す設定は初期状態でオフです。施設が Channex でオンにします。
• API は非同期のため、登録直後の照会で 404 が返ることがあります。当社はこれを予約なしとは判断しません。

施設側の接続

施設は VibeBooking のコンソールで Channex の API キーを貼り付けて連携します。連携すると、「施設」の「連携」に Channex が表示されます。

お問い合わせ

連携をご検討の事業者様は、hello@vibebooking.ai までご連絡ください。