중대한 변경

예약 취소 및 재예약 없이 여행객의 예약 세부 사항을 조정할 수 있는 ‘ self-serve ’ 옵션을 제공하세요.

개요

여행객들에게 유연성은 여전히 최우선 순위이며, 여행 계획이 변경되어 기존 예약 내용을 수정해야 하는 여행객들을 위해 원활한 경험을 제공하는 것이 중요합니다.

이러한 예약 변경이 비용에 영향을 미치는 경우, 이를 ‘하드 변경’이라고 합니다. Rapid Hard Change API를 사용하면 API를 통해 날짜, 객실 유형 및 투숙 인원 수를 수정할 수 있어, traveler-facing 또는 agent-facing 의 예약 변경 기능을 구축하거나 개선할 수 있습니다.

Rapid Hard Change API는 다음과 같은 변경 유형을 지원합니다:

날짜를 조정하거나 현재 이후의 새로운 날짜 범위로 완전히 대체할 수 있습니다. 단, 완전히 새로운 숙박 날짜는 원래 예약 날짜로부터 1년 이내여야 합니다.
원래 예약된 객실 유형은 상위 등급으로 변경하거나 하위 등급으로 변경할 수 있습니다. 예를 들어, ‘스탠다드 퀸 2개’ 객실 예약은 ‘디럭스 킹’ 객실로 업그레이드할 수 있습니다.
승객 수는 늘리거나 줄일 수 있습니다.
예약 가능한 객실에서 투숙 날짜와 인원수를 함께 변경할 수 있습니다(매개변수로 전달).

Expedia-contracted 에서 재고가 있는 모든 싱글룸에 대한 ‘Rapid’ 예약의 경우, pre-stay 에서 상기 변경 사항을 적용할 수 있습니다. 여기에는 check-in, 이전에 이루어진 same-day 변경 사항이 포함되지만, 숙박 시설에 따른 페널티가 적용될 수 있습니다.

숙박 시설로 결정된 penalty값이 원래 예약 금액과 동일한 경우, non-refundable 예약에 대해서는 변경 옵션이 표시되지 않으므로 유의하시기 바랍니다.

이를 통해 여행사 직원과 여행객에게 더 나은 self-serviceability 서비스를 제공할 수 있으며, 익스피디아 고객 지원팀의 도움이 필요한 수동 변경 작업의 필요성을 줄일 수 있습니다.

또한 일정 기록 기능을 사용하여 예약에 대한 모든 변경 기록을 볼 수 있습니다.

>> 일정의 역사에 대해 더 알아보기

과감한 변화의 이점

예약 변경을 더 빠르게 처리하고 여행객을 유지하세요: 이제 여행사 담당자는 예약 변경을 위해 별도의 도구에 로그인하거나 익스피디아 상담원에게 전화할 필요가 없어, 시간과 서비스 비용을 절약할 수 있습니다. 또한 전체 예약 취소를 방지할 수 있어 여행객에게 조회 프로세스를 다시 시작하라는 메시지가 표시되지 않으므로 경쟁사에 고객을 잃을 가능성이 줄어듭니다.

가능한 한 마지막 남은 객실을 확보하고 원래 가격을 유지해 주세요: 여행객들은 여행에 딱 맞는 숙박 시설를 고르기 위해 시간을 들였습니다. 숙박 시설의 일부 구간에서는 ‘하드 변경’이 적용되어 원래 객실이 유지되므로, 마지막으로 남은 객실을 놓칠 위험이 없습니다. 1박 요금이 동일할 것이라고 보장할 수는 없지만, 숙박 시설 조건이 허용하는 경우 여행객은 원래 예약과 동일한 1박 요금을 적용받을 수 있습니다.

일정 ID를 일관되게 유지하여 여행객의 경험을 개선하세요: 하드 변경을 통해 원래의 일정 번호를 그대로 유지하면, 귀하와 상담원, 여행객 모두의 혼란을 줄일 수 있습니다.

작동 방식

일정 조회 엔드포인트에서 일정를 요청하여 해당 예약이 하드 변경이 가능한지 확인하십시오. 자격을 충족하는 경우, 일정 Retrieve 또는 일정 Search 응답에 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==" 
          } 
        } 
      } 
    ] 
  } 
]

예약 가능한 객실/요금:

그런 다음 shop_for_change토큰화된 링크를 사용하여 가용성 API의 ‘추가 요금(Additional Rates)’ 엔드포인트를 호출하면, 동일하거나 다른 객실 유형에 대해 다른 날짜 및/또는 투숙 인원을 검색할 수 있습니다. ‘가용성’ 응답은 새로운 check-in/check-out 날짜 및/또는 투숙 인원 조건에 해당하는 요금이 적용되는 모든 이용 가능한 객실을 반환합니다. 이 가용성 응답은 귀사가 기존 일반 쇼핑 흐름에 이미 연동해 둔 것과 동일한 것입니다. 변경 사항에 적합한, 업데이트된 price_check, room및 rate과 연결된 bed_group링크를 사용하십시오.

>> 추가 요금 엔드포인트 살펴보기

sales_channel는 가용성 요청에서 필수 입력 항목입니다. 이 필드가 요청에 전달되지 않으면 응답에서 오류가 반환됩니다.
원래 예약이 숙박 시설/hotel 수령 요금제였으며, currency요청에 shop_for_change매개변수가 전달되지 않은 경우, 숙박 시설 통화가 반환됩니다. 예를 들어, 숙박 시설가 스페인에 위치해 있고 숙박 시설/hotel 요금 체계인 경우, 예약 시 통화를 USD로 설정했더라도 shop_for_change요청에 USD가 전달되지 않으면 반환되는 가격은 EUR로 표시됩니다.
객실 선택 후 price_check URL을 사용하여 환불 금액이나 해당되는 경우 추가 요금 및 위약금을 가져옵니다. 환불 또는 청구해야 할 금액에는 위약금이 반영됩니다. 변경 또는 취소 시 부과되는 위약금은 숙박 시설에 따라 결정됩니다.
요금 확인 링크는 새로운 날짜, 객실 및/또는 투숙 인원에 대해 amount_owed 또는 refund 및/또는 penalty를 반환합니다.
원래 예약이 회원 요금으로 이루어진 경우, 파트너사는 이용 가능한 회원 요금(MOD)을 확인하기 위해 rate_option=member매개변수를 전달해야 합니다. 원래 예약 금액을 re-use 로 환불하지 않을 예정입니다. 이는 확정 변경 시점에 여행자가 실제로 회원으로 로그인하여 회원 요금을 올바르게 적용받을 수 있도록 하기 위함입니다.

과격한 변화의 한계

강제적인 변화를 통해 비즈니스 모델을 바꾸는 것은 불가능합니다. 예를 들어, expedia_collect에서 property_collect로 예약을 변경할 수는 없습니다. 이러한 시도를 하면 **단계에서 “ **400 - Bad Requestshop_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 ’ 단계에서 패키지 요금을 검색하게 됩니다. 해당 변경 사항에 대해 패키지 요금이 제공되지 않는 경우, ‘이용 가능 여부 없음’으로 표시됩니다.

환불이 포함된 요금 확인 응답의 예:

이 예시에서는 $148.37 에서 1박당 USD 요금으로 숙박 기간을 1박 단축하고, penalty를 적용하지 않아, 해당 금액이 refund로 책정됩니다.

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

청구해야 할 금액과 위약금이 포함된 요금 확인 응답의 예:

이 예시에서는 1박당 $148.37 USD인 숙박 일수를 1박 단축하고 있지만, 해당 숙박 일수를 취소할 경우 $200.00 USD penalty의 취소 수수료가 부과되므로, 결과적으로 $51.63 USD를 지불해야 합니다.

{ 
  "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" 
        } 
      } 
    } 
  ] 
}

변경 사항을 적용한 후에는 일정 검색을 수행하여 변경 사항이 적용되었는지 확인해야 합니다.

새 날짜의 예:

일정, 원본 check-in 의 날짜는 2027-12-13 이며, check-out 의 날짜는 2027-12-14:

{
  "itinerary_id": "9141257626318",
  "property_id": "480180",
  "rooms": [
    {
      "id": "201300171",
      "bed_group_id": "37321",
      "confirmation_id": {
        "expedia": "32831654",
        "property": "53063928"
      },
      "checkin": "2027-12-13",
      "checkout": "2027-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": "2027-12-11T23:59:00.000-06:00",
            "end": "2027-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": "2027-06-21T19:52:42.477Z",
  "affiliate_reference_id": "2027-06-21-02",
  "affiliate_metadata": "data_point_1:|data_point2:",
  "email": "janedoe@email.com",
  "phone": {
    "country_code": "1",
    "area_code": "858",
    "number": "1234567"
  }
}

일정, 새로운 check-in 날짜 2027-12-04 및 check-out 날짜 2027-12-05. 일정 번호는 원래 예약과 동일하게 유지됩니다.

{
  "itinerary_id": "9141257626318",
  "property_id": "480180",
  "rooms": [
    {
      "id": "201300171",
      "bed_group_id": "37321",
      "confirmation_id": {
        "expedia": "33633318"
      },
      "checkin": "2027-12-04",
      "checkout": "2027-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": "2027-12-02T23:59:00.000-06:00",
            "end": "2027-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": "2027-06-21T19:52:42.477Z",
  "affiliate_reference_id": "2027-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 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/숙박 시설 Collect이며, 이는 변경할 수 없습니다.

앞서 언급했듯이, 급격한 변화를 통해 비즈니스 모델을 바꾸는 것은 불가능합니다. 예를 들어, expedia_collect에서 property_collect으로 예약을 변경할 수는 없습니다. 비즈니스 모델을 변경하려고 시도하면 ‘ shop_for_change ’ 단계에서 400 - Bad Request 오류가 발생합니다.

{
    "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 ’의 관련 엔드포인트를 참조하거나 일반적인 오류 응답을 확인하십시오.

>> 일반적인 오류 응답 확인하기