UltimateInvoice v24.0

📌 Version du module : 24.0.2 📅 Dernière mise à jour : 28/07/2026 👤 Éditeur/Licence : Philippe GRAND / Atoo-Net / GNU GPL v3+ 🌍 Langues de l'interface : 📧 Support : par e-mail à l'adresse contact@atoo-net.com ✅ Compatibilité Dolibarr : Dolibarr 23.0 et 24.0 ✅ Module requis : Factures ✅ Version PHP requise : PHP 7.4 ou supérieur 💡 Mises à jour gratuites pendant 1 an pour une même version, puis 50 % de remise sur la version suivante.

Donnez à vos factures Dolibarr l'apparence de votre entreprise avec UltimateInvoice

Le module 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, largeur des 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é.

Aucune ligne de code n'est nécessaire : tout se configure depuis les écrans d'administration du module, avec des aperçus graphiques et des poignées de redimensionnement à la souris.

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.

🎨 Ce que vous pouvez personnaliser

🧩 Deux niveaux de configuration à ne pas confondre

Le module s'articule autour de deux notions distinctes :

1. Le Design (onglet Modèles) définit à quoi ressemble le document : couleurs, marges, logo, alias société, fond de page, largeur des colonnes.

2. 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.

Plusieurs Designs peuvent coexister. Un seul est actif par défaut, et un sélecteur placé en haut à droite de l'application permet d'en changer instantanément, sans repasser par la configuration.

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

🖌️ Personnalisation graphique (Designs)

• Fond de page : image de fond ou PDF de fond, pour utiliser un papier à en-tête déjà maquetté, avec réglage de la transparence et du positionnement X/Y.

• En-tête : hauteur et largeur du logo, second logo pour un partenaire ou une 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é : affichez une raison sociale, une adresse, un capital ou un numéro de TVA différents de l'entité juridique réelle, 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, prix unitaire, quantité, unité, remise), redimensionnables à 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, avec DejaVuSans pour les jeux de caractères étendus ou cyrilliques.

📄 Contenu de la facture

Les options s'activent indépendamment les unes des autres, par simple case à cocher :

• Colonnes de lignes : numérotation, photo du produit, prix unitaire HT, remise, prix unitaire après remise, quantité, poids et poids total, unité.

• Blocs d'adresses : coordonnées du destinataire, du client et du commercial suiveur, identifiants professionnels, numéro 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 conditions générales de vente

🔏 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é du document (il vient bien de vous) et son 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.

Cette fonctionnalité est décrite ici sans ambiguïté, afin que son périmètre soit clair avant l'achat :

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, avec un avertissement 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é, 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.

Ces deux derniers 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. Cette page dédiée nécessite PHP 8.1 ou supérieur.

🧱 Compatibilité avec le module Milestone

UltimateInvoice reconnaît les lignes jalons du module Milestone : 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 détaille chaque option écran par écran, avec un fil conducteur unique du début à la fin : création d'un Design, réglage des options, génération d'une facture. Il est mis à jour à chaque version.

⚙️ Prérequis

⚙️ Installation

1. Télécharger le fichier archive du module (.zip).

2. Placer le fichier dans le répertoire racine de Dolibarr.

3. Décompresser l'archive et vérifier que le module se trouve bien dans htdocs/custom/ultimateinvoice.

4. Activer le module depuis Accueil → Configuration → Modules, onglet Atoo-Net.

5. Sélectionner le modèle ultimate_invoice dans la liste déroulante Modèles de la fiche facture.

🧭 Cas d'utilisation typiques

• Aligner les factures sur votre charte graphique : reprendre couleurs, logo et papier à en-tête existants sans faire développer un modèle PDF sur mesure.

• Facturer sous une marque commerciale : utiliser l'alias société pour afficher une raison sociale ou une adresse différentes de l'entité juridique.

• Envoyer les factures sous pli : utiliser le préréglage enveloppe à fenêtre et le repère de pliage pour un envoi postal sans découpe manuelle.

• Joindre systématiquement vos CGV : ajouter automatiquement le même document contractuel à la suite de chaque facture.

• Faciliter le paiement : ajouter un QR-code de paiement SEPA, ou le bulletin de versement suisse pour une clientèle helvétique.

• Rassurer sur l'origine du document : signer numériquement les factures envoyées par e-mail pour que le destinataire puisse vérifier qu'elles n'ont pas été modifiées.

❓ FAQ

• Quelle différence avec le module UltimatePDF ?
  UltimateInvoice est la version allégée d'UltimatePDF, limitée aux factures. Si vous avez besoin de personnaliser également les devis, commandes, contrats, expéditions, notes de frais, interventions ou documents fournisseurs, c'est UltimatePDF qu'il faut choisir.

• Le module modifie-t-il le cœur de Dolibarr ?
  Non. UltimateInvoice ajoute un modèle de document supplémentaire et s'appuie sur les hooks standards. Le modèle PDF natif reste disponible : vous pouvez revenir en arrière à tout moment en le resélectionnant sur la fiche facture.

• Puis-je avoir plusieurs mises en page différentes ?
  Oui. Créez autant de Designs que nécessaire. Un seul est actif par défaut, et un sélecteur en haut à droite de l'application permet de basculer de l'un à l'autre.

• Faut-il des compétences techniques ?
  Non. Toute la configuration se fait depuis les écrans d'administration, avec des aperçus graphiques. Aucune modification de fichier n'est nécessaire.

• La signature électronique a-t-elle une valeur légale ?
  Il s'agit d'une signature basique de type PAdES-B-B : elle prouve l'intégrité et l'origine du fichier, mais elle n'a pas la valeur probante d'une signature qualifiée eIDAS et ne comporte ni horodatage qualifié ni archivage long terme.

• La signature électronique remplace-t-elle Factur-X ?
  Non. Ce sont deux sujets distincts. La signature garantit l'intégrité d'un PDF ; la facturation électronique impose un format structuré (Factur-X, PDF/A-3) qu'UltimateInvoice ne produit pas.

• Où est stocké le mot de passe de la clé privée du certificat ?
  Dans la table des constantes de Dolibarr (llx_const), en clair, faute de coffre-fort de secrets natif dans Dolibarr. Restreignez l'accès à la base de données en conséquence. Le fichier de certificat, lui, est placé hors du dossier web du module, mais reste lisible par le serveur web : appliquez des permissions strictes sur ce répertoire.

• Pourquoi ma facture n'est-elle pas signée ?
  Le cas le plus fréquent est la fusion de fichiers additionnels sur cette facture : les deux fonctions s'excluent, et la signature est volontairement ignorée avec un avertissement dans le journal Dolibarr.

• Le QR-code de paiement est-il fourni par le module ?
  Le QR-code SEPA et la QR-facture suisse sont des réglages du cœur de Dolibarr, dans Configuration → PDF → Paramètres spécifiques. UltimateInvoice les respecte lors de la génération du document.

• Le module est-il compatible avec les jalons du module Milestone ?
  Oui. Les lignes jalons sont reconnues et conservent leur mise en forme propre dans le PDF.

• Mes anciennes factures sont-elles modifiées ?
  Non. Seuls les documents régénérés après activation du modèle utilisent la nouvelle mise en page. Les PDF déjà produits restent intacts.

Pourquoi utiliser UltimateInvoice ?

• Obtenir des factures à votre image sans faire développer un modèle PDF sur mesure

• Régler la mise en page depuis des écrans d'administration, avec aperçus et redimensionnement à la souris

• Créer plusieurs Designs et basculer de l'un à l'autre en un clic

• Utiliser un papier à en-tête existant comme fond de page, image ou PDF

• Facturer sous une marque commerciale grâce à l'alias société

• Choisir précisément les colonnes et les blocs affichés sur le document

• Joindre automatiquement vos CGV et vos PDF annexes

• Ajouter codes-barres, QR-codes, QR-code SEPA et QR-facture suisse

• Signer numériquement les factures envoyées par e-mail

• Conserver le modèle natif de Dolibarr disponible à tout moment

⚠️ Recommandation importante

Comme pour tout module modifiant l'apparence de documents commerciaux, testez UltimateInvoice sur une instance de test avant de l'utiliser en production.

Avant de commencer, effectuez une sauvegarde complète de :

• La base de données Dolibarr

• Le répertoire de documents Dolibarr

Après configuration, générez une facture courte et une facture longue sur plusieurs pages, puis contrôlez les blocs d'adresses, les totaux, le pied de page et l'absence de page blanche avant de généraliser le modèle.

📖 Documentation

La documentation complète du module est disponible sur le wiki officiel de Dolibarr :

👉 Wiki Dolibarr – Module UltimateInvoice (FR)

Documentation dans les autres langues :

👉 Wiki Dolibarr – Module UltimateInvoice (EN)

👉 Wiki Dolibarr – Module UltimateInvoice (DE)

👉 Wiki Dolibarr – Module UltimateInvoice (ES)

👉 Wiki Dolibarr – Module UltimateInvoice (IT)

Un guide d'utilisation complet est également intégré au module, onglet Guide d'utilisation de sa page de configuration.

Plus de modules