일정 기록
Rapid의 검색 API의 일정 기록 섹션에서는 예약과 관련된 모든 객실의 세부 정보 내역을 볼 수 있습니다.
개요
일정 기록은 모든 예약에 유용하지만 특히 중단, 문제, 보고 등을 조정 및 확인하는 데 사용할 수 있어 변경된 예약에 유용합니다. 이 유연한 솔루션은 상담원 및 서비스 도구, 고객용 사이트, 앱 등에 활용할 수 있습니다.
일정 기록은 include=history
플래그를 전달하여 기존 검색 API 응답에 포함될 수 있으며 예약 일정에 대한 기록 세부 정보를 포함합니다. 예약 내의 모든 객실에 대해 별도의 내역 섹션을 사용할 수 있으며 각 섹션은 세 가지 예약 이벤트 개체( created
, modified
및 canceled
)로 구성됩니다. 또한 Expedia Group 상담원이 여행 일정 수준에서 조정한 내용을 제공하는 itinerary_history
섹션도 표시됩니다.
created | modified | canceled |
---|---|---|
이벤트 개체에는 원래 예약에 대한 세부 정보가 포함됩니다. | 이벤트 개체에는 예약 변경에 대한 세부 정보가 포함됩니다.* | 이벤트 개체에는 예약 취소에 대한 세부 정보가 포함됩니다. |
동일한 흐름에서 여러 개의 중대한 변경(비용에 영향을 미치는 변경)을 함께 수행하는 경우 기록에는 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"
}
]
]
}
기록이 있는 일정 응답의 모든 예는 일정 검색 엔드포인트 예(Itinerary with History
)을 확인해 주세요.