有價差變更

透過 Rapid 的「有價差變更 API」，合作夥伴為旅客提供自助服務選項時，無需取消和重新預訂即可調整預訂的重要詳情。

簡介

靈活性仍然是旅行者的首要任務，對於需要隨著旅行計劃的變化而更改現有預訂詳細資訊的旅客來說，建立無縫體驗非常重要。

當此類預訂變更影響成本時，它們被稱為硬變更。Rapid 的 Hard Change API 可讓您透過 API 支援日期、客房類型和占用率修改來建立或改進您的 traveler-facing 或 agent-facing 更改體驗。

Rapid 的「有價差變更 API」有助於實現以下變更類型：

未來可以調整日期或完全替換新的日期範圍。但請注意，全新的入住日期不得超過原預訂日期後一年。
原始預訂的客房類型可以升級或降級。例如，標準兩張大床的預訂可以升級為豪華加大雙人床的預訂。
居住人數可以增加或減少。
可供應客房的入住日期和入住人數 (以參數傳遞) 可同時更改。

可以在任何單一客房上進行 Expedia-contracted 更改，在 Expedia-contracted 庫存上進行快速預訂。這包括 same-day 更改，只要它們是在 check-in 之前進行的，儘管可能會受到酒店的處罰。

請注意，當飯店確定的 penalty等於原始預訂價值時，non-refundable 預訂將不會出現變更選項。

這為您的代理商和旅客提供了更好的 self-serviceability，並減少了需要 Expedia 服務支援的手動變更工作。

此外，您還可以使用行程歷史記錄功能，查看對預訂所做的所有變更記錄。

硬性改變的好處

**更快解決預訂變更並留住您的旅客：**代理商不再需要登入單獨的工具或致電 Expedia 代理來進行預訂變更，從而節省您的時間和服務成本。此外，透過避免完全取消預訂，旅客不會感到需要重新啟動購物流程，這樣您就不太可能流失旅客，讓他們轉而向競爭對手預訂。

**盡可能確保最後可用的客房並維持原始定價：**旅客花時間為他們的旅行選擇合適的住宿。對於部分屬性，硬更改保留了原始的客房，這意味著不會丟失最後一個可用的客房。雖然我們不能保證每晚的價格相同，但如果飯店允許，您的旅客可以享受與原始預訂相同的每晚價格。

**透過保持行程 ID 一致性來改善旅行者體驗：**您可以透過硬性變更保留原始行程號，從而減少您、代理商和旅客的混淆。

運作方式

從 Rapid 的行程檢索端點要求行程，以查看預訂是否符合硬變更的條件。如果適用的話，shop_for_change記號化連結將顯示在行程擷取或行程搜尋回應中。

回應內連結範例：

[ 
  { 
    "itinerary_id": "1293878723", 
    ... 
    "rooms": [ 
      { 
        "id": "307234070", 
        ... 
        "links": { 
          "cancel": { 
            "method": "DELETE", 
            "href": "/v3/itineraries/9030154067083/rooms/d3a9f088-f8a9-4ac1-999d-d5bae3ae18b0?token=REhZAQsCBAEHU0cBW0NeEUocagFfXQcEMzUfXFREClxbAUBeUEsHC1UKTTtbAGxEXAZaFgAIKy5lfC4SURNFRltbUkFpQFVGRAtbC2tdBQtdU1EGAlBSBhRRVFIEFVJdA1UbUQNRA04LVVdZBwkAUVwFUQEXR1gXRw1WRGsWQQtfX1xWb1xXWQ8OVFYAVxZAXBJKWA1WPlEFCFMDAlVXC1NXH1YDBFMZAQVQVhkKBgMCHVdUUwIHBQFRVAZQARVJQVgSUhZCQGcIUAQHDV8NDB9VD1RRXQ4XUUdEQQYEAl4EC15KBgpdRyBQBlJfFkQOBQUNVgAGAFEHUAQ=" 
          }, 
          "change": { 
            "method": "PUT", 
            "href": "/v3/itineraries/9030154067083/rooms/d3a9f088-f8a9-4ac1-999d-d5bae3ae18b0?token=REhZAQsCBAEHU0cBW0NeEUocagFfXQcEMzUfXFREClxbAUBeUEsHC1UKTTtbAGxEXAZaFgAIKy5lfC4SURNFRltbUkFpQFVGRAtbC2tdBQtdU1EGAlBSBhRRVFIEFVJdA1UbUQNRA04LVVdZBwkAUVwFUQEXR1gXRw1WRGsWQQtfX1xWb1xXWQ8OVFYAVxZAXBJKWA1WPlEFCFMDAlVXC1NXH1YDBFMZAQVQVhkKBgMCHVdUUwIHBQFRVAZQARVJQVgSUhZCQGcIUAQHDV8NDB9VD1RRXQ4XUUdEQQYEAl4EC15KBgpdRyBQBlJfFkQOBQUNVgAGAFEHUAQ=" 
          }, 
          "shop_for_change": { 
            "method": "GET", 
            "href": "/v3/properties/480180/availability?token=XV1CBl5UWkdoCwc9RlNTCkoBCCp_bSd1QBRcX1BGEVEIVjlHXF1ZAVcHDVRRXlEbDVdQXEkBBlMFFFoBAFQbAAEHBgcOBlIED1sMQ0RRD1dURUwIBEpVAh8JUVhSTQdfVVlTXRo0YEVLWxETV10PE1gWXAFuRVwRQQpWQFFAVhxQRURaXlJsBlhXDQtaBm9QUQRaWg1NFQVTBVMBGVdRHwQBFAAHRQtQCFEXA0xaR0YIXlY9AFkNCFhaBTpFWkdYX2gQWAtbBAlUBRcABUBQQVBDFlxWVmwBW1tbDVxTOkEEFlc7DAENU1QIUgMBXAlXHkRZFkNdURFrFkcKAF4KXToNUAlVAwRbD1YXCUZdAEc-XQhWAGhfXAoLVlcDUltRBkhVUgYGHVZTUwEUDQBVCEwIAwRUXFEBVFMECQYfAExfF0xdDARvUgxfDlFaBmsXDVwLPgxXDwEIVQoIUlUHUB5TDQ1TUQ0BaEZWBVsWVm4ODgUERQ0UXlZWUwIOV1sHFl1dBF9ZCV5aBQ8FVV5RFh1RBQdISQddDwdeS1pBExYFXgsVRVgWF1oBSztGA1VTSwBbBwFqCgUMCVACBVICU1UbUwoABR0BAAEFSFYFUlcVUAENAgdVBl1XAAUEHhJIWQALBQdRA1MeRgEHUUpACFcBahZeQksGVl5BV0QPVztLU0RBWVBFARFREgtaBEJSSxhmWAYFWAlVBFMHA1BRBAYECkMDTQtHQQhfAWtRW10KWV8FPVUKBlJfCwsMBwMLABpTBUkHCh4ETFBAQA9bXmZSDVpTWF0Ea1tTB0dEBF0GGw9WQwdfDghRDVZrDEUGVWtRAAoABlsHVwNQUhEBXQsBRlUXV1E8Qw9cAwkLVQdSHFEOSAUEbAUBQFAjBQlBAyQDVxoEBlRvR11BXRZHWQ9WbFULClhRCFE5TV5NBFhpFldbDzxTRRFCAFZXGAkwMXdAAgpGXEdKHWZbDQBVXG1iRAdAURASXlpUOVYLXVoLDwE6RQ0SAglbUwIGTFEDFl1IDEVBXV1QOwMNW11ZC186VhdCSwdXBR8EbGZwRV0eWBVHXFcDPFYLVg9dCFRpSRdaFAFHFxhuUAYJBl4GAwwGEVZOWkNBXgxTOlZbDl1RX1JqXAUWbV0AQFlGURIFVgVaQFJHcAtdVw8SQVUPUw9RBVUDBA5dBA==" 
          } 
        } 
      } 
    ] 
  } 
]

可供應客房數/房價：

然後，您可以使用標記化連結呼叫可用性 API 中的附加費率端點shop_for_change，以搜尋相同/不同客房類型的不同日期和/或入住人數。可用性回應將傳回所有可用的房間，其價格符合新的 check-in/check-out 日期和/或入住率。此可用性回應與您已整合的常規購物流程的回應相同。使用與更新的 room、rate和 bed_group (適用變更) 相關的 price_check 連結。
sales_channel是可用性請求中的必填欄位。如果要求中未傳遞此欄位，則回應中將傳回錯誤。
如果原始預訂是飯店/物業代收價格，且 currency未在 shop_for_change請求中傳遞，則將返回飯店貨幣。例如，如果該酒店位於西班牙，並且是酒店/物業收費價格，但您以美元預訂，如果在 shop_for_change請求中未傳遞美元，則返回的價格將以歐元為單位。
選擇客房後，請使用 price_check URL 取得退款或額外費用以及任何罰款資訊 (如果有的話)。請注意，已發生的任何罰款都將記入退款或欠費金額中。更改或取消的罰金由飯店決定。
價格檢查連結會回傳新日期、客房和/或入住人數的 amount_owed 或 refund 和/或 penalty。
如果原始預訂是會員價格，合作夥伴應傳遞 rate_option=member參數才能查看可用的會員價格 (MOD)。我們不會 re-use 原始預訂的價值，因為我們希望確保在硬更改時旅行者確實以會員身份登錄，以便能夠正確接收會員價格。

硬性改變的局限性

不可能透過硬性改變來改變商業模式。例如，預訂不能從 expedia_collect更改為 property_collect。此類嘗試將在 **步驟中拋出 **400 - 錯誤請求shop_for_change 錯誤。

範例

{
    "type": "invalid_input",
    "message": "An invalid request was sent in, please check the nested errors for details.",
    "errors": [
        {
            "type": "filter.mismatch",
            "message": "Existing booking is property_collect, this cannot be changed.",
            "fields": [
                {
                    "name": "filter",
                    "type": "querystring",
                    "value": "expedia_collect"
                }
            ]
        }
    ]
}

也不可能透過硬更改來更改費率類型。例如，更改套餐預訂將在 shop_for_change步驟購買套餐價格。如果沒有適合更改的套餐價格，則會顯示無可用性。

內含退款資訊的「價格檢查」回應範例：

在此範例中，我們將住宿時間縮短 1 晚，每晚費用為 $148.37 美元，且沒有 penalty，因此該金額為 refund。

{ 
  "status": "available", 
  ... 
  "refund": { 
    "request_currency": { 
      "value": "148.37", 
      "currency": "USD" 
    }, 
    "billable_currency": { 
      "value": "148.37", 
      "currency": "USD" 
    } 
  } 
}

內含欠費金額和罰款的「價格檢查」回應範例：

在這個例子中，我們將住宿時間縮短 1 晚，每晚費用為 $148.37 美元，但取消該晚需支付 $200.00 美元 penalty，從而欠款 $51.63 美元。

{ 
  "status": "available", 
  ... 
  "amount_owed": { 
    "request_currency": { 
      "value": "51.63", 
      "currency": "USD" 
    }, 
    "billable_currency": { 
      "value": "51.63", 
      "currency": "USD" 
    } 
  }, 
  "penalty": { 
    "request_currency": { 
      "value": "200.00", 
      "currency": "USD" 
    }, 
    "billable_currency": { 
      "value": "200.00", 
      "currency": "USD" 
    } 
  } 
}

如果旅宿收取加人費用、旅宿費用和/或住宿費用，則這些資訊會在回應一併傳回。
commit 連結用於確認旅客想要更改日期並接受更改條款。發生以下情況時：
- 到期金額在變更提交的正文中，輸入新的付款資訊。接受的付款類型包括客戶卡、虛擬卡、公司卡或聯盟夥伴卡 (Affiliate Collect)。
- 退款旅行者無需輸入新的付款，退款將以原始付款方式進行。

重要提示：

如果「價格檢查」回應中有 amount_owed，則需提供付款資訊，否則系統會回傳錯誤訊息。
如果回應中有 refund，則不需要付款，但如果提供，則會被忽略。
如果沒有 amount_owed 或 refund，則不需提供付款資訊，若已提供則系統會予以忽略，不會回傳錯誤訊息。

「價格檢查」回應中的確認變更連結範例：

{ 
  "status": "available", 
  ... 
  "links": { 
    "commit": { 
      "method": "PUT", 
      "href": "/v3/itineraries/9030222954615/rooms/036df797-f9a1-4ad8-a1e9-1e9a621ecd0a/pricing?token=QldfCGlcUA4EXVRWAxBCAF4ARxBZVwVmEg9dBFAFV11SAVAHGFhVBgBJDQENBB4PCAAHSVACW1gAAFFXUVIEBxJbUkFVW1FbQz1bA2tGBFVXQ1EIcTw1d30scRBFSg9bVTtVW1YPVAZcCQIAWEtXR0sHQQBuXl1YC1oGBAVAQA1NU29HSUVWWUNKBwZdFVlcVwBVbgBKDk8SUBMUWwUAR0VUXAYfCFYSWABDDVFHXVwGb1cHBxAOAl9TFwRWUA5cXRo3ZEJFVk0TV1wORgdFUF0dEkdRUlZOV1xVB1kSB1wKCVsKAjpCBABXEVVrDFVeCQIAVgYAEhFVElA6Ek4WXVg3YHUtdnQxc0BfA0BmF1QVVBIFA1ZaS1IUAAISXlxZAENUC1FRWwtbXAoJBlYeAFYcAwBCFVJKElgDS25JF1tQDVRRPQpUDVYGVQwNVBIIB14EBBcOVFJUF1weARFCE11fARsFbTAiEVlSFF8BRlgMBjkGWQMIDQAKXwcRAQpXU1NfEEIIBgMFV0xSAxsAXR4EWA1FVxZmCRFcXQgETQhWFwRWUWYNBwlXDlcFVhVCSQxRWVEFU1AXSgpbQhZfXFNpR1JCWw1mYyN6IXV4Lnh9F1dZWwcObVQAXVRQSjlXXghPbFMEUg9LCQIAWEtXR1gLWhBfQwRXBFEdDgVAQQFfU0JBWVtUO0RXExBXBA1BWBFQVU9IE1ECUExRXAMAWRNWRxYSWg9RRz5CA0dAXV0Pb1gGXwVRBQZWWgRQGFYPClFPAwUFXRVZDVsLGQACAAABVwcMAwVbDBJDAUFHDFwLPVsAWFBSWVoLWgYNSFdXDgUVUAJRDU4NVgJdSwUAAQBQDAJTUwxbBEBBFFtJAEcVSD5RAQoECAQEXFpEUF0KVRdWF1FWbxZcDF0EBlUBA0wBBRpVVmcKVhNVeAAKQAd3VwsaV1sJAlsIVwwBOxIHDVwNCAtUbVpMAVRnCwANVgEBU1oADlBXEVdcE1oQQEg9AgkBVF8zMEMEB1NoBgdBU0pZFUJcW10KVUozQVNVCxMnUAYWWwddOQVWV1NdBE0UUBJaWldZRgEmHFN2QwEETRxFAUEHUUQCeEcGADdDV1FYdVZSFgIHElB3QAYGEl9CVBAHBkFWcxxXAmdAXQNWFVYEFgUiFlEKRREAWkxbFUBDB1cUBHhUFlR3EwEiFRdMRkBfWVBBO15cW1AAR3NbXAJSQhdVXAtVBFYAAlNQCwE=" 
    } 
  } 
}

接受新付款方式的「確認」請求內文範例：

{ 
  "payments": [ 
    { 
      "type": "customer_card", 
      "number": "4111111111111111", 
      "security_code": "123", 
      "expiration_month": "08", 
      "expiration_year": "2030", 
      "billing_contact": { 
        "given_name": "John", 
        "family_name": "Smith", 
        "email": "john@example.com", 
        "phone": { 
          "country_code": "1", 
          "area_code": "487", 
          "number": "5550077" 
        }, 
        "address": { 
          "line_1": "555 1st St", 
          "line_2": "10th floor", 
          "line_3": "Unit 12", 
          "city": "Seattle", 
          "state_province_code": "WA", 
          "postal_code": "98119", 
          "country_code": "US" 
        } 
      } 
    } 
  ] 
}

確認變更後，您應該執行行程擷取以確認套用變更。

新日期範例：

原入住日期為 2023 年 12 月 13 日、退房日期為 2023 年 12 月 14 日的行程：

{
  "itinerary_id": "9141257626318",
  "property_id": "480180",
  "rooms": [
    {
      "id": "201300171",
      "bed_group_id": "37321",
      "confirmation_id": {
        "expedia": "32831654",
        "property": "53063928"
      },
      "checkin": "2023-12-13",
      "checkout": "2023-12-14",
      "number_of_adults": 2,
      "given_name": "Jane",
      "family_name": "Doe",
      "status": "booked",
      "special_request": "Top floor or away from street please",
      "smoking": false,
      "rate": {
        "id": "270125984",
        "merchant_of_record": "property",
        "refundable": true,
        "cancel_refund": {
          "amount": "-151.31",
          "currency": "USD"
        },
        "cancel_penalties": [
          {
            "currency": "USD",
            "nights": "1",
            "start": "2023-12-11T23:59:00.000-06:00",
            "end": "2023-12-13T23:59:00.000-06:00"
          }
        ],
        "amenities": [
          "2192",
          "1073742786"
        ],
        "pricing": {
          "nightly": [
            [
              {
                "value": "129",
                "type": "base_rate",
                "currency": "USD"
              },
              {
                "value": "22.31",
                "type": "tax_and_service_fee",
                "currency": "USD"
              }
            ]
          ],
          "totals": {
            "inclusive": {
              "billable_currency": {
                "value": "151.31",
                "currency": "USD"
              }
            },
            "exclusive": {
              "billable_currency": {
                "value": "129",
                "currency": "USD"
              }
            },
            "property_fees": {
              "billable_currency": {
                "value": "0.81",
                "currency": "USD"
              }
            }
          },
          "fees": {
            "mandatory_fee": {
              "billable_currency": {
                "value": "0.81",
                "currency": "USD"
              }
            }
          }
        }
      },
      "loyalty_id": "123456789",
      "loyalty": {
        "member_id": "123456789",
        "program_id": "Hotel"
      },
      "links": {
        "cancel": {
          "method": "DELETE",
          "href": "/v3/itineraries/9141257626318/rooms/934aec56-b124-4f29-9ef8-90309b92eb07?token=REhZAQsDBAMHVEcBW0NeEUocagFfXQcEMzUfXFREClxbAUBeUEsHC1UKTTtbAGxEXAZaFgAIKy5lfC4SQgdERlpTRWxGQV9TXg5ROl1QXAAJAA0NBEIVQFYVVURBQTlRVFkCCwdQC1MeUQkAXVQPDFQHWwJQX1gWFlcDU0wWVgBQV1dBX0BDSlRXC0R3CVVQUhJMXF8NWAhSBVIEAFE="
        },
        "change": {
          "method": "PUT",
          "href": "/v3/itineraries/9141257626318/rooms/934aec56-b124-4f29-9ef8-90309b92eb07?token=REhZAQsDBAMHVEcBW0NeEUocagFfXQcEMzUfXFREClxbAUBeUEsHC1UKTTtbAGxEXAZaFgAIKy5lfC4SQgdERlpTRWxGQV9TXg5ROl1QXAAJAA0NBEIVQFYVVURBQTlRVFkCCwdQC1MeUQkAXVQPDFQHWwJQX1gWFlcDU0wWVgBQV1dBX0BDSlRXC0R3CVVQUhJMXF8NWAhSBVIEAFE="
        },
        "pricing": {
          "method": "GET",
          "href": "/v3/itineraries/9141257626318/rooms/934aec56-b124-4f29-9ef8-90309b92eb07/pricing?token=REhZAQsDBAMHVEcBW0NeEUocagFfXQcEMzUfXFREClxbAUBeUEsHC1UKTTtbAGxEXAZaFgAIKy5lfC4SQgdERlpTRWxGQV9TXg5ROl1QXAAJAA0NBEIRR1ABDQ4ACV4JBlMCBBERQQxIURYVTWdbBQRSDVUADwlDVg5SX1hbXglYWFdSWFRAQQMIAxpEBFRaWAZLXhdIT1sOWEdCVRQXXFBHbRcDUwdGUA9SA2taUA9RAgdVVgIDAhxQW1MHGAcOUAZPVVUFWBUAAAEFV1YBXQsAUQQeclsGV19DEV8JVwtXVgdRU10EUw=="
        },
        "shop_for_change": {
          "method": "GET",
          "href": "/v3/properties/480180/availability?token=XV1CBl5UWkdoCwc9RlNTCkoBCCp_bSd1QBRcX1BGEVEIVjlHXF1ZAVcHDVRRXlEbDVdQXEkBBlMFFFoBAFQbAAEHBgcOBlIED1sMQ0RRD1dURUwIBEpVAh8JUVhSTQdfVVlTXRo0YEVLWxETV10PE1gWXAFuRVwRQQpWQFFAVhxQRURaXlJsBlhXDQtaBm9QUQRaWg1NFQVTBVMBGVdRHwQBFAAHRQtQCFEXA0xaR0YIXlY9AFkNCFhaBTpFWkdYX2gQWAtbBAlUBRcABUBQQVBDFlxWVmwBW1tbDVxTOkEEFlc7DAENU1QIUgMBXAlXHkRZFkNdURFrFkcKAF4KXToNUAlVAwRbD1YXCUZdAEc-XQhWAGhfXAoLVlcDUltRBkhVUgYGHVZTUwEUDQBVCEwIAwRUXFEBVFMECQYfAExfF0xdDARvUgxfDlFaBmsXDVwLPgxXDwEIVQoIUlUHUB5TDQ1TUQ0BaEZWBVsWVm4ODgUERQ0UXlZWUwIOV1sHFl1dBF9ZCV5aBQ8FVV5RFh1RBQdISQddDwdeS1pBExYFXgsVRVgWF1oBSztGA1VTSwBbBwFqCgUMCVACBVICU1UbUwoABR0BAAEFSFYFUlcVUAENAgdVBl1XAAUEHhJIWQALBQdRA1MeRgEHUUpACFcBahZeQksGVl5BV0QPVztLU0RBWVBFARFREgtaBEJSSxhmWAYFWAlVBFMHA1BRBAYECkMDTQtHQQhfAWtRW10KWV8FPVUKBlJfCwsMBwMLABpTBUkHCh4ETFBAQA9bXmZSDVpTWF0Ea1tTB0dEBF0GGw9WQwdfDghRDVZrDEUGVWtRAAoABlsHVwNQUhEBXQsBRlUXV1E8Qw9cAwkLVQdSHFEOSAUEbAUBQFAjBQlBAyQDVxoEBlRvR11BXRZHWQ9WbFULClhRCFE5TV5NBFhpFldbDzxTRRFCAFZXGAkwMXdAAgpGXEdKHWZbDQBVXG1iRAdAURASXlpUOVYLXVoLDwE6RQ0SAglbUwIGTFEDFl1IDEVBXV1QOwMNW11ZC186VhdCSwdXBR8EbGZwRV0eWBVHXFcDPFYLVg9dCFRpSRdaFAFHFxhuUAYJBl4GAwwGEVZOWkNBXgxTOlZbDl1RX1JqXAUWbV0AQFlGURIFVgVaQFJHcAtdVw8SQVUPUw9RBVUDBA5dBA=="
        }
      }
    }
  ],
  "billing_contact": {
    "given_name": "Jane",
    "family_name": "Doe",
    "address": {
      "line_1": "123 Main Street",
      "line_2": "",
      "city": "Seattle",
      "state_province_code": "WA",
      "postal_code": "98122",
      "country_code": "US"
    }
  },
  "creation_date_time": "2023-06-21T19:52:42.477Z",
  "affiliate_reference_id": "2023-06-21-02",
  "affiliate_metadata": "data_point_1:|data_point2:",
  "email": "janedoe@email.com",
  "phone": {
    "country_code": "1",
    "area_code": "858",
    "number": "1234567"
  }
}

新入住日期為 2023 年 12 月 04 日、退房日期為 2023 年 12 月 05 日的行程。請注意，行程編號將與原始預訂中的一致。

{
  "itinerary_id": "9141257626318",
  "property_id": "480180",
  "rooms": [
    {
      "id": "201300171",
      "bed_group_id": "37321",
      "confirmation_id": {
        "expedia": "33633318"
      },
      "checkin": "2023-12-04",
      "checkout": "2023-12-05",
      "number_of_adults": 2,
      "given_name": "Jane",
      "family_name": "Doe",
      "status": "booked",
      "special_request": "Top floor or away from street please",
      "smoking": false,
      "rate": {
        "id": "270125984",
        "merchant_of_record": "property",
        "refundable": true,
        "cancel_refund": {
          "amount": "-151.31",
          "currency": "USD"
        },
        "cancel_penalties": [
          {
            "currency": "USD",
            "nights": "1",
            "start": "2023-12-02T23:59:00.000-06:00",
            "end": "2023-12-04T23:59:00.000-06:00"
          }
        ],
        "amenities": [
          "2192",
          "1073742786"
        ],
        "pricing": {
          "nightly": [
            [
              {
                "value": "22.31",
                "type": "tax_and_service_fee",
                "currency": "USD"
              },
              {
                "value": "129.00",
                "type": "base_rate",
                "currency": "USD"
              }
            ]
          ],
          "totals": {
            "inclusive": {
              "billable_currency": {
                "value": "151.31",
                "currency": "USD"
              }
            },
            "exclusive": {
              "billable_currency": {
                "value": "129.00",
                "currency": "USD"
              }
            },
            "property_fees": {
              "billable_currency": {
                "value": "0.81",
                "currency": "USD"
              }
            }
          },
          "fees": {
            "mandatory_fee": {
              "billable_currency": {
                "value": "0.81",
                "currency": "USD"
              }
            }
          }
        }
      },
      "loyalty_id": "123456789",
      "loyalty": {
        "member_id": "123456789",
        "program_id": "Hotel"
      },
      "links": {
        "cancel": {
          "method": "DELETE",
          "href": "/v3/itineraries/9141257626318/rooms/ae70934e-1f8f-441c-9ae5-6f75a622ce55?token=REhZAQsDBAMHVEcBW0NeEUocagFfXQcEMzUfXFREClxbAUBeUEsHC1UKTTtbAGxEXAZaFgAIKy5lfC4SQgdERlpTRWxGQV9TXg5ROl1QXAAJAA0NBEIVQFYVVURBQTlRVFkCCwdQC1MeUQkAXVQPDFQHWwJQX1gWFlcDU0wWVgBQV1dBX0BDSlRXC0R3CVVQUhJMXF8NWAhSBVIEAFE="
        },
        "change": {
          "method": "PUT",
          "href": "/v3/itineraries/9141257626318/rooms/ae70934e-1f8f-441c-9ae5-6f75a622ce55?token=REhZAQsDBAMHVEcBW0NeEUocagFfXQcEMzUfXFREClxbAUBeUEsHC1UKTTtbAGxEXAZaFgAIKy5lfC4SQgdERlpTRWxGQV9TXg5ROl1QXAAJAA0NBEIVQFYVVURBQTlRVFkCCwdQC1MeUQkAXVQPDFQHWwJQX1gWFlcDU0wWVgBQV1dBX0BDSlRXC0R3CVVQUhJMXF8NWAhSBVIEAFE="
        },
        "pricing": {
          "method": "GET",
          "href": "/v3/itineraries/9141257626318/rooms/ae70934e-1f8f-441c-9ae5-6f75a622ce55/pricing?token=REhZAQsDBAMHVEcBW0NeEUocagFfXQcEMzUfXFREClxbAUBeUEsHC1UKTTtbAGxEXAZaFgAIKy5lfC4SQgdERlpTRWxGQV9TXg5ROl1QXAAJAA0NBEIRR1ABDQ4ACV4JBlMCBBERQQxIURYVTWdbBQRSDVUADwlDVg5SX1hbXglYWFdSWFRAQQMIAxpEBFRaWAZLXhdIT1sOWEdCVRQXXFBHbRcDUwdGUA9SA2taUA9RAgdVVgIDAhxQW1MHGAcOUAZPVVUFWBUAAAEFV1YBXQsAUQQeclsGV19DEV8JVwtXVgdRU10EUw=="
        },
        "shop_for_change": {
          "method": "GET",
          "href": "/v3/properties/480180/availability?token=XV1CBl5UWkdoCwc9RlNTCkoBCCp_bSd1QBRcX1BGEVEIVjlHXF1ZAAZWAFUGB1YbXFMNXUkBAFdXFANWV1IbBFcEUVUPUgZRUVEGQ0RRD1dURUwIBEpVAh8JUVhSTQdfVVlTXRo0YEVLWxETV10PE1gWXAFuRVwRQQpWQFFAVhxQRURaXlJsBlhXDQtaBm9QUQRaWg1NFQVTBVMBGVdRHwUAFAAHRQtQCFEXA0xaR0YIXlY9AFkNCFhaBTpFWkdYX2gQWAtbBAlUBRcABUBQQVBDFlxWVmwBW1tbDVxTOkEEFlc7DAENU1QIUgMBXAlXHkRZFkNdURFrFkcKAF4KXToNUAlVAwRbD1YXCUZdAEc-XQhWAGhfXApTAFRSDgtQVUgGBQxUHVYBUFsUDQRWBUwHVQBRBAUKVFUDDAQfAExfF0xdDARvUgxfDlFaBmsXDVwLPgxXDwEIVQoIUlUHUB5TDQ1TUQ0BaEZWBVsWVm4ODgUERQ0UXlZWUwIOV1sHFl1dBF9ZCV5aBQ8FVV5RFh1RBQdISQddDwdeS1pBExYFXgsVRVgWF1oBSztGA1VTSwBbBwFqCgUMCVACBVICU1UbUwoABR0BAAEFSFYFUlcVUAENAgdVBl1XAAUEHhJIWQALBQdRA1MeRgEHUUpACFcBahZeQksGVl5BV0QPVztLU0RBWVBFARFREgtaBEJSSxhmWAYFWAlVBFMHA1BRBAYECkMDTQtHQQhfAWtRW10KWV8FPVUKBlJfCwsMBwMLABpTBUkGDR4ETFBAQA9bXmZSDVpTWF0Ea1tTB0dEBF0GGw9WQwdfDghRDVZrDEUGVWtRAAoAB1UHVQZUXhEBXQsBRlUXV1E8Qw9cAwkLVQdSHFEOSAUEbAUBQFAjBA5BAyQEURoBA1pvR11BXRZHWQ9WbFULClhRCFE5TV5NBFhpFldbDzxTRRFCAFZXGAkwMXdAAgpGXEdKHWZbDQBVXG1iRAdAURASXlpUOVYLXVoLDwE6RQ0SAglbUwIGTFEDFl1IDEVBXV1QOwMNW11ZC186VhdCSwdXBR8EbGZwRV0eWBVHXFcDPFYLVg9dCFRpSRdaFAFHFxhuUAYJBl4GAwwGEVZOWkNBXgxTOlZbDl1RX1JqXAUWbV0AQFlGURIFVgVaQFJHcAtdVw8SQVUPUAxVBlEDBgpQBw=="
        }
      }
    }
  ],
  "billing_contact": {
    "given_name": "Jane",
    "family_name": "Doe",
    "address": {
      "line_1": "123 Main Street",
      "line_2": "",
      "city": "Seattle",
      "state_province_code": "WA",
      "postal_code": "98122",
      "country_code": "US"
    }
  },
  "creation_date_time": "2023-06-21T19:52:42.477Z",
  "affiliate_reference_id": "2023-06-21-02",
  "affiliate_metadata": "data_point_1:|data_point2:",
  "email": "janedoe@email.com",
  "phone": {
    "country_code": "1",
    "area_code": "858",
    "number": "1234567"
  }
}

若要檢視預訂歷史記錄，請使用 include=history 標幟呼叫「行程擷取 API」。這時將回傳行程和客房等級相關詳情。

錯誤處理

不可能有變更。預訂已與請求的日期相符。

當 check-in, check-out, 入住率、客房類型、費率 ID 和價格均與原始預訂相同時，將傳回 400 錯誤請求錯誤。

{
 "type": `invalid_input`,
 "message": "An invalid request was sent in, please check the nested errors for details",
 "errors": [
  {
   "type": "no_change",
   "message": "No change possible. Reservation already matches requested date."
  }
 ]
}

現有預約為 Expedia Collect/Property Collect，無法變更。

如上所述，不可能透過硬性改變來改變商業模式。例如，預訂不能從expedia_collect到property_collect。嘗試更改業務模型將引發 400 - Bad Request 錯誤shop_for_change步。

{
    "type": "invalid_input",
    "message": "An invalid request was sent in, please check the nested errors for details.",
    "errors": [
        {
            "type": "filter.mismatch",
            "message": "Existing booking is property_collect, this cannot be changed.",
            "fields": [
                {
                    "name": "filter",
                    "type": "querystring",
                    "value": "expedia_collect"
                }
            ]
        }
    ]
}

有關錯誤處理的更多指導，請參閱 API Explorer 中的相關端點或參考常見錯誤回應。