Ce que je veux faire : envoyer à mes clients suisses une facture qu’ils paient en scannant un QR code.
En Suisse, le bulletin de versement a laissé la place à la QR-facture : un QR code imprimé au bas du document, que le client scanne avec l’application de sa banque. L’IBAN, le montant, la monnaie et la référence sont déjà remplis, il ne lui reste qu’à valider.
Le modèle de document SwissQR DHub produit cette page. La facture garde sa première page ; la QR-facture vient à la fin du PDF, sous la mention À détacher avant le versement. Elle se compose de deux parties : le récépissé, à conserver une fois le paiement effectué, et la section paiement, avec le QR code, le compte à créditer, le débiteur, la monnaie et le montant.
Sur la facture de démonstration FA-DEMO-001, la QR-facture porte le montant de 778,32 CHF, le compte CH93 0076 2011 6238 5295 7 au nom de DoliHub Demo, et la Boulangerie du Lac SARL comme débiteur.
Les trois conditions pour obtenir un QR code
- Le modèle de document de la facture doit être SwissQR DHub.
- Le mode de règlement de la facture doit être Virement bancaire (ou laissé vide).
- Un compte bancaire avec IBAN doit être renseigné sur la facture.
Il faut les trois. Si le mode de règlement est Espèce, Carte bancaire ou Chèque, ou si aucun compte bancaire n’est rattaché à la facture, le PDF sort sans QR code : Dolibarr imprime simplement le mode de règlement en bas de page. C’est logique — une facture payée en espèces n’a rien à scanner. La comparaison des deux rendus se trouve dans Exemple concret : espèces ou virement.
⚠️ Les trois conditions sont obligatoires
Modèle SwissQR DHub, mode de règlement Virement bancaire et compte bancaire avec IBAN. Si l’une manque, la facture sort sans QR code.
La référence de paiement
Avec un IBAN classique, la QR-facture est émise sans référence de paiement. C’est la référence de la facture, reprise dans les Informations supplémentaires, qui permet de rapprocher le paiement reçu.
Avec un QR-IBAN (un IBAN émis spécialement pour les QR-factures), le modèle génère automatiquement une référence QR à partir de la référence de la facture, et la transmet dans le QR code.
Envoyer la facture
Une fois le PDF généré depuis la fiche (bloc Modèle de document, bouton Générer), la facture part avec ENVOYER EMAIL, depuis la fiche ou depuis la liste. Le client reçoit un PDF dont la dernière page est sa QR-facture.

