Notice du module PropalQR

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

Signature clientEn 1 scan
Emplacements du QRFiche, PDF, e-mail
Pages du PDF ciblées1re, toutes ou dernière
CompatibilitéDolibarr 18 à 24

1. Présentation du module

PropalQR (« Signature propale par QR code ») ajoute le QR code du lien de signature en ligne sur vos propositions commerciales (devis) Dolibarr. Concrètement, le client n'a plus à recopier une adresse ni à retrouver un lien au milieu d'un e-mail : il scanne le code avec l'appareil photo de son téléphone et arrive directement sur la page de signature en ligne du devis. C'est un raccourci qui accélère l'acceptation d'un devis, notamment lors d'un rendez-vous ou d'une remise de document papier. Le module ne crée aucune donnée et ne remplace rien : il s'appuie entièrement sur la signature en ligne native de Dolibarr et se contente d'en dessiner l'adresse. Il intervient donc là où le devis circule déjà : un encart sur la fiche de la proposition, un bloc sur le PDF généré, et deux champs de fusion pour les e-mails. La proposition elle-même n'est pas touchée : ni champ ajouté, ni onglet supplémentaire, ni modification de son statut ou de son historique.

  • Transforme le lien de signature en ligne d'un devis en un QR code que le client scanne pour signer
  • Affiche un encart en haut de la fiche de la proposition, avec le lien cliquable et le QR code côte à côte
  • Estampille le QR code sur le PDF du devis, à la position et sur les pages de votre choix
  • Fournit deux champs de fusion pour insérer le QR code ou le lien de signature dans vos e-mails
  • Ne s'appuie que sur la signature en ligne native de Dolibarr : rien de plus n'est exposé que le lien déjà transmis au client
  • Ne crée aucune donnée, aucun champ et aucun onglet supplémentaire sur la proposition
  • Fonctionne sans configuration : le module place le bloc lui-même tant que vous ne lui imposez pas de position

2. Le QR code sur la fiche de la proposition

Sur l'écran d'un devis, le module ajoute un encart « QR code de signature en ligne » en haut de la fiche, juste sous le bandeau qui porte la référence et le statut. Il apparaît dès que le devis est sorti du brouillon et que la signature en ligne est active.

  • L'encart réunit un titre, le lien public de signature — cliquable, ouvert dans un nouvel onglet — et l'image du QR code
  • Le QR code encode l'adresse de la page de signature en ligne du devis, et rien d'autre
  • Le client présent peut scanner le code directement à l'écran, sans attendre un e-mail ni un document
  • La teinte d'accent choisie dans les réglages colore le titre, le lien et le cadre de l'encart
  • L'image du QR code n'est fabriquée qu'au moment où le navigateur l'affiche, pour ne pas alourdir l'ouverture de la fiche
  • L'encart n'apparaît que sur l'affichage normal du devis : il est volontairement absent de l'écran de préparation d'un e-mail, qui doit rester rapide
  • Sur un écran étroit, l'encart se réorganise et se centre de lui-même
  • Aucun onglet et aucun bouton ne sont ajoutés à la fiche : l'encart est le seul ajout visible

3. Le QR code sur le PDF de la proposition

À chaque génération du PDF d'un devis, le module reprend le document produit par Dolibarr et y dépose un bloc composé d'un titre et du QR code. C'est ce qui rend un devis imprimé ou envoyé en pièce jointe signable depuis un téléphone.

  • Le bloc est déposé sur le PDF déjà produit : le document conserve sa mise en page, son en-tête et son pied de page
  • Le bloc contient le titre et le QR code ; le lien n'est pas écrit en toutes lettres sur le document
  • Vous choisissez les pages concernées : la première seulement, toutes les pages, ou la dernière seulement
  • Tant qu'aucune coordonnée n'est enregistrée, le bloc se place automatiquement en bas à droite de la page
  • Une position précise peut être imposée en millimètres, mesurée depuis le bord gauche et depuis le bord haut de la page
  • Une coordonnée qui ferait sortir le bloc de la page est ramenée d'elle-même dans la page : le bloc n'est jamais coupé
  • La teinte d'accent s'applique au QR code comme à son titre
  • Le bloc est posé par les modèles PDF de proposition livrés avec Dolibarr ; un modèle d'un autre éditeur ne le reçoit que s'il utilise le même point d'extension
  • L'aperçu d'un modèle PDF, lancé depuis la configuration des propositions commerciales, montre le bloc avec une adresse de démonstration

4. Le QR code et le lien dans les e-mails

Le module met à disposition deux champs de fusion que vous pouvez insérer dans vos modèles d'e-mails Dolibarr, ou directement dans le message que vous êtes en train d'écrire.

  • __PROPAL_SIGNATURE_QRCODE__ insère l'image du QR code dans le corps du message
  • __PROPAL_SIGNATURE_QRCODE_URL__ insère le lien public de signature, utile lorsque la messagerie du client bloque l'affichage des images
  • Les deux champs se placent comme les autres variables de Dolibarr, dans l'objet comme dans le corps du message
  • Ils sont remplacés au moment de l'envoi, pour une proposition sortie du brouillon dont la signature en ligne est active
  • Ces deux champs ne figurent pas dans la liste d'aide des variables disponibles affichée par Dolibarr : saisissez-les tels quels
  • L'image n'est pas incorporée au message : elle est appelée quand le destinataire ouvre l'e-mail, ce qui évite de ralentir l'écran d'envoi
  • Dans un modèle de document ODT de proposition, le champ qui porte le lien est lui aussi remplacé ; celui qui porte l'image ne convient qu'à un support HTML

5. La page de réglages

Tous les réglages tiennent sur une page, avec un aperçu à côté des champs. Aucun n'est obligatoire : les valeurs livrées conviennent dans la plupart des cas, et vous n'y revenez que pour déplacer le bloc ou changer sa couleur.

  • Position du bloc sur le PDF : coordonnée X depuis le bord gauche et coordonnée Y depuis le bord haut, exprimées en millimètres
  • Les deux champs sont pré-remplis avec la position donnée en exemple, celle qui pose le QR code sous la zone de signature du document
  • Vider un champ puis enregistrer rend la main au placement automatique
  • Affichage du QR code sur le PDF : première page uniquement, toutes les pages, ou dernière page uniquement
  • Couleur d'accent : six teintes proposées — Noir encre, Bleu océan, Vert émeraude, Violet, Orange ambré, Rouge carmin
  • Un aperçu montre, sur une maquette de proposition, où tombera le bloc : le cadre se déplace en direct pendant que vous tapez les coordonnées
  • L'aperçu affiche un vrai QR code dans la teinte sélectionnée, et indique « Automatique » pour une coordonnée laissée vide
  • « Enregistrer » applique les trois réglages d'un coup ; une valeur qui n'est pas un nombre, ou une couleur hors palette, est refusée avec un message explicite
  • « Rétablir la position par défaut » réinscrit la position d'exemple, remet la teinte sur Noir encre et l'affichage sur la première page
  • En environnement multi-sociétés, les réglages sont propres à la société dans laquelle vous les enregistrez

6. Menu, accès et droits

Le module reste discret dans l'interface : une entrée de menu, deux droits, et rien d'autre à administrer au quotidien.

  • Une entrée « Propal QR » est ajoutée dans le menu principal et ouvre la page de réglages
  • La même page est accessible depuis la liste des modules, par l'icône de configuration du module
  • Deux droits sont prévus : utiliser le module, et le configurer
  • Les deux sont accordés par défaut aux nouveaux utilisateurs et groupes, et se retirent comme n'importe quel droit Dolibarr
  • L'entrée de menu s'affiche dès le droit d'utilisation, mais la page de réglages exige le droit de configuration : sans lui, l'accès est refusé
  • Le module n'ajoute aucune table, aucun champ personnalisé, aucun dictionnaire et aucune tâche planifiée

7. Quand le QR code apparaît, et quand il n'apparaît pas

Le QR code ne s'affiche que lorsque la signature a du sens, afin de ne jamais proposer au client un lien qui ne mènerait à rien.

  • La signature en ligne des propositions doit être activée dans la configuration des propositions commerciales
  • La proposition doit être sortie du brouillon : un devis au brouillon n'affiche aucun QR code
  • La proposition doit porter une référence
  • Si l'une de ces conditions manque, aucun encart n'est affiché, aucun bloc n'est ajouté au PDF et les champs de fusion restent vides
  • Le QR code reste présent sur un devis signé, refusé ou facturé : seul le brouillon est écarté
  • L'adresse encodée est l'adresse publique de votre Dolibarr telle qu'elle est enregistrée dans sa configuration : c'est celle-là qui doit être joignable depuis un téléphone

8. Données et sécurité

Le QR code n'est qu'une représentation graphique d'un lien que Dolibarr sait déjà produire. C'est ce qui rend le module neutre vis-à-vis de vos données.

  • Le QR code n'encode que le lien de signature en ligne calculé par Dolibarr, protégé par la clé de sécurité propre à votre instance
  • Aucune donnée de la proposition, du client ou de l'utilisateur n'est encodée dans le code ni transmise ailleurs
  • L'image du QR code est dessinée par votre propre serveur, sans aucun service extérieur ni accès à Internet
  • Le point d'accès qui fabrique l'image se contente de dessiner l'adresse qu'on lui passe : il ne consulte pas la base et ne révèle rien de plus que le lien déjà envoyé au client
  • Les images destinées aux PDF sont conservées parmi les documents de l'instance et réutilisées tant que le lien et la teinte ne changent pas
  • Le module n'écrit rien dans la proposition : ni son statut, ni ses données, ni son historique ne sont modifiés

9. Liaisons avec Dolibarr

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

  • Propositions commerciales (devis) : C'est la dépendance obligatoire du module : sans le module natif Propositions commerciales, PropalQR ne peut pas être activé. Il se greffe sur la fiche du devis et sur son PDF sans modifier la structure des propositions, et ne concerne aucun autre document (ni commande, ni facture, ni contrat).
  • Signature en ligne Dolibarr : Le QR code encode l'adresse de signature en ligne produite par Dolibarr : l'option « signature en ligne » des propositions doit donc être activée. Le lien, son jeton de sécurité et la page de signature restent entièrement natifs ; le module n'expose rien de plus que ce lien, déjà destiné au client.
  • Modèles PDF de proposition : Le bloc QR est déposé à la fin de la génération du PDF, par le point d'extension prévu par Dolibarr à cet endroit. Les modèles de proposition livrés avec Dolibarr l'utilisent ; un modèle d'un autre éditeur n'affichera le bloc que s'il fait de même. L'aperçu d'un modèle, depuis la configuration des propositions, montre le bloc avec une adresse de démonstration.
  • Modèles d'e-mails et documents fusionnés : Le module ajoute deux champs de fusion (__PROPAL_SIGNATURE_QRCODE__ et __PROPAL_SIGNATURE_QRCODE_URL__) réutilisables dans les modèles d'e-mails de Dolibarr. Le champ qui porte le lien est également remplacé dans un document généré depuis un modèle ODT de proposition ; celui qui porte l'image est destiné aux messages HTML.
  • Utilisateurs, droits et menus : Deux droits propres au module encadrent son usage : l'un pour s'en servir, l'autre pour le configurer. Une entrée de menu mène à la page de réglages, et l'affichage du QR code sur la fiche suit les droits dont dispose déjà l'utilisateur sur la proposition.
  • Multi-sociétés (entités) : Les réglages sont enregistrés pour la société dans laquelle vous les saisissez : chaque société peut avoir sa propre position de bloc, sa propre teinte et son propre choix de pages. Le lien de signature est calculé par la fonction native en tenant compte de la société de la proposition, de sorte que le code reste valable.
  • Statut du document : Le comportement suit le statut natif de la proposition : rien n'est proposé sur un brouillon, tout l'est dès la validation, et le QR code reste disponible ensuite, y compris sur un devis déjà signé ou facturé.
  • Client destinataire du devis : C'est le client qui scanne le code pour ouvrir la page de signature et signer en ligne. Le module facilite ce parcours sans créer de fiche, de compte ni de donnée supplémentaire, et sans rien demander au client en dehors de la signature elle-même.
Besoin d'aide ? WhatsApp Téléphone: 07 45 15 75 87 Téléphone: 07 43 52 58 29 Email Ouvrir le formulaire