KSI: Mise à jour des liens officiels : vidéo, fiche KSIDol, démo et notice

2026-10-19T16:08:10Z

Mise à jour des liens officiels : vidéo, fiche KSIDol, démo et notice

← Older revision		Revision as of 16:08, 19 October 2026
Line 556:		Line 556:

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

			== Liens officiels ==
			* Vidéo de démonstration : [https://youtu.be/JduaIeWMf0U Booking — démo (YouTube)]
			* Fiche du module : [https://www.ksidol.io/fr/modules/detail?module=main_module_booking Booking sur KSIDol]
			* Démonstration en ligne : [https://www.ksidol.io/t/demo-booking/custom/booking/index.php?mainmenu=booking&leftmenu=booking_main Booking — ouvrir la démo]
			* Notice du module : [https://www.ksidol.io/notices/ksidol_notice_fr/booking.html Booking — consulter la notice]

KSI: /* Présentation */

2026-07-26T05:46:20Z

Présentation

← Older revision		Revision as of 05:46, 26 July 2026
Line 29:		Line 29:

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

			== Vidéo de démonstration ==
			[https://youtu.be/JduaIeWMf0U Booking — Réservations et locations pour Dolibarr (démo YouTube)]

	== Éditeur et support ==		== Éditeur et support ==

KSI at 11:30, 3 May 2026

2026-05-03T11:30:54Z

Show changes

KSI: 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..."

2026-03-17T19:03:03Z

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..."

New page

= Booking pour Dolibarr =

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

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é.

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.

== Positionnement actuel du module ==

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

Le fonctionnement cible actuel repose sur :

* '''WordPress''' pour le site public
* '''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.

== Disponibilité DoliStore ==

Le module est distribué via DoliStore.

Lien éditeur K.S.I :
[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 ==

Booking répond à plusieurs besoins :

* centraliser les réservations dans Dolibarr
* 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é ==

* '''Dolibarr''' : v19 à v23
* '''PHP''' : PHP 8.x
* '''Type d’installation''' : module externe dans <code>htdocs/custom</code>
* '''Aucune modification du core Dolibarr'''

== Fonctionnalités principales ==

=== 1. Gestion des produits réservables ===

Le module permet de transformer des produits du catalogue Dolibarr en '''produits réservables'''.

Pour chaque produit réservable, il est possible de définir notamment :

* son activation dans Booking
* sa capacité
* sa granularité de réservation
* ses durées minimales et maximales
* 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.

=== 2. Prise de réservation en back-office ===

Le module propose un écran '''Prendre une réservation''' permettant à un utilisateur interne de créer une réservation depuis Dolibarr.

La réservation peut être liée à :

* un tiers existant
* un produit réservable
* une période d’arrivée / départ
* un nombre de personnes
* une catégorie de location
* des prestations complémentaires
* une note publique ou interne

Selon le paramétrage, cette action peut générer :

* un '''devis'''
* ou une '''commande'''

Les informations de réservation sont propagées sur les documents commerciaux via les mécanismes du module.

=== 3. Liste des réservations ===

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

Cette vue permet notamment :

* de filtrer les réservations
* de consulter les dates
* d’identifier le client
* de voir le document d’origine
* 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 ===

Le planning est l’un des éléments centraux du module.

Il permet :

* de visualiser l’occupation par période
* de filtrer par ressource
* de naviguer par jour, mois ou année
* de voir les réservations internes
* 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.

=== 5. Gestion des ressources ===

Le module gère des '''ressources''' pouvant être affectées aux réservations :

* chambres
* 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.

=== 6. Gestion des prestations ===

Le module gère des '''prestations optionnelles''' liées aux réservations.

Exemples :

* ménage
* 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.

=== 7. Types de personnes ===

Le module inclut la gestion des '''types de personnes''' afin d’adapter certaines règles à la composition du séjour.

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.

=== 8. Règles de disponibilité et de tarification ===

Booking intègre un système de règles qui permet d’adapter le comportement du module selon le contexte.

Les règles peuvent porter sur :

* la disponibilité
* la fermeture / ouverture des réservations
* la tarification
* les restrictions
* certaines catégories
* certaines ressources
* certaines prestations
* certains types de personnes
* certaines périodes
* certains jours de semaine
* certaines plages horaires

Le moteur permet notamment :

* d’ouvrir ou fermer des périodes
* 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 ===

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

Les indicateurs disponibles couvrent notamment :

* le taux d’occupation
* 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.

== Synchronisations iCal ==

=== Objectif ===

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

Cela permet par exemple de :

* récupérer des périodes occupées depuis des canaux externes
* 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 ===

Le module propose :

* configuration des canaux de synchronisation
* 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 ===

Le module gère plusieurs canaux selon le paramétrage, notamment :

* Airbnb
* Booking.com
* Website
* Google selon le contexte de synchronisation
* imports manuels
* blocages manuels

=== Contrôle iCal ===

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

Cette partie est utile pour :

* comprendre l’origine d’une indisponibilité
* contrôler les imports
* gérer certains blocages / déblocages
* vérifier les historiques liés à la synchronisation

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

=== Principe général ===

Le scénario recommandé repose sur :

# réservation / commande côté WordPress
# 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 ===

Le module inclut le plugin :

<code>pluginwoobook/woocommerce-dolibarr-sync.php</code>

Ce plugin WordPress permet :

* de configurer l’endpoint Dolibarr
* 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 ===

Le flux peut transmettre notamment :

* identifiant de commande Woo
* 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 ===

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

Cela permet au module d’exploiter :

* dates de début
* dates de fin
* informations de séjour
* nombre de personnes

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

=== Endpoints Dolibarr ===

Le point d’entrée principal de synchronisation Woo est :

<code>custom/booking/syncwoocommande/receive.php</code>

Le module propose également un endpoint de test :

<code>custom/booking/syncwoocommande/ping.php</code>

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

La communication WooCommerce / Dolibarr est protégée via signature.

Deux modes sont pris en charge :

* '''WooBook'''
* '''Webhook WooCommerce natif'''

Le module sait vérifier les signatures avant traitement.

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

Lorsqu’une commande Woo est synchronisée, le module peut :

* créer ou mettre à jour le tiers
* 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 ===

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

Si le même événement est rejoué :

* le module tente de retrouver l’objet existant
* il met à jour au lieu de recréer
* il évite les doublons de commande et de réservation

C’est un point important dans un environnement webhook réel.

== Gestion métier des annulations ==

Le module distingue la logique '''client''' et la logique '''interne'''.

La fenêtre d’annulation tardive configurée s’applique au contexte client selon les règles définies.

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.

Les annulations peuvent aussi être propagées depuis les documents commerciaux ou depuis la synchronisation Woo selon les cas.

== Menus principaux du module ==

Le module ajoute un menu principal '''Réservations''' avec plusieurs entrées fonctionnelles, notamment :

* Tableau de bord
* 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 ==

=== Paramètres généraux ===

Ils permettent notamment de définir :

* le comportement par défaut
* 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 ===

Cette partie permet de gérer :

* les mappings canaux / produits
* 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 ===

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

Elle permet notamment de définir :

* le mode d’authentification
* 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 ==

Le module intègre plusieurs outils utiles pour l’exploitation :

* journal de synchronisation
* 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 ==

=== Hébergement / location saisonnière ===

* réservation sur site WordPress
* commande WooCommerce
* synchronisation vers Dolibarr
* réservation visible dans Booking
* planning mis à jour
* suivi commercial centralisé

=== Gestion d’espaces ou salles ===

* produits réservables par créneau
* ressources affectées
* planning d’occupation
* règles de fermeture / ouverture
* documents commerciaux liés

=== Activité avec canaux externes ===

* import iCal depuis plateformes externes
* gestion de blocs externes
* réduction du risque de double réservation
* visibilité unifiée dans le planning Dolibarr

== Résumé ==

Booking pour Dolibarr est un module complet de gestion de réservation orienté exploitation interne.

Il permet de :

* structurer l’offre réservable
* 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.

Gestion de locations et réservations - Revision history

KSI: Mise à jour des liens officiels : vidéo, fiche KSIDol, démo et notice

KSI: /* Présentation */

KSI at 11:30, 3 May 2026

KSI: 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..."