Module UltimateInvoice FR - Revision history

Grandoc at 13:32, 28 July 2026

2026-07-28T13:32:48Z

@@ Line 1: / Line 1: @@
 =Sommaire=
 [[Category:Modules complémentaires]]
 {{TemplateDocDev}}
 {{TemplateDocUtil}}
@@ Line 226: / Line 225: @@
 ''[[#Sommaire|⬆ Retour au sommaire]]''

Grandoc: Undo revision 66800 by Grandoc (talk)

2026-07-28T12:48:52Z

Undo revision 66800 by Grandoc (talk)

Show changes

Grandoc at 12:47, 28 July 2026

2026-07-28T12:47:45Z

Show changes

Grandoc: /* Onglet Guide d'utilisation */

2026-07-28T12:35:47Z

Onglet Guide d'utilisation

← Older revision		Revision as of 12:35, 28 July 2026
Line 186:		Line 186:

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

			[[File:slide_05_invoice.png\|800px]]

	''[[#Sommaire\|⬆ Retour au sommaire]]''		''[[#Sommaire\|⬆ Retour au sommaire]]''

Grandoc: /* Deux niveaux de configuration */

2026-07-28T12:34:24Z

Deux niveaux de configuration

← Older revision		Revision as of 12:34, 28 July 2026
Line 27:		Line 27:
	*Le '''Design''' (onglet ''Modèles'') définit '''à quoi ressemble''' le document<span> </span>: couleurs, marges, logo, alias société, fond de page, largeur des colonnes. Plusieurs Designs peuvent coexister, un seul est actif par défaut (constante <code>ULTIMATE_DESIGN</code>), et un sélecteur en haut à droite de l'application permet d'en changer instantanément.		*Le '''Design''' (onglet ''Modèles'') définit '''à quoi ressemble''' le document<span> </span>: couleurs, marges, logo, alias société, fond de page, largeur des colonnes. Plusieurs Designs peuvent coexister, un seul est actif par défaut (constante <code>ULTIMATE_DESIGN</code>), 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<span> </span>: colonnes visibles, blocs d'adresses, mentions légales, signatures imprimées, etc. Elles ne touchent pas à l'habillage graphique.		*Les pages '''Options''' et '''Factures''' décident '''ce qui s'affiche''' sur le document<span> </span>: colonnes visibles, blocs d'adresses, mentions légales, signatures imprimées, etc. Elles ne touchent pas à l'habillage graphique.

	~~[[File:UltimateInvoice_designs-24.0.png\|800px]]~~

	===Personnalisation graphique (Designs)===		===Personnalisation graphique (Designs)===

Grandoc: /* Onglet Factures */

2026-07-28T12:33:40Z

Onglet Factures

← Older revision		Revision as of 12:33, 28 July 2026
Line 183:		Line 183:
	Cette page regroupe les réglages propres au contenu de la facture<span> </span>: 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...).		Cette page regroupe les réglages propres au contenu de la facture<span> </span>: 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...).

	[[File:~~UltimateInvoice_invoices-24.0~~.png\|800px]]		[[File:slide_04_invoice.png\|800px]]

	==Onglet Guide d'utilisation==		==Onglet Guide d'utilisation==

Grandoc: /* Onglet Options (réglages globaux) */

2026-07-28T12:32:24Z

Onglet Options (réglages globaux)

← Older revision		Revision as of 12:32, 28 July 2026
Line 149:		Line 149:
	Ces réglages s'appliquent à tous les documents, indépendamment du Design choisi<span> </span>: logos, blocs d'adresses et identifiants professionnels, fond de page, contenu des lignes, CGV, coordonnées bancaires, certificat de signature, format de papier.		Ces réglages s'appliquent à tous les documents, indépendamment du Design choisi<span> </span>: logos, blocs d'adresses et identifiants professionnels, fond de page, contenu des lignes, CGV, coordonnées bancaires, certificat de signature, format de papier.

	[[File:~~UltimateInvoice_options-24.0~~.png\|800px]]		[[File:slide_03_invoice.png\|800px]]

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

Grandoc: /* Onglet Modèles (Designs) */

2026-07-28T12:29:57Z

Onglet Modèles (Designs)

← Older revision		Revision as of 12:29, 28 July 2026
Line 131:		Line 131:
	C'est ici que se crée l'habillage graphique commun à tous vos documents.		C'est ici que se crée l'habillage graphique commun à tous vos documents.

	[[File:~~UltimateInvoice_designs-24.0~~.png\|800px]]		[[File:slide_01_invoice.png\|800px]]

	- La liste affiche tous les Designs existants<span> </span>: libellé, description, type de bordure, couleurs, statut et badge "Défaut" pour celui actuellement utilisé.		- La liste affiche tous les Designs existants<span> </span>: libellé, description, type de bordure, couleurs, statut et badge "Défaut" pour celui actuellement utilisé.
Line 137:		Line 137:
	- Cliquez sur '''Ajouter un design''' pour en créer un nouveau, ou sur le crayon pour modifier un design existant.		- Cliquez sur '''Ajouter un design''' pour en créer un nouveau, ou sur le crayon pour modifier un design existant.

	[[File:~~UltimateInvoice_design_edit-24.0~~.png\|800px]]		[[File:slide_02_invoice.png\|800px]]

	- Renseignez bloc par bloc<span> </span>: 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.'''		- Renseignez bloc par bloc<span> </span>: 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.'''

Grandoc: Created page with "=Sommaire= Category:Modules complémentaires Category:Ultimateinvoice {{TemplateDocDev}} {{TemplateDocUtil}} =Informations= {{TemplateModuleInfo |modulename=UltimateIn..."

2026-07-28T12:15:58Z

Created page with "=Sommaire= Category:Modules complémentaires Category:Ultimateinvoice {{TemplateDocDev}} {{TemplateDocUtil}} =Informations= {{TemplateModuleInfo |modulename=UltimateIn..."

New page

=Sommaire=
[[Category:Modules complémentaires]]
[[Category:Ultimateinvoice]]
{{TemplateDocDev}}
{{TemplateDocUtil}}
=Informations=
{{TemplateModuleInfo
|modulename=UltimateInvoice
|editor=[[File:Logo atoonet.jpg|link=https://www.atoo-net.com]]
|webbuy={{LinkToPluginDownloadDoliStore|keyword=ultimateinvoice}}
|status=stable
|prerequisites=Module ''Factures'' activé - PHP 7.4 minimum
|minversion=23.0.x - 24.0.x
|note=
''[[#Sommaire|⬆ 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é '''<code>ultimate_invoice</code>'''. 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 [[Module_Ultimatepdf_FR|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 <code>ULTIMATE_DESIGN</code>), 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.

[[File:UltimateInvoice_designs-24.0.png|800px]]

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

{| class="wikitable"
! 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 : '''<code>.pem</code>, <code>.crt</code>, <code>.p12</code>, <code>.pfx</code>'''. 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 [[Module_Jalon_FR|Milestone]] (<code>product_type = 9</code>) : 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.

''[[#Sommaire|⬆ 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 :

<code>unzip module_ultimateinvoice-X.0.0.zip</code>

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

<code>htdocs/custom/ultimateinvoice</code>

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

''[[#Sommaire|⬆ 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 <code>ultimateinvoice -> config</code> : seuls les utilisateurs disposant de ce droit (généralement les administrateurs) peuvent y accéder. Les autres utilisateurs voient simplement le modèle <code>ultimate_invoice</code> 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.

[[File:UltimateInvoice_designs-24.0.png|800px]]

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

[[File:UltimateInvoice_design_edit-24.0.png|800px]]

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

[[File:UltimateInvoice_options-24.0.png|800px]]

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 (<code>.pem</code>, <code>.crt</code>, <code>.p12</code> ou <code>.pfx</code>) 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 :

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

<code>cat signature.crt signature.key > signature.pem</code>

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

[[File:UltimateInvoice_invoices-24.0.png|800px]]

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

''[[#Sommaire|⬆ Retour au sommaire]]''

=Utilisation=

- Ouvrez la fiche de la '''facture''', puis, dans le bloc '''Documents''' en bas de fiche, choisissez le modèle '''<code>ultimate_invoice</code>''' 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==

{| class="wikitable"
! Symptôme !! Cause probable
|-
| Le modèle <code>ultimate_invoice</code> 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 <code>SwissQr*</code> 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.

''[[#Sommaire|⬆ Retour au sommaire]]''