Module UltimateInvoice FR

Sommaire

Informations

Module name	UltimateInvoice
Editor / Editeur
Download or buy page / Page achat ou téléchargement	External module - www.dolistore.com
Status / Statut / Estado	Stable
Prerequisites / Prérequis	Module Factures activé - PHP 7.4 minimum Dolibarr min version: See on Dolistore Dolibarr max version: See on Dolistore
Last update date / Date mise à jour fiche / Fecha última actualización	2026-07-28
Note / Nota	⬆ Retour au sommaire

Fonctionnalités

UltimateInvoice remplace le modèle PDF natif de Dolibarr pour les factures par un modèle entièrement personnalisable, nommé ultimate_invoice. Véritable couteau suisse de la facture PDF, il permet de définir votre charte graphique (logo, couleurs, marges, fond de page, largeurs de colonnes), de choisir précisément ce qui s'affiche sur le document, d'y joindre vos CGV ou des PDF annexes, d'y ajouter des codes-barres et QR-codes, et de signer numériquement le fichier généré.

UltimateInvoice est la version allégée du module UltimatePDF : elle couvre uniquement les factures. Pour les devis, commandes, contrats, expéditions, notes de frais, interventions, projets, produits/nomenclatures ou documents fournisseurs, la version complète UltimatePDF est nécessaire.

Deux niveaux de configuration

Le module s'articule autour de deux notions à ne pas confondre :

Le Design (onglet Modèles) définit à quoi ressemble le document : couleurs, marges, logo, alias société, fond de page, largeur des colonnes. Plusieurs Designs peuvent coexister, un seul est actif par défaut (constante ULTIMATE_DESIGN), et un sélecteur en haut à droite de l'application permet d'en changer instantanément.
Les pages Options et Factures décident ce qui s'affiche sur le document : colonnes visibles, blocs d'adresses, mentions légales, signatures imprimées, etc. Elles ne touchent pas à l'habillage graphique.

Personnalisation graphique (Designs)

Fond de page : image de fond ou PDF de fond (papier à en-tête déjà maquetté), avec transparence et positionnement X/Y.
En-tête : hauteur et largeur du logo, second logo (partenaire, certification), largeur du bloc expéditeur avec aperçu glisser-déposer et préréglage enveloppe à fenêtre norme postale française.
Alias société : permet d'afficher sur le document une raison sociale, une adresse, un capital ou un n° de TVA différents de l'entité juridique réelle — utile pour une marque commerciale ou une filiale.
Marges et colonnes : marges du PDF et largeur de chaque colonne du tableau de lignes (référence, image, date, type, projet, TVA, PU, quantité, unité, remise), chacune redimensionnable à la souris sur un aperçu graphique.
Pied de page : taille de police, hauteur réservée au texte libre, couleurs du texte et du fond.
Police : choix de la police du document (DejaVuSans pour les jeux de caractères étendus ou cyrilliques).

Chaque bloc du formulaire possède son propre bouton Enregistrer : vous validez bloc par bloc sans perdre votre saisie sur les autres.

Contenu de la facture

Colonnes de lignes : numérotation, photo produit, PU HT, remise, PU après remise, quantité, poids et poids total, unité.
Blocs d'adresses : coordonnées destinataire, client, commercial suiveur, identifiants professionnels (SIRET...), n° de TVA intracommunautaire, empilement vertical des blocs de contacts.
Mise en page : en-tête non répété sur chaque page, repère de pliage, texte associé à la date, format de papier.
Spécifique factures : expéditions liées, conditions de paiement, facture de situation, lien de paiement en ligne, encours client, montant en toutes lettres, ligne de total TTC, génération sans colonne TVA.
Signatures imprimées : signature du responsable sur le document et signature du commercial suiveur dans la note. Ce sont des images ajoutées au PDF, à ne pas confondre avec la signature cryptographique décrite plus bas.

Fusion de PDF et CGV

CGV : un fichier de conditions générales de vente est téléversé depuis la page Options puis ajouté à la suite de la facture, avec présélection par défaut possible.
Fichiers additionnels : après activation de l'option correspondante sur la page Factures, un ou plusieurs PDF quelconques peuvent être fusionnés au document depuis la fiche de la facture.

Signature électronique des factures (PAdES)

UltimateInvoice peut apposer une signature numérique sur le PDF au moment de sa génération. Elle garantit au destinataire l'authenticité (le document vient bien de vous) et l'intégrité (il n'a pas été modifié depuis). Adobe Acrobat Reader l'affiche dans son panneau Signatures, et un cadre de signature visible est dessiné en bas à droite de la dernière page.

Aspect	Détail
Ce que la fonctionnalité fait	Signature cryptographique PKCS#7 détachée, équivalent PAdES-B-B, intégrée nativement au PDF, avec cadre visible et cliquable
Ce qu'elle ne fait pas	Pas d'horodatage qualifié (RFC 3161), pas de LTV/archivage long terme, pas de valeur probante eIDAS qualifiée
Ce qu'elle ne remplace pas	Ni la facturation électronique (Factur-X / PDF-A3), ni une signature qualifiée délivrée par un prestataire de confiance

Formats de certificat acceptés : .pem, .crt, .p12, .pfx. Le fichier doit contenir le certificat et la clé privée. Il est stocké dans le répertoire documents de Dolibarr, hors du dossier web du module : il n'est donc pas téléchargeable depuis un navigateur.

Limite importante : la fusion de fichiers additionnels réécrit le PDF après sa génération et casserait la signature. Sur une facture où des fichiers sont fusionnés, la signature est donc automatiquement ignorée (un avertissement est écrit dans le journal Dolibarr) plutôt que produite invalide. La fusion des CGV, elle, reste compatible.

Codes-barres, QR-codes et QR-facture suisse

Codes-barres produits (EAN13 avec clé de contrôle, CODE128, CODE39) et codes-barres tiers, en haut ou en bas de page.
QR-codes société (MyCompany), tiers, ou facture.
QR-code de paiement SEPA (norme EPC069-12) et QR-facture suisse (Swiss QR-bill), y compris le bulletin de versement complet sur une page dédiée. Attention : ces deux réglages appartiennent au cœur de Dolibarr (Accueil - Configuration - PDF - onglet Paramètres spécifiques, section Factures) et non au module, qui se contente de les respecter lors de la génération.

Pour le bulletin de versement suisse complet, le mode de règlement doit être le virement bancaire, un compte bancaire doit être renseigné sur la facture, l'adresse de votre société doit être complète et l'IBAN valide (les QR-IBAN ne sont pas encore gérés). Le cadre de signature électronique est volontairement dessiné sur la dernière page de la facture, avant l'ajout du bulletin, dont la mise en page est normative.

Compatibilité avec le module Milestone

UltimateInvoice reconnaît les lignes jalons du module Milestone (product_type = 9) : elles ne sont pas traitées comme des lignes produit classiques dans le calcul du poids de ligne et du prix unitaire après remise, et conservent leur mise en forme propre dans le PDF.

Guide d'utilisation intégré

Un guide complet en français et en anglais est consultable directement depuis la configuration du module, onglet Guide d'utilisation. Il est mis à jour à chaque version et détaille chaque option.

⬆ Retour au sommaire

Prérequis

Dolibarr : Versions supportées :

23.x
24.x

PHP : version 7.4 minimum. Le bulletin de versement suisse complet en page dédiée nécessite PHP 8.1 ou supérieur.

Modules Dolibarr : le module Factures doit être activé.

⚙️ Procédure d'installation

⚙️ Installation manuelle

Télécharger le fichier archive du module (.zip).
Placer le fichier dans le répertoire racine de Dolibarr.
Décompresser le fichier zip avec la commande :

unzip module_ultimateinvoice-X.0.0.zip

Vérifier que l'emplacement correct du module est :

htdocs/custom/ultimateinvoice

Le module est maintenant disponible et peut être activé depuis Dolibarr.

⬆ Retour au sommaire

Configuration

Pour utiliser ce module, il vous faut d'abord l'activer. Pour cela, après s'être connecté avec un compte administrateur, allez sur la page "Accueil - Configuration - Modules". Le module apparait dans l'onglet "Atoo-Net", cliquez sur "Activer". Un pictogramme apparait à la fin de la ligne du module, cliquez dessus pour accéder aux pages de paramétrage spécifiques à ce module.

Toutes les pages d'administration du module sont protégées par le droit ultimateinvoice -> config : seuls les utilisateurs disposant de ce droit (généralement les administrateurs) peuvent y accéder. Les autres utilisateurs voient simplement le modèle ultimate_invoice apparaître dans la liste déroulante "Modèles" de la fiche facture.

La configuration se compose de cinq onglets : Modèles, Options, Factures, Guide d'utilisation et À propos.

Onglet Modèles (Designs)

C'est ici que se crée l'habillage graphique commun à tous vos documents.

- La liste affiche tous les Designs existants : libellé, description, type de bordure, couleurs, statut et badge "Défaut" pour celui actuellement utilisé.

- Cliquez sur Ajouter un design pour en créer un nouveau, ou sur le crayon pour modifier un design existant.

- Renseignez bloc par bloc : informations du modèle et police, fond de page, en-tête et logos, alias société, bloc central, marges et largeurs de colonnes, pied de page. Chaque bloc dispose de son propre bouton Enregistrer.

- Un Design désactivé n'apparaît plus dans les listes de sélection. Le "Modèle maître" et le Design par défaut ne peuvent pas être supprimés, afin de ne jamais casser la génération de documents.

Important : après modification d'un Design, si le document généré ne semble pas avoir changé, vérifiez que c'est bien ce Design qui porte le badge "Défaut".

Onglet Options (réglages globaux)

Ces réglages s'appliquent à tous les documents, indépendamment du Design choisi : logos, blocs d'adresses et identifiants professionnels, fond de page, contenu des lignes, CGV, coordonnées bancaires, certificat de signature, format de papier.

La plupart des réglages sont des interrupteurs on/off appliqués immédiatement ; le format de papier et les identifiants professionnels se valident avec un bouton Enregistrer dédié.

Téléversement des CGV

Dans le bloc dédié, sélectionnez votre fichier PDF de conditions générales de vente et envoyez-le. Il apparaîtra ensuite dans une liste déroulante près du bouton Générer de la fiche facture, et peut être présélectionné par défaut.

Mise en service de la signature électronique

Dans le bloc Certificat de signature, en bas de la page Options :

Téléversez votre fichier certificat (.pem, .crt, .p12 ou .pfx) contenant le certificat et la clé privée.
Renseignez le motif de la signature (texte libre visible dans les propriétés de signature du PDF, par exemple "Facture certifiée conforme").
Renseignez le mot de passe de la clé privée si elle est protégée, puis enregistrez.
Activez l'interrupteur "Signer électroniquement le PDF de facture".
Générez une facture et ouvrez-la dans Acrobat Reader : le panneau Signatures doit afficher la signature et le cadre visible apparaît en bas à droite de la dernière page.

Un seul certificat à la fois est pris en compte : supprimez l'ancien avant d'en téléverser un nouveau.

Pour tester, un certificat auto-signé suffit :

openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout signature.key -out signature.crt

cat signature.crt signature.key > signature.pem

Acrobat affichera alors la signature comme "présente mais non fiable" : c'est normal, l'autorité n'étant pas reconnue. En production, utilisez un certificat délivré par une autorité de certification.

À savoir avant de déployer : le mot de passe de la clé privée est stocké en clair dans la table des constantes de Dolibarr, faute de coffre-fort de secrets natif. Restreignez l'accès à la base et aux sauvegardes en conséquence, et appliquez des droits fichiers stricts sur le répertoire de stockage du certificat.

Onglet Factures

Cette page regroupe les réglages propres au contenu de la facture : adresses, codes-barres et QR-codes, projet lié, en-tête et mise en page, colonnes de lignes, signatures imprimées, fusion de PDF et réglages spécifiques aux factures (expéditions liées, facture de situation, lien de paiement en ligne, encours client, montant en toutes lettres...).

Onglet Guide d'utilisation

Affiche le guide complet du module dans la langue de l'interface (français ou anglais). C'est la documentation de référence, plus détaillée que cette page.

⬆ Retour au sommaire

Utilisation

- Ouvrez la fiche de la facture, puis, dans le bloc Documents en bas de fiche, choisissez le modèle ultimate_invoice dans la liste déroulante "Modèles" et cliquez sur Générer.

- Le PDF apparaît dans la liste des fichiers joints : il peut être téléchargé, prévisualisé ou envoyé par e-mail.

- Changer de Design rapidement : utilisez le sélecteur dédié dans le menu en haut à droite de l'application, sans repasser par la configuration complète.

- Ajouter les CGV : sélectionnez le fichier CGV dans la liste déroulante située près du bouton Générer.

- Fusionner un PDF annexe : après activation de l'option sur la page Factures, sélectionnez le ou les fichiers à fusionner depuis la fiche de la facture. Sur ces factures, la signature électronique est automatiquement ignorée.

Dépannage

Symptôme	Cause probable
Le modèle `ultimate_invoice` n'apparaît pas dans la liste	Le module UltimateInvoice ou le module Factures n'est pas activé
Le document ne reflète pas les modifications d'un Design	Ce Design n'est pas celui qui porte le badge "Défaut"
Aucune signature ni cadre visible sur le PDF	Aucun certificat téléversé, ou extension non reconnue
Journal : skipped: additional files merging is active	Des fichiers additionnels sont fusionnés à cette facture, les deux fonctions s'excluent
Acrobat affiche "signature non valide"	Certificat auto-signé : normal en test, utilisez un certificat d'une autorité reconnue en production
Journal : Error getting private key	Mot de passe de la clé privée absent ou erroné, ou fichier sans clé privée
Le bulletin de versement suisse n'apparaît pas	Voir les messages `SwissQr*` dans le journal Dolibarr : mode de règlement autre que le virement, adresse ou IBAN non conformes, QR-IBAN non géré

Le journal Dolibarr (Accueil - Configuration - Autres - Journaux) trace chaque génération et chaque tentative de signature.

⬆ Retour au sommaire

Autres langues

⬆ Retour au sommaire