1. 自社システム vs JTB BÓKUN：役割と管理項目の明確な切り分け
システム連携後、情報の上書きや管理の手間を防ぐため、どの項目をどちらのシステムで制御・編集すべきかの切り分け（権限の役割分担）を定義します。以下の表に役割分担の原則を示します。
|
管理項目 |
自社システムでの編集・管理 |
JTB BÓKUNでの編集・管理 |
|
空き状況・在庫 (Availability) |
管理する（信頼できる唯一の情報源） |
システム制御下（グレーアウト） |
|
臨時販売停止 (Closures) |
管理する（ツアー催行の中止判断） |
自社システムの設定に自動同期。 |
|
電子チケットバーコード |
自社独自バーコードを発行して |
リセラーへバーコードを自動配信。 |
|
販売価格 (Prices) |
自社システム内で変更可能。 |
管理する（主たる設定・上書き箇所） |
|
商品説明・画像 (Content) |
自社システム内で変更可能。 |
管理する（OTA提供用の基本情報） |
|
販売チャネル接続 (Sellers) |
管理・操作できません。 |
管理する（最重要機能） |
|
各種ポリシー・締切時間 |
管理・操作できません。 |
管理する |
|
予約時質問 (Questions) |
管理・操作できません。 |
管理する |
2. 双方のシステムで完全に一致させるべき4大要素
以下の4項目に少しでも不一致がある場合、予約エラー（Booking Failure）を誘発し、販売機会の損失を招きます。マッピング設定時およびシステム変更時には、確実に情報が1対1で一致していることを厳密に管理してください。
① 料金（Rates）：自社システム側の料金コード（Rate ID / Option ID）と、JTB BÓKUNの対応する料金を完全に一致させます。
② 料金カテゴリー（Pricing categories）：「大人（Adult）」「子供（Child）」などの区分が完全に一対一で対応していなければなりません。
③ 開始時刻（Start times）：ツアーの開催時間（例: 朝 09:00、午後 14:00）は、分・秒単位まで双方のシステムで同一にする必要があります。
④ 追加オプション（Extras）：有料・無料の追加コンテンツオプションがある場合、そのすべての種類を双方のシステムで一対一で正確に紐付けます。
3. 予約・キャンセル・変更時の通信処理メカニズム
接続開始後、予約に関わるあらゆるトランザクションは、システム間をミリ秒単位のスピードで駆け巡り、自動連携されます。具体的な通信内容は以下の通りです。
- 新規予約：ViatorやGetYourGuide等のOTA、またはリセラーを通じて新規予約が入ると、Bókunは直ちに対象商品のリアルタイム空き状況を自社システムに問い合わせ（Shallow/Deep Search）、確保に成功すると同時に予約情報（顧客名、枚数、予約時刻など）をプッシュし、在庫が確定します。
- 予約キャンセル：OTAまたはリセラー側でお客様が予約をキャンセルした場合、キャンセル要求は自動でJTB BÓKUNに連携され、そこから自社システムへと送信（プッシュ）されます。自社システム側でこれを受信すると、在庫の返還と予約ステータスの変更が自動的に実行されます。
- 予約内容の変更（Amendments）：お客様がOTA側で「参加人数の変更（追加/削減）」を行ったり、「予約日程・時間の変更」を要求したりした場合、これらの変更指示データもすべて自動でJTB BÓKUNを中継し、自社システム側へ連携・更新されます。
- アロケーション（配分在庫）とリセラーIDの自動追跡：アロケーションの割り当ては、すべて自社システム（外部システム）側で中央制御できます。JTB BÓKUNは予約発生時に、提携リセラーを示す固有のベンダー識別子である「seller Id（セラーID）」を一緒に自社システムに引き渡します。自社システムはこのセラーIDを判別することで、どのOTAや代理店からきた予約かを特定し、代理店ごとのアロケーション在庫の調整を自在に行うことができます。
- セーフティスイッチの設置場所：JTB BÓKUN管理画面において、商品の編集画面を開き、「アドバンス」 > 「体験設定」 > 「外部チャネルマネージャーAPI」の順にメニューを展開すると、「これは外部のチャネルマネージャーAPI接続の商品です。」という切り替え用トグルスイッチが表示されます。
- システムダウン時の対応フロー：万が一、自社システムがダウンし、APIが正常に応答を返さなくなった場合、このトグルをクリックして「OFF（無効）」に変更してください。
- 切り替え時のシステム挙動と効果：トグルを無効化しても、それまでに紐付けた自社システムとJTB BÓKUN商品のマッピング設定データは消去されることなく「内部に完全に維持」されます。ただ「リアルタイム連携API通信のみがOFF」になります。この状態になると、JTB BÓKUNは自社システムへのリアルタイム空き状況の問い合わせを停止し、代替として「JTB BÓKUN側カレンダーの在庫・空き状況設定」を使用して販売を継続します。これにより、自社システムが数時間にわたって復旧しない状況下でも、OTAでの販売を急停止することなく、JTB BÓKUN側の在庫数制御によってオーバーブッキングを防ぎながら予約を受け付け続けることができます。復旧完了後は、このトグルを「ON（有効）」に戻すだけで、一瞬にして元のリアルタイム自動同期運用に復帰できます。
4. システムダウン時の緊急機能「セーフティスイッチ（Safety Switch）」の運用
API連携における最大のリスクである「自社システム側のシステム障害（ネットワーク遮断、サーバークラッシュ、メンテナンスの遅延）」に備え、JTB BÓKUNには即時に連携を安全な手動運用へ切り替える「セーフティスイッチ（Safety Switch）」が標準搭載されています。
- セーフティスイッチの設置場所：JTB BÓKUN管理画面において、商品の編集画面を開き、「アドバンス」 > 「体験設定」の順にメニューを展開すると、「外部チャネルマネージャーAPI」（これは外部のチャネルマネージャーAPI接続の商品です。）という切り替え用トグルスイッチが表示されます。
- システムダウン時の対応フロー：万が一、自社システムがダウンし、APIが正常に応答を返さなくなった場合、このトグルをクリックして「OFF（無効）」に変更してください。
- 切り替え時のシステム挙動と効果：トグルを無効化しても、それまでに紐付けた自社システムとJTB BÓKUN商品のマッピング設定データは消去されることなく「内部に完全に維持」されます。ただ「リアルタイム連携API通信のみがOFF」になります。この状態になると、JTB BÓKUNは自社システムへのリアルタイム空き状況の問い合わせを停止し、代替として「JTB BÓKUN側カレンダーの在庫・空き状況設定」を使用して販売を継続します。これにより、自社システムが数時間にわたって復旧しない状況下でも、OTAでの販売を急停止することなく、JTB BÓKUN側の在庫数制御によってオーバーブッキングを防ぎながら予約を受け付け続けることができます。復旧完了後は、このトグルを「ON（有効）」に戻すだけで、一瞬にして元のリアルタイム自動同期運用に復帰できます。