Wo WooCommerce Débutant

Factures Proforma PDF pour WooCommerce — Documentation

Installer, configurer et utiliser DataFirefly Factures pro forma 2.0 pour WooCommerce : modèles et aperçu en direct, coordonnées de l’entreprise et bancaires, numérotation, boutons clients, e-mails, commandes et mise à jour depuis la 1.x.

Mis à jour Version du module 2.0.0

Présentation

DataFirefly Factures pro forma crée des factures pro forma professionnelles en PDF pour vos commandes et paniers WooCommerce. Vous les créez en un clic depuis n’importe quelle commande, les joignez aux e-mails WooCommerce ou laissez vos clients les télécharger depuis le panier, leur compte ou la page de confirmation de commande.

Une facture pro forma indique ce que le client paiera avant que la commande soit réglée : elle permet à un client de payer d’avance par virement bancaire, de faire valider un achat par un service achats ou de préparer les formalités douanières.

Une facture pro forma n’a pas valeur de facture. Le document le précise par défaut ; continuez à émettre vos factures définitives comme d’habitude.

Prérequis et installation

Prérequis

  • WordPress 6.4 ou version ultérieure (testé jusqu’à 7.1)
  • WooCommerce 8.2 ou version ultérieure (testé jusqu’à 11.2), avec ou sans HPOS
  • PHP 7.4 à 8.5 avec les extensions dom et mbstring (présentes chez presque tous les hébergeurs). GD sert à aplatir les logos transparents.

Le moteur PDF (Dompdf) est inclus : il n’y a rien d’autre à installer.

Installation

  1. Allez dans Extensions > Ajouter une extension > Téléverser une extension, choisissez le fichier df-proforma-woo-2.0.0.zip et cliquez sur Installer maintenant.
  2. Activez l’extension. WooCommerce doit être actif.
  3. Ouvrez WooCommerce > Pro forma.

Guide de démarrage et vue d’ensemble

L’onglet Vue d’ensemble s’ouvre sur un guide en quatre étapes : saisir les coordonnées de votre entreprise, ajouter votre logo et choisir un modèle, choisir où les clients obtiennent le document, ouvrir un PDF de test. Chaque étape est cochée automatiquement une fois réalisée.

La vue d’ensemble affiche ensuite le nombre de pro forma émises (au total et ce mois-ci), le prochain numéro, les endroits où les clients peuvent télécharger le document, les e-mails auxquels il est joint, les dernières pro forma avec un lien vers leur PDF et l’état du système.

DataFirefly Factures pro forma – Tableau de bord des factures pro forma : guide de démarrage, documents émis, prochain numéro et dernières pro forma
Tableau de bord des factures pro forma : guide de démarrage, documents émis, prochain numéro et dernières pro forma

Document : modèle et aperçu en direct

L’onglet Document définit l’apparence du PDF. L’aperçu en direct à côté des réglages utilise le même modèle et les mêmes polices que le PDF et se met à jour pendant la saisie, avant même d’enregistrer. Au-dessus de l’aperçu, choisissez des données d’exemple ou l’une de vos 12 dernières commandes ; Ouvrir en PDF affiche le vrai fichier. L’aperçu n’attribue jamais de numéro.

DataFirefly Factures pro forma – Réglages du document avec aperçu en direct de la facture pro forma
Réglages du document avec aperçu en direct de la facture pro forma

Apparence

  • Modèle : Moderne, Classique, Minimaliste ou Audacieux.
  • Couleur de la marque : choisissez l’une des couleurs proposées ou la vôtre. Le texte placé sur cette couleur passe automatiquement en blanc ou en noir pour rester lisible.
  • Police : sans empattement ou avec empattement. Format du papier : A4 ou Lettre US.
  • Logo : choisi dans la médiathèque, en trois tailles. Sans logo, le nom de votre entreprise s’affiche à la place.
DataFirefly Factures pro forma – Quatre modèles de facture pro forma : Moderne, Classique, Minimaliste et Audacieux
Quatre modèles de facture pro forma : Moderne, Classique, Minimaliste et Audacieux
DataFirefly Factures pro forma – Modèle Audacieux avec la couleur de la marque et le logo dans l’aperçu en direct
Modèle Audacieux avec la couleur de la marque et le logo dans l’aperçu en direct

Produits et montants

  • Prix sur le document : HT (l’usage pour les clients professionnels, la taxe étant ajoutée à la fin) ou TTC. Les lignes et les totaux utilisent toujours le même mode.
  • Colonnes et blocs optionnels : colonne référence (UGS), images des produits, colonne taux de taxe, récapitulatif des taxes par taux, adresse de livraison (si différente), moyen de paiement, note laissée par le client.

Textes et mentions légales

  • Titre du document : laissez-le vide pour utiliser « Facture pro forma » dans la langue de chaque client.
  • Durée de validité (jours) : 0 masque la date « Valable jusqu’au ».
  • Texte d’introduction, Conditions générales et Pied de page (affiché en bas de chaque page, au-dessus des identifiants de votre entreprise).
  • Indiquer que le document n’a pas valeur de facture : recommandé.

Les textes acceptent les variables {customer_name}, {order_number}, {proforma_number}, {valid_until} et {site_title}.

Coordonnées de l’entreprise et bancaires

L’onglet Entreprise remplit le bloc émetteur du document. Utiliser l’adresse de la boutique WooCommerce copie l’adresse de votre boutique en un clic.

  • Nom de l’entreprise, adresse, code postal, ville, pays, téléphone, e-mail et site web.
  • Identifiants et mentions légales : numéro de TVA, numéro d’immatriculation avec son nom local (par exemple SIRET, Handelsregister, KvK, NIP, CIF, Codice fiscale) et autres mentions, une par ligne.
  • Coordonnées bancaires : titulaire du compte, banque, IBAN et BIC / SWIFT, affichés sur chaque document lorsque l’option est activée. Sans vos propres coordonnées, ce sont les comptes du moyen de paiement WooCommerce « Virement bancaire » qui sont utilisés.
DataFirefly Factures pro forma – Coordonnées de l’entreprise, numéro de TVA, SIRET et coordonnées bancaires de la pro forma
Coordonnées de l’entreprise, numéro de TVA, SIRET et coordonnées bancaires de la pro forma

Numérotation

L’onglet Numérotation affiche le prochain numéro au fur et à mesure que vous modifiez les réglages.

  • Numéro basé sur : une séquence dédiée (recommandé : des numéros consécutifs sans trou, dans l’ordre d’émission des documents, même lorsque deux documents sont émis au même moment) ou le numéro de commande.
  • Préfixe et Suffixe : cliquez sur une balise pour insérer {Y} (année), {y} (année sur deux chiffres), {m} (mois), {d} (jour) ou {order_number}.
  • Chiffres, Remettre le compteur à zéro (chaque année ou jamais) et Prochaine valeur du compteur (à modifier uniquement si vous poursuivez une séquence existante).

Un numéro est attribué la première fois que le document d’une commande est ouvert, téléchargé, joint à un e-mail ou envoyé. Il est enregistré dans la commande et ne change jamais.

DataFirefly Factures pro forma – Numérotation des pro forma : séquence ou numéro de commande, préfixe avec l’année, remise à zéro annuelle
Numérotation des pro forma : séquence ou numéro de commande, préfixe avec l’année, remise à zéro annuelle

Clients et e-mails

L’onglet Clients et e-mails détermine où vos clients obtiennent le document. Ces boutons restent désactivés tant que vous ne les activez pas.

  • Bouton dans Mon compte > Commandes (liste et page des commandes) et Bouton sur la page de confirmation de commande, pour les états de commande que vous choisissez. Les gestionnaires de boutique peuvent toujours ouvrir le document depuis la commande.
  • Panier : ajoutez au panier un bouton « Télécharger une facture pro forma », choisissez son texte, rendez-le disponible pour tous les visiteurs ou pour les clients connectés uniquement, et demandez le nom, la société et l’adresse à imprimer sur le document.
  • E-mails : joignez le PDF aux e-mails WooCommerce de votre choix (« Commande en attente », utilisé pour les virements bancaires, par défaut) et activez l’e-mail « Facture pro forma ». Modifier l’e-mail l’ouvre dans WooCommerce > Réglages > E-mails, où vous modifiez son objet, son en-tête et son texte.
DataFirefly Factures pro forma – Boutons clients dans Mon compte, la confirmation de commande et le panier, et pièces jointes aux e-mails
Boutons clients dans Mon compte, la confirmation de commande et le panier, et pièces jointes aux e-mails

Le document PDF

Chaque document est créé à partir de la commande actuelle, il lui correspond donc toujours :

  • blocs émetteur et client, avec le nom du pays et le format d’adresse du pays ;
  • numéro, date d’émission, date de validité, numéro de commande et moyen de paiement ;
  • lignes de produits avec leurs options (par exemple Couleur : Rouge), référence, image et taux de taxe lorsque ces colonnes sont activées ;
  • sous-total, remises avec codes promo, livraison, frais, total HT, une ligne par taux de taxe, total, remboursements et solde, dans la devise de la commande ;
  • récapitulatif des taxes par taux, coordonnées bancaires, conditions générales, pied de page et numéros de page.

Les longues commandes se poursuivent sur plusieurs pages, avec l’en-tête du tableau répété et le pied de page sur chaque page. Les polices couvrent les alphabets latin, grec et cyrillique.

DataFirefly Factures pro forma – Facture pro forma en PDF avec deux taux de TVA, récapitulatif des taxes et coordonnées bancaires
Facture pro forma en PDF avec deux taux de TVA, récapitulatif des taxes et coordonnées bancaires

Travailler avec les commandes

Encadré Facture pro forma

Chaque commande dispose d’un encadré Facture pro forma avec le numéro, les dates et les boutons Voir le PDF, Télécharger, Envoyer la facture pro forma au client et Dater d’aujourd’hui, qui relance la période de validité. L’encadré indique aussi si le client peut télécharger le document, et sinon pourquoi.

DataFirefly Factures pro forma – Encadré Facture pro forma d’une commande WooCommerce : voir, télécharger et envoyer au client
Encadré Facture pro forma d’une commande WooCommerce : voir, télécharger et envoyer au client

Liste des commandes

La colonne Pro forma affiche le numéro de chaque commande (cliquez pour ouvrir le PDF) ou Créer. Deux actions groupées sont ajoutées : Télécharger les pro forma (PDF), qui réunit jusqu’à 50 commandes dans un seul fichier PDF, et Envoyer les pro forma par e-mail. Un message confirme chaque action.

DataFirefly Factures pro forma – Liste des commandes WooCommerce avec la colonne Pro forma et le téléchargement groupé
Liste des commandes WooCommerce avec la colonne Pro forma et le téléchargement groupé

Pro forma depuis le panier

Lorsque le bouton du panier est activé, les clients peuvent obtenir une pro forma avant de commander, dans le panier classique comme dans le bloc Panier. Un court formulaire demande le nom, la société, l’adresse, le pays, le numéro de TVA et l’e-mail à imprimer, prérempli pour les clients connectés ; rien n’est enregistré dans leur compte. Le PDF se télécharge sans quitter le panier.

Les documents issus du panier reçoivent une référence commençant par C et n’utilisent pas votre numérotation. Pour éviter les abus, un visiteur peut créer 10 documents de panier toutes les 10 minutes.

Pour placer le bouton ailleurs, utilisez le bloc Bouton pro forma (texte, style et alignement) ou le code court [df_proforma_cart_button].

DataFirefly Factures pro forma – Pro forma depuis le panier : formulaire nom, société, adresse et numéro de TVA avant le téléchargement du PDF
Pro forma depuis le panier : formulaire nom, société, adresse et numéro de TVA avant le téléchargement du PDF

Mon compte et confirmation de commande

Pour les états que vous avez choisis, le client trouve un bouton de téléchargement dans Mon compte > Commandes et sur la page de confirmation de commande, avec les thèmes classiques comme avec les thèmes blocs. Les liens exigent la clé secrète de la commande, et les clients enregistrés doivent être connectés.

DataFirefly Factures pro forma – Page de commande de Mon compte avec l’encadré de téléchargement de la facture pro forma
Page de commande de Mon compte avec l’encadré de téléchargement de la facture pro forma

Outils, langues et confidentialité

L’onglet Outils contient :

  • Langue des documents : la langue du client (langue du compte, WPML ou Polylang) ou la langue du site.
  • Confidentialité : les documents sont générés à la demande et ne sont pas stockés sur le serveur ; les pièces jointes des e-mails sont des fichiers temporaires placés dans un dossier privé et supprimés juste après l’envoi ; aucun cookie et aucune requête externe. Un texte suggéré pour votre politique de confidentialité est ajouté au guide de politique de confidentialité de WordPress.
  • Fichiers de la version 1 : supprimez les fichiers PDF laissés par la version 1.
  • Système : moteur PDF, extensions PHP, dossier privé et polices, avec Supprimer les fichiers temporaires et Afficher à nouveau le guide de démarrage.
  • Lors de la suppression de l’extension : choisissez Conserver les réglages pour les garder après la suppression de l’extension. Les numéros de pro forma restent dans vos commandes et les compteurs sont toujours conservés, afin qu’une réinstallation n’attribue jamais deux fois le même numéro.

L’extension est traduite en anglais, français, espagnol, allemand, portugais (Portugal), italien, polonais et néerlandais.

Mise à jour depuis la version 1.x

Installez la version 2.0.0 par-dessus la version 1.x (Extensions > Ajouter une extension > Téléverser une extension, puis Remplacer la version actuelle par la version téléversée). Au premier chargement :

  • les coordonnées de l’entreprise, le logo, la couleur, la validité et les réglages des e-mails sont conservés ;
  • la numérotation est identique : même compteur, même préfixe, numéros déjà attribués aux commandes conservés ;
  • les fichiers PDF de la version 1, accessibles par leur adresse, sont déplacés dans un dossier privé ; vous pouvez les supprimer dans Outils ;
  • les nouveaux boutons clients restent désactivés tant que vous ne les activez pas, et un avis présente les nouveautés.

TCPDF n’est plus utilisé : vous pouvez supprimer toute copie de TCPDF installée pour la version 1.

Pour les développeurs

Modèle

Copiez templates/document.php dans yourtheme/df-proforma-woo/document.php pour modifier la mise en page.

Hooks

  • dfpw_order_data (array $doc, WC_Order $order) et dfpw_cart_data (array $doc, WC_Cart $cart, array $buyer) : données d’un document.
  • dfpw_proforma_number (string $number, WC_Order $order) : nouveau numéro.
  • dfpw_document_css, dfpw_template_file, dfpw_document_locale.
  • dfpw_customer_can_download, dfpw_cart_allowed, dfpw_cart_rate_limit, dfpw_attach_to_email, dfpw_customer_vat_number.
  • dfpw_capability (réglages, par défaut manage_woocommerce) et dfpw_order_capability (documents des commandes, par défaut edit_shop_orders).
  • Actions : dfpw_number_issued, dfpw_pdf_generated, dfpw_cart_document_created.

WP-CLI

  • wp dfpw status
  • wp dfpw generate <order>... [--output=<file>] ou wp dfpw generate 0 --sample
  • wp dfpw next-number [<value>]
  • wp dfpw cleanup

Dépannage

Le PDF n’est pas créé

Ouvrez Pro forma > Outils > Système ou Outils > Santé du site : les extensions PHP dom et mbstring doivent être présentes et le dossier privé accessible en écriture.

Le client ne voit pas le bouton de téléchargement

Vérifiez que le bouton est activé dans Clients et e-mails et que l’état de la commande fait partie des états choisis. L’encadré Facture pro forma de la commande explique pourquoi le client ne peut pas la télécharger.

Certains caractères manquent

Les polices couvrent les alphabets latin, grec et cyrillique. Le chinois, le japonais, le coréen, l’arabe et l’hébreu ne sont pas pris en charge.

Les montants ne correspondent pas à la commande

Le document reflète toujours la commande actuelle. Si vous avez modifié la commande après l’envoi de la pro forma, ouvrez à nouveau le document ou renvoyez-le.

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

Toujours bloqué ? Contactez le support