Solicita uma reserva para o(s) quarto(s) especificado(s). A solicitação deve ser enviada com o método POST via HTTPS para proteger as informações de pagamento do cliente. As informações enviadas na solicitação estão sujeitas a métodos de validação de segurança e proteção antifraude da EAN.

As informações do cartão de crédito fornecidas na solicitação serão usadas para pré-pagamento direto da reserva. A reserva do cliente é paga na íntegra (salvo os extras, como serviço de quarto) assim que uma resposta positiva é recebida, mesmo que tenha sido feita com meses de antecipação.

Certifique-se de usar o par cid/apiKey correto para reservas ativas. Isso é fundamental tanto para receber reservas com êxito como para garantir que qualquer comissão obtida seja paga na conta certa.

Caso ocorra erros de validação de entrada para os valores city, address ou firstName e lastName, observe que, atualmente, a API é compatível apenas com os conjuntos de caracteres UTF-8 Basic Latin e Latin-1 Supplement. Idiomas que usam caracteres incompatíveis com esses conjuntos de caracteres, como ő ou ű, devem ser filtrados ou convertidos para evitar erros de entrada.


Formatos de solicitação
URL em XML/REST: POST https://book.api.ean.com/ean-services/rs/hotel/v3/res
Elemento pai XML: <HotelRoomReservationRequest>

Para evitar problemas de limitação de tamanho de URL, envie todos os valores de solicitação no corpo de POST como dados de application/x-www-form-urlencoded. Não envie parâmetros dentro da string da URL em si.
Para solicitações de XML, elementos comuns devem ser enviados no mesmo formato usado para solicitações GET. Não tente formatar esses valores como elementos XML no corpo de POST.



Parâmetros de solicitação

Parâmetros de URL específicos do serviço
Nome Valor Obrigatório Descrição
currencyCode string sim Sempre use o valor de atributo retornado no nó ChargeableRateInfo da resposta anterior ao preencher esse parâmetro para uma solicitação de reserva.
O uso de outras fontes para esse valor pode causar erros de incompatibilidade.
additionalData contêiner para MapEntry não

Use este parâmetro somente para reserva para ajudar a rastrear reservas na Central de Afiliados EAN. Consulte nossa página Rastrear reservas para ver a documentação completa.



Parâmetros base
Nome Tipo Obrigatório Descrição
apiExperience string sim

Use esse atributo para identificar a origem de sua solicitação. Selecione um valor aplicável do conjunto fornecido abaixo para cada solicitação enviada.

Valores:
PARTNER_CALL_CENTER - solicitação de um agente na central de atendimento
PARTNER_WEBSITE - solicitação de um site direcionado aos clientes
PARTNER_MOBILE_WEB - solicitação de um site formatado para dispositivos móveis
PARTNER_MOBILE_APP - solicitação de um app para dispositivo móvel
PARTNER_BOT_CACHE - solicitação de um robô de cache
PARTNER_BOT_REPORTING - solicitação de um robô de relatório
PARTNER_AFFILIATE - solicitação de uma API/plataforma usada por sua própria base de afiliados

hotelId long sim ID do estabelecimento para a reserva a ser solicitada.
arrivalDate string sim

Data do check-in, no formato MM/DD/AAAA. Transfira o valor com base na resposta do quarto.

As reservas podem ser feitas até 23h59 do horário local do hotel (21h59 para PST e Ilhas do Pacífico).

departureDate string sim Data do check-out, no formato MM/DD/AAAA. Transfira o valor com base na resposta do quarto.
supplierType string sim Define o fornecedor a ser usado para executar a reserva. Transfira o valor com base na resposta do quarto.

Valores:
E: Expedia Collect
rateKey string sim Valida os parâmetros estabelecidos na solicitação de reserva. Transfira o valor com base na resposta do quarto. Use a rateKey retornada no primeiro Room objeto na resposta do quarto para obter um desempenho melhor.

Se for usado algum valor diferente do fornecido na resposta do quarto anterior, ocorrerá falha na reserva.

Caso você opte por permitir que os clientes modifiquem qualquer parâmetro na fase de reserva, reenvie esses parâmetros em uma nova solicitação de quarto para obter um novo valor válido para esse parâmetro.

Erros referentes a "QueryId inválido" ou erros de armazenamento de tarifas no cache sugerem que a chave expirou ou é inválida. Reenvie a solicitação de quarto anterior para obter um novo valor, mesmo que nenhum parâmetro tenha sido alterado.
roomTypeCode string sim Código designando o quarto específico solicitado. Sempre obtenha dinamicamente com base na solicitação de quarto anterior.

Envie junto com rateCode
rateCode string sim Código designando a tarifa equiparada ao quarto específico solicitado. Sempre obtenha dinamicamente com base na solicitação de quarto anterior.

Envie junto com roomTypeCode
RoomGroup object sim Contêiner para as matrizes Room que definem a contagem de quartos e de hóspedes. Use os mesmos valores para adultos, crianças e idades de crianças conforme definido na solicitação de quarto anterior.

Parâmetros adicionais para esse objeto são necessários especificamente para reservas (veja abaixo).
RoomGroup.Room array sim O número de nós Room define o número de quartos solicitados. Inclua o mesmo número de nós e os mesmos parâmetros de idade/contagem de hóspedes conforme definido na solicitação de quarto anterior.
Room.numberOfAdults int sim Contagem de hóspedes adultos para o quarto. Use o mesmo valor conforme definido na solicitação de quarto anterior.
Room.numberOfChildren int sim se > 0 Contagem de hóspedes crianças para o quarto. Use o mesmo valor conforme definido na solicitação de quarto anterior.
Room.childAges lista separada por vírgulas
de int
sim se a contagem de crianças > 0 Idades de hóspedes crianças, se houver. Use o mesmo valor conforme definido na solicitação de quarto anterior. A EAN considera como criança pessoas com idade entre 0 e 17 anos.
Room.firstName string sim Nome completo do hóspede que está fazendo check-in da reserva. O nome deve corresponder à identificação com foto do hóspede fornecida durante o check-in no estabelecimento.

Somente são aceitos caracteres Latin ASCII sem acento (alfabeto de 26 letras).

Máximo de 25 caracteres; sem saudações ou nomes de empresa. Os nomes dos hóspedes não precisam ser exclusivos para cada quarto.
Room.lastName string sim Sobrenome completo do hóspede que está fazendo check-in da reserva. O nome deve corresponder à identificação com foto do hóspede fornecida durante o check-in no estabelecimento.

Somente são aceitos caracteres Latin ASCII sem acento (alfabeto de 26 letras).

Máximo de 40 caracteres; sem saudações ou nomes de empresa. Os nomes dos hóspedes não precisam ser exclusivos para cada quarto.
Room.bedTypeId string sim Código para a escolha de cama do cliente (ou um único valor se nenhuma escolha tiver sido oferecida).

Transfira o valor correspondente com base no atributo BedType ID do quarto selecionado do cliente na resposta do quarto.

A escolha entre vários tipos de cama para o mesmo quarto é apenas uma solicitação e poderá não ser respeitada no hotel caso a disponibilidade não permita.
Room.numberOfBeds int não Valor de 1 ou 2. Somente solicitação. Ofereça apenas se opções de BedType sensatas retornarem na resposta do quarto.
Room.smokingPreference string sim se usado Preferência de fumante/não fumante solicitada. Omita este elemento inteiro da sua solicitação se não for necessário para uma determinada reserva.

Valores possíveis:
NS: não fumante
S: fumante
E: sem preferência

Inclua apenas os valores que foram retornados na resposta do quarto. Não use os valores acima como opções embutidas em código. A inclusão de um valor não fornecido na resposta impedirá a realização da reserva. Não envie vários valores.
affiliateConfirmationId string sim Valor designado para rastreamento de reservas e para ajudar a evitar reservas duplicadas.

Gere um valor exclusivo como uma identificação GUID (36 caracteres, no máximo) antes de enviar a reserva. Se a API detectar esse valor emparelhado com uma reserva existente, ela evitará todas as reservas subsequentes, considerando-as como duplicadas.

Para evitar que novas tentativas de reserva sejam rejeitadas, sempre crie um novo valor para a nova tentativa de reserva que falhou devido a qualquer erro, exceto por tempo limite atingido.
affiliateCustomerId string não ID de cliente opcional adicional para uso com rastreamento pelo parceiro. Use esta ID apenas internamente, pois a exposição acidental poderá permitir a recuperação de itinerários que não pertencem ao cliente.
itineraryId long não

Se uma solicitação de reserva inicial retornar com um erro de cartão de crédito, extraia esse valor da resposta e inclua-o na tentativa de reserva subsequente.

Quando for passado novamente, esse valor será equiparado ao registro de itinerário existente que foi gerado pela sua primeira solicitação. Erros ou recusas de cartão de crédito repetidos serão limitados a um único registro para evitar o aparecimento de vários cancelamentos nas estatísticas.

Somente exponha esse valor aos clientes se estiver usando suporte da EAN (você não tem seus próprios agentes de suporte).

Não reenvie esse valor se ele retornar -1. Isso indica que não foi criado um itinerário. Comece novamente com uma nova solicitação depois de enviar o erro e permitir que o cliente o corrija se necessário.

chargeableRate string sim O total a ser cobrado para a reserva.

Transfira o valor total com base no objeto ChargeableRateInfo retornado na resposta do quarto.

Após o envio da solicitação, esta tarifa é validada em relação à tarifa mais recente para as cotações de tarifa e quarto fornecidas. Se a tarifa mais recente for maior, será retornado um erro contendo a nova tarifa mais alta e seu valor rateKey correspondente. Se ela for menor, a solicitação passará com a nova tarifa menor.
specialInformation string não

Permite que o cliente adicione solicitações ou informações extra a serem passadas adiante para o estabelecimento.

Qualquer informação incluída será apenas uma solicitação sem garantia. Não use esse campo para enviar solicitações de serviço de atendimento ao cliente entre empresas ou para transmitir quaisquer informações pessoais/financeiras confidenciais.

Máximo de 256 caracteres sem quebras de linha ou retornos de carro. Qualquer quebra de linha ou retorno de carro não retirado deste parâmetro causará um erro irrecuperável.

sendReservationEmail boolean não

Envie como false se enviar os seus próprios e-mails de confirmação; omita se não fizer isso.

Use este parâmetro apenas se já tiver consultado o gerente de conta ou o suporte sobre seu próprio sistema de e-mail de confirmação.

Parâmetros de informações de pagamento
Esses parâmetros definem as informações usadas para validar e cobrar o pagamento no cartão de crédito do cliente.

As informações para pagamento são fornecidas por meio dos objetos ReservationInfo e AddressInfo. Os valores aplicáveis em ambos os objetos são validados em relação às informações do banco emissor sobre o titular do cartão.

Alguns sistemas usados para processamento e validação de pagamento não conseguem analisar caracteres não latinos. A fim de evitar erros de validação de dados, verifique se somente valores de caracteres latinos são permitidos para todos os parâmetros.

Consulte as nossas melhores práticas para solicitação e processamento de informações de cartão na seção de validação da nossa página de tipos de cartão de crédito.

Nome Valor Obrigatório Descrição
ReservationInfo object sim Contém informações para contato e de cartão de crédito do cliente.
ReservationInfo.email string sim Endereço de e-mail do cliente. O e-mail de confirmação da EAN (travelnow.com) é enviado automaticamente para este endereço. Deve ser um endereço de e-mail válido, mesmo se a sua integração tratar esse campo como somente interno.
Máximo de 50 caracteres para todo o endereço, incluindo @ e .
ReservationInfo.firstName string sim Nome completo do titular do cartão de crédito.
Somente são aceitos caracteres Latin ASCII sem acento (alfabeto de 26 letras).
Máximo de 25 caracteres; sem saudações ou nomes de empresa.
ReservationInfo.lastName string sim Sobrenome completo do titular do cartão de crédito.
Somente são aceitos caracteres Latin ASCII sem acento (alfabeto de 26 letras).
Máximo de 40 caracteres; sem saudações ou nomes de empresa.
ReservationInfo.homePhone string sim

Número do telefone residencial do cliente. Usado por um agente do serviço de atendimento ao cliente quando é preciso entrar em contato com o cliente para resolver um problema com a reserva.

Os números devem ter pelo menos 5 dígitos. Use apenas os caracteres de 0 a 9, +, - e ( ).

ReservationInfo.workPhone string não Número do telefone comercial do cliente. Os números devem ter pelo menos 5 dígitos. Use apenas os caracteres de 0 a 9, +, - e ( ).
ReservationInfo.extension string não Ramal do telefone comercial do cliente, se necessário. Máximo de 5 caracteres.
ReservationInfo.faxPhone string não Número de fax do cliente. Os números devem ter pelo menos 5 dígitos. Use apenas os caracteres de 0 a 9, +, - e ( ).
ReservationInfo.companyName string não Nome da empresa, se necessário, para fins fiscais ou recibos de viagem do funcionário.
ReservationInfo.creditCardType string sim O tipo de cartão de crédito que está sendo usado. Consulte esta página sobre valores específicos para tipos de cartão de crédito e detalhes sobre validação.
ReservationInfo.creditCardNumber string sim Número do cartão de crédito do cliente.
ReservationInfo.creditCardIdentifier string sim O número de identificação ou o código de segurança do cartão (CSV ou CVV), encontrado no verso do cartão. Nunca armazene este valor após a entrada inicial do cliente e a tentativa de reserva.
ReservationInfo.creditCardExpirationMonth string sim Mês de validade do cartão de crédito, no formato MM.
ReservationInfo.creditCardExpirationYear string sim Ano de validade do cartão de crédito, no formato YYYY.
Informações de endereço
As informações de endereço do titular do cartão são enviadas em um objeto separado dos dados do cartão de pagamento em ReservationInfo. Valores especiais podem ser usados nesse objeto durante o desenvolvimento para a realização de reservas de teste estáticas.
Nome Valor Obrigatório Descrição
AddressInfo object sim Contém as informações de endereço do titular do cartão. Essas informações devem coincidir com os registros do fornecedor do cartão de crédito para que o pagamento seja processado com êxito.
AddressInfo.address1 string sim O endereço do cliente, com 28 caracteres, no máximo. Verifique se os caracteres especiais estão codificados corretamente.
AddressInfo.address2 string não Segunda linha de endereço (opcional), com 28 caracteres, no máximo.
AddressInfo.address3 string não Terceira linha de endereço (opcional), com 28 caracteres, no máximo.
city string sim Cidade do cliente.
stateProvinceCode string sim para Estados Unidos,
Canadá e Austrália
Código de dois caracteres do estado/província que contém a cidade especificada. No caso da Austrália, você deverá usar os códigos especiais fornecidos abaixo.

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
countryCode string sim Código de dois caracteres ISO-3166 do país que contém a cidade especificada. Use somente códigos de país designados como "oficialmente atribuídos" na tabela de decodificação ISO-3166.
postalCode string sim Código postal para cobrança do cliente. Mínimo de 5 caracteres, máximo de 10. As reservas nos EUA devem usar somente código postal de 5 dígitos.
Para que a reserva seja válida, esse valor deve coincidir com os registros do emissor do cartão de crédito.
Nomeie esse campo como "Código postal para cobrança" ou "CEP para cobrança" para diminuir as falhas. Os caracteres válidos são alfanuméricos, espaços, sublinhados (_) e hifens (-).


Resposta da reserva
Confirma a reserva bem-sucedida dos quartos solicitados ou fornece informações sobre o status da reserva caso ela ainda não tenha sido confirmada.

A resposta de uma reserva bem-sucedida também contém o número do itinerário do cliente, o número de confirmação dele e uma confirmação da seleção de quarto e do preço pago.

Como essa resposta contém dados do cliente, retorne-os para os clientes por meio seguro via HTTPS.

Conteúdo da resposta
Elemento pai: HotelRoomReservationResponse


Nome Valor Descrição
itineraryId long ID exclusiva da EAN para a reserva.

Usado junto com o número de confirmação de reserva para qualquer comunicação que seja feita com o cliente pela EAN ou por seu próprio departamento de serviço de atendimento ao cliente. Certifique-se de que ambos os valores sejam claramente fornecidos ao cliente.
confirmationNumbers array

Número(s) de confirmação da reserva, um para cada quarto reservado. Gerado pelo banco de dados de reservas da EAN.

Este valor é usado junto com a ID de itinerário em todas as comunicações da EAN com o cliente. Se você envia os seus próprios e-mails e confia no suporte da EAN (você não tem os seus próprios agentes), os dois valores deverão ser claramente fornecidos ao cliente. Se você usa o suporte de agente para agente, não forneça esse valor aos clientes.

A reserva de vários quartos retornará um número de confirmação padrão para o primeiro quarto. Os outros quartos terão o mesmo número de confirmação anexado com um hífen e um número começando com 1. Ex: 120467481181, 120467481181-1, 120467481181-2

processedWithConfirmation boolean Indica se o hotel em si confirmou a reserva quando ela foi processada.

Quando retornado como false, indica que o estabelecimento ainda não retornou o número de confirmação da reserva. Provavelmente, a reserva retornará com o status PS.

Nesses casos, um agente da EAN monitorará a reserva até que ela esteja totalmente confirmada. O e-mail de confirmação avisará ao cliente que um número de confirmação será encaminhado por um agente tão logo seja fornecido.
errorText string Qualquer texto de erro que tenha sido gerado durante o processo de reserva além do conteúdo do elemento comum EanWSError.
hotelReplyText string Qualquer informação extra recebida do hotel no momento da reserva.
supplierType string Confirma o sistema do fornecedor usado para processar a reserva.
reservationStatusCode 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.

Valores:
CF Confirmada
CX Cancelada
UC Não confirmada. Trate esse status da mesma forma que DT. A API nunca atribuirá esse status a reservas ao vivo.
PS Fornecedor pendente. Consulte nosso guia de processo pendente.
ER Erro. Pode ocorrer quando a reserva precisar de atenção do agente ou devido à recusa de um cartão de crédito. Se o erro de cartão de crédito voltar a ocorrer, alerte o cliente apropriadamente. Se ele tentar reservar novamente, reenvie a ID itineraryId retornada na resposta da reserva com falha.
DT Itinerário excluído (normalmente, um teste ou uma reserva com falha)
existingItinerary boolean Indicador de reserva duplicada evitada, usado em conjunto com o parâmetro de solicitação affiliateConfirmationId. Retorna como true junto com o itinerário bem-sucedido existente se o mesmo valor de confirmação é enviado mais de uma vez.
numberOfRoomsBooked int Confirma o número de quartos reservados. Corresponderá à quantidade de números de confirmação retornados.
drivingDirections string Normalmente vazio; não recomendado para exibição.
checkInInstructions string Instruções de check-in para o hotel.
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.
arrivalDate string Confirmação da data do check-in.
departureDate string Confirmação da data do check-out.
hotelName string Nome do hotel reservado.
hotelAddress string Endereço do hotel
hotelCity string Cidade do hotel
hotelStateProvinceCode 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 estados dos Estados Unidos
Códigos de províncias/territórios do Canadá
Códigos de províncias/territórios da Austrália
hotelCountryCode string Código de dois caracteres ISO-3166 do país no qual o hotel está localizado.
hotelPostalCode string Código postal do hotel.
roomDescription string Breve descrição do quarto reservado.
rateOccupancyPerRoom int Confirma quantos hóspedes estão garantidos para o quarto reservado.
RoomGroup object Contêiner para as matrizes Room que definem a contagem de quartos e de hóspedes. Confirma os dados de cama e hóspede de cada quarto reservado.
RoomGroup.Room array O número de nós corresponderá ao valor numberOfRoomsBooked.
Room.numberOfAdults int Contagem de hóspedes adultos para o quarto.
Room.numberOfChildren int Contagem de hóspedes crianças para o quarto.
Room.childAges lista separada por vírgulas
de int
Idades de hóspedes crianças, se houver.
Room.firstName string Nome completo do hóspede que está fazendo check-in da reserva.
Room.lastName string Sobrenome completo do hóspede que está fazendo check-in da reserva.
Room.bedTypeId string Código para a escolha de cama do cliente (ou um único valor se nenhuma escolha tiver sido oferecida).
Room.bedTypeDescription string Descrição confirmando a escolha de tipo de cama.
Room.numberOfBeds int Valor de 1 ou 2.
Room.smokingPreference string Confirma a preferência de fumante/não fumante solicitada.
Room.ChargeableNightlyRates array Contêiner para a matriz NightlyRate do quarto. As tarifas retornadas são específicas para o quarto individual e aparecem em ordem sequencial por toda a duração da estadia.

Para obter o custo médio por noite para vários quartos, use os valores fornecidos por nightlyRatesPerRoom.

Retorna para minorRev=29 e superior.
ChargeableNightlyRates.NightlyRate object

Fornece a tarifa para uma única noite dentro do intervalo da estadia solicitada.

Indica a presença de uma tarifa promocional, da tarifa base e da tarifa após a aplicação da promoção (se for o caso). Contém somente atributos.

No caso de solicitações de vários quartos, esse valor corresponde ao custo médio por noite considerando todos os quartos. A EAN recomenda o uso da nova matriz ChargeableNightlyRates por noite para a exibição de preços de vários quartos.

Para solicitações de vários quartos com minorRev=28 ou inferior, esse elemento fornece tarifas apenas para o primeiro quarto, em vez do valor médio de tarifa.

Atributos:

promo boolean Indica se uma tarifa promocional é aplicada à tarifa desta noite.
rate string A diária após a promoção, se houver, é aplicada.
baseRate string A diária antes da promoção, se houver, é aplicada.
ChargeableNightlyRates.
ConvertedNightlyRates
object Informações de tarifas convertidas para a moeda solicitada pelo cliente. Retornadas apenas se o hotel não emitir faturas na moeda solicitada ou se a mesma não é utilizada pelo mercado da localidade do cliente. Contém os mesmos atributos que ChargeableNightyRates. Retorna para minorRev=29 e superior.
RateInfos contêiner para RateInfo Contém uma matriz de elementos RateInfo que fornecem informações de tarifa detalhadas para quartos individuais.

Se você estiver usando uma integração mais antiga executada em minorRev=6 ou anterior, RateInfo retornará sem o contêiner RateInfos.
RateInfos.RateInfo object Contém todas as informações de tarifa para um quarto Solteiro em vários objetos diferentes e valores individuais.

Atributos:
priceBreakdownboolean Indica se uma nota discriminada de preço completa, incluindo impostos, e o preço total a serem cobrados estão incluídos.
promo boolean Indica se a tarifa retornada é promocional.
rateChange boolean Indica se a tarifa é diferente para pelo menos uma das noites durante a estadia.
RateInfo.cancellationPolicy string Política de cancelamento do estabelecimento. Exibição obrigatória.
RateInfo.CancelPolicyInfoList array Detalha pormenores da política de cancelamento, geralmente determinando o período de multa e as sanções decorrentes do cancelamento.
Revise os detalhes da matriz CancelPolicyInfo
RateInfo.nonRefundable boolean Confirma o valor retornado na resposta do quarto. Se retornado em uma resposta de reserva bem-sucedida como true, a quantia cobrada será final. Somente para Expedia Collect.
RateInfo.ChargeableRateInfo object Os atributos deste objeto contêm o total absoluto a ser cobrado para a reserva, bem como os totais e as tarifas médias. Os nós dentro do objeto fornecem detalhes sobre o preço da diária e as sobretaxas.

Atributos:
total string O total de diárias, impostos e sobretaxas a ser cobrado para a reserva. Esse é o valor total que deverá ser exibido para o cliente e incluído na solicitação de reserva.
surchargeTotal string Total de TaxAndServiceFee e ExtraPersonFee da matriz de Surcharges.
nightlyRateTotal string Total de valores na matriz nightlyRatesPerRoom contidos neste objeto.
maxNightlyRate string Preço da diária mais alta de todas as tarifas retornadas
currencyCode string Código de moeda das tarifas retornadas
commissionableUsdTotal string Quantia usada para calcular comissões de parceiros, em USD. Total de diárias menos sobretaxas.
averageRate string O preço médio de todas as diárias com os valores promocionais aplicados, sem sobretaxas.
averageBaseRate string O preço médio de todas as diárias sem os valores promocionais aplicados, sem sobretaxas. Retornará o mesmo que o valor anterior se não houver nenhuma promoção.
ChargeableRateInfo.nightlyRatesPerRoom array Contêiner para a matriz NightlyRate. Tem o atributo size para indicar número de nós na matriz, o que corresponderá ao número de noites na solicitação. As tarifas retornam em ordem sequencial em toda a duração da estadia.
nightlyRatesPerRoom.NightlyRate n/a Detalha a tarifa para uma única noite dentro do intervalo da estadia solicitada. Indica a presença de uma tarifa promocional, da tarifa base e da tarifa após a aplicação da promoção (se for o caso). Contém somente atributos.

Atributos:
promo boolean Indica se uma tarifa promocional é aplicada à tarifa desta noite.
rate string A diária após a promoção, se houver, é aplicada.
baseRate string A diária antes da promoção, se houver, é aplicada.
RateInfo.promoType string Indica se as promoções retornadas são específicas para dispositivos móveis ou padrão. Retorna Mobile para promoções para dispositivos móveis e Standard para todas as outras.
Para retornar promoções para dispositivos móveis, você deve identificar o app ou o site do seu dispositivo móvel por meio da cadeia de caracteres customerUserAgent apropriada.
RateInfo.depositRequired boolean Indica se é necessário depósito no momento da reserva para garanti-la.
RateInfo.rateType string Indica se a tarifa retornada é pré-paga pela EAN ou pós-paga no hotel. Retorna com um valor MerchantStandard para disponibilidade pré-paga ou não retorna nada para pós-paga.
ChargeableRateInfo.Surcharges array Contêiner para a matriz Surcharge. Esta matriz relaciona as sobretaxas individuais que compõem o valor retornado por surchargeTotal. Tem o atributo size para indicar o número de nós na matriz.
Surcharges.Surcharge n/a Detalha o tipo e a quantidade de uma única sobretaxa. Contém somente atributos.

Atributos:
amount string Quantia da sobretaxa específica
type string Nome da sobretaxa.
Valores possíveis:
  • TaxAndServiceFee
  • ExtraPersonFee
  • Tax
  • ServiceFee
  • SalesTax
  • HotelOccupancyTax

Somente TaxAndServiceFee e ExtraPersonFee contam para surchargeTotal. Todos os outros valores são componentes individuais do valor TaxAndServiceFee.


Nota: os tipos de sobretaxa SalesTax (Imposto de vendas) e HotelOccupancyTax (Imposto de ocupação do hotel) devem ser exibidos conforme a lei estadual em Nova York. Exiba esses valores separadamente nos detalhes de preço final.
RateInfo.HotelFees array

Este elemento discrimina certos impostos e taxas cobrados pelo hotel que, caso contrário, não seriam detalhados especificamente na matriz Surcharges.

Todos os valores neste elemento são cobrados pelo hotel no check-in ou check-out. Eles não fazem parte de nenhuma taxa cobrada no momento da reserva.

Quando preenchido, use esse elemento para atender ao formato de exibição de tarifas/impostos/taxas exigido pelos principais agregadores e mecanismos de busca.

Observe que todas as taxas retornadas são valores totais de toda a reserva, incluindo taxas por noite ou por quarto. Exemplo: Uma taxa de $ 10 por noite para uma estadia de 4 noites será representada pelo valor 40.00

Contém o atributo size para indicar o número de taxas contidas.

HotelFees.HotelFee none

Contém atributos para a descrição, a quantia e a moeda de uma única taxa.

Detalha o total de todas as taxas de resort, de turismo e estaduais ou quaisquer outras taxas cobradas que não possam ser razoavelmente evitadas.

As cobranças retornam na moeda reservável indicada pelo atributo currencyCode de ChargeableRateInfo.

Atributos:

description string O tipo de cobrança (por exemplo, VAT ou taxa de resort)
amount string Valor total da taxa


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.

ConvertedRateInfo object Informações de tarifas convertidas para a moeda solicitada pelo cliente. Retornado somente se a moeda convertida e a cobrável forem diferentes, ou seja, se o hotel não puder aceitar a moeda solicitada pelo cliente. Contém os mesmos atributos que ChargeableRateInfo.
Os valores retornados nesse objeto não podem ser reservados. A tentativa de reservar com um valor convertido resultará em erro.
RoomGroup object Confirma o conteúdo do mesmo objeto RoomGroup enviado na solicitação, que se aplica às tarifas fornecidas.