CheckRates
Endpoint
Seção intitulada “Endpoint”POST {base_url}/1.0/hotels/checkratesValida um rateKey obtido anteriormente e retorna a tarifa atual. Sempre obrigatório antes do BookingHold.
Headers
Seção intitulada “Headers”| Header | Valor |
|---|---|
Authorization |
Bearer <access_token> |
Content-Type |
application/json |
Accept |
application/json |
Corpo da requisição
Seção intitulada “Corpo da requisição”{ "rateKey": "<rateKey from /hotels/rates>"}Resposta (sucesso)
Seção intitulada “Resposta (sucesso)”{ "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.
Campo roomOccupancies
Seção intitulada “Campo roomOccupancies”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) |
Campo remarks
Seção intitulada “Campo remarks”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
Quando chamar o CheckRates
Seção intitulada “Quando chamar o CheckRates”- 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.
Janelas de tempo
Seção intitulada “Janelas de tempo”| 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.
Erros específicos deste endpoint
Seção intitulada “Erros específicos deste endpoint”| 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”.
Mudanças de preço
Seção intitulada “Mudanças de preço”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.

