Gestion de locations et réservations: Difference between revisions

Jump to navigation Jump to search

Gestion de locations et réservations (view source)

Revision as of 11:30, 3 May 2026

12,371 bytes added ,  5 months ago
m
no edit summary
VisualWikitext
(Created page with "= Booking pour Dolibarr = == Présentation == '''Booking''' est un module externe pour Dolibarr dédié à la '''gestion des réservations''', des '''plannings d’occupatio...")
Tag: 2017 source edit
 
mNo edit summary
Tag: 2017 source edit
Line 1: Line 1:
= Booking pour Dolibarr =
[[Category:Complementary modules]]
[[Category:K.S.I]]
[[Category:Booking]]
[[Category:Reservation]]
 
{{TemplateDocDev}}
{{TemplateDocUtil}}
 
<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 pour Dolibarr</div>
  <div style="font-size:18px; color:#345; margin-bottom:14px;">Réservations et locations pour hébergements, salles, matériels, activités, espaces et services planifiables</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;">Réservations</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Planning</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Ressources</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;">Hébergements</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Salles & espaces</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Matériel</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">WooCommerce</span>
  </div>
</div>


== Présentation ==
== Présentation ==


'''Booking''' est un module externe pour Dolibarr dédié à la '''gestion des réservations''', des '''plannings d’occupation''', des '''ressources''', des '''règles de disponibilité et de tarification''', ainsi qu’à la '''synchronisation avec des canaux externes'''.
'''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 permet de transformer Dolibarr en outil central de pilotage pour une activité de réservation : hébergements, chambres, gîtes, locations saisonnières, espaces, équipements, services réservables ou toute activité nécessitant un suivi de dates, 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.


Contrairement à une logique purement site web, Booking est conçu comme une '''brique métier interne''' : il relie les réservations aux clients, aux produits, aux commandes, au planning, aux statistiques et aux flux de synchronisation.
== Éditeur et support ==


== Positionnement actuel du module ==
{| class="wikitable" style="width:100%; border-collapse:collapse;"
! style="width:24%; background:#f0f6ff;" | Élément
! style="background:#f0f6ff;" | 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=
|}


Le '''portail public natif historique n’est plus le mode recommandé'''.
== Informations module ==


Le fonctionnement cible actuel repose sur :
{| class="wikitable" style="width:100%;"
! style="width:24%; background:#f7f7f7;" | Information
! style="background:#f7f7f7;" | 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
|}


* '''WordPress''' pour le site public
== Langues disponibles ==
* '''WooCommerce''' pour la commande en ligne
* '''YITH''' ou équivalent pour les champs et logiques de réservation côté site
* '''Dolibarr + Booking''' pour la gestion interne, les commandes, les réservations, le planning, les règles et le suivi


Le module est livré avec un plugin WordPress dédié nommé '''WooBook''', qui assure la transmission des commandes WooCommerce vers Dolibarr.
{| class="wikitable" style="width:100%; text-align:center;"
! style="background:#f0f6ff;" | Drapeau
! style="background:#f0f6ff;" | Langue
! style="background:#f0f6ff;" | Code
! style="background:#f0f6ff;" | Disponibilité
|-
| ???????? || Français || FR || Oui
|-
| ???????? || Anglais || EN || Oui
|-
| ???????? || Italien || IT || Oui
|-
| ???????? || Allemand || DE || Oui
|-
| ???????? || Espagnol || ES || Oui
|}


== Disponibilité DoliStore ==
== Objectifs du module ==


Le module est distribué via DoliStore.
Booking a pour objectif de centraliser dans Dolibarr la gestion opérationnelle des réservations.


Lien éditeur K.S.I :
Le module permet notamment de :
[https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search= Voir les modules K.S.I sur DoliStore]


== Objectifs du module ==
* 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.


Booking répond à plusieurs besoins :
=== Utilisation back-office Dolibarr ===


* centraliser les réservations dans 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.
* relier une réservation à un produit, un tiers et un document commercial
* visualiser l’occupation dans un planning
* gérer les ressources et les prestations associées
* appliquer des règles de disponibilité et de prix
* synchroniser les indisponibilités avec des flux iCal
* intégrer les commandes issues d’un site WordPress / WooCommerce
* produire des indicateurs de suivi d’activité


== Compatibilité ==
=== Utilisation avec site WordPress / WooCommerce ===


* '''Dolibarr''' : v19 à v23
Pour un site public de réservation ou de vente en ligne, le flux recommandé est le suivant :
* '''PHP''' : PHP 8.x
* '''Type d’installation''' : module externe dans <code>htdocs/custom</code>
* '''Aucune modification du core Dolibarr'''


== Fonctionnalités principales ==
# 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.


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


Le module permet de transformer des produits du catalogue Dolibarr en '''produits réservables'''.
== Pour quels métiers ? ==


Pour chaque produit réservable, il est possible de définir notamment :
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.


* son activation dans Booking
<div style="border:1px solid #d7e3f4; border-radius:12px; padding:16px; margin:14px 0; background:#f8fbff;">
* sa capacité
'''Gîtes, chambres d'hôtes, hôtels et locations saisonnières'''<br />
* sa granularité de réservation
Centralisez les séjours, nuitées, calendriers d'occupation, options et documents commerciaux depuis Dolibarr.
* ses durées minimales et maximales
</div>
* la gestion du nombre de personnes
* les ressources associées
* les prestations associées
* les temps tampons avant et après réservation
* la nécessité d’une confirmation manuelle
* un acompte éventuel
* une couleur d’affichage dans le planning


Cette couche permet d’adapter le comportement du module à des cas variés : location à la nuit, réservation par créneau, unité, séjour, capacité multiple, etc.
<div style="border:1px solid #d7e3f4; border-radius:12px; padding:16px; margin:14px 0; background:#f8fbff;">
'''Conciergeries et gestionnaires de biens'''<br />
Suivez plusieurs logements, propriétaires, périodes bloquées, plateformes externes et réservations multi-canaux dans un même outil.
</div>


=== 2. Prise de réservation en back-office ===
<div style="border:1px solid #d7e3f4; border-radius:12px; padding:16px; margin:14px 0; background:#f8fbff;">
'''Salles de réception, séminaires et événements'''<br />
Gérez les créneaux, capacités, services additionnels, devis, commandes et planning d'occupation des espaces.
</div>


Le module propose un écran '''Prendre une réservation''' permettant à un utilisateur interne de créer une réservation depuis Dolibarr.
<div style="border:1px solid #d7e3f4; border-radius:12px; padding:16px; margin:14px 0; background:#f8fbff;">
'''Associations, collectivités et structures culturelles'''<br />
Organisez les réservations de salles, équipements, ateliers, activités, inscriptions ou prestations planifiées.
</div>


La réservation peut être liée à :
<div style="border:1px solid #d7e3f4; border-radius:12px; padding:16px; margin:14px 0; background:#f8fbff;">
'''Loueurs de matériel et équipements professionnels'''<br />
Planifiez les disponibilités de machines, outillage, sonorisation, mobilier, équipements techniques ou ressources internes.
</div>


* un tiers existant
<div style="border:1px solid #d7e3f4; border-radius:12px; padding:16px; margin:14px 0; background:#f8fbff;">
* un produit réservable
'''Espaces de coworking, bureaux partagés et ateliers'''<br />
* une période d’arrivée / départ
Réservez bureaux, postes, salles de réunion, ateliers ou espaces mutualisés avec une vision claire du taux d'occupation.
* un nombre de personnes
</div>
* une catégorie de location
* des prestations complémentaires
* une note publique ou interne


Selon le paramétrage, cette action peut générer :
<div style="border:1px solid #d7e3f4; border-radius:12px; padding:16px; margin:14px 0; background:#f8fbff;">
'''Activités touristiques, loisirs et prestations sur créneaux'''<br />
Structurez les réservations d'activités, visites, stages, sorties, prestations horaires ou offres avec nombre de participants.
</div>


* un '''devis'''
<div style="border:1px solid #d7e3f4; border-radius:12px; padding:16px; margin:14px 0; background:#f8fbff;">
* ou une '''commande'''
'''Entreprises de services avec ressources planifiables'''<br />
Affectez des ressources, équipes, options et périodes à des prestations vendues sous forme de réservation ou de location.
</div>


Les informations de réservation sont propagées sur les documents commerciaux via les mécanismes du module.
== Titres courts utilisables pour la présentation ==


=== 3. Liste des réservations ===
* '''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'''


Le module dispose d’un listing dédié permettant de consulter les réservations enregistrées.
== Fonctionnalités principales ==


Cette vue permet notamment :
<div style="border:1px solid #e2e8f0; border-radius:12px; padding:16px; margin:14px 0; background:#ffffff;">
'''Produits réservables'''<br />
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.
</div>


* de filtrer les réservations
<div style="border:1px solid #e2e8f0; border-radius:12px; padding:16px; margin:14px 0; background:#ffffff;">
* de consulter les dates
'''Prise de réservation'''<br />
* d’identifier le client
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.
* de voir le document d’origine
</div>
* de suivre le statut
* de distinguer les réservations internes et les blocs externes
* d’ouvrir les archives
* d’effectuer certaines actions métier selon les droits


=== 4. Planning / calendrier ===
<div style="border:1px solid #e2e8f0; border-radius:12px; padding:16px; margin:14px 0; background:#ffffff;">
'''Planning et calendrier'''<br />
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.
</div>


Le planning est l’un des éléments centraux du module.
<div style="border:1px solid #e2e8f0; border-radius:12px; padding:16px; margin:14px 0; background:#ffffff;">
'''Ressources'''<br />
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.
</div>


Il permet :
<div style="border:1px solid #e2e8f0; border-radius:12px; padding:16px; margin:14px 0; background:#ffffff;">
'''Services optionnels'''<br />
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.
</div>


* de visualiser l’occupation par période
<div style="border:1px solid #e2e8f0; border-radius:12px; padding:16px; margin:14px 0; background:#ffffff;">
* de filtrer par ressource
'''Types de personnes'''<br />
* de naviguer par jour, mois ou année
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é.
* de voir les réservations internes
</div>
* de voir les blocages issus des synchronisations externes
* d’ouvrir les fiches associées
* d’effectuer certaines actions comme l’annulation selon les droits


Le planning est conçu comme une vue opérationnelle de l’occupation réelle.
<div style="border:1px solid #e2e8f0; border-radius:12px; padding:16px; margin:14px 0; background:#ffffff;">
'''Règles de disponibilité et de prix'''<br />
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.
</div>


=== 5. Gestion des ressources ===
<div style="border:1px solid #e2e8f0; border-radius:12px; padding:16px; margin:14px 0; background:#ffffff;">
'''Statistiques'''<br />
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.
</div>


Le module gère des '''ressources''' pouvant être affectées aux réservations :
== Synchronisation iCal / ICS ==


* chambres
Le module dispose d'une couche de synchronisation iCal / ICS destinée à limiter les doubles réservations et à centraliser les indisponibilités.
* logements
* salles
* équipements
* équipes
* moyens matériels


Chaque ressource peut être liée à un produit, catégorisée, dotée d’une capacité et affichée avec une couleur spécifique dans le planning.
Cette couche permet notamment :


=== 6. Gestion des prestations ===
* 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.


Le module gère des '''prestations optionnelles''' liées aux réservations.
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.


Exemples :
== Intégration WordPress / WooCommerce / YITH ==


* ménage
Booking peut fonctionner avec un site WordPress / WooCommerce grâce au plugin WooBook fourni avec le module.
* petit déjeuner
* service complémentaire
* option payante
* prestation annexe


Ces prestations peuvent être proposées dans le cadre d’une réservation et intégrées au traitement global.
Le principe général est le suivant :


=== 7. Types de personnes ===
# 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 module inclut la gestion des '''types de personnes''' afin d’adapter certaines règles à la composition du séjour.
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.


Cela permet d’affiner la logique métier autour des capacités, des calculs liés au nombre de personnes ou de certaines règles tarifaires.
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.


=== 8. Règles de disponibilité et de tarification ===
== Logique d'annulation ==


Booking intègre un système de règles qui permet d’adapter le comportement du module selon le contexte.
La logique d'annulation distingue les actions clients et les actions back-office.


Les règles peuvent porter sur :
Selon la configuration :


* la disponibilité
* une fenêtre d'annulation peut s'appliquer au contexte client ;
* la fermeture / ouverture des réservations
* les utilisateurs autorisés peuvent annuler depuis le back-office ;
* la tarification
* une annulation peut libérer des périodes bloquées ;
* les restrictions
* les documents commerciaux liés peuvent déclencher une mise à jour de la réservation ;
* certaines catégories
* certaines annulations peuvent être propagées vers WooCommerce lorsque le flux est configuré.
* certaines ressources
* certaines prestations
* certains types de personnes
* certaines périodes
* certains jours de semaine
* certaines plages horaires


Le moteur permet notamment :
== Menus principaux ==


* d’ouvrir ou fermer des périodes
Le module ajoute un menu principal dédié aux réservations avec les entrées suivantes :
* d’appliquer des priorités
* de fixer un prix
* d’augmenter ou diminuer un prix
* de gérer un prix fixe par produit
* de gérer des comportements spécifiques liés à la taxe de séjour ou au petit déjeuner


=== 9. Statistiques ===
* 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.


Le module fournit une page de statistiques permettant de suivre l’activité Booking.
== Configuration ==


Les indicateurs disponibles couvrent notamment :
La configuration est organisée par écrans fonctionnels.


* le taux d’occupation
=== Paramètres généraux ===
* les nuitées vendues
* la durée moyenne de séjour
* l’occupation par produit
* les nuitées par mois
* le chiffre d’affaires lié
* les documents commerciaux associés


Les statistiques s’appuient sur les données Booking et sur les documents commerciaux Dolibarr liés.
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.


== Synchronisations iCal ==
=== Paramètres devis et commande ===


=== Objectif ===
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.


Le module permet de synchroniser les disponibilités et indisponibilités avec des sources externes au format '''iCal / ICS'''.
=== Paramètres publics ===


Cela permet par exemple de :
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.


* récupérer des périodes occupées depuis des canaux externes
=== Paramètres site / CMS ===
* publier des périodes occupées vers d’autres outils
* éviter les doubles réservations
* intégrer des blocages externes dans le planning Dolibarr


=== Fonctions disponibles ===
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.


Le module propose :
=== Paramètres synchronisation ===


* configuration des canaux de 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.
* import iCal
* export ICS
* génération de secrets d’export
* webhook iCal
* import manuel
* lancement manuel des synchronisations
* tâche cron Dolibarr dédiée
* journal de synchronisation
* diagnostic de flux
* contrôle iCal
* réparation / recréation de la tâche cron
* gestion des blocs externes


=== Canaux gérés ===
=== Paramètres WooCommerce ===


Le module gère plusieurs canaux selon le paramétrage, notamment :
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.


* Airbnb
=== Alertes et diagnostics ===
* Booking.com
* Website
* Google selon le contexte de synchronisation
* imports manuels
* blocages manuels


=== Contrôle iCal ===
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.


Une page dédiée permet de superviser le comportement iCal et de travailler sur les blocages.
== Utilisation quotidienne ==


Cette partie est utile pour :
=== Préparer les produits réservables ===


* comprendre l’origine d’une indisponibilité
# Créer ou sélectionner les produits Dolibarr concernés.
* contrôler les imports
# Les activer comme produits réservables dans Booking.
* gérer certains blocages / déblocages
# Définir les durées, capacités et règles de base.
* vérifier les historiques liés à la synchronisation
# Associer les ressources et services nécessaires.
# Ajouter les règles de disponibilité ou de prix.


== Intégration WordPress / WooCommerce / YITH ==
=== Créer une réservation interne ===


=== Principe général ===
# 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é.


Le scénario recommandé repose sur :
=== Suivre le planning ===


# réservation / commande côté WordPress
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.
# traitement commercial côté WooCommerce
# données de séjour issues du site ou d’un plugin de réservation type YITH
# transmission vers Dolibarr via le plugin '''WooBook'''
# création ou mise à jour des objets dans Dolibarr


=== Plugin WooBook fourni ===
=== Gérer les synchronisations ===


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


<code>pluginwoobook/woocommerce-dolibarr-sync.php</code>
=== Suivre les indicateurs ===


Ce plugin WordPress permet :
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.


* de configurer l’endpoint Dolibarr
== Notice technique publique ==
* de configurer le secret partagé
* de choisir les statuts WooCommerce à synchroniser
* de définir des mappings produits Woo -> Dolibarr
* de définir des mappings clients Woo -> tiers Dolibarr
* de transmettre les métadonnées utiles à la réservation


=== Informations transmises depuis WooCommerce ===
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.


Le flux peut transmettre notamment :
=== Architecture générale ===


* identifiant de commande Woo
Booking est construit comme un module externe Dolibarr standard. Il utilise les mécanismes natifs de Dolibarr pour :
* statut de commande
* client
* email
* identifiant client Woo
* lignes de commande
* produit Woo
* SKU
* dates de séjour
* nombre de personnes
* notes
* montants
* TVA
* métadonnées de ligne et de commande


=== Compatibilité avec YITH ===
* 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.


Le plugin WooBook est prévu pour reconnaître des métadonnées de réservation usuelles, y compris dans des contextes '''YITH'''.
=== Données gérées ===


Cela permet au module d’exploiter :
Le module s'appuie sur plusieurs ensembles de données :


* dates de début
* réservations ;
* dates de fin
* produits réservables ;
* informations de séjour
* ressources ;
* nombre de personnes
* 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.


sans imposer un unique schéma rigide côté WordPress.
=== Liaisons Dolibarr ===


=== Endpoints Dolibarr ===
Booking interagit avec plusieurs objets standards de Dolibarr :


Le point d’entrée principal de synchronisation Woo est :
* 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.


<code>custom/booking/syncwoocommande/receive.php</code>
Ces liaisons permettent de conserver Dolibarr comme référentiel central pour le suivi commercial, la facturation, les clients et les produits.


Le module propose également un endpoint de test :
=== Hooks ===


<code>custom/booking/syncwoocommande/ping.php</code>
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.


=== Sécurité de la synchronisation Woo ===
=== Triggers ===


La communication WooCommerce / Dolibarr est protégée via signature.
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.


Deux modes sont pris en charge :
=== Sécurité ===


* '''WooBook'''
Le module s'appuie sur plusieurs niveaux de sécurité :
* '''Webhook WooCommerce natif'''


Le module sait vérifier les signatures avant traitement.
* 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.


=== Résultat côté Dolibarr ===
=== Maintenance ===


Lorsqu’une commande Woo est synchronisée, le module peut :
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.


* créer ou mettre à jour le tiers
== Installation ==
* créer ou mettre à jour la commande Dolibarr
* rattacher les lignes au bon produit Dolibarr
* créer ou mettre à jour la réservation interne Booking
* associer la réservation à la commande
* mettre à jour les dates
* annuler la réservation si la commande Woo est annulée / remboursée / échouée
* libérer les blocs associés si nécessaire


=== Idempotence ===
# 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.


Le flux Woo a été conçu pour éviter la duplication.
== Droits utilisateurs ==


Si le même événement est rejoué :
Le module distingue plusieurs niveaux d'accès :


* le module tente de retrouver l’objet existant
* lecture des données de réservation ;
* il met à jour au lieu de recréer
* gestion des réservations ;
* il évite les doublons de commande et de réservation
* gestion des ressources ;
* gestion des services ;
* gestion des règles ;
* administration du module.


C’est un point important dans un environnement webhook réel.
Il est recommandé de limiter la configuration et les synchronisations aux administrateurs ou utilisateurs de confiance.


== Gestion métier des annulations ==
== Cas d'utilisation métier ==


Le module distingue la logique '''client''' et la logique '''interne'''.
=== Louer un gîte, une chambre ou un logement sans perdre le fil ===


La fenêtre d’annulation tardive configurée s’applique au contexte client selon les règles définies.
* 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.


En revanche, l’utilisateur interne autorisé ou l’administrateur peut conserver la capacité d’annuler depuis le back-office, selon les droits et les workflows métier en place.
=== Organiser la réservation de salles et d'espaces événementiels ===


Les annulations peuvent aussi être propagées depuis les documents commerciaux ou depuis la synchronisation Woo selon les cas.
* 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.


== Menus principaux du module ==
=== Piloter la location de matériel, véhicules ou équipements ===


Le module ajoute un menu principal '''Réservations''' avec plusieurs entrées fonctionnelles, notamment :
* é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.


* Tableau de bord
=== Centraliser une activité multi-canal dans Dolibarr ===
* Prendre une réservation
* Réservations
* Planning
* Ressources
* Prestations
* Produits réservables
* Règles
* Types de personnes
* Synchronisations / Partages
* Contrôle iCal
* Paramétrage


== Paramétrage ==
* 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.


=== Paramètres généraux ===
=== Planifier des prestations avec participants ou options ===


Ils permettent notamment de définir :
* 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.


* le comportement par défaut
== Bonnes pratiques ==
* la génération de documents
* la disponibilité par défaut
* la gestion des extrafields
* la synchronisation des documents Dolibarr
* les règles de modification
* la fenêtre d’annulation tardive
* certaines constantes globales du module


=== Paramétrage synchronisation ===
* 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.


Cette partie permet de gérer :
== Désinstallation ==


* les mappings canaux / produits
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.
* les imports iCal
* les exports ICS
* les secrets
* les tokens
* les diagnostics
* les logs
* les crons
* la conservation des données de configuration


=== Paramétrage WooCommerce Sync ===
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é.


Une page dédiée permet de configurer le lien WooCommerce / Dolibarr.
== FAQ ==


Elle permet notamment de définir :
=== Le module modifie-t-il le cœur de Dolibarr ? ===


* le mode d’authentification
Non. Booking est un module externe qui s'intègre via les mécanismes standards de Dolibarr.
* les secrets de communication
* l’URL de base Dolibarr
* les mappings produits Woo -> Dolibarr
* les mappings clients Woo -> Dolibarr
* certains comportements spécifiques comme l’ajout de ligne taxe de séjour
* les tests de connectivité
* le rappel des étapes côté WordPress


== Logs, maintenance et diagnostic ==
=== Peut-on utiliser Booking sans WooCommerce ? ===


Le module intègre plusieurs outils utiles pour l’exploitation :
Oui. Le module peut fonctionner uniquement en back-office Dolibarr pour saisir et suivre les réservations.


* journal de synchronisation
=== Peut-on synchroniser des calendriers externes ? ===
* test de connectivité Woo
* test import / export iCal
* réparation du cron iCal
* nettoyage d’orphelins
* outils de contrôle iCal
* correction de certains cas de désalignement de dates Woo / site
* supervision des statuts de synchronisation


== Cas d’usage typiques ==
Oui. Le module inclut une couche iCal / ICS pour importer ou exporter des périodes selon la configuration.


=== Hébergement / location saisonnière ===
=== Le module gère-t-il plusieurs chambres ou plusieurs lignes ? ===


* réservation sur site WordPress
Oui. Les versions récentes améliorent la gestion des réservations multi-lignes avec dates et nombres de personnes distincts.
* commande WooCommerce
* synchronisation vers Dolibarr
* réservation visible dans Booking
* planning mis à jour
* suivi commercial centralisé


=== Gestion d’espaces ou salles ===
=== Les réservations sont-elles liées aux devis ou commandes ? ===


* produits réservables par créneau
Oui. Selon le paramétrage, une réservation peut être liée à des documents commerciaux Dolibarr et les informations utiles peuvent être propagées.
* ressources affectées
* planning d’occupation
* règles de fermeture / ouverture
* documents commerciaux liés


=== Activité avec canaux externes ===
=== Les données sont-elles supprimées à la désactivation ? ===


* import iCal depuis plateformes externes
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.
* gestion de blocs externes
* réduction du risque de double réservation
* visibilité unifiée dans le planning Dolibarr


== Résumé ==
== Résumé ==


Booking pour Dolibarr est un module complet de gestion de réservation orienté exploitation interne.
Booking pour Dolibarr transforme Dolibarr en outil central de gestion des réservations et locations.
 
Il permet de :


* structurer l’offre réservable
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.
* centraliser les réservations
* relier la réservation au client et au document commercial
* piloter un planning opérationnel
* gérer ressources, prestations et règles
* synchroniser des flux iCal
* intégrer proprement un site WordPress / WooCommerce / YITH via le plugin WooBook fourni


Le module s’adresse aux structures qui souhaitent faire de Dolibarr le point central de leur organisation, tout en conservant un site web dédié à la vente et à la réservation.
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.
KSI
211

edits

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

Navigation menu