Entrega API para Itinerarios

Con Itinerarios, puedes mostrar la información de reserva de los clientes y ayudarles a encontrar productos o servicios de booking-related, como excursiones o experiencias. También puedes utilizar los datos para analizar las tendencias de las reservas y crear informes para las partes interesadas.

Opciones de entrega

Tu API de entrega de datos de Itinerarios puede utilizar un mecanismo push o pull.

Mecanismo push

El servicio push envía actualizaciones del itinerario a medida que se producen. Los campos principales de la reserva están disponibles a los pocos minutos de una transacción, y los campos auxiliares y de enriquecimiento a las 2-4 horas. Esta opción te permite

Muestra la información de las reservas de tus clientes en tu web o app
Ofrecer a los viajeros productos y servicios adicionales para su viaje

Los eventos push se enviarán a través de un Webhook a la URL que proporciones, en formato de mensajeHTTP POST. Estos mensajes pueden llegar desordenados, así que consulta los elementos creation_datey update_date_timepara determinar el orden.

Para más detalles sobre cómo adoptar esta opción de entrega, consulta Configuración de la API.

Trabajar con eventos push

Como los datos del itinerario se entregan a medida que están disponibles, puedes recibir varios eventos para el mismo itinerario: un evento inicial con los campos principales, seguido de eventos posteriores a medida que se enriquecen los datos auxiliares o se actualiza el itinerario. Consulta Campos disponibles para ver un desglose completo de los campos que llegan en tiempo real y los que lo hacen en un plazo de 2 a 4 horas.

Qué hacer:

Espera múltiples eventos por itinerario: utiliza itinerary_idpara correlacionar eventos y trata siempre el evento con la última update_date_timecomo autoritativo
Elige cómo gestionar las actualizaciones: cuando recibas un nuevo evento para un itinerario existente, puedes sobrescribir el registro anterior con los datos más recientes, o anexar cada evento para mantener un historial de cambios.
Maneja los campos ausentes con elegancia: los campos auxiliares pueden estar ausentes en los primeros eventos; comprueba la presencia de campos antes de procesarlos

Evita lo siguiente:

Supongamos que el primer evento contiene la carga útil completa: los campos auxiliares siguen en eventos posteriores
Tratar como errores los eventos múltiples de un mismo itinerario: este es el comportamiento esperado
Trata los valores financieros de real-time como definitivos: pueden refinarse en 24 horas

Mecanismo pull

Nota

La entrega pull sólo está disponible para los socios de la Plataforma de Viajes de Marca Blanca.

El servicio pull proporciona datos detallados del itinerario como apoyo:

Análisis de datos
Conciliación de los registros de reservas con los datos de Expedia Group
Recuperación de datos para ventanas de tiempo en las que falló la entrega push
Investigaciones del servicio de asistencia

Al igual que con la entrega push, los datos del itinerario están disponibles en dos niveles para la entrega pull: los campos principales (itinerary_ID, status, gross_booking_value, checkin_date, y checkout_date) están accesibles a los pocos minutos de una reserva o actualización, y los campos auxiliares y de enriquecimiento a las 2-4 horas. Consulta Campos disponibles para ver un desglose completo por campos.

Este servicio consta de dos extremos HTTP GETque te permiten:

Crea una lista de itinerarios creados o actualizados en un intervalo de tiempo especificado utilizando las variables creation_date_start, creation_date_end, update_date_time_start, y update_date_time_end
Recuperar itinerarios específicos por su itinerary_id

Para más detalles sobre el proceso de autenticación, consulta Configuración de la API.

Recuperar datos del itinerario por ventana temporal

Para recuperar los datos del itinerario de una ventana de tiempo determinada, sondea el punto final GET /itinerariesutilizando update_date_time_starty update_date_time_endcomo ventana de consulta.

Enfoque recomendado:

Utiliza los campos update_date_time para la ventana de consulta: Utiliza update_date_time_starty update_date_time_endcomo ventana de consulta para recuperar itinerarios creados o actualizados en un periodo determinado. Si sólo utilizas creation_date, te perderás las actualizaciones del itinerario.
Persiste tu última marca de tiempo de sondeo con éxito: Utilízala como tu siguiente update_date_time_start, avanzando la ventana de forma incremental.
Deduplica: Utiliza itinerary_id + update_date_timeen tus consultas. El mismo itinerario puede aparecer en varias ventanas de sondeo a medida que se enriquecen los campos auxiliares. Trata siempre como fidedigno el registro con la últimaupdate_date_time.

Si tu caso de uso requiere los datos de itinerario más completos y puntuales, se recomienda la entrega push.

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. La columna Disponibilidad indica cuándo se puede acceder normalmente a cada campo tras un evento de reserva o una actualización:

En tiempo real: Disponible a los pocos minutos de una reserva o actualización
Near-real-time: Disponible entre 2 y 4 horas después de una reserva o actualización

Los nombres de campo que empiezan por un nombre seguido de un punto (por ejemplo, <variable>.<nested variable>) indican una relación de anidamiento.

Plataforma de viajes de marca blanca

Nombre del campo	Definición	Ejemplo	Disponibilidad
`itinerary_id`	Número de itinerario o el número de referencia del pedido en el punto de venta.	72622069245694	En tiempo real
`status`	Estado del itinerario y de sus elementos individuales.	Valores posibles: confirmado cancelado	En tiempo real
`creation_date`*	La fecha en que se hizo inicialmente una reserva, representada en formato de fecha ISO 8601 (YYYY-MM-DD).	2023-02-05	En tiempo real
`update_date_time`*	La fecha y hora de la última actualización del itinerario, representada en formato de fecha ISO 8601 (YYYY-MM-dd'T"HH:mm:ss.SSSZ).	2023-10-21T00:00:00.000Z	En tiempo real
`online`	Indica si el itinerario se reservó online (verdadero) o a través de un agente (falso). Se representa con un valor booleano.	true	Near-real-time
`package`	Indica si el itinerario forma parte de un paquete o es una reserva independiente. Se representa con un valor booleano.	false	Near-real-time
`payment_type`	Método utilizado en el momento del pago.	Valores posibles: Tarjeta de crédito Puntos Pago fraccionado	En tiempo real
`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	Near-real-time
`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	Disponibilidad
`purchaser.email`**	Dirección de correo electrónico de la persona que hizo la reserva.	smith@example.com	En tiempo real
`purchaser.loyalty_id`**	Identificador de afiliación al programa de fidelidad.	12345678	Near-real-time
`purchaser.first_name`**	Nombre de la persona que hizo la reserva.	Jane	En tiempo real
`purchaser.last_name`**	Apellidos de la persona que hizo la reserva.	Smith	En tiempo real

property_booking_items

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

Nombre del campo	Definición	Ejemplo	Disponibilidad
`booking_item_id`	Identificador de un elemento específico reservado como parte de un itinerario.	1400882912	En tiempo real
`status`	Estado del elemento de alojamiento concreto.	Valores posibles: confirmado cancelado	En tiempo real
`checkin_date`*	Fecha de entrada del elemento de alojamiento correspondiente. Representado en formato de fecha ISO 8601 (YYYY-MM-DD).	2023-02-01	En tiempo real
`checkout_date`*	Fecha de salida del elemento de alojamiento correspondiente. Representado en formato de fecha ISO 8601 (YYYY-MM-DD).	2023-02-05	En tiempo real
`property.id`	Expedia Group's Identificador único del hotel o propiedad de alquiler vacacional.	1400882912	Near-real-time
`property.chain_name`	Nombre de la cadena a la que pertenece el alojamiento, cuando proceda.	Independiente	Near-real-time
`property.brand_name`	Nombre de la marca a la que pertenece el alojamiento, cuando proceda. Una cadena puede tener varias marcas.	Savoy Signature	Near-real-time
`property.name`	Nombre del hotel o alquiler vacacional.	Hotel 1	En tiempo real
`property.city`	Nombre de la ciudad donde se encuentra el alojamiento.	Toronto	En tiempo real
`property.state_province_name`	Nombre del estado o la provincia donde se encuentra el alojamiento.	Ontario	Near-real-time
`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	En tiempo real
`property.star_rating`	Clasificación por estrellas del alojamiento.	3.0	Near-real-time
`room_name`	El tipo de habitación reservada, tal y como la define el hotel o la empresa de alquiler vacacional.	Habitación doble confort con baño privado	Near-real-time
`adult_count`	Número de adultos incluidos en la reserva correspondiente.	2	En tiempo real
`child_count`	Número de niños incluidos en la reserva correspondiente.	0	En tiempo real
`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	Near-real-time
`property_confirmation_id`	Número de confirmación facilitado por el hotel o la empresa de alquiler vacacional.	1516171819	Near-real-time
`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	Disponibilidad
`booking_item_id`	Identificador de un elemento específico reservado como parte de un itinerario.	1400882911	En tiempo real
`status`	Estado del elemento de viaje aéreo concreto.	Valores posibles: confirmado cancelado	En tiempo real
`departure_date`*	Fecha de inicio del elemento de viaje aéreo correspondiente. Representado en formato de fecha ISO 8601 (YYYY-MM-DD).	2023-02-01	En tiempo real
`arrival_date`*	Fecha de fin del elemento de viaje aéreo correspondiente. Representado en formato de fecha ISO 8601 (YYYY-MM-DD).	2023-02-02	En tiempo real
`airline.plating_carrier_name`	Nombre de la compañía aérea que emitió el billete.	Air Canada	Near-real-time
`airline.plating_carrier_code`	Asociación de Transporte Aéreo Internacional (IATA) código de la compañía aérea que emitió el billete.	AC	En tiempo real
`carrier_pnr`	Nombre del pasajero registrado en la compañía aérea que emitió el billete.	SMITH	Near-real-time
`trip_type`	Tipo de viaje reservado.	Valores posibles: Solo ida Ida y vuelta Varios destinos	Near-real-time
`fare_class`	Clase de tarifa del billete.	Económico	Near-real-time
`airport_origin_code`	El código IATA del aeropuerto de origen.	LHR	En tiempo real
`airport_origin_location`	Ubicación del aeropuerto de origen.	Londres, GB (LHR-Heathrow)	Near-real-time
`airport_destination_code`	Código del aeropuerto de destino. Representado en formato IATA.	YYZ	En tiempo real
`airport_destination_location`	Ubicación del aeropuerto de destino.	Toronto, ON (YYZ-Lester B. Pearson Intl.)	Near-real-time
`ticket_number`	Número de billete del vuelo.	123456789	Near-real-time
`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	Near-real-time
`segment_count`	Número de segmentos de vuelo del billete de avión.	1	Near-real-time
`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	Disponibilidad
`booking_item_id`	Identificador de un elemento específico reservado como parte de un itinerario.	1400882910	En tiempo real
`status`	Estado del elemento de viaje de coche concreto.	Valores posibles: confirmado cancelado	En tiempo real
`pickup_date`*	Fecha de inicio del elemento del viaje en coche. Representado en formato de fecha ISO 8601 (YYYY-MM-DD).	2023-02-02	En tiempo real
`return_date`*	Fecha de fin del elemento del viaje en coche. Representado en formato de fecha ISO 8601 (YYYY-MM-DD).	2023-02-05	En tiempo real
`rental_company.name`	Nombre de la empresa de alquiler de coches.	Hertz	En tiempo real
`car_type`	Tipo de coche alquilado.	Compacto de 2/4 puertas	Near-real-time
`pickup_location`	Lugar de recogida del coche.	Deer Lake, NL (YDF-Deer Lake Regional)	En tiempo real
`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	En tiempo real
`return_location`	Lugar de devolución del coche.	Deer Lake, NL (YDF-Deer Lake Regional)	En tiempo real
`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	En tiempo real
`trip_type`	Tipo de viaje reservado.	Valores posibles: Solo ida Ida y vuelta Varios destinos	Near-real-time
`rental_company_confirmation_id`	Número de confirmación facilitado por la empresa de alquiler de coches.	ABC1234	Near-real-time
`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	Near-real-time
`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	Disponibilidad
`booking_item_id`	Identificador de un elemento específico reservado como parte de un itinerario.	1400882910	En tiempo real
`status`	Estado de la actividad específica.	Valores posibles: confirmado cancelado	En tiempo real
`activity_start_date`*	Fecha de inicio de la actividad. Representado en formato de fecha ISO 8601 (YYYY-MM-DD).	2023-02-03	En tiempo real
`activity_end_date`*	Fecha de fin de la actividad. Representado en formato de fecha ISO 8601 (YYYY-MM-DD).	2023-02-03	En tiempo real
`vendor.name`	Nombre del proveedor que ofrece la actividad.	Visitas guiadas de Olivia	En tiempo real
`vendor.city`	Ciudad en la que se encuentra el proveedor de la actividad.	Deer Lake, NL (YDF-Deer Lake Regional)	En tiempo real
`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	En tiempo real
`offering_name`	Nombre de la actividad.	Passions of Paradise: Gran Barrera de Coral	Near-real-time
`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	Near-real-time
`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	Disponibilidad
`booking_item_id`	Identificador de un elemento específico reservado como parte de un itinerario.	1400882610	En tiempo real
`status`	Estado del seguro específico seleccionado.	Valores posibles: confirmado cancelado	En tiempo real
`rate`	Tarifa y detalles del precio del seguro seleccionado. Consulta la tabla `rate` para ver la lista de elementos anidados.

tarifa

En estos campos se indican la tarifa y los detalles del precio de un elemento de la reserva o del itinerario completo. Incluyen valores anidados que describen el valor monetario de la reserva, desglosado por valor bruto de la reserva e impuestos y tasas.

Nombre del campo	Definición	Ejemplo	Disponibilidad
`rate_plan_name`	El nombre del plan de tarifas utilizado para la tarificación del artículo. Disponible sólo para artículos de reserva de propiedades.	Solo alojamiento	Near-real-time
`rate_plan_type`	Tipo de tarifa utilizado para la reserva. Disponible sólo para artículos de reserva de propiedades.	Tarifa de distribución	Near-real-time
`refundable`	Si el componente de reserva correspondiente es reembolsable (verdadero) o no (falso).	true	Near-real-time
`pricing`	Objeto que captura el valor monetario de la reserva, desglosado por valor bruto de la reserva e impuestos y tasas.
`pricing.gross_booking_value`	Objeto que captura el valor monetario de la reserva.
`pricing.gross_booking_value.billable_currency`	Objeto que representa el valor monetario de la reserva en la moneda utilizada para el pago.
`pricing.gross_booking_value.billable_currency.currency`	Moneda en la que el cliente paga la reserva. Representada en formato ISO 4217.	GBP	En tiempo real
`pricing.gross_booking_value.billable_currency.value`	El valor bruto de reserva.	2520,80	En tiempo real
`pricing.taxes_and_fees`	Valor y moneda de los impuestos y las tasas de la reserva.
`pricing.taxes_and_fees.billable_currency`	Valor monetario de los impuestos y tasas de la reserva, en la moneda utilizada para el pago.
`pricing.taxes_and_fees.billable_currency.currency`	Moneda en la que el cliente paga la reserva. Representada en formato ISO 4217.	GBP	En tiempo real
`pricing.taxes_and_fees.billable.currency.value`	Valor bruto de la reserva.	491,10	En tiempo real

cupón

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

Notas para todos los campos de la Plataforma de Viajes Marca Blanca

Los campos de fecha están en Tiempo Universal Coordinado (UTC).
** Esto representa datos de Información Personal Identificable (IPI). Asegúrate de manejarlo correctamente según las directrices de tu empresa. Inclúyelo sólo cuando sea absolutamente necesario.

Programa de Afiliación de Agentes de Viajes (TAAP)

Nombre del campo	Definición	Ejemplo	Disponibilidad
`itinerary_id`	Número de itinerario o el número de referencia del pedido en el punto de venta.	72622069245694	En tiempo real
`agency_reference_code`	Una referencia de itinerario personalizado proporcionada por la agencia en el momento de la compra.	86549B_GB	En tiempo real
`status`	Estado del itinerario y de sus elementos individuales.	Valores posibles: confirmado cancelado	Near-real-time
`creation_date`*	La fecha en que se hizo inicialmente una reserva, representada en formato de fecha ISO 8601 (YYYY-MM-DD).	2023-02-05	En tiempo real
`update_date_time`*	La fecha y hora de la última actualización del itinerario, representada en formato de fecha ISO 8601 (YYYY-MM-dd'T"HH:mm:ss.SSSZ).	2023-10-21T00:00:00.000Z	En tiempo real
`online`	Indica si el itinerario se reservó online (verdadero) o a través de un agente (falso). Se representa con un valor booleano.	true	Near-real-time
`point_of_sale_country_code`	El código del país en el que el cliente hizo la reserva. Se representa en formato ISO 3166-1 alfa-2 de dos letras.	GB	Near-real-time
`purchaser`	Identificación de la persona que hizo la reserva. Consulta la tabla `purchaser` para ver la lista de elementos anidados.
`agency`	Identificación de la agencia TAAP y del agente que hizo la reserva. Consulta la tabla `agency` para ver la lista de elementos anidados.
`payment`	Información sobre el pago del itinerario. Consulta la tabla `payment` 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.
`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.
`earnings`	Los detalles de la comisión de un elemento de la reserva o de todo el itinerario. Consulta la tabla `earnings` para ver la lista de elementos anidados.

purchaser

Estos campos identifican a la persona que va a viajar.

Nombre del campo	Definición	Ejemplo	Disponibilidad
`purchaser.email`**	Dirección de correo electrónico del viajero.	smith@example.com	En tiempo real
`purchaser.first_name`**	Nombre del viajero.	Jane	En tiempo real
`purchaser.last_name`**	Apellido del viajero.	Smith	En tiempo real

agencia

Estos campos identifican a la agencia TAAP y al agente que hizo la reserva.

Nombre del campo	Definición	Ejemplo	Disponibilidad
`agency.name`	Nombre de la agencia TAAP que hizo la reserva.	Viajes por el mundo	Near-real-time
`agency.id`	Código de seguimiento de la agencia TAAP que hizo la reserva.	WS02555	En tiempo real
`agency.agent.first_name`**	Nombre del agente TAAP que hizo la reserva.	Bob	En tiempo real
`agency.agent.last_name`**	Apellido del agente TAAP que hizo la reserva.	Jones	En tiempo real
`agency.agent.email`**	Dirección de correo electrónico del agente TAAP que hizo la reserva.	bjones@worldtravel.com	En tiempo real

Pago

Estos campos contienen los datos de pago del itinerario.

Nombre del campo	Definición	Ejemplo	Disponibilidad
`payment_type`	Método utilizado en el momento del pago.	Valores posibles: tarjeta de crédito puntos Pago fraccionado	En tiempo real
`status`	Indica si se ha pagado el itinerario.	Valores posibles: pagado Sin pagar	Near-real-time
`deferred`	Si el pago del itinerario fue aplazado (verdadero) o pagado (falso). Se representa con un valor booleano.	true	Near-real-time
`payment_due_date`	La fecha de vencimiento del pago Formato de fecha ISO 8601 (YYYY-MM-DD). Sólo aplicable a los pagos aplazados.	2023-02-05	Near-real-time
`payee`	Indica quién es el responsable de realizar el pago del itinerario.	Valores posibles: agencia cliente	Near-real-time

property_booking_items

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

Nombre del campo	Definición	Ejemplo	Disponibilidad
`booking_item_id`	Identificador de un elemento específico reservado como parte de un itinerario.	1400882912	En tiempo real
`status`	Estado del elemento de alojamiento concreto.	Valores posibles: confirmada cancelado	En tiempo real
`checkin_date`*	Fecha de entrada del elemento de alojamiento correspondiente. Representado en formato de fecha ISO 8601 (YYYY-MM-DD).	2023-02-01	En tiempo real
`checkout_date`*	Fecha de salida del elemento de alojamiento correspondiente. Representado en formato de fecha ISO 8601 (YYYY-MM-DD).	2023-02-05	En tiempo real
`property.id`	Expedia Group's identificador único del hotel o propiedad de alquiler vacacional	1400882912	Near-real-time
`property.chain_name`	Nombre de la cadena a la que pertenece el alojamiento, cuando proceda.	Independiente	Near-real-time
`property.brand_name`	Nombre de la marca a la que pertenece el alojamiento, cuando proceda. Una cadena puede tener varias marcas.	Savoy Signature	Near-real-time
`property.name`	Nombre del hotel o alquiler vacacional.	Hotel 1	En tiempo real
`property.city`	Nombre de la ciudad donde se encuentra el alojamiento.	Toronto	En tiempo real
`property.state_province_name`	Nombre del estado o la provincia donde se encuentra el alojamiento.	Ontario	Near-real-time
`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	En tiempo real
`property.star_rating`	Clasificación por estrellas del alojamiento.	3.0	Near-real-time
`room_name`	El tipo de habitación reservada, tal y como la define el hotel o la empresa de alquiler vacacional.	Habitación doble confort con baño privado	Near-real-time
`adult_count`	Número de adultos incluidos en la reserva.	2	En tiempo real
`child_count`	Número de niños incluidos en la reserva.	0	En tiempo real
`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	Near-real-time
`property_confirmation_id`	Número de confirmación facilitado por el hotel o la empresa de alquiler vacacional.	1516171819	Near-real-time
`rate`	Tarifa y detalles del precio de la reserva del alojamiento. Consulta la tabla `rate` para ver la lista de elementos anidados.
`earnings`	Los datos de la comisión de la reserva del alojamiento. Consulta la tabla `earnings` 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	Disponibilidad
`booking_item_id`	Identificador de un elemento específico reservado como parte de un itinerario.	1400882911	En tiempo real
`status`	Estado del elemento de viaje aéreo concreto.	Valores posibles: confirmado cancelado	En tiempo real
`departure_date`*	Fecha de inicio del elemento de viaje aéreo correspondiente. Representado en formato de fecha ISO 8601 (YYYY-MM-DD).	2023-02-01	En tiempo real
`arrival_date`*	Fecha de fin del elemento de viaje aéreo correspondiente. Representado en formato de fecha ISO 8601 (YYYY-MM-DD).	2023-02-02	En tiempo real
`airline.plating_carrier_name`	Nombre de la compañía aérea que emitió el billete.	Air Canada	Near-real-time
`airline.plating_carrier_code`	IATA código de la compañía aérea que emitió el billete.	AC	En tiempo real
`carrier_pnr`	Nombre del pasajero registrado en la compañía aérea que emitió el billete.	SMITH	Near-real-time
`trip_type`	Tipo de viaje reservado.	Valores posibles: Solo ida Ida y vuelta Varios destinos	Near-real-time
`fare_class`	Clase de tarifa del billete.	Económico	Near-real-time
`airport_origin_code`	El código IATA del aeropuerto de origen.	LHR	En tiempo real
`airport_origin_location`	Ubicación del aeropuerto de origen.	Londres, GB (LHR-Heathrow)	Near-real-time
`airport_destination_code`	Código del aeropuerto de destino. Representado en formato IATA.	YYZ	En tiempo real
`airport_destination_location`	Ubicación del aeropuerto de destino.	Toronto, ON (YYZ-Lester B. Pearson Intl.)	Near-real-time
`ticket_number`	Número de billete del vuelo.	123456789101	Near-real-time
`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	Near-real-time
`segment_count`	El número de segmentos de vuelo del billete.	1	Near-real-time
`rate`	Tarifa y detalles del precio de la reserva del vuelo. Consulta la tabla `rate` para ver la lista de elementos anidados.
`earnings`	Los datos de la comisión de la reserva del vuelo. Consulta la tabla `earnings` 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	Disponibilidad
`booking_item_id`	Identificador de un elemento específico reservado como parte de un itinerario.	1400882910	En tiempo real
`status`	Estado del elemento de viaje de coche concreto.	Valores posibles: confirmado cancelado	En tiempo real
`pickup_date`*	Fecha de inicio del elemento del viaje en coche. Representado en formato de fecha ISO 8601 (YYYY-MM-DD).	2023-02-02	En tiempo real
`return_date`*	Fecha de fin del elemento del viaje en coche. Representado en formato de fecha ISO 8601 (YYYY-MM-DD).	2023-02-05	En tiempo real
`rental_company.name`	Nombre de la empresa de alquiler de coches.	Hertz	En tiempo real
`car_type`	Tipo de coche alquilado.	Compacto de 2/4 puertas	Near-real-time
`pickup_location`	Lugar de recogida del coche.	Deer Lake, NL (YDF-Deer Lake Regional)	En tiempo real
`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	En tiempo real
`return_location`	Lugar de devolución del coche.	Deer Lake, NL (YDF-Deer Lake Regional)	En tiempo real
`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	En tiempo real
`trip_type`	Tipo de viaje reservado.	Valores posibles: Solo ida Ida y vuelta Varios destinos	Near-real-time
`rental_company_confirmation_id`	Número de confirmación facilitado por la empresa de alquiler de coches.	ABC1234	Near-real-time
`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	Near-real-time
`rate`	Tarifa y detalles del precio de la reserva del coche. Consulta la tabla `rate` para ver la lista de elementos anidados.
`earnings`	Los datos de la comisión de la reserva del coche. Consulta la tabla `earnings` 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	Disponibilidad
`booking_item_id`	Identificador de un elemento específico reservado como parte de un itinerario.	1400882910	En tiempo real
`status`	Estado de la actividad específica.	Valores posibles: confirmado cancelado	En tiempo real
`activity_start_date`*	Fecha de inicio de la actividad. Representado en formato de fecha ISO 8601 (YYYY-MM-DD).	2023-02-03	En tiempo real
`activity_end_date`*	Fecha de fin de la actividad. Representado en formato de fecha ISO 8601 (YYYY-MM-DD).	2023-02-03	En tiempo real
`vendor.name`	Nombre del proveedor que ofrece la actividad.	Visitas guiadas de Olivia	En tiempo real
`vendor.city`	Ciudad en la que se encuentra el proveedor de la actividad.	Deer Lake, NL (YDF-Deer Lake Regional)	En tiempo real
`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	En tiempo real
`offering_name`	Nombre de la actividad.	Senda del río Humber	Near-real-time
`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	Near-real-time
`rate`	Tarifa y detalles del precio de la reserva de la actividad. Consulta la tabla `rate` para ver la lista de elementos anidados.
`earnings`	Los detalles de la comisión del elemento de reserva de actividad. Consulta la tabla `earnings` para ver la lista de elementos anidados.

tarifa

Nombre del campo	Definición	Ejemplo	Disponibilidad
`refundable`	Si el componente de reserva correspondiente es reembolsable (verdadero) o no (falso).	true	Near-real-time
`pricing`	Objeto que captura el valor monetario de la reserva, desglosado por valor bruto de la reserva e impuestos y tasas.
`pricing.gross_booking_value`	Valor monetario de la reserva, incluidos impuestos y tasas.
`pricing.gross_booking_value.billable_currency`	Valor monetario de la reserva en la moneda utilizada para el pago.
`pricing.gross_booking_value.billable_currency.currency`	Moneda en la que el cliente paga la reserva. Representada en formato ISO 4217.	GBP	En tiempo real
`pricing.gross_booking_value.billable_currency.value`	El valor bruto de reserva.	2520,80	En tiempo real
`pricing.taxes_and_fees`	Valor y moneda de los impuestos y las tasas de la reserva.
`pricing.taxes_and_fees.billable_currency`	Valor monetario de los impuestos y tasas de la reserva, en la moneda utilizada para el pago.
`pricing.taxes_and_fees.billable_currency.currency`	Moneda en la que el cliente paga la reserva. Representada en formato ISO 4217.	GBP	En tiempo real
`pricing.taxes_and_fees.billable.currency.value`	Valor bruto de la reserva.	491,10	En tiempo real

ganancias

Nombre del campo	Definición	Ejemplo	Disponibilidad
`commission`	Objeto que representa el importe de la comisión de la reserva o artículo, incluido en el valor bruto de la reserva.
`commission.billable_currency`	Objeto que representa el importe de la comisión en la moneda de pago.
`commission.billable_currency.currency`	Moneda del valor de la comisión, representada en formato ISO 4217	USD	En tiempo real
`commission.billable_currency.value`	Valor monetario de la comisión.	100.25	En tiempo real
`service_charge`	Objeto que representa las tasas de servicio aplicadas por una agencia TAAP al itinerario.
`service_charge.amount`	Objeto que representa el valor monetario de la tasa de servicio aplicada por una agencia TAAP al itinerario.
`service_charge.amount.billable_currency`	Objeto que representa el importe del valor de la comisión de servicio en la moneda de pago.
`service_charge.amount.billable_currency.currency`	Moneda del valor del cargo por servicio, representada en formato ISO 4217.	USD	En tiempo real
`service_charge.amount.billable_currency.value`	Valor monetario de las comisiones de servicio aplicadas por la agencia TAAP al itinerario.	50.50	En tiempo real
`service_charge.taxes_and_fees`	Objeto que representa el valor y la moneda de los impuestos y tasas de la cuota de servicio.
`service_charge.taxes_and_fees.billable_currency`	Objeto que representa el valor monetario de los impuestos y tasas de la cuota de servicio, en la moneda de pago.
`service_charge.taxes_and_fees.billable_currency.currency`	Moneda de pago, representada en formato ISO 4217.	USD	En tiempo real
`service_charge.taxes_and_fees.billable_currency.value`	Importe pagado por el cliente en la divisa de facturación en concepto de impuestos y tasas.	5.25	En tiempo real

Notas para todos los campos TAAP

Los campos de fecha están en Tiempo Universal Coordinado (UTC).
** Esto representa datos de Información Personal Identificable (IPI). Asegúrate de manejarlo correctamente según las directrices de tu empresa. Inclúyelo sólo cuando sea absolutamente necesario.

Detalles de la API

Hemos proporcionado una instantánea del esquema y las configuraciones de la API en función de cómo utilizaría tu empresa los datos de la API de Itinerarios. Puedes descargar las especificaciones OpenAPI y utilizar una herramienta de prueba de API para comprender cómo se comparan los ejemplos y las definiciones de esquema con la salida real.

Plataforma de viajes de marca blanca

Los campos, incluidos los objetos anidados, disponibles para nuestros socios de la Plataforma de Viajes de Marca Blanca a través de nuestros métodos de entrega push y pull son:

TAP

Los campos, incluidos los objetos anidados, disponibles para nuestros socios TAAP a través de nuestro método de entrega push son: