Developer Hub
Esta traducción se ha generado automáticamente

Historial del itinerario

La sección de historial de itinerarios de la API de Rapid Retrieve te permite 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 de reservas de una habitación concreta solo se generará cuando se produzca un cambio definitivo en la habitación a través de nuestras API o de las herramientas de gestión/agente 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.

>> Más información sobre el cambio de moneda
>> Descubre la API de detalles del cambio

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": "2027-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": "2027-06-27T20:54:47.551Z",
        "event_type": "created",
        "event_source": "rapid_api",
        "confirmation_id": {
          "expedia": "34222139"
        },
        "status": "canceled",
        "checkin": "2027-06-27",
        "checkout": "2027-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": "2027-06-27T14:00:00.000-07:00",
              "end": "2027-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": "2027-06-27T21:11:31.578Z",
        "event_type": "modified",
        "event_source": "rapid_api",
        "confirmation_id": {
          "expedia": "34232470"
        },
        "status": "canceled",
        "checkin": "2027-06-27",
        "checkout": "2027-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": "2027-06-27T14:00:00.000-07:00",
              "end": "2027-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": "2027-06-27T21:12:35.827852619Z",
        "event_type": "canceled",
        "event_source": "rapid_api",
        "confirmation_id": {
          "expedia": "34232470"
        },
        "status": "canceled",
        "checkin": "2027-06-27",
        "checkout": "2027-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": "2027-06-27T14:00:00.000-07:00",
              "end": "2027-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 - other
  • event_type -
    • Para una reducción de la estancia, un cambio o un reembolso por cortesía del proveedor - modified
    • para cancelaciones y no presentados de los proveedores: canceled

Cuando el parámetro de solicitud include en la solicitud de recuperación del itinerario es history_v2:

  • event_source - supplier
  • event_type -
    • Para una reducción de la estancia, un cambio o un reembolso por cortesía del proveedor - modified
    • para cancelaciones y no presentados de los proveedores: canceled
    • Para no presentados del viajero: canceled_no_show

Si quieres ver un ejemplo completo de la respuesta del itinerario con el historial incluido, echa un vistazo al ejemplo llamado « Itinerary with History » del punto final «Itinerary Retrieve».

Detalles de la API

¿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 es responsable del contenido de sitios web externos.
2026 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.