PS PrestaShop Débutant

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.

Mis à jour Version du module 1.1.0

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.

La même facture imprimée par PrestaShop (à gauche) et par l'éditeur de factures (à droite) : logo, bloc vendeur, récapitulatif, détail de la TVA et coordonnées bancaires
Facture PrestaShop avant et après

Installation

  1. Dans Modules > Gestionnaire de modules, cliquez sur Installer un module et envoyez le fichier dfinvoiceeditor-1.1.0.zip.
  2. Le module crée sa table de réglages, le dossier img/dfinvoiceeditor pour le logo et la page Commandes > Éditeur de factures.
  3. 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.
Éditeur de factures PrestaShop, section Général : mise en page activée, langue de la facture, police automatique selon la langue, taille du texte et couleurs
Éditeur de factures : réglages généraux

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.

En-tête et logo : logo propre aux factures, largeur et position du logo, date de facture sous le numéro
En-tête et logo de la facture

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.

Adresses et récapitulatif : bloc vendeur avec raison sociale, adresse, SIREN et numéro de TVA, adresses de facturation et de livraison, bandeau récapitulatif
Bloc vendeur et adresses

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.
Lignes produits : choix, ordre et largeur des colonnes de la facture (référence, produit, prix unitaire, TVA, quantité, total)
Colonnes des lignes produits

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

Paiement et échéance : délai de paiement en jours, tampon « Payée », coordonnées bancaires (IBAN, BIC) et QR code SEPA avec le montant dû
Échéance, IBAN et QR code SEPA

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

Champs personnalisés : conditions de paiement dans le bandeau pour les sociétés, texte sous les totaux, chacun avec ses conditions d'impression
Champs personnalisés conditionnels

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.

Mentions légales par pays : règles d'exemple livraison intracommunautaire, autoliquidation des services et exportation, avec conditions de destination, de client et de taxe
Mentions légales par pays
Facture PDF B2B sans TVA : détail de la TVA à 0 %, tampon « Payée », coordonnées bancaires et mention d'autoliquidation avec le numéro de consultation VIES (entreprise fictive)
Facture B2B en autoliquidation

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.

Pied de page : mentions de la société imprimées en bas de chaque page, avec les textes légaux de Commandes > Factures
Pied de page de la facture

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.

Cette page vous a-t-elle été utile ?

Toujours bloqué ? Contactez le support