Documentation KSIDol > Modules KSIDol > PropalQR

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

Couleurs d'accent6 teintes

Pages du PDF ciblées1re, toutes ou dernière

1. Presentation du module

PropalQR (« Signature propale par QR code ») ajoute un QR code à côté du lien de signature en ligne de vos propositions commerciales (devis) Dolibarr. Concrètement, le client n'a plus besoin de recopier une adresse ou de chercher un lien dans un e-mail : il scanne le QR 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 nouvelle donnée et ne remplace rien : il s'appuie entièrement sur les objets natifs de Dolibarr. Le QR code encode simplement l'URL de signature en ligne déjà fournie par Dolibarr pour la proposition. Il fonctionne donc là où votre devis vit déjà : sur la fiche de la proposition, dans le PDF généré, et dans les e-mails envoyés depuis Dolibarr.

Transforme le lien de signature en ligne d'un devis en un QR code que le client scanne pour signer
S'affiche automatiquement sur la fiche de la proposition, à côté du lien existant
Peut être ajouté au PDF du devis et inséré dans les modèles d'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
Aucune configuration obligatoire : le module choisit des réglages adaptés par défaut

2. 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 » sous les informations de la proposition, à côté du lien de signature déjà présent.

Affiche un bloc contenant le titre, le lien public de signature (cliquable) et l'image du QR code
Le QR code encode l'adresse de la page de signature en ligne du devis
L'encart n'apparaît que sur l'affichage normal du devis (pas pendant la préparation d'un e-mail), pour ne pas ralentir les écrans
Le collaborateur peut faire scanner le code directement à l'écran par le client présent

3. QR code sur le PDF de la proposition

Lorsque Dolibarr génère le PDF d'un devis, le module y ajoute un bloc avec le QR code de signature, pratique pour un devis imprimé ou envoyé en pièce jointe.

Ajoute le QR code sur le PDF du devis produit par Dolibarr (le lien en toutes lettres n'est pas répété sur le PDF)
La position du bloc (coordonnées X et Y, en millimètres) est réglable dans la configuration
La couleur du QR code et de son titre suit la teinte d'accent choisie
Vous choisissez sur quelles pages il apparaît : uniquement la première, toutes, ou uniquement la dernière
Le client scanne le QR code du document papier ou PDF pour ouvrir la signature en ligne sur son téléphone

4. QR code et lien dans les e-mails

Le module met à disposition deux « champs de fusion » (substitutions) que vous pouvez insérer dans vos modèles d'e-mails Dolibarr pour intégrer le QR code ou le lien de signature.

__PROPAL_SIGNATURE_QRCODE__ : insère l'image du QR code dans le corps de l'e-mail
__PROPAL_SIGNATURE_QRCODE_URL__ : insère le lien public de signature (utile si le client bloque l'affichage des images)
L'image du QR code est produite à la demande, pour ne pas ralentir l'ouverture du formulaire « Envoyer un e-mail »
Ces champs se placent dans les modèles d'e-mails, comme les autres variables Dolibarr

5. Configuration du module

Le module ajoute une entrée « Propal QR » dans le menu et une page de réglages. Aucun réglage n'est obligatoire : les valeurs par défaut conviennent dans la plupart des cas.

Position du QR sur le PDF : coordonnées X (depuis le bord gauche) et Y (depuis le haut), en millimètres ; laisser vide conserve le placement automatique
Aperçu visuel : une maquette de page (spécimen du modèle Cyan) montre en direct où tombera le QR code quand vous ajustez X et Y
Couleur d'accent : 6 teintes proposées (Noir encre, Bleu océan, Vert émeraude, Violet, Orange ambré, Rouge carmin)
Affichage du QR sur le PDF : première page uniquement, toutes les pages, ou dernière page uniquement
Boutons « Enregistrer » et « Rétablir la position par défaut » pour revenir aux réglages d'origine

6. Conditions d'affichage du QR code

Le QR code n'apparaît que lorsque la signature a du sens, afin d'éviter de proposer un lien inactif.

La signature en ligne des propositions doit être activée dans Dolibarr
La proposition ne doit plus être au statut brouillon (le devis doit être validé)
Si ces conditions ne sont pas réunies, aucun bloc QR n'est affiché ni ajouté au PDF
Le module gère les environnements multi-sociétés (multi-entité) pour calculer la bonne adresse publique

7. Liaisons avec Dolibarr

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

Propositions commerciales (devis) : Le module dépend du module natif Propositions commerciales : le bloc QR s'ajoute sur la fiche du devis et sur son PDF, sans modifier la structure des propositions.
Signature en ligne Dolibarr : Le QR code encode l'URL de signature en ligne fournie par Dolibarr. Il faut donc que la signature en ligne des propositions soit activée. Le module n'expose rien de plus que ce lien public déjà transmis au client.
Génération des PDF : Le module s'insère dans la génération PDF native (modèles de propositions) pour y déposer le bloc QR, à la position et sur les pages que vous choisissez.
Modèles d'e-mails (substitutions) : Il fournit deux variables de fusion (__PROPAL_SIGNATURE_QRCODE__ et __PROPAL_SIGNATURE_QRCODE_URL__) réutilisables dans les modèles d'e-mails Dolibarr, comme les autres champs standard.
Clients / tiers destinataires : C'est le client destinataire du devis qui scanne le QR code pour signer en ligne ; le module facilite ce parcours sans créer de fiche ni de donnée supplémentaire.
Statut du document : Le comportement suit le statut natif de la proposition : le QR n'est proposé que pour un devis validé (jamais pour un brouillon).