# Factures Proforma PDF pour WooCommerce — Documentation

> Présentation Le plugin Factures Proforma PDF pour WooCommerce génère des factures proforma professionnelles au format PDF directement depuis vos commandes WooCommerce. Chaque document reprend automatiquement les produits avec leurs attributs…

- Page: <https://www.datafirefly.com/documentation/df-proforma-woo/>
- Langue: fr
- Mis à jour le: 2026-08-06
- Autres langues: [en](https://www.datafirefly.com/en/documentation/df-proforma-woo/index.md), [es](https://www.datafirefly.com/es/documentation/df-proforma-woo/index.md), [de](https://www.datafirefly.com/de/documentation/df-proforma-woo/index.md), [it](https://www.datafirefly.com/it/documentation/df-proforma-woo/index.md), [pl](https://www.datafirefly.com/pl/documentation/df-proforma-woo/index.md), [nl](https://www.datafirefly.com/nl/documentation/df-proforma-woo/index.md), [pt](https://www.datafirefly.com/pt/documentation/df-proforma-woo/index.md)
- Index: <https://www.datafirefly.com/documentation/llms.txt>

## Présentation

Le plugin **Factures Proforma PDF pour WooCommerce** génère des factures proforma professionnelles au format PDF directement depuis vos commandes WooCommerce. Chaque document reprend automatiquement les produits avec leurs attributs (dimensions, options, personnalisations), l'intégralité des totaux WooCommerce (sous-total, expédition, remises, TVA) et vos coordonnées d'entreprise.

Une facture proforma est un document non contractuel remis avant paiement. Elle ne remplace pas la facture définitive.

## Installation

### 1. Installer le plugin

1. Dans votre administration WordPress, allez dans **Extensions → Ajouter → Téléverser une extension**.
2. Sélectionnez l'archive ZIP du plugin puis cliquez sur **Installer maintenant**.
3. Activez le plugin.

### 2. Prérequis

- WordPress 6.0 ou supérieur
- WooCommerce 7.0 ou supérieur (compatible HPOS)
- PHP 8.0 ou supérieur

## Configuration

Les réglages se trouvent dans **WooCommerce → Proforma**, organisés en trois onglets.

### Onglet Entreprise

Renseignez les informations qui apparaîtront dans le bloc émetteur du PDF : logo (via la médiathèque), raison sociale, adresse complète, téléphone, e-mail, numéro de TVA intracommunautaire et SIRET.

### Onglet Document

- **Préfixe numéro** : par exemple `PRO-` donnera PRO-00001, PRO-00002, etc. Le compteur s'incrémente automatiquement et chaque numéro reste attaché à sa commande.
- **Validité** : nombre de jours pendant lesquels la proforma est valable (la date limite est imprimée sur le document).
- **Symbole et position monétaire** : 10,00 € ou € 10,00.
- **Couleur accent** : couleur des bandes, titres et en-têtes de tableau du PDF.
- **Texte pied de page** : mention légale imprimée en bas de chaque page.

### Onglet E-mail

Activez **Joindre automatiquement** pour que la proforma soit attachée aux e-mails de confirmation de commande (nouvelle commande, commande en cours, commande en attente).

## Générer une proforma

### Depuis la fiche commande

Une boîte **Facture Proforma** apparaît dans la colonne latérale de chaque commande. Elle permet de générer le PDF, de le télécharger et de le régénérer après modification de la commande. L'action est aussi disponible dans le menu déroulant _Actions de commande_.

### Depuis la liste des commandes

- **Colonne dédiée** : une icône indique si une proforma existe (bleue) ou non (grise) ; un clic la télécharge ou la génère.
- **Action groupée** : cochez plusieurs commandes puis choisissez _Générer proforma(s)_ pour un traitement en masse.

Après modification d'une commande (ajout de produit, remise), utilisez le bouton **Régénérer** pour mettre à jour le PDF : le numéro proforma reste identique.

## Contenu du PDF

- Blocs émetteur / destinataire avec adresses complètes
- Tableau des produits avec référence, désignation et **attributs produits** (dimensions, options de personnalisation…)
- Totaux complets identiques à WooCommerce : sous-total, expédition, remises et coupons, TVA, total TTC
- Mode de paiement et notes client (optionnel)
- Numérotation, date d'émission et date de validité

## Stockage et sécurité

Les PDF sont enregistrés dans `wp-content/uploads/df-proforma/`, un dossier protégé contre le listage. Seuls les utilisateurs disposant de la capacité `manage_woocommerce` peuvent générer ou télécharger les documents.

## Questions fréquentes

### Le PDF ne se génère pas

Vérifiez que la bibliothèque PDF est bien installée (une notice s'affiche dans l'administration si elle est absente) et que le dossier `uploads` est accessible en écriture.

### Puis-je modifier le numéro d'une proforma existante ?

Le numéro est fixé à la première génération et stocké dans la commande afin de garantir la traçabilité. Régénérer le document conserve le même numéro.

### Les remises et frais de port apparaissent-ils ?

Oui, le document reprend exactement les lignes de totaux calculées par WooCommerce, y compris les livraisons offertes et les coupons.