API de itinerarios

Accede a datos de reservas en tiempo casi real para tus clientes

Con nuestra API de itinerarios, puedes mostrar la información de las reservas de tus clientes y ayudarles a encontrar productos o servicios relacionados, como visitas o experiencias. También puedes utilizar los datos de esta API para analizar las tendencias de las reservas y crear informes para las partes interesadas.

Campos disponibles

En las tablas siguientes encontrarás los campos, incluidos objetos anidados, disponibles a través de nuestros métodos de entrega push y pull.

Nombre del campo	Definición	Ejemplo
`itinerary_id`	Número de itinerario o el número de referencia del pedido en el punto de venta.	72622069245694
`status`	Estado del itinerario y de sus elementos individuales.	Valores posibles: Reservado Cancelado
`creation_date`*	Fecha en que se hizo inicialmente una reserva; se representa en formato de fecha ISO8601 (AAAA-MM-DD).	2023-02-05
`update_date_time`*	Fecha y hora de la última actualización del itinerario; se representa en formato de fecha ISO8601 (AAAA-MM-dd"T"HH:mm:ss.SSSZ).	2023-10-21T00:00:00.000-08:00
`online`	Indica si el itinerario se reservó por Internet o a través de un agente. Se representa con un valor booleano.	true
`package`	Indica si el itinerario se reservó por Internet o a través de un agente. Se representa con un valor booleano.	false
`payment_type`	Método utilizado en el momento del pago.	Valores posibles: Tarjeta de crédito Puntos Pago fraccionado
`point_of_sale_country_code`	Código de país del punto de venta desde el que el cliente hizo la reserva. Se representa en formato ISO 3166-1 alfa-2 de dos letras.	GB
`purchaser`	Identificación de la persona que hizo la reserva. Consulta la tabla `purchaser` para ver la lista de elementos anidados.
`property_booking_items`	Componentes del alojamiento reservados como parte del itinerario. Consulta la tabla `property_booking_items` para ver la lista de elementos anidados.
`flight_booking_items`	Componentes aéreos reservados como parte del itinerario. Consulta la tabla `flight_booking_items` para ver la lista de elementos anidados.
`car_booking_items`	Componentes de coche reservados como parte del itinerario. Consulta la tabla `car_booking_items` para ver la lista de elementos anidados.
`activity_booking_items`	Componentes de actividad reservados como parte del itinerario. Consulta la tabla `activity_booking_items` para ver la lista de elementos anidados.
`insurance_booking_items`	Componentes de seguro reservados como parte del itinerario. Consulta la tabla `insurance_booking_items` para ver la lista de elementos anidados.
`rate`	Tarifa y detalles del precio de un elemento de la reserva o del itinerario completo. Consulta la tabla `rate` para ver la lista de elementos anidados.
`coupon`	El cupón aplicado al itinerario, cuando proceda. Consulta la tabla `coupon` para ver la lista de elementos anidados.

purchaser

Estos campos identifican a la persona que hizo la reserva.

Nombre del campo	Definición	Ejemplo
`purchaser.email`**	Dirección de correo electrónico de la persona que hizo la reserva.	smith@example.com
`purchaser.loyalty_id`**	Identificador de afiliación al programa de fidelidad.	12345678

property_booking_items

En estos campos se indican los componentes del alojamiento reservados como parte del itinerario.

Nombre del campo	Definición	Ejemplo
`booking_item_id`	Identificador de un elemento específico reservado como parte de un itinerario.	1400882912
`status`	Estado del elemento de alojamiento concreto.	Valores posibles: Reservado Cancelado
`checkin_date`*	Fecha de entrada del elemento de alojamiento correspondiente. Se representa en formato de fecha ISO8601 (AAAA-MM-DD).	2023-02-01
`checkout_date`*	Fecha de salida del elemento de alojamiento correspondiente. Se representa en formato de fecha ISO8601 (AAAA-MM-DD).	2023-02-05
`property.id`	Identificador único de Expedia Group para el hotel o el alojamiento de alquiler vacacional	1400882912
`property.chain_name`	Nombre de la cadena a la que pertenece el alojamiento, cuando proceda.	Independiente
`property.brand_name`	Nombre de la marca a la que pertenece el alojamiento, cuando proceda. Una cadena puede tener varias marcas.	Savoy Signature
`property.name`	Nombre del hotel o alquiler vacacional.	Hotel 1
`property.city`	Nombre de la ciudad donde se encuentra el alojamiento.	Toronto
`property.state_province_name`	Nombre del estado o la provincia donde se encuentra el alojamiento.	Ontario
`property.country_code`	Código del país donde se encuentra el alojamiento. Se representa en formato ISO 3166-1 alfa-2 de dos letras.	CA
`property.star_rating`	Clasificación por estrellas del alojamiento.	3
`room_name`	Tipo de habitación reservada.	Habitación doble confort, baño privado
`adult_count`	Número de adultos incluidos en la reserva correspondiente.	2
`child_count`	Número de niños incluidos en la reserva correspondiente.	0
`expedia_collect`	Valor booleano que representa si la reserva se ha pagado en la página de pago de la plataforma (true) o si debe pagarse directamente al proveedor (false).	true
`property_confirmation_id`***	Identificación de confirmación proporcionada por el hotel o la empresa de alquiler vacacional.	1516171819
`rate`	Tarifa y detalles del precio de la reserva del alojamiento. Consulta la tabla `rate` para ver la lista de elementos anidados.

flight_booking_items

En estos campos se indican los componentes aéreos reservados como parte del itinerario.

Nombre del campo	Definición	Ejemplo
`booking_item_id`	Identificador de un elemento específico reservado como parte de un itinerario.	1400882911
`status`	Estado del elemento de viaje aéreo concreto.	Valores posibles: Reservado Cancelado
`departure_date`*	Fecha de inicio del elemento de viaje aéreo correspondiente. Se representa en formato de fecha ISO8601 (AAAA-MM-DD).	2023-02-01
`arrival_date`*	Fecha de fin del elemento de viaje aéreo correspondiente. Se representa en formato de fecha ISO8601 (AAAA-MM-DD).	2023-02-02
`airline.plating_carrier`	Nombre de la compañía aérea en cuyo nombre se ha emitido el billete.	Air Canada
`carrier_pnr`	Nombre del pasajero en el registro.	SMITH
`trip_type`	Tipo de viaje reservado.	Valores posibles: Solo ida Ida y vuelta Varios destinos
`fare_class`	Clase de tarifa del billete.	Económico
`airport_origin_code`	Código del aeropuerto de origen. Representado en formato IATA (Asociación Internacional de Transporte Aéreo).	LHR
`airport_origin_location`	Ubicación del aeropuerto de origen.	Londres, GB (LHR-Heathrow)
`airport_destination_code`	Código del aeropuerto de destino. Representado en formato IATA.	YYZ
`airport_destination_location`	Ubicación del aeropuerto de destino.	Toronto, ON (YYZ-Lester B. Pearson Intl.)
`ticket_number`	Número de billete del vuelo.	123456789101
`expedia_collect`	Valor booleano que representa si la reserva se ha pagado en la página de pago de la plataforma (true) o si debe pagarse directamente al proveedor (false).	true
`segment_count`	Número de segmentos de vuelo del billete de avión.	1
`rate`	Tarifa y detalles del precio de la reserva del vuelo. Consulta la tabla `rate` para ver la lista de elementos anidados.

car_booking_items

En estos campos se indican los componentes de coche reservados como parte del itinerario.

Nombre del campo	Definición	Ejemplo
`booking_item_id`	Identificador de un elemento específico reservado como parte de un itinerario.	1400882910
`status`	Estado del elemento de viaje de coche concreto.	Valores posibles: Reservado Cancelado
`pickup_date`*	Fecha de inicio del elemento del viaje en coche. Se representa en formato de fecha ISO8601 (AAAA-MM-DD).	2023-02-02
`return_date`*	Fecha de fin del elemento del viaje en coche. Se representa en formato de fecha ISO8601 (AAAA-MM-DD).	2023-02-05
`rental_company.name`***	Nombre de la empresa de alquiler de coches.	Hertz
`car_type`***	Tipo de coche alquilado.	Compacto de 2/4 puertas
`pickup_location`	Lugar de recogida del coche.	Deer Lake, NL (YDF-Deer Lake Regional)
`pickup_country_code`***	Código de país del lugar de recogida del coche. Se representa en formato ISO 3166-1 alfa-2 de dos letras.	CA
`return_location`	Lugar de devolución del coche.	Deer Lake, NL (YDF-Deer Lake Regional)
`return_country_code`***	Código de país del lugar de devolución del coche. Se representa en formato ISO 3166-1 alfa-2 de dos letras.	CA
`trip_type`	Tipo de viaje reservado.	Valores posibles: Solo ida Ida y vuelta Varios destinos
`rental_company_confirmation_id`***	Identificación de confirmación proporcionada por la empresa de alquiler de coches.	ABC1234
`expedia_collect`	Valor booleano que representa si la reserva se ha pagado en la página de pago de la plataforma (true) o si debe pagarse directamente al proveedor (false).	false
`rate`	Tarifa y detalles del precio de la reserva del coche. Consulta la tabla `rate` para ver la lista de elementos anidados.

activity_booking_items

En estos campos se recogen los componentes de actividad reservados como parte del itinerario.

Nombre del campo	Definición	Ejemplo
`booking_item_id`	Identificador de un elemento específico reservado como parte de un itinerario.	1400882910
`status`	Estado de la actividad específica.	Valores posibles: Reservado Cancelado
`activity_start_date`*	Fecha de inicio de la actividad. Se representa en formato de fecha ISO8601 (AAAA-MM-DD).	2023-02-03
`activity_end_date`*	Fecha de fin de la actividad. Se representa en formato de fecha ISO8601 (AAAA-MM-DD).	2023-02-03
`vendor.name`***	Nombre del proveedor que ofrece la actividad.	Viator
`vendor.city`***	Ciudad en la que se encuentra el proveedor de la actividad.	Deer Lake, NL (YDF-Deer Lake Regional)
`vendor.country_code`***	Código del país en el que se encuentra el proveedor de la actividad. Se representa en formato ISO 3166-1 alfa-2 de dos letras.	CA
`offering_name`***	Nombre de la actividad.	Passions of Paradise: Gran Barrera de Coral
`rate`	Tarifa y detalles del precio de la reserva de la actividad. Consulta la tabla `rate` para ver la lista de elementos anidados.

insurance_booking_items

En estos campos se indican los componentes de seguro reservados como parte del itinerario.

Nombre del campo	Definición	Ejemplo
`booking_item_id`	Identificador de un elemento específico reservado como parte de un itinerario.	1400882610
`status`	Estado del seguro específico seleccionado.	Valores posibles: Reservado Cancelado
`rate`	Tarifa y detalles del precio del seguro seleccionado. Consulta la tabla `rate` para ver la lista de elementos anidados.

tarifas y precios

En estos campos se indican la tarifa y los detalles del precio de un elemento de la reserva o del itinerario completo.

tarifa

Nombre del campo	Definición	Ejemplo
`rate_plan_name`	El nombre del plan de tarifas utilizado para la tarificación del artículo. Disponible solo para property_booking_items.	Solo alojamiento
`rate_plan_type`	Tipo de tarifa utilizado para la reserva. Disponible solo para property_booking_items.	Tarifa de distribución
`refundable`	Si el componente de reserva correspondiente se puede reembolsar.	true

precios

Este campo tiene valores anidados que describen el valor monetario de la reserva, desglosado por valor bruto de la reserva e impuestos y tasas. Además, los campos están anidados para una mayor flexibilidad.

Los nombres de campo que empiezan por un nombre seguido de un punto (por ejemplo, <variable>.<nested variable>) indican una relación de anidamiento. Todos los campos de esta tabla están anidados bajo la variable pricing.

Nombre del campo	Definición	Ejemplo
`taxes_and_fees`	Valor y moneda de los impuestos y las tasas de la reserva. Consulta los elementos anidados más abajo.
`gross_booking_value`	Valor monetario de la reserva, incluidos impuestos y tasas.	2523,00
`taxes_and_fees.billable_currency`	Valor monetario de los impuestos y tasas de la reserva, en la moneda utilizada para el pago. Anidada bajo la variable `taxes_and_fees`. Consulta los elementos anidados más abajo.
`gross_booking_value.billable_currency`	Valor monetario de la reserva en la moneda utilizada para el pago. Anidada bajo la variable `gross_booking_value`. Consulta los elementos anidados más abajo.
`billable_currency.currency`	Moneda en la que el cliente paga la reserva. Representada en formato ISO 4217. Anidada bajo la variable `billable_currency`.	GBP
`billable.currency.value`	Valor bruto de la reserva. Anidada bajo la variable `billable_currency`.	2520,80
`billable_currency.currency`	Moneda en la que el cliente paga las tasas y los impuestos. Representada en formato ISO 4217. Anidada bajo la variable `billable_currency`.	GBP
`billable_currency.value`	Importe pagado por el cliente en la divisa de facturación en concepto de impuestos y tasas. Anidada bajo la variable `billable_currency`.	491,10

cupón

Nombre del campo	Definición	Ejemplo
`code`***	Código del cupón utilizado para la reserva.	ABCD
`name`***	Nombre del cupón.	PRIME
`description`***	Descripción del cupón.	BoGo 5 %
`currency`***	Moneda en la que se ha aplicado el valor del cupón. Representada en formato ISO 4217.	GBP
`value`***	Valor monetario del cupón.	126,04

* Los campos de fecha se indican en Tiempo Universal Coordinado (UTC).

** Datos de información personal identificable (IPI). Asegúrate de gestionar esta información correctamente según las directrices de tu empresa. Inclúyela solo cuando sea absolutamente necesario.

*** Los datos de estos campos estarán disponibles entre las 18:00 y las 20:00 UTC del día siguiente a la creación o actualización de la reserva. Actualmente no están disponibles en tiempo casi real.

Modos de entrega

La API de Itinerarios proporciona datos de dos mecanismos: push y pull.

Mecanismo push

El servicio push se ha diseñado para enviar actualizaciones del itinerario a medida que estén disponibles en tiempo casi real, centrándose en los detalles esenciales del itinerario. Este servicio se dirige a los siguientes casos de uso:

Permitir a los colaboradores mostrar la información de las reservas de los clientes en su sitio web o aplicación.
Permitir a los colaboradores comercializar productos y servicios relacionados con las reservas.

Los eventos se enviarán mediante un webhook a la URL que proporciones en formato de mensaje HTTP POST. Recuerda que los mensajes pueden llegar desordenados. Consulta los elementos creation_date y update_date_time para determinar el orden.

Para obtener más detalles sobre el proceso de autenticación, consulta Cómo empezar.

Mecanismo pull

El servicio pull proporciona datos detallados del itinerario para respaldar casos de uso como los siguientes:

Permitir el análisis de datos.
Activar la recuperación de datos para períodos de tiempo en los que falló la entrega push.
Habilitar el servicio de asistencia en tiempo real.

Este servicio consta de dos puntos finales HTTP GET: uno pone a disposición una lista de itinerarios creados o actualizados en un intervalo de tiempo especificado y el otro recupera itinerarios concretos por su ID. Los parámetros de consulta son:

creation_date_start
creation_date_end
update_date_time_start
update_date_time_end
itinerary_id

Para obtener más detalles sobre el proceso de autenticación, consulta Cómo empezar.

Detalles de la API

Explora las definiciones de los puntos de conexión en esta página y usa un software de pruebas de API para ver la diferencia entre los ejemplos y las definiciones de esquemas, y el resultado real.