View source for Module Gestion des véhicules

[[en:Module Vehicle Management]]
[[it:Modulo Gestione dei veicoli]]
[[de:Modul Fahrzeugverwaltung]]
[[es:Módulo Gestión de vehículos]]

'''Gestion des véhicules et engins''' est un module externe pour Dolibarr permettant de centraliser le suivi d'un parc de véhicules routiers, d'utilitaires et d'engins. Il regroupe les caractéristiques du matériel, les affectations des conducteurs, les kilométrages, les consommations, les interventions, les assurances et les contrôles réglementaires.

Le module permet également de relier les factures fournisseurs aux interventions et aux contrôles, puis de générer un dossier véhicule réunissant un récapitulatif PDF et une archive des documents associés. L’intégration QUARTIX QWS v2 ajoute les estimations kilométriques, les synthèses d’utilisation, les positions, les trajets et leur visualisation sur carte.

Cette page comprend la présentation du module, son installation et sa '''notice d'utilisation illustrée'''. Les captures ont été réalisées les 5 et 7 septembre 2026 sur une instance de démonstration Dolibarr 24 avec Multicompany. Les adresses et plaques d’immatriculation sont floutées. Les valeurs affichées servent uniquement d'exemples ; elles ne constituent ni des réglages recommandés ni des références de consommation. Le thème et la version de Dolibarr peuvent faire varier la présentation.

Documentation actualisée le 7 septembre 2026. Le développement QUARTIX complète la version 1.0.0 ; les anciennes archives portant ce numéro peuvent ne pas l’inclure. Le logiciel fournit le français et l’anglais. Les traductions EN, IT, DE et ES de cette notice ne modifient ni les langues du logiciel ni le catalogue réglementaire français.

__TOC__

==Informations==

{| class="wikitable"
!Information!!Valeur
|-
|Nom||Gestion des véhicules et engins
|-
|Identifiant technique||<code>lmdbvehiclemanagement</code>
|-
|Auteur||Pierre Ardoin
|-
|Famille||Les Métiers du Bâtiment
|-
|Version présentée||1.0.0 — première version stable du 4 septembre 2026
|-
|Dolibarr minimum||20.0
|-
|PHP minimum||8.0
|-
|Base de données||MySQL ou MariaDB
|-
|Langues fournies||Français et anglais
|-
|Multicompany||Compatible ; module Multicompany facultatif
|-
|Licence||GNU GPL version 3 ou ultérieure
|}

==Fonctionnalités==

===Gestion du parc===

*Fiches pour les véhicules routiers, utilitaires et engins, avec immatriculation facultative.
*Caractéristiques techniques, énergie, capacités et autonomie WLTP.
*Suivi du cycle de vie, du brouillon à la cession.
*Affectations des conducteurs, avec plusieurs affectations simultanées possibles et une seule affectation principale par période.
*Relevés kilométriques et prise en charge des corrections ou remplacements de compteur.
*Événements d'entretien, pannes et incidents.
*Chronologie regroupant événements, contrôles et consommations.
*Modèles de numérotation, dont un modèle fondé sur l'immatriculation.

Les listes proposent des filtres, le tri, la pagination et des colonnes personnalisables. Les fiches utilisent les notes, contacts, fichiers joints et objets liés de Dolibarr selon les fonctions concernées.

===Pleins, recharges et consommations===

Le module suit les carburants, les recharges électriques, l'hydrogène et les additifs. Les consommables sont associés à leurs unités et aux énergies compatibles. Les capacités du véhicule permettent de signaler un dépassement lors de la saisie.

*Synchronisation des consommations avec les relevés kilométriques.
*Synthèses par véhicule, consommable et unité.
*Statistiques de coûts, distances et consommations, avec graphiques Dolibarr.
*Import CSV et export natif.
*Prix facultatif pour les additifs<span> </span>: un montant absent est distingué d'un montant égal à zéro et n'entre pas dans les statistiques de prix.

Une option par entité permet de créer une '''opération diverse''' native pour un plein ou une recharge. Elle nécessite un compte bancaire, les informations de règlement et un justificatif PDF, JPEG ou PNG. Les métadonnées des images justificatives sont nettoyées.

La comptabilité reste facultative. En comptabilité en partie double, un compte général du plan actif est requis. Les données financières et le justificatif sont verrouillés après rapprochement bancaire ou transfert comptable.

'''Lorsque la création d'opérations diverses est activée, l'import CSV des consommations est indisponible.''' L'activation de cette option ne crée pas d'opérations pour les consommations historiques.

===Assurances===

*Contrats individuels ou contrats de flotte couvrant plusieurs véhicules.
*Couverture principale et couvertures complémentaires.
*Contacts de l'assureur et du courtier.
*Attestations communes ou propres à un véhicule, avec justificatifs, validation, rejet et archivage.
*Référents utilisateurs ou groupes et personnels affectés éligibles.
*Relances avant et après échéance, avec modèles d'emails et travaux planifiés natifs.

===Contrôles réglementaires===

Un questionnaire guidé permet de qualifier les véhicules et engins et de déterminer les exigences applicables à partir des informations enregistrées.

La version 1.0.0 fournit un catalogue français versionné couvrant notamment les contrôles routiers, la pollution, la catégorie L, les usages spécialisés, les vérifications générales périodiques (VGP), la mise ou remise en service, le tachygraphe, l'ADR et l'ATP. Des surcharges par entité et des règles personnalisées complètent le catalogue.

*Contrôles numérotés avec organisme, résultat, dates et justificatif obligatoire.
*Validation immuable, annulation motivée, remplacement, contre-visite et archivage encadré.
*Échéancier et registre de sécurité.
*Export et import de contrôles en brouillon.
*Blocage configurable des nouvelles affectations et mises en service.
*Recalcul quotidien et rappels par travail planifié, avec événement Agenda unique par exigence.

Lorsqu'une information indispensable manque, le module ne calcule pas d'échéance arbitraire. Il constitue une aide au suivi documentaire<span> </span>: il ne réalise pas les contrôles et ne délivre aucun rapport officiel.

===Factures fournisseurs liées===

Depuis un événement ou un contrôle, l'action '''Créer une facture fournisseur''' ouvre le formulaire natif Dolibarr. Le fournisseur de l'intervention est proposé lorsqu'il est renseigné et accessible ; il peut être modifié. La facture est créée en brouillon et liée à l'objet d'origine.

Il est également possible de sélectionner une facture existante ou d'utiliser l'action '''Lier à''' depuis une facture fournisseur. Les relations sont visibles dans les blocs '''Objets liés''' des deux fiches. Plusieurs factures peuvent être associées à une même intervention.

Une déliaison retire uniquement la relation. Elle ne supprime pas la facture et ne modifie pas les données réglementaires d'un contrôle validé. Les objets liés doivent appartenir à l'entité courante et les droits requis sur chacun d'eux restent nécessaires.

===Dossier véhicule PDF et ZIP===

Le modèle '''Dossier véhicule''' produit deux fichiers<span> </span>:

*un '''PDF''' regroupant les caractéristiques du véhicule, la chronologie disponible, les événements, les contrôles, les factures liées, une synthèse des pleins et recharges et l'inventaire documentaire ;
*un '''ZIP''' contenant ce PDF et les fichiers originaux du véhicule, des événements, des contrôles et des factures liées.

Les brouillons, annulations et archives sont inclus. Une facture liée à plusieurs interventions n'est embarquée qu'une fois. Les fichiers indexés mais absents sont signalés dans le PDF.

Les justificatifs des consommations et de leurs opérations diverses, les fichiers temporaires, les aperçus et les dossiers précédents sont exclus de l'archive. Le tableau de synthèse des consommations présente les dates, kilométrages, références, consommables, natures, unités et références d'huile ; il ne présente ni les quantités ni les montants.

La génération utilise les données et documents déjà disponibles<span> </span>: elle ne génère pas les documents commerciaux des factures et ne reconstitue pas un historique non enregistré.

La génération nécessite les droits de lecture et d'écriture du véhicule ainsi que la lecture des factures fournisseurs. La consultation du dossier nécessite les droits cumulés de lecture correspondants. Le dossier n'est pas accessible aux utilisateurs externes ni par lien public.

===Gestion multientité===

Avec Multicompany, les objets partageables sont configurables dans les réglages natifs de partage. Les listes concernées affichent un filtre et une colonne '''Environnement'''.

Les documents restent stockés dans l'entité propriétaire de l'objet, y compris lorsqu'il est consulté depuis une autre entité autorisée. Les réglages par entité, modèles et choix de partage sont conservés lors d'une désactivation puis réactivation du module.

==Prérequis et dépendances==

Le socle requis est Dolibarr 20 ou supérieur, PHP 8.0 ou supérieur et MySQL/MariaDB. Les dépendances supplémentaires varient selon les fonctions utilisées.

{| class="wikitable"
!Module ou extension!!Utilisation
|-
|Agenda||Échéances et événements ; recommandé pour le suivi automatique.
|-
|Travaux planifiés||Exécution périodique des recalculs et relances.
|-
|Banques et Caisses||Requis pour créer les opérations diverses des consommations.
|-
|Comptabilité||Facultative ; règles de compte adaptées au mode comptable actif.
|-
|Factures fournisseurs||Requis pour les liaisons de factures et les dossiers véhicule.
|-
|Extension PHP ZIP (<code>ZipArchive</code>)||Requise pour générer le dossier PDF/ZIP.
|-
|Multicompany||Facultatif ; partage et gestion de plusieurs entités.
|-
|Ressources||Facultatif ; liaison à une ressource Dolibarr.
|}

L'onglet '''Compatibilité''' des réglages indique les dépendances et fonctionnalités disponibles dans l'environnement courant.

==Installation==

#Récupérer une distribution du module correspondant à la version 1.0.0.
#Placer le répertoire <code>lmdbvehiclemanagement</code> dans le répertoire des modules externes de l'installation Dolibarr. Les fichiers du module doivent se trouver directement dans ce répertoire, sans second répertoire imbriqué du même nom.
#Se connecter à Dolibarr avec un compte administrateur.
#Ouvrir '''Accueil → Configuration → Modules/Applications'''.
#Rechercher et activer '''Gestion des véhicules et engins''', dans la famille '''Les Métiers du Bâtiment'''.
#Ouvrir les réglages avec la roue dentée du module et consulter l'onglet '''Compatibilité'''.
#Attribuer aux utilisateurs et groupes les permissions correspondant à leurs fonctions.

Si une archive de déploiement Dolibarr est fournie, elle peut être installée depuis l'écran natif de déploiement des modules externes.

==Configuration initiale==

#Vérifier les dictionnaires utiles au parc<span> </span>: énergies, consommables, types de matériel, profils, types et résultats de contrôles.
#Choisir les modèles de numérotation des objets.
#Configurer les options d'assurance, les référents et les modèles d'emails de relance.
#Vérifier les règles réglementaires et les options de blocage souhaitées.
#Dans les '''Travaux planifiés''' de Dolibarr, vérifier et activer les traitements nécessaires aux recalculs et aux rappels automatiques.
#Si les opérations diverses sont utilisées, configurer cette option et ses paramètres bancaires dans chaque entité concernée.
#Pour les dossiers véhicule, activer '''Dossier véhicule''' dans le bloc '''Modèles de document''' et, si souhaité, le choisir comme modèle par défaut.
#En environnement Multicompany, configurer les partages et les permissions d'accès aux entités.

Les onglets '''Compatibilité''' et '''À propos''' sont accessibles depuis les réglages du module.

===Choisir la numérotation et activer le dossier véhicule===

#Ouvrir l'onglet '''Paramètres''' des réglages.
#Dans '''Modèles de documents''', activer la ligne '''Dossier véhicule'''. La colonne '''Défaut''' permet de le proposer automatiquement lors de la génération.
#Dans '''Modèles de numérotation''', choisir le modèle de chaque objet.
#Pour les véhicules, choisir '''standard''' pour une référence séquentielle ou '''registration''' pour utiliser l'immatriculation normalisée. Un matériel sans immatriculation reçoit une référence de type MAT avec ce dernier modèle.

Les exemples de référence permettent de vérifier le résultat attendu. Sur un parc existant, un changement impliquant la reprise des références doit suivre la procédure de migration proposée par le module.

[[File:LMDBVehicleManagement-2026-09-15-modeles-anonymise.png|thumb|center|1100px|Réglages des modèles documentaires et de la numérotation. Le dossier est activé ; le choix du modèle par défaut est distinct.]]

===Configurer les dépenses des pleins et recharges===

Dans '''Paramètres''', le bloc '''Tickets et opérations diverses des pleins / recharges''' permet d'activer la création d'une dépense native.

#Choisir le compte bancaire de l'entité et le mode de règlement habituel.
#Renseigner les comptes comptables selon le mode de comptabilité utilisé. Le compte général est obligatoire en partie double ; le compte auxiliaire reste facultatif.
#Activer l'option souhaitée et cliquer sur '''Enregistrer'''.
#Vérifier ensuite la saisie d'un plein<span> </span>: les informations de règlement et le ticket sont demandés lorsque cette option est active.

Cette option concerne les nouvelles opérations. Elle ne transforme pas les anciennes consommations en dépenses et rend leur import CSV indisponible.

===Configurer les relances d'assurance===

#Ouvrir l'onglet '''Assurance''' des réglages.
#Choisir les utilisateurs et/ou groupes référents.
#Indiquer si les personnels affectés doivent être inclus, puis sélectionner les types d'affectation concernés.
#Sélectionner les seuils avant expiration et les délais de répétition après expiration ou absence de justificatif.
#Choisir les modèles d'emails de dépôt et de contrôle.
#Activer les relances et cliquer sur '''Enregistrer'''.
#Utiliser le lien '''Ouvrir les travaux planifiés''' pour vérifier l'état de la tâche et son dernier résultat.

Le bouton '''Envoyer un email de test''' déclenche un envoi réel<span> </span>: vérifier les destinataires avant de l'utiliser. Les délais visibles sur l'illustration sont ceux de l'environnement de démonstration.

[[File:LMDBVehicleManagement-1.0.0-16-relances-assurance.jpg|thumb|center|1100px|Choix des référents, seuils de relance, modèles d'emails et accès au travail planifié d'assurance.]]

===Configurer les rappels des contrôles===

Dans l'onglet '''Contrôles réglementaires''' des réglages<span> </span>:

#Choisir les horizons de rappel et le délai d'affichage « à échéance prochaine ».
#Sélectionner les utilisateurs ou groupes destinataires et préciser si le conducteur affecté doit être inclus.
#Choisir le modèle de rappel et, si nécessaire, activer les rappels journaliers après échéance.
#Enregistrer les réglages puis vérifier le travail planifié de recalcul et de rappel.

Le catalogue distingue les règles natives des adaptations propres à l'entité. Les surcharges et règles personnalisées doivent correspondre au matériel réellement exploité et conserver leur justification.

==Notice — premiers pas==

===Accéder au parc et retrouver une fiche===

Ouvrir le menu '''Gestion des véhicules et engins''' repéré par une icône de voiture. Le menu latéral regroupe le parc, les événements, les contrôles, la consommation et les contrats d'assurance.

#Cliquer sur '''Liste des véhicules et engins'''.
#Saisir un critère dans les filtres de référence, immatriculation, libellé, modèle ou état.
#Cliquer sur la loupe pour rechercher ; la croix réinitialise les filtres.
#Cliquer sur un en-tête de colonne pour trier, ou sur le sélecteur de colonnes pour adapter la liste.
#Ouvrir le véhicule en cliquant sur sa référence.

Le sélecteur de limite règle le nombre de lignes par page. Lorsqu'un partage multientité est actif, la colonne et le filtre '''Environnement''' permettent d'identifier l'entité d'origine.

[[File:LMDBVehicleManagement-2026-09-01-liste-anonymise.png|thumb|center|1100px|Accès aux rubriques du module et recherche dans le parc de démonstration.]]

===Créer un véhicule ou un engin===

#Cliquer sur '''Nouveau véhicule ou engin'''.
#Renseigner un '''Libellé''' explicite et l'immatriculation si le matériel en possède une.
#Choisir le '''Type principal de matériel''', puis compléter les caractéristiques connues<span> </span>: catégorie, genre, masses, nombre de places, territoire, numéro de série, marque et modèle.
#Choisir l'énergie et renseigner l'autonomie lorsqu'elle est connue.
#Compléter les dates de construction, première immatriculation et mise en service selon les informations disponibles.
#Choisir le mode de détention et le propriétaire. La liaison à une ressource Dolibarr est facultative.
#Compléter la description et cliquer sur '''Enregistrer''' en bas du formulaire.

La fiche est créée en brouillon. La référence suit le modèle de numérotation configuré ; il n'est pas nécessaire de fabriquer un identifiant manuellement. Compléter ensuite les capacités des consommables utiles au véhicule depuis sa fiche en modification.

[[File:LMDBVehicleManagement-1.0.0-03-creation.jpg|thumb|center|1100px|Partie supérieure du formulaire de création<span> </span>: identification, caractéristiques techniques et dates.]]

===Lire la fiche et son état===

La fiche présente la référence, le libellé et un badge d'état, puis les caractéristiques techniques et la couverture d'assurance disponible. Les onglets donnent accès aux notes, documents, événements, affectations, kilométrages, consommations, contrôles et historique selon les droits.

[[File:LMDBVehicleManagement-2026-09-02-fiche-anonymise.png|thumb|center|1100px|Extrait de la fiche d'un véhicule en service<span> </span>: caractéristiques, capacités et résumé d'assurance.]]

{| class="wikitable"
!État!!Utilisation
|-
|Brouillon||Préparer et vérifier la fiche avant validation.
|-
|Validé||Véhicule identifié et validé, avant sa mise en service.
|-
|En service||Matériel utilisé dans le parc.
|-
|Hors service||Matériel retiré de l'exploitation.
|-
|Cédé / vendu||Matériel sorti du parc à la suite d'une cession.
|}

Utiliser les actions proposées sur la fiche, notamment '''Valider''', '''Mettre en service''', '''Mettre hors service''' ou '''Céder / vendre''', selon l'état courant et les permissions. Les règles réglementaires peuvent empêcher une mise en service. Une sortie de parc doit être enregistrée par le changement d'état approprié afin de conserver son historique ; la suppression répond à un autre besoin.

==Notice — utilisation quotidienne==

===Affecter un conducteur===

#Ouvrir l'onglet '''Affectations''' du véhicule.
#Cliquer sur '''Ajouter une affectation'''.
#Sélectionner le conducteur et renseigner la date et l'heure de début.
#Renseigner une fin lorsqu'elle est connue, puis le type d'affectation.
#Préciser s'il s'agit de l'affectation principale, choisir son état et compléter le motif utile.
#Cliquer sur '''Enregistrer'''.

Plusieurs affectations peuvent coexister, mais une seule peut être principale sur une même période. Pour terminer une affectation, ouvrir sa modification avec le crayon et renseigner sa fin et son état. Vérifier le résultat dans le tableau.

[[File:LMDBVehicleManagement-2026-09-04-affectations-anonymise.png|thumb|center|1100px|Liste des affectations<span> </span>: conducteur, période, type, caractère principal et état.]]

===Ajouter ou corriger un relevé kilométrique===

#Ouvrir l'onglet '''Kilométrage''' et cliquer sur '''Ajouter un relevé'''.
#Renseigner la date du relevé et la valeur constatée au compteur.
#Choisir la nature du relevé. Pour une correction ou un remplacement de compteur, compléter le motif correspondant.
#Enregistrer, puis vérifier l'ordre chronologique et la différence avec les autres relevés.

'''Un relevé créé par un plein ou une recharge se corrige depuis la fiche de cette consommation.''' L'icône d'information de la ligne le rappelle. Éviter d'ajouter un second relevé manuel pour corriger la même opération.

[[File:LMDBVehicleManagement-2026-09-05-kilometrage-anonymise.png|thumb|center|1100px|Relevés kilométriques avec date, différence et source. Les lignes issues des consommations sont gérées depuis leur fiche d'origine.]]

===Enregistrer un plein, une recharge ou un additif===

#Cliquer sur '''Nouveau plein / recharge''' dans le menu latéral.
#Renseigner la date et l'heure, puis sélectionner le véhicule.
#Choisir la '''Nature''' et le carburant, la recharge ou l'additif correspondant. Compléter la référence d'huile lorsqu'elle est demandée.
#Vérifier le conducteur, saisir la quantité dans l'unité proposée et le kilométrage du compteur.
#Saisir le '''Total TTC'''. Pour un additif dont le prix est inconnu, laisser le montant vide ; zéro signifie un prix connu égal à zéro.
#Choisir le projet si nécessaire. Lorsque les opérations diverses sont actives, vérifier le règlement et joindre le ticket PDF, JPEG ou PNG.
#Conserver un relevé standard pour une saisie ordinaire ; justifier une correction ou un remplacement de compteur si c'est le cas.
#Cliquer sur '''Enregistrer''' et vérifier la fiche obtenue.

Un avertissement de dépassement de capacité invite à vérifier la quantité, l'unité, le véhicule et sa capacité configurée. Les champs financiers et le ticket ne sont plus librement modifiables après rapprochement bancaire ou transfert comptable.

[[File:LMDBVehicleManagement-1.0.0-06-plein.jpg|thumb|center|1100px|Formulaire de plein ou recharge avec ticket de caisse et règlement, lorsque les opérations diverses sont activées.]]

===Consulter les consommations et statistiques===

#Cliquer sur '''Consommation''' pour ouvrir la synthèse globale, ou sur l'onglet '''Consommation''' d'un véhicule pour son suivi individuel.
#Définir la période et, selon le besoin, filtrer par véhicule, conducteur, consommable ou nature.
#Lancer la recherche avec la loupe.
#Lire les passages, quantités, coûts, moyennes et pics par consommable et unité.
#Consulter les courbes puis ouvrir '''Liste des pleins / recharges''' pour retrouver les saisies à l'origine d'une valeur.

Les unités restent distinctes<span> </span>: litres, kWh et kilogrammes ne s'additionnent pas. La colonne '''Intervalles exclus''' aide à repérer les intervalles non retenus dans les calculs. Les données de démonstration peuvent produire des pics volontairement atypiques ; elles n'illustrent pas la consommation normale du véhicule.

[[File:LMDBVehicleManagement-2026-09-07-synthese-anonymise.png|thumb|center|1100px|Synthèse filtrable et premiers graphiques<span> </span>: les valeurs affichées proviennent d'un jeu de données de test.]]

===Enregistrer une intervention, une panne ou un incident===

#Depuis la fiche du véhicule, cliquer sur '''Nouvel événement véhicule'''.
#Renseigner le libellé, le type d'événement, sa date et les informations utiles sur le conducteur et le tiers intervenant.
#Préciser la gravité, le kilométrage et, si nécessaire, l'immobilisation et sa période.
#Décrire l'intervention puis enregistrer.
#Ajouter les justificatifs dans les fichiers joints de l'événement.

Le menu '''Événements véhicule''' permet de retrouver les interventions de l'ensemble du parc. L'historique du véhicule les regroupe avec ses autres opérations.

===Associer la facture d'une intervention===

Sur la fiche de l'événement ou du contrôle, deux parcours sont disponibles<span> </span>:

*'''Créer une facture fournisseur''' ouvre le formulaire natif. Vérifier le fournisseur, compléter la facture puis enregistrer<span> </span>: le brouillon est lié à l'intervention.
*'''Lier une facture fournisseur existante''' permet de sélectionner une facture puis de cliquer sur '''Lier'''.

Vérifier ensuite la ligne dans '''Objets liés'''. Le lien de référence ouvre la facture. L'action de déliaison retire seulement l'association ; elle ne supprime ni la facture ni l'intervention.

[[File:LMDBVehicleManagement-2026-09-13-intervention-facture-anonymise.png|thumb|center|1100px|Fiche d'entretien et actions de création ou de liaison d'une facture fournisseur ; la relation existante apparaît dans Objets liés.]]

==Notice — assurances et attestations==

===Créer un contrat et couvrir des véhicules===

#Cliquer sur '''Nouveau contrat''' dans la rubrique '''Contrats d'assurance'''.
#Sélectionner l'assureur, puis le contact ou courtier si nécessaire.
#Renseigner le numéro de police, le libellé, les garanties et la période du contrat.
#Préciser le renouvellement et la date de préavis connue. Ajouter les coordonnées d'assistance utiles.
#Sélectionner le ou les véhicules couverts, le type de couverture et sa période.
#Cliquer sur '''Enregistrer''', puis vérifier les véhicules rattachés dans la fiche du contrat.

Une couverture peut être principale ou complémentaire. Un contrat de flotte permet de regrouper plusieurs véhicules dans la même police.

[[File:LMDBVehicleManagement-1.0.0-18-creation-assurance.jpg|thumb|center|1100px|Extrait du formulaire de contrat<span> </span>: assureur, police, période et rattachement des véhicules.]]

[[File:LMDBVehicleManagement-2026-09-11-assurance-anonymise.png|thumb|center|1100px|Contrat d'assurance enregistré et véhicule couvert, avec type et période de couverture.]]

===Déposer et faire contrôler une attestation===

#Ouvrir le contrat depuis '''Liste des contrats'''.
#Choisir l'onglet '''Attestations d'assurance'''.
#Dans '''Nouvelle attestation d'assurance''', choisir la portée<span> </span>: flotte couverte ou véhicule concerné selon les choix proposés.
#Renseigner la période et sélectionner le justificatif.
#Cliquer sur '''Enregistrer le brouillon''' pour poursuivre la préparation, ou '''Soumettre au contrôle''' lorsque le dossier est prêt.
#L'utilisateur habilité vérifie le justificatif et sa période, puis valide l'attestation ou la rejette avec un motif.
#Lors d'un renouvellement, enregistrer la nouvelle attestation et utiliser l'archivage prévu pour conserver la traçabilité de l'ancienne.

Le tableau affiche la portée, les dates, le justificatif téléchargeable et l'état. Un brouillon ne remplace pas une attestation contrôlée et validée.

[[File:LMDBVehicleManagement-1.0.0-12-attestations.jpg|thumb|center|1100px|Attestation validée et formulaire de dépôt<span> </span>: enregistrement provisoire et soumission au contrôle sont deux actions distinctes.]]

==Notice — contrôles réglementaires==

===Qualifier le véhicule===

#Ouvrir l'onglet '''Contrôles réglementaires''' de la fiche véhicule.
#Lire chaque question de '''Qualification réglementaire''' et sélectionner la réponse correspondant à l'usage réel.
#Renseigner les dates d'applicabilité lorsqu'elles sont nécessaires.
#Cliquer sur '''Enregistrer la qualification'''.
#Examiner les '''Exigences réglementaires''' calculées<span> </span>: qualification, dernier contrôle, date calculée, date retenue et état.

Pour un équipement de levage, l'intervalle de VGP doit être choisi après qualification technique. Le formulaire ne doit pas servir à deviner une périodicité. Une information manquante doit être complétée à partir des documents du matériel.

[[File:LMDBVehicleManagement-2026-09-09-qualification-anonymise.png|thumb|center|1100px|Extrait du questionnaire de qualification, à compléter selon les caractéristiques et l'usage du matériel.]]

===Lire l'échéancier===

#Ouvrir '''Échéancier des contrôles''' dans le menu latéral.
#Filtrer la période, le véhicule, le type de matériel, le profil, le contrôle ou l'état.
#Trier les échéances par '''Date retenue''' pour préparer les interventions.
#Ouvrir le véhicule concerné pour retrouver le détail de l'exigence.

Les badges permettent de distinguer notamment une exigence '''À jour''' d'une exigence '''Échue'''. La date retenue est celle utilisée pour le suivi de l'exigence ; elle doit être lue avec la qualification et les documents correspondants.

[[File:LMDBVehicleManagement-2026-09-08-echeancier-anonymise.png|thumb|center|1100px|Échéancier du parc de démonstration, avec dates retenues et états des exigences.]]

===Enregistrer et valider un contrôle===

#Depuis l'exigence du véhicule, cliquer sur '''Enregistrer un contrôle''' pour reprendre le véhicule et l'exigence. Le menu '''Nouveau contrôle''' permet aussi une création directe.
#Vérifier le véhicule, l'exigence et la nature du contrôle.
#Renseigner la date, l'organisme, la référence du procès-verbal et le résultat.
#Saisir la date de validité officielle. Si une autre date effective est retenue, renseigner son motif.
#Compléter les observations et cliquer sur '''Enregistrer'''.
#Sur le contrôle en brouillon, joindre le justificatif obligatoire puis vérifier les informations avant validation.
#Après validation, consulter l'exigence et son échéance actualisée.

[[File:LMDBVehicleManagement-2026-09-10-controle-anonymise.png|thumb|center|1100px|Création d'un contrôle depuis une exigence<span> </span>: organisme, résultat, référence du procès-verbal et dates.]]

Un contrôle validé est immuable. Pour corriger une erreur, utiliser l'annulation motivée et le remplacement prévus par le module. Pour une contre-visite, conserver le lien avec le contrôle concerné. Une facture peut être liée ou déliée sans réécrire les données réglementaires validées.

==Notice — documents et historique==

===Conserver les pièces et les notes===

Utiliser l'onglet '''Notes''' pour les informations publiques ou privées selon les droits, et les fichiers joints de l'objet concerné pour ses pièces. Un rapport d'intervention appartient à l'événement ; un justificatif de contrôle appartient au contrôle. Ce rattachement permet de les retrouver ensuite dans le dossier du véhicule.

Les actions d'ajout, aperçu, téléchargement et suppression suivent les permissions de l'objet et les fonctionnalités disponibles dans la version de Dolibarr. Un droit de lecture n'autorise pas la modification des documents.

===Générer et lire le dossier véhicule===

#Ouvrir la '''fiche principale''' du véhicule et descendre au bloc '''Fichiers joints'''.
#Sélectionner '''Dossier véhicule''' dans '''Modèle de document'''.
#Cliquer sur '''Générer'''.
#Après génération, vérifier la présence du PDF et du ZIP dans le bloc.
#Cliquer sur la loupe du PDF pour l'aperçu, sur son nom pour le télécharger ou sur le ZIP pour récupérer l'archive documentaire.

[[File:LMDBVehicleManagement-1.0.0-14-dossier.jpg|thumb|center|754px|Bloc documentaire de la fiche<span> </span>: sélection du modèle, génération, aperçu du PDF et téléchargement de l'archive.]]

[[File:LMDBVehicleManagement-2026-09-19-apercu-pdf-anonymise.png|thumb|center|793px|Extrait de la première page d'un dossier PDF existant<span> </span>: identification et caractéristiques du véhicule.]]

Pour actualiser le dossier, relancer '''Générer'''. Les fichiers réservés au dossier ne doivent pas être remplacés manuellement. Les justificatifs des consommations et de leurs opérations diverses ne sont pas inclus dans l'archive. Les droits de lecture du véhicule et des factures fournisseurs restent requis pour consulter le dossier.

===Retrouver une opération dans l'historique===

#Ouvrir l'onglet '''Historique''' du véhicule.
#Filtrer par période, source, type, libellé ou état selon le besoin.
#Cliquer sur l'en-tête de la colonne Date pour trier ou sur le libellé d'une opération pour ouvrir sa fiche d'origine.
#Consulter l'indication documentaire lorsqu'une pièce est associée.

L'onglet '''Événements/Agenda''' présente les événements Agenda liés à l'objet. L'onglet '''Historique''' rassemble la chronologie métier disponible. Les deux vues répondent à des usages complémentaires.

[[File:LMDBVehicleManagement-2026-09-17-historique-anonymise.png|thumb|center|1100px|Chronologie consolidée<span> </span>: interventions, relevés, consommations, assurances et affectations.]]

===Importer ou exporter===

Utiliser les fonctions d'import/export natives de Dolibarr avec les jeux de données du module et les droits correspondants. Préparer le CSV à partir des champs attendus par l'import, vérifier les références et l'entité, puis contrôler le résultat après traitement. Les contrôles réglementaires importés sont créés en brouillon.

L'import des consommations est refusé lorsque la création d'opérations diverses est active. Un prix d'additif absent doit rester une cellule vide ; un zéro doit être conservé comme zéro.

== Intégration de l’API QUARTIX ==

L’intégration utilise '''QUARTIX QWS v2''' en lecture seule pour compléter le suivi du parc. Elle récupère les estimations kilométriques, la dernière position, les synthèses d’utilisation et le journal des trajets. Les tracés sont chargés à la demande. Elle ne modifie ni le compte QUARTIX, ni les affectations de conducteurs dans Dolibarr.

=== Prérequis et droits ===

* Disposer d’un accès QWS fourni par QUARTIX, avec le code client, le login, le mot de passe et le '''nom d’application (APPLICATION NAME)'''. Faire confirmer l’accès aux données souhaitées, notamment aux tracés.
* Utiliser une distribution du module contenant cette intégration. Le développement décrit au 7 septembre 2026 complète la version 1.0.0 ; le numéro 1.0.0 seul ne garantit pas sa présence dans une ancienne archive.
* Vérifier dans '''Compatibilité''' la disponibilité de cURL, OpenSSL et du chiffrement natif avec la clé d’instance Dolibarr. La carte utilise le composant Leaflet fourni par Dolibarr.
* Activer les '''Travaux planifiés''' et leur exécution effective sur le serveur pour automatiser les imports.
* Attribuer explicitement les droits nécessaires : lecture des véhicules, consultation des positions GPS et synchronisation QUARTIX sont distinctes. L’utilisateur interne qui exécute les travaux doit aussi pouvoir gérer les relevés kilométriques. Le droit de synchronisation ne donne pas accès au GPS.

Les réglages et associations sont administrés dans l’environnement propriétaire. Les utilisateurs externes n’accèdent pas aux fonctions QUARTIX. Un véhicule partagé reste synchronisé par son propriétaire ; la consultation depuis une autre entité respecte les partages et les droits.

=== Configurer la connexion ===

# Après déploiement, désactiver puis réactiver le module pour enregistrer les tables, droits et travaux nécessaires. Les réglages existants sont conservés.
# Ouvrir la roue dentée du module, puis l’onglet '''QUARTIX'''.
# Saisir le code client, le login, le mot de passe et recopier exactement l’'''APPLICATION NAME''' fourni par QUARTIX. Un mot de passe laissé vide conserve celui enregistré.
# Confirmer l’'''interprétation des horodatages'''. Le mode '''Convention QWS''' respecte le décalage horaire explicite lorsqu’il est fourni et utilise sinon l’heure locale du véhicule. Les autres modes ne doivent être utilisés qu’après confirmation de la convention du compte.
# Confirmer auprès de QUARTIX l’unité des durées. Tant qu’elle n’est pas confirmée dans les réglages, les durées restent indisponibles ; elles ne sont pas transformées en zéros.
# Définir la '''Conservation des trajets (jours)''' selon le besoin. La valeur initiale est de 30 jours lorsqu’aucun réglage n’existe.
# Cliquer sur '''Enregistrer''', puis sur '''Tester la connexion et charger les véhicules'''. Le catalogue reçu permet d’associer les véhicules.
# Activer '''Synchronisation QUARTIX''' après configuration et vérifier les quatre travaux planifiés décrits ci-dessous.

Les identifiants et jetons sont propres à chaque environnement. Le mot de passe enregistré n’est pas réaffiché. Une modification des identifiants renouvelle l’authentification de l’environnement concerné.

=== Associer un véhicule et gérer un boîtier ===

# Depuis les réglages QUARTIX, sélectionner le véhicule Dolibarr puis son véhicule dans le catalogue QUARTIX.
# Confirmer son '''fuseau IANA''' et la '''date et heure réelles d’installation du boîtier''' sur ce véhicule. Le début de journée est issu du paramétrage QUARTIX.
# Enregistrer l’association, puis contrôler les premières valeurs dans l’onglet '''Utilisation QUARTIX''' de la fiche véhicule.

La date d’installation borne les nouveaux imports : aucune position ni estimation antérieure n’est importée ; les synthèses commencent à la première journée QUARTIX complète après installation. Les anciennes associations migrées sans date restent sans date inventée. Après modification du fuseau ou du début de journée dans QUARTIX, revoir l’association avant de reprendre les imports.

L’interrupteur de la ligne permet de '''suspendre''' puis de réactiver une association. L’action '''Dissocier''' propose deux cas à distinguer :

* '''Réaffectation du boîtier''' : conserver les imports de l’ancien véhicule avant d’associer le boîtier à un autre véhicule. Les tracés déjà chargés restent consultables jusqu’à expiration ; les nouvelles demandes de l’ancienne association sont arrêtées.
* '''Association erronée''' : supprimer définitivement les trajets, synthèses et estimations QUARTIX du véhicule. Lire la confirmation avant de valider.

Dans les deux cas, la dernière position est effacée et le boîtier redevient disponible. Les relevés manuels et ceux des pleins/recharges sont conservés. Une nouvelle association ne doit pas chevaucher des journées dont l’historique a été conservé sur le même véhicule.

=== Activer les quatre travaux planifiés ===

Les tâches sont installées '''désactivées''', avec une fréquence initiale de quinze minutes. Ouvrir les '''Travaux planifiés QUARTIX''' depuis les réglages, vérifier l’utilisateur d’exécution, activer les tâches puis contrôler leur dernier résultat.

{| class="wikitable"
! Travail !! Rôle
|-
| QUARTIX — dernières positions || Actualiser la dernière position, par lots de véhicules.
|-
| QUARTIX — kilométrage quotidien || Importer les estimations kilométriques, avec traitement quotidien des véhicules.
|-
| QUARTIX — utilisation et reprise historique || Importer les journées terminées et reprendre progressivement l’historique d’utilisation.
|-
| QUARTIX — journal des trajets || Relire la journée courante et les journées ouvertes, compléter l’historique, traiter les demandes de tracés et purger les trajets expirés.
|}

La fréquence de réveil n’est pas une garantie de mise à jour de toute la flotte en quinze minutes. Les lots, la taille du parc, le temps de réponse et les quotas QUARTIX influencent le délai réel. Une limitation de quota ou une indisponibilité applique un délai de reprise commun à l’environnement. Éviter de multiplier les tests de connexion pendant ce délai.

=== Lire les données du véhicule et le tableau de bord ===

L’onglet '''Utilisation QUARTIX''' du véhicule regroupe l’état de l’association et les informations importées accessibles. Le menu '''Tableau de bord''' donne une synthèse du parc avec filtres, indicateurs et graphiques natifs Dolibarr.

* '''Kilométrage''' : les valeurs importées sont des estimations QUARTIX, identifiées comme telles. Elles ne remplacent pas les relevés réels ni ceux des consommations. Une contradiction avec les relevés réels est signalée ; elle ne bloque pas leur saisie ou correction.
* '''Dernière position''' : elle nécessite le droit GPS. Vérifier sa date ; une position ancienne ne prouve ni une panne ni une immobilisation.
* '''Utilisation''' : distances, nombre de trajets, journées actives et couverture des journées renseignées. Les synthèses quotidiennes sont conservées douze mois. La journée en cours n’entre pas dans les synthèses terminées.
* '''Données manquantes''' : une journée inconnue est distinguée d’une journée renseignée sans activité. Les totaux ne portent que sur les journées renseignées.
* '''Tableau de bord''' : la période initiale couvre les trente journées terminées précédentes. Les totaux et l’évolution portent sur toute la sélection ; la comparaison par véhicule présente les vingt distances les plus élevées. Les lieux et liens GPS sont absents sans le droit correspondant.

L’affichage des données déjà importées ne déclenche pas de nouvel appel QWS. Les consommations restent calculées à partir de leurs relevés réels.

[[File:LMDBVehicleManagement-2026-09-quartix-utilisation.png|thumb|center|1000px|Synthèse quotidienne QUARTIX : couverture des journées, distances et nombre de trajets. Les durées restent indisponibles tant que leur unité n’est pas confirmée.]]

=== Consulter le journal des trajets ===

# Ouvrir l’onglet '''Trajets''' du véhicule avec le droit GPS.
# Choisir la période, initialement les sept derniers jours, puis appliquer les filtres utiles et lancer la recherche.
# Lire les départs, arrivées, distances et états. Utiliser les tris, la pagination et le sélecteur de colonnes pour adapter l’affichage.
# Vérifier la couverture des journées et la dernière synchronisation avant de conclure à l’absence de trajet.

Les horaires affichés suivent le fuseau de la session Dolibarr ; la journée de rattachement conserve le découpage QUARTIX du véhicule. Une arrivée provisoire n’est pas présentée comme une arrivée définitive.

'''Les trajets privés sont protégés.''' Seuls le jour et les distances sont conservés dans leur résumé : pas d’adresse, de coordonnées, d’horaire précis, de durée ou de tracé. La même protection s’applique lorsque les indications nécessaires de confidentialité manquent.

[[File:LMDBVehicleManagement-2026-09-quartix-trajets-anonymise.png|thumb|center|1000px|Journal QUARTIX avec filtres de période et états des trajets. Les adresses sont floutées.]]

=== Afficher le tracé sur la carte ===

# Dans les réglages QUARTIX de l’environnement propriétaire, activer '''Consultation des tracés QUARTIX''' après vérification de l’accès QWS correspondant.
# Dans le journal, cliquer sur le pictogramme '''Voir le tracé''' d’un trajet non privé.
# Le dialogue affiche le tracé en cache ou déclenche son chargement si nécessaire. Le bouton '''Charger / actualiser le tracé''' permet une nouvelle demande lorsque le délai autorisé est écoulé.
# Pour un véhicule partagé, une demande non disponible attend le passage du travail '''Journal des trajets''' de l’environnement propriétaire.

La modale utilise le dialogue natif Dolibarr, sans historique de navigation ni barre de débogage intégrés. Les informations et avertissements restent affichés dans des blocs d’alerte ; ce ne sont pas des notifications éphémères.

La carte relie les points transmis par QUARTIX ; '''elle ne recalcule pas un itinéraire routier'''. Un trajet terminé dispose de marqueurs de départ et d’arrivée. La note '''Trajet en cours''' et l’absence d’arrivée définitive concernent uniquement les trajets encore ouverts. Un tracé absent ou comportant moins de deux points est signalé comme indisponible.

Un tracé terminé déjà en cache ne provoque pas de nouvel appel QUARTIX. Les nouvelles tentatives d’une même journée sont espacées d’au moins quinze minutes, sous réserve des quotas. La vérification périodique du dialogue relit le cache et les autorisations ; elle n’est pas un suivi GPS en direct.

Le fond de carte utilise OpenStreetMap par défaut, sans clé API, avec attribution visible. Un autre fournisseur peut être configuré par URL HTTPS et attribution. Le navigateur demande les tuiles de la zone affichée au fournisseur, sans lui envoyer les secrets QUARTIX. Une panne du fond de carte est signalée séparément d’une indisponibilité du tracé.

[[File:LMDBVehicleManagement-2026-09-quartix-route-anonymise.png|thumb|center|1000px|Tracé d’un trajet terminé dans la modale native, avec messages persistants. L’immatriculation et le fond de carte sont floutés pour protéger les lieux ; l’attribution cartographique est conservée.]]

=== Conservation et confidentialité ===

Les trajets et leurs tracés suivent la même durée de conservation. Réduire cette durée masque immédiatement les journées expirées ; le travail du journal supprime ensuite leurs données par lots. Augmenter la durée permet une reprise progressive des journées encore disponibles chez QUARTIX.

La purge du journal reste active lorsque seule la synchronisation est suspendue, à condition que le module et le travail '''Journal des trajets''' restent actifs. Désactiver le module ou ce travail arrête la purge. Les synthèses d’utilisation gardent leur conservation distincte de douze mois.

Les tracés en cache sont chiffrés. Un trajet reclassé privé ou devenu incompatible avec le journal ne doit plus afficher son ancien tracé. Les positions et parcours GPS ne sont pas exposés dans les documents, exports ou API du module. Aucun conducteur, score d’écoconduite ou détail de vitesse n’est importé par cette intégration.

=== Diagnostic QUARTIX ===

{| class="wikitable"
! Situation !! Vérification ou action
|-
| Le test de connexion échoue || Enregistrer tous les champs, notamment APPLICATION NAME. Relever l’étape et le statut HTTP affichés, sans diffuser les identifiants ni les réponses API brutes.
|-
| Les données n’arrivent pas || Vérifier l’association active, la synchronisation, la date d’installation, les droits du compte d’exécution et les quatre travaux planifiés. Une reprise historique demande plusieurs passages.
|-
| Les durées sont indisponibles || Faire confirmer leur unité auprès de QUARTIX puis la renseigner dans les réglages.
|-
| Le pictogramme de tracé manque || Vérifier le droit GPS, l’activation des tracés, la confidentialité du trajet et la durée de conservation.
|-
| La demande reste en attente || Vérifier le travail du journal et la synchronisation dans l’environnement propriétaire, ainsi que les délais de reprise.
|-
| La carte reste vide || Lire le message persistant : tracé absent/incomplet, session expirée, accès retiré ou fond de carte indisponible sont des situations différentes. Après mise à jour du module, recharger la page.
|-
| Les valeurs diffèrent de QUARTIX || Comparer le même véhicule, la même journée, le fuseau, le début de journée, la couverture et la date de synchronisation. Distinguer estimation kilométrique et relevé réel.
|}


==Questions fréquentes==

{| class="wikitable"
!Situation!!Vérification ou action
|-
|Un bouton n'apparaît pas||Vérifier les droits, l'état de l'objet et les dépendances dans Compatibilité.
|-
|Le dossier ne peut pas être généré||Vérifier l'activation du modèle, Factures fournisseurs, l'extension PHP ZIP et les droits sur le véhicule et les factures.
|-
|Le kilométrage d'une ligne ne peut pas être modifié||Si la source est une consommation, ouvrir et corriger le plein ou la recharge d'origine.
|-
|Une attestation n'est pas considérée comme validée||Vérifier son état, sa portée, sa période et son justificatif ; un brouillon doit encore être soumis au contrôle.
|-
|Une échéance manque||Vérifier les caractéristiques, les réponses de qualification et les dates nécessaires au calcul.
|-
|Les relances ne partent pas||Vérifier l'activation des rappels, les destinataires, les modèles d'emails, l'envoi d'emails Dolibarr et le dernier résultat des travaux planifiés.
|-
|Une dépense ne peut plus être corrigée||Vérifier son rapprochement bancaire ou son transfert comptable avant toute correction dans le parcours financier natif.
|-
|Des données d'une autre entité apparaissent||Vérifier la colonne Environnement et les partages autorisés dans Multicompany.
|}

==Mise à jour==

Avant toute mise à jour, sauvegarder la base de données et les documents de l'installation.

Après remplacement des fichiers du module, le désactiver puis le réactiver pour appliquer les migrations et enregistrer les déclarations natives nécessaires. Les réglages existants sont conservés.

Pour une mise à jour depuis une version de développement<span> </span>:

*consulter le fichier <code>ChangeLog.md</code> de la distribution ;
*vérifier les modèles documentaires et les travaux planifiés ;
*régénérer les dossiers existants pour bénéficier de leur présentation finale ;
*vérifier les paramètres bancaires avant d'activer la création d'opérations diverses ;
*pour QUARTIX, enregistrer les accès, confirmer unités et fuseaux, associer les véhicules et activer les quatre travaux décrits ci-dessus.

Les nouveaux libellés Agenda s'appliquent aux événements futurs. Les historiques et contrôles validés ne sont pas réécrits.

==Limites de la version 1.0.0==

*Les contrôles détaillés des extincteurs, appareils sous pression, accessoires de levage et fluides frigorigènes ne sont pas préconfigurés.
*La gestion dédiée des cartes grises, sinistres, primes, franchises et contraventions n'est pas couverte.
*La gestion commerciale des factures d'achat reste assurée par le module natif Factures fournisseurs.
*Les rappels périodiques nécessitent une configuration opérationnelle des travaux planifiés et de l'envoi d'emails Dolibarr.

*L’export des tracés QUARTIX, les scores d’écoconduite et la modification automatique des affectations ne sont pas proposés.

==Sources et liens utiles==

*[https://github.com/mapiolca/lmdbvehiclemanagement Code source du module]
*[https://github.com/mapiolca/lmdbvehiclemanagement/blob/094fc89/README.md Documentation initiale de la version 1.0.0]
*[https://github.com/mapiolca/lmdbvehiclemanagement/blob/094fc89/ChangeLog.md Historique de la version 1.0.0]
*[https://github.com/mapiolca Profil de l'auteur]

[[Category:Modules complémentaires]]
[[Category:DocUserFR]]