硬性变更
借助 Rapid 硬性变更 API，合作伙伴能够为旅客提供自助服务选项，从而无需取消和重新预订即可调整其预订的关键详细信息。
概述
灵活性仍然是旅行者的首要任务，对于那些需要随着旅行计划的变化而更改现有预订详细信息的旅行者来说，建立无缝体验非常重要。
当此类预订变更影响成本时，它们被称为硬变更。Rapid 的 Hard Change API 使您能够通过 API 支持日期、房间类型和入住率修改，从而构建或改善面向旅行者或面向代理的变更体验。
Rapid 硬性变更 API 有助于实现以下类型的变更：
- 未来可以调整日期或完全替换为新的日期范围。但是请注意，新入住日期必须在原预订日期的一年之内。
- 原始预订的房间类型可以升级或降级。例如，标准两张大床的预订可以升级为豪华特大床的预订。
- 居住人数可以增加或减少。
- 对于可预订的客房，住宿日期和入住人数可以一起变更（作为参数传递）。
上述更改可在入住前对 Expedia 签约库存的任何单间快速预订进行。这包括当天的更改，只要是在入住前进行即可，但酒店可能会收取罚款。
请注意，当酒店确定的penalty等于原始预订价值时，不可退款的预订将不会出现更改选项。
这为您的代理和旅行者提供了更好的自助服务能力，并减少了需要 Expedia 服务支持的手动更改工作。
此外，可以使用行程历史记录功能查看对预订所做的所有变更的记录。
硬性改变的好处
**更快地解决预订变更并留住您的旅客：**代理不再需要登录单独的工具或致电 Expedia 代理来进行预订变更，从而节省您的时间和服务成本。此外，通过避免取消全部预订，旅客无需被迫重新开始选购流程，这样您就更有可能留住这些旅客。
**尽可能保留最后一间可用房间并维持原价：**旅行者花费大量时间为他们的旅程选择合适的住宿。对于部分房产而言，硬更改保留了原来的房间，这意味着不存在失去最后一间可用房间的风险。虽然我们不能保证每晚的价格相同，但如果酒店允许，您的旅客可以享受与原始预订相同的每晚价格。
**通过保持行程 ID 一致来改善旅行者体验：**您可以通过硬性更改保留原始行程号，从而减少您、代理商和旅行者的混淆。
如何操作
响应中的链接示例：
[
{
"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，以搜索相同/不同房型的不同日期和/或入住人数。可用性响应将返回所有可用的房间，其价格符合新的入住/退房日期和/或入住率。此可用性响应与您已集成的常规购物流程的响应相同。使用与已更新的room、rate和bed_group关联的price_check链接进行适当的变更。 sales_channel是可用性请求中的必填字段。如果请求中未传递该字段，则响应将返回错误。- 如果原始预订是酒店/物业代收价格，且
currency未在shop_for_change请求中传递，则将返回酒店货币。例如，如果该酒店位于西班牙，并且是酒店/物业收费价格，但您以美元预订，如果在shop_for_change请求中未传递美元，则返回的价格将以欧元为单位。 - 选择客房后，使用
price_checkURL 获取退款或额外费用以及任何手续费（如适用）。请注意，退款或欠款金额可能会产生罚款。更改或取消的罚金由酒店决定。 - 价格检查链接返回新日期、房型和/或入住人数的
amount_owed或refund和/或penalty。 - 如果原始预订是会员价格，合作伙伴应传递
rate_option=member参数才能查看可用的会员价格 (MOD)。我们不会重复使用原始预订的价值，因为我们希望确保在硬更改时旅行者确实以会员身份登录，以便能够正确接收会员价格。
硬性改变的局限性
- 不可能通过硬性改变来改变商业模式。例如，预订不能从
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链接用于确认旅客想要变更日期并接受变更条款。当存在以下情况时：- 到期金额在变更提交的正文中，输入新的付款信息。接受的付款类型包括客户卡、虚拟卡、公司卡或联盟伙伴收款。
- 退款旅行者无需输入新的付款，退款将以原始付款方式进行。
重要提示：
- 如果价格检查响应中有
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 月 4 日、退房日期为 2023 年 12 月 5 日：请注意，行程编号将与原始预订中的编号保持一致。
{
"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。将返回行程级别和房间级别的详细信息。
错误处理
- 不可能有任何改變。预订已与请求的日期相符。
当入住、退房、入住人数、房型、房价 ID 和价格均与原始预订相同时，将返回 400 Bad Request 错误。
{
"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 中的相关端点或参考常见错误响应。