Pular para o conteúdo

CheckRates

POST {base_url}/1.0/hotels/checkrates

Valida um rateKey obtido anteriormente e retorna a tarifa atual. Sempre obrigatório antes do BookingHold.

Header Valor
Authorization Bearer <access_token>
Content-Type application/json
Accept application/json
{
"rateKey": "<rateKey from /hotels/rates>"
}
{
"hotel": {
"rooms": [
{
"id": 5438585,
"name": "Standard",
"rates": [
{
"rateKey": "<NEW rateKey, valid 20 min>",
"clientCurrency": "USD",
"cancellationPolicies": [...],
"reservationPolicies": [...],
"amount": 116.00,
"publicAmount": 135.98,
"taxes": {...},
"feesNotIncluded": {...},
"roomOccupancies": [
{ "adults": 2, "amount": 740.29 },
{ "adults": 1, "minorsAges": "6,6", "amount": 740.29 }
]
}
]
}
],
"id": 100652,
"name": "Ocean View Cancun Arenas",
"remarks": "Hotel notes, mandatory taxes payable at hotel, etc."
},
"eventId": "30456e90-4525-4d3f-a2b4-aca715da3bcf"
}

Importante: aqui é hotel (singular), não hotels (plural)

Seção intitulada “Importante: aqui é hotel (singular), não hotels (plural)”

/hotels/rates retorna hotels[]. /hotels/checkrates retorna um único objeto hotel, já que você consultou uma tarifa específica.

Indica como o quarto pode ser ocupado. Útil quando a tarifa admite tanto configurações só de adultos quanto de adultos+crianças pelo mesmo preço.

Campo Descrição
adults Número de adultos
minorsAges Idades dos menores separadas por vírgulas
amount Valor total na moeda do hotel (não na moeda do cliente)

Texto livre do hotel. Frequentemente contém:

  • Impostos obrigatórios pagáveis no hotel (p. ex. “$67.42 MXN por quarto por noite”)
  • Requisitos de visto / entrada
  • Notas específicas do hotel
  • Sempre antes do BookingHold.
  • Após obter um rateKey de Rates, dentro de 60 minutos.
  • O preço/disponibilidade pode ter mudado desde o Rates — use o novo rateKey retornado.
De Até Limite
rateKey de Rates Usado no CheckRates 60 minutos
rateKey de CheckRates Usado no BookingHold 20 minutos

Se você exceder 60 minutos, o erro 4004 é retornado.

Código HTTP Mensagem Causa O que fazer
1002 401 agency configuration not Found Channel/agência não provisionada Contate a PriceTravel com a requisição, a resposta e o eventId
1003 400 Invalid agency templateId Problema de configuração da agência Contate a PriceTravel com a requisição, a resposta e o eventId
4001 400 The RateKey must be valid rateKey corrompido, expirado ou vazio (p. ex. {{ _.rateKey }} não substituído) Envie o rateKey do HotelRates completo e sem alterações; se expirou, busque novamente via /hotels/rates
4002 400 More hotels than expected O rateKey contém vários hotéis — inválido para o CheckRates Envie um rateKey de um único hotel
4003 400 You don’t have enough credit Crédito / saldo de linha do channel esgotado Contate a PriceTravel para revisar seu saldo de crédito
4004 400 RateKey older than 60 min O rateKey do HotelRates tem mais de 60 min Busque novamente via /hotels/rates
4005 200 No results A tarifa não está mais disponível de forma alguma Busque novamente via /hotels/rates
4006 200 <provider message> (p. ex. “not allotment for the rate”) Erro de disponibilidade específico do fornecedor Busque novamente via /hotels/rates
5001 500 Miss-match of channel Id Divergência de channel Contate a PriceTravel com a requisição, a resposta e o eventId
5007 401 Mismatch of channel id. Channel id from previous step: <X> O rateKey foi gerado com as credenciais de outro channel Execute todo o fluxo, a partir do HotelRates, com as mesmas credenciais

Caso especial: 4006 “not allotment for the rate ”

Seção intitulada “Caso especial: 4006 “not allotment for the rate ””

O fornecedor não tem mais inventário para aquela tarifa específica. O rateKey era válido no momento da busca, mas o fornecedor esgotou o estoque entre o Rates e o CheckRates. Solução: busque novamente via /hotels/rates e obtenha um rateKey novo.

Caso especial: 4005 “Your search did not yield any results”

Seção intitulada “Caso especial: 4005 “Your search did not yield any results””

Retornado com HTTP 200 (não é um erro em termos de HTTP). A tarifa sumiu, mas a API respondeu com sucesso. Trate como “esgotado — busque novamente”.

Se o preço diferir entre o Rates e o CheckRates, a nova tarifa deve ser apresentada ao usuário antes de continuar. O valor retornado pelo CheckRates é a tarifa vinculante que entra no BookingHold.