Developer Hub

일정 기록

Rapid의 검색 API의 일정 기록 섹션에서는 예약과 관련된 모든 객실의 세부 정보 내역을 볼 수 있습니다.

개요

일정 기록은 모든 예약에 유용하지만 특히 중단, 문제, 보고 등을 조정 및 확인하는 데 사용할 수 있어 변경된 예약에 유용합니다. 이 유연한 솔루션은 상담원 및 서비스 도구, 고객용 사이트, 앱 등에 활용할 수 있습니다.

일정 기록은 include=history 플래그를 전달하여 기존 검색 API 응답에 포함될 수 있으며 예약 일정에 대한 기록 세부 정보를 포함합니다. 예약 내의 모든 객실에 대해 별도의 내역 섹션을 사용할 수 있으며 각 섹션은 세 가지 예약 이벤트 개체( created, modified 및 canceled)로 구성됩니다. 또한 Expedia Group 상담원이 여행 일정 수준에서 조정한 내용을 제공하는 itinerary_history 섹션도 표시됩니다.

createdmodifiedcanceled
이벤트 개체에는 원래 예약에 대한 세부 정보가 포함됩니다.이벤트 개체에는 예약 변경에 대한 세부 정보가 포함됩니다.*이벤트 개체에는 예약 취소에 대한 세부 정보가 포함됩니다.

동일한 흐름에서 여러 개의 중대한 변경(비용에 영향을 미치는 변경)을 함께 수행하는 경우 기록에는 modified 이벤트가 하나만 포함됩니다. 그러나 중대한 변경이 개별적으로 하나씩 이루어지면 기록에 여러 modified 개체가 표시됩니다.

*특정 객실의 일정 기록에 있는 modified 이벤트는 API 또는 Expedia Group 서비스/상담원 도구를 통해 객실이 중대하게 변경되는 경우에만 생성됩니다. 이름 변경, 흡연/금연 선호 사항, 특별 요청 변경 등과 같이 비용에 대한 영향이 없는 변경 사항은 세부 정보 변경 API 또는 Expedia Group 서비스/상담원 도구를 통해 객실에 적용된 경미한 변경으로 간주되며, 새로 수정된 이벤트로 반영되지 않지만 객실의 최신 이벤트에 병합됩니다.

예를 들어 다음 작업은 여행 일정 세부 정보를 생성합니다.

  • 단일 객실 예약을 생성하면 created 이벤트가 생성됩니다.
  • 세부 정보 변경 API 또는 Expedia Group 서비스/상담원 도구를 통해 특별 요청을 업데이트하면 modified 이벤트가 생성되지 않으며, 이전 단계에서 생성된 기존 created 이벤트에는 업데이트된/최신 special_request가 표시됩니다.
  • 중대한 변경 API 또는 Expedia Group 서비스/상담원 도구를 통해 객실을 다른 체크인 날짜로 변경하도록 요청하면 새로운 체크인 날짜와 함께 modified 이벤트가 생성됩니다.
  • 세부 정보 변경 API 또는 Expedia Group 서비스/상담원 도구를 통해 given_name을 업데이트하면 modified 이벤트가 생성되지 않으며, 이전 단계에서 생성된 기존 modified 이벤트에는 업데이트된/최신 given_name이 표시됩니다.
  • 객실을 취소하면 canceled 이벤트가 생성됩니다.

예약 내역을 보려면 include=history 플래그를 사용하여 일정 검색 API를 호출해야 합니다. 일정 수준 및 객실 수준 세부 정보가 모두 응답으로 반환됩니다.

예:

{
  "itinerary_id": "8999989898988",
  "rooms": [ ... ],
  ...
  "itinerary_history": [
    {
      "history_id": "842737548",
      "event_timestamp": "2023-06-27T13:31:15.523Z",
      "event_type": "adjustment",
      "amount": {
        "value": "-32.10",
        "currency": "USD"
      },
      "agent_id": "10203"
    }
  ],
  "room_history": [
    [
      {
        "history_id": "42b4240c-109d-4bd6-a141-1db50619b700",
        "event_timestamp": "2023-06-27T20:54:47.551Z",
        "event_type": "created",
        "event_source": "rapid_api",
        "confirmation_id": {
          "expedia": "34222139"
        },
        "status": "canceled",
        "checkin": "2023-06-27",
        "checkout": "2023-06-29",
        "number_of_adults": 1,
        "given_name": "Jane",
        "family_name": "Doe",
        "bed_group_id": "37310",
        "smoking": false,
        "special_request": "Top floor or away from street please",
        "rate": {
          "id": "240273974",
          "merchant_of_record": "property",
          "refundable": false,
          "cancel_refund": {
            "amount": "-76.71",
            "currency": "USD"
          },
          "cancel_penalties": [
            {
              "currency": "USD",
              "nights": "1",
              "start": "2023-06-27T14:00:00.000-07:00",
              "end": "2023-06-27T15:00:00.000-07:00"
            }
          ],
          "pricing": {
            "nightly": [
              [
                {
                  "value": "66.02",
                  "type": "base_rate",
                  "currency": "USD"
                },
                {
                  "value": "10.69",
                  "type": "tax_and_service_fee",
                  "currency": "USD"
                }
              ],
              [
                {
                  "value": "66.02",
                  "type": "base_rate",
                  "currency": "USD"
                },
                {
                  "value": "10.69",
                  "type": "tax_and_service_fee",
                  "currency": "USD"
                }
              ]
            ],
            "totals": {
              "inclusive": {
                "billable_currency": {
                  "value": "153.42",
                  "currency": "USD"
                }
              },
              "exclusive": {
                "billable_currency": {
                  "value": "132.04",
                  "currency": "USD"
                }
              }
            }
          }
        },
        "amount_charged": {
          "billable_currency": {
            "value": "153.42",
            "currency": "USD"
          }
        },
        "room_id": "213014272"
      },
      {
        "history_id": "e5f4221f-31bc-406c-a8e5-00aa46d13564",
        "event_timestamp": "2023-06-27T21:11:31.578Z",
        "event_type": "modified",
        "event_source": "rapid_api",
        "confirmation_id": {
          "expedia": "34232470"
        },
        "status": "canceled",
        "checkin": "2023-06-27",
        "checkout": "2023-06-30",
        "number_of_adults": 1,
        "given_name": "Jane",
        "family_name": "Doe",
        "bed_group_id": "37310",
        "smoking": false,
        "special_request": "Top floor or away from street please",
        "rate": {
          "id": "240242975",
          "merchant_of_record": "property",
          "refundable": false,
          "cancel_refund": {
            "amount": "-191.100",
            "currency": "USD"
          },
          "cancel_penalties": [
            {
              "currency": "USD",
              "nights": "1",
              "start": "2023-06-27T14:00:00.000-07:00",
              "end": "2023-06-27T15:00:00.000-07:00"
            }
          ],
          "amenities": [
            "2192",
            "2109"
          ],
          "pricing": {
            "nightly": [
              [
                {
                  "value": "83.000",
                  "type": "base_rate",
                  "currency": "USD"
                },
                {
                  "value": "12.550",
                  "type": "tax_and_service_fee",
                  "currency": "USD"
                }
              ],
              [
                {
                  "value": "83.000",
                  "type": "base_rate",
                  "currency": "USD"
                },
                {
                  "value": "12.550",
                  "type": "tax_and_service_fee",
                  "currency": "USD"
                }
              ],
              [
                {
                  "value": "83.000",
                  "type": "base_rate",
                  "currency": "USD"
                },
                {
                  "value": "12.550",
                  "type": "tax_and_service_fee",
                  "currency": "USD"
                }
              ]
            ],
            "totals": {
              "inclusive": {
                "billable_currency": {
                  "value": "286.650",
                  "currency": "USD"
                }
              },
              "exclusive": {
                "billable_currency": {
                  "value": "249.000",
                  "currency": "USD"
                }
              }
            }
          }
        },
        "amount_charged": {
          "billable_currency": {
            "value": "209.940",
            "currency": "USD"
          }
        },
        "penalty": {
          "billable_currency": {
            "value": "76.71",
            "currency": "USD"
          }
        },
        "room_id": "213018273"
      },
      {
        "history_id": "e5f4221f-31bc-406c-a8e5-00aa46d13564",
        "event_timestamp": "2023-06-27T21:12:35.827852619Z",
        "event_type": "canceled",
        "event_source": "rapid_api",
        "confirmation_id": {
          "expedia": "34232470"
        },
        "status": "canceled",
        "checkin": "2023-06-27",
        "checkout": "2023-06-30",
        "number_of_adults": 1,
        "given_name": "Jane",
        "family_name": "Doe",
        "bed_group_id": "37310",
        "smoking": false,
        "special_request": "Top floor or away from street please",
        "rate": {
          "id": "242273975",
          "merchant_of_record": "property",
          "refundable": false,
          "cancel_refund": {
            "amount": "-191.100",
            "currency": "USD"
          },
          "cancel_penalties": [
            {
              "currency": "USD",
              "nights": "1",
              "start": "2023-06-27T14:00:00.000-07:00",
              "end": "2023-06-27T15:00:00.000-07:00"
            }
          ],
          "amenities": [
            "2192",
            "2109"
          ],
          "pricing": {
            "nightly": [
              [
                {
                  "value": "83.000",
                  "type": "base_rate",
                  "currency": "USD"
                },
                {
                  "value": "12.550",
                  "type": "tax_and_service_fee",
                  "currency": "USD"
                }
              ],
              [
                {
                  "value": "83.000",
                  "type": "base_rate",
                  "currency": "USD"
                },
                {
                  "value": "12.550",
                  "type": "tax_and_service_fee",
                  "currency": "USD"
                }
              ],
              [
                {
                  "value": "83.000",
                  "type": "base_rate",
                  "currency": "USD"
                },
                {
                  "value": "12.550",
                  "type": "tax_and_service_fee",
                  "currency": "USD"
                }
              ]
            ],
            "totals": {
              "inclusive": {
                "billable_currency": {
                  "value": "286.650",
                  "currency": "USD"
                }
              },
              "exclusive": {
                "billable_currency": {
                  "value": "249.000",
                  "currency": "USD"
                }
              }
            }
          }
        },
        "amount_refunded": {
          "billable_currency": {
            "value": "191.100",
            "currency": "USD"
          }
        },
        "penalty": {
          "billable_currency": {
            "value": "95.550",
            "currency": "USD"
          }
        },
        "room_id": "213014273"
      }
    ]
  ]
}

숙박 시설의 일정 변경을 확인하려면 이벤트 유형과 이벤트 소스의 조합을 찾아보세요.
일정 검색 요청의 include 요청 매개변수가 history인 경우:

  • event_source - other
  • event_type -
    • 공급업체에서 투숙일수를 단축 및 변경하거나 환불한 경우 - modified
    • 공급업체에서 취소 및 노쇼로 처리한 경우 - canceled

일정 검색 요청의 include 요청 매개변수가 history_v2인 경우:

  • event_source - supplier
  • event_type -
    • 공급업체에서 투숙일수를 단축 및 변경하거나 환불한 경우 - modified
    • 공급업체에서 취소한 경우 - canceled
    • 여행객이 나타나지 않아 노쇼로 처리된 경우 - canceled_no_show

기록이 있는 일정 응답의 모든 예는 일정 검색 엔드포인트 예(Itinerary with History)을 확인해 주세요.

관련 문서

EPS 알림 테스터

코로나19 Rapid 업데이트

서명 생성기

이용 후기

이 페이지가 도움이 되었나요?
이 콘텐츠를 어떻게 개선하면 좋을까요?
더 나은 만드는 데 도움을 주셔서 감사합니다!

개인정보 처리방침 쿠키 정책 이용약관

Expedia, Inc.는 외부 웹사이트 콘텐츠에 대해 책임을 지지 않습니다.
© 2024 Expedia, Inc., Expedia Group 계열사. All rights reserved. Expedia 및 비행기 로고는 Expedia, Inc.의 상표 또는 등록 상표입니다. CST# 2029030-50.