Historial del itinerario
En la sección del historial del itinerario de la API de recuperación de Rapid podrás ver los detalles históricos de cada habitación asociada a la reserva.
Información general
El historial del itinerario es útil para todas las reservas, pero en particular para aquellas en las que se hayan hecho cambios, ya que se puede utilizar en tareas de reconciliación y validación si hay interrupciones, problemas, derivaciones, etc. La solución es lo suficientemente versátil como para implementarse en herramientas de agente o servicios, así como en sitios web o aplicaciones para el cliente.
El historial del itinerario se puede incluir en una respuesta existente de la API de recuperación al pasar el indicador include=history, e incluirá detalles históricos sobre un itinerario de reserva. Habrá una sección individual del historial para todas las habitaciones de una reserva y cada sección constará de tres objetos de eventos de reserva: created, modifiedy canceled. Además, también verás la sección itinerary_history, que permite a los agentes de Expedia Group realizar ajustes en el itinerario.
created | modified | canceled |
|---|---|---|
| El objeto de evento incluirá detalles de la reserva original. | El objeto de evento incluirá detalles de los cambios realizados en la reserva.* | El objeto de evento incluirá detalles de las cancelaciones realizadas en la reserva. |
Si realizas varios cambios importantes (es decir, que tienen un impacto financiero) a la vez en el mismo flujo, el historial solo tendrá solo un evento modified. Sin embargo, si los cambios importantes se realizan por separado, uno tras otro, el historial mostrará varios objetos modified. |
* El evento modified en el historial del itinerario de una habitación determinada solo se generará cuando se realice un cambio importante en la habitación a través de nuestras API o las herramientas de gestión o para agentes de Expedia Group. Los cambios que no tienen ningún impacto financiero, como un cambio de nombre, preferencia para fumadores, cambios de solicitudes especiales, etc., y que se realicen en la habitación a través de la API de cambio de detalles o las herramientas de gestión o para agentes de Expedia Group se consideran cambios menores y no se reflejarán como un nuevo evento modificado, sino que se fusionarán con el último evento de la habitación.
Por ejemplo, las siguientes acciones generarán estos detalles del historial del itinerario:
- La creación de una reserva de habitación individual generará un evento
created. - La actualización de una solicitud especial a través de la API de cambio de detalles o mediante las herramientas de gestión o para agentes de Expedia Group no generará un evento
modified, sino que el eventocreatedexistente que se había creado en el paso anterior mostrará elspecial_requestactualizado o más reciente. - Una solicitud de cambio de habitación a una fecha de entrada diferente a través de la API de cambio importante o las herramientas de gestión o para agentes de Expedia Group generará un evento
modifiedcon la nueva fecha de entrada. - La actualización de
given_namea través de la API de cambio de detalles o las herramientas de gestión o para agentes de Expedia Group no generará un eventomodified, sino que el eventomodifiedexistente que ya se había creado en el paso anterior mostrará elgiven_nameactualizado o más reciente. - La cancelación de la habitación generará un evento
canceled.
Para ver el historial de la reserva, debes llamar a la API de recuperación del itinerario por medio del indicador include=history. Se devolverán los detalles a nivel de itinerario y de habitación.
Ejemplo:
{
"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"
}
]
]
}Para detectar los cambios de itinerario que haya hecho el alojamiento, busca una combinación de tipo de evento y origen del evento.
Cuando el parámetro de solicitud include en la solicitud de recuperación del itinerario es history:
event_source-otherevent_type-- por estancias reducidas, cambios y reembolsos por buena voluntad del proveedor:
modified - para cancelaciones y no presentados de los proveedores:
canceled
- por estancias reducidas, cambios y reembolsos por buena voluntad del proveedor:
Cuando el parámetro de solicitud include en la solicitud de recuperación del itinerario es history_v2:
event_source-supplierevent_type-- por estancias reducidas, cambios y reembolsos por buena voluntad del proveedor:
modified - para cancelaciones y no presentados de los proveedores:
canceled - Para no presentados del viajero:
canceled_no_show
- por estancias reducidas, cambios y reembolsos por buena voluntad del proveedor:
Para ver una respuesta completa de itinerario con el historial incluido, consulta el ejemplo Itinerary with History para el punto de conexión de recuperación del itinerario.