Entrega de la API para itinerarios

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

Opciones de envío

Tu API para el envío de datos de itinerarios puede utilizar tanto un mecanismo «push» como uno «pull».

Mecanismo push

El servicio push envía actualizaciones del itinerario en cuanto se producen. Los campos principales de la reserva están disponibles a los pocos minutos de realizar una transacción, y los campos secundarios y de ampliación, en un plazo de 2 a 4 horas. Esta opción te permite:

Muestra la información de las reservas de los clientes en tu página web o aplicación
Ofrece a los viajeros productos y servicios adicionales que puedan comprar para su viaje

Los eventos push se enviarán mediante un webhook a la URL que nos facilites, en formato de mensaje HTTP POST. Es posible que estos mensajes lleguen sin un orden concreto, así que fíjate en los elementos creation_date y update_date_time para determinar el orden.

>> Ver más detalles sobre la configuración de la API

Trabajar con eventos «push»

Como los datos del itinerario se envían a medida que están disponibles, es posible que recibas varios eventos para un mismo itinerario: un evento inicial con los campos principales, seguido de eventos posteriores a medida que se completan los datos complementarios o se actualiza el itinerario.

>> Echa un vistazo a la sección «Campos disponibles» para ver un desglose completo de los tiempos de los campos

Qué hacer:

En cada itinerario habrá varios eventos: usa itinerary_id para relacionar los eventos y ten siempre en cuenta que la versión más reciente de update_date_time es la que prevalece.
Elige cómo gestionar las actualizaciones: cuando recibas un nuevo evento para un itinerario ya existente, puedes sobrescribir el registro anterior con los datos más recientes o añadir cada evento al final para mantener un historial de cambios
Gestiona adecuadamente los campos que faltan: es posible que los campos secundarios no estén presentes en los eventos iniciales; comprueba si los campos están presentes antes de procesarlos

Evita lo siguiente:

Supongamos que el primer evento contiene la carga útil completa:. Los campos adicionales aparecen en eventos posteriores.
Considera como errores los eventos múltiples en un mismo itinerario:. Este es el comportamiento esperado.
Considera que las cifras de real-time son definitivas:, aunque pueden sufrir modificaciones en las próximas 24 horas

Mecanismo pull

Nota

El servicio «Pull delivery» solo está disponible para los socios de la plataforma de viajes de marca blanca.

El servicio de consulta proporciona datos detallados sobre itinerarios para facilitar:

Análisis de datos
Conciliar los registros de reservas con los datos de Expedia Group
Recuperación de datos para intervalos de tiempo en los que falló el envío por push
Investigaciones del servicio de asistencia técnica

Al igual que con la entrega «push», los datos del itinerario están disponibles en dos niveles para la entrega «pull»: se puede acceder a los campos principales (itinerary_ID, status, gross_booking_value, checkin_date y checkout_date) a los pocos minutos de realizar una reserva o una actualización, mientras que los campos complementarios y de enriquecimiento están disponibles en un plazo de 2 a 4 horas.

>> Echa un vistazo a «Campos disponibles» para ver un desglose completo por campo

Este servicio consta de dos puntos de conexión de HTTP GET que te permiten:

Crea una lista de itinerarios creados o actualizados en un intervalo de tiempo determinado utilizando las variables creation_date_start, creation_date_end, update_date_time_start y update_date_time_end
Busca itinerarios concretos por su itinerary_id

>> Echa un vistazo a la configuración de la API para saber más sobre el proceso de autenticación

Recuperación de datos de itinerarios por intervalo de tiempo

Para obtener los datos del itinerario correspondientes a un intervalo de tiempo determinado, realiza una consulta al punto final « GET /itineraries » utilizando update_date_time_start y update_date_time_end como intervalo de consulta.

Enfoque recomendado:

Utiliza los campos de update_date_time en la ventana de búsqueda:. Utiliza update_date_time_start y update_date_time_end como ventana de búsqueda para recuperar los itinerarios creados o actualizados en un periodo determinado. Si solo usas creation_date, te perderás las actualizaciones del itinerario.
Guarda la marca de tiempo de tu última consulta correcta:. Úsala como tu próximo update_date_time_start, ampliando la ventana poco a poco.
Deduplicar:. Usa itinerary_id + update_date_time en tus consultas. Es posible que el mismo itinerario aparezca en varias ventanas de consulta a medida que se van completando los campos complementarios. Considera siempre como referencia el registro que aparece en update_date_time.

Si tu caso de uso requiere los datos de itinerario más completos y actualizados, te recomendamos el envío 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 suele estar disponible cada campo tras una reserva o una actualización:

****o en tiempo real: disponible a los pocos minutos de realizar una reserva o una actualización
Near-real-time: Disponible entre 2 y 4 horas después de hacer una reserva o una modificació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 la que se hizo la reserva por primera vez, expresada en el formato de fecha ISO 8601 (YYYY-MM-DD).	2023-02-05	En tiempo real
`update_date_time`*	La fecha y la hora de la última actualización del itinerario, expresadas en el 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ó por Internet (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 si 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`**	Apellido 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. Expresado en el formato de fecha ISO 8601 (YYYY-MM-DD).	2023-02-01	En tiempo real
`checkout_date`*	Fecha de salida del elemento de alojamiento correspondiente. Expresado en el formato de fecha ISO 8601 (YYYY-MM-DD).	2023-02-05	En tiempo real
`property.id`	Expedia Group's identificador único del hotel o del alojamiento vacacional. informar	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 lo define el hotel o la empresa de alquiler vacacional.	Habitación doble confortable 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. Expresado en el 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. Expresado en el formato de fecha ISO 8601 (YYYY-MM-DD).	2023-02-02	En tiempo real
`airline.plating_carrier_name`	Nombre de la aerolínea que emitió el billete.	Air Canada	Near-real-time
`airline.plating_carrier_code`	Asociación Internacional de Transporte Aéreo (IATA): código de la aerolínea que emitió el billete.	AC	En tiempo real
`carrier_pnr`	Nombre del pasajero que figura en el registro de la aerolínea 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. Expresado en el 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. Expresado en el 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. Expresado en el formato de fecha ISO 8601 (YYYY-MM-DD).	2023-02-03	En tiempo real
`activity_end_date`*	Fecha de fin de la actividad. Expresado en el formato de fecha ISO 8601 (YYYY-MM-DD).	2023-02-03	En tiempo real
`vendor.name`	Nombre del proveedor que ofrece la actividad.	Olivia's Tours	En tiempo real
`activity_city`	Ciudad donde se celebra la actividad.	San Judas	En tiempo real
`activity_country_code`	Código del país donde se lleva a cabo 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 en 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. Solo disponible para artículos de reserva de alojamientos.	Solo alojamiento	Near-real-time
`rate_plan_type`	Tipo de tarifa utilizado para la reserva. Solo disponible para artículos de reserva de alojamientos.	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 recoge el valor monetario de la reserva, desglosado en valor bruto de la reserva e impuestos y tasas.
`pricing.gross_booking_value`	Objeto que recoge 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 la 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 sobre todos los campos de la plataforma de viajes de marca blanca

Los campos de fecha están en hora universal coordinada (UTC).
** Esto se refiere a datos de información de identificación personal (PII). Asegúrate de hacerlo bien, siguiendo las directrices de tu empresa. Inclúyelo solo cuando sea absolutamente necesario.

Programa de afiliados para agencias 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 del itinerario personalizado que te da la agencia al finalizar 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 la que se realizó inicialmente la reserva, expresada en el formato de fecha ISO 8601 (YYYY-MM-DD).	2023-02-05	En tiempo real
`update_date_time`*	La fecha y la hora de la última actualización del itinerario, expresadas en el 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ó por Internet (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 ha hecho 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 y del agente de TAAP que hicieron 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 una reserva concreta o de todo el itinerario. Te informo de... Consulta la tabla `earnings` para ver la lista de elementos anidados.

purchaser

Estos campos sirven para identificar 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 indican la agencia y el agente de TAAP que hicieron la reserva.

Nombre del campo	Definición	Ejemplo	Disponibilidad
`agency.name`	Nombre de la agencia de 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 de TAAP que hizo la reserva.	Bob	En tiempo real
`agency.agent.last_name`**	Apellido del agente de TAAP que hizo la reserva.	Jones	En tiempo real
`agency.agent.email`**	Dirección de correo electrónico del agente de 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 ya se ha pagado el itinerario.	Valores posibles: pagado Pendiente de pago	Near-real-time
`deferred`	Si el pago del itinerario se aplazó (verdadero) o se abonó (falso). Te informo de que... Se representa con un valor booleano.	true	Near-real-time
`payment_due_date`	La fecha de vencimiento del pago en formato ISO 8601 (YYYY-MM-DD). Solo se aplica a los pagos aplazados.	2023-02-05	Near-real-time
`payee`	Indica quién se encarga de pagar el 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. Expresado en el formato de fecha ISO 8601 (YYYY-MM-DD).	2023-02-01	En tiempo real
`checkout_date`*	Fecha de salida del elemento de alojamiento correspondiente. Expresado en el formato de fecha ISO 8601 (YYYY-MM-DD).	2023-02-05	En tiempo real
`property.id`	Expedia Group's identificador único del hotel o del alojamiento 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 lo define el hotel o la empresa de alquiler vacacional.	Habitación doble confortable 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 alquileres vacacionales.	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 detalles de la comisión de la reserva de 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. Expresado en el 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. Expresado en el formato de fecha ISO 8601 (YYYY-MM-DD).	2023-02-02	En tiempo real
`airline.plating_carrier_name`	Nombre de la aerolínea que emitió el billete.	Air Canada	Near-real-time
`airline.plating_carrier_code`	IATA código de la aerolínea que emitió el billete.	AC	En tiempo real
`carrier_pnr`	Nombre del pasajero que figura en el registro de la aerolínea 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 tramos 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 detalles de la comisión de la reserva de 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. Expresado en el 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. Expresado en el 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 detalles 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. Expresado en el formato de fecha ISO 8601 (YYYY-MM-DD).	2023-02-03	En tiempo real
`activity_end_date`*	Fecha de fin de la actividad. Expresado en el formato de fecha ISO 8601 (YYYY-MM-DD).	2023-02-03	En tiempo real
`vendor.name`	Nombre del proveedor que ofrece la actividad.	Olivia's Tours	En tiempo real
`activity_city`	Ciudad donde se celebra la actividad.	San Judas	En tiempo real
`activity_country_code`	Código del país donde se lleva a cabo la actividad. Se representa en formato ISO 3166-1 alfa-2 de dos letras.	CA	En tiempo real
`offering_name`	Nombre de la actividad.	Excursión por el sendero 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 de la partida de reserva de la actividad. informo 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 recoge el valor monetario de la reserva, desglosado en 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 la 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

beneficios

Nombre del campo	Definición	Ejemplo	Disponibilidad
`commission`	Objeto que representa el importe de la comisión correspondiente a la reserva o al 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 del pago.
`commission.billable_currency.currency`	Moneda en la que se expresa el importe de la comisión, según el formato ISO 4217	USD	En tiempo real
`commission.billable_currency.value`	Importe de la comisión.	100.25	En tiempo real
`service_charge`	Objeto que representa las comisiones de servicio que una agencia TAAP aplica al itinerario.
`service_charge.amount`	Objeto que representa el valor monetario de la comisión de servicio que aplica una agencia TAAP al itinerario.
`service_charge.amount.billable_currency`	Objeto que representa el importe de la comisión del servicio en la moneda de pago.
`service_charge.amount.billable_currency.currency`	Moneda en la que se expresa el importe del cargo por servicio, representada en formato ISO 4217.	USD	En tiempo real
`service_charge.amount.billable_currency.value`	Importe de las comisiones de servicio que la agencia TAAP aplica al itinerario. Incluye impuestos y tasas cuando la agencia se hace cargo de ellos.	50,50	En tiempo real
`service_charge.taxes_and_fees`	Objeto que representa el importe y la moneda de los impuestos y tasas correspondientes a la tarifa del servicio.
`service_charge.taxes_and_fees.billable_currency`	Importe que ha pagado el cliente en concepto de impuestos y tasas sobre el cargo por servicio, en la moneda de facturación. Este valor solo se rellena cuando « Expedia TAAP » se encarga de los impuestos y las tasas.
`service_charge.taxes_and_fees.billable_currency.currency`	Moneda de pago, expresada 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 sobre todos los campos de TAAP

Los campos de fecha están en hora universal coordinada (UTC).
** Esto se refiere a datos de información de identificación personal (PII). Asegúrate de gestionarlo correctamente siguiendo las directrices de tu empresa. Inclúyelo solo cuando sea absolutamente necesario.

Detalles de la API

Te hemos facilitado un resumen del esquema y las configuraciones de la API, teniendo en cuenta cómo utilizaría tu empresa los datos de la API de itinerarios. Puedes descargar las especificaciones de OpenAPI y usar una herramienta de pruebas de API para ver cómo se comparan los ejemplos y las definiciones de esquemas con los resultados reales.

Plataforma de viajes de marca blanca

Los campos, incluidos los objetos anidados, a los que tienen acceso 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, a los que pueden acceder nuestros socios de TAAP a través de nuestro método de envío «push» son: