Dolibarr ERP CRM Wiki

Gestión de alquileres y reservas para Dolibarr: Difference between revisions

Page

Gestión de alquileres y reservas para Dolibarr (view source)

Revision as of 11:45, 3 May 2026

2,536 bytes added ,  6 months ago
m
no edit summary
VisualWikitext
(Created page with "= 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'...")
Tag: 2017 source edit
 
mNo edit summary
Tag: 2017 source edit
Line 1: Line 1:
= Booking para Dolibarr =
[[Category:Complementary modules]]
[[Category:K.S.I]]
[[Category:Booking]]
[[Category:Reservation]]


== Presentación ==
{{TemplateDocDev}}
{{TemplateDocUtil}}


'''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'''.
<div style="border:1px solid #d7e3f4; border-radius:14px; padding:22px; margin:12px 0 22px 0; background:linear-gradient(135deg,#f6faff,#ffffff); box-shadow:0 2px 10px rgba(20,60,110,0.08);">
  <div style="font-size:28px; font-weight:700; color:#17365d; margin-bottom:8px;">Booking para Dolibarr</div>
  <div style="font-size:18px; color:#345; margin-bottom:14px;">Gestión de reservas y alquileres para alojamientos, salas, equipos, actividades, espacios y servicios planificables</div>
  <div style="display:flex; flex-wrap:wrap; gap:8px; margin-top:10px;">
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Reservas</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Planificación</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Recursos</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">iCal / ICS</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Alojamientos</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Salas y espacios</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Material</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">WooCommerce</span>
  </div>
</div>


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.
== Presentación ==


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.
'''Booking''' es un módulo externo para '''Dolibarr ERP/CRM''' dedicado a reservas, alquileres, recursos, disponibilidades y sincronizaciones con canales externos.


== Posicionamiento actual del módulo ==
Permite usar Dolibarr como centro de gestión interno para actividades con reserva en el tiempo: alojamientos, alquileres vacacionales, salas de reunión, equipos profesionales, espacios compartidos, servicios reservables y actividades por franjas horarias.


El '''portal público nativo histórico ya no es el modo recomendado'''.
El módulo añade una capa de negocio en Dolibarr: productos reservables, recursos, servicios opcionales, reglas de disponibilidad y precio, planning, documentos comerciales, sincronización iCal y conexión WordPress / WooCommerce mediante WooBook.


El flujo objetivo actual se basa en:
== Editor y soporte ==


* '''WordPress''' para el sitio público
{| class="wikitable" style="width:100%; border-collapse:collapse;"
* '''WooCommerce''' para los pedidos online
! style="width:24%; background:#f0f6ff;" | Elemento
* '''YITH''' o equivalente para los campos y la lógica de reserva en el sitio
! style="background:#f0f6ff;" | Información
* '''Dolibarr + Booking''' para la gestión interna, pedidos, reservas, planificación, reglas y seguimiento
|-
| '''Editor'''
| '''KSIDol'''
|-
| '''Especialidad'''
| Integrador Dolibarr
|-
| '''Servicios'''
| Desarrollo a medida, hosting SaaS, acompañamiento Dolibarr
|-
| '''Sitio web'''
| https://www.ksidol.io
|-
| '''Soporte'''
| support@ksidol.io
|-
| '''Módulos Dolistore'''
| https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search=
|}


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


== Disponibilidad en DoliStore ==
{| class="wikitable" style="width:100%;"
! style="width:24%; background:#f7f7f7;" | Información
! style="background:#f7f7f7;" | Detalle
|-
| '''Nombre del módulo'''
| Booking
|-
| '''Uso principal'''
| Gestión de reservas, alquileres, disponibilidades, recursos y sincronizaciones
|-
| '''Tipo'''
| Módulo externo Dolibarr
|-
| '''Compatibilidad Dolibarr'''
| Dolibarr v19 a v23
|-
| '''Compatibilidad PHP'''
| PHP 8.x
|-
| '''Modificación del núcleo Dolibarr'''
| No
|-
| '''Idiomas disponibles'''
| Francés, Inglés, Italiano, Alemán, Español
|}


El módulo se distribuye en DoliStore.
== Idiomas disponibles ==


Página del editor K.S.I:
{| class="wikitable" style="width:100%; text-align:center;"
[https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search= Ver los módulos de K.S.I en DoliStore]
! style="background:#f0f6ff;" | Bandera
! style="background:#f0f6ff;" | Idioma
! style="background:#f0f6ff;" | Código
! style="background:#f0f6ff;" | Disponibilidad
|-
| ???????? || Francés || FR || Sí
|-
| ???????? || Inglés || EN || Sí
|-
| ???????? || Italiano || IT || Sí
|-
| ???????? || Alemán || DE || Sí
|-
| ???????? || Español || ES || Sí
|}


== Objetivos del módulo ==
== Objetivos del módulo ==


Booking está pensado para:
Booking centraliza en Dolibarr la gestión operativa de reservas. Permite marcar productos como reservables, asociar recursos y servicios, gestionar fechas y capacidades, crear reservas desde el back-office, generar documentos comerciales, seguir la ocupación, sincronizar flujos iCal / ICS, recibir pedidos WooCommerce y reducir duplicados.
 
* 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 ==
== Posicionamiento recomendado ==


* '''Dolibarr''': v19 a v23
=== Uso back-office Dolibarr ===
* '''PHP''': PHP 8.x
* '''Tipo de instalación''': módulo externo en <code>htdocs/custom</code>
* '''Sin modificación del core de Dolibarr'''


== Funcionalidades principales ==
Los usuarios crean y siguen reservas directamente en Dolibarr. Es adecuado para equipos administrativos, agencias, gestores de alojamientos, asociaciones, empresas de alquiler y organizaciones que desean controlar disponibilidad desde su ERP.


=== 1. Productos reservables ===
=== Uso con WordPress / WooCommerce ===


El módulo permite convertir productos estándar del catálogo de Dolibarr en '''productos reservables'''.
WooCommerce recoge pedido e información de reserva, WooBook envía datos útiles a Dolibarr, Booking crea o actualiza la reserva interna y Dolibarr sigue siendo la referencia para gestión, seguimiento comercial y planning.


Para cada producto reservable se puede definir:
== ¿Para qué sectores? ==


* activación en Booking
Booking está dirigido a estructuras que venden, alquilan u organizan prestaciones con fecha, duración, capacidad o disponibilidad.
* capacidad
<div style="border:1px solid #d7e3f4; border-radius:12px; padding:16px; margin:14px 0; background:#f8fbff;">
* granularidad de reserva
'''Casas rurales, B&B, hoteles y alquileres vacacionales'''<br />
* duraciones mínimas y máximas
Centralice estancias, noches, calendarios de ocupación, opciones y documentos comerciales directamente desde Dolibarr.
* gestión del número de personas
</div>
* recursos vinculados
<div style="border:1px solid #d7e3f4; border-radius:12px; padding:16px; margin:14px 0; background:#f8fbff;">
* servicios vinculados
'''Concierges y gestores de propiedades'''<br />
* tiempos de margen antes y después de la reserva
Siga varios alojamientos, propietarios, periodos bloqueados, plataformas externas y reservas multicanal en una sola herramienta.
* necesidad de confirmación manual
</div>
* anticipo opcional
<div style="border:1px solid #d7e3f4; border-radius:12px; padding:16px; margin:14px 0; background:#f8fbff;">
* color de visualización en el calendario
'''Salones de recepción, seminarios y eventos'''<br />
Gestione franjas horarias, capacidades, servicios adicionales, presupuestos, pedidos y planning de ocupación de espacios.
</div>
<div style="border:1px solid #d7e3f4; border-radius:12px; padding:16px; margin:14px 0; background:#f8fbff;">
'''Asociaciones, administraciones locales y entidades culturales'''<br />
Organice reservas de salas, equipos, talleres, actividades, inscripciones o prestaciones planificadas.
</div>
<div style="border:1px solid #d7e3f4; border-radius:12px; padding:16px; margin:14px 0; background:#f8fbff;">
'''Empresas de alquiler de material y equipos profesionales'''<br />
Planifique disponibilidades de máquinas, herramientas, sonido, mobiliario, equipos técnicos o recursos internos.
</div>
<div style="border:1px solid #d7e3f4; border-radius:12px; padding:16px; margin:14px 0; background:#f8fbff;">
'''Coworking, oficinas compartidas y talleres'''<br />
Reserve oficinas, puestos, salas de reuniones, talleres o espacios compartidos con una visión clara de la ocupación.
</div>
<div style="border:1px solid #d7e3f4; border-radius:12px; padding:16px; margin:14px 0; background:#f8fbff;">
'''Turismo, ocio y actividades por franjas horarias'''<br />
Estructure reservas de actividades, visitas, cursos, salidas, servicios horarios u ofertas con número de participantes.
</div>
<div style="border:1px solid #d7e3f4; border-radius:12px; padding:16px; margin:14px 0; background:#f8fbff;">
'''Empresas de servicios con recursos planificables'''<br />
Asigne recursos, equipos, opciones y periodos a prestaciones vendidas como reserva o alquiler.
</div>


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.
== Títulos cortos para presentación ==


=== 2. Alta de reservas en back-office ===
* '''Booking Dolibarr para alojamientos y alquileres vacacionales'''
* '''Reserva de salas, espacios y eventos en Dolibarr'''
* '''Planning de alquiler de material directamente en Dolibarr'''
* '''Gestión de disponibilidades, recursos y reservas de clientes'''
* '''Dolibarr conectado a WooCommerce para reservas'''
* '''Sincronización iCal para limitar dobles reservas'''
* '''Un módulo de negocio para alquilar, planificar y facturar'''
* '''Reservas multicanal centralizadas en Dolibarr'''


El módulo ofrece una pantalla '''Tomar una reserva''' que permite a los usuarios internos crear una reserva directamente desde Dolibarr.
== Funcionalidades principales ==
 
<div style="border:1px solid #e2e8f0; border-radius:12px; padding:16px; margin:14px 0; background:#ffffff;">
Una reserva puede vincularse a:
'''Productos reservables'''<br />
 
Los productos Dolibarr pueden activarse como reservables con duraciones, capacidades, personas, recursos, servicios, reglas de disponibilidad y reglas tarifarias.
* un tercero existente
</div>
* un producto reservable
<div style="border:1px solid #e2e8f0; border-radius:12px; padding:16px; margin:14px 0; background:#ffffff;">
* un periodo de llegada / salida
'''Toma de reserva'''<br />
* un número de personas
Un asistente ayuda a seleccionar cliente, producto, fechas, número de personas y opciones. Según la configuración, la reserva puede alimentar un presupuesto, pedido u otro documento comercial.
* una categoría de alquiler
</div>
* servicios opcionales
<div style="border:1px solid #e2e8f0; border-radius:12px; padding:16px; margin:14px 0; background:#ffffff;">
* notas públicas o internas
'''Planning y calendario'''<br />
 
El planning muestra ocupación, reservas internas, indisponibilidades importadas, bloqueos externos e información operativa por periodo, recurso o producto.
Según la configuración, esta acción puede generar:
</div>
 
<div style="border:1px solid #e2e8f0; border-radius:12px; padding:16px; margin:14px 0; background:#ffffff;">
* un '''presupuesto'''
'''Recursos y servicios opcionales'''<br />
* o un '''pedido'''
Los recursos representan habitaciones, alojamientos, vehículos, material, equipos o espacios. Los servicios opcionales pueden incluir limpieza, desayuno, opciones de pago o prestaciones adicionales.
 
</div>
La información de la reserva se propaga a los documentos comerciales vinculados mediante los mecanismos del módulo.
<div style="border:1px solid #e2e8f0; border-radius:12px; padding:16px; margin:14px 0; background:#ffffff;">
'''Reglas de disponibilidad y precio'''<br />
Las reglas gestionan periodos abiertos o cerrados, restricciones, precios fijos, variaciones tarifarias y criterios por producto, periodo, día, franja, categoría o número de personas.
</div>
<div style="border:1px solid #e2e8f0; border-radius:12px; padding:16px; margin:14px 0; background:#ffffff;">
'''Estadísticas'''<br />
Una página dedicada sigue número de reservas, tasa de ocupación, noches, duración media, ocupación por producto, ingresos y documentos vinculados.
</div>


=== 3. Lista de reservas ===
== Sincronización iCal / ICS ==


El módulo incluye una lista dedicada de reservas.
El módulo incluye una capa iCal / ICS para limitar dobles reservas y centralizar indisponibilidades. Puede importar periodos ocupados, exportar disponibilidad o indisponibilidad, mapear productos Dolibarr con canales externos, supervisar estados, registrar errores y conflictos, gestionar bloqueos externos y ejecutar sincronizaciones manuales o automáticas.
 
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 ==
== Integración WordPress / WooCommerce / YITH ==


=== Principio general ===
Booking puede funcionar con WordPress / WooCommerce mediante el plugin WooBook. El sitio público recoge pedido y datos de reserva, WooCommerce prepara datos comerciales, WooBook envía cliente, líneas, productos e información de estancia a Dolibarr y Booking crea o actualiza la reserva interna.


El flujo recomendado es:
== Lógica de cancelación ==


# reserva / pedido en WordPress
Las cancelaciones pueden gestionarse desde el contexto cliente o desde back-office según permisos y parámetros. Pueden liberar periodos bloqueados, actualizar documentos vinculados y propagar cambios a WooCommerce si está configurado.
# 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 ===
== Menús principales ==


El módulo incluye el plugin de WordPress:
* Panel de control;
* Tomar una reserva;
* Reservas;
* Calendario / planning;
* Recursos;
* Servicios;
* Productos reservables;
* Reglas;
* Tipos de personas;
* Sincronizaciones;
* Control iCal;
* Configuración.


<code>pluginwoobook/woocommerce-dolibarr-sync.php</code>
== Configuración ==
 
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:
 
<code>custom/booking/syncwoocommande/receive.php</code>
 
Endpoint de prueba:
 
<code>custom/booking/syncwoocommande/ping.php</code>
 
=== 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 ===
La configuración se organiza en pantallas funcionales: parámetros generales, presupuestos y pedidos, parámetros públicos, sitio / CMS, sincronización, WooCommerce, alertas y diagnósticos.


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


Si el mismo evento se repite:
# Crear o seleccionar productos Dolibarr.
# Activarlos como reservables en Booking.
# Definir duraciones, capacidades y reglas básicas.
# Asociar recursos y servicios.
# Añadir reglas de disponibilidad o precio.
# Crear una reserva con el asistente.
# Controlar planning y sincronizaciones.
# Seguir indicadores por periodo, producto, ocupación e ingresos.


* el módulo intenta encontrar el objeto existente
== Nota técnica pública ==
* actualiza en lugar de recrear
* evita pedidos y reservas duplicados


Este punto es importante en entornos reales basados en webhooks.
Esta sección describe la arquitectura funcional sin exponer valores internos, nombres técnicos sensibles, secretos, rutas detalladas ni estructura SQL bruta.


== Lógica de cancelación ==
=== Arquitectura general ===


El módulo distingue entre lógica de '''cliente''' y lógica '''interna'''.
Booking es un módulo externo estándar de Dolibarr. Usa mecanismos nativos para declarar el módulo, añadir menús, gestionar derechos, instalar o actualizar estructuras de datos, ejecutar tareas programadas, añadir hooks, reaccionar mediante triggers, cargar traducciones y publicar recursos públicos cuando el administrador lo permite.


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


Sin embargo, los usuarios internos autorizados o los administradores pueden seguir cancelando desde el back-office según permisos y flujo operativo.
El módulo gestiona reservas, productos reservables, recursos, servicios, reglas de disponibilidad y precio, tipos de personas, vínculos producto-recurso, bloqueos externos, registros de sincronización y configuración.


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


== Menús principales ==
Booking interactúa con productos, servicios, terceros, contactos, presupuestos, pedidos, facturas, proyectos si es necesario, categorías, campos complementarios, tareas programadas y derechos de usuario.


El módulo añade un menú principal '''Reservas''' con entradas como:
=== Hooks y triggers ===


* Cuadro de mando
Los hooks muestran información de reserva, accesos rápidos, contadores o acciones contextuales en fichas Dolibarr. Los triggers mantienen coherentes reservas y documentos comerciales durante validaciones, modificaciones, eliminaciones o cancelaciones.
* Tomar una reserva
* Reservas
* Calendario
* Recursos
* Servicios
* Productos reservables
* Reglas
* Tipos de personas
* Sincronizaciones / Comparticiones
* Control iCal
* Configuración


== Configuración ==
=== Seguridad y mantenimiento ===


=== Ajustes generales ===
El módulo usa derechos Dolibarr dedicados, control administrador, tokens de formularios, firmas para intercambios WooCommerce, secretos para exportaciones y sincronizaciones, limitación de accesos públicos y registros. Las herramientas de mantenimiento ayudan a limpiar vínculos huérfanos y controlar sincronizaciones.


Permiten definir, por ejemplo:
== Instalación ==


* comportamiento por defecto
# Copiar el módulo en el directorio custom de Dolibarr.
* generación de documentos
# Verificar permisos de archivos.
* modo de disponibilidad por defecto
# Activar el módulo en '''Configuración > Módulos/Aplicaciones'''.
* gestión de extrafields
# Asignar derechos Booking.
* sincronización de documentos Dolibarr
# Abrir configuración y verificar parámetros generales.
* reglas de modificación
# Crear productos, recursos, servicios y reglas.
* ventana de cancelación tardía
# Probar una reserva interna antes de sincronizaciones externas.
* constantes globales del módulo


=== Ajustes de sincronización ===
== Derechos de usuario ==


Esta parte permite gestionar:
El módulo distingue lectura, gestión de reservas, recursos, servicios, reglas y administración. Configuración y sincronización deben reservarse a administradores o usuarios de confianza.


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


=== Ajustes WooCommerce Sync ===
=== Alquilar una casa rural, habitación o alojamiento sin perder el control ===
* alojamientos reservables;
* planning de ocupación;
* importación iCal;
* solicitudes WooCommerce;
* seguimiento comercial y facturación.


Existe una página dedicada para configurar la integración WooCommerce / Dolibarr.
=== Organizar salas y espacios para eventos ===
* salas vinculadas a productos o recursos;
* franjas, días o periodos;
* servicios opcionales;
* reglas de apertura e indisponibilidad;
* planning operativo.


Permite definir:
=== Gestionar material, vehículos o equipos ===
* equipos por recurso;
* control de disponibilidad;
* seguimiento de uso;
* vínculo con presupuestos, pedidos o facturas;
* mejor visibilidad del parque.


* modo de autenticación
== Buenas prácticas ==
* 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 ==
* Crear primero los productos en Dolibarr.
* Nombrar claramente recursos y servicios.
* Probar reglas en un periodo corto.
* Verificar planning después de cada sincronización externa.
* Limitar derechos de usuarios no administradores.
* Supervisar registros tras una puesta en producción WooCommerce.
* Conservar copia de seguridad antes de actualizaciones importantes.


El módulo incluye varias herramientas operativas:
== Desinstalación ==


* log de sincronización
Al desactivar, el módulo puede conservar datos de reserva. Es recomendable para evitar perder historial. La eliminación completa debe reservarse a pruebas o decisión confirmada del administrador.
* 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 ==
== FAQ ==


=== Alojamiento / alquiler vacacional ===
=== ¿El módulo modifica el núcleo de Dolibarr? ===
No. Booking es un módulo externo integrado con mecanismos estándar.


* reserva en sitio WordPress
=== ¿Puede usarse Booking sin WooCommerce? ===
* pedido WooCommerce
Sí. Puede funcionar solo en back-office Dolibarr.
* sincronización a Dolibarr
* reserva visible en Booking
* calendario de ocupación actualizado
* seguimiento comercial centralizado


=== Reserva de espacios o salas ===
=== ¿Se pueden sincronizar calendarios externos? ===
Sí. Hay importación y exportación iCal / ICS según configuración.


* productos reservables por franja
=== ¿Las reservas están vinculadas a presupuestos o pedidos? ===
* recursos asignados
Sí. Pueden vincularse a documentos comerciales Dolibarr.
* 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 ==
== Resumen ==


Booking para Dolibarr es un módulo completo de gestión de reservas orientado a la operación interna.
Booking para Dolibarr transforma Dolibarr en una herramienta central de reservas y alquileres. Estructura la oferta reservable, centraliza reservas, vincula datos con clientes y documentos, gestiona recursos y servicios, aplica reglas de negocio, sincroniza calendarios y puede integrar WordPress / WooCommerce.
 
Permite:
 
* estructurar la oferta reservable
* centralizar reservas
* vincular reservas con clientes y documentos comerciales
* gestionar un calendario operativo
* administrar recursos, servicios y reglas
* sincronizar flujos iCal
* integrar correctamente un sitio WordPress / WooCommerce / YITH mediante el plugin WooBook incluido
 
El módulo está dirigido a organizaciones que desean mantener Dolibarr como sistema central de gestión, conservando al mismo tiempo un sitio dedicado a la venta online y la reserva.
KSI
216

edits

Retrieved from "https://wiki.dolibarr.org/index.php/Special:MobileDiff/66066"