【チャネルマネージャーAPI】トラブルシューティングガイド

1. 連携エラーの発生兆候とよくある発生原因

接続確認時や運用中に予約システムとのデータ通信エラーが発生した際、JTB BÓKUN画面上で警告（エラー）が出力される場合があります。これらの代表的なエラー原因は以下の4点に絞られます。

• マッピングデータの欠落：商品同士は連携されているものの、その内部にある具体的な「料金」「料金カテゴリー」「開始時刻」などの個別項目が、未設定あるいはドロップダウン選択が空白になっている。
• 不適切なマッピングの設定：1対1のマッピング規則を無視した選択が行われている。または、自社システムに存在しない旧データ・別商品がJTB BÓKUN商品に関連付けられている。
• API要求応答（「/product/getById」）の通信失敗：JTB BÓKUN側から、自社システムに対して対象商品の情報を要求するエンドポイント「`/product/getById`」へのリクエストが、通信不良、自社側の内部データベースエラー、あるいは認証失効により失敗している（APIが正しいJSONレスポンスを返していない）。
• アドバンスでの意図しない連携トグルのアクティブ化：商品の「アドバンス」にて、「チャネルマネージャー API」のトグルが「ON」になっているが、「他システムとの連携」側の「チャネルマネージャーAPI」管理画面上で対象の商品マッピング（紐付け設定）が完了していない場合。この場合、JTB BÓKUNは「マッピングが存在しない」という内容の警告を出力します。

2. エラーの特定と具体的な解消手順（復旧フロー）

エラーの警告を検知した場合、システム担当者および運用マネージャーは、以下のステップに従って迅速かつ的確に対処を完了させてください。

■ ステップ1：現在のトグル設定の点検
不適切なアクティブ化（マッピングを作成していないのに連携がONになっている）が疑われる場合、対象商品の「アドバンス」に移動し、「チャネルマネージャー API」のトグルを一時的に「オフ（無効）」にします。これにより不適切な空き状況の確認要求による予約ストップを回避し、マッピング設定作業の準備に入ることができます。

■ ステップ2：マッピング画面への移行
管理画面の左ナビゲーションから「設定 – 他システムとの連携 – チャネルマネージャーAPI」を選択し、プラグインの管理画面へ入ります。

■ ステップ3：マッピングの再作成・更新
商品リストから、エラーが出ている、または未接続商品を見つけ、同じ行にある「マッピングを作成する」ボタンをクリックします。

■ ステップ4：マッピング詳細の紐付け直し
『【チャネルマネージャーAPI】商品の作成およびマッピング手順』に従い、サプライヤー、商品、各料金、各料金カテゴリ、各開始時刻を余すことなく正しく設定し直します。不一致（ミスマッチ）を解消するために、事前にJTB BÓKUNの商品に必要な設定項目を追加してから、再度マッピング画面を開いて紐付け直すプロセス（ 商品編集画面からコンポーネントを追加した後のリフレッシュ）を必要に応じて行ってください。

■ ステップ5：最終保存とステータスの確認
ページ最下部にある「Update（更新）」ボタンをクリックして変更を保存します。

■ ステップ6：連携状態の最終確認
「商品一覧」画面に戻り、対象商品名の横に「チャネルマネージャーAPI商品」というラベルが正常に表示したことを確認します。さらに「商品編集画面 > 空き状況」にアクセスし、カレンダー等のタブがグレイアウトされていることを確認します。これでトラブルシューティングおよび正常化プロセスは完了です。