DataFirefly Éditeur de factures PDF pour PrestaShop

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

1. Dans Modules > Gestionnaire de modules, cliquez sur Installer un module et envoyez le fichier dfinvoiceeditor.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.

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.
• 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 numéro de TVA, le téléphone et l’e-mail du client sont optionnels.

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

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

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

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.

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.

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.

Les avoirs gardent l’ancienne présentation

La version 1.0.0 couvre les factures et les bons de livraison. Les avoirs gardent la mise en page de PrestaShop.