Recupere el estado y los detalles de un itinerario existente, confirme el estado de una reserva solicitada anteriormente o recupere una lista de itinerarios de un periodo especificado.

Utilice esta solicitud para confirmar el estado de las reservas que se devuelven con un estado diferente a "CF" y evitar que se efectúen posibles reservas duplicadas.

Formatos de solicitud
URL de XML/REST: GET https://book.api.ean.com/ean-services/rs/hotel/v3/itin?
Elemento principal de XML: <HotelItineraryRequest>

Parámetros de solicitud

Parámetros base
Nombre Valor Obligatorio Descripción
itineraryId largo no El valor que se devuelve de una solicitud de reserva anterior. No se debe enviar junto a affiliateConfirmationId.

Nota: Para los hoteles que utilicen Expedia Partner Central, no se pueden localizar los itinerarios utilizando este valor. Utilice el EXPEDIA_BOOKING_ITEM_ID valor de confirmationExtras para obtener un valor compatible con EPC.

affiliateConfirmationId cadena no El valor asociado a la reserva si este elemento se ha utilizado en la solicitud de reserva. Utilícelo como sustituto cuando itineraryId no esté disponible; por ejemplo, después de una respuesta de reserva con tiempo de espera agotado. No se debe enviar junto a itineraryId.
email cadena en caso de utilizar itineraryId La dirección de correo electrónico de la reserva.
lastName cadena en caso de utilizar creditCardNumber Los apellidos que aparecen en la reserva.
creditCardNumber cadena no El número de tarjeta de crédito que se ha utilizado para hacer la reserva. Se debe enviar con lastName.
confirmationExtras matriz no Indique un elemento de datos de seguimiento específico para que se identifique en los registros devueltos. additionalData1 y additionalData2 aparecen de modo predeterminado, a menos que se especifique lo contrario.
Si se solicita más de un elemento de datos adicionales, se tratará de una lista delimitada por comas. Consulte la página Seguimiento de reservas para obtener más información sobre el envío de datos de seguimiento en la solicitud de reserva.
ItineraryQuery objeto no

Utilice este objeto para solicitar una lista de itinerarios basados en un intervalo de fechas. Puede buscar por las fechas de registro de salida o de creación del itinerario.

Nota: Si se usa este método, es posible que no se devuelvan las reservas efectuadas en el mismo día, ya que es preciso utilizar una tabla de datos diferente que la utilizada para las solicitudes que contienen un solo itineraryId. La tabla utilizada por ItineraryQuery puede retrasarse hasta un día.

ItineraryQuery.creationDateStart cadena no La fecha de inicio al buscar por la fecha de creación. Busque itinerarios que se hayan reservado hace 30 días como máximo.
ItineraryQuery.creationDateEnd cadena en caso de especificarse una fecha de inicio La fecha de finalización al buscar por la fecha de creación. Utilice un intervalo de fechas de un día para ver las reservas de hoy. Unos intervalos de fechas más amplios no incluirán las reservas de hoy.
ItineraryQuery.departureDateStart cadena no La fecha de inicio al buscar por la fecha de registro de salida. Busque itinerarios con un máximo de 30 días después de la finalización de la estancia.
ItineraryQuery.departureDateEnd cadena en caso de especificarse una fecha de inicio La fecha de finalización al buscar por la fecha de registro de salida.
ItineraryQuery.includeChildAffiliates booleano no

Envíelo como true para que se devuelva cualquier cuenta secundaria que pertenezca al cid enviado en la solicitud.

Respuesta de itinerario
Devuelve todos los detalles de itinerarios individuales, incluidos la propiedad y las habitaciones reservadas, los detalles del cliente utilizados para reservar la habitación y el estado de la reserva.

Esta respuesta también puede devolver una lista de itinerarios basados en un intervalo de fechas de creación o salida especificado en la solicitud.

Utilice esta información para proporcionar más información de confirmación en la solicitud de un cliente, verificar el estado de una reserva existente si originalmente se devolvió con un error o, en caso de que se emplee una de las opciones de intervalo de fechas, para recopilar estadísticas de ventas internas.

Ya que esta respuesta devuelve información de clientes, proporcione cualquier dato relacionado con usuarios mediante HTTPS.
Contenido de la respuesta
Elemento principal: HotelItineraryResponse
Elemento de la matriz: Itinerary


La respuesta de itinerario consta de una matriz de Itinerary en el elemento principal HotelItineraryResponse. Los itinerarios individuales simplemente se devuelven como una sola instancia de Itinerary.

El elemento principal tiene un solo atributo size para indicar el número de itinerarios que se incluyen en la respuesta.

Itinerary elementos

Nombre Valor Descripción
itineraryId largo El ID asociado a la reserva. Proporciónelo únicamente a los clientes si depende del servicio de asistencia de EAN (no dispone de sus propios agentes).
affiliateId largo El cid atribuido a la reserva.
creationDate cadena La fecha de realización de la reserva.
itineraryStartDate cadena La fecha de registro de entrada.
itineraryEndDate cadena La fecha de registro de salida.
affiliateCustomerId cadena El valor que se utiliza cuando se efectúa la reserva, si procede.
Customer objeto Contiene toda la información del cliente asociada a la reserva. En este caso, el cliente es el titular de la tarjeta de pago que se utilizó para efectuar la reserva.
Customer.email cadena La dirección de correo electrónico del cliente.
Customer.firstName cadena El nombre de pila del cliente.
Customer.lastName cadena Los apellidos del cliente.
Customer.homePhone cadena El teléfono particular del cliente.
Customer.workPhone cadena El teléfono del trabajo del cliente, si se ha proporcionado.
Customer.extension cadena La extensión telefónica del cliente, si se ha proporcionado.
Customer.faxPhone cadena El número de fax del cliente, si se ha proporcionado.
Customer.CustomerAddresses matriz Contiene la información de la dirección del cliente.
CustomerAddresses.address1 cadena La dirección postal del cliente.
CustomerAddresses.address2 cadena La segunda línea de la dirección postal, si se ha proporcionado.
CustomerAddresses.address3 cadena La tercera línea de la dirección postal, si se ha proporcionado.
CustomerAddresses.city cadena La ciudad del cliente.
CustomerAddresses.stateProvinceCode cadena Se trata de un código de dos caracteres correspondiente al estado o la provincia de la ciudad especificada. Solo devuelve códigos de país de EE. UU., Canadá y Australia.

Referencias:
Códigos de estados de EE. UU.
Códigos de provincias y territorios de Canadá
Códigos de provincias y territorios de Australia
  • Capital Australiana - AC
  • Nueva Gales del Sur - NW
  • Territorio del Norte - NO
  • Queensland - QL
  • Australia Meridional - SA
  • Tasmania - TS
  • Victoria - VC
  • Australia Occidental - WT
CustomerAddresses.countryCode cadena El código ISO-3166 de dos caracteres correspondiente al país del cliente.
CustomerAddresses.postalCode cadena El código postal del cliente.
CustomerAddresses.isPrimary booleano Indica si se trata de la dirección principal conocida del cliente.
CustomerAddresses.type entero Un valor de 1 indica que es una dirección de facturación; un valor de 2 indica que se trata de una dirección de envío.
HotelConfirmation matriz Contiene información sobre la habitación y el hotel reservados, así como el estado actual del itinerario.
HotelConfirmation.supplierId largo El proveedor que se ha utilizado para reservar el hotel.
Valores:
2: Hoteles de Expedia Collect
9: Apartamentos de Expedia Collect
13: Propiedades de Expedia.com
HotelConfirmation.chainCode cadena El código de la cadena hotelera.
HotelConfirmation.creditCardType cadena El tipo de tarjeta de crédito que se utilizó para efectuar la reserva.
HotelConfirmation.arrivalDate cadena La fecha de registro de entrada.
HotelConfirmation.departureDate cadena La fecha de registro de salida.
HotelConfirmation.confirmationNumber cadena El número de confirmación que se devuelve en la respuesta de la reserva en el momento de efectuar la reserva. Proporciónelo únicamente a los clientes si depende del servicio de asistencia de EAN (no dispone de sus propios agentes).
HotelConfirmation.cancellationNumber cadena El número de cancelación que se devuelve en la respuesta de la cancelación si se ha anulado el itinerario.
HotelConfirmation.numberOfAdults entero El número de adultos confirmados para la reserva.
HotelConfirmation.numberOfChildren entero El número de niños confirmados para la reserva.
HotelConfirmation.affiliateConfirmationId cadena El valor que se ha enviado para la reserva, si lo hubiera.
HotelConfirmation.smokingPreference cadena La preferencia para fumadores, en caso de que se haya indicado en la reserva original.
HotelConfirmation.supplierPropertyId cadena El ID de la propiedad del proveedor; debe ser igual al propertyId de la respuesta de disponibilidad.
HotelConfirmation.roomType cadena El código del tipo de habitación para la habitación reservada.
HotelConfirmation.rateType cadena El tipo de tarifa para la habitación reservada.
HotelConfirmation.rateDescription cadena La descripción de la tarifa para la habitación.
HotelConfirmation.roomDescription cadena Descripción corta de habitación.
HotelConfirmation.status cadena Indica el estado de la reserva en el sistema del proveedor durante la reserva. Tenga previsto enviar mensajes pertinentes a los clientes para todos los valores sin confirmar.
CF Confirmado
CX Cancelado
UC Sin confirmar.
PS Pendiente del proveedor. El agente realizará el seguimiento con el cliente cuando haya disponible un número de confirmación.
ER Error. Se ha producido un error permanente en la reserva.
DT Itinerario borrado (normalmente se trata de una reserva errónea o de prueba).
HotelConfirmation.locale cadena La configuración regional utilizada para efectuar la reserva.
HotelConfirmation.nights entero El número de noches reservadas.
HotelConfirmation.GenericRefund objeto Contiene el tipo de moneda y la cantidad de abonos o devoluciones parciales emitidos en el itinerario solicitado debido a quejas del cliente (excluye devoluciones por cancelaciones completas). Está disponible con un valor de minorRev=26 y superior.
GenericRefund.refundAmount entero El valor del abono/devolución que se han emitido en el itinerario. Está disponible con un valor de minorRev=26 y superior.
GenericRefund.currencyCode cadena El código de moneda para la cantidad de abono/devolución proporcionada. Está disponible con un valor de minorRev=26 y superior.
HotelConfirmation.RateInfos objeto

Incluye el objeto RateInfo que se emplea en la solicitud de reserva de origen. También incluye los valores nonRefundable y cancellationPolicy originales.

HotelConfirmation.ReservationGuest objeto/matriz Contiene el nombre del huésped o huéspedes de la reserva.

Las respuestas JSON devolverán pares de nombres de huéspedes en forma de matriz en lugar de un objeto para reservas de varias habitaciones con un status de DT, CX, PS o ER.
HotelConfirmation.specialCheckInInstructions cadena Contiene información crucial para el registro de entrada, como un requisito de notificar al establecimiento la hora de llegada estimada. Muestre esta información en el mismo área que las instrucciones para realizar la entrada primarias.
ReservationGuest.firstName cadena El nombre de pila del huésped.
ReservationGuest.lastName cadena Los apellidos del huésped.
HotelConfirmation.Hotel objeto La información del hotel que se ha reservado.
Hotel.hotelId largo El ID asociado a la propiedad durante la reserva.
Hotel.statusCode cadena El estado actual del hotel en la base de datos de EAN durante la solicitud del itinerario. Cualquier estado diferente a A no se podrá volver a reservar.
Valores:
A: Activo
I: Inactivo
D: Borrado
R: Eliminado
C: De confianza
Hotel.name cadena El nombre del hotel.
Hotel.address1 cadena La dirección postal del hotel.
Hotel.address2 cadena La segunda línea de la dirección postal, si se ha proporcionado.
Hotel.address3 cadena La tercera línea de la dirección postal, si se ha proporcionado.
Hotel.city cadena La ciudad donde se encuentra el hotel.
Hotel.stateProvinceCode cadena Se trata de un código de dos caracteres correspondiente al estado o la provincia de la ciudad especificada. Solo devuelve códigos de país de EE. UU., Canadá y Australia.

Referencias:
Códigos de estados de EE. UU.
Códigos de provincias y territorios de Canadá
Códigos de provincias y territorios de Australia
Hotel.countryCode cadena El código ISO-3166 de dos caracteres correspondiente al país del cliente.
Hotel.postalCode cadena El código postal del hotel.
Hotel.phone flotante/cadena El número de teléfono del hotel.
Evite proporcionárselo directamente al cliente con el fin de prevenir que se produzcan problemas de atención al cliente debido a cambios o cancelaciones realizadas directamente con el hotel en lugar de a través de su EAN o de su propio departamento de servicio de Atención al cliente.
Recomiende a los clientes que contesten al mensaje de correo electrónico de confirmación o que llamen al servicio de atención al cliente si tienen cualquier duda sobre la reserva.
Nota: Este valor puede devolverse como flotante o como cadena, según el formato que el hotel le otorgue.
Hotel.fax cadena El número de fax del hotel.
Hotel.latitude flotante La coordenada de latitud del hotel.
Hotel.longitude flotante La coordenada de longitud del hotel.
Hotel.coordinateAccuracyCode cadena El código para comprobar la exactitud de las coordenadas proporcionadas.
Hotel.lowRate flotante La tarifa baja estadística del hotel.
Hotel.highRate flotante La tarifa alta estadística del hotel.
Hotel.hotelRating flotante La clasificación por estrellas del hotel.
Hotel.market cadena El mercado donde se aplicó la reserva, por ejemplo, Los Ángeles.
Hotel.region cadena El mercado regional donde se aplicó la reserva, por ejemplo, California.
Hotel.superRegion cadena Devuelve la organización suprarregional donde se aplicó la reserva, por ejemplo, AMER.
Hotel.theme cadena La temática del establecimiento reservado, por ejemplo, hotel en línea de playa, hotel con spa, etc.
HotelConfirmation.ConfirmationExtras contenedor de la matriz de ConfirmationExtra Devuelve cualquier información de seguimiento solicitada que se haya enviado con la reserva. Tiene el atributo size para indicar el número de valores asociados a la reserva. Debe especificar todos los valores personalizados en la solicitud con el fin de que se devuelvan.
ConfirmationExtras.name cadena El nombre del elemento additionalData.
ConfirmationExtras.value cadena El valor de los datos de seguimiento enviados.
HotelConfirmation.ValueAdds contenedor de ValueAdd Contiene todos los valores añadidos que contiene la reserva. Tiene un atributo size para indicar el número de valores añadidos individuales.

Está disponible con un valor de minorRev=28 o superior.
ValueAdds.ValueAdd matriz

Contiene un elemento description que describe un servicio gratuito individual que se ofrece con la habitación y la tarifa proporcionadas, tales como desayuno o internet inalámbrico gratuitos.

Está disponible con un valor de minorRev=28 o superior.