Ir al contenido

CheckRates

POST {base_url}/1.0/hotels/checkrates

Valida un rateKey obtenido previamente y devuelve la tarifa actual. Siempre requerido antes de 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: aquí es hotel (singular), no hotels (plural)

Sección titulada «Importante: aquí es hotel (singular), no hotels (plural)»

/hotels/rates devuelve hotels[]. /hotels/checkrates devuelve un solo objeto hotel, ya que consultaste una tarifa específica.

Te indica cómo se puede ocupar la habitación. Útil cuando la tarifa admite tanto configuraciones solo de adultos como de adultos+menores al mismo precio.

Campo Descripción
adults Número de adultos
minorsAges Edades de los menores separadas por comas
amount Monto total en la moneda del hotel (no la moneda del cliente)

Texto libre del hotel. A menudo contiene:

  • Impuestos obligatorios pagaderos en el hotel (p. ej. “$67.42 MXN por habitación por noche”)
  • Requisitos de visa / ingreso
  • Notas específicas del hotel
  • Siempre antes de BookingHold.
  • Después de obtener un rateKey de Rates, dentro de los 60 minutos.
  • El precio/disponibilidad puede haber cambiado desde Rates — usa el nuevo rateKey devuelto.
Desde Hasta Límite
rateKey de Rates Usado en CheckRates 60 minutos
rateKey de CheckRates Usado en BookingHold 20 minutos

Si superas los 60 minutos, se devuelve el error 4004.

Código HTTP Mensaje Causa Qué hacer
1002 401 agency configuration not Found Channel/agencia no provisionada Contacta a PriceTravel con el request, el response y el eventId
1003 400 Invalid agency templateId Problema de configuración de la agencia Contacta a PriceTravel con el request, el response y el eventId
4001 400 The RateKey must be valid rateKey corrupto, expirado o vacío (p. ej. {{ _.rateKey }} no sustituido) Envía el rateKey de HotelRates completo y sin modificar; si expiró, vuelve a buscar vía /hotels/rates
4002 400 More hotels than expected El rateKey contiene múltiples hoteles — inválido para CheckRates Envía un rateKey de un solo hotel
4003 400 You don’t have enough credit Crédito / saldo de línea del channel agotado Contacta a PriceTravel para revisar tu saldo de crédito
4004 400 RateKey older than 60 min El rateKey de HotelRates tiene más de 60 min Vuelve a buscar vía /hotels/rates
4005 200 No results La tarifa ya no está disponible en absoluto Vuelve a buscar vía /hotels/rates
4006 200 <provider message> (p. ej. “not allotment for the rate”) Error de disponibilidad específico del proveedor Vuelve a buscar vía /hotels/rates
5001 500 Miss-match of channel Id Discrepancia de channel Contacta a PriceTravel con el request, el response y el eventId
5007 401 Mismatch of channel id. Channel id from previous step: <X> El rateKey se generó con las credenciales de otro channel Ejecuta todo el flujo, desde HotelRates, con las mismas credenciales

Caso especial: 4006 “not allotment for the rate ”

Sección titulada «Caso especial: 4006 “not allotment for the rate ”»

El proveedor ya no tiene inventario para esa tarifa específica. El rateKey era válido al momento de la búsqueda, pero el proveedor agotó existencias entre Rates y CheckRates. Solución: vuelve a buscar vía /hotels/rates y obtén un rateKey nuevo.

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

Sección titulada «Caso especial: 4005 “Your search did not yield any results”»

Se devuelve con HTTP 200 (no es un error en términos de HTTP). La tarifa desapareció pero la API respondió correctamente. Trátalo como “agotado — vuelve a buscar”.

Si el precio difiere entre Rates y CheckRates, la nueva tarifa debe presentarse al usuario antes de continuar. El monto devuelto por CheckRates es la tarifa vinculante que entra en BookingHold.