PS PrestaShop Intermedio

Alquiler de Productos — Guía completa

Instalar, configurar y explotar el alquiler de productos: calendario de reserva, panel de control, planificación en línea de tiempo por unidad, números de serie, check-in y check-out, protección contra la sobrerreserva, temporadas, tarifas planas, fianza en línea separada o huella Stripe, solicitudes sin pago, packs, API REST, feed iCal, webhooks y correos de recordatorio, para PrestaShop 1.7.8 a 9.x.

Actualizado Versión del módulo 2.0.0

Presentación

El módulo Alquiler de productos (dfproductrental) añade un modo alquiler que se activa producto a producto en su tienda PrestaShop y cubre después toda la explotación del parque. En la ficha de un producto alquilable, el cliente elige sus fechas en un calendario integrado que muestra, día a día, lo que está disponible, las unidades restantes, los días completos y los días sin entrega ni devolución posible. El precio se calcula en directo: duración, tarifa diaria aplicada, ahorro obtenido con los tramos o las tarifas planas, fianza y total. La tarificación funciona por día mediante tramos decrecientes, un porcentaje del precio de venta o coeficientes de duración, modulada por temporadas de precios y tarifas planas. La fianza vive en una línea dedicada del carrito, reembolsable con factura de abono, o pasa a una huella bancaria Stripe.

En el back office, un panel de control reúne lo que requiere su atención hoy, una planificación en línea de tiempo muestra cada reserva por unidad (número de serie), y las reservas, el check-out y el check-in, las estadísticas, las solicitudes sin pago, los packs sincronizados, la API REST, el feed iCal privado, los webhooks salientes y los correos de recordatorio completan el módulo. Las fechas quedan retenidas mientras el cliente paga y cualquier solapamiento se detecta, de modo que una unidad nunca se alquila dos veces.

Ideal para material, mobiliario, equipamiento de eventos, instrumentos, vehículos o herramientas: todo artículo que se alquila en lugar de venderse de una vez por todas. El modo alquiler solo se activa en los productos que usted designe, sin cambiar el resto de su catálogo.

DataFirefly Alquiler de productos: calendario de reserva en la ficha del producto con disponibilidad, unidades restantes y precio en directo
Calendario de reserva en la ficha del producto con disponibilidad, unidades restantes y precio en directo

Novedades de la versión 2.0.0

  • Funciona con Hummingbird, el tema por defecto de PrestaShop 9, así como con Classic y los temas personalizados.
  • Se acabó la sobrerreserva: las fechas quedan retenidas durante el proceso de compra, una reserva tomada entretanto se retira del carrito con un mensaje antes del pago, y un pedido pagado en fechas que ya no están libres se marca como conflicto (panel, pedido, planificación, correo a la tienda).
  • Carrito protegido: las cantidades de las líneas de alquiler están bloqueadas, el añadido al carrito nativo se rechaza en los productos alquilables y la línea de fianza no puede eliminarse.
  • Nuevo bloque de reserva: calendario integrado con las unidades restantes, precio en directo con el ahorro obtenido, tarifas planas en forma de botones, selector de cantidad y formulario de solicitud desplegable.
  • Nuevo back office: panel de control con acciones en un clic, planificación en línea de tiempo por unidad con días de margen, alquileres con retraso y conflictos, ajustes en seis secciones, estadísticas rediseñadas y una tarjeta Alquiler en la ficha de producto de PrestaShop.
  • Feed iCal privado de sus alquileres para Google Calendar, Outlook o Apple Calendar.
  • 8 idiomas (EN, FR, ES, DE, IT, PL, NL, PT) y 9 plantillas de correo rediseñadas en cada idioma.
  • Importes más claros: precios mostrados sin IVA o con IVA según el grupo de clientes, fianza mostrada por el importe realmente pagado o garantizado, y nuevo ajuste Añadir el IVA a las fianzas por producto.
  • Seguridad: token en cada acción del lado de la tienda, límite de solicitudes por visitante y por hora, campo antibots, bloqueo en torno a las comprobaciones de disponibilidad, webhooks en HTTPS y clave secreta de Stripe que nunca vuelve a mostrarse.
  • Compatible de PrestaShop 1.7.8 a 9.x y de PHP 7.4 a 8.5.

Compatibilidad

  • PrestaShop 1.7.8 a 9.x
  • PHP 7.4 a 8.5
  • Temas Hummingbird, Classic y personalizados
  • Monotienda y multitienda
  • 8 idiomas: EN, FR, ES, DE, IT, PL, NL, PT (interfaz, calendario y correos)
  • Sin dependencias: sin Composer, autoloader PSR-4 manual, calendario integrado localmente

Instalación y actualización

  1. En el back office, abra Módulos > Gestor de módulos.
  2. Pulse Subir un módulo y seleccione el archivo dfproductrental.zip.
  3. Una vez instalado, pulse Configurar para abrir los ajustes.

El módulo crea sus tablas, registra sus hooks y añade un menú Catálogo > Alquileres con seis páginas: Panel, Planificación, Reservas, Productos de alquiler, Unidades y Estadísticas. Una barra de navegación común a todas las páginas del módulo las enlaza con la configuración, muestra el número de solicitudes pendientes de respuesta y le avisa de los conflictos de reserva.

Actualización desde 1.x: suba el ZIP 2.0.0 encima de la versión anterior y vacíe después la caché de PrestaShop. Se conservan las reservas, las unidades, las configuraciones de productos y los ajustes. Las versiones 1.x añadían el tipo de IVA del producto a las fianzas por producto: este comportamiento se mantiene tras la actualización para que sus clientes paguen los mismos importes, y un aviso le propone desactivarlo. Una URL de webhook en http:// queda desactivada por la actualización (se exige HTTPS).

Panel de control

Catálogo > Alquileres > Panel reúne de un vistazo lo que requiere su atención:

  • Indicadores: unidades entregadas (alquileres en curso), entregas y devoluciones previstas hoy, devoluciones con retraso, ocupación en los próximos 30 días e ingresos de este mes (sin IVA, alquileres que empiezan este mes) con su evolución.
  • Listas de las entregas y devoluciones del día, de las solicitudes de reserva y de los alquileres con retraso, con acciones en un clic: Entregar, Registrar devolución, Aceptar, Rechazar.
  • Conflictos por resolver: reservas pagadas o confirmadas en fechas que ya no están disponibles, que hay que mover o asignar a otra unidad.
  • Un gráfico de ocupación de los próximos 30 días y los alquileres que empiezan en los próximos 7 días.

En una tienda nueva, unas pantallas vacías guiadas indican los primeros pasos: añadir un producto de alquiler y esperar después las primeras reservas.

DataFirefly Alquiler de productos: panel con unidades fuera, entregas y devoluciones del día, retrasos, ocupación e ingresos
Panel con unidades fuera, entregas y devoluciones del día, retrasos, ocupación e ingresos

Configuración

La página de configuración (Configurar en el Gestor de módulos, o Configuración en la navegación del módulo) se organiza en seis secciones. Las cuadrículas (temporadas, fechas de cierre, coeficientes) se comprueban línea a línea al guardar, con un mensaje que señala la línea errónea.

Reglas de reserva

  • Selección de fechas: un campo de periodo (rango), dos campos de inicio y fin, o fecha de inicio más un número de semanas.
  • Elección de las fechas: en la ficha de producto, o solo en el carrito (las fechas se eligen entonces una sola vez para todo el pedido).
  • Fechas globales del carrito y Horas de retirada y devolución.
  • Facturar el día de la devolución: sí, recuento de calendario, el día de la devolución es un día de alquiler (del 14 al 20 = 7 días); no, modelo rotación, la devolución ocurre el día siguiente al periodo facturado (del 14 al 21 = 7 días, una semana va de lunes a lunes), y ese día queda no disponible para otra entrega.
  • Horizonte del calendario (días): hasta qué fecha futura pueden reservar los clientes (365 por defecto).
  • Días de margen por defecto: días bloqueados tras cada devolución para preparar el artículo, sobrescribibles por producto.
  • Caducidad de los carritos (minutos): pasado este plazo, un carrito no pagado libera sus fechas (60 por defecto). Durante el proceso de compra, el plazo se renueva.
  • Días de cierre semanales (casillas) y Fechas de cierre, una por línea, como AAAA-MM-DD (puntual) o MM-DD (cada año, p. ej. 12-25). Un alquiler puede abarcar un día cerrado; solo la entrega y la devolución son imposibles ese día.

Tarifas

Temporadas de precios, Rejilla de coeficientes y coeficientes de fin de semana (sábado a lunes, viernes a lunes), y el modo Todo el catálogo en alquiler con su tarificación (precio del producto por día, o precio del producto × coeficiente de duración) y sus solicitudes sin pago.

Fianza

Modo de fianza (por producto, global automática con una sola fianza por pedido, o desactivada), Fianza predeterminada, Cobrar la fianza, Añadir el IVA a las fianzas por producto (no por defecto: la fianza que introduce es el importe pagado), y multiplicador, mínimo y redondeo de la fianza global.

Visualización en la página de producto

Posición del bloque de alquiler (y reposicionamiento por JavaScript para los temas que lo necesiten), ocultación del añadido al carrito nativo, y Mostrar las unidades restantes en el calendario (la mención «Quedan N»).

Solicitudes y notificaciones

Repercutir los packs en sus componentes, Expiración de las solicitudes (horas), Solicitudes por visitante y hora (límite antispam, 5 por defecto), Correos de recordatorio automáticos y su antelación, y Avisarme de los conflictos de reserva (correo a la tienda).

Integraciones

API REST, Feed de calendario (iCal), Webhooks salientes y su URL HTTPS, Fianza por huella bancaria Stripe con clave publicable, clave secreta (nunca vuelve a mostrarse: deje el campo vacío para conservarla), huella obligatoria antes de la salida y texto de consentimiento. Los tokens, la URL cron, la dirección iCal y el secreto de los webhooks se muestran en paneles bajo el formulario.

DataFirefly Alquiler de productos: ajustes del módulo por sección: reglas de reserva, días de cierre, tarifas y fianza
Ajustes del módulo por sección: reglas de reserva, días de cierre, tarifas y fianza

Configurar un producto alquilable

Vaya a Catálogo > Alquileres > Productos de alquiler y pulse Añadir: producto, activación, modo de tarificación (importes fijos, porcentaje del precio de venta o coeficiente), precio base diario, fianza, duración mínima y máxima, unidades disponibles, días de margen, solicitud sin pago y bloqueo del stock por las solicitudes. En la ficha de producto de PrestaShop, una tarjeta Alquiler resume el estado, la tarifa, las unidades, las duraciones y las próximas reservas, con enlaces a la configuración y a la planificación.

Tramos de precio decrecientes

Cada tramo se define por un día mínimo, un día máximo y un precio diario. El módulo aplica el tramo cuyo intervalo contiene la duración elegida; un día máximo a 0 significa ilimitado; sin tramo correspondiente, se aplica el precio base. Ejemplo: 39/día de 1 a 3 días, 32/día de 4 a 7 días, 26/día desde 8 días. En la ficha de producto, el ahorro respecto al precio base se muestra en el resumen del precio.

Tarifas planas

La zona Tarifas planas acepta una tarifa por línea con el formato días|precio sin IVA|etiqueta, por ejemplo 7|199|Tarifa semanal. Cuando la duración elegida coincide exactamente, este precio redondo sustituye todo el cálculo: ni tramos, ni coeficientes, ni temporadas. Las tarifas planas se ofrecen como botones encima del calendario: un clic selecciona el periodo correspondiente.

Modo porcentaje

El precio base diario, la fianza y los tramos se expresan como porcentaje del precio de venta sin IVA del producto. Un producto vendido a 1000 con una fianza de 10 exige 100 de fianza. Los importes siguen automáticamente los precios de su catálogo.

DataFirefly Alquiler de productos: configuración de un producto de alquiler: tarifa diaria, tramos decrecientes, fianza, duración y unidades
Configuración de un producto de alquiler: tarifa diaria, tramos decrecientes, fianza, duración y unidades

Uso en la tienda

Elección de fechas

El bloque de reserva se abre con un encabezado «desde X / día» y después un calendario integrado (dos meses en pantalla grande, uno en el móvil). Cada día muestra su estado: disponible, «Quedan N» cuando quedan pocas unidades, completo (tachado) o cerrado para entregas y devoluciones. Las casillas «Recogida» y «Devolución» guían la selección y una leyenda explica los colores. Los días reservados incluyen el margen de cada producto. En el modo semanas, el cliente elige una fecha de inicio y un número de semanas; la fecha de devolución y el total se calculan automáticamente.

Precio y reserva

El resumen del precio se actualiza en directo: duración, tarifa diaria aplicada, ahorro obtenido con los tramos o las tarifas planas, alquiler, fianza (reembolsada o solo garantizada) y total. Los importes se muestran sin IVA o con IVA según el grupo de clientes. Una línea de confianza recuerda al cliente que la disponibilidad es en tiempo real, que las fechas quedan retenidas durante el pago y cómo funciona la fianza. El botón de reserva añade el alquiler al carrito: el precio se inyecta mediante un precio específico ligado al carrito, el precio de catálogo permanece intacto y la fianza aparece en su propia línea.

DataFirefly Alquiler de productos: paquetes de duración fija con el formulario de solicitud de reserva
Paquetes de duración fija con el formulario de solicitud de reserva

En el móvil

El bloque se adapta a las pantallas pequeñas: calendario de un mes, zonas táctiles amplias y resumen del precio bajo el calendario. Se ha comprobado con 390 px de ancho, con etiquetas, foco visible y anuncios en directo para los lectores de pantalla.

DataFirefly Alquiler de productos: calendario de reserva y resumen del precio en el móvil
Calendario de reserva y resumen del precio en el móvil

Carrito

Cada línea de alquiler muestra sus fechas bajo el nombre del producto. Las cantidades de las líneas de alquiler están bloqueadas: cambiar una cantidad implica elegir nuevas fechas. Un resumen del alquiler recuerda durante cuánto tiempo quedan retenidas las fechas, y el editor de fechas globales del carrito (si está activo) permite al cliente cambiar el periodo de todo el pedido. Si otra persona ha tomado las fechas mientras el carrito esperaba, la línea se retira con un mensaje antes del pago.

DataFirefly Alquiler de productos: carrito con las fechas bajo cada línea de alquiler, la fianza y el cambio de fechas
Carrito con las fechas bajo cada línea de alquiler, la fianza y el cambio de fechas

Confirmación de pedido y cuenta de cliente

La confirmación de pedido y el detalle del pedido en la cuenta de cliente muestran una tabla con los periodos de alquiler, las duraciones, los importes, las fianzas y los estados. La página Mis alquileres de la cuenta de cliente presenta los alquileres en tarjetas, con su estado y, cuando hace falta, el botón Registrar mi tarjeta para la huella Stripe.

DataFirefly Alquiler de productos: fechas de alquiler, fianzas y estados en la confirmación del pedido
Fechas de alquiler, fianzas y estados en la confirmación del pedido
DataFirefly Alquiler de productos: página Mis alquileres en la cuenta del cliente
Página Mis alquileres en la cuenta del cliente

Fianza: línea dedicada o huella Stripe

Fianza cobrada

Con Cobrar la fianza activado, la fianza aparece como línea dedicada del carrito: un producto técnico Fianza de alquiler, sin IVA y oculto del catálogo, lleva el total de las fianzas del pedido. El precio de los productos alquilados solo contiene el alquiler. En la factura, la fianza es una línea aparte; su reembolso a la devolución del material se resuelve con una factura de abono sobre esa línea, desde la ficha del pedido. La línea de fianza no puede eliminarse del carrito. El importe proviene del modo elegido: fianza por producto, o fianza global automática (importe base con IVA multiplicado, con mínimo y redondeo).

Una fianza de garantía no suele estar sujeta a IVA: con Añadir el IVA a las fianzas por producto desactivado (por defecto en una instalación nueva), la fianza que introduce es exactamente el importe que paga el cliente.

Huella bancaria Stripe

Con Cobrar la fianza desactivado y Fianza por huella bancaria Stripe activado (claves pk_ y sk_ rellenadas), no se cobra nada. Tras su pedido, el cliente es invitado desde la página de confirmación a registrar su tarjeta en una página segura impulsada por Stripe Elements: ningún dato de tarjeta pasa por la tienda y no se carga ni bloquea ningún importe. El módulo comprueba que la tarjeta registrada corresponde al pedido.

En caso de daños constatados a la devolución: abra la reserva, introduzca la fianza retenida y su motivo, guarde y pulse Cobrar la retención vía Stripe. El importe se carga fuera de sesión en la divisa del pedido y el identificador del pago se conserva en la reserva. Un rechazo bancario (3-D Secure) se muestra tal cual; la retención queda entonces por cobrar de otro modo.

Huella obligatoria antes de la salida

Esta opción condiciona la entrega al registro de la tarjeta: una reserva pagada sin huella se marca como pendiente de huella (insignia y filtro en las reservas, indicador en el panel) y el botón Entregar se niega mientras la tarjeta no esté registrada. Ningún pedido pagado se anula nunca automáticamente. El cliente está acompañado en todo momento: botón Registrar mi tarjeta en la página Mis alquileres, recordatorio diario por correo con el enlace seguro (a través de la URL cron) y un enlace que puede copiar desde la ficha de reserva. El texto de consentimiento de la página de huella puede sustituirse en cada idioma.

Para un caso acordado con el cliente (B2B, club, garantía alternativa), el interruptor Autorizar la salida sin huella de la ficha de reserva exime solo a ese alquiler.

¿Por qué no una preautorización clásica? Las redes de tarjetas hacen caducar las preautorizaciones a los 7 días: imposible cubrir un alquiler más largo. El registro de tarjeta no caduca; es el modelo que usan las plataformas de alquiler. La cuenta Stripe utilizada es independiente del módulo de pago de la tienda.

Unidades y números de serie

En Catálogo > Alquileres > Unidades, cree una ficha por ejemplar físico: producto, referencia o número de serie, estado (disponible o en mantenimiento), activación y nota interna. En cuanto un producto tiene al menos una unidad, su capacidad de alquiler pasa a ser el número de unidades activas y disponibles: poner una unidad en mantenimiento la retira del stock sin tocar la configuración. Esta capacidad también se usa al aceptar solicitudes y en la API.

En cada reserva, el campo Unidades asignadas ofrece las unidades libres en el periodo (margen incluido) más las ya asignadas. Una unidad tomada por otra reserva se rechaza con un mensaje. Las referencias aparecen en la lista de reservas, la planificación, la ficha del pedido y el webhook.

Reservas, check-out y check-in

Catálogo > Alquileres > Reservas lista todas las reservas con producto, cliente, pedido, fechas, unidades asignadas, fianza y estado en color: solicitud pendiente, pendiente (carrito), confirmada, en curso, devuelta, rechazada, cancelada, además de las insignias de conflicto y de huella pendiente. Las acciones rápidas siguen el estado:

  • Entregar, en una reserva confirmada: el material se entrega al cliente, el alquiler pasa a en curso y se registra la hora.
  • Registrar devolución, en un alquiler en curso: el material se restituye, el alquiler pasa a devuelto y se registra la hora. Las fechas se liberan tras los días de margen.
  • Aceptar y Rechazar, en una solicitud.
DataFirefly Alquiler de productos: lista de reservas con estado, unidades, fianza y acciones rápidas
Lista de reservas con estado, unidades, fianza y acciones rápidas

La ficha de reserva agrupa el producto, las fechas, la cantidad, el estado y las unidades asignadas, el estado del material a la salida y a la devolución, y la fianza retenida con su motivo, lista para el cobro Stripe o una factura de abono parcial. Al guardar, se comprueban las fechas y el estado, y un periodo que supera la capacidad se marca como conflicto.

DataFirefly Alquiler de productos: ficha de reserva con unidades, estado del material y retención de fianza
Ficha de reserva con unidades, estado del material y retención de fianza

Planificación

Catálogo > Alquileres > Planificación muestra una línea de tiempo: una fila por producto con la carga de cada día (verde, y roja cuando está completo), y una fila por unidad (número de serie) con las barras de reserva coloreadas según su estado: confirmada, en curso, solicitud, carrito, con retraso o conflicto. Los días de margen aparecen rayados y los alquileres con retraso se prolongan hasta hoy. Cambie entre las vistas 2 semanas, Mes y 3 meses, filtre por producto, muestre u oculte las solicitudes y los carritos, y haga clic en una barra para abrir la reserva. Los días de cierre y el día actual están marcados. Los enlaces de la versión 1.x siguen funcionando.

DataFirefly Alquiler de productos: planificación mensual por producto y por unidad con reservas, días de margen y conflictos
Planificación mensual por producto y por unidad con reservas, días de margen y conflictos
DataFirefly Alquiler de productos: planificación de dos semanas con unidades numeradas y alquileres con retraso
Planificación de dos semanas con unidades numeradas y alquileres con retraso

Protección contra la sobrerreserva y conflictos

La disponibilidad se comprueba bajo un bloqueo de base de datos, de modo que dos clientes no pueden tomar la última unidad al mismo tiempo. Mientras el cliente recorre el carrito y el proceso de compra, cada reserva se vuelve a comprobar y su retención se renueva. Si sus fechas se han tomado entretanto (por ejemplo tras la caducidad del carrito), la línea se retira con un mensaje antes del pago.

Si un pedido se paga aun así en fechas que ya no están disponibles, la reserva se conserva (el pedido existe) pero se marca como conflicto: aviso en la navegación del módulo, lista en el panel, barra roja en la planificación, mención en la ficha del pedido y, si está activado, un correo a la tienda. Mueva una de las reservas o asigne otra unidad para resolverlo.

Estadísticas

Catálogo > Alquileres > Estadísticas analiza el periodo que elija (últimos 12 meses por defecto): indicadores y después, por producto, el número de reservas, los días alquilados multiplicados por la cantidad y acotados al periodo, la capacidad, la tasa de ocupación con una barra, los ingresos de alquiler sin IVA imputados al inicio del alquiler y las fianzas retenidas, con una fila de totales. Estados considerados: confirmada, en curso, devuelta.

DataFirefly Alquiler de productos: estadísticas por producto: reservas, días alquilados, tasa de ocupación e ingresos
Estadísticas por producto: reservas, días alquilados, tasa de ocupación e ingresos

Ficha de pedido en el back office

En la ficha de pedido de PrestaShop, un único bloque Alquiler muestra cada producto alquilado con su periodo, duración, unidades, importes, fianza y estado (traducido y en color), con enlaces a las reservas. La misma información aparece en la factura.

DataFirefly Alquiler de productos: periodos de alquiler, fianzas y estados en el pedido del back office
Periodos de alquiler, fianzas y estados en el pedido del back office

Temporadas de precios

La cuadrícula de temporadas acepta una temporada por línea: inicio|fin|multiplicador|etiqueta. Dos formatos de límites: fechas completas 2026-06-15|2026-09-15|1.3|Temporada alta (temporada puntual) o mes-día 12-20|01-05|1.5|Fiestas (cada año, cambio de año gestionado). Cada día de alquiler se factura a la tarifa diaria multiplicada por el coeficiente de su temporada; fuera de temporada el coeficiente es 1; si las temporadas se solapan, gana la última línea. Las tarifas planas ignoran las temporadas: ese es el sentido de un precio redondo.

Correos y recordatorios (cron)

El módulo incluye 9 plantillas de correo en los 8 idiomas, con encabezado, insignia de estado, tabla resumen y botón de acción: solicitud recibida, solicitud aceptada o rechazada, nueva solicitud para la tienda, recordatorio antes del inicio, recordatorio antes de la devolución, aviso de retraso, recordatorio de huella bancaria y conflicto de reserva. Los asuntos, las fechas y los importes siguen el idioma del destinatario.

Los recordatorios se envían mediante la URL cron protegida por token que se muestra bajo el formulario de configuración: active Correos de recordatorio automáticos, fije la antelación (1 = la víspera) y llame a la URL una vez al día (tarea cron del alojamiento o servicio externo). Cada correo se envía una sola vez por reserva. La llamada cron purga también las solicitudes caducadas.

DataFirefly Alquiler de productos: correo de reserva confirmada enviado al cliente
Correo de reserva confirmada enviado al cliente
DataFirefly Alquiler de productos: correo de recordatorio antes del inicio del alquiler
Correo de recordatorio antes del inicio del alquiler

Solicitud de reserva sin pago

En los productos con la opción activada, el bloque de reserva ofrece un formulario de solicitud desplegable: el cliente elige sus fechas, deja sus datos de contacto (rellenados automáticamente si ha iniciado sesión) y un mensaje, sin pasar por caja. La tienda recibe un correo y la solicitud aparece en las reservas y en el panel con el estado Solicitud pendiente: Aceptar vuelve a comprobar la disponibilidad, confirma y notifica al cliente; Rechazar libera las fechas y notifica al cliente. El bloqueo del stock por las solicitudes se ajusta por producto, un plazo de caducidad puede anular las solicitudes sin respuesta, y las solicitudes están limitadas por visitante y por hora contra el spam.

DataFirefly Alquiler de productos: correo a la tienda por una nueva solicitud de reserva
Correo a la tienda por una nueva solicitud de reserva

Packs de productos

Los packs nativos de PrestaShop están sincronizados: reservar un pack bloquea la disponibilidad de cada uno de sus componentes alquilables en el mismo periodo (cantidades del pack incluidas), reservar un componente solo hace el pack no disponible, y cualquier cambio en la reserva del pack se propaga a sus componentes. Las reservas de componentes están ocultas en la tienda y visibles en el back office con una insignia Pack. Un ajuste desactiva el mecanismo.

API REST

Active la API en la sección Integraciones: dos tokens regenerables (lectura y escritura, y solo lectura), pasados mediante X-Api-Key o Authorization: Bearer.

  • GET ping: autenticación y versión.
  • GET products: productos alquilables y su configuración.
  • GET availability: disponibilidad día a día, unidades restantes y margen incluidos.
  • GET bookings: reservas, filtrables por status, id_product, from, to, updated_since, external_reference.
  • POST bookings: creación, idempotente mediante external_reference; un periodo que supera la capacidad devuelve 409.
  • POST bookings&id=N: modificación; DELETE bookings&id=N: cancelación.

Feed de calendario (iCal)

Active Feed de calendario (iCal) en la sección Integraciones: una dirección privada, mostrada en el panel bajo el formulario, publica sus alquileres confirmados y en curso y las solicitudes pendientes. Suscríbase a ella desde Google Calendar, Outlook o Apple Calendar para ver las entregas y devoluciones en su calendario habitual. La dirección puede regenerarse en cualquier momento; la anterior deja entonces de funcionar.

Webhooks salientes

Active los webhooks e indique la URL HTTPS de su software: en cada evento recibe un POST JSON con la reserva completa (fechas, cantidad, precio, estado, cliente, unidades asignadas, horas de check-out y check-in, retención). Dos cabeceras acompañan cada llamada: X-DfRental-Event (nombre del evento) y X-DfRental-Signature (HMAC-SHA256 del cuerpo con el secreto mostrado en el panel dedicado, regenerable). Eventos: booking.requested, booking.confirmed, booking.declined, booking.cancelled, booking.active, booking.returned, más booking.created y booking.updated para la API. El envío se hace en la medida de lo posible con un tiempo de espera corto: un receptor caído nunca bloquea la tienda.

Webhooks y API se complementan: los webhooks notifican a su software en tiempo real, y la API con updated_since permite ponerse al día tras una caída del receptor.

Preguntas frecuentes y resolución de problemas

¿El precio de alquiler modifica el precio de mi producto?

No. El precio se inyecta mediante un precio específico ligado al carrito en curso, y la fianza vive en su propia línea. El precio de catálogo no cambia.

¿Pueden dos clientes reservar la última unidad al mismo tiempo?

No. La disponibilidad se comprueba bajo un bloqueo, las fechas quedan retenidas durante el proceso de compra y se vuelven a comprobar antes del pago. Si aun así se paga un pedido en fechas que ya no están libres (por ejemplo tras un pago muy largo), la reserva se marca como conflicto en el panel y en la planificación, y usted recibe un aviso por correo.

El calendario no aparece en la ficha de producto

Compruebe que el producto está configurado y activo en Productos de alquiler. Vacíe después la caché de PrestaShop (Parámetros avanzados > Rendimiento). Si su tema desplaza la zona de compra, active Reposicionar el bloque con JavaScript o elija otra posición del bloque en la sección Visualización en la página de producto.

El cliente no puede cambiar la cantidad en el carrito

Es lo previsto: la cantidad de una línea de alquiler es la cantidad reservada para esas fechas. Para alquilar más unidades, el cliente elige la cantidad en el bloque de reserva, que comprueba la disponibilidad.

¿La fianza está sujeta a IVA?

Por defecto no: la fianza que introduce es el importe pagado. Tras una actualización desde 1.x, el IVA se sigue añadiendo para conservar los mismos importes; desactive Añadir el IVA a las fianzas por producto en la sección Fianza si no lo desea.

El modo semanas devuelve el domingo, quiero de lunes a lunes

Desactive Facturar el día de la devolución: una semana va entonces de lunes a lunes, con 7 días facturados y la devolución el día siguiente al periodo facturado. Ese día queda no disponible para otra entrega.

El cliente no ha registrado su huella Stripe

El enlace se propone en la página de confirmación del pedido y un botón Registrar mi tarjeta aparece en la página Mis alquileres. Con la opción Huella obligatoria antes de la salida, el cliente recibe un recordatorio diario por correo y el botón Entregar permanece bloqueado. El enlace también puede copiarse desde la ficha de reserva.

El cobro Stripe es rechazado

El banco del cliente puede rechazar un cargo fuera de sesión (3-D Secure). El mensaje de Stripe se muestra tal cual en el back office. La retención queda entonces por cobrar por otro canal; la reserva conserva el importe y el motivo.

La capacidad de mi producto ya no sigue la cantidad configurada

Es el comportamiento esperado en cuanto existe una unidad para ese producto: la capacidad pasa a ser el número de unidades activas y disponibles. Elimine las unidades para volver a la cantidad configurada.

¿Una solicitud aceptada crea un pedido?

No. La aceptación confirma la reserva y bloquea las fechas, sin crear un pedido de PrestaShop. Usted cobra por el canal de su elección y sigue el alquiler desde las reservas.

Los correos de recordatorio no salen

Compruebe que el interruptor de los correos de recordatorio está activado y que la URL cron se llama a diario: responde en JSON con el número de correos enviados. Cada correo se envía una sola vez por reserva, y solo para reservas vinculadas a un pedido.

Mi webhook ya no recibe nada tras la actualización

La versión 2.0.0 exige una URL HTTPS. Una dirección http:// queda desactivada por la actualización: introduzca una dirección HTTPS y vuelva a activar los webhooks.

La API devuelve 401

Compruebe que la API está activada y que el token enviado coincide con el mostrado. Tras una regeneración, actualice sus integraciones. El token de solo lectura solo se acepta en los endpoints GET (403 en caso contrario).

¿Qué versiones de PrestaShop son compatibles?

PrestaShop 1.7.8 a 9.x, con PHP 7.4 a 8.5, en monotienda y multitienda, con los temas Hummingbird y Classic y los temas personalizados.

¿Te ha resultado útil esta página?

¿Sigues atascado? Contacta con soporte