Alquiler y disponibilidad

Consulta qué unidades quedan libres antes de vender un alquiler por fechas.

3 endpoints GET · 3 Solo lectura

Para negocios que alquilan por períodos (bicicletas, material, vehículos): saber qué queda libre entre dos fechas antes de cerrar la venta.

La disponibilidad se calcula descontando de tu stock las líneas de albarán y de factura directa que ocupan esas fechas — las que llevan startDate y endDate. Usa numDisponibilidad… para la ficha de un producto, consultarDisponibilidadArticulos para un listado con varias referencias y sus variaciones, y consultarReservasArticulos cuando necesitas ver reserva a reserva quién ocupa cada día.

Flujo típico

Un recorrido habitual por esta área, de principio a fin.

/api/v1/rentals/availability Miras qué queda libre en el rango
/api/v1/delivery-notes Cierras el alquiler con sus fechas

Endpoints del área 3

GET /api/v1/rentals/availability/summary

Disponibilidad de un artículo

Devuelve las unidades disponibles de un artículo de alquiler (o de una de sus variaciones), en un rango de fechas o en general.

GET /api/v1/rentals/availability

Disponibilidad por variaciones

Devuelve, para uno o varios artículos, la disponibilidad de cada variación en un rango de fechas: stock, unidades reservadas y unidades libres.

GET /api/v1/rentals/bookings

Reservas por variaciones

Devuelve las variaciones con stock de los artículos indicados y el detalle de cada reserva que ocupa el rango de fechas.

Antes de empezar

Todos estos endpoints comparten el mismo formato de llamada, autenticación por API key y envelope de respuesta: los tienes en Primeros pasos.