Gestion de locations et réservations

Booking pour Dolibarr

Réservations et locations pour hébergements, salles, matériels, activités, espaces et services planifiables

   Réservations
   Planning
   Ressources
   iCal / ICS
   Hébergements
   Salles & espaces
   Matériel
   WooCommerce

Présentation

Booking est un module externe pour Dolibarr ERP/CRM dédié à la gestion des réservations, locations, ressources, disponibilités et synchronisations avec des canaux externes.

Il permet d'utiliser Dolibarr comme centre de gestion interne pour les activités nécessitant une réservation dans le temps : hébergements, locations saisonnières, salles, équipements, espaces partagés, prestations réservables, activités sur créneaux ou tout service nécessitant un contrôle de capacité et de disponibilité.

Le module ne se limite pas à un formulaire de réservation. Il ajoute une véritable couche métier dans Dolibarr : produits réservables, ressources, services optionnels, règles de disponibilité et de prix, planning, documents commerciaux, synchronisations iCal et passerelle WordPress / WooCommerce via le plugin WooBook.

Éditeur et support

Élément	Information
Éditeur	KSIDol
Spécialité	Intégrateur Dolibarr
Services	Développement sur mesure, hébergement SaaS, accompagnement Dolibarr
Site web	https://www.ksidol.io
Support	support@ksidol.io
Modules Dolistore	https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search=

Informations module

Information	Détail
Nom du module	Booking
Usage principal	Gestion des réservations, locations, disponibilités, ressources et synchronisations
Type	Module externe Dolibarr
Compatibilité Dolibarr	Dolibarr v19 à v23
Compatibilité PHP	PHP 8.x
Installation	Module externe installé dans l'environnement personnalisé de Dolibarr
Modification du cœur Dolibarr	Non
Langues disponibles	Français, Anglais, Italien, Allemand, Espagnol

Langues disponibles

Drapeau	Langue	Code	Disponibilité
????????	Français	FR	Oui
????????	Anglais	EN	Oui
????????	Italien	IT	Oui
????????	Allemand	DE	Oui
????????	Espagnol	ES	Oui

Objectifs du module

Booking a pour objectif de centraliser dans Dolibarr la gestion opérationnelle des réservations.

Le module permet notamment de :

déclarer des produits Dolibarr comme réservables ;
associer des ressources, services et règles métier à ces produits ;
gérer les dates, durées, capacités et nombres de personnes ;
créer des réservations depuis le back-office ;
générer ou alimenter des documents commerciaux Dolibarr ;
suivre l'occupation dans un planning ;
synchroniser des indisponibilités avec des flux iCal / ICS ;
recevoir des commandes depuis WordPress / WooCommerce ;
éviter les doublons lors des synchronisations répétées ;
produire des indicateurs d'activité.

Positionnement conseillé

Le module peut être utilisé de deux manières complémentaires.

Utilisation back-office Dolibarr

Dans ce mode, les utilisateurs créent et suivent les réservations directement depuis Dolibarr. C'est le mode adapté aux équipes administratives, agences, gestionnaires d'hébergements, associations, entreprises de location ou structures qui souhaitent piloter leurs disponibilités depuis l'ERP.

Utilisation avec site WordPress / WooCommerce

Pour un site public de réservation ou de vente en ligne, le flux recommandé est le suivant :

Le client réserve ou commande sur le site WordPress.
WooCommerce gère la commande et les informations de réservation.
Le plugin WooBook transmet les informations utiles vers Dolibarr.
Booking crée ou met à jour la réservation interne.
Dolibarr reste le référentiel de gestion, de suivi commercial et de planning.

Ce fonctionnement est particulièrement adapté aux sites utilisant WooCommerce avec des champs de réservation ou une extension dédiée comme YITH.

Pour quels métiers ?

Booking s'adresse aux structures qui vendent, louent ou organisent des prestations avec une notion de date, de durée, de capacité ou de disponibilité. Le module est pensé pour les métiers qui doivent éviter les doubles réservations, centraliser leur planning et relier les réservations aux clients et documents commerciaux Dolibarr.

Gîtes, chambres d'hôtes, hôtels et locations saisonnières
Centralisez les séjours, nuitées, calendriers d'occupation, options et documents commerciaux depuis Dolibarr.

Conciergeries et gestionnaires de biens
Suivez plusieurs logements, propriétaires, périodes bloquées, plateformes externes et réservations multi-canaux dans un même outil.

Salles de réception, séminaires et événements
Gérez les créneaux, capacités, services additionnels, devis, commandes et planning d'occupation des espaces.

Associations, collectivités et structures culturelles
Organisez les réservations de salles, équipements, ateliers, activités, inscriptions ou prestations planifiées.

Loueurs de matériel et équipements professionnels
Planifiez les disponibilités de machines, outillage, sonorisation, mobilier, équipements techniques ou ressources internes.

Espaces de coworking, bureaux partagés et ateliers
Réservez bureaux, postes, salles de réunion, ateliers ou espaces mutualisés avec une vision claire du taux d'occupation.

Activités touristiques, loisirs et prestations sur créneaux
Structurez les réservations d'activités, visites, stages, sorties, prestations horaires ou offres avec nombre de participants.

Entreprises de services avec ressources planifiables
Affectez des ressources, équipes, options et périodes à des prestations vendues sous forme de réservation ou de location.

Titres courts utilisables pour la présentation

Booking Dolibarr pour hébergements et locations saisonnières
Réservation de salles, espaces et événements dans Dolibarr
Planning de location de matériel directement dans Dolibarr
Gestion des disponibilités, ressources et réservations clients
Dolibarr connecté à WooCommerce pour les réservations
Synchronisation iCal pour limiter les doubles réservations
Un module métier pour louer, planifier et facturer
Réservations multi-canaux centralisées dans Dolibarr

Fonctionnalités principales

Produits réservables
Les produits Dolibarr peuvent être activés comme produits réservables. Le module ajoute une couche de configuration permettant de définir le mode de réservation, les durées, la capacité, les personnes, les ressources, les services, les règles de disponibilité et les règles tarifaires.

Prise de réservation
Un assistant permet de saisir une réservation depuis Dolibarr. L'utilisateur sélectionne le client, le produit, les dates, le nombre de personnes, la catégorie ou les options disponibles. Selon le paramétrage, la réservation peut alimenter un devis, une commande ou un autre document commercial.

Planning et calendrier
Le planning permet de visualiser l'occupation, les réservations internes, les indisponibilités importées, les blocs externes et les informations utiles au suivi quotidien. Les vues permettent de travailler par période, ressource ou produit.

Ressources
Les ressources représentent les éléments réservables ou mobilisables : chambres, logements, salles, véhicules, matériels, équipements, équipes ou espaces. Chaque ressource peut être rattachée à un produit, catégorisée, rendue active ou inactive et affichée dans le planning.

Services optionnels
Le module permet de gérer des services associés aux réservations : ménage, petit-déjeuner, prestation additionnelle, option payante, service annexe ou toute prestation complémentaire à inclure dans le processus commercial.

Types de personnes
La gestion des types de personnes permet de moduler les règles selon la composition de la réservation : adulte, enfant, invité, participant, catégorie tarifaire ou toute typologie utile à l'activité.

Règles de disponibilité et de prix
Le moteur de règles permet de gérer les périodes ouvertes ou fermées, les priorités, les restrictions, les prix fixes, les variations tarifaires, les règles par produit, par période, par jour, par créneau, par catégorie ou selon le nombre de personnes lorsque l'option est activée.

Statistiques
Une page dédiée permet de suivre l'activité : nombre de réservations, taux d'occupation, nuitées, durée moyenne de séjour, occupation par produit, chiffre d'affaires lié et documents commerciaux associés.

Synchronisation iCal / ICS

Le module dispose d'une couche de synchronisation iCal / ICS destinée à limiter les doubles réservations et à centraliser les indisponibilités.

Cette couche permet notamment :

l'import de périodes occupées depuis des canaux externes ;
l'export de disponibilités ou indisponibilités vers des systèmes externes ;
la gestion de mappings entre produits Dolibarr et canaux externes ;
la supervision des derniers états de synchronisation ;
la journalisation des erreurs et conflits ;
la gestion des blocs externes ;
le lancement manuel ou automatisé de synchronisations ;
la réparation de certaines données de calendrier en cas de besoin.

Les canaux typiques peuvent inclure des plateformes de location, un site web, des calendriers externes, des imports manuels ou des blocs d'indisponibilité administrés depuis Dolibarr.

Intégration WordPress / WooCommerce / YITH

Booking peut fonctionner avec un site WordPress / WooCommerce grâce au plugin WooBook fourni avec le module.

Le principe général est le suivant :

Le site public collecte la commande et les informations de réservation.
WooCommerce prépare les données commerciales.
WooBook transmet la commande, le client, les lignes, les produits et les informations de séjour à Dolibarr.
Booking rapproche les données avec les produits Dolibarr.
La réservation interne est créée ou mise à jour.
Les documents commerciaux Dolibarr sont liés à la réservation.

Le flux est conçu pour être idempotent : si un événement est rejoué, le module cherche à mettre à jour les éléments existants plutôt qu'à créer des doublons.

Le module sait également gérer des cas avancés, comme les réservations multi-lignes, plusieurs chambres pour un même client, des dates distinctes par ligne, des nombres de personnes différents et certaines règles spécifiques telles que la taxe de séjour ou les prestations annexes.

Logique d'annulation

La logique d'annulation distingue les actions clients et les actions back-office.

Selon la configuration :

une fenêtre d'annulation peut s'appliquer au contexte client ;
les utilisateurs autorisés peuvent annuler depuis le back-office ;
une annulation peut libérer des périodes bloquées ;
les documents commerciaux liés peuvent déclencher une mise à jour de la réservation ;
certaines annulations peuvent être propagées vers WooCommerce lorsque le flux est configuré.

Menus principaux

Le module ajoute un menu principal dédié aux réservations avec les entrées suivantes :

Tableau de bord ;
Prendre une réservation ;
Réservations ;
Calendrier / planning ;
Ressources ;
Services ;
Produits réservables ;
Règles ;
Types de personnes ;
Synchronisations ;
Contrôle iCal ;
Configuration.

Configuration

La configuration est organisée par écrans fonctionnels.

Paramètres généraux

Cette partie permet de définir le comportement global du module : type de document généré, règles de disponibilité par défaut, synchronisation avec les documents Dolibarr, gestion des champs de réservation, sur-réservation, modification après confirmation, annulation tardive et maintenance de base.

Paramètres devis et commande

Cette partie permet de définir le comportement lors de la génération des documents commerciaux : statut par défaut, génération de PDF, conditions de paiement, modes de paiement et informations à reprendre dans les documents.

Paramètres publics

Le module peut publier une interface publique ou des éléments intégrables selon la configuration. Cette partie permet de gérer l'activation, les textes de marque, les couleurs, les menus publics, les contenus de confirmation, les documents annexes, le logo et les messages envoyés aux utilisateurs ou administrateurs.

Paramètres site / CMS

Une couche CMS permet de gérer certains contenus publics multilingues : pages, sections, branding, SEO, éléments de navigation, contenus de recherche, panier, validation et planning public.

Paramètres synchronisation

Cette partie permet de gérer les mappings de canaux, les imports iCal, les exports ICS, les diagnostics, les journaux de synchronisation, les tâches automatiques et la supervision des blocs externes.

Paramètres WooCommerce

Cette partie permet de configurer la liaison avec le site WordPress / WooCommerce : mode d'authentification, secrets de communication, URL du site, correspondances de produits, correspondances clients, options de taxe, tests de connectivité et rappel des réglages côté WordPress.

Alertes et diagnostics

Le module peut envoyer des alertes en cas d'incohérences ou de problèmes de synchronisation. Des outils de diagnostic permettent de comprendre l'origine d'un blocage, d'une indisponibilité ou d'un écart entre Dolibarr et les canaux externes.

Utilisation quotidienne

Préparer les produits réservables

Créer ou sélectionner les produits Dolibarr concernés.
Les activer comme produits réservables dans Booking.
Définir les durées, capacités et règles de base.
Associer les ressources et services nécessaires.
Ajouter les règles de disponibilité ou de prix.

Créer une réservation interne

Ouvrir l'assistant de prise de réservation.
Sélectionner le tiers ou créer le client si besoin.
Choisir le produit réservable.
Renseigner dates, heures, personnes et options.
Vérifier la disponibilité et le tarif.
Valider la réservation et le document commercial associé.

Suivre le planning

Le planning permet de visualiser l'occupation et de repérer rapidement les réservations confirmées, en attente, annulées ou issues de synchronisations externes.

Gérer les synchronisations

L'utilisateur peut contrôler les flux iCal, lancer une synchronisation, consulter les derniers statuts, identifier les erreurs et gérer les blocs externes.

Suivre les indicateurs

Les statistiques permettent de suivre l'activité par période, produit, taux d'occupation, nombre de nuitées et revenus liés aux documents commerciaux.

Notice technique publique

Cette section décrit l'architecture fonctionnelle du module sans exposer les valeurs internes, noms techniques sensibles, secrets, chemins détaillés ou structure SQL brute.

Architecture générale

Booking est construit comme un module externe Dolibarr standard. Il utilise les mécanismes natifs de Dolibarr pour :

déclarer le module ;
ajouter des menus ;
gérer les droits utilisateurs ;
installer ou mettre à jour les structures de données ;
exécuter des tâches planifiées ;
ajouter des hooks dans les fiches Dolibarr ;
réagir aux événements métier via des triggers ;
charger les traductions ;
publier des ressources publiques lorsque l'administrateur l'autorise.

Données gérées

Le module s'appuie sur plusieurs ensembles de données :

réservations ;
produits réservables ;
ressources ;
services ;
règles de disponibilité et de tarification ;
types de personnes ;
liens entre produits, ressources, services et règles ;
blocs externes d'indisponibilité ;
journaux et historiques de synchronisation ;
paramètres de configuration.

Liaisons Dolibarr

Booking interagit avec plusieurs objets standards de Dolibarr :

produits et services ;
tiers et contacts ;
devis ;
commandes ;
factures ;
projets lorsque le contexte le nécessite ;
catégories ;
champs complémentaires ;
tâches planifiées ;
droits utilisateurs.

Ces liaisons permettent de conserver Dolibarr comme référentiel central pour le suivi commercial, la facturation, les clients et les produits.

Hooks

Le module ajoute des hooks sur les fiches utiles afin d'afficher des informations de réservation, des accès rapides, des compteurs ou des actions contextuelles depuis les fiches produits, tiers et documents commerciaux.

Triggers

Les triggers assurent la cohérence entre les réservations et les documents Dolibarr. Ils peuvent notamment propager des informations de réservation, mettre à jour les liens avec les documents commerciaux, réagir aux validations, modifications, suppressions ou annulations, et détacher certaines données lorsque les objets liés disparaissent.

Sécurité

Le module s'appuie sur plusieurs niveaux de sécurité :

droits Dolibarr dédiés ;
contrôle administrateur pour la configuration ;
jetons de protection sur les formulaires ;
signatures pour les échanges WooCommerce ;
secrets pour les exports et synchronisations ;
limitation des accès publics selon configuration ;
journalisation des erreurs et opérations sensibles.

Maintenance

Les outils de maintenance permettent de nettoyer certains liens orphelins, vérifier les données de réservation, contrôler les synchronisations, réparer certaines données iCal et conserver une configuration cohérente après évolution du module.

Installation

Copier le module dans le répertoire personnalisé de Dolibarr.
Vérifier que les droits fichiers permettent à Dolibarr de lire le module et de publier les ressources publiques si cette option est utilisée.
Activer le module dans Configuration > Modules/Applications.
Affecter les droits Booking aux utilisateurs concernés.
Ouvrir la configuration du module et vérifier les paramètres généraux.
Créer les produits réservables, ressources, services et règles nécessaires.
Tester une réservation interne avant d'ouvrir les synchronisations externes.

Droits utilisateurs

Le module distingue plusieurs niveaux d'accès :

lecture des données de réservation ;
gestion des réservations ;
gestion des ressources ;
gestion des services ;
gestion des règles ;
administration du module.

Il est recommandé de limiter la configuration et les synchronisations aux administrateurs ou utilisateurs de confiance.

Cas d'utilisation métier

Louer un gîte, une chambre ou un logement sans perdre le fil

chambres, logements ou hébergements comme produits réservables ;
planning d'occupation lisible par période ;
import iCal depuis plateformes externes ;
commande ou demande depuis WooCommerce ;
suivi commercial et facturation dans Dolibarr.

Organiser la réservation de salles et d'espaces événementiels

salles liées à des produits ou ressources ;
gestion de créneaux, journées ou périodes ;
services optionnels comme ménage, accueil, équipement ou prestation annexe ;
règles d'ouverture, fermeture ou indisponibilité ;
planning opérationnel pour l'équipe.

Piloter la location de matériel, véhicules ou équipements

équipements réservables par ressource ;
contrôle de disponibilité sur une période ;
suivi des périodes d'utilisation ;
association avec devis, commandes ou factures ;
meilleure visibilité sur l'occupation du parc.

Centraliser une activité multi-canal dans Dolibarr

réservations créées en interne ;
indisponibilités importées depuis des canaux externes ;
synchronisation avec un site WordPress / WooCommerce ;
supervision des conflits et derniers états ;
Dolibarr utilisé comme référentiel commercial principal.

Planifier des prestations avec participants ou options

activités sur créneaux ;
nombre de personnes par réservation ;
services ou options complémentaires ;
documents commerciaux liés ;
statistiques par période, produit ou occupation.

Bonnes pratiques

Créer d'abord les produits Dolibarr avant de les activer dans Booking.
Nommer clairement les ressources et services.
Tester les règles de disponibilité sur une période courte avant généralisation.
Vérifier le planning après chaque activation de synchronisation externe.
Utiliser des droits limités pour les utilisateurs non administrateurs.
Surveiller les journaux de synchronisation après une mise en production WooCommerce.
Conserver une sauvegarde avant toute mise à jour importante du module.

Désinstallation

Lors de la désactivation, le module peut conserver les données de réservation selon le paramétrage. Cette approche est recommandée afin d'éviter la perte d'historique métier.

La suppression complète des données doit être réservée aux environnements de test ou aux cas où l'administrateur a confirmé qu'aucun historique de réservation ne doit être conservé.

FAQ

Le module modifie-t-il le cœur de Dolibarr ?

Non. Booking est un module externe qui s'intègre via les mécanismes standards de Dolibarr.

Peut-on utiliser Booking sans WooCommerce ?

Oui. Le module peut fonctionner uniquement en back-office Dolibarr pour saisir et suivre les réservations.

Peut-on synchroniser des calendriers externes ?

Oui. Le module inclut une couche iCal / ICS pour importer ou exporter des périodes selon la configuration.

Le module gère-t-il plusieurs chambres ou plusieurs lignes ?

Oui. Les versions récentes améliorent la gestion des réservations multi-lignes avec dates et nombres de personnes distincts.

Les réservations sont-elles liées aux devis ou commandes ?

Oui. Selon le paramétrage, une réservation peut être liée à des documents commerciaux Dolibarr et les informations utiles peuvent être propagées.

Les données sont-elles supprimées à la désactivation ?

Par défaut, il est recommandé de conserver les données. Une suppression complète ne doit être faite qu'après validation de l'administrateur.

Résumé

Booking pour Dolibarr transforme Dolibarr en outil central de gestion des réservations et locations.

Le module structure l'offre réservable, centralise les réservations, relie les données aux clients et documents commerciaux, affiche les disponibilités dans un planning, gère les ressources et services, applique des règles métier, synchronise les calendriers externes et peut intégrer un site WordPress / WooCommerce.

Il est particulièrement adapté aux entreprises ou organisations qui souhaitent conserver Dolibarr comme système de gestion principal tout en disposant d'un workflow de réservation complet et évolutif.