CheckRates
Endpoint
Sección titulada «Endpoint»POST {base_url}/1.0/hotels/checkratesValida un rateKey obtenido previamente y devuelve la tarifa actual. Siempre requerido antes de BookingHold.
Headers
Sección titulada «Headers»| Header | Valor |
|---|---|
Authorization |
Bearer <access_token> |
Content-Type |
application/json |
Accept |
application/json |
Cuerpo de la petición
Sección titulada «Cuerpo de la petición»{ "rateKey": "<rateKey from /hotels/rates>"}Respuesta (éxito)
Sección titulada «Respuesta (éxito)»{ "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.
Campo roomOccupancies
Sección titulada «Campo roomOccupancies»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) |
Campo remarks
Sección titulada «Campo remarks»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
Cuándo llamar a CheckRates
Sección titulada «Cuándo llamar a CheckRates»- 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.
Ventanas de tiempo
Sección titulada «Ventanas de tiempo»| 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.
Errores específicos de este endpoint
Sección titulada «Errores específicos de este endpoint»| 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”.
Cambios de precio
Sección titulada «Cambios de precio»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.

