Rapid Lodging APIでキャンセルポリシーがどのように機能するか、さらに詳しく理解しましょう。
予約時に全額返金可能ではないすべての料金タイプは、API 応答で refundable=false と表示されます。
各料金の特定のキャンセルポリシーは、Rapid Shop Availability API の cancel_penalties オブジェクトと nonrefundable_date_ranges オブジェクトの組み合わ せによって決定されます。
nonrefundable_date_ranges オブジェクトは、予約時に完全に返金不可の滞在期間を定義します。そのため、このオブジェクトは cancel_penalties オブジェクトで設定された追加のキャンセルポリシーよりも優先されます。nonrefundable_date_ranges オブジェクトを使用して、予約時に返金不可の滞在期間を設定することは任意です。 nonrefundable_date_range が含まれていることに注意してください。つまり、1 泊料金に加えて、「終了」日の税金や手数料も請求されます。cancel_penalties オブジェクトは追加のキャンセル料の詳細を設定し、これらのポリシーを構築するためのさまざまなオプションがあります。詳細には、指定されたキャンセル料適用期間の開始日と終了日、およびキャンセル料のタイプと値が含まれます。キャンセル料のタイプには、固定金額、宿泊数、合計料金に対する割合が含まれます。
nonrefundable_date_ranges オブジェクトで定義された料金に返金不可の期間がある場合、cancel_penalties オブジェクトで設定されているその他のキャンセル料に加えて、これらの宿泊料金が請求されることに注意してください。
予約の返金額は、Manage Booking API の一部として、Retrieve Booking サービス内の cancel_refund オブジェクトで確認できます。宿泊料金の返金ステータスの詳細については、以下を参照してください。
注 : cancel_penaltiesの開始時刻と終了時刻のタイムゾーンは宿泊施設の現地時間です。
キャンセルポリシーの作成に関する以下のガイドラインは、宿泊施設がキャンセルポリシーを正確に解釈してお客様に伝えたり、記載されていない形式で API がポリシーを返すときにお客様に返金不可のメッセージを表示したりする際に役立てることができます。
カリフォルニア州における最近のポリシー変更に準拠するため、Rapid APIを修正し、カリフォルニア州に所在するすべての施設について、check-inの時刻から72時間以内にキャンセルが行われない限り、予約作成タイムスタンプからちょうど24時間後にキャンセル期間が開始されるようにしました。エクスペディアのシステムは、この変更を自動的に行うように設定されています。
いくつか例を挙げましょう：
- カリフォルニア州内の施設では、キャンセルポリシーが設定されていない全額払い戻し可能な料金の場合、キャンセルポリシーは変更されません。
- カリフォルニア州内にある施設で、予約時からキャンセルペナルティが適用されるnon-refundable、キャンセルポリシーは予約作成日のちょうど24時間後からに変更されます。
- 施設の所在地がカリフォルニア州以外の場合、カリフォルニア州内で予約が行われたとしても、キャンセルポリシーは変更されません。
更新されたキャンセルペナルティウィンドウは、旅行者のショッピング中にAPIコールで自動的に表示されます。non-refundableの予約の場合、払い戻し可能フラグがfalse のままであることにお気づきかもしれません。ホテルの場合、このウィンドウは予約のタイムスタンプから24時間、Vrboのプロパティの場合、予約の翌日末までです。
APIは、GET/itinerariesリトリーブ呼び出しで、更新されたキャンセル・ペナルティ・ウィンドウを表示します。キャンセルポリシーは予約確認メールにも表示されます。
ショッピングAPI可用性レスポンスのrefundable booleanは、この変更では変更されません。レートがnon-refundable, の場合は、Rapid API'sフィルタリング機能を維持するため、refundable=false と表示されます。現在使用しているのと同じロジックを使用してこのパラメータをフィルタリングすることはできますが、インターフェイス要素を表示する際には、カリフォルニア州のキャンセルポリシーの変更を考慮する必要があります。
Retrieve Itineraryレスポンスのrefundable パラメータは、予約が現在修正されたキャンセルペナルティ期限内にあるかどうかを反映する必要があります。これにより、インベントリが取得されたときに予約が全額払い戻し可能かどうかを判断できます。
キャンセルポリシーは、次のテンプレートで表される 4 つの主要な期間で構成されます。 キャンセルポリシーを適切に表すために、4 つの期間をすべて含めるようにしましょう。
1. キャンセルポリシーの例外期間。
予約の確定を起点にキャンセル時に返金が行われない期間は nonrefundable_date_ranges オブジェクトで定義できます。この期間外の滞在期間は、cancel_penalties オブジェクト内で指定されたポリシーの対象となるため、予約された滞在の一部のみが例外期間内にある場合は、部分的な返金を受けることができます。
2. 無料キャンセル期間。
[最も早いキャンセル料適用期間の開始日時] までキャンセル料は無料です。注 : 返金不可期間 (nonrefundable_date_ranges オブジェクトで定義) 内にある予約済みの滞在期間は返金されませんが、この期間外の滞在期間は、cancel_penalties オブジェクトで指定された最も早いキャンセル料適用期間の開始時刻前にキャンセルが行われた場合、全額返金されます。
3. キャンセル料適用期間 (複数のキャンセル料金適用期間を設定可能) - API レスポンスに cancel_penalties が含まれる場合。
注 : 返 金不可期間 (nonrefundable_date_ranges オブジェクトで定義) 内にある予約済みの滞在期間は全額請求されますが、cancel_penalties オブジェクトで指定されたポリシーに従って、この期間外の滞在期間は返金されます。
金額ベースのキャンセル料
[キャンセル料適用期間の開始日時] 以降のキャンセルには、[金額] [通貨] のキャンセル料が発生します。
または
宿泊数ベースのキャンセル料
[キャンセル料適用期間の開始日時] 以降のキャンセルには、[宿泊数] 泊分のキャンセル料に加えて、税およびサービス料が発生します。
または
割合ベースのキャンセル料
[キャンセル料適用期間の開始日時] 以降のキャンセルには、合計価格の [割合]% 分のキャンセル料が発生します。 金額ベースと宿泊ベース、または金額ベースと割合ベースのキャンセル料を同時に設定することはできますが、同じ期間に対して宿泊ベースと割合ベースのキャンセル料を設定することはできません。
4. レイトチェックインとノーショー期間。
ご予約の施設にチェックインされなかった場合、またはチェックイン後に予約をキャンセルもしくは変更された場合、施設の自由裁量により予約金額の最大 100% のキャンセル料が発生する可能性があります。
直近のキャンセル料金適用期間の終了日が、直近のキャンセル日時になります。
5. 宿泊料金の返金。
1 日以上の宿泊も返金不可である場合、宿泊オブジェクトで返される宿泊料金は返金不可とみなされます。宿泊全体が全額返金可能な場合にのみ宿泊料金が返金されます。
例 1 - 金額ベースのキャンセル料
**API レスポンス : **
"refundable": true,
"cancel_penalties": [
{
"start": "2022-08-26T23:59:00.000+07:00",
"end": "2022-09-29T23:59:00.000+07:00",
"amount": "200",
"currency": "USD"
}
],
予約の詳細 :
- お客様の予約日は 2022 年 7 月 5 日
- チェックイン日は 2022 年 9 月 29 日
- チェックアウト日は 2022 年 10 月 6 日
キャンセルポリシーの内容 :
- 2022 年 8 月 26 日午後 11 時 59 分 (GMT +7:00) までキャンセル料は無料です。
- 2022 年 8 月 26 日午後 11 時 59 分 (GMT +7:00) 以降のキャンセルには、200 USD のキャンセル料が発生します。
- キャンセル料適用期間の終了時刻は 2022 年 9 月 29 日午後 11 時 59 分 (GMT +7:00) です。この時点から予約は全額返金不可になります。
- ご予約の施設にチェックインされなかった場合、またはチェックイン後に予約をキャンセルもしくは変更された場合、施設の自由裁量により予約金額の最大 100% のキャンセル料が発生する可能性があります。
注 : 複数の客室のリクエストの場合、返金されるキャンセル手数料の金額は客室の定員タイプ単位となるため、状況に応じてキャンセル手数料を乗算する必要があります。
例 2 - 金額ベースのキャンセル料 + 返金不可の期間
**API レスポンス : **
"refundable": false,
"cancel_penalties": [
{
"start": "2022-08-26T23:59:00.000+07:00",
"end": "2022-09-29T23:59:00.000+07:00",
"amount": "200",
"currency": "USD"
}
],
"nonrefundable_date_ranges": [
{
"start": "2022-09-30",
"end": "2022-10-01"
}
{ "start": "2022-10-05",
"end": "2022-10-06"
}
],
予約の詳細 :
- お客様の予約日は 2022 年 7 月 5 日
- チェックイン日は 2022 年 9 月 29 日
- チェックアウト日は 2022 年 10 月 7 日
キャンセルポリシーの内容 :
- 2022 年 8 月 26 日午後 11 時 59 分 (GMT +7:00) より前のキャンセル :
- 返金不可期間 (2022 年 9 月 30 日 ～ 2022 年 10 月 1 日、および 2022 年 10 月 5 日 ～ 2022 年 10 月 6 日) に予約された宿泊は、予約時から完全に返金不可となります。
- 返金不可期間外の宿泊については、キャンセルは無料です。
- 2022 年 8 月 26 日午後 11 時 59 分 (GMT +7:00) から 2022 年 9 月 29 日午後 11 時 59 分 (GMT +7:00) までのキャンセル :
- 返金不可期間 (2022 年 9 月 30 日 ～ 2022 年 10 月 1 日、および 2022 年 10 月 5 日 ～ 2022 年 10 月 6 日) に予約された宿泊は、予約時から完全に返金不可となります。
- 返金不可の宿泊数分の費用に加え、200 米ドルの手数料がかかります。
- キャンセル料適用期間の終了時刻は 2022 年 9 月 29 日午後 11 時 59 分 (GMT +7:00) です。この時点から予約は全額返金不可になります。
- ご予約の施設にチェックインされなかった場合、またはチェックイン後に予約をキャンセルもしくは変更された場合、施設の自由裁量により予約金額の最大 100% のキャンセル料が発生する可能性があります。
**注 : **
nonrefundable_date_ranges オブジェクトは、この方法で任意の cancel_penalties オブジェクトの期間と組み合わせることができます。- 複数の客室のリクエストの場合、返金されるキャンセル手数料の金額は客室の定員タイプ単位となるため、状況に応じてキャンセル手数料を乗算する必要があります。
例 3 - 宿泊数ベースのキャンセル料
**API レスポンス : **
"refundable": true,
"cancel_penalties": [
{
"start": "2022-08-26T23:59:00.000+07:00",
"end": "2022-09-29T23:59:00.000+07:00",
"nights": "1",
"currency": "USD"
}
],
予約の詳細 :
- お客様の予約日は 2022 年 7 月 5 日
- チェックイン日は 2022 年 9 月 29 日
- チェックアウト日は 2022 年 10 月 6 日
キャンセルポリシーの内容 :
- 2022 年 8 月 26 日午後 11 時 59 分 (GMT +7:00) までキャンセル料は無料です。
- 2022 年 8 月 26 日午後 11 時 59 分 (GMT +7:00) 以降のキャンセルには、1 泊分のキャンセル料が発生します。
- キャンセル料適用期間の終了時刻は 2022 年 9 月 29 日午後 11 時 59 分 (GMT +7:00) です。この時点から予約は全額返金不可になります。
- ご予約の施設にチェックインされなかった場合、またはチェックイン後に予約をキャンセルもしくは変更された場合、施設の自由裁量により予約金額の最大 100% のキャンセル料が発生する可能性があります。
注 : 複数泊予約されている場合、予約の 1 泊目に対してキャンセル料が請求されます。
例 4 - 割合ベースのキャンセル料
**API レスポンス : **
"refundable": true,
"cancel_penalties": [
{
"start": "2022-08-26T23:59:00.000+07:00",
"end": "2022-09-29T23:59:00.000+07:00",
"percent": "90%",
"currency": "USD"
}
],
予約の詳細 :
- お客様の予約日は 2022 年 7 月 5 日
- チェックイン日は 2022 年 9 月 29 日
- チェックアウト日は 2022 年 10 月 6 日
キャンセルポリシーの内容 :
- 2022 年 8 月 26 日午後 11 時 59 分 (GMT +7:00) までキャンセル料は無料です。
- 2022 年 8 月 26 日午後 11 時 59 分 (GMT +7:00) 以降のキャンセルには、宿泊料およびサービス料の 90% 分のキャンセル料が発生します。
- キャンセル料適用期間の終了時刻は 2022 年 9 月 29 日午後 11 時 59 分 (GMT +7:00) です。この時点から予約は全額返金不可になります。
- ご予約の施設にチェックインされなかった場合、またはチェックイン後に予約をキャンセルもしくは変更された場合、施設の自由裁量により予約金額の最大 100% のキャンセル料が発生する可能性があります。
例 5 - キャンセル料無料 / キャンセル料なし
**API レスポンス : **
"refundable": true,
"cancel_penalties": [
{
"start": "2022-08-26T23:59:00.000+07:00",
"end": "2022-09-29T23:59:00.000+07:00",
"nights": "0",
"currency": "USD"
}
],
予約の詳細 :
- お客様の予約日は 2022 年 7 月 5 日
- チェックイン日は 2022 年 9 月 29 日
- チェックアウト日は 2022 年 10 月 6 日
キャンセルポリシーの内容 :
- 2022 年 8 月 26 日午後 11 時 59 分 (GMT +7:00) までキャンセル料は無料です。
- 2022 年 8 月 26 日午後 11 時 59 分 (GMT +7:00) からチェックイン日 (2022 年 9 月 29 日) までのキャンセルは無料です。キャンセル料は発生しません。
- ご予約の施設にチェックインされなかった場合、またはチェックイン後に予約をキャンセルもしくは変更された場合、施設の自由裁量により予約金額の最大 100% のキャンセル料が発生する可能性があります。
例 6 - 返金不可
予約が全額返金不可の場合、cancel_penalties ウィンドウの開始日時は予約日時より前になります。
**API レスポンス : **
"cancel_penalties": [
{
"start": "2022-11-29T10:47:19.727+00:00",
"end": "2023-01-05T23:59:00.000+00:00",
"percent": "100%",
"currency": "USD"
}
],
予約の詳細 :
- お客様の予約日は 2022 年 11 月 30 日
- チェックイン日は 2023 年 1 月 5 日
- チェックアウト日は 2023 年 1 月 7 日
キャンセルポリシー テキスト :
- ご予約をキャンセルされた場合、返金は行われず、今後の宿泊に使用できる優待クーポンの発行もありません。
例 7 - 段階的なキャンセル
段階的なキャンセルポリシーにより、施設は、キャンセル時の通知の金額に応じて異なるキャンセル料をお客様に請求できます。通常は、滞在期間が近づくほどキャンセル料が高くなります。
**API レスポンス : **
"refundable": true,
"cancel_penalties": [
{
"start": "2022-08-31T23:59:00.000+07:00",
"end": "2022-12-09T23:59:00.000+07:00",
"percent": "70%",
"currency": "USD"
},
{
"start": "2022-12-09T23:59:00.000+07:00",
"end": "2022-12-12T23:59:00.000+07:00",
"percent": "90%",
"currency": "USD"
}
],
予約の詳細 :
- お客様の予約日は 2022 年 7 月 5 日
- チェックイン日は 2022 年 12 月 12 日
- チェックアウト日は 2022 年 12 月 22 日
キャンセルポリシーの内容 :
- 2022 年 8 月 31 日午後 11 時 59 分 (GMT +7:00) までキャンセルは無料です。
- 2022 年 8 月 31 日午後 11 時 59 分 (GMT +7:00) から 2022 年 12 月 9 日午後 11 時 59 分 (GMT +7:00) までのキャンセルには、宿泊料およびサービス料の 70% 分のキャンセル料が発生します。
- 2022 年 12 月 9 日午後 11 時 59 分 (GMT +7:00) から 2022 年 12 月 12 日午後 11 時 59 分 (GMT +7:00) までのキャンセルには、宿泊料およびサービス料の 90% 分のキャンセル料が発生します。
- キャンセル料適用期間の終了時刻は 2022 年 12 月 12 日午後 11 時 59 分 (GMT +7:00) です。この時点から予約は全額返金不可になります。
- ご予約の施設にチェックインされなかった場合、またはチェックイン後に予約をキャンセルもしくは変更された場合、施設の自由裁量により予約金額の最大 100% のキャンセル料が発生する可能性があります。
例 8 - 一部返金可
**API レスポンス : **
"refundable": false
"cancel_penalties": [
{
"start": "2022-11-27T22:21:15.996+01:00",
"end": "2023-01-10T18:00:00.000+01:00",
"percent": "90%",
"currency": "USD"
}
],
予約の詳細 :
- お客様の予約日は 2022 年 11 月 28 日
- チェックイン日は 2023 年 1 月 10 日
- チェックアウト日は 2023 年 1 月 14 日
キャンセルポリシーの内容 :
- 予約確定以降のすべてのキャンセルで 90% のキャンセル料が発生します。
- キャンセル料適用期間の終了時刻は 2023 年 1 月 10 日午前 0 時 0 分 (GMT +1:00) です。この時点から予約は全額返金不可になります。
- ご予約の施設にチェックインされなかった場合、またはチェックイン後に予約をキャンセルもしくは変更された場合、施設の自由裁量により予約金額の最大 100% のキャンセル料が発生する可能性があります。
例 9 - 返金不可の宿泊料金
**API レスポンス : **
"refundable" : false,
"cancel_penalties" : [
{
"start" : "2022-11-16T18:00:00.000+04:00",
"end" : "2022-11-19T18:00:00.000+04:00",
"nights" : "1",
"currency" : "EUR"
}
],
キャンセルポリシーの内容 :
- 予約全体が返金可能な場合にのみ宿泊料金の返金が可能です。
- この予約をキャンセルすると 1 泊分のキャンセル料が発生するため、予約全体は返金不可であり、この場合は宿泊料金が返金されません。
