Facturation Récapitulative B2B — Documentation
Installer, configurer et automatiser la facturation récapitulative mensuelle B2B sur PrestaShop 8 et 9.
Présentation
Facturation Récapitulative regroupe toutes les commandes d’un client professionnel sur une période (le mois écoulé, par défaut) en une seule facture consolidée. Au lieu d’une facture par commande, vos clients B2B reçoivent une facture mensuelle unique, numérotée en séquence, avec la ventilation de TVA par taux et le détail commande par commande. Le module génère le PDF via le moteur natif de PrestaShop, l’envoie par email et retire au passage les factures individuelles des emails de commande adressés aux clients professionnels.
Les factures PrestaShop individuelles ne sont jamais supprimées : elles restent générées et disponibles dans votre back-office et dans l’historique de commande. Seul l’email envoyé au client B2B est allégé de son PDF individuel.
Installation
Installez le module comme n’importe quel module PrestaShop, depuis Modules > Module Manager > Téléverser un module, en envoyant le fichier ZIP. À l’installation, le module crée ses tables, son onglet d’administration et une valeur de jeton (token) aléatoire pour le cron. Aucune dépendance Composer n’est requise.
Configuration
Rendez-vous dans Modules > Module Manager, puis cliquez sur Configurer en face de Facturation Récapitulative. La page de configuration regroupe tous les réglages.
Groupes de clients B2B
Cochez le ou les groupes de clients considérés comme professionnels. Seuls les clients appartenant à ces groupes voient leurs commandes consolidées, reçoivent la facture récapitulative et accèdent à l’espace « Mes factures récapitulatives ». C’est ce réglage qui définit votre périmètre B2B.
États de commande inclus
Sélectionnez les états de commande qui rendent une commande éligible à la consolidation (par défaut : paiement accepté, préparation en cours, expédié, livré). Une commande dont l’état courant ne figure pas dans cette liste est ignorée à la génération.
Jour de génération
Choisissez le jour du mois (de 1 à 28) auquel le cron déclenche la génération du mois précédent. Un jour compris entre 1 et 28 garantit que la date existe dans tous les mois.
Préfixe et numérotation
Définissez le préfixe de numérotation (par défaut REC). Les factures récapitulatives sont numérotées en séquence au format PREFIXE-AAAA-00042, via un compteur dédié. Les numéros ne sont jamais réutilisés, même après suppression d’une facture.
Envoi automatique et nettoyage des emails
Deux interrupteurs pilotent le comportement d’envoi :
- Envoi automatique par email : à la génération (cron ou manuelle), la facture récapitulative est envoyée au client avec le PDF joint.
- Retirer la facture individuelle des emails de commande : pour les clients B2B, le PDF de facture individuelle est retiré des emails de commande, afin de ne conserver qu’un envoi propre — la facture récapitulative mensuelle.
Mentions légales et conditions de paiement
Deux zones de texte multilingues vous permettent de personnaliser les mentions légales (par défaut, un rappel de l’article 289 I-3 du CGI relatif à la facture périodique récapitulative) et les conditions de paiement affichées en pied de facture. Ces textes sont saisissables dans chacune des langues de la boutique.
Automatisation par cron
La génération automatique s’appuie sur une URL de cron protégée par un jeton. Récupérez l’URL complète (jeton inclus) dans le panneau d’information de la page de configuration, puis programmez-la dans le planificateur de tâches de votre serveur. Exemple d’entrée crontab pour un déclenchement quotidien :
0 6 * * * wget -q -O /dev/null "https://votreboutique.tld/module/dfdeferredinvoicing/cron?token=VOTRE_TOKEN"Le cron est idempotent : il ne génère la facture d’un client que si elle n’existe pas déjà pour la période. Vous pouvez donc l’exécuter chaque jour sans risque — seul le jour de génération configuré déclenche réellement le traitement du mois précédent.
Paramètres optionnels
&force=1: force la génération quel que soit le jour du mois.&month=6&year=2026: cible une période précise (utile pour rejouer un mois passé).
La réponse est renvoyée au format JSON, avec le nombre de clients traités, de factures créées et de commandes consolidées.
Pour tester immédiatement, ouvrez l’URL du cron avec &force=1 dans votre navigateur : vous obtiendrez le récapitulatif JSON de la génération sans attendre le jour programmé.
Utilisation au quotidien
Onglet « Factures récapitulatives »
Un onglet Factures récapitulatives est ajouté sous Commandes. Il liste toutes les factures récapitulatives générées, avec le numéro, le client, la période, le nombre de commandes, le total TTC et l’état d’envoi de l’email. Chaque ligne propose de télécharger le PDF, de renvoyer l’email ou de supprimer la facture.
Génération manuelle
En haut de cet onglet, un panneau permet de générer manuellement une période (mois et année, pré-remplis sur le mois précédent) pour l’ensemble des clients B2B ou pour un client précis. C’est utile pour un rattrapage ponctuel ou pour émettre la facture d’un client à la demande.
Espace client
Les clients professionnels disposent d’un lien « Mes factures récapitulatives » dans leur compte, où ils retrouvent et téléchargent l’ensemble de leurs factures consolidées. Ce lien n’apparaît que pour les clients appartenant aux groupes B2B configurés.
Ce que contient la facture récapitulative
Chaque facture reprend : les coordonnées de la boutique et l’adresse de facturation du client (raison sociale, numéro de TVA), le détail commande par commande (date, référence, numéro de facture PrestaShop d’origine, montant), la ventilation de TVA par taux (produits et frais de port), avec une ligne d’ajustement d’arrondi si un écart minime apparaît, puis les totaux HT / TVA / TTC, et enfin vos conditions de paiement et mentions légales.
Les commandes sont regroupées par devise : un client ayant commandé dans deux devises différentes sur la même période reçoit une facture récapitulative par devise.
Garanties et limites
- Anti-doublon : chaque commande est enregistrée dans une table de liaison où elle est unique. Une commande déjà consolidée ne peut jamais être reprise dans une autre facture récapitulative.
- Suppression : supprimer une facture récapitulative libère ses commandes, qui redeviennent éligibles à une nouvelle consolidation. Le numéro supprimé n’est toutefois pas réattribué.
- Factures individuelles : elles restent visibles dans l’historique de commande côté client ; seul l’email est allégé. Les masquer casserait la comptabilité PrestaShop.
- Ventilation TVA : la répartition par taux est reconstituée à partir des lignes de commande et de la livraison ; elle peut être approximative dans le cas rare où un même produit cumule plusieurs taxes empilées.
Compatibilité
Facturation Récapitulative est compatible PrestaShop 8.0 à 9.x, en boutique simple comme en multiboutique, sur les cinq langues du catalogue (français, anglais, espagnol, allemand, italien), sans aucune dépendance Composer.