Developer Hub

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.

createdmodifiedcanceled
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 evento created existente que se había creado en el paso anterior mostrará el special_request actualizado 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 modified con la nueva fecha de entrada.
  • La actualización de given_name a través de la API de cambio de detalles o las herramientas de gestión o para agentes de Expedia Group no generará un evento modified, sino que el evento modified existente que ya se había creado en el paso anterior mostrará el given_name actualizado 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 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.

Relacionados

Comentarios de huéspedes

Novedades de Rapid sobre el COVID-19

Evaluador de notificaciones de EPS

Generador de firmas

¿Te ha resultado útil esta página?
¿Cómo podemos mejorar este contenido?
�Gracias por ayudarnos a mejorar!

Declaración de privacidad Política sobre cookies Condiciones de uso

Expedia, Inc. no se responsabiliza del contenido de sitios web de terceros.
© 2024 Expedia, Inc., una empresa de Expedia Group. Todos los derechos reservados. Expedia y el logotipo del avión son marcas comerciales o marcas comerciales registradas de Expedia, Inc, n.º 2029030-50.