Gestión de alquileres y reservas para Dolibarr

Booking para Dolibarr

Presentación

Booking es un módulo externo para Dolibarr dedicado a la gestión de reservas, la planificación de ocupación, los recursos, las reglas de disponibilidad y tarificación, así como a la sincronización con canales externos.

El módulo convierte Dolibarr en una herramienta central para actividades que gestionan reservas: alojamientos, habitaciones, alquileres vacacionales, espacios, equipos, servicios reservables o cualquier actividad que necesite seguimiento de fechas, capacidad y disponibilidad.

Más que una simple función del sitio web, Booking está diseñado como una capa operativa interna: conecta las reservas con clientes, productos, pedidos, planificación, estadísticas y flujos de sincronización.

Posicionamiento actual del módulo

El portal público nativo histórico ya no es el modo recomendado.

El flujo objetivo actual se basa en:

WordPress para el sitio público
WooCommerce para los pedidos online
YITH o equivalente para los campos y la lógica de reserva en el sitio
Dolibarr + Booking para la gestión interna, pedidos, reservas, planificación, reglas y seguimiento

El módulo incluye un plugin de WordPress dedicado llamado WooBook, que envía los pedidos de WooCommerce a Dolibarr.

Disponibilidad en DoliStore

El módulo se distribuye en DoliStore.

Página del editor K.S.I: Ver los módulos de K.S.I en DoliStore

Objetivos del módulo

Booking está pensado para:

centralizar las reservas en Dolibarr
vincular una reserva a un producto, un tercero y un documento comercial
visualizar la ocupación en un calendario
gestionar recursos y servicios asociados
aplicar reglas de disponibilidad y precio
sincronizar indisponibilidades mediante flujos iCal
integrar pedidos procedentes de un sitio WordPress / WooCommerce
proporcionar indicadores de actividad e informes

Compatibilidad

Dolibarr: v19 a v23
PHP: PHP 8.x
Tipo de instalación: módulo externo en htdocs/custom
Sin modificación del core de Dolibarr

Funcionalidades principales

1. Productos reservables

El módulo permite convertir productos estándar del catálogo de Dolibarr en productos reservables.

Para cada producto reservable se puede definir:

activación en Booking
capacidad
granularidad de reserva
duraciones mínimas y máximas
gestión del número de personas
recursos vinculados
servicios vinculados
tiempos de margen antes y después de la reserva
necesidad de confirmación manual
anticipo opcional
color de visualización en el calendario

Esta capa permite adaptar el módulo a muchos casos de uso: estancias por noche, franjas horarias, reserva por unidad, estancia completa, capacidad múltiple, etc.

2. Alta de reservas en back-office

El módulo ofrece una pantalla Tomar una reserva que permite a los usuarios internos crear una reserva directamente desde Dolibarr.

Una reserva puede vincularse a:

un tercero existente
un producto reservable
un periodo de llegada / salida
un número de personas
una categoría de alquiler
servicios opcionales
notas públicas o internas

Según la configuración, esta acción puede generar:

un presupuesto
o un pedido

La información de la reserva se propaga a los documentos comerciales vinculados mediante los mecanismos del módulo.

3. Lista de reservas

El módulo incluye una lista dedicada de reservas.

Esta vista permite:

filtrar reservas
consultar fechas
identificar el cliente
mostrar el documento de origen
seguir el estado
distinguir reservas internas y bloques externos
abrir archivos
ejecutar acciones de negocio según permisos

4. Calendario / planificación

El calendario es uno de los elementos centrales del módulo.

Permite:

visualizar la ocupación por periodo
filtrar por recurso
navegar por día, mes o año
mostrar reservas internas
mostrar bloques externos sincronizados
abrir fichas relacionadas
realizar acciones como cancelación según permisos

El calendario está pensado como una vista operativa de la ocupación real.

5. Gestión de recursos

El módulo gestiona recursos asignables a las reservas:

habitaciones
unidades de alojamiento
salas
equipos
equipos humanos
activos operativos

Cada recurso puede vincularse a un producto, clasificarse, tener capacidad y mostrarse con un color específico en el calendario.

6. Gestión de servicios

El módulo también gestiona servicios opcionales vinculados a las reservas.

Ejemplos:

limpieza
desayuno
servicio adicional
opción de pago
servicio complementario

Estos servicios pueden proponerse durante la gestión de la reserva e incluirse en el proceso general.

7. Tipos de personas

El módulo incluye la gestión de tipos de personas para afinar la lógica de reserva según la composición de los huéspedes.

Esto ayuda a mejorar reglas de capacidad, cálculos basados en personas y otras reglas operativas.

8. Reglas de disponibilidad y tarificación

Booking incluye un motor de reglas para adaptar el comportamiento del módulo según el contexto.

Las reglas pueden afectar a:

disponibilidad
apertura / cierre de reservas
tarificación
restricciones
categorías
recursos
servicios
tipos de personas
rangos de fechas
días de la semana
franjas horarias

El motor permite:

abrir o cerrar periodos
aplicar prioridades
fijar un precio
aumentar o disminuir un precio
definir un precio fijo por producto
gestionar comportamientos específicos como tasa turística o desayuno

9. Estadísticas

El módulo ofrece una página de estadísticas para seguir la actividad de Booking.

Los indicadores disponibles incluyen:

tasa de ocupación
noches vendidas
duración media de estancia
ocupación por producto
noches por mes
ingresos vinculados
documentos comerciales vinculados

Las estadísticas se basan en los datos de Booking y en los documentos Dolibarr relacionados.

Sincronizaciones iCal

Objetivo

El módulo puede sincronizar disponibilidad e indisponibilidad con fuentes externas en formato iCal / ICS.

Casos típicos:

importar periodos ocupados desde canales externos
exportar periodos ocupados a sistemas externos
reducir el riesgo de doble reserva
integrar bloques externos en el calendario de Dolibarr

Funciones disponibles

El módulo proporciona:

configuración de canales
importación iCal
exportación ICS
generación de secretos de exportación
webhook iCal
importación manual
lanzamiento manual de sincronizaciones
tarea cron dedicada en Dolibarr
registro de sincronización
diagnóstico de flujos
pantalla de control iCal
reparación / recreación del cron
gestión de bloques externos

Canales soportados

Según la configuración, los canales pueden incluir:

Airbnb
Booking.com
Website
Google en algunos contextos
importaciones manuales
bloqueos manuales

Control iCal

Una pantalla dedicada ayuda a supervisar el comportamiento iCal y la gestión de bloques.

Es útil para:

entender el origen de una indisponibilidad
controlar importaciones
gestionar operaciones de bloqueo / desbloqueo
revisar el historial de sincronización

Integración WordPress / WooCommerce / YITH

Principio general

El flujo recomendado es:

reserva / pedido en WordPress
tratamiento comercial en WooCommerce
datos de estancia procedentes del sitio o de un plugin de reservas como YITH
envío a Dolibarr mediante el plugin WooBook
creación o actualización de objetos en Dolibarr

Plugin WooBook incluido

El módulo incluye el plugin de WordPress:

pluginwoobook/woocommerce-dolibarr-sync.php

Este plugin permite:

configurar el endpoint de Dolibarr
configurar el secreto compartido
elegir los estados de WooCommerce a sincronizar
definir mapeos de productos Woo -> Dolibarr
definir mapeos de clientes Woo -> terceros Dolibarr
transmitir metadatos útiles para la reserva

Información enviada desde WooCommerce

El flujo puede transmitir:

id del pedido Woo
estado del pedido
cliente
correo electrónico
id del cliente Woo
líneas de pedido
producto Woo
SKU
fechas de estancia
número de personas
notas
importes
IVA
metadatos de líneas y del pedido

Compatibilidad con YITH

El plugin WooBook reconoce metadatos de reserva habituales, incluso en contextos YITH.

Esto permite al módulo procesar:

fechas de inicio
fechas de fin
información de estancia
número de personas

sin exigir una única estructura rígida del lado de WordPress.

Endpoints Dolibarr

Endpoint principal de sincronización Woo:

custom/booking/syncwoocommande/receive.php

Endpoint de prueba:

custom/booking/syncwoocommande/ping.php

Seguridad de la sincronización Woo

La comunicación entre WooCommerce y Dolibarr está protegida mediante solicitudes firmadas.

Se admiten dos modos:

WooBook
Webhook nativo de WooCommerce

El módulo verifica las firmas antes de procesar los datos.

Resultado dentro de Dolibarr

Cuando se sincroniza un pedido Woo, el módulo puede:

crear o actualizar el tercero
crear o actualizar el pedido de Dolibarr
asociar las líneas al producto correcto de Dolibarr
crear o actualizar la reserva interna de Booking
vincular la reserva al pedido
actualizar las fechas
cancelar la reserva si el pedido Woo se cancela / reembolsa / falla
liberar los bloques vinculados cuando sea necesario

Idempotencia

El flujo Woo está diseñado para evitar duplicados.

Si el mismo evento se repite:

el módulo intenta encontrar el objeto existente
actualiza en lugar de recrear
evita pedidos y reservas duplicados

Este punto es importante en entornos reales basados en webhooks.

Lógica de cancelación

El módulo distingue entre lógica de cliente y lógica interna.

La ventana de cancelación tardía configurada se aplica al lado cliente según las reglas del módulo.

Sin embargo, los usuarios internos autorizados o los administradores pueden seguir cancelando desde el back-office según permisos y flujo operativo.

Las cancelaciones también pueden propagarse desde documentos comerciales vinculados o desde la sincronización Woo según el escenario.

Menús principales

El módulo añade un menú principal Reservas con entradas como:

Cuadro de mando
Tomar una reserva
Reservas
Calendario
Recursos
Servicios
Productos reservables
Reglas
Tipos de personas
Sincronizaciones / Comparticiones
Control iCal
Configuración

Configuración

Ajustes generales

Permiten definir, por ejemplo:

comportamiento por defecto
generación de documentos
modo de disponibilidad por defecto
gestión de extrafields
sincronización de documentos Dolibarr
reglas de modificación
ventana de cancelación tardía
constantes globales del módulo

Ajustes de sincronización

Esta parte permite gestionar:

mapeos canal / producto
importaciones iCal
exportaciones ICS
secretos
tokens
diagnósticos
logs
cron
conservación de datos de configuración

Ajustes WooCommerce Sync

Existe una página dedicada para configurar la integración WooCommerce / Dolibarr.

Permite definir:

modo de autenticación
secretos de comunicación
URL base de Dolibarr
mapeos de productos Woo -> Dolibarr
mapeos de clientes Woo -> terceros Dolibarr
comportamientos específicos como la creación de línea de tasa turística
pruebas de conectividad
recordatorios de configuración del lado de WordPress

Logs, mantenimiento y diagnóstico

El módulo incluye varias herramientas operativas:

log de sincronización
prueba de conectividad Woo
prueba de importación / exportación iCal
reparación del cron iCal
limpieza de huérfanos
herramientas de control iCal
herramientas de corrección para desajustes de fechas Woo / sitio
supervisión del estado de sincronización

Casos de uso típicos

Alojamiento / alquiler vacacional

reserva en sitio WordPress
pedido WooCommerce
sincronización a Dolibarr
reserva visible en Booking
calendario de ocupación actualizado
seguimiento comercial centralizado

Reserva de espacios o salas

productos reservables por franja
recursos asignados
calendario de ocupación
reglas de apertura / cierre
documentos comerciales vinculados

Actividad multicanal

importación iCal desde plataformas externas
gestión de bloques externos
reducción del riesgo de doble reserva
visibilidad unificada en el calendario de Dolibarr

Resumen

Booking para Dolibarr es un módulo completo de gestión de reservas orientado a la operación interna.