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.
Cookies
KSIDol utilise des cookies nécessaires pour le panier, la connexion et le paiement. Les cookies non essentiels restent désactivés tant que vous ne les acceptez pas.
Bonjour, je suis KSIAssistantIA, l’assistant intégré à votre logiciel de gestion. Je peux par exemple vous faire un résumé de la situation de votre entreprise. Voulez-vous voir ce que je sais faire ?