dfproforma — Génération automatique de factures proforma

Présentation

dfproforma automatise la génération de factures proforma dans PrestaShop 8. Dès qu’une commande atteint un statut configuré, le module crée un PDF personnalisé (logo, numérotation, pied de page multilingue) et le met à disposition du client depuis son espace compte. La génération manuelle depuis la fiche commande reste disponible à tout moment.

Installation

1. Dans le back-office PrestaShop, aller dans Modules > Gestionnaire de modules.
2. Cliquer sur Télécharger un module et sélectionner le fichier dfproforma.zip.
3. Cliquer sur Installer. Les tables SQL sont créées automatiquement.
4. Le module apparaît dans la liste sous le nom Proforma Invoice Generator.

Configuration générale

Accédez à la configuration via Modules > Gestionnaire de modules > dfproforma > Configurer.

Statuts déclencheurs

Cochez les statuts de commande qui doivent déclencher la génération automatique de la proforma. Dès qu’une commande passe dans l’un de ces statuts, le PDF est créé et stocké sur le serveur.

Logo PDF

Uploadez un logo dédié aux proformas (formats acceptés : PNG, JPG). Si ce champ est laissé vide, le logo de la boutique est utilisé par défaut.

Pièce jointe e-mail

Activez l’option Joindre la proforma aux e-mails de confirmation pour que le PDF soit automatiquement attaché aux e-mails de commande (order_conf, bankwire, cheque, payment).

Numérotation des proformas

La numérotation est configurable par langue installée. Pour chaque langue :

• Préfixe : texte ajouté avant le numéro (ex. PROFORMA, PRO).
• Numéro de départ : entier à partir duquel le compteur commence (ex. 1 ou 1000).
• Nombre de chiffres : longueur du compteur avec zéros de remplissage (ex. 6 → 000001).

Exemple : préfixe PROFORMA, départ 1, 6 chiffres → première proforma numérotée PROFORMA-000001.

Pied de page PDF

Saisissez le texte de pied de page pour chaque langue active. Ce texte apparaît en bas de chaque proforma générée dans la langue correspondante.

Génération manuelle depuis le back-office

Sur chaque fiche commande, une carte Facture proforma s’affiche dans le panneau latéral :

• Si une proforma existe : lien de téléchargement direct du PDF.
• Si aucune proforma n’existe : bouton Générer la proforma pour la créer immédiatement, quel que soit le statut de la commande.

Téléchargement client

Le client accède à ses proformas depuis son espace compte :

• Page de détail de commande : un bouton Télécharger la proforma apparaît directement sous les informations de commande.
• Historique des commandes : les liens proforma sont intégrés via JavaScript sans requête AJAX supplémentaire (ajout en v1.0.2).

L’accès est protégé par la clé sécurisée de la commande (secure_key) — un client ne peut télécharger que ses propres proformas.

Structure du PDF

Chaque proforma générée contient :

• Numéro de proforma (selon la numérotation configurée)
• Date de génération
• Logo de la boutique (ou logo personnalisé)
• Coordonnées de la boutique et de l’acheteur
• Tableau des produits avec quantités et prix unitaires HT et TTC
• Totaux (HT, TVA, TTC, frais de port)
• Pied de page personnalisé dans la langue de la commande

Multiboutique

dfproforma est nativement compatible avec le mode multiboutique PrestaShop 8 :

• La configuration (statuts, logo, numérotation, pied de page) est indépendante par boutique.
• Les fichiers PDF sont stockés dans un dossier séparé par boutique.
• La numérotation est unique par combinaison numéro + boutique.

Désinstallation

La désinstallation supprime la table SQL df_proforma et toutes les clés de configuration préfixées DFPROFORMA_. Les fichiers PDF déjà générés sont conservés sur le serveur.

Changelog

• v1.0.2 — Intégration dans l’historique des commandes via le hook actionFrontControllerSetMedia ; affichage des liens sans AJAX supplémentaire.
• v1.0.1 — Corrections mineures de stabilité.
• v1.0.0 — Version initiale : génération par statut, PDF personnalisable, pièce jointe e-mail, téléchargement client.