Notice du module GED QR mobile

Guide d'utilisation non technique : à quoi sert le module, comment l'utiliser et comment il s'articule avec Dolibarr.

CompatibilitéDolibarr 18 à 24
Accès mobileQR + code à 6 chiffres
DestinationsGED/ECM ou 13 types de fiches
OptionFacture fournisseur au brouillon

1. Présentation du module

GED QR Mobile transforme un téléphone en scanner pour Dolibarr. Depuis un poste, vous créez une « session de scan » : vous indiquez où les photos doivent arriver, puis le module affiche un QR code. La personne qui tient le téléphone le scanne, un écran de capture s'ouvre avec deux boutons — ajouter des photos, les envoyer — et les images arrivent là où vous l'avez demandé. Il n'y a aucune application à installer sur le téléphone, aucun câble à brancher et aucun courriel à envoyer. Les photos ne séjournent dans aucune zone d'attente : elles sont déposées directement dans la destination choisie, enregistrées dans l'index des fichiers de Dolibarr et consultables comme n'importe quel document. Cette destination est soit un répertoire de la GED, soit les documents d'une fiche métier : tiers, projet, commande, facture, intervention, ticket et bien d'autres. Un PDF unique regroupant toutes les pages peut être produit au passage. En option, un document photographié peut même être lu pour en préparer une facture fournisseur au brouillon, qu'il reste à vérifier et à valider.

  • Un QR code suffit pour déposer des photos dans Dolibarr, sans installer d'application sur le téléphone
  • Deux familles de destinations : un répertoire de la GED, ou les documents d'une fiche métier
  • Les photos arrivent directement à destination : rien à valider ni à clore sur le téléphone
  • Accès encadré par un lien à jeton, une date d'expiration et un code de validation à six chiffres
  • Suivi en direct des photos reçues côté Dolibarr, avec miniatures, compteurs et statuts
  • PDF unique de la session, avec page de garde et pagination, reconstruit à chaque envoi
  • En option, lecture d'un document scanné pour en proposer une facture fournisseur au brouillon
  • Aucune modification du cœur de Dolibarr, respect des permissions et des sociétés (entités)

2. Créer une session de scan et générer le QR code

Tout part d'une session créée depuis le menu GED/ECM > Scan QRCode, ou depuis l'onglet Scan QRCode d'une fiche. Le formulaire tient en quelques champs : il dit où les photos doivent arriver, ce qui doit être livré et combien de temps le QR code reste valable.

  • Donner un libellé à la session pour la retrouver facilement ; ouvert depuis une fiche, le libellé est proposé d'office
  • Choisir ce qui sera livré : les images seules, ou les images accompagnées d'un PDF fusionné
  • Choisir le mode d'accès mobile : lien direct, ou connexion préalable avec un compte Dolibarr
  • Fixer la durée de validité du QR code, exprimée en heures
  • Ajouter si besoin un masque de sous-répertoire pour ranger la livraison, par exemple {yyyy}/{mm} ou {objref}
  • Saisir une note libre, conservée sur la fiche de la session
  • À l'enregistrement, le module attribue une référence, puis affiche le QR code, le lien mobile et le code de validation
  • Le panneau « Sessions récentes » rappelle les dernières sessions ; ouvert depuis une fiche, il ne montre que celles de cette fiche
  • Le lien, le code et le QR ne sont montrés qu'aux profils autorisés à créer une session (un profil en lecture seule ne les voit pas)

3. Choisir où les photos doivent arriver

La destination est le choix réellement structurant : elle décide de l'endroit où les documents seront rangés, puis consultés. Deux familles sont proposées, et le module crée lui-même ce qui manque.

  • Répertoire de la GED : choisir un répertoire existant de l'arborescence manuelle, présentée sous forme d'arbre
  • Ou saisir un nouveau chemin du type Clients/2026 : chaque niveau manquant est créé dans la GED et reste navigable dans l'écran natif
  • Fiche métier : les photos sont déposées dans le répertoire de documents de la fiche et apparaissent dans son onglet Documents
  • Fiches prises en charge : tiers, projet, proposition commerciale, commande client, facture client, fiche d'intervention, contrat, ticket, produit ou service, commande fournisseur, facture fournisseur, expédition et adhérent
  • Seuls les types de fiches dont le module est actif et que vous avez le droit de consulter sont proposés
  • Un onglet Scan QRCode est ajouté sur ces fiches — les expéditions exceptées — et pré-remplit le formulaire ; il peut être masqué dans la configuration
  • Le masque de sous-répertoire accepte l'année, le mois, le jour, l'heure, la référence et le libellé de la session, l'utilisateur, le type et la référence de la fiche

4. Capturer et envoyer les photos depuis le mobile

La personne sur le terrain scanne le QR code : un écran épuré s'ouvre, sans menu Dolibarr. Il ne propose que deux gestes, ajouter des photos puis les envoyer.

  • Saisir le code de validation lorsque la session en demande un
  • Déclencher directement l'appareil photo, ou piocher plusieurs images dans la galerie
  • Retirer de la sélection une photo ratée avant de l'envoyer
  • Envoyer tout le lot en une seule fois : l'écran confirme le nombre de photos déposées
  • Envoyer d'autres photos au même QR code tant qu'il est valable, sans rien refaire sur le poste
  • Rien d'autre n'est demandé sur le téléphone : ni étape de clôture, ni formulaire à remplir
  • En mode compte Dolibarr, l'opérateur se connecte d'abord et le dépôt est enregistré à son nom
  • Les images acceptées sont au format JPEG, PNG ou WebP, dans la limite de taille et de nombre fixée en configuration

5. Suivre la session depuis sa fiche

La fiche de la session rassemble tout ce qui la concerne : son QR code, l'arrivée des photos en direct, les documents produits et les actions encore possibles.

  • Le bloc d'accès mobile affiche le QR code, le lien et le code de validation, et rappelle si ce lien exige un compte Dolibarr
  • Le suivi en direct liste les photos reçues avec leur miniature, leur nom et leur taille, et se met à jour tout seul
  • La fiche rappelle la destination et donne un lien direct vers le répertoire de la GED ou vers la fiche concernée
  • Le chemin de livraison, le nombre d'images et le PDF produit sont affichés, le PDF s'ouvrant d'un simple clic
  • Chaque photo livrée s'ouvre dans un nouvel onglet depuis sa miniature, comme n'importe quel document Dolibarr
  • Le statut de chaque image est indiqué : en attente, livrée, ou fusionnée dans le PDF
  • La référence, un badge de statut et un retour vers la liste coiffent la fiche

6. Obtenir un PDF unique du scan

Plutôt qu'une série d'images, le module sait produire un seul document regroupant toutes les pages de la session. C'est le choix fait à la création, sous « Documents livrés ».

  • Le PDF est reconstruit à chaque envoi de photos et réécrit au même endroit : la destination ne contient qu'un PDF par session
  • Une page de garde facultative rappelle la référence, le libellé, la destination, l'opérateur, la date et le nombre de pages
  • Une page par photo, en portrait ou en paysage selon l'image, avec le nom de la photo en légende et un pied de page paginé
  • Le document reprend le format de papier, la police et les options PDF réglés dans Dolibarr ; le format peut aussi être imposé
  • Le nom du fichier suit un masque configurable et n'écrase jamais un fichier existant
  • Le bouton « Régénérer le PDF » le reconstruit à la demande depuis la fiche de la session
  • Une image illisible est ignorée et journalisée : elle n'empêche pas la production du document
  • Le PDF est produit par le moteur PDF intégré à Dolibarr, sans aucun outil externe à installer

7. Retrouver les sessions et leur état

Une liste dédiée, accessible depuis le menu GED/ECM, récapitule les sessions de scan pour le suivi et le contrôle.

  • Colonnes affichées : référence, libellé, type de destination, nombre d'images, date de création, dernière activité et statut
  • Filtres sur la référence, le libellé, le type de destination et le statut
  • Colonnes triables, pagination et nombre de lignes réglable
  • Une pastille signale les sessions qui ont produit un PDF fusionné
  • Un bouton ouvre directement le formulaire de création d'une nouvelle session
  • Chaque ligne ouvre la fiche de la session correspondante

8. Accès mobile, code de validation et sécurité

L'écran de capture peut être ouvert sans compte Dolibarr : le module encadre donc strictement qui peut déposer, et pendant combien de temps. Le QR code porte un identifiant, jamais un droit d'accès.

  • Deux modes au choix, session par session : lien direct, ou connexion obligatoire avec un compte Dolibarr
  • En mode compte, le module vérifie la permission de l'opérateur et rattache le dépôt à son nom
  • Le lien porte un jeton aléatoire, vérifié par empreinte et chiffré en base
  • Un code de validation à six chiffres est demandé par défaut sur l'écran de capture ; sa longueur est réglable
  • Les tentatives erronées sont comptées et la session se verrouille d'elle-même pendant un délai réglable
  • Le QR code cesse de fonctionner à l'expiration, et après la clôture de la session sauf option contraire
  • L'adresse IP et le navigateur ne sont conservés que sous forme d'empreinte salée, comportement réglable
  • La configuration avertit lorsque le chiffrement réversible de Dolibarr n'est pas opérationnel sur l'instance
  • Les miniatures et les photos ne sont servies qu'aux utilisateurs connectés disposant du droit de lecture
  • L'accès sans compte peut être interdit globalement : tous les QR exigent alors une connexion

9. Piloter la durée de vie d'un QR code

Une session suit un cycle simple, lisible sur sa fiche comme dans la liste, et reste pilotable depuis le poste tant qu'elle n'est pas close.

  • Les statuts possibles sont : en attente, ouverte, capture en cours, finalisée, annulée et expirée
  • « Prolonger la validité » repousse la date d'expiration sans toucher au QR code déjà distribué
  • « Renouveler le QR code » émet un nouveau jeton et un nouveau code : les précédents cessent aussitôt de fonctionner
  • « Clore la session » arrête le QR code ; les photos déjà déposées restent en place
  • « Annuler la session » referme immédiatement l'accès mobile
  • Un QR code émis par une version antérieure du module continue de fonctionner : il est redirigé vers le bon écran

10. Faire lire un document scanné (option)

Une facture ou un ticket photographié peut être lu par un service d'analyse de document, afin d'en préparer une facture fournisseur au brouillon. La fonction est livrée désactivée : l'activer signifie que les pages scannées quittent le serveur vers le service configuré, et cette décision revient à l'exploitant. Un service installé sur votre propre réseau garde les documents chez vous.

  • Trois services au choix : l'API Anthropic, l'API OpenAI, ou tout service parlant le dialecte OpenAI à une adresse qui vous appartient
  • Un compte grand public sur un site de conversation ne convient pas : il faut une clé d'API, ou un service hébergé par vos soins
  • La clé est stockée chiffrée, jamais réaffichée et jamais journalisée ; enregistrer la page en laissant le champ vide conserve la clé en place
  • Le bouton « Lire le document » envoie les pages de la session, puis présente le résultat dans un formulaire entièrement modifiable
  • Chaque page est redressée selon l'orientation inscrite par le téléphone, puis ramenée à une taille de travail avant d'être lue
  • Rien n'est enregistré avant que vous ne cliquiez, et ce qui est enregistré est un brouillon encore modifiable
  • Le PDF du scan est joint à la facture créée lorsque la session en produit un
  • Les consignes envoyées au service sont affichées en entier et réécrivables ; un bouton rétablit celles d'origine
  • Un bouton « Tester la connexion » contrôle la clé, l'adresse et le modèle en n'envoyant qu'une question très courte
  • Deux lectures au plus tournent en même temps, chacune occupant un processus du serveur pendant toute sa durée
  • La fonction demande le module Fournisseur et le droit de créer une facture fournisseur

11. Lire plusieurs photos à la suite

Quand une session contient une pile de tickets, les photos capturées deviennent une liste de travail : chacune peut devenir sa propre facture fournisseur au brouillon.

  • Cocher les photos à lire, ou utiliser le bouton d'une seule ligne pour n'en traiter qu'une
  • Les lectures s'enchaînent une par une, une barre de progression indiquant où en est le lot
  • Une photo en échec n'interrompt pas le lot : elle affiche la raison et propose d'être reprise
  • Ce qu'est devenue chaque photo est conservé : à la réouverture de la session, chaque ligne pointe toujours vers le brouillon qu'elle a produit
  • Une photo déjà transformée en brouillon n'est plus proposée une seconde fois
  • Lorsque aucun tiers ne correspond au fournisseur lu, la photo est renvoyée vers l'écran de lecture détaillée, où vous désignez le tiers

12. Les contrôles appliqués avant d'écrire une facture

Rien n'est écrit sur la seule foi de la lecture : chaque champ est reconstruit par le module, les chiffres sont confrontés au document, et tout ce qui reste douteux est listé à l'écran sous « À vérifier ».

  • Le fournisseur est rapproché par son numéro de TVA, son numéro d'immatriculation ou son adresse électronique avant son nom, et l'écran dit comment il a été reconnu
  • Un rapprochement obtenu sur le seul nom est signalé comme tel, et un lien permet de créer le tiers manquant
  • Une facture portant déjà cette référence pour ce fournisseur est signalée avant toute écriture, avec un lien vers elle
  • Les totaux lus sur le document et les totaux recalculés sont présentés côte à côte, et tout écart est annoncé
  • Les prix de lignes lus du mauvais côté de la taxe sont remis là où les totaux du document les placent
  • Les taux de TVA sont rattachés aux lignes que le bloc de taxes du document désigne, et la correction est annoncée
  • Un taux inconnu de l'instance est écarté plutôt que comptabilisé : la ligne demande alors à être complétée à la main
  • Un avoir, une devise différente de celle de l'instance ou un document qui ne semble pas adressé à votre société sont signalés
  • Les lignes, les dates, la référence et le fournisseur restent modifiables avant l'enregistrement
  • La facture est toujours créée au brouillon, et l'écran renvoie dessus pour la vérifier et la compléter

13. Configurer le module

La page de réglages (Configuration > Modules > GED QR Mobile) est découpée en sections, et un onglet « À propos » rappelle l'éditeur, la licence et la politique d'accès du module.

  • Accès mobile et sécurité : mode d'accès par défaut, autorisation des QR sans compte, code de validation et sa longueur, tentatives avant verrouillage, durée du verrouillage, accès après clôture, empreinte de l'IP et de l'appareil, validité par défaut du QR
  • Limites de capture : taille maximale par image et nombre maximal d'images par session
  • Destination : masque de sous-répertoire appliqué par défaut, et affichage de l'onglet de scan sur les fiches
  • Document PDF : documents livrés par défaut, page de garde, format de page et masque de nom du fichier
  • Rétention : nombre de jours pendant lesquels les fichiers temporaires d'une session close sont conservés
  • Analyse de document : activation, service, clé d'API, modèle, adresse du service, pages par lecture, taille des pages, temps accordé, lectures simultanées, format de réponse et consignes
  • Les valeurs saisies sont bornées : une durée, une taille ou un nombre hors limites est ramené dans la plage admise

14. Entretien, purge et maintenance

Le module fait seul le ménage de ses données temporaires et sait réparer son installation, sans jamais toucher aux documents déjà livrés.

  • Une tâche planifiée, déclarée et activée par le module, fait expirer chaque jour les sessions dépassées
  • Les fichiers temporaires d'une session close sont supprimés passé le délai de rétention ; les documents livrés ne sont jamais touchés
  • Le bouton « Lancer la purge » effectue le même nettoyage immédiatement
  • « Réparer le schéma » ajoute les colonnes manquantes après une mise à jour et retire les contraintes bloquantes des versions antérieures
  • « Chiffrer les anciens secrets » protège les jetons et les codes des sessions créées par une version antérieure
  • La politique d'accès se remet à jour d'elle-même, et les sessions encore ouvertes qui n'avaient pas de code en reçoivent un
  • Les réglages survivent à une désactivation suivie d'une réactivation du module

15. Liaisons avec Dolibarr

Le module ne fonctionne pas en vase clos : il s'articule avec les briques natives de Dolibarr.

  • GED / ECM (documents) : C'est la dépendance obligatoire du module : les répertoires de la GED servent de destination, et chaque image comme le PDF fusionné deviennent de vrais documents de Dolibarr. Les fichiers se consultent, s'ouvrent et se téléchargent ensuite comme n'importe quel autre document.
  • Répertoires manuels de la GED : Le module lit l'arborescence des répertoires manuels pour proposer la destination sous forme d'arbre, crée à la volée les niveaux d'un chemin qui n'existe pas encore, pointe vers le répertoire par le lien natif de la GED et rafraîchit le compteur de documents pour que l'écran natif n'affiche pas un répertoire vide.
  • Fiches métier et onglet Documents : Une session peut viser les documents d'une fiche : tiers, projet, proposition commerciale, commande client, facture client, fiche d'intervention, contrat, ticket, produit ou service, commande fournisseur, facture fournisseur, expédition ou adhérent. Les fichiers sont déposés à l'emplacement attendu par l'onglet Documents de la fiche, selon l'organisation propre à chaque version de Dolibarr.
  • Index des fichiers de Dolibarr : Chaque fichier déposé est enregistré par le mécanisme natif d'indexation, avec son empreinte et son auteur. C'est ce qui permet aux documents du scan de se comporter exactement comme ceux déposés à la main.
  • Utilisateurs et permissions : Quatre permissions propres au module encadrent les écrans internes : lire les sessions, en créer et capturer des images, clore une session et produire ses documents, administrer le module. Les répertoires et les fichiers sont créés au nom de l'utilisateur Dolibarr concerné.
  • Menus Dolibarr : Le module s'insère dans le menu natif GED/ECM avec trois entrées : « Scan QRCode », « Nouvelle session de scan » et « Sessions de scan ». Il n'ajoute ni menu principal ni espace à part.
  • Moteur PDF de Dolibarr : Le PDF fusionné est produit par le moteur PDF embarqué dans Dolibarr : il suit donc le format de papier, la police et les options PDF de l'instance, sans aucune dépendance externe.
  • Module Fournisseur : La lecture d'un document scanné aboutit à une facture fournisseur au brouillon : elle réclame donc le module Fournisseur actif et le droit de créer une facture fournisseur. Sans eux, l'écran le dit clairement au lieu d'échouer plus loin.
  • Taux de TVA de l'instance : Les taux déclarés et actifs pour le pays de votre société servent de référence lors de la lecture d'un document : un taux qui ne figure pas dans cette liste est écarté plutôt que porté sur une ligne de facture.
  • Tâches planifiées : Le module déclare et active sa propre tâche planifiée, chargée de faire expirer les sessions dépassées et de supprimer leurs fichiers temporaires. Elle se retrouve dans l'écran natif des travaux planifiés.
  • Multi-sociétés (entités) : Sessions, fichiers capturés, répertoires et documents sont rattachés à l'entité courante : sur une installation multi-sociétés, chaque société ne voit que ses propres sessions et ses propres dépôts.
Besoin d'aide ? WhatsApp Téléphone: 07 45 15 75 87 Téléphone: 07 43 52 58 29 Email Ouvrir le formulaire