https://wiki.dolibarr.org/index.php?action=history&feed=atom&title=Gesti%C3%B3n_de_alquileres_y_reservas_para_DolibarrGestión de alquileres y reservas para Dolibarr - Revision history2026-11-09T06:21:29ZRevision history for this page on the wikiMediaWiki 1.39.17https://wiki.dolibarr.org/index.php?title=Gesti%C3%B3n_de_alquileres_y_reservas_para_Dolibarr&diff=68181&oldid=prevKSI: Mise à jour des liens officiels : vidéo, fiche KSIDol, démo et notice2026-10-19T16:08:22Z<p>Mise à jour des liens officiels : vidéo, fiche KSIDol, démo et notice</p>
<table style="background-color: #fff; color: #202122;" data-mw="interface">
<col class="diff-marker" />
<col class="diff-content" />
<col class="diff-marker" />
<col class="diff-content" />
<tr class="diff-title" lang="en">
<td colspan="2" style="background-color: #fff; color: #202122; text-align: center;">← Older revision</td>
<td colspan="2" style="background-color: #fff; color: #202122; text-align: center;">Revision as of 16:08, 19 October 2026</td>
</tr><tr><td colspan="2" class="diff-lineno" id="mw-diff-left-l323">Line 323:</td>
<td colspan="2" class="diff-lineno">Line 323:</td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>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.</div></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>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.</div></td></tr>
<tr><td colspan="2" class="diff-side-deleted"></td><td class="diff-marker" data-marker="+"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;"></ins></div></td></tr>
<tr><td colspan="2" class="diff-side-deleted"></td><td class="diff-marker" data-marker="+"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;">== Enlaces oficiales ==</ins></div></td></tr>
<tr><td colspan="2" class="diff-side-deleted"></td><td class="diff-marker" data-marker="+"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;">* Vídeo de demostración : [https://youtu.be/JduaIeWMf0U Booking — demo (YouTube)]</ins></div></td></tr>
<tr><td colspan="2" class="diff-side-deleted"></td><td class="diff-marker" data-marker="+"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;">* Ficha del módulo : [https://www.ksidol.io/es/modules/detail?module=main_module_booking Booking en KSIDol]</ins></div></td></tr>
<tr><td colspan="2" class="diff-side-deleted"></td><td class="diff-marker" data-marker="+"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;">* Demostración en línea : [https://www.ksidol.io/t/demo-booking/custom/booking/index.php?mainmenu=booking&leftmenu=booking_main Booking — abrir la demo]</ins></div></td></tr>
<tr><td colspan="2" class="diff-side-deleted"></td><td class="diff-marker" data-marker="+"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;">* Manual del módulo : [https://www.ksidol.io/notices/ksidol_notice_es/booking.html Booking — consultar el manual]</ins></div></td></tr>
<!-- diff cache key mediawiki_test:diff::1.12:old-66066:rev-68181 -->
</table>KSIhttps://wiki.dolibarr.org/index.php?title=Gesti%C3%B3n_de_alquileres_y_reservas_para_Dolibarr&diff=66066&oldid=prevKSI at 11:45, 3 May 20262026-05-03T11:45:32Z<p></p>
<a href="https://wiki.dolibarr.org/index.php?title=Gesti%C3%B3n_de_alquileres_y_reservas_para_Dolibarr&diff=66066&oldid=65633">Show changes</a>KSIhttps://wiki.dolibarr.org/index.php?title=Gesti%C3%B3n_de_alquileres_y_reservas_para_Dolibarr&diff=65633&oldid=prevKSI: 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'..."2026-03-17T19:09:40Z<p>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'..."</p>
<p><b>New page</b></p><div>= Booking para Dolibarr =<br />
<br />
== Presentación ==<br />
<br />
'''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'''.<br />
<br />
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.<br />
<br />
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.<br />
<br />
== Posicionamiento actual del módulo ==<br />
<br />
El '''portal público nativo histórico ya no es el modo recomendado'''.<br />
<br />
El flujo objetivo actual se basa en:<br />
<br />
* '''WordPress''' para el sitio público<br />
* '''WooCommerce''' para los pedidos online<br />
* '''YITH''' o equivalente para los campos y la lógica de reserva en el sitio<br />
* '''Dolibarr + Booking''' para la gestión interna, pedidos, reservas, planificación, reglas y seguimiento<br />
<br />
El módulo incluye un plugin de WordPress dedicado llamado '''WooBook''', que envía los pedidos de WooCommerce a Dolibarr.<br />
<br />
== Disponibilidad en DoliStore ==<br />
<br />
El módulo se distribuye en DoliStore.<br />
<br />
Página del editor K.S.I: <br />
[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]<br />
<br />
== Objetivos del módulo ==<br />
<br />
Booking está pensado para:<br />
<br />
* centralizar las reservas en Dolibarr<br />
* vincular una reserva a un producto, un tercero y un documento comercial<br />
* visualizar la ocupación en un calendario<br />
* gestionar recursos y servicios asociados<br />
* aplicar reglas de disponibilidad y precio<br />
* sincronizar indisponibilidades mediante flujos iCal<br />
* integrar pedidos procedentes de un sitio WordPress / WooCommerce<br />
* proporcionar indicadores de actividad e informes<br />
<br />
== Compatibilidad ==<br />
<br />
* '''Dolibarr''': v19 a v23<br />
* '''PHP''': PHP 8.x<br />
* '''Tipo de instalación''': módulo externo en <code>htdocs/custom</code><br />
* '''Sin modificación del core de Dolibarr'''<br />
<br />
== Funcionalidades principales ==<br />
<br />
=== 1. Productos reservables ===<br />
<br />
El módulo permite convertir productos estándar del catálogo de Dolibarr en '''productos reservables'''.<br />
<br />
Para cada producto reservable se puede definir:<br />
<br />
* activación en Booking<br />
* capacidad<br />
* granularidad de reserva<br />
* duraciones mínimas y máximas<br />
* gestión del número de personas<br />
* recursos vinculados<br />
* servicios vinculados<br />
* tiempos de margen antes y después de la reserva<br />
* necesidad de confirmación manual<br />
* anticipo opcional<br />
* color de visualización en el calendario<br />
<br />
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.<br />
<br />
=== 2. Alta de reservas en back-office ===<br />
<br />
El módulo ofrece una pantalla '''Tomar una reserva''' que permite a los usuarios internos crear una reserva directamente desde Dolibarr.<br />
<br />
Una reserva puede vincularse a:<br />
<br />
* un tercero existente<br />
* un producto reservable<br />
* un periodo de llegada / salida<br />
* un número de personas<br />
* una categoría de alquiler<br />
* servicios opcionales<br />
* notas públicas o internas<br />
<br />
Según la configuración, esta acción puede generar:<br />
<br />
* un '''presupuesto'''<br />
* o un '''pedido'''<br />
<br />
La información de la reserva se propaga a los documentos comerciales vinculados mediante los mecanismos del módulo.<br />
<br />
=== 3. Lista de reservas ===<br />
<br />
El módulo incluye una lista dedicada de reservas.<br />
<br />
Esta vista permite:<br />
<br />
* filtrar reservas<br />
* consultar fechas<br />
* identificar el cliente<br />
* mostrar el documento de origen<br />
* seguir el estado<br />
* distinguir reservas internas y bloques externos<br />
* abrir archivos<br />
* ejecutar acciones de negocio según permisos<br />
<br />
=== 4. Calendario / planificación ===<br />
<br />
El calendario es uno de los elementos centrales del módulo.<br />
<br />
Permite:<br />
<br />
* visualizar la ocupación por periodo<br />
* filtrar por recurso<br />
* navegar por día, mes o año<br />
* mostrar reservas internas<br />
* mostrar bloques externos sincronizados<br />
* abrir fichas relacionadas<br />
* realizar acciones como cancelación según permisos<br />
<br />
El calendario está pensado como una vista operativa de la ocupación real.<br />
<br />
=== 5. Gestión de recursos ===<br />
<br />
El módulo gestiona '''recursos''' asignables a las reservas:<br />
<br />
* habitaciones<br />
* unidades de alojamiento<br />
* salas<br />
* equipos<br />
* equipos humanos<br />
* activos operativos<br />
<br />
Cada recurso puede vincularse a un producto, clasificarse, tener capacidad y mostrarse con un color específico en el calendario.<br />
<br />
=== 6. Gestión de servicios ===<br />
<br />
El módulo también gestiona '''servicios opcionales''' vinculados a las reservas.<br />
<br />
Ejemplos:<br />
<br />
* limpieza<br />
* desayuno<br />
* servicio adicional<br />
* opción de pago<br />
* servicio complementario<br />
<br />
Estos servicios pueden proponerse durante la gestión de la reserva e incluirse en el proceso general.<br />
<br />
=== 7. Tipos de personas ===<br />
<br />
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.<br />
<br />
Esto ayuda a mejorar reglas de capacidad, cálculos basados en personas y otras reglas operativas.<br />
<br />
=== 8. Reglas de disponibilidad y tarificación ===<br />
<br />
Booking incluye un motor de reglas para adaptar el comportamiento del módulo según el contexto.<br />
<br />
Las reglas pueden afectar a:<br />
<br />
* disponibilidad<br />
* apertura / cierre de reservas<br />
* tarificación<br />
* restricciones<br />
* categorías<br />
* recursos<br />
* servicios<br />
* tipos de personas<br />
* rangos de fechas<br />
* días de la semana<br />
* franjas horarias<br />
<br />
El motor permite:<br />
<br />
* abrir o cerrar periodos<br />
* aplicar prioridades<br />
* fijar un precio<br />
* aumentar o disminuir un precio<br />
* definir un precio fijo por producto<br />
* gestionar comportamientos específicos como tasa turística o desayuno<br />
<br />
=== 9. Estadísticas ===<br />
<br />
El módulo ofrece una página de estadísticas para seguir la actividad de Booking.<br />
<br />
Los indicadores disponibles incluyen:<br />
<br />
* tasa de ocupación<br />
* noches vendidas<br />
* duración media de estancia<br />
* ocupación por producto<br />
* noches por mes<br />
* ingresos vinculados<br />
* documentos comerciales vinculados<br />
<br />
Las estadísticas se basan en los datos de Booking y en los documentos Dolibarr relacionados.<br />
<br />
== Sincronizaciones iCal ==<br />
<br />
=== Objetivo ===<br />
<br />
El módulo puede sincronizar disponibilidad e indisponibilidad con fuentes externas en formato '''iCal / ICS'''.<br />
<br />
Casos típicos:<br />
<br />
* importar periodos ocupados desde canales externos<br />
* exportar periodos ocupados a sistemas externos<br />
* reducir el riesgo de doble reserva<br />
* integrar bloques externos en el calendario de Dolibarr<br />
<br />
=== Funciones disponibles ===<br />
<br />
El módulo proporciona:<br />
<br />
* configuración de canales<br />
* importación iCal<br />
* exportación ICS<br />
* generación de secretos de exportación<br />
* webhook iCal<br />
* importación manual<br />
* lanzamiento manual de sincronizaciones<br />
* tarea cron dedicada en Dolibarr<br />
* registro de sincronización<br />
* diagnóstico de flujos<br />
* pantalla de control iCal<br />
* reparación / recreación del cron<br />
* gestión de bloques externos<br />
<br />
=== Canales soportados ===<br />
<br />
Según la configuración, los canales pueden incluir:<br />
<br />
* Airbnb<br />
* Booking.com<br />
* Website<br />
* Google en algunos contextos<br />
* importaciones manuales<br />
* bloqueos manuales<br />
<br />
=== Control iCal ===<br />
<br />
Una pantalla dedicada ayuda a supervisar el comportamiento iCal y la gestión de bloques.<br />
<br />
Es útil para:<br />
<br />
* entender el origen de una indisponibilidad<br />
* controlar importaciones<br />
* gestionar operaciones de bloqueo / desbloqueo<br />
* revisar el historial de sincronización<br />
<br />
== Integración WordPress / WooCommerce / YITH ==<br />
<br />
=== Principio general ===<br />
<br />
El flujo recomendado es:<br />
<br />
# reserva / pedido en WordPress<br />
# tratamiento comercial en WooCommerce<br />
# datos de estancia procedentes del sitio o de un plugin de reservas como YITH<br />
# envío a Dolibarr mediante el plugin '''WooBook'''<br />
# creación o actualización de objetos en Dolibarr<br />
<br />
=== Plugin WooBook incluido ===<br />
<br />
El módulo incluye el plugin de WordPress:<br />
<br />
<code>pluginwoobook/woocommerce-dolibarr-sync.php</code><br />
<br />
Este plugin permite:<br />
<br />
* configurar el endpoint de Dolibarr<br />
* configurar el secreto compartido<br />
* elegir los estados de WooCommerce a sincronizar<br />
* definir mapeos de productos Woo -> Dolibarr<br />
* definir mapeos de clientes Woo -> terceros Dolibarr<br />
* transmitir metadatos útiles para la reserva<br />
<br />
=== Información enviada desde WooCommerce ===<br />
<br />
El flujo puede transmitir:<br />
<br />
* id del pedido Woo<br />
* estado del pedido<br />
* cliente<br />
* correo electrónico<br />
* id del cliente Woo<br />
* líneas de pedido<br />
* producto Woo<br />
* SKU<br />
* fechas de estancia<br />
* número de personas<br />
* notas<br />
* importes<br />
* IVA<br />
* metadatos de líneas y del pedido<br />
<br />
=== Compatibilidad con YITH ===<br />
<br />
El plugin WooBook reconoce metadatos de reserva habituales, incluso en contextos '''YITH'''.<br />
<br />
Esto permite al módulo procesar:<br />
<br />
* fechas de inicio<br />
* fechas de fin<br />
* información de estancia<br />
* número de personas<br />
<br />
sin exigir una única estructura rígida del lado de WordPress.<br />
<br />
=== Endpoints Dolibarr ===<br />
<br />
Endpoint principal de sincronización Woo:<br />
<br />
<code>custom/booking/syncwoocommande/receive.php</code><br />
<br />
Endpoint de prueba:<br />
<br />
<code>custom/booking/syncwoocommande/ping.php</code><br />
<br />
=== Seguridad de la sincronización Woo ===<br />
<br />
La comunicación entre WooCommerce y Dolibarr está protegida mediante solicitudes firmadas.<br />
<br />
Se admiten dos modos:<br />
<br />
* '''WooBook'''<br />
* '''Webhook nativo de WooCommerce'''<br />
<br />
El módulo verifica las firmas antes de procesar los datos.<br />
<br />
=== Resultado dentro de Dolibarr ===<br />
<br />
Cuando se sincroniza un pedido Woo, el módulo puede:<br />
<br />
* crear o actualizar el tercero<br />
* crear o actualizar el pedido de Dolibarr<br />
* asociar las líneas al producto correcto de Dolibarr<br />
* crear o actualizar la reserva interna de Booking<br />
* vincular la reserva al pedido<br />
* actualizar las fechas<br />
* cancelar la reserva si el pedido Woo se cancela / reembolsa / falla<br />
* liberar los bloques vinculados cuando sea necesario<br />
<br />
=== Idempotencia ===<br />
<br />
El flujo Woo está diseñado para evitar duplicados.<br />
<br />
Si el mismo evento se repite:<br />
<br />
* el módulo intenta encontrar el objeto existente<br />
* actualiza en lugar de recrear<br />
* evita pedidos y reservas duplicados<br />
<br />
Este punto es importante en entornos reales basados en webhooks.<br />
<br />
== Lógica de cancelación ==<br />
<br />
El módulo distingue entre lógica de '''cliente''' y lógica '''interna'''.<br />
<br />
La ventana de cancelación tardía configurada se aplica al lado cliente según las reglas del módulo.<br />
<br />
Sin embargo, los usuarios internos autorizados o los administradores pueden seguir cancelando desde el back-office según permisos y flujo operativo.<br />
<br />
Las cancelaciones también pueden propagarse desde documentos comerciales vinculados o desde la sincronización Woo según el escenario.<br />
<br />
== Menús principales ==<br />
<br />
El módulo añade un menú principal '''Reservas''' con entradas como:<br />
<br />
* Cuadro de mando<br />
* Tomar una reserva<br />
* Reservas<br />
* Calendario<br />
* Recursos<br />
* Servicios<br />
* Productos reservables<br />
* Reglas<br />
* Tipos de personas<br />
* Sincronizaciones / Comparticiones<br />
* Control iCal<br />
* Configuración<br />
<br />
== Configuración ==<br />
<br />
=== Ajustes generales ===<br />
<br />
Permiten definir, por ejemplo:<br />
<br />
* comportamiento por defecto<br />
* generación de documentos<br />
* modo de disponibilidad por defecto<br />
* gestión de extrafields<br />
* sincronización de documentos Dolibarr<br />
* reglas de modificación<br />
* ventana de cancelación tardía<br />
* constantes globales del módulo<br />
<br />
=== Ajustes de sincronización ===<br />
<br />
Esta parte permite gestionar:<br />
<br />
* mapeos canal / producto<br />
* importaciones iCal<br />
* exportaciones ICS<br />
* secretos<br />
* tokens<br />
* diagnósticos<br />
* logs<br />
* cron<br />
* conservación de datos de configuración<br />
<br />
=== Ajustes WooCommerce Sync ===<br />
<br />
Existe una página dedicada para configurar la integración WooCommerce / Dolibarr.<br />
<br />
Permite definir:<br />
<br />
* modo de autenticación<br />
* secretos de comunicación<br />
* URL base de Dolibarr<br />
* mapeos de productos Woo -> Dolibarr<br />
* mapeos de clientes Woo -> terceros Dolibarr<br />
* comportamientos específicos como la creación de línea de tasa turística<br />
* pruebas de conectividad<br />
* recordatorios de configuración del lado de WordPress<br />
<br />
== Logs, mantenimiento y diagnóstico ==<br />
<br />
El módulo incluye varias herramientas operativas:<br />
<br />
* log de sincronización<br />
* prueba de conectividad Woo<br />
* prueba de importación / exportación iCal<br />
* reparación del cron iCal<br />
* limpieza de huérfanos<br />
* herramientas de control iCal<br />
* herramientas de corrección para desajustes de fechas Woo / sitio<br />
* supervisión del estado de sincronización<br />
<br />
== Casos de uso típicos ==<br />
<br />
=== Alojamiento / alquiler vacacional ===<br />
<br />
* reserva en sitio WordPress<br />
* pedido WooCommerce<br />
* sincronización a Dolibarr<br />
* reserva visible en Booking<br />
* calendario de ocupación actualizado<br />
* seguimiento comercial centralizado<br />
<br />
=== Reserva de espacios o salas ===<br />
<br />
* productos reservables por franja<br />
* recursos asignados<br />
* calendario de ocupación<br />
* reglas de apertura / cierre<br />
* documentos comerciales vinculados<br />
<br />
=== Actividad multicanal ===<br />
<br />
* importación iCal desde plataformas externas<br />
* gestión de bloques externos<br />
* reducción del riesgo de doble reserva<br />
* visibilidad unificada en el calendario de Dolibarr<br />
<br />
== Resumen ==<br />
<br />
Booking para Dolibarr es un módulo completo de gestión de reservas orientado a la operación interna.<br />
<br />
Permite:<br />
<br />
* estructurar la oferta reservable<br />
* centralizar reservas<br />
* vincular reservas con clientes y documentos comerciales<br />
* gestionar un calendario operativo<br />
* administrar recursos, servicios y reglas<br />
* sincronizar flujos iCal<br />
* integrar correctamente un sitio WordPress / WooCommerce / YITH mediante el plugin WooBook incluido<br />
<br />
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.</div>KSI