Consulta de disponibilidad y tarifas de un hotel para una estadía, pensada para
sistemas externos que distribuyen el inventario del PMS (agencias, TMCs). Se
autentica con el API Key de integración externa (header X-Api-Key).

Parámetros

• La estadía se cobra por noches: va de start_date a la noche anterior a
  end_date (día de salida). Si no se envía end_date, se asume una noche.
• Si no se envía adults, se asume 1. Los tipos de habitación que no admiten
  esa cantidad de adultos no se incluyen.
• Todas las noches deben caer dentro de la ventana de reservas del hotel. Si alguna
  queda por fuera, responde 422 indicando el último end_date permitido.

Respuesta

• No se incluyen los tipos de habitación que no tienen habitaciones libres en
  alguna de las noches, ni los que no tienen ningún plan que las OTAs puedan
  vender para la estadía.
• availability: habitaciones de ese tipo libres durante toda la estadía, es
  decir.
• total_rates: valor de la estadía completa (suma de todas las noches) por plan
  tarifario, para la cantidad de adultos consultada y sin impuestos. No aparecen
  los planes que las OTAs no pueden vender para la estadía (las mismas
  restricciones que ellas reciben): los cerrados para la venta en alguna de las
  noches y aquellos cuya estadía mínima o máxima del día de llegada la estadía no
  cumple.
• total_taxes_percentage: porcentaje de impuestos que el hotel suma sobre
  total_rates (ej. "19.0%"). Es "0.0%" si el hotel no maneja impuestos.

Valores null

Aplican solo a estadías dentro de la ventana de reservas. Un null significa que
el PMS no tiene el dato completo para la estadía, no que el valor sea cero. En ese
caso la habitación o el plan no se puede cotizar para esas fechas:

• availability es null cuando alguna de las noches todavía no tiene la
  disponibilidad calculada. Puede pasar justo después de que el hotel amplía su
  ventana de reservas o crea un tipo de habitación, mientras el PMS termina el
  cálculo.
• El value de un plan en total_rates es null cuando alguna de las noches no
  tiene precio para ese plan y esa cantidad de adultos.