Reservas y Citas: guía completa
Instalar, configurar y gestionar la reserva de citas: configuración rápida, servicios, profesionales, agenda día/semana/mes, depósito verificado y reembolsos, horarios excepcionales, emails y recordatorios.
Presentación
El módulo Reservas y Citas (dfbooking) añade la reserva de citas en línea a PrestaShop 1.7.8, 8 y 9. El cliente elige un servicio, un profesional o «Primer disponible», y después un día y una hora. Las horas propuestas se calculan en tiempo real a partir de los horarios, la duración del servicio, la pausa, los cierres y las citas ya reservadas.
Se puede pedir un depósito: se paga mediante un pedido nativo de PrestaShop, es decir, con los medios de pago ya activos en su tienda. El equipo trabaja desde un panel y una agenda en el back office, y el cliente gestiona su cita desde un enlace privado recibido por email o desde su cuenta.
Esta documentación corresponde a la versión 2.0.0.
Novedades de la 2.0.0: panel, configuración rápida en un solo formulario, agenda día / semana / mes con el horario de apertura visible, página «Cierres y horarios», verificación del depósito en el pedido, seguimiento de los reembolsos, calendario utilizable con el teclado, resumen antes de confirmar, cancelación desde «Mis citas», límite antirrobots, emails rediseñados en 8 idiomas y compatibilidad con PrestaShop 1.7.8.
Conceptos clave
- Servicio: lo que reserva el cliente (corte, consulta, taller). Tiene una duración, una pausa, un precio por persona, un número de plazas por horario y, opcionalmente, un depósito, una categoría y una foto.
- Profesional o recurso: la persona, la cabina o la máquina que realiza el servicio. Cada uno tiene su horario semanal y, opcionalmente, una foto y un email.
- Horario: una hora reservable, generada a partir del horario semanal y del intervalo entre horas.
- Estados: Pendiente de pago, Pendiente de confirmación, Confirmada, Cancelada, Finalizada, No presentado.
- Reembolso del depósito: Reembolso pendiente, Reembolsado o Depósito retenido, para las reservas pagadas y después canceladas.
Instalación y actualización
- Abra Módulos > Gestor de módulos y haga clic en Subir un módulo.
- Suelte el archivo
dfbooking-2.0.0.zipy abra Reservas > Panel.
La instalación crea las tablas, el menú Reservas (Panel, Agenda, Reservas, Servicios, Profesionales y recursos, Cierres y horarios), un producto técnico oculto «Depósito de reserva» y la carpeta img/dfbooking/ para las fotos.
Para pasar de una versión 1.x a la 2.0.0, basta con instalar el nuevo ZIP encima: el script de actualización añade las nuevas columnas y páginas, registra el depósito ya recibido de las reservas pagadas y añade los nuevos ajustes. Sus reservas, servicios, horarios, cierres y ajustes se conservan, y los enlaces de calendario de los profesionales siguen siendo válidos.
No elimine el producto «Depósito de reserva»: lleva el importe del depósito en el carrito. No es visible en el catálogo, se retira de cualquier carrito que no sea un carrito de depósito y, al desinstalar, se desactiva (en lugar de eliminarse) si figura en pedidos.
Configuración rápida
Mientras no haya ningún servicio en línea, el panel muestra un formulario de configuración rápida. En un minuto indica:
- el profesional (nombre y función), sus días laborables, su horario de apertura y una posible pausa;
- su primer servicio: nombre, duración, precio y depósito en porcentaje (0 = reserva sin pago).
Un clic en Abrir la reserva en línea crea el profesional, su horario y el servicio, y muestra el enlace de su página de reserva para añadirlo al menú o a una página CMS. También puede configurarlo todo paso a paso desde los menús Profesionales y Servicios.

Añada ?service=ID a la URL de la página de reserva para abrir directamente un servicio, por ejemplo desde una página CMS que lo presente.
Panel
Reservas > Panel reúne lo que requiere su atención:
- las citas de hoy, con acciones en un clic (Confirmar, Finalizada, No presentado);
- las solicitudes por confirmar y los depósitos a reembolsar;
- la ocupación de los próximos 7 días (parte del horario de apertura ya reservada, cierres y horarios excepcionales incluidos);
- las próximas citas y, para el mes en curso, la facturación reservada, la parte reservada en línea, la tasa de cancelación y la tasa de no presentados.
Una barra de navegación común enlaza todas las páginas del módulo, con contadores (solicitudes por confirmar, reembolsos pendientes) y un enlace a la página de reserva.

Configuración
Los ajustes se abren desde la pestaña Ajustes de la barra de navegación (o con Configurar en el gestor de módulos).
Horarios
- Intervalo entre horas (30 min por defecto): separación entre dos horas de inicio propuestas.
- Antelación mínima (120 min por defecto): el cliente no puede reservar una hora que empiece antes.
- Plazo de reserva (60 días por defecto): profundidad del calendario.
- Confirmar las reservas automáticamente: si se desactiva, las reservas sin depósito llegan como «Pendiente de confirmación».
- Mostrar las plazas libres en las sesiones en grupo.
Formulario del cliente
- Cuenta de cliente obligatoria y teléfono obligatorio.
- Casilla de consentimiento: elija una página CMS (política de privacidad, condiciones); aparece una casilla obligatoria antes de confirmar.
- Condiciones de reserva: texto breve por idioma mostrado antes de confirmar, en la página de la cita y en los emails (cancelación, reembolso del depósito, retrasos).
- Reservas por visitante y por hora (5 por defecto): protege su agenda y su buzón de los robots. 0 = sin límite. Los clientes conectados no tienen límite y la dirección IP nunca se almacena.
Depósito, cancelación y cambios
- Reservar un horario no pagado durante (30 min por defecto): pasado este plazo sin pedido creado, la hora se libera.
- Impuestos sobre los depósitos: sin impuestos por defecto. El depósito definido en un servicio es siempre el importe pagado, IVA incluido; elija una regla de impuestos si la factura del depósito debe mostrar el IVA que contiene.
- Cancelación en línea y cambio en línea por el cliente, activables por separado.
- Cambios en línea posibles hasta X horas antes de la cita (24 por defecto).
- Reembolsar el depósito si el cliente cancela en línea: sí por defecto (la reserva aparece en «Reembolsos pendientes»); no: el depósito se conserva y se informa de ello al cliente antes de cancelar.
Notificaciones y recordatorios
- Email de notificación del equipo: recibe cada nueva reserva, cancelación y cambio (vacío = email de la tienda).
- Avisar también al profesional asignado: copia enviada al email indicado en el profesional.
- Email de recordatorio X horas antes (24 por defecto, 0 para desactivar).
- Adjuntar un archivo de calendario (.ics) a los emails de confirmación, cambio y cancelación.
- Marcar las citas pasadas como finalizadas automáticamente.
Página de reserva
- Color de acento: botones, día y hora seleccionados. Elija un color legible sobre fondo blanco.
- URL de la página:
/reservationpor defecto, modificable (por ejemplo/cita).
Enlaces y automatización
Al final de los ajustes: el enlace de la página de reserva, la URL cron, el calendario de todo el equipo, el botón Ejecutar las tareas ahora y el botón Generar nuevos enlaces de calendario (los enlaces anteriores dejan entonces de funcionar).

Servicios
En Reservas > Servicios, cada servicio incluye:
- Nombre, categoría y descripción, por idioma. Los servicios de una misma categoría se muestran juntos en la página de reserva, con filtros en cuanto hay al menos dos categorías.
- Foto (JPG, PNG o WebP, 5 MB máx.), mostrada en miniatura.
- Duración y pausa entre citas (limpieza, preparación).
- Plazas por horario: 1 para una cita individual, más para una sesión en grupo.
- Precio por persona (0 oculta el precio) y depósito: ninguno, porcentaje del precio o importe fijo por persona.
- Color usado en la agenda, y los profesionales que realizan el servicio.
Un servicio solo se ofrece en línea si tiene al menos un profesional activo asociado. La lista señala los servicios sin profesional; una lista vacía muestra una guía de inicio.
A partir de seis servicios, aparece un campo de búsqueda encima de la lista en la página de reserva.
Profesionales y horarios
En Reservas > Profesionales y recursos, indique el nombre, la función, la descripción, una foto (mostrada en un círculo), un color y, opcionalmente, un email para recibir los avisos.
Horario semanal
Para cada día, indique hasta tres franjas horarias. Use dos franjas para la pausa del mediodía. Un día sin franjas es un día libre. El botón Copiar de martes a viernes copia las franjas del lunes, y Vaciar borra un día.
Agenda personal en el móvil
Una vez guardado el profesional, su ficha muestra un enlace de calendario privado. En Google Calendar (Otros calendarios > Desde URL) o en un iPhone (Ajustes > Calendario > Cuentas > Añadir calendario suscrito), sus citas aparecen y se actualizan solas. En los ajustes hay un enlace para todo el equipo.
Este enlace da acceso al nombre y al teléfono de los clientes. Compártalo solo con la persona correspondiente. En caso de duda, genere nuevos enlaces desde los ajustes.
Sesiones en grupo
Con más de una plaza por horario, el cliente elige el número de participantes y ve las plazas libres bajo cada hora (configurable). Varias reservas pueden compartir la misma hora de inicio hasta agotar las plazas; el precio y el depósito se multiplican por el número de participantes.
Cierres y horarios excepcionales
La página Reservas > Cierres y horarios reúne:
- una vista semanal del horario de cada profesional, con el total de horas por semana (haga clic en un nombre para modificarlo);
- Cierres y días libres: un periodo sin ninguna hora, para toda la tienda o un profesional. Si ya hay citas en el periodo, un aviso lo indica: no se cancelan automáticamente;
- Horarios excepcionales: horario especial para una fecha (apertura nocturna, domingo antes de Navidad, jornada reducida), con una segunda franja opcional. Sustituye a la semana habitual solo ese día.
Prioridad para una fecha: un cierre siempre prevalece; después, el horario excepcional propio del profesional y luego el de toda la tienda; si no, la semana habitual. La noche del cambio al horario de verano, las horas que no existen nunca se proponen.

El depósito
- La reserva se crea como «Pendiente de pago» y la hora queda bloqueada.
- El módulo prepara un carrito que solo contiene el depósito y envía al cliente a su proceso de compra. El carrito que tenía se guarda aparte.
- Al validar el pedido, el módulo comprueba que el depósito completo figura en el pedido. Si falta (línea retirada del carrito, vale de descuento), la reserva queda «Pendiente de confirmación» con una alerta en su ficha y en el pedido.
- Pago inmediato (tarjeta, PayPal): la reserva pasa a Confirmada y se envían los emails.
- Pago diferido (transferencia, cheque): la hora sigue bloqueada y la reserva se confirma cuando usted pasa el pedido a un estado pagado.
- Pedido cancelado, en error o reembolsado: la cita se cancela y se avisa al cliente.
- Pago abandonado: la hora se libera tras el plazo configurado.
Tras el pedido, se restaura el carrito original del cliente. La página de confirmación del pedido, el detalle del pedido en la cuenta del cliente y la factura PDF muestran la cita (con el resto a pagar en el local).
Si un pago llega fuera de plazo cuando otro cliente ya ha tomado la hora, la reserva pasa a «Pendiente de confirmación» con una nota interna, para que usted contacte con el cliente. Todas las comparaciones de fechas usan el reloj de la tienda, aunque la base de datos esté configurada en otra zona horaria.
Reembolso del depósito
Cuando se cancela una reserva pagada (por el cliente en línea, por la tienda o junto con el pedido), pasa a Reembolso pendiente y aparece en el panel. Un reembolso parcial o una factura por abono creados en el pedido la marcan automáticamente como Reembolsado. También puede usar los botones Marcar como reembolsada o Conservar el depósito de la ficha de la reserva.
Proceso de reserva del cliente
- Servicio: lista agrupada por categoría, con filtros y búsqueda.
- Profesional: una persona concreta o «Primer disponible». Este paso se omite si un solo profesional realiza el servicio.
- Día y hora: el calendario se abre en la próxima disponibilidad; las horas se agrupan en mañana, tarde y noche.
- Datos de contacto, condiciones y consentimiento, y después el resumen «Revise su cita» (servicio, hora, profesional, total, a pagar ahora, a pagar en el local) justo antes del botón de confirmación.

El calendario es utilizable con el teclado: flechas para pasar de un día o de una semana a otra, Inicio y Fin para la semana, Re Pág / Av Pág para cambiar de mes, Intro para elegir. Los días no disponibles se anuncian como tales a los lectores de pantalla.

En ordenador, un resumen acompaña al cliente durante todo el proceso; cada paso completado se pliega con un enlace «Cambiar».

En el móvil, una barra en la parte inferior de la pantalla recuerda el servicio, la hora y el precio, con un botón «Continuar». La página funciona con los temas Classic y Hummingbird.

Gestión de la cita por el cliente
Tras reservar, el cliente llega a la página de su cita. Allí tiene el resumen, el botón para añadirla a Google Calendar y un archivo .ics para Apple Calendar y Outlook. Según sus ajustes, también puede cambiar la cita a otra hora libre (manteniendo o no al mismo profesional) o cancelarla. Se indican la fecha y la hora límite para los cambios en línea, así como lo que ocurre con el depósito en caso de cancelación.

Esta página es accesible desde el enlace de cada email, también para clientes sin cuenta. Los clientes conectados encuentran sus citas en Mi cuenta > Mis citas: próximas citas en tarjetas (estado, referencia, depósito, fecha límite), añadir al calendario, cancelación directamente desde la lista tras confirmación, e historial.

«Mis citas» solo muestra las reservas de la cuenta. Una reserva como invitado con depósito se vincula al cliente del pedido.
Agenda del back office
Reservas > Agenda ofrece tres vistas:
- la vista día, con una columna por profesional;
- la vista semana, con filtro por profesional;
- la vista mes, con las citas de cada día («+N más» a partir de tres).
La barra de color de una cita indica el servicio y su borde el estado (discontinuo mientras no esté confirmada). Las horas fuera del horario de apertura aparecen en gris (horarios excepcionales incluidos), los días cerrados aparecen rayados y una línea roja marca la hora actual.

- Clic en una hora libre (o en un día en la vista mes): abre la creación de una cita con el día, la hora y el profesional ya rellenados.
- Arrastrar y soltar una cita: la mueve conservando su duración. En la vista día, soltarla en otra columna cambia de profesional; en la vista mes, cambia de día manteniendo la hora. Una ventana de confirmación propone avisar al cliente por email. Si la hora está ocupada, o si el profesional no realiza el servicio, la agenda pide confirmación antes de forzar.
- Clic en una cita: abre su ficha; un clic en un día lo abre en la vista día.
- Teclado: flechas izquierda y derecha para navegar, T para volver a hoy.


Reservas en el back office
Lista
Reservas > Reservas lista las citas con filtros (estado, reembolso, fecha, servicio, profesional, cliente) y exportación CSV.

Crear una cita telefónica
Haga clic en Nueva reserva o en una hora libre de la agenda. Elija el servicio, el profesional (o la asignación automática), la fecha y la hora; la hora de fin se calcula según la duración del servicio. Si el email corresponde a un cliente existente, la reserva se vincula a él. Una reserva que se solape con otra se rechaza, salvo que active Guardar aunque la hora esté ocupada.
Ficha de una reserva
La ficha reúne la cita, el cliente, el pago (depósito esperado y recibido en el pedido, resto, reembolso, enlace al pedido), el mensaje del cliente y una nota interna. Las acciones rápidas son Confirmar, Marcar como finalizada, No presentado, Cancelar, Restablecer y Reenviar el email. Un cambio de estado envía el email correspondiente al cliente. Estas acciones respetan los permisos del empleado.

Detalle del pedido
Un pedido de depósito muestra un bloque «Cita vinculada» con el depósito, el posible reembolso, las alertas (depósito incompleto, depósito a reembolsar) y un enlace a la reserva.
Emails
Se incluyen seis plantillas en 8 idiomas (francés, inglés, español, alemán, italiano, neerlandés, polaco, portugués), en HTML y en texto:
- Confirmación: cita confirmada, con archivo .ics adjunto;
- Solicitud recibida: reserva pendiente de confirmación o de pago;
- Recordatorio: enviado X horas antes de la cita;
- Cancelación (con la mención del reembolso o de la retención del depósito) y Cambio;
- Aviso al equipo: nueva reserva, cancelación o cambio por el cliente. Responder a este email escribe directamente al cliente.
Cada email al cliente destaca la fecha y la hora, e incluye el resumen, el enlace privado de gestión de la cita, los enlaces de calendario y sus condiciones de reserva.

Tareas automáticas
Tres tareas se ejecutan en segundo plano: el envío de recordatorios, la liberación de las horas cuyo depósito no se pagó a tiempo y el paso de las citas pasadas a «Finalizada».
Los ajustes muestran una URL cron protegida por token. Llámela cada 15 minutos desde el cron de su servidor para recordatorios puntuales. Sin cron, las tareas se ejecutan durante las visitas a la tienda, como máximo cada 10 minutos. El botón Ejecutar las tareas ahora las lanza de inmediato.
Seguridad y fiabilidad
- La disponibilidad se vuelve a comprobar en el momento de confirmar, con un bloqueo común a todas las tiendas: dos clientes no pueden reservar la misma hora.
- El depósito realmente presente en el pedido se comprueba antes de cualquier confirmación automática.
- Tokens de seguridad en todas las acciones, enlace de gestión protegido por una clave secreta, límite de reservas por visitante.
RGPD
Con el módulo oficial psgdpr, la exportación de los datos de un cliente incluye sus reservas, y la eliminación de sus datos anonimiza sus reservas (nombre, email, teléfono, mensaje, huella antirrobots) sin alterar sus estadísticas.
Multitienda e idiomas
Servicios y profesionales tienen textos por idioma y por tienda, y las reservas pertenecen a su tienda. La interfaz del módulo, los menús, los estados y los emails están disponibles en francés, inglés, español, alemán, italiano, neerlandés, polaco y portugués.
Desinstalación
La desinstalación elimina las tablas, las reservas, la configuración, el menú y las fotos. El producto de depósito se elimina, o solo se desactiva si figura en pedidos. Los pedidos ya realizados no se modifican.
Resolución de problemas
No aparece ninguna hora
Compruebe que el profesional tiene horario ese día (página Cierres y horarios), que el servicio está asociado a él, que el día no está cerrado, y compare la antelación mínima y la duración del servicio con las franjas horarias.
Un servicio no aparece en línea
Debe estar activo y asociado a al menos un profesional activo.
Una reserva pagada sigue «Pendiente de confirmación»
Abra su ficha: o bien el pedido no contiene el depósito completo (alerta roja), o bien la hora se ha reservado mientras tanto (nota interna). Compruebe el pago y después confirme o cambie la cita.
Un visitante ya no puede reservar
Probablemente se ha alcanzado el límite de reservas por visitante y por hora. Auméntelo o ponga 0 en los ajustes.
Los recordatorios no se envían
Compruebe que el recordatorio no está en 0 y que la reserva está «Confirmada». En una tienda con pocas visitas, configure la URL cron.
La foto no se guarda
La carpeta img/dfbooking/ debe tener permisos de escritura. Compruebe también el tamaño (5 MB máx.) y el formato.
La URL de reserva devuelve un error 404
Active las URL amigables en Parámetros de la tienda > Tráfico y SEO y vacíe la caché.
Preguntas frecuentes
¿Puede el cliente reservar sin crear una cuenta?
Sí, salvo que active «Cuenta de cliente obligatoria». Gestiona su cita con el enlace recibido por email.
¿Puedo ofrecer «Primer disponible»?
Sí, automáticamente en cuanto varios profesionales realizan el servicio. El módulo asigna al profesional libre a la hora elegida.
¿Cómo se evitan las reservas dobles?
La disponibilidad se vuelve a comprobar al confirmar, con un bloqueo, y el back office rechaza los solapamientos salvo que usted los fuerce.
¿Qué ocurre si un cliente quita el depósito de su carrito?
El pedido se acepta, pero la reserva no se confirma: queda «Pendiente de confirmación» con una alerta, para que usted compruebe el pago.
¿Cómo se reembolsa un depósito?
Haga un reembolso parcial o una factura por abono en el pedido: la reserva se marca automáticamente como «Reembolsado». Los depósitos a reembolsar aparecen en el panel.
¿Es compatible con PrestaShop 9?
Sí, de PrestaShop 1.7.8 a 9.x, con los temas Classic y Hummingbird, con una o varias tiendas.