Pennylane Facturation Pro

Présentation

Avec PrestaShop et Pennylane côte à côte, chaque vente porte souvent deux numéros (la facture de PrestaShop, puis celle de Pennylane), et les remboursements faits dans PrestaShop n'arrivent pas toujours dans Pennylane. La facture électronique impose au contraire une facture unique, au bon format, et un avoir pour chaque remboursement.

Pennylane Facturation Pro laisse le geste dans PrestaShop et confie le document à Pennylane :

• Commande payée = facture Pennylane, numérotée par Pennylane, au format Factur-X pour vos clients professionnels.
• Remboursement = avoir Pennylane rattaché à sa facture, que vous remboursiez une quantité, un montant ou le port.
• Le client reçoit le PDF définitif de Pennylane par e-mail et le retrouve dans son compte.
• La facture de PrestaShop peut être coupée : une seule numérotation, celle de Pennylane.
• Un onglet de suivi sous Commandes : tableau de bord, journal, export comptable, alertes, assistant de mise en service.
• Une panne de Pennylane ne bloque rien : le client reçoit une facture pro forma, remplacée par la facture officielle au retour de Pennylane (voir Panne de Pennylane et pro forma).
• Paiements, rapprochement bancaire et devis : fonctions de l'édition Ultimate, absentes de la Pro.

Ce que fait ce module (et ce qu'il ne fait pas)

Prérequis

Compatibilité

• PrestaShop : 1.7.5 à 9.x, testé jusqu'à 9.0, ancienne et nouvelle page commande du back-office.
• PHP : 7.2 à 8.5, selon ce que votre version de PrestaShop accepte.
• Thème : indépendant de votre thème (Classic, Hummingbird et thèmes dérivés). Les pages du front reposent sur une feuille de style dédiée, chargée sur les seules pages du module, que votre thème peut adapter (voir Intégration au thème).
• Multiboutique : un compte Pennylane et des réglages par boutique, voir Multiboutique et licence.
• Autres modules Acronet (Rétractation & Retours SAV Pro, Anti Double Paiement) : cohabitation vérifiée, aucun nom de classe, de table ni de réglage commun.
• Module officiel « Pennylane » : incompatible en même temps (chaque commande serait facturée deux fois). Tant qu'il est actif, le passage en mode Actif est verrouillé.
• Données : quatre tables utilisées (pfp_document, pfp_customer, pfp_alert, pfp_proforma) et les copies des PDF (dossier var/pennylanefacturationpro/, fermé au web), conservées à la désinstallation : elles prouvent quelles pièces ont été émises.

Installation

1. Dans votre back-office PrestaShop, allez dans Modules › Gestionnaire de modules › Installer un module.
2. Sélectionnez l'archive reçue (celle qui correspond à votre version de PrestaShop dans votre espace client), puis validez.
3. Le module s'installe désactivé et ajoute l'onglet Commandes › Pennylane. Le bouton « Configurer » du gestionnaire de modules mène au même endroit.

Mise en service : l'assistant

Ouvrez Commandes › Pennylane › Mise en service. Sept étapes, dans l'ordre ; chacune affiche son état (fait, à faire ou problème) et l'action suivante est mise en avant. Rien ne change pour vos clients avant l'étape 6.

1. Licence Acronet : collez la clé reçue par e-mail après votre achat (ACR-XXXX-XXXX-XXXX-XXXX), puis « Enregistrer et vérifier ».
2. Jeton d'API Pennylane : l'étape rappelle les lignes à cocher dans Pennylane ; collez le jeton, indiquez sa période de validité, puis « Tester et enregistrer ». Le module le teste avant de l'enregistrer et affiche le nom de votre entreprise. Un jeton refusé ou sans les droits obligatoires n'est pas enregistré, et le message dit pourquoi. Le jeton n'est jamais réaffiché en entier (seuls ses 4 premiers et 4 derniers caractères). Voir Jeton d'API.
3. Droits du jeton et numérotation : contrôlés aussitôt, en lecture seule (aucune pièce n'est créée pour vérifier). La numérotation est confirmée dès qu'une facture finalisée existe dans votre compte Pennylane. Sur un compte Pennylane tout neuf, elle ne peut pas être lue sans créer de pièce : elle est alors contrôlée à la première facture du mode Test (si elle n'est pas réglée, cette facture reste en brouillon chez Pennylane, sans consommer de numéro, et le module vous le dit).
4. Mode Test : indiquez l'e-mail d'un ou plusieurs comptes clients de test (le vôtre). Seules leurs commandes partent vers Pennylane.
5. Commande d'essai : passez une commande avec ce compte, passez-la à un état payé (« Paiement accepté »). La facture apparaît avec son numéro Pennylane ; vérifiez-la dans Pennylane et dans l'e-mail reçu. Faites ensuite un remboursement partiel en gardant « Générer un avoir » coché pour voir l'avoir lié à la facture.
6. Passage en mode Actif : toutes les commandes payées à partir de maintenant sont facturées par Pennylane, y compris une commande passée avant mais réglée après (un virement reçu plus tard, par exemple). Les commandes déjà réglées, ou dont PrestaShop a déjà numéroté la facture, gardent leur facture PrestaShop et ne sont jamais refacturées.
7. Couper la facture PrestaShop : une seule numérotation, celle de Pennylane (PS_INVOICE = 0). Elle est rétablie automatiquement si vous désactivez ou désinstallez le module, pour que votre boutique ne vende jamais sans facture.

Jeton d'API Pennylane : droits et remplacement

Le jeton se crée dans Pennylane : Paramètres › Connectivité › onglet Développeurs › « Générer un Token API ». L'écran présente une ligne par ressource et deux colonnes, « Lecture seule » et « Lecture et écriture ». Cochez :

Rien d'autre n'est nécessaire dans la Pro. Les droits « Lecture seule » sur les transactions et les comptes bancaires ne servent qu'au rapprochement bancaire de l'édition Ultimate.

Période de validité (1 mois, 6 mois, 12 mois, Illimité) : choisissez une validité longue, 12 mois ou Illimité, pour ne pas voir vos factures attendre un jeton expiré. L'API de Pennylane ne communique pas la date d'expiration d'un jeton : indiquez au module la période choisie en collant le jeton, il en déduit la date, l'affiche et vous prévient 30 jours avant (bandeau dans l'onglet et e-mail d'alerte). Si vous ne l'indiquez pas, notez la date de votre côté. Pennylane ne montre le jeton qu'une fois : copiez-le aussitôt.

• Jeton masqué : l'onglet n'affiche que ses 4 premiers et 4 derniers caractères, la date à laquelle il a été posé et sa date d'expiration notée.
• « Vérifier les droits » : le module lit (sans rien écrire) chaque ressource avec le jeton en place et affiche chaque ligne en vert, ou en rouge avec « droit absent » quand Pennylane refuse l'accès (HTTP 403). Un droit facultatif absent est affiché sans bloquer. Il indique aussi si l'émission de factures électroniques est activée dans votre compte (droit « Enregistrement PA »).
• Remplacer le jeton : collez le nouveau, puis « Tester et remplacer ». Il est testé avant d'être enregistré : refusé par Pennylane (HTTP 401), sans « Lecture et écriture » sur Clients et Factures client, ou ouvrant une autre entreprise que l'actuelle, il n'est pas enregistré et l'ancien reste en place. Les avoirs d'une facture doivent partir dans l'entreprise qui l'a numérotée : c'est pourquoi la même entreprise est exigée. Vous pouvez ensuite supprimer l'ancien jeton dans Pennylane.
• Changer d'entreprise avant toute émission : tant qu'aucune pièce n'a été émise et que le mode Actif n'est pas en place, le bouton « Débrancher le jeton » permet d'en coller un d'une autre entreprise.
• Multiboutique : la vérification et le remplacement se font pour la boutique choisie dans le sélecteur de PrestaShop. Une boutique sans jeton propre utilise le jeton commun (contexte « toutes les boutiques ») et l'onglet le précise ; y coller un jeton lui donne le sien.

Au quotidien

Il n'y a rien à faire pour chaque vente : vous travaillez dans PrestaShop comme avant. L'onglet Commandes › Pennylane sert à vérifier que tout est parti et à agir quand le module le demande. Une pastille rouge sur l'onglet du menu indique le nombre de points à traiter, et un e-mail vous prévient (voir Alertes).

• Fiche commande : un bloc « Pennylane » donne le numéro de la facture et des avoirs, leur montant, leur état, le PDF, et un bouton « Relancer » si une pièce attend.
• Compte client : dans le détail de la commande, « Vos documents » liste la facture et les avoirs avec leur numéro Pennylane et leur PDF. Les liens PDF habituels de PrestaShop (facture, avoir) servent eux aussi le PDF de Pennylane, de PrestaShop 1.7.5 à 9.x.
• Back-office : le téléchargement de la facture depuis la page commande sert le PDF de Pennylane quand la facture Pennylane est émise.
• Anciennes factures PrestaShop : une fois la facture PrestaShop coupée, le client retrouve toujours les factures de ses commandes antérieures à la mise en service : « Vos documents » rappelle le lien et PrestaShop les sert comme avant.

Les e-mails de PrestaShop

Le module ne modifie aucun modèle d'e-mail de PrestaShop : vous n'avez rien à retoucher. Il envoie en plus son propre e-mail « Votre facture » ou « Votre avoir », avec le PDF Pennylane, dans la langue de la commande (français, anglais, allemand, espagnol, italien ou néerlandais ; anglais pour une autre langue) et avec les montants dans la devise de la commande (désactivable dans Réglages). Les e-mails habituels de PrestaShop (confirmation de commande, paiement accepté, avoir) continuent de partir : tant que la facture PrestaShop n'est pas coupée, ils joignent la facture PrestaShop, d'où deux numéros ; une fois coupée, ils partent sans pièce jointe et seul le PDF Pennylane fait foi. Si l'e-mail d'avoir de PrestaShop fait doublon avec celui du module, vous pouvez l'alléger dans Design › Modèles d'e-mails (modèle credit_slip).

Tableau de bord

• Mois en cours et mois précédent : nombre de factures et d'avoirs émis, montants TTC, net facturé (factures moins avoirs), par date d'émission.
• File d'envoi : pièces en file, en attente (avoir qui attend sa facture, facture qui attend la licence), bloquées (votre action est requise), PDF Factur-X attendus. Chaque chiffre ouvre le journal filtré. Boutons « Traiter la file maintenant » et « Relancer les pièces bloquées ».
• Dernier passage de la file et, si vous en avez posé une, de la tâche planifiée (avec un avertissement si elle n'a pas tourné depuis plus d'une heure).
• Connexion à Pennylane : jeton accepté ou refusé, droits complets ou manquants, numérotation en place, avec le bouton « Contrôler maintenant ».
• Licence : état, domaine, dernière vérification, nouvelle version disponible.
• Boutiques (multiboutique) : mode, entreprise Pennylane, couverture de licence et compteurs de chaque boutique.
• À traiter : les alertes, avec l'action adaptée (« Relancer », « Émettre l'avoir », « Marquer comme traité »).

Journal des pièces

Toutes les factures et tous les avoirs, les plus récents d'abord, 50 par page. Rien n'y est jamais effacé.

• Filtres : état (émises, en file, en attente, bloquées, Factur-X attendu), type (factures ou avoirs), période (du, au), boutique en multiboutique.
• Recherche : numéro de commande, référence de commande, référence de la pièce (REFERENCE-id, -AVn pour un avoir), numéro Pennylane (« F-2026-10-12 » ou seulement « 12 ») ou identifiant Pennylane.
• Pour chaque pièce : date de création et d'émission, numéro Pennylane, commande (lien vers la fiche commande), montant TTC, état, « payée », « envoyée au client », état du PDF, motif en cas de blocage, et le PDF.
• Relance groupée : cochez des pièces et « Relancer la sélection », ou « Relancer toutes les bloquées ». Chaque pièce est retraitée aussitôt (dans la limite de 20 secondes, le reste part au passage suivant) et le résultat s'affiche.

Export CSV comptable

Le bouton « Exporter en CSV » du journal exporte les pièces selon les filtres affichés (par exemple : factures et avoirs du mois, pour le rapprochement). Format pensé pour Excel en français : séparateur point-virgule, UTF-8 avec BOM, décimales à la virgule, une ligne par pièce.

PDF Factur-X et e-mail au client

Pennylane numérote la facture tout de suite, mais produit le PDF Factur-X (le PDF qui contient les données de la facture pour les logiciels comptables) quelques minutes plus tard, et seulement pour un client professionnel. Le module en tient compte :

• Client professionnel : le module relit la pièce (1, 2, 3 puis toutes les 5 minutes) jusqu'à ce que le Factur-X soit prêt, puis envoie l'e-mail avec ce PDF définitif. En recette, il est arrivé en moins d'une minute.
• Délai d'attente réglable (30 minutes par défaut) : au-delà, le PDF disponible part quand même, et la copie gardée par la boutique est remplacée si le Factur-X arrive ensuite (sans second e-mail).
• Particulier : pas de Factur-X (forme B2B), l'e-mail part tout de suite.
• Chaque PDF définitif est copié dans votre boutique : le compte client et le back-office le servent depuis cette copie, même si Pennylane est momentanément injoignable. Si la copie est impossible ou effacée, rien n'est perdu : le PDF est relu chez Pennylane, puis recopié.

TVA et ventes hors de France

Le taux de TVA enregistré par PrestaShop sur la commande fait foi : le module ne recalcule jamais une taxe. Il dit à Pennylane quel taux de quel pays a été appliqué, et ajoute la mention légale d'une vente sans TVA. Ces mentions suivent les règles françaises usuelles ; vous restez responsable du paramétrage des taxes de votre boutique (règles de taxes de PrestaShop) et de votre inscription au guichet unique OSS.

• La mention est imprimée par Pennylane sous « Mention spéciale » au pied du PDF (traduite en allemand ou en espagnol pour un client germanophone ou hispanophone, en anglais pour les autres langues) et reprise dans le Factur-X. Le type de vente (livraison de biens, prestation de services) est porté sur chaque pièce : un produit virtuel est une prestation, un produit physique un bien. Depuis la version 1.2.0, le réglage « Prestations de services » déclare comme prestations des produits non virtuels (installation, formation, réparation…) ; tant qu'il est vide, rien ne change.
• Taux commun à la France et au pays du client (10 % en France et en Espagne, par exemple) : c'est la règle de taxes de votre boutique qui tranche (une taxe propre au pays du client = TVA de ce pays), ou le réglage « TVA : ventes hors de France ».
• Franchise en base (article 293 B) : choisissez cette mention dans Réglages, elle est portée sur toutes les pièces sans TVA. Un texte libre peut aussi être imposé sur toutes les pièces.
• Taux inconnu (taux qui vient de changer, taux que Pennylane ne propose pas encore) : la pièce est bloquée, jamais émise fausse, avec une alerte qui dit quoi faire. Voie de secours sans attendre une mise à jour : une ligne « Correspondances TVA » dans Réglages (par exemple « AT 4,9 = AT_49 »), puis « Relancer ». Une vente à 0 % vers un particulier de l'Union européenne sans numéro de TVA est bloquée de la même façon (ni autoliquidation, ni exportation) : vérifiez la fiche du client ou vos règles de taxes.
• Devises : la facture est émise dans la devise de la commande (livre sterling, franc suisse, dollar...) ; Pennylane en tient l'équivalent en euros pour votre comptabilité. Le tableau de bord du module compte en euros.
• Langues : le PDF Pennylane suit la langue du client en français, anglais, allemand ou espagnol (les langues de Pennylane), en anglais pour une autre langue ; l'e-mail du module part aussi en italien et en néerlandais.

Taux par pays : base TEDB de la Commission européenne au 20/10/2026, codes vérifiés auprès de Pennylane à la même date. Deux taux officiels ne sont pas encore proposés par Pennylane (Autriche 4,9 %, Estonie 13 %) : les pièces concernées sont bloquées et signalées. Dès que Pennylane leur aura donné un code, une ligne « Correspondances TVA » les débloquera sans attendre une mise à jour du module.

Remboursements et avoirs

Faites vos remboursements comme d'habitude, depuis la fiche commande du back-office, en gardant « Générer un avoir » coché. Le module émet alors l'avoir Pennylane correspondant :

• remboursement d'articles (quantités), remboursement partiel en montant, remboursement du port, retour produit ;
• avoir lié à sa facture, numéroté par Pennylane (dans la même suite que les factures) ;
• contrôle du reste à créditer AVANT l'émission : un avoir qui dépasserait la facture est bloqué et signalé, au lieu d'être numéroté puis refusé par Pennylane. Le reste à créditer vaut le montant TTC de la facture moins les avoirs déjà émis pour elle (ceux du module et ceux saisis directement dans Pennylane, comptés une seule fois). Il ne dépend pas du paiement : une facture payée, ou rapprochée d'un virement dans Pennylane (son « reste à payer » tombe alors à 0), reste entièrement créditable ;
• l'avoir d'une facture déjà émise part toujours, même si la licence n'est plus valide.

Commande réglée avant la mise en service. Sa facture est celle de PrestaShop, que Pennylane ne connaît pas : un avoir Pennylane resterait orphelin, le module n'en crée donc pas. Depuis la version 1.0.1, il ne reste plus muet : chaque bordereau établi depuis la mise en service sur une telle commande lève l'alerte « Avoir d'une commande non facturée par le module », une seule fois par bordereau, avec deux boutons :

• « Bordereau PrestaShop (PDF) » : l'avoir de PrestaShop, à remettre au client ou à votre comptable ;
• « Émettre l'avoir » : il transmet l'avoir si la facture de la commande a depuis été émise par le module ; sinon, il explique pourquoi rien n'est parti, sans rien créer dans Pennylane.

Établissez l'avoir là où la facture d'origine a été émise (avoir PrestaShop, ou avoir saisi dans Pennylane si la facture y a été reprise), selon votre organisation comptable, puis cliquez « Marquer comme traité » : l'alerte ne revient pas. Les bordereaux établis avant la mise en service ne déclenchent aucune alerte.

Alertes

Le module vous prévient quand il a besoin de vous, dans l'onglet (pastille du menu, encart « À traiter ») et par e-mail : au plus un e-mail par jour et par type d'alerte, à l'adresse choisie dans les réglages (par défaut, l'e-mail de la boutique), en français ou en anglais selon la langue de la boutique.

Panne de Pennylane et pro forma

La vente n'est jamais bloquée, et la boutique ne crée jamais une seconde numérotation de factures. Si Pennylane ne répond pas, la pièce reste dans la file d'envoi et repart seule : 5 minutes, 15 minutes, 1 heure, 3 heures, puis toutes les 6 heures, sans limite. Au retour de Pennylane, une sonde légère (toutes les 10 minutes au plus) relance les pièces en attente sans attendre leur prochain essai.

Facture pro forma

• Une facture pro forma (série PF-AAAA-NNNNN, mention « Document provisoire, ne vaut pas facture ») est créée au premier échec et visible dans « Vos documents ». Son contenu (lignes, total, adresse) est figé à l'émission.
• Elle est envoyée au client au troisième échec.
• Elle est remplacée par la facture officielle dès que Pennylane répond ; l'e-mail de la facture le mentionne.

Pannes longues

Les alertes sont graduées selon l'âge de la file : pastille dans le menu à 1 heure, e-mail à 24 heures, bandeau rouge sur tout le back-office à 72 heures. Une erreur interne du module est distinguée d'une panne de Pennylane : alerte « Erreur de la boutique », jamais de bandeau « Pennylane ne répond plus ».

Plus besoin de tâche planifiée

Le traitement de la file se fait en tâche de fond depuis le front de la boutique, au plus toutes les 15 minutes, seulement s'il y a du travail et après l'envoi de la page : aucune tâche planifiée n'est à créer. La file avance aussi à chaque commande, à chaque remboursement, et au plus toutes les 5 minutes quand le back-office est ouvert.

La tâche planifiée reste possible : l'adresse à appeler (une seule pour toutes les boutiques) est affichée dans Réglages, par exemple avec la ligne crontab */15 * * * * curl -fsS "adresse" > /dev/null ou l'outil de tâches planifiées de votre hébergeur. Le tableau de bord affiche son dernier passage.

Une pièce n'est jamais envoyée deux fois : chaque facture et chaque avoir portent une référence unique chez Pennylane, et le module relit ce qui existe avant toute nouvelle tentative.

Si un envoi automatique échoue

Chaque automatisme du module a sa voie de secours manuelle. Elles sont dans le bloc « Pennylane » de la fiche commande (sous chaque pièce émise) et dans le journal (colonne d'actions de chaque pièce). Chaque bouton demande une confirmation, et le dernier état de chaque action, avec sa date et son origine (automatique ou bouton), reste affiché sous la pièce.

Plateforme agréée : ce qui se passe

Pennylane transmet de lui-même la facture à la plateforme agréée du client au moment où il la finalise, à une condition : la fiche de ce client dans Pennylane doit déjà porter son adresse de facturation électronique (celle de l'annuaire) ; Pennylane ne la remplit pas seul. Depuis la version 1.2.0, le module la pose lui-même : juste avant de finaliser la facture ou l'avoir d'un client professionnel français, il lit l'annuaire de la facture électronique sur la fiche Pennylane du client et y pose l'adresse qui correspond à son SIRET (sinon à son SIREN seul), puis la relit. Le résultat est affiché sur la fiche commande et au journal. Ce contrôle ne bloque jamais : en cas d'échec, la pièce est finalisée quand même. Le module ne renvoie plus la pièce après coup : il relit son statut par la file et l'affiche dans le journal, sur la fiche commande et au tableau de bord. Il ne la soumet lui-même qu'en secours (bouton, ou aucun statut affiché par Pennylane après la dernière relecture). Le réglage « Transmettre à la plateforme agréée » coupe tout ce mécanisme. Les avoirs suivent le même chemin.

• Particulier ou client étranger : pas de facture électronique, rien n'est transmis, sans alerte. C'est normal.
• Professionnel français sans adresse à la finalisation (« non transmise ») : une alerte par pièce, qui donne le remède (avoir puis nouvelle facture). C'est un avertissement, pas une panne : le client reçoit sa facture par e-mail.
• « Non éligible » : réponse de Pennylane à une transmission de secours. Refus définitif : une alerte, aucun nouvel essai automatique (la retente à 7 jours des versions précédentes, toujours vaine, a disparu en 1.2.0). Si Pennylane affiche la pièce « Non envoyé », son option « Marquer comme envoyée » retire cette mention sans renvoyer d'e-mail au client.
• « Refusée » ou rejetée par la plateforme : alerte avec le motif, pas de nouvel essai automatique. Corrigez (droits du jeton, fiche client dans Pennylane), puis le bouton.
• Pennylane injoignable : nouvel essai programmé, sans alerte.

Réglages

Le jeton d'API (vérification des droits, remplacement, voir Jeton d'API) et la clé de licence se gèrent aussi depuis Réglages.

Intégration au thème

Le module s'affiche correctement tel quel sur Classic (PrestaShop 1.7 et 8), Hummingbird (PrestaShop 9) et leurs thèmes enfants. Sa feuille de style pfp-front.css est autonome : elle ne dépend pas du thème et n'est chargée que sur les pages du module, le détail de commande et le suivi d'une commande invité. Pour l'adapter à votre boutique, deux niveaux, sans toucher au module :

• Des variables CSS, posées sur :root avec le préfixe --pfp-f- pour éviter toute collision (accent, texte, fond et bordure des cartes, couleurs d'état, arrondi, marge). Redéfinissez-les dans le CSS de votre thème, par exemple :root { --pfp-f-accent: #0f766e; --pfp-f-rayon: 0; }. Les classes du module commencent par pfp- (notation BEM).
• Des gabarits surchargeables par le mécanisme standard de PrestaShop : copiez le fichier dans themes/<votre-thème>/modules/pennylanefacturationpro/views/templates/… en gardant le même chemin. Vos retouches survivent aux mises à jour du module. C'est le cas du bloc « Vos documents » du détail de commande (hook/documents.tpl, qui affiche aussi la facture pro forma) et des e-mails (pfp_facture, pfp_avoir, pfp_proforma, dans mails/<langue>/, en .html et .txt).

Les réglages de couleur et de CSS libre côté client ainsi que les pages de devis relèvent de l'édition Ultimate. Un document d'aide à l'intégration, docs/INTEGRATION-THEME.md, est livré avec le module.

Multiboutique et licence

• Une licence = une installation PrestaShop, qui couvre jusqu'à 5 boutiques, conformément aux conditions générales de vente du 1er novembre 2026, appliquées par anticipation depuis le 21 octobre 2026.
• Réglages par boutique : choisissez la boutique dans le sélecteur de PrestaShop en haut de page, puis réglez son jeton (donc son entreprise Pennylane), son mode, ses e-mails de test, ses alertes. Une boutique sans réglage propre utilise les réglages communs (contexte « toutes les boutiques »).
• Au-delà du plafond, la boutique en trop s'éteint seule : ses ventes continuent, ses factures attendent en file et partent dès qu'elle est couverte ; les autres boutiques ne sont jamais coupées. Le tableau de bord indique la couverture de chaque boutique.
• Un seul traitement en tâche de fond couvre toutes les boutiques, chacune avec ses réglages, sa licence et, au besoin, son propre compte Pennylane.
• En contexte « toutes les boutiques », le tableau de bord et le journal montrent l'ensemble, avec un filtre par boutique ; en contexte boutique, seulement ses pièces.
• Une clé validée reste active 30 jours même si nos serveurs sont injoignables.

Questions fréquentes

Mes anciennes commandes vont-elles être refacturées ?

Non. Seules les commandes payées après la mise en service (passage en mode Test ou Actif) sont facturées par Pennylane, y compris une commande passée avant mais réglée après. Les commandes déjà réglées gardent leur facture PrestaShop ; un remboursement sur l'une d'elles est signalé par une alerte (voir Remboursements et avoirs).

Je vends hors de France : le module convient-il ?

Oui, depuis la version 1.1.0 : TVA des autres pays de l'Union européenne (guichet unique OSS), autoliquidation pour vos clients professionnels de l'Union, exportation, outre-mer, devises et langues de vos clients. Le détail est dans TVA et ventes hors de France. Le module reprend le taux que PrestaShop a appliqué : le paramétrage des taxes de votre boutique reste de votre ressort.

Mes commandes de places de marché (eBay, Amazon…) sont-elles facturées ?

Oui : le module facture toute commande qui passe à un état payé dans PrestaShop, quelle que soit son origine. Si le module de la place de marché produit lui-même un PDF de facture PrestaShop pour l'envoyer à l'acheteur, ce PDF reste celui de PrestaShop, sauf si vous cochez « Modules tiers » dans Réglages (seulement si ce module fait télécharger la facture). Vérifiez son réglage avant de couper la facture PrestaShop, ou contactez-nous : un module peut aussi lire le PDF Pennylane par Pennylanefacturationpro::pdfFacture($idCommande).

Que se passe-t-il si je désactive le module ?

Plus rien ne part vers Pennylane et la facture PrestaShop est rétablie automatiquement. Le journal, les copies des PDF et les pièces déjà émises sont conservés.

Pourquoi mon client professionnel reçoit-il sa facture quelques minutes après sa commande ?

Le module attend le PDF Factur-X définitif de Pennylane (voir PDF Factur-X). Mettez l'attente à 0 si vous préférez un envoi immédiat.

Les avoirs ont-ils leur propre numérotation ?

Non, Pennylane numérote les avoirs dans la même suite que les factures. C'est conforme.

Et si je change d'entreprise Pennylane ?

Avant toute émission, « Débrancher le jeton » puis collez celui de la nouvelle entreprise. Dès qu'une pièce a été émise, le module n'accepte plus qu'un jeton de la même entreprise : les avoirs de vos factures doivent partir dans l'entreprise qui les a numérotées (voir Jeton d'API).

Pennylane affiche un « reste à payer » sur une facture payée : est-ce un impayé ?

Non. Quand la commande est payée, le module déclare la facture payée dans Pennylane : elle y passe à l'état « payée ». Mais Pennylane garde son reste à payer tant que la facture n'est pas rapprochée d'un mouvement bancaire : le rapprochement avec la banque reste à faire dans Pennylane. Le tableau de bord, le journal et l'export CSV du module se fient au marquage « payée », jamais à ce reste : une facture déclarée payée n'y est jamais comptée comme impayée. Le contrôle des avoirs ne s'en sert pas non plus (voir Remboursements) : une facture rapprochée reste remboursable par avoir.

Puis-je garder le module officiel « Pennylane » en même temps ?

Non, chaque commande serait facturée deux fois. Le mode Actif reste verrouillé tant qu'il est actif.

Le module ralentit-il ma boutique ?

Non. Les appels à Pennylane se font au moment du paiement ou dans la file, avec des délais courts ; une panne de Pennylane ne bloque jamais une commande.

Dépannage

Une pièce est « Bloquée »

Le motif est affiché à côté de la pièce (journal, fiche commande). Corrigez la cause, puis « Relancer ». Les motifs les plus courants : jeton refusé, numérotation non configurée dans Pennylane, taux de TVA inconnu ou vente à 0 % sans justification (voir TVA), avoir supérieur au reste à créditer de la facture (un avoir a déjà été saisi dans Pennylane).

Le jeton est refusé

Cliquez « Vérifier les droits » : un refus complet (jeton expiré, supprimé ou copié en partie, ou offre Pennylane sans API) s'affiche en rouge, un droit manquant porte la mention « droit absent ». Créez alors un nouveau jeton dans la même entreprise avec « Lecture et écriture » sur « Clients » et « Factures client », puis remplacez-le (voir Jeton d'API). Les factures attendent en file pendant ce temps : rien n'est perdu.

« Numérotation : contrôlée à la première facture du mode Test »

Votre compte Pennylane n'a encore aucune facture finalisée : réglez la numérotation dans Pennylane (Paramètres › Facturation) avant votre commande d'essai.

Mes clients reçoivent deux numéros de facture

Coupez la facture PrestaShop (dernière étape de l'assistant) une fois vos essais terminés, et vérifiez que le module officiel « Pennylane » n'est pas actif.

Des PDF restent « Factur-X attendu »

La file avance en tâche de fond depuis la boutique, quand celle-ci reçoit des visites : vérifiez son dernier passage au tableau de bord, ou cliquez « Traiter la file maintenant ». Sur une boutique très peu visitée, une tâche planifiée la fait avancer la nuit (voir Panne de Pennylane et pro forma).

Je ne reçois pas les alertes par e-mail

Vérifiez l'adresse et la case « Alertes par e-mail » dans Réglages, et l'envoi d'e-mails de votre boutique (Paramètres avancés › E-mail). Le bouton « Envoyer le récapitulatif maintenant » du tableau de bord force un envoi.

Taux de TVA pris en charge

Les taux français, ceux des 27 pays de l'Union européenne, de la Suisse, du Royaume-Uni et de la Norvège, et 0 % (autoliquidation, exportation, exonération). Une commande portant un autre taux est bloquée avec un message clair plutôt que facturée fausse ; la voie de secours « Correspondances TVA » la débloque (voir TVA et ventes hors de France). Une ligne soumise à plusieurs taxes cumulées (États-Unis, Canada) se débloque de la même façon, avec un code sans TVA.

Versions et nouveautés

La mise à jour se télécharge dans votre espace client (Mes commandes, archive adaptée à votre version de PrestaShop), puis s'installe comme le module : Modules › Gestionnaire de modules › Installer un module, par-dessus la version en place. Vos réglages, votre clé de licence, votre jeton, vos pièces et vos alertes sont conservés. Sur PrestaShop 1.7, rechargez la page du gestionnaire de modules (Ctrl+F5) avant d'envoyer l'archive, puis ouvrez l'onglet Commandes › Pennylane une fois : la mise à jour s'y termine.

Version 2.0.0 du 26/10/2026

C'est une mise à jour de la 1.2.0 : mêmes réglages, même onglet, mêmes liens envoyés à vos clients. Rien ne se perd, et le module termine seul la mise à jour de ses données au premier passage.

• Panne de Pennylane : jamais de seconde numérotation de factures. Une facture pro forma (PF-AAAA-NNNNN, « Document provisoire, ne vaut pas facture ») est créée au premier échec, envoyée au client au troisième, puis remplacée par la facture officielle. Alerte graduée selon l'âge de la file (pastille à 1 h, e-mail à 24 h, bandeau rouge à 72 h), sonde légère au retour de Pennylane, erreur interne de la boutique distinguée d'une panne (voir Panne de Pennylane et pro forma).
• Plus besoin de tâche planifiée : la file est traitée en tâche de fond depuis le front, au plus toutes les 15 minutes et seulement s'il y a du travail. La tâche planifiée reste possible.
• Intégration au thème : feuille de style autonome pfp-front.css, chargée sur les seules pages du module, du détail de commande et du suivi invité ; gabarits surchargeables par le thème ; crochets reposés automatiquement quand leur liste change (voir Intégration au thème).
• Corrections de l'audit : portée boutique des alertes en multiboutique, garde-fou contre la double facturation étendu à l'édition Ultimate (refus d'installation, mode Actif verrouillé), compatibilité avec PHP 8.4 et plus, Réglages lisibles sur téléphone.
• Traductions : anglais complet, pages client et e-mails en 6 langues.
• Réservé à l'Ultimate : référence de paiement transmise à Pennylane, rapprochement bancaire, devis, couleur et CSS libre du front. Ces fonctions n'apparaissent pas dans la Pro (voir Pro ou Ultimate).

Version 1.2.0 du 22/10/2026

• Adresse de facturation électronique posée avant la finalisation : avant chaque facture et chaque avoir d'un client professionnel français, le module pose sur sa fiche Pennylane l'adresse trouvée dans l'annuaire (celle de son SIRET, sinon son SIREN seul), pour que Pennylane transmette lui-même la pièce à la plateforme agréée du client en la finalisant (voir Plateforme agréée : ce qui se passe).
• Plus d'envoi en double : la pièce n'est plus soumise une seconde fois par le module après sa transmission par Pennylane ; la soumission par le module ne sert plus qu'en secours.
• Alerte claire pour un client professionnel français absent de l'annuaire : facture envoyée par e-mail, remède indiqué (avoir puis nouvelle facture). Un particulier ou un client étranger ne déclenche plus d'alerte.
• Fin de la retente à 7 jours des pièces « non éligibles », qui ne pouvait pas aboutir : refus définitif, une alerte, aucun nouvel essai.
• Brouillon repris (pièce créée lors d'un passage précédent) : date et échéance remises au jour de la finalisation.
• Fiche client Pennylane : une mise à jour refusée est journalisée et retentée à la pièce suivante (elle était tenue pour faite).
• Nouveau réglage « Prestations de services » (catégories et produits) pour des prestations vendues comme produits non virtuels ; sans effet tant qu'il n'est pas rempli.

Version 1.1.1 du 21/10/2026

• Mention légale dans la langue du PDF : sous la mention française, la traduction est en allemand ou en espagnol pour un client germanophone ou hispanophone (en anglais auparavant), en anglais pour les autres langues.
• Taxes cumulées (États-Unis, Canada) : message qui nomme les taxes et le taux total, et voie de secours par « Correspondances TVA » avec une ligne « Taxes locales » à part (seule la première taxe était lue). Une taxe d'un pays hors de l'Union au même taux qu'un taux français (13 % en Ontario, par exemple) n'est plus déclarée comme TVA française quand la règle de taxes porte une taxe propre à ce pays.
• Prestations hors de l'Union : article 259-1 pour un client professionnel, article 259 B pour un particulier.
• Clients professionnels hors de l'Union : numéro d'identification (CHE-…, GB…) imprimé dans la mention ; un numéro que Pennylane ne sait pas lire ne bloque plus la création de la fiche client.
• Irlande du Nord : client au numéro de TVA XI, biens à 0 % traités en livraison intracommunautaire.
• Onglet du back-office : demandes de confirmation rétablies avant chaque bouton (« Renvoyer l'e-mail », « Forcer payée », « Transmettre à la plateforme agréée »…), « Tout cocher » réparé, colonne des boutons du journal sans défilement horizontal, titre du bloc Pennylane de la fiche commande corrigé en PrestaShop 1.7.5 et 1.7.6.
• Fiche client refusée par Pennylane quand deux clients du même nom sont créés au même instant : nouvel essai automatique au lieu d'un blocage.

Version 1.1.0 du 20/10/2026

• TVA des autres pays de l'Union européenne (guichet unique OSS) : une vente au taux du pays du client est désormais facturée par Pennylane (elle était bloquée en 1.0).
• Autoliquidation, exportation, outre-mer : mention légale imprimée sur la facture et l'avoir, numéro de TVA du client, type de vente ; franchise en base et texte imposé en réglage.
• Taux inconnu : pièce bloquée avec une alerte et une voie de secours (« Correspondances TVA »).
• Devises : une commande dans une autre devise que l'euro est facturée dans sa devise (elle était bloquée en 1.0).
• Langues : e-mails en allemand, espagnol, italien et néerlandais en plus du français et de l'anglais ; PDF Pennylane en allemand et en espagnol ; la facture d'un client italien n'est plus bloquée.
• PDF : facture Pennylane servie au téléchargement depuis le back-office et par les liens habituels du compte client dès PrestaShop 1.7.5 ; anciennes factures PrestaShop toujours accessibles au client une fois la facture PrestaShop coupée ; option pour les modules tiers.

Version 1.0.1 du 20/10/2026

• Commande passée avant la mise en service mais payée après : la facture Pennylane est désormais émise (en 1.0.0, avec la facture PrestaShop coupée, une telle commande n'en avait aucune). Une commande réglée avant la mise en service, ou dont PrestaShop a déjà numéroté la facture, n'est toujours jamais refacturée.
• Remboursement d'une commande antérieure : il n'est plus ignoré en silence. Une alerte par bordereau, avec le PDF du bordereau PrestaShop et « Émettre l'avoir » (voir Remboursements et avoirs).
• Alerte « Remboursement sans avoir » : une fois marquée traitée, elle ne revient plus.
• E-mail au client dans la langue de sa commande (français ou anglais), montants dans la devise de la commande, aussi dans « Vos documents », la fiche commande et le journal.
• Envoi plus robuste : si Pennylane ne retrouve pas un brouillon juste après l'avoir créé, la pièce est simplement réessayée au passage suivant au lieu d'être bloquée.

Version 1.0.0 du 19/10/2026

Première version : factures et avoirs émis par Pennylane, file de secours, onglet Commandes › Pennylane (tableau de bord, journal, export CSV, alertes, assistant de mise en service), transmission à la plateforme agréée, PrestaShop 1.7.5 à 9.x.

Pro ou Ultimate

Les deux éditions émettent les mêmes factures et les mêmes avoirs dans Pennylane (numérotation unique, TVA de l'Union européenne, export, plateforme agréée, pro forma pendant une panne, multiboutique). Pennylane Facturation Ultimate ajoute, pour la Pro :

• le suivi des paiements : moyen et référence de paiement transmis à Pennylane avec la facture ;
• le rapprochement bancaire des factures avec les mouvements de votre banque lus dans Pennylane, avec écran de contrôle et retour arrière sur chaque rapprochement (il demande les droits « Lecture seule » sur les transactions et les comptes bancaires) ;
• les devis, acceptés ou refusés par le client dans Mon compte ;
• une apparence côté client réglable (couleur d'accent, CSS libre).

Les deux éditions ne s'installent pas sur la même boutique : chacune facturerait les commandes.

Voir la documentation de Pennylane Facturation Ultimate

Besoin d'aide ?

Notre équipe répond aux questions d'installation, de configuration et d'usage de ce module. Précisez votre version de PrestaShop, votre version de PHP, votre offre Pennylane, le domaine concerné et, si possible, la référence de la pièce et une capture de l'onglet Commandes › Pennylane.