エラーコード

エラーは3つの形で返ります。認証エラーは HTTP 401、ビジネスルールのエラーは HTTP 200 内の success: false、予約送信のエラーは BookingPushRS.Error です。このページではすべてのコードを一覧で示します。

認証エラー#

HTTPレスポンス原因
401{"success": false, "error": "Authentication required"}トークンがない、不明、または Bearer の形式が不正。
200message: partner_is_not_foundログイン：キーペアが一致しない。
200message: hotel_is_not_foundログイン：hotelSeoUrl に該当するホテルがない。
200message: hotel_permission_is_not_foundログイン：パートナーにこのホテルへのアクセス権がない。

message コード#

snake_case のテキストコードで、success: false とともに返ります。

messageエンドポイント説明
hotel_id_is_not_foundほとんどのエンドポイントhotelID が送信されていません。
start_date_is_not_found / end_date_is_not_found空室状況日付パラメーターがありません。
online_cupon_is_not_foundクーポンコードが存在しない、無効、期限切れ、または利用できません。
mail_host_is_not_foundメール設定オンラインチャネルに SMTP が設定されていません。
hotel_company_info_could_not_foundバーチャル POS 情報ホテルに決済プロバイダーが設定されていません。
bank_info_is_not_found決済（タイプ 3）オンライン販売用に有効化された銀行口座がありません。
required_input_info_not_submitted決済（タイプ 10）必須フィールドが不足しています。errors[] に不足しているフィールドが示されます。
country_info_sent_incorrectly決済（タイプ 10）countryID が国一覧にありません。
there_is_missing_info_in_the_shopping_cart決済（タイプ 10）カート項目に id、name、piece、price のいずれかがありません。errors[] で該当項目が示されます。

客室一覧のエラーコード#

客室一覧（POST /external/online/roomType）は、数値の errorCode と人が読める errorMessage を返します。メッセージは language パラメーターに応じて翻訳されるため、プログラムでは errorCode で判定してください。

errorCode意味対処
10001ホテルが見つからないhotelID を確認してください。
10002パラメーター不足（hotelID、startDate、endDate、adultCount）必須フィールドを送信してください。
10003ホテルのオンライン販売が停止中ホテル側で管理パネルからオンラインチャネルを有効にする必要があります。
10004チャネルに公開された客室タイプがないホテル側で客室タイプをオンライン販売に公開する必要があります。
10022パラメーターが不正チェックインは本日以降、チェックアウトはチェックインより後、最大30泊、大人1–40名、子ども0–10名。
20001大人の空室が不足別の日程や人数を提案してください。
20002子どもの空室が不足子どもを受け入れられる客室が残っていません。
20003 / 20004大人と子どもの空室が不足全体の定員がリクエストを満たせません。

空室はあるものの特定の客室タイプを販売できない場合、その roomCount は 0 になり、理由は roomRestrictionMessage に入ります：closed_to_checkin、closed_to_checkout、passive_sales、minimum_stay、maximum_stay、closed_to_arrival、price_not_found。

予約送信のエラー#

エラー時の BookingPushRS には、Success: true の代わりに Error フィールドが入ります。

レスポンス · 200（エラー）
{
    "BookingPushRS": {
        "Error": "Could not register.",
        "BookingConfirmNumbers": [
            {
                "confirmTime": 1755500000,
                "bookingID": 0,
                "bookingType": "Book",
                "HMS_ID": null
            }
        ]
    }
}
Errorコード原因
No available data could be found.01ボディが空、または JSON を解析できない。Bookings[0].hotelID がない。
Hotel registration not found on HMS.02ホテルがオンラインチャネルに接続されていない、またはチャネルが無効。
Could not register.—保存中のエラー（客室タイプ／食事条件の ID が不正、日付に矛盾がある）。
Failed to parse information.—構造に必要なフィールドが欠けている。

リトライの指針#

  • 401：一度だけ再ログインしてリクエストをリトライします。
  • 500 とネットワークエラー：1秒、2秒、4秒の間隔で最大3回まで試行します。予約送信をリトライするときは同じ ID を使ってください。既存のコードで Book を送信すると、重複予約は作成されずにレコードが更新されます。
  • success: false：リトライしないでください。パラメーターを修正するか、ゲストに代替案を提示してください。
  • サポートへのお問い合わせには、リクエストの全文（シークレットとカード情報はマスク）、レスポンス、発生日時を含めてください。
最終更新: 2026年9月21日誤りを見つけましたか？お知らせください