Ir al contenido

HotelRates

POST {base_url}/1.0/hotels/rates

Devuelve disponibilidad y tarifas de uno o más hoteles en un rango de fechas.

Header Valor
Authorization Bearer <access_token>
Content-Type application/json
Accept application/json
Accept-Encoding gzip
Parámetro Requerido Tipo Notas
language No string Idioma del contenido de la respuesta. Valores aceptados: en-us, es-mx. Default: en-us

Tu channel tiene un idioma por defecto (inglés, salvo que se configure otro); para pedir uno distinto, usa ?language= — ver Idiomas.

{
"checkIn": "2027-05-15",
"checkOut": "2027-05-16",
"roomCriteria": [
{
"paxes": [
{ "age": 30 }
]
}
],
"hotelIds": [100652],
"hotelRateFilter": {
"nonRefundable": false
},
"market": "MX"
}
Campo Requerido Tipo Notas
checkIn Yes string (YYYY-MM-DD) No puede ser una fecha pasada
checkOut Yes string (YYYY-MM-DD) Debe ser > checkIn
roomCriteria[] Yes array Una entrada por cada habitación solicitada
roomCriteria[].paxes[] Yes array Lista de pax — se requiere al menos un adulto (18+)
roomCriteria[].paxes[].age Yes int Menor de 17 = menor
hotelIds[] Yes array of int Máximo 50 IDs por llamada
hotelRateFilter.nonRefundable No bool Filtro de tarifas. En una muestra de Integration, true y false devolvieron las mismas 19 tarifas — 7 no reembolsables y 12 reembolsables en las dos — así que no dependas de él para reducir resultados, y comprueba cancellationPolicies en cada tarifa. Default: false
market No string Código de país ISO del catálogo de Market (p. ej. MX, IN, US, ES)

Si envías name y surname en roomCriteria[].paxes[], no esperes que BookingGet los devuelva — ver BookingGet. Para enviar los nombres de los huéspedes por habitación, usa BookingHold: ver Guest data in the hold.

{
"hotels": [
{
"id": 100652,
"name": "Ocean View Cancun Arenas",
"rooms": [
{
"id": 16370816,
"name": "Standard",
"rates": [
{
"rateKey": "RMDsX5...AAB=",
"clientCurrency": "USD",
"cancellationPolicies": [
{
"startDate": "2027-05-12T00:00:00Z",
"endDate": "2027-05-15T23:59:59Z",
"amount": 116.00,
"currency": "USD"
}
],
"reservationPolicies": [
{ "type": "MEAL_PLAN", "code": "I", "description": "All Inclusive" },
{ "type": "RESERVATION", "code": "PREPAID", "description": "Prepaid" }
],
"amount": 116.00,
"publicAmount": 135.98,
"taxes": { "total": 16.00, "details": [] },
"feesNotIncluded": { "total": 0, "details": [], "currency": "" }
}
]
}
]
}
],
"eventId": "93072334-e0f6-4abd-9c9c-02ffca872382"
}
Campo Tipo Descripción
hotels[].id int Identificador del hotel
hotels[].name string Nombre del hotel
hotels[].rooms[].id int ID del tipo de habitación
hotels[].rooms[].name string Nombre de la habitación
hotels[].rooms[].rates[].rateKey string Úsalo para CheckRates — válido 60 min
hotels[].rooms[].rates[].clientCurrency string Moneda de los precios mostrados
hotels[].rooms[].rates[].amount decimal Monto neto que paga la agencia
hotels[].rooms[].rates[].publicAmount decimal Precio de venta recomendado (incluye margen)
hotels[].rooms[].rates[].cancellationPolicies array Penalización por rango de fechas (UTC)
hotels[].rooms[].rates[].reservationPolicies array Plan de alimentos + tipo de reserva
hotels[].rooms[].rates[].taxes object Obligatorios + otros (informativo)
hotels[].rooms[].rates[].feesNotIncluded object Cargos cobrados en el check-in del hotel
eventId string ID de traza — inclúyelo al reportar incidencias

Una tarifa es efectivamente no reembolsable cuando:

cancellationPolicies[i].amount === rates.amount

La penalización iguala el precio de la tarifa → penalización del 100% → no hay ventana real de reembolso.

Código HTTP Mensaje Causa Qué hacer
429 429 Request rate limit exceeded Demasiadas peticiones en poco tiempo Reduce el ritmo de peticiones y reintenta con espera
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 en PT Contacta a PriceTravel con el request, el response y el eventId
3001 400 CheckIn can not be a past date checkIn es anterior a hoy Envía un checkIn de hoy o posterior
3002 400 CheckOut can not be earlier or equal to CheckIn checkOut es igual o anterior a checkIn Envía un checkOut posterior al checkIn
3003 400 Can’t quote more than 28 days El rango solicitado supera los 28 días Divide la estancia en peticiones de 28 días o menos
3004 400 All rooms must contain at least one adult (18+) Una habitación de roomCriteria no tiene ningún pax de 18 años o más Incluye al menos un pax de 18 años o más en cada habitación
4001 500 Invalid Channel Id on Rate Limiter Interno Contacta a PriceTravel con el request, el response y el eventId
5001 500 Miss-match of channel Id Discrepancia de channel Contacta a PriceTravel con el request, el response y el eventId
Síntoma Causa probable
hotels[] vacío pero sin error No hay disponibilidad para esas fechas/criterios
El mismo hotel devuelve tarifas un minuto y al siguiente no Fluctuación de inventario en tiempo real del proveedor
429 en cada reintento Rate limit del channel — espera y reintenta con retardo
Fees currency: "" El hotel no cobra cargos a la llegada