DataFirefly Éditeur de factures PDF pour PrestaShop
Installer le module, régler logo, colonnes, champs personnalisés, mentions légales par pays, échéance et QR code SEPA, puis vérifier la facture avec l'aperçu.
Présentation
Le module dfinvoiceeditor remplace la mise en page des factures PDF de PrestaShop 8 et 9 par la vôtre, réglée depuis le back-office. Il ne modifie aucun fichier .tpl et ne pose aucun override : au moment où PrestaShop génère une facture, le module fournit son propre en-tête, son corps et son pied de page. Désactiver le module ou son interrupteur principal ramène la facture d’origine.
Les réglages s’appliquent à toutes les factures produites par PrestaShop : facture jointe aux e-mails de commande, facture téléchargée depuis le compte client, factures imprimées ou groupées depuis le back-office. En option, les bons de livraison prennent la même présentation.

Installation
- Dans Modules > Gestionnaire de modules, cliquez sur Installer un module et envoyez le fichier
dfinvoiceeditor-1.1.0.zip. - Le module crée sa table de réglages, le dossier
img/dfinvoiceeditorpour le logo et la page Commandes > Éditeur de factures. - Ouvrez cette page. La mise en page du module est active dès l’installation avec des réglages par défaut sobres : générez un aperçu pour la découvrir.
Le module fonctionne sur PrestaShop 8.0 à 9.x, en multiboutique (réglages par boutique) et en multilingue. Aucune dépendance Composer n’est requise.
Mise à jour vers la version 1.1.0
Envoyez dfinvoiceeditor-1.1.0.zip dans le Gestionnaire de modules, puis cliquez sur Mettre à jour. Les réglages, textes, champs personnalisés, règles et le logo sont conservés tels quels. La version 1.1.0 corrige :
- les caractères polonais, tchèques ou turcs remplacés par « ? » quand l’employé qui télécharge la facture utilise une autre langue que la commande ;
- le détail de la TVA d’une facture exonérée (autoliquidation, exportation), qui ne montrait que les frais de port comme base ;
- les déclinaisons au format PrestaShop 8 et 9, coupées au milieu de la parenthèse ;
- le pied de page, imprimé seulement sur la dernière page, et qui reprenait celui de la facture précédente dans un export groupé ;
- le pays du client et les libellés de personnalisation, désormais dans la langue de la facture.
L’éditeur
La page est découpée en sections accessibles depuis la colonne de gauche. Sous la liste, un schéma de page A4 met en surbrillance la zone de la facture que vous réglez. La barre en bas de page indique s’il reste des modifications non enregistrées et porte le bouton Enregistrer.
Les textes imprimés existent dans chaque langue de la boutique. Les pastilles de langue sous l’en-tête choisissent la langue affichée dans tous les champs multilingues.
Aperçu et comparaison
En haut de la page, choisissez une facture récente de la boutique, puis Facture ou Bon de livraison :
- Aperçu ouvre le PDF dans un nouvel onglet avec les réglages affichés à l’écran, même non enregistrés. Seul un logo tout juste envoyé attend l’enregistrement.
- Comparer avec la facture PrestaShop ouvre le même document dans la mise en page d’origine.
Réglages généraux
- Utiliser cette mise en page pour les factures : l’interrupteur principal. Désactivé, PrestaShop imprime de nouveau sa propre facture, sans perte de réglages.
- Utiliser aussi cette mise en page pour les bons de livraison : voir la section Bons de livraison.
- Langue de la facture : la langue de la commande (recommandé) ou celle de l’employé qui génère le PDF.
- Police : automatique selon la langue, Helvetica, DejaVu Sans, Times ou Courier. DejaVu Sans couvre aussi le polonais, le grec et le cyrillique. La police automatique suit la langue de la facture, même quand l’employé qui la télécharge travaille dans une autre langue.
- Taille du texte de 7 à 12 pt et quatre couleurs : accent (titre, en-tête du tableau, total à payer, titres de section), texte, texte secondaire et texte posé sur la couleur d’accent.

En-tête et logo
Choisissez le logo de facture de la boutique, un logo propre aux factures ou aucun logo. Le logo dédié accepte PNG, JPG ou GIF jusqu’à 2 Mo ; un PNG d’au moins 600 px de large s’imprime net. Réglez sa largeur de 10 à 90 mm et sa position à gauche ou à droite. La hauteur est plafonnée à 26 mm pour que l’en-tête ne chevauche jamais le contenu.

Adresses et récapitulatif
Le bloc vendeur est un texte libre avec variables, par défaut {shop_name}, {shop_address} et {shop_details} (les coordonnées de Paramètres de la boutique > Contact). Les adresses de facturation et de livraison s’affichent au format d’adresse du pays ; l’adresse de livraison peut être masquée quand elle est identique à la facturation. Le module compare les adresses telles qu’elles s’impriment (société, nom, rue, code postal, ville, pays), sans tenir compte du téléphone, du numéro de TVA ni du DNI : une même adresse enregistrée deux fois par le client est donc masquée aussi. Le numéro de TVA, le téléphone et l’e-mail du client sont optionnels.
Emplacement du bloc vendeur : dans la ligne des adresses (par défaut) ou sous le logo, dans l’en-tête. Sous le logo, le bloc partage les 35 mm environ que PrestaShop réserve à l’en-tête. Le module mesure le texte sur chaque facture et laisse au logo la hauteur restante, sans descendre sous 12 mm. Si le bloc est trop long, il passe sur deux colonnes sous le logo, puis en plus petit. Aucune ligne n’est coupée. Dans le cas rare où deux colonnes ne suffisent pas, le logo garde sa taille et le bloc s’imprime juste sous l’en-tête, en haut de la première page. Pour garder un grand logo, utilisez {shop_address_inline}, qui tient l’adresse sur une seule ligne. Le texte imprimé en bas de chaque page est le pied de page du module, réglé séparément dans la section Pied de page.
La barre récapitulative, bande teintée sous les adresses, affiche au choix la référence et la date de commande, le paiement, l’échéance, le transporteur et le numéro de suivi, ainsi que les champs personnalisés placés dans la barre.

Lignes produits
Le tableau liste les 12 colonnes disponibles : image, référence, nom, EAN-13, référence fournisseur, prix unitaire HT, prix unitaire TTC, remise, taux de TVA, quantité, total HT, total TTC. Pour chacune, cochez l’impression, modifiez le titre dans chaque langue, réglez la largeur relative et l’alignement, et changez l’ordre avec les flèches. Le bandeau au-dessus montre la répartition des largeurs ; elles sont ajustées pour remplir la page.
- Les déclinaisons (« Taille : M, Couleur : Bleu ») passent sur une deuxième ligne en plus petit. Les deux formats de nom de PrestaShop sont reconnus : « T-shirt (Taille : M – Couleur : Bleu) » comme « T-shirt – Taille : M – Couleur : Bleu ».
- Les personnalisations saisies par le client s’impriment sous le nom du produit.
- La miniature produit mesure de 6 à 25 mm.
- Bordures sous chaque ligne, grille complète ou aucune bordure ; lignes alternées grisées en option.
- Les titres de colonnes se répètent en haut de chaque page d’une longue facture.

Totaux
- Détail de la TVA par taux : base et montant par taux, produits, frais de port, emballage cadeau et écotaxe regroupés. Une facture sans taxe (autoliquidation, exportation) affiche une ligne 0 % sur toute sa base HT.
- Remises : le nom des bons de réduction et des règles panier appliqués s’imprime sous la ligne des remises, comme sur la facture PrestaShop.
- Masquer les lignes à zéro pour la remise et l’emballage cadeau.
- Lister les paiements reçus avec leur moyen, montant et date.
- Contenu ajouté par d’autres modules : ce que d’autres modules ajoutent aux factures par le hook
displayPDFInvoicereste imprimé, après les totaux, après les lignes produits, ou masqué.
Paiement et échéance
Échéance et reste à payer
Le délai de paiement en jours après la date de facture imprime la date d’échéance dans la barre récapitulative et remplit la variable {due_date}. Laissez 0 pour ne pas imprimer d’échéance.
Quand une facture est payée en partie, les lignes Déjà réglé et Reste à payer s’ajoutent sous le total TTC. Le montant réglé est la somme des paiements rattachés à la facture dans PrestaShop. Le tampon Payée, optionnel, s’imprime sous les totaux quand la facture est soldée.
Coordonnées bancaires et QR code SEPA
Choisissez quand imprimer le bloc bancaire : jamais, seulement s’il reste un montant dû, ou toujours. Renseignez le titulaire (le nom de la boutique s’il est vide), la banque, l’IBAN, le BIC et la référence de paiement, par défaut {invoice_number}. L’IBAN est contrôlé par sa clé : un IBAN erroné est signalé et bloque l’enregistrement.
Le QR code SEPA (format EPC069-12) contient le bénéficiaire, l’IBAN, le BIC, le montant restant dû et la référence. Le client le scanne avec son application bancaire et le virement est prérempli. Il s’imprime uniquement pour les factures en euros et seulement s’il reste un montant à payer.

Champs personnalisés
Ajoutez autant de champs que nécessaire : numéro de bon de commande, SIRET du client, conditions de paiement, message du client. Chaque champ a :
- un libellé et un contenu dans chaque langue, avec gras, italique et souligné ;
- un emplacement : barre récapitulative, sous les adresses, sous les lignes produits, sous les totaux ou dans le pied de page ;
- le choix Imprimer sur : factures, bons de livraison ou les deux ;
- l’option Masquer quand ses variables sont vides, utile pour
SIRET : {customer_siret}; - des conditions d’impression (voir plus bas).
Le volet Variables insère une variable dans le dernier champ modifié. Les variables disponibles couvrent la boutique (nom, adresse, e-mail, téléphone, coordonnées), la commande et la facture (numéro, dates, échéance, reste à payer, paiement, transporteur, suivi, numéro de bon de livraison, devise) et le client (nom, société, e-mail, numéro de TVA, SIRET, APE, DNI, téléphones, message laissé à la commande).

Mentions légales par pays
Chaque règle contient un texte par langue et des conditions. Toutes les règles qui correspondent à la facture sont imprimées, dans l’ordre de la liste, dans un cadre sous les totaux ou dans le pied de page.
Conditions
- Destination : tous les pays, pays de la boutique, Union européenne, UE hors pays de la boutique, hors UE, ou une liste de pays. Cliquez sur un pays pour le sélectionner ou le retirer.
- Client : tous, avec ou sans numéro de TVA, société ou particulier.
- Taxe sur la facture : avec ou sans taxe.
Le pays pris en compte est par défaut celui de l’adresse que PrestaShop utilise pour calculer les taxes ; vous pouvez forcer l’adresse de facturation ou de livraison.
Règles d’exemple
Quatre règles sont installées inactives : livraison intracommunautaire exonérée (article 138 de la directive 2006/112/CE, avec le numéro de TVA du client), services B2B dans l’UE en autoliquidation (article 196, ajoutée en 1.1.0 pour les nouvelles installations et après « Rétablir les réglages par défaut »), exportation hors UE (article 146) et conditions de retard B2B en France (pénalités et indemnité forfaitaire de 40 €). Faites valider leur formulation par votre expert-comptable avant de les activer.
Avec DataFirefly VIES B2B, la mention d’autoliquidation avec le numéro de consultation VIES est déjà imprimée par ce module sur les factures exonérées, dans le bloc « Contenu ajouté par d’autres modules ». Laissez alors les règles d’exemple UE désactivées pour ne pas l’imprimer deux fois : l’éditeur affiche un rappel quand VIES B2B est actif.


Pied de page
Le texte du pied de page s’imprime en bas de chaque page, par défaut {shop_name}, {shop_address_inline}. Limitez-le à trois lignes : l’espace réservé par PrestaShop au pied de page est réduit, les textes longs vont dans un champ personnalisé sous les totaux. Le texte légal libre et le texte de pied de page de Commandes > Factures peuvent être ajoutés.
Le pied de page, avec les mentions légales et les champs personnalisés placés dans le pied de page, s’imprime sur chaque page de la facture. Dans un export groupé, chaque facture garde son propre pied de page.

Libellés
La section Libellés liste chaque mot imprimé sur la facture : titre, numéro, dates, titres des adresses, totaux, détail de TVA, échéance, coordonnées bancaires, textes des bons de livraison. Ils sont préremplis en français, anglais, espagnol, allemand, italien, néerlandais, polonais et portugais, et modifiables dans chaque langue.
Bons de livraison
Activez Utiliser aussi cette mise en page pour les bons de livraison dans les réglages généraux. Le bon de livraison reprend le logo, les couleurs, les adresses, la barre récapitulative et les lignes produits, sans aucun prix : seules les colonnes image, référence, nom, EAN-13, référence fournisseur et quantité sont imprimées. Totaux, coordonnées bancaires, mentions légales et texte légal de facture n’y figurent pas. L’en-tête indique le numéro du bon, sa date et le numéro de facture.
Sauvegarde et transfert
Exporter les réglages télécharge un fichier JSON avec tous les réglages de la boutique, textes compris. Les textes y sont repérés par code de langue : le fichier s’importe sur une autre boutique ou une autre installation même si les identifiants de langue diffèrent. Le logo n’est pas inclus. Importer remplace tous les réglages de la boutique courante après confirmation.
Rétablir les réglages par défaut, dans la barre du bas, remet tous les réglages et textes d’origine en conservant le logo envoyé.
Dépannage
L’aperçu indique que l’éditeur n’a pas pu prendre la main
Le message suivant la phrase donne la cause, également inscrite dans Paramètres avancés > Logs. Dans ce cas PrestaShop produit sa facture d’origine : aucune facture n’est bloquée.
Un employé obtient la facture d’origine
PrestaShop n’exécute pas les hooks d’un module quand le profil de l’employé connecté n’a pas le droit Voir sur ce module. Donnez ce droit dans Paramètres avancés > Équipe > Permissions > Modules. Les factures envoyées aux clients et téléchargées depuis leur compte ne sont pas concernées.
Le pied de page déborde sur le contenu
Raccourcissez le texte du pied de page ou déplacez les mentions longues dans un champ personnalisé sous les totaux, ou choisissez l’emplacement « Encadrées sous les totaux » pour les mentions légales. Au-delà de trois lignes, le numéro de page passe sous la marge basse que PrestaShop réserve au pied de page.
Le QR code ne s’affiche pas
Vérifiez que le bloc bancaire est activé, que l’IBAN est enregistré, que la facture est en euros et qu’il reste un montant à payer. En mode « Toujours », une facture soldée affiche les coordonnées sans QR code.
L’adresse de livraison reste affichée alors qu’elle semble identique
Les deux adresses diffèrent sur au moins un élément imprimé : société, complément d’adresse, code postal, région ou orthographe de la rue. Les majuscules, les espaces et la ponctuation sont ignorés. Ouvrez la commande dans le back-office pour comparer les deux adresses.
Un réglage semble sans effet sur l’aperçu
Certains éléments ne s’impriment que si la facture contient l’information : numéro de TVA du client, numéro de suivi, reste à payer sur une facture payée en partie, tampon Payée sur une facture soldée, échéance avec un délai de paiement supérieur à 0 jour, lignes remise et emballage à zéro. Choisissez en haut de l’éditeur une facture qui contient cette information pour vérifier le réglage.
Les avoirs gardent l’ancienne présentation
Le module couvre les factures et les bons de livraison. Les avoirs gardent la mise en page de PrestaShop.