KSI: Création de la documentation DoliLocation

2026-11-06T09:55:25Z

Création de la documentation DoliLocation

New page

[[Category:Modules complémentaires]]

=DoliLocation=

==Présentation==

{| class="wikitable"
|-
!Module
!DoliLocation
|-
!Version
!1.0.3
|-
!Dolibarr
!18 → 24
|-
!PHP
!7.4+ (exécution éprouvée 8.1 → 8.3)
|-
!Licence
!GNU GPLv3
|-
!Éditeur / Publisher
![https://www.ksidol.io KSIDol.io]
|}

DoliLocation (nom technique '''ksilocation''', version '''1.0.3''') ajoute à Dolibarr la gestion d'une activité de location : parc, disponibilité, chiffrage, contrats, états des lieux, livraisons et retours, caution et dommages. Le module se greffe sur les pièces et les écrans natifs plutôt que d'ouvrir un second logiciel à côté de l'ERP.

Le livrable comprend '''166 fichiers dont 94 en PHP''', '''45 écrans''', '''30 tables''', '''10 droits''' et '''725 clés de traduction par langue''', en '''5 langues''' : français, anglais, allemand, espagnol, italien. Éditeur : KSI 30. Licence : GPL v3.

== Les 10 métiers préréglés ==

* engins et matériel de chantier
* événementiel et réception
* véhicules
* audiovisuel, son et lumière
* mobilité douce (vélos, trottinettes)
* salles et espaces
* remorques et utilitaires légers
* matériel médical et paramédical
* informatique et bureautique
* textile, vaisselle et réception légère

Ces dix préréglages ne sont que des points de départ : les 18 capacités se combinent librement, pour adapter DoliLocation à '''bien plus de dix''' façons de louer selon l'activité réelle.

== Moteur de disponibilité et chiffrage ==

* '''intervalles semi-ouverts''' : un retour et un départ peuvent se succéder le même jour
* délais de préparation et de remise en état pris dans le calcul
* options temporaires qui expirent d'elles-mêmes
* confirmation transactionnelle : deux confirmations simultanées ne peuvent pas sur-réserver la même capacité
* chiffrage par durées, paliers et saisons, avec un '''instantané tarifaire figé sur le contrat''' : une évolution ultérieure des tarifs ne modifie plus un dossier engagé
* tenue en charge mesurée sur '''1 000 unités de parc et 1 000 dossiers confirmés'''

== Le module vit dans Dolibarr : les 8 onglets intégrés ==

* '''Fiche produit''', onglet « Location » : rend l'article louable, fixe son unité de temps et sa durée minimale, affiche l'historique de ses locations — le catalogue natif reste le seul référentiel.
* '''Fiche tiers''', onglet « Locations » : tous les dossiers du client, en cours et passés — l'historique est sous les yeux pendant l'appel.
* '''Devis''' (proposition commerciale), onglet « Location » : les périodes portées par les lignes, avec la signature électronique du cœur de Dolibarr, horodatée et archivée — l'accord reste attaché à la pièce qui l'a produit.
* '''Commande''', onglet « Location » : le dossier adossé à la commande native, sans double saisie — ce qui est vendu et ce qui est réservé ne divergent plus.
* '''Expédition''', onglet « Location » : la livraison et l'enlèvement du matériel — départ et retour se préparent depuis la pièce logistique habituelle.
* '''Entrepôt''', onglet « Location » : ce que le dépôt contient et ce qui en est sorti — le comptoir connaît la disponibilité réelle.
* '''Utilisateur''', onglet « Location » : ce dont l'intervenant a la charge — chacun voit son périmètre.
* '''Projet''', onglet « Location » : les dossiers rattachés au chantier ou à l'événement — le coût de location se lit là où le projet est suivi.

== Les 6 modèles de document imprimables ==

* contrat de location
* bon de sortie et de retour
* état des lieux (un seul modèle, employé au départ et au retour)
* constat de dommage
* attestation de caution
* feuille de route de tournée

== Les 18 capacités activables ==

Posées automatiquement au choix du métier, puis ajustables une par une : devis préalable; dossier de chantier ou d'événement; livraison et enlèvement; tournées; unités identifiées; compteurs (kilomètres, heures); états des lieux départ et retour; caution ou dépôt de garantie; dommages et retenues; assurance; franchise; carburant et consommables; nettoyage et hygiène; permis et habilitations; sous-location; caisse comptoir; mini-site public; canaux boutique.

== Ce qui est inclus ==

Le module complet et ses '''3 tâches planifiées''' (libérer les options expirées, reprendre les livraisons de canal en échec, contrôler l'intégrité du journal des locations); le comptoir qui identifie un article à partir d'un code scanné (code-barres, numéro de série); la logistique et les tournées; le mini-site public de réservation; la couche de canaux; l'API REST; le journal des opérations en ajout seul, à chaîne d'empreintes. Les connecteurs compagnons '''WooCommerce''' (extension WordPress) et '''PrestaShop 8''' (module) sont compris dans le prix et livrés séparément. Prix unique : '''425 € HT'''.

Pièces natives créées : devis, commande, projet, et expédition '''en brouillon'''.

== Ce qui n'est pas inclus ==

* la caution est '''enregistrée et non encaissée''' : aucune écriture comptable sans retenue motivée
* aucun mouvement de stock involontaire : les expéditions naissent en brouillon
* les numéros de série s'appuient sur les lots et séries '''natifs''' de Dolibarr
* les moteurs de base autres que MariaDB 10.11 ne sont pas éprouvés; PHP hors 8.1-8.3 ne l'est pas à l'exécution

== Compatibilité et prérequis ==

Dolibarr '''18.0.6 à 24.0.2''', éprouvé palier par palier sur '''7 versions''' : '''18.0.6''', '''19.0.4''', '''20.0.4''', '''21.0.4''', '''22.0.5''', '''23.0.4''' et '''24.0.2''', avec '''799 contrôles verts par palier''' et aucun échec. '''PHP 8.1 à 8.3''' éprouvé à l'exécution. Base : '''MariaDB 10.11''', seul moteur éprouvé.

==Installation==

===Prérequis===

*Dolibarr 18 → 24
*PHP 7.4+ (exécution éprouvée 8.1 → 8.3)
*Un compte administrateur Dolibarr pour l’activation et la configuration

===Installation===

#Décompressez l’archive du module.
#Copiez le dossier du module dans <code>htdocs/custom/</code>.
#Depuis Dolibarr, ouvrez Accueil → Configuration → Modules/Applications, puis activez le module.
#Attribuez les permissions nécessaires aux utilisateurs ou groupes concernés.
#Ouvrez la page de configuration du module et contrôlez les réglages avant la mise en service.

==Mise à jour==

Avant une mise à jour, sauvegardez la base de données et les documents Dolibarr. Remplacez ensuite le dossier du module par la nouvelle version, puis ouvrez sa page de configuration pour appliquer les éventuelles migrations.

==Droits et permissions==

Les accès sont gérés par les permissions Dolibarr. Accordez uniquement les droits nécessaires à chaque rôle métier.

== Support et achat ==

Achat sur la boutique https://www.ksidol.io · support et questions avant achat : https://www.ksidol.io/contact

== Liens officiels ==
* Vidéo de démonstration : [https://youtu.be/JbrEZpLwEas DoliLocation — démo (YouTube)]
* Fiche du module : [https://www.ksidol.io/fr/modules/detail?module=main_module_ksilocation DoliLocation sur KSIDol]
* Démonstration en ligne : [https://www.ksidol.io/t/demo-location/ DoliLocation — ouvrir la démo]
* Notice du module : [https://www.ksidol.io/notices/ksidol_notice_fr/ksilocation.html DoliLocation — consulter la notice]

DoliLocation – Location de matériel pour Dolibarr - Revision history

KSI: Création de la documentation DoliLocation