建構取消規定

詳細了解取消規定如何在 Rapid API 上運作。

簡介

所有在預訂時不可全額退款的房價類型，將在 API 回應中顯示 refundable=false 。

每個房價的取消規定取決於 Rapid 商店供應情況 API 中 cancel_penalties 和 nonrefundable_date_ranges 物件的組合。

nonrefundable_date_ranges 物件會定義在預訂時完全不得退款的任何住宿日期。因此，此物件始終優先於任何 cancel_penalties 物件中規定的其他取消規定。使用 nonrefundable_date_ranges 物件設定在預訂時不得退款的住宿日期是可選的。請注意，nonrefundable_date_range 全包，即每晚的價格加上「結束」日期的任何稅金和其他費用也會一併收取。
cancel_penalties 物件列出了任何額外的取消費用詳情，並提供多種選項可建構這些規定。詳細資訊包括指定取消期限的開始日期和結束日期、取消費用類型和金額。取消費用類型包括固定金額、住宿天數和占總費用的百分比。

請注意，如果 nonrefundable_date_ranges 物件中定義了房價的不得退款日期，則除了 cancel_penalties 物件中規定的其他取消費用，還會針對這些晚數收取取消費用。

您可以在擷取預訂服務 (管理預訂 API) 的 cancel_refund 物件中找到該筆預訂的退款金額。每次入住金額的退款狀態詳情請參見下文。

**請注意：**收取 cancel_penalties 的開始時間和結束時間以旅宿當地時區為準。

以下提供用於建立取消規定內容的指南，是為了協助旅宿準確地解釋取消規定，並傳達給終端旅客，或者在 API 以未列出的格式回傳規定時，向旅客顯示不得退款的訊息。

規定範本

取消規定由以下範本表示的四個主要期間組成。請包含所有四個期間，以正確呈現取消規定。

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 - 金額計算取消費用

API 回應：

"refundable": true,
"cancel_penalties": [
    {
        "start": "2022-08-26T23:59:00.000+07:00",
        "end": "2022-09-29T23:59:00.000+07:00",
        "amount": "
        ",
        "currency": "USD"
    }
],

預訂詳情：

旅客於 2022 年 7 月 5 日預訂
入住日期為 2022 年 9 月 29 日
退房日期為 2022 年 10 月 6 日

取消規定說明：

在 2022 年 8 月 26 日 23:59 (GMT +7:00) 之前可免費取消。
在 2022 年 8 月 26 日 23:59 (GMT +7:00) 之後取消，將收取 200 美元的費用。
取消期限的結束時間是 9 月 29 日 23: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 日 23:59 (GMT +7:00) 之前取消：
- 在不得退款日期範圍內 (2022 年 9 月 30 日 - 2022 年 10 月 1 日及 2022 年 10 月 5 日 - 2022 年 10 月 6 日) 的任何預訂晚數自預訂時間起不得退款。
- 在不得退款日期範圍外的晚數都可以免費取消。
在 2022 年 8 月 26 日 23:59 (GMT +7:00) 和 2022 年 9 月 29 日 23:59 (GMT +7:00) 之間取消：
- 在不得退款的日期範圍 (2022 年 9 月 30 日至 2022 年 10 月 1 日和 2022 年 10 月 5 日至 2022 年 10 月 6 日) 內的任何預訂晚數，自預訂之日起均不得退款。
- 除了不得退款的晚數外，還將收取 200 美元的取消費用。
取消期限的結束時間是 9 月 29 日 23: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 日 23:59 (GMT +7:00) 之前可免費取消。
在 2022 年 8 月 26 日 23:59 (GMT +7:00) 之後取消將收取 1 晚取消費用。
取消期限的結束時間是 9 月 29 日 23:59 (GMT +7:00)，屆時預訂將完全不得退款。
若您在預訂後未依約入住，或者在入住登記後取消或變更此預訂，旅宿可能會酌情向您收取最高達預訂金額 100% 的取消費用。

**備註：**如果預訂多晚住宿，將收取預訂第一晚的取消費用。

範例 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 日 23:59 (GMT +7:00) 之前可免費取消。
在 2022 年 8 月 26 日 23:59 (GMT +7:00) 之後取消將收取住宿金額 90% 的取消費用。
取消期限的結束時間是 2022 年 9 月 29 日 23: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 日 23:59 (GMT +7:00) 之前可免費取消。
2022 年 8 月 26 日 23: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 日 23:59 (GMT +7:00) 之前免費取消。
2022 年 8 月 31 日 23:59 (GMT +7:00) - 2022 年 12 月 9 日 23:59 (GMT +7:00) 取消將收取住宿金額 70% 的取消費用。
在 2022 年 12 月 9 日 23:59 (GMT +7:00) 到 2022 年 12 月 12 日 (GMT +7:00) 期間之後取消，將收取住宿金額 90% 的取消費用。
取消期限的結束時間是 2022 年 12 月 12 日 23: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 日 00:00 (GMT +1:00)，屆時預訂將完全不得退款。
若您在預訂後未依約入住，或者在入住登記後取消或變更此預訂，旅宿可能會酌情向您收取最高達預訂金額 100% 的取消費用。

範例 9 - 不得退款的單次住宿金額

API 回應：

"refundable" : true,
      "cancel_refund" : {
        "amount" : "-784.57",
        "currency" : "EUR"
      },
      "cancel_penalties" : [ {
        "currency" : "EUR",
        "nights" : "1",
        "start" : "2022-11-16T18:00:00.000+04:00",
        "end" : "2022-11-19T18:00:00.000+04:00"

取消規定說明：

只有在整個預訂均可退款的情況下，才可退還單次住宿金額。
取消此預訂會產生 1 晚的取消費用，因此整個預訂均不得退款；在這種情況下，整筆單次住宿金額皆不予退款。

建構取消規定

詳細了解取消規定如何在 Rapid API 上運作。

簡介

規定範本

1. 取消規定的例外期間

2. 免費取消期間

3. 如果 API 回應中有 `cancel_penalties`，則為適用取消費用期間 (可以有多個取消費用期間)

4. 延遲入住和預訂後未入住的期間

5. 單次住宿金額退款。

範例

範例 1 - 金額計算取消費用

範例 2 - 金額計算罰款 + 不得退款日期

範例 3 - 晚數計算取消費用

範例 4 - 百分比計算取消費用

範例 5 - 免費取消/無取消手續費

範例 6 - 不得退款

範例 7 - 層級取消

範例 8 - 部分退款

範例 9 - 不得退款的單次住宿金額

其他參考文件

旅客評論

簽章產生器

EPS 通知測試

COVID-19 Rapid 更新

建構取消規定

詳細了解取消規定如何在 Rapid API 上運作。

簡介

規定範本

1. 取消規定的例外期間

2. 免費取消期間

3. 如果 API 回應中有 cancel_penalties，則為適用取消費用期間 (可以有多個取消費用期間)

4. 延遲入住和預訂後未入住的期間

5. 單次住宿金額退款。

範例

範例 1 - 金額計算取消費用

範例 2 - 金額計算罰款 + 不得退款日期

範例 3 - 晚數計算取消費用

範例 4 - 百分比計算取消費用

範例 5 - 免費取消/無取消手續費

範例 6 - 不得退款

範例 7 - 層級取消

範例 8 - 部分退款

範例 9 - 不得退款的單次住宿金額

其他參考文件

旅客評論

簽章產生器

EPS 通知測試

COVID-19 Rapid 更新

3. 如果 API 回應中有 `cancel_penalties`，則為適用取消費用期間 (可以有多個取消費用期間)