Recupere os detalhes e o status de um itinerário existente, confirme o status de uma reserva solicitada anteriormente ou recupere uma lista de itinerários de um intervalo de datas específico.

Use esta solicitação para confirmar o status de reservas que retornaram com um status diferente de "CF" e evite possíveis reservas duplicadas.
Formatos de solicitação
URL em XML/REST: GET https://book.api.ean.com/ean-services/rs/hotel/v3/itin?
Elemento pai XML: <HotelItineraryRequest>

Parâmetros de solicitação

Parâmetros base
Nome Valor Obrigatório Descrição
itineraryId long não Valor retornado de uma solicitação de reserva anterior. Não envie junto com affiliateConfirmationId.

Nota: Para os hotéis que usam o Expedia Partner Central, os itinerários não podem ser localizados com este valor. Use o valor EXPEDIA_BOOKING_ITEM_ID confirmationExtras para retornar um valor compatível com o EPC.

affiliateConfirmationId string não Valor associado à reserva, se este elemento tiver sido usado na solicitação de reserva. Use como substituto quando itineraryId não estiver disponível. Como por exemplo, depois que o tempo limite de uma resposta de reserva é atingido. Não envie junto com itineraryId.
email string sim se itineraryId for usado Endereço de e-mail na reserva.
lastName string sim se creditCardNumber for usado Sobrenome na reserva
creditCardNumber string não O número de cartão de crédito usado para fazer a reserva. Deve incluir o lastName.
confirmationExtras array não Indique um elemento específico de dados de rastreamento a ser identificado nos registros retornados. additionalData1 e additionalData2 serão retornados por padrão, exceto se especificado.
Se estiver solicitando mais de um elemento de dados adicional, esta será uma lista delimitada por vírgulas. Consulte a página Rastrear reservas para obter mais informações sobre o envio de dados de rastreamento na solicitação de reserva.
ItineraryQuery object não

Use este objeto para solicitar uma lista de itinerários baseada em um intervalo de datas. É possível pesquisar por datas de criação de itinerário ou datas de check-out.

Nota: as reservas no mesmo dia podem não ser retornadas ao usar este método, pois uma tabela de dados diferente deve ser usada que não a usada para solicitações únicas de itineraryId. A tabela usada para ItineraryQuery pode estar atrasada em até um dia.

ItineraryQuery.creationDateStart string não Data inicial ao pesquisar usando data de criação. Procure itinerários reservados até 30 dias atrás.
ItineraryQuery.creationDateEnd string sim se uma data inicial tiver sido especificada Data final ao pesquisar usando data de criação. Use um intervalo de datas de um dia para retornar as reservas do dia corrente. Intervalos de datas maiores excluirão as reservas do dia corrente.
ItineraryQuery.departureDateStart string não Data inicial ao pesquisar usando data do check-out. Procure itinerários até 30 dias após o final da estadia.
ItineraryQuery.departureDateEnd string sim se uma data inicial tiver sido especificada Data final ao pesquisar usando data do check-out.
ItineraryQuery.includeChildAffiliates boolean não

Envie como true para retornar quaisquer contas inferiores pertencentes à cid enviadas na solicitação.

Resposta de itinerário
Retorna todos os detalhes sobre itinerários individuais, como o estabelecimento e os quartos reservados, os dados do cliente usados para reservar o quarto e o status da reserva em si.

Esta resposta também pode retornar uma lista de itinerários baseada em um intervalo de datas de partida ou de criação especificadas na solicitação.

Use estes dados para fornecer mais informações de confirmação a pedido do cliente, para verificar o status de uma reserva existente (se inicialmente retornada com erro) ou ao usar uma das opções de intervalo de datas, para compilar estatísticas de vendas internas.

Como esta resposta retorna informações do cliente, forneça quaisquer dados direcionados ao usuário por HTTPS.
Conteúdo da resposta
Elemento pai: HotelItineraryResponse
Elemento de matriz: Itinerary


A resposta de itinerário consiste em uma matriz de Itinerary dentro do elemento pai HotelItineraryResponse. Itinerários simples retornam apenas uma única instância de Itinerary.

O elemento pai tem um único atributo size para indicar o número de itinerários contidos na resposta.

Itinerary Elementos

Nome Valor Descrição
itineraryId long ID associada à reserva. Somente forneça aos clientes se confiar no suporte da EAN (você não tem seus próprios agentes).
affiliateId long cid creditada para a reserva
creationDate string A reserva de data foi feita
itineraryStartDate string Data do check-in
itineraryEndDate string Data do check-out
affiliateCustomerId string Valor usado quando a reserva foi feita, se aplicável
Customer object Contém todas as informações sobre o cliente associado à reserva. Neste caso, cliente = titular do cartão de pagamento usado para criar a reserva.
Customer.email string Endereço de e-mail do cliente
Customer.firstName string Nome do cliente
Customer.lastName string Sobrenome do cliente
Customer.homePhone string Telefone residencial do cliente
Customer.workPhone string Telefone comercial do cliente, se fornecido
Customer.extension string Ramal de telefone do cliente, se fornecido
Customer.faxPhone string Número de fax do cliente, se fornecido
Customer.CustomerAddresses array Contém as informações de endereço do cliente
CustomerAddresses.address1 string Endereço do cliente
CustomerAddresses.address2 string Segunda linha de endereço, se fornecido
CustomerAddresses.address3 string Terceira linha de endereço, se fornecido
CustomerAddresses.city string Cidade do cliente
CustomerAddresses.stateProvinceCode string Código de dois caracteres do estado/província que contém a cidade especificada. Retorna códigos de país somente para EUA, Canadá e Austrália.

Referências:
Códigos de estado nos EUA
Códigos de província/território no Canadá
Códigos de província/território na Austrália
  • Capital da Austrália - AC
  • Nova Gales do Sul - NW
  • Território do Norte - NO
  • Queensland - QL
  • Austrália Meridional - SA
  • Tasmânia - TS
  • Victoria - VC
  • Austrália Ocidental - WT
CustomerAddresses.countryCode string Código de dois caracteres ISO-3166 do país do cliente.
CustomerAddresses.postalCode string Código postal do cliente
CustomerAddresses.isPrimary boolean Indica se este é o endereço principal do cliente
CustomerAddresses.type int Um valor 1 indica um endereço de cobrança; um valor 2 indica um endereço de envio.
HotelConfirmation array Contém informações sobre o quarto e o hotel reservados, bem como o status atual do itinerário.
HotelConfirmation.supplierId long Fornecedor usado para reservar o hotel.
Valores:
2: hotéis da Expedia Collect
9: condos da Expedia Collect
13: Estabelecimentos da Expedia.com
HotelConfirmation.chainCode string Código da rede hoteleira
HotelConfirmation.creditCardType string Tipo de cartão de crédito usado para criar a reserva
HotelConfirmation.arrivalDate string Data do check-in
HotelConfirmation.departureDate string Data do check-out
HotelConfirmation.confirmationNumber string Número de confirmação retornado na resposta da reserva quando ela foi feita. Somente forneça aos clientes se confiar no suporte da EAN (você não tem seus próprios agentes).
HotelConfirmation.cancellationNumber string Número de cancelamento retornado na resposta do cancelamento se o itinerário tiver sido cancelado
HotelConfirmation.numberOfAdults int Número de adultos confirmados na reserva
HotelConfirmation.numberOfChildren int Número de crianças confirmadas na reserva
HotelConfirmation.affiliateConfirmationId string Valor enviado pela reserva, se houver
HotelConfirmation.smokingPreference string Preferência de fumante/não fumante, se indicado na reserva original
HotelConfirmation.supplierPropertyId string ID do estabelecimento do fornecedor; o mesmo que propertyId na resposta de disponibilidade
HotelConfirmation.roomType string Código de tipo de quarto referente ao quarto reservado
HotelConfirmation.rateType string Tipo de tarifa para o quarto reservado
HotelConfirmation.rateDescription string Descrição da tarifa referente ao quarto.
HotelConfirmation.roomDescription string Breve descrição do quarto.
HotelConfirmation.status string Indica o status da reserva no sistema do fornecedor no momento da reserva. Antecipe mensagens de clientes apropriadas para todos os valores não confirmados.
CF Confirmada
CX Cancelada
UC Não confirmada.
PS Fornecedor pendente. O agente fará o acompanhamento com o cliente quando houver um número de confirmação disponível.
ER Erro. Falha permanente na reserva.
DT Itinerário excluído (normalmente, um teste ou uma reserva com falha)
HotelConfirmation.locale string Local usado para fazer a reserva
HotelConfirmation.nights int Número de diárias reservadas
HotelConfirmation.GenericRefund object Contém o tipo de moeda e o valor de créditos parciais ou reembolsos emitidos para o itinerário solicitado devido a reclamações de clientes (não reembolsos para cancelamentos completos). Disponível com minorRev=26 e superior.
GenericRefund.refundAmount int O valor do crédito/reembolso emitido para o itinerário. Disponível com minorRev=26 e superior.
GenericRefund.currencyCode string O código da moeda do valor do crédito/reembolso fornecido. Disponível com minorRev=26 e superior.
HotelConfirmation.RateInfos object

Contém o objeto RateInfo usado na solicitação de reserva originada. Também contém os valores nonRefundable e cancellationPolicy originais.

HotelConfirmation.ReservationGuest object/array Contém os nomes dos hóspedes na reserva.

As respostas JSON retornarão pares de nomes de hóspedes como uma matriz, em vez de um objeto, para as reservas de vários quartos com status DT, CX, PS ou ER.
HotelConfirmation.specialCheckInInstructions string Contém informações importantes para o check-in, como o requisito de notificar ao estabelecimento o horário estimado de chegada. Exiba essas informações junto com as principais instruções de check-in.
ReservationGuest.firstName string Nome do hóspede
ReservationGuest.lastName string Sobrenome do hóspede
HotelConfirmation.Hotel object Informações sobre o hotel reservado
Hotel.hotelId long ID associada ao estabelecimento no momento da reserva
Hotel.statusCode string O status atual do hotel no banco de dados da EAN no momento da solicitação de itinerário. Qualquer status diferente de A não pode ser reservado novamente.
Valores:
A:Ativo
I:Inativo
D:Excluído
R:Removido
C:De confiança
Hotel.name string Nome do hotel
Hotel.address1 string Endereço do hotel
Hotel.address2 string Segunda linha de endereço, se fornecido
Hotel.address3 string Terceira linha de endereço, se fornecido
Hotel.city string Cidade onde o hotel está localizado
Hotel.stateProvinceCode string Código de dois caracteres do estado/província que contém a cidade especificada. Retorna códigos de país somente para EUA, Canadá e Austrália.

Referências:
Códigos de estado nos EUA
Códigos de província/território no Canadá
Códigos de província/território na Austrália
Hotel.countryCode string Código de dois caracteres ISO-3166 do país do cliente.
Hotel.postalCode string Código postal do hotel
Hotel.phone float/string Número de telefone do hotel.
Evite informar ao cliente para evitar problemas com o serviço de atendimento ao cliente decorrentes de alterações ou cancelamentos realizados diretamente com o hotel, e não através da EAN ou do seu próprio departamento específico para esse serviço.
Incentive os clientes a responderem ao e-mail de confirmação e/ou ligarem para o serviço de atendimento ao cliente caso tenham dúvidas sobre a reserva.
Observação: esse valor pode retornar como um float ou uma string, dependendo de como estiver formatado pelo hotel.
Hotel.fax string Número de fax do hotel
Hotel.latitude float Coordenada de latitude do hotel
Hotel.longitude float Coordenada de longitude do hotel
Hotel.coordinateAccuracyCode string Código de precisão das coordenadas fornecidas
Hotel.lowRate float Tarifa baixa estatística do hotel
Hotel.highRate float Tarifa alta estatística do hotel
Hotel.hotelRating float Classificação por estrelas do hotel
Hotel.market string O mercado ao qual a reserva foi aplicada (por exemplo, Los Angeles).
Hotel.region string O mercado regional ao qual a reserva foi aplicada (por exemplo, Califórnia).
Hotel.superRegion string Retorna a super-região à qual a reserva foi aplicada (por exemplo, AMER).
Hotel.theme string Tema do estabelecimento reservado (por exemplo, hotel de praia, hotel spa, etc).
HotelConfirmation.ConfirmationExtras contêiner para a matriz ConfirmationExtra Retorna qualquer informação de rastreamento solicitada que tenha sido enviada com a reserva. Tem o atributo size para indicar o número de valores associados à reserva. Deve especificar os valores personalizados na solicitação para que eles sejam retornados.
ConfirmationExtras.name string O nome do item additionalData
ConfirmationExtras.value string Valor dos dados de rastreamento enviados
HotelConfirmation.ValueAdds contêiner para ValueAdd Contém todos os valores agregados incluídos na reserva. Tem um atributo size para indicar o número de valores agregados individuais.

Disponível com minorRev=28 ou superior.
ValueAdds.ValueAdd array

Contém um elemento description descrevendo um serviço gratuito individual oferecido com o quarto e a tarifa fornecidos, como café da manhã ou internet sem fio gratuitos.

Disponível com minorRev=28 ou superior.