Factures et avoirs pour Pennylane
Module PrestaShop — guide d'installation et de configuration
Version 1.0.9 du module
Télécharger ce guide en PDFInstallation, mise à jour et désinstallation
Module « Factures et avoirs pour Pennylane » (rcinvoicesync), version 1.0.9. La configuration détaillée est dans le guide de configuration.
1. Prérequis
| Élément | Exigence |
|---|---|
| PrestaShop | 1.6.1.x, 1.7.x, 8.x ou 9.x (versions vérifiées : 1.6.1.24, 1.7.1.2, 1.7.7.8, 1.7.8.11, 8.2.7, 9.2.0) |
| PHP | 7.1 ou plus récent, dans les limites de votre version de PrestaShop (vérifié de 7.1 à 8.5). Sur PHP plus ancien, le module refuse de s'installer avec un message clair |
| Extensions PHP | cURL et OpenSSL (obligatoires) ; intl recommandée (noms de domaine accentués) |
| Réseau | Connexions HTTPS sortantes vers app.pennylane.com et licences.romain-couzon.fr |
| Pennylane | Un compte qui permet de créer un jeton d'API (Paramètres > Connectivité > Développeurs) |
| Autre connecteur | Si un autre module envoie déjà vos factures à Pennylane, décidez lequel les envoie : deux modules ne doivent pas traiter les mêmes factures (voir les limites) |
| Navigateur | Celui du back-office PrestaShop |
Une boutique multiboutique est couverte par une seule licence ; chaque boutique a sa propre connexion Pennylane et ses propres réglages.
2. Choisir le paquet
| Votre PrestaShop | Paquet |
|---|---|
| 1.6.1.x | rcinvoicesync-1.0.9-ps16.zip |
| 1.7.0 à 8.2 | rcinvoicesync-1.0.9-ps17.zip |
| 9.x | rcinvoicesync-1.0.9-ps9.zip |
Les trois paquets se téléchargent sur la page indiquée dans l'e-mail d'achat, avec votre clé de licence.
3. Installer
- Back-office PrestaShop : Modules > Gestionnaire de modules > Téléverser un module, puis choisissez le ZIP.
- Ouvrez la configuration du module.
- Licence : collez votre clé, choisissez « la boutique en production » (ou « une préproduction » pour une copie de test), puis Activer. La licence se rattache alors au nom de domaine de la boutique par défaut : elle n'est valable que pour lui, et couvre toutes les boutiques de l'installation (changement d'adresse : une fois par période de 12 mois, voir le § 6).
- 1. Connexion à Pennylane : collez le jeton d'API. Le module affiche la société Pennylane trouvée.
- 2. Situation fiscale, 3. Bons et cartes cadeaux et, avec votre comptable si besoin, 4. Comptes et ventilation : voir le guide de configuration.
- 5. Envoi : la date de départ (par défaut le jour de l'installation) et le mode (manuel par défaut). À régler avant de valider : toute modification après la validation en demande une nouvelle.
- Dernière étape, en bas de la page : Vérifier ma configuration, puis cochez la confirmation de responsabilité et Valider ma configuration. Aucun envoi vers votre société Pennylane n'a lieu avant cette validation.
- Menu Commandes > Pennylane : la liste des documents. Envoyez un premier document et vérifiez-le dans Pennylane.
- Facultatif : la tâche planifiée (section 6) pour l'envoi automatique en dehors des heures d'utilisation du back-office.
Pour reprendre l'historique (documents antérieurs à la date de départ) : Commandes > Pennylane > Envoyer une période.
4. Sans licence, préproduction
- Tant que la licence n'est pas activée, le module fonctionne entièrement vers une société de test Pennylane (sandbox) : rien n'est envoyé vers une société réelle.
- Une préproduction (copie de la boutique) s'active gratuitement avec la même clé en choisissant « une préproduction » ; elle n'envoie qu'à des sociétés de test.
- Une copie de la boutique de production n'envoie rien tant que vous n'avez pas confirmé son domaine dans la section 1 : protection contre les envois en double.
5. Mettre à jour
- Téléchargez la nouvelle version (lien « Télécharger le module » dans la section Licence de la configuration, ou page de téléchargement de l'e-mail d'achat). Les versions publiées pendant votre maintenance sont disponibles ; après la fin de la maintenance, la dernière version publiée avant cette date reste téléchargeable.
- Modules > Téléverser un module avec le nouveau ZIP, sans désinstaller : vos réglages, votre licence et l'historique des envois sont conservés.
- Les tables du module sont mises à jour automatiquement au premier passage. Un cache PHP (OPcache) qui ne relit pas les fichiers est détecté : le module se recharge seul.
- Vos réglages et leur validation sont conservés. Une nouvelle validation n'est demandée que si la nouvelle version change un réglage existant (l'historique des versions le signale alors).
- Les documents pas encore envoyés sont analysés à nouveau une fois. Un document bloqué que la nouvelle version juge valide ne part jamais seul, même en envoi automatique : il apparaît « À valider » avec le motif « Débloqué par la mise à jour ». Vérifiez qu'il n'a pas été saisi à la main dans Pennylane entre-temps, puis envoyez-le (un par un ou par sélection) ou marquez-le « traité hors module ».
- Ne désinstallez jamais le module pour le mettre à jour : la désinstallation retire les réglages.
- Utilisez toujours le paquet de votre version de PrestaShop (tableau du § 2) et une version égale ou plus récente. PrestaShop ne le vérifie pas lors d'une mise à jour ; le module, si : avec un mauvais paquet ou une version plus ancienne, il s'arrête et indique le ZIP à installer. Installer ce ZIP suffit, rien n'est perdu.
Changer de version de PrestaShop : de 1.7 vers 8, même paquet ps17 ; vers PrestaShop 9, téléversez le paquet ps9 après la migration de la boutique.
6. Changer de serveur ou de domaine
- Même domaine (nouveau serveur, réinstallation) : rien à faire, la licence se renouvelle seule.
- Nouveau domaine : les envois continuent pendant 30 jours ; dans la section Licence, Transférer la production vers ce domaine (une migration par période de 12 mois ; un changement d'hébergeur à la même adresse n'en est pas une). Confirmez aussi le domaine dans la section 1.
7. Désinstaller
- Par défaut, la désinstallation conserve l'historique (ce qui a été envoyé) et la licence : une réinstallation ne renvoie jamais un document déjà présent dans Pennylane.
- Pour tout effacer, activez « Effacer l'historique à la désinstallation » (section 6) avant de désinstaller. Pour libérer la licence au profit d'une autre installation : Désactiver dans la section Licence.
- Après un effacement de l'historique, le module reconnaît encore les factures déjà présentes dans Pennylane à leur numéro. Si vous reprenez ensuite une période déjà envoyée, gardez le même préfixe de factures qu'à l'époque (retirer seulement le « # » ne pose pas de problème).
8. En cas de problème
- Lisez le motif affiché sur le document (Commandes > Pennylane) : il explique la cause et la marche à suivre.
- Vérifier ma configuration signale ce qui empêche les envois (connexion, licence, validation, comptes).
- Si besoin, contactez le support avec le rapport de diagnostic (section 6, « Télécharger le rapport de diagnostic ») : voir SUPPORT.md.
Configuration
À l'intention du marchand et de son expert-comptable. Version 1.0.9 du module, 15 octobre 2026.
Qui fait quoi
- Vous (avec votre expert-comptable si vous en avez un) choisissez les réglages fiscaux et comptables : régime de TVA, nature de vos ventes, comptes, traitement des cartes cadeaux. Vous les confirmez dans le module (« Valider ma configuration »).
- Le module applique fidèlement ces réglages. Il garantit la fiabilité de la synchronisation et l'intégrité des données transmises : montants, TVA, numéros, absence de doublon, avoirs liés à leur facture.
- Le module ne modifie jamais une facture ou un avoir émis par PrestaShop. Quand un document est incohérent, il n'est pas envoyé : le module explique pourquoi et comment le traiter.
Avant de commencer
- Un jeton d'API Pennylane, créé dans Pennylane : Paramètres > Connectivité > Développeurs. Droits nécessaires : Factures clients (lecture et écriture), Clients (lecture et écriture), Fichiers (lecture et écriture). Droits facultatifs, seulement si vous les utilisez : Comptes comptables (lecture) pour choisir vos comptes ; Écritures comptables (lecture et écriture) et Journaux (lecture) pour l'écriture complémentaire automatique des cartes cadeaux.
- La clé de licence reçue par e-mail. Tant qu'elle n'est pas activée, le module n'envoie qu'à une société de test Pennylane : vous pouvez tout vérifier avant d'envoyer à votre société réelle.
La configuration, section par section
Chaque réglage est expliqué dans l'écran. Les valeurs par défaut conviennent à la plupart des boutiques qui vendent des biens en France.
Licence
| Réglage | Par défaut | Effet |
|---|---|---|
| Clé de licence | — | Une licence vaut pour un seul nom de domaine : celui de la boutique par défaut de votre installation, enregistré lors de la première activation en production. Elle couvre toute l'installation PrestaShop, quel que soit le nombre de boutiques. Pour un autre site, il faut une autre licence ; les préproductions (copies de test) sont gratuites. Changement d'adresse : une fois par période de 12 mois, depuis le module. La licence reste valable sans limite de durée ; seules les mises à jour et le support dépendent de la maintenance. |
| Production ou préproduction | Production ; préproduction si l'adresse ressemble à une copie de test (localhost, preprod., staging., /preprod…) | Une préproduction (copie de test) est gratuite et n'envoie qu'à des sociétés de test Pennylane. La proposition ne se fonde que sur l'adresse : vérifiez-la avant d'activer. |
Changement de domaine (migration) : le module continue d'envoyer pendant 30 jours ; transférez la licence depuis cet écran. Si le serveur de licences est injoignable, rien ne change : les envois continuent.
Une fois la licence activée, l'écran affiche la fin de la maintenance et deux liens : Télécharger le module (les versions auxquelles votre maintenance donne droit) et Renouveler la maintenance (paiement de 12 mois supplémentaires, facultatif).
1. Connexion à Pennylane
Le jeton est chiffré dans la boutique et n'est jamais réaffiché. Une copie de la boutique (préproduction) n'envoie rien tant que vous n'avez pas confirmé son domaine : c'est une protection contre les envois en double depuis une copie.
2. Situation fiscale (obligatoire)
| Réglage | Par défaut | Conséquences |
|---|---|---|
| Régime de TVA | — (à choisir) | Franchise en base : aucune ligne avec TVA n'est acceptée. |
| Guichet unique OSS | — | Inscrit à l'OSS (impots.gouv.fr) : la TVA d'un client particulier d'un autre pays de l'UE est celle de son pays. Jamais inscrit, ou ventes en France seulement : Non. |
| Ventes à 0 % en France exonérées | Non | Oui seulement si la loi exonère vos ventes sans TVA (formation professionnelle, soins…). L'autoliquidation (sous-traitance du bâtiment) et la TVA sur la marge (biens d'occasion) ne sont pas des exonérations : avec Oui, elles partiraient comme exonérées. Avec Non, une facture française à 0 % est bloquée (souvent une erreur de réglage des taxes). |
| Vous vendez | — (biens ou services) | Décide du compte de vente (707 ou 706) et de l'exigibilité de la TVA dans Pennylane : sur les débits pour les biens, sur les encaissements pour les services. Si vous vendez aussi l'autre (la pose d'un appareil, par exemple), utilisez les exceptions. |
| Exceptions par catégorie ou par produit | aucune | Pour une boutique qui vend des biens et des services. Identifiants : colonne ID de Catalogue > Catégories ou Catalogue > Produits. Seule la catégorie par défaut du produit compte, pas ses sous-catégories : listez chacune. Le port et l'emballage suivent les produits livrés. Seules les exceptions utiles à votre réponse sont affichées. |
Le pays retenu pour la TVA est celui de l'adresse sur laquelle PrestaShop la calcule : l'adresse de livraison, sauf réglage contraire de la boutique (International > Taxes). Une facture adressée en France et livrée en Autriche porte la TVA autrichienne pour une boutique inscrite à l'OSS.
L'option pour la TVA sur les débits d'un prestataire de services se règle dans Pennylane, pas dans le module.
3. Bons et cartes cadeaux
PrestaShop enregistre tous les bons comme des remises. Une carte cadeau ou un crédit client utilisé à la commande est pourtant un moyen de paiement.
Vous ne vendez ni cartes cadeaux ni bons créés à la main ? Répondez « Non » aux deux questions : les réglages des cartes disparaissent. Seule reste à choisir la comptabilisation des crédits clients : PrestaShop crée un tel bon quand vous remboursez un client en bon d'achat (codes V…C…O…). Un bon offert sans avoir (geste commercial, dédommagement) est une remise : il ne compte pas comme bon de remboursement.
| Réglage | Par défaut | Conséquences |
|---|---|---|
| Vous vendez des cartes cadeaux | — | Sans réponse, un bon à montant fixe attend votre qualification. |
| Bons de remboursement manuels | — | Oui seulement pour des bons que vous créez vous-même après un avoir. Les bons créés par PrestaShop lors d'un remboursement (codes V…C…O…) sont reconnus automatiquement. |
| Préfixes des codes, produits cartes | — | Permettent de reconnaître vos cartes et crédits. |
| Nature des cartes | — | Usages multiples (cas général : produits à plusieurs taux, ou commandes livrées hors de France) : la TVA est due à l'utilisation ; le produit carte a une règle de taxe à 0 %. Usage unique (France, un seul taux) : la TVA est due dès la vente ; le produit carte porte le taux des produits qu'elle paie. Dans le doute : usages multiples. |
| Comptabilisation, usage unique | — | « Comme PrestaShop » (la carte est une remise ; le chiffre d'affaires est constaté à la vente, les cartes non utilisées sont à neutraliser en clôture) ou « sur le compte de la carte » (4191 : Pennylane traite la vente et l'utilisation comme un acompte, et déclare la TVA de la vente une fois le paiement rapproché). |
| Comptabilisation, usages multiples et crédits clients | — | « Relevé à comptabiliser » ou « écriture complémentaire automatique ». Voir ci-dessous. |
| Comptes des cartes et des crédits | aucun | Numéro de votre plan Pennylane (4191, 4197…). Recherché dans Pennylane. Un compte désactivé ou absent doit être activé ou créé dans Pennylane. |
Pourquoi un traitement particulier ? Pour une carte à usages multiples ou un crédit client, la facture que PrestaShop remet au client montre moins de TVA que due : PrestaShop a déduit la carte comme une remise. Le module n'altère pas cette facture. Il l'envoie telle quelle, place la part de la carte sur ses propres lignes, taux par taux, puis :
- Relevé à comptabiliser : le menu Commandes > Pennylane liste, mois par mois et taux par taux, la TVA à reporter, avec l'écriture à passer (export CSV). Vous ou votre comptable la passez, puis vous marquez les lignes comme comptabilisées.
- Écriture complémentaire automatique : le module passe lui-même l'écriture dans le journal des opérations diverses, une par facture, jamais deux fois. Il la construit d'après ce que Pennylane a réellement comptabilisé pour la facture. Exemple vérifié : carte sur 4191, Pennylane la déduit comme un acompte et met sa TVA en attente sur 4458 ; l'écriture est alors « débit 4458, crédit TVA collectée du taux ». Si la comptabilisation de Pennylane n'est pas reconnue avec certitude, aucune écriture n'est passée : la ligne retourne au relevé, avec la raison.
Ce que la facture remise au client ne dit pas : pour une carte à usages multiples, la TVA qu'elle affiche reste celle de PrestaShop. La comptabilité et la déclaration de TVA seront justes ; le document client, non. Pour un client professionnel, établissez une facture rectificative s'il la demande. Recommandations : excluez vos produits « carte cadeau » des règles promo, et donnez-leur une règle de taxe à 0 % (pas « Aucune taxe » : voir les défauts de PrestaShop plus bas).
Remboursement d'une commande payée par carte (limite de la version 1.0) : l'avoir est envoyé tel qu'émis et reste juste. Le remboursement lui-même (virement, nouvelle carte, recrédit) est un règlement : il se comptabilise manuellement, côté paiements, hors module.
Cartes échues : la constatation en produit des cartes non utilisées (758 ou 70x selon leur nature) est une écriture de clôture, à passer par vous ou votre comptable.
4. Comptes et ventilation (avancé, avec votre comptable)
Facultatif, replié par défaut (cliquez sur son titre pour l'ouvrir ; il s'ouvre seul dès qu'un réglage y est fait). Sans réglage, Pennylane impute chaque ligne au compte de vente de sa nature.
| Réglage | Par défaut | Conséquences |
|---|---|---|
| Compte des ventes de marchandises | 707 (Pennylane) | Vaut aussi pour le port, l'emballage et les remises des biens, sauf compte propre. Un compte imposé remplace la nature envoyée à Pennylane : la TVA suit le traitement de ce compte dans Pennylane. |
| Compte des prestations | 706 (Pennylane) | TVA sur les encaissements. |
| Compte des frais de port | comme les produits | Attention : Pennylane traite un compte 708 (7085) comme des services, avec une TVA sur les encaissements (44574). Pour des ventes de biens, la TVA du port est due à la livraison : elle ne serait déclarée qu'une fois la facture rapprochée de son paiement. Ce choix demande une confirmation explicite. |
| Compte des remises | déduites des ventes | Avec un compte de remises (709 par exemple), la TVA des remises reste déduite de la TVA collectée. |
| Remises à répartition incertaine (biens / services) | me demander | Une remise par catégorie, par marque ou sur « le produit le moins cher », à un taux qui mêle biens et services : PrestaShop n'indique pas sur quoi elle porte. « Me demander à chaque fois » : la facture attend votre réponse. « Répartir au prorata » : répartie au prorata des montants HT des biens et des services, sans question. |
5. Envoi
| Réglage | Par défaut | Effet |
|---|---|---|
| Mode | Manuel | Manuel : vous validez chaque envoi (un par un, par lot, à une date, ou par période). Automatique : chaque document contrôlé part dès que sa commande atteint un statut déclencheur. Un statut de commande créé pour l'occasion peut servir de déclencheur. |
| Délai | 0 h | Laisse le temps de corriger une commande avant l'envoi automatique. |
| Date de départ | jour de l'installation | Les documents antérieurs ne partent jamais automatiquement ; « Envoyer une période » permet de reprendre l'historique. |
| Clients particuliers | regroupés | Un client « Clients particuliers » dans Pennylane, ou un client par acheteur. |
| Facture électronique | non cochée | Facultatif. Les factures et avoirs d'un client professionnel situé en France, avec son SIRET dans la boutique, sont convertis par Pennylane au format Factur-X puis transmis à la plateforme du client. Les autres documents partent comme d'habitude ; leur fiche dit pourquoi ils ne sont pas transmis. |
Avant de cocher « Facture électronique » :
- la facturation électronique activée dans votre compte Pennylane, par le dirigeant ou l'expert-comptable (Pennylane demande un consentement signé ou une vérification d'identité) ;
- dans Pennylane, un modèle de facture avec un pied de page portant les trois mentions obligatoires : pénalités de retard, indemnité forfaitaire pour frais de recouvrement, escompte ;
- des numéros de facture et d'avoir faits de lettres, de chiffres et de - + _ / seulement (35 caractères au plus) : le « # » du préfixe proposé par PrestaShop est refusé par Pennylane. Changez le préfixe dans Commandes > Factures (et Avoirs) : il vaut pour les documents suivants, les numéros déjà émis ne changent jamais ;
- le SIRET de vos clients professionnels dans leur compte client.
« Vérifier ma configuration » signale un préfixe refusé. Sur la fiche de chaque document envoyé, la ligne « Facture électronique » dit s'il a été transmis, s'il est en cours (Pennylane le convertit, la transmission se fait au passage suivant) ou pourquoi il ne l'a pas été. Si Pennylane a converti la facture mais refusé sa transmission (facture électronique pas encore activée, fiche du client, annuaire…), réglez la cause dans Pennylane, puis cliquez sur « Transmettre à nouveau à la plateforme » sur la fiche du document, ou sélectionnez les documents dans la liste et choisissez cette action groupée : seule la transmission est demandée, la facture n'est jamais envoyée une seconde fois. Le suivi de la facture chez le client (reçue, acceptée, refusée) se consulte dans Pennylane.
6. Tâche planifiée, données et diagnostic (facultatif, replié)
Le module travaille pendant que vous utilisez le back-office. Pour que l'envoi automatique fonctionne quand personne n'est connecté, faites exécuter par votre hébergeur la commande ou l'adresse affichées. Si l'adresse a pu être vue par un tiers, renouvelez-la : l'ancienne cesse de fonctionner, votre connexion Pennylane n'est pas touchée.
Cette section propose aussi « Télécharger le rapport de diagnostic », à joindre à toute demande de support. Il décrit l'environnement, la licence (clé masquée), les réglages et les derniers incidents ; il ne contient jamais le jeton Pennylane, la clé complète, l'adresse de la tâche planifiée ni les données de vos clients.
L'ordre de la page
En haut, l'encadré État dit ce qui empêche les envois et liste les étapes, chacune avec ✓ (faite) ou ✗ (à faire) et un lien vers sa section : connexion, situation fiscale, bons et cartes cadeaux, envoi, validation. Viennent ensuite la licence, les sections 1 à 5 (la 4, avancée, repliée), puis la dernière étape, « Vérifier et valider ma configuration », et enfin la section 6, repliée. Chaque section s'enregistre séparément avec son propre bouton. Selon vos réponses, les champs inutiles sont masqués (réglages des cartes cadeaux si vous n'en vendez pas, statuts déclencheurs en mode manuel…) ; un champ déjà rempli reste toujours affiché.
Vérifier et valider ma configuration (dernière étape)
Le bouton « Vérifier ma configuration » n'envoie rien. Il affiche :
- Des contrôles : connexion et droits du jeton, licence, situation fiscale, comptes relus dans Pennylane, traitements des cartes, choix particuliers (port en 708…).
- Une simulation sur vos derniers documents (prévisionnelle) : chaque ligne qui serait envoyée, son code de TVA, son compte, et les écritures complémentaires prévues.
- Ce que Pennylane a réellement comptabilisé pour vos derniers documents envoyés (vérifié, lu dans votre grand livre ; nécessite le droit Écritures comptables).
- Un récapitulatif de vos réglages, à transmettre à votre comptable.
Puis cochez « J'ai vérifié cette configuration. Je suis responsable des choix fiscaux et comptables qu'elle contient » et cliquez sur « Valider ma configuration ». Aucun envoi vers votre société Pennylane n'a lieu avant cette validation. Toute modification ultérieure d'un réglage demande une nouvelle validation. L'historique des réglages, de leurs modifications et de leurs validations (date, auteur) est conservé et affiché sous ce bouton.
L'alerte du tableau de bord
Quand des documents demandent votre attention, un encadré « Factures et avoirs pour Pennylane » apparaît en tête du tableau de bord du back-office :
- ⚠ N factures nécessitent votre attention : documents bloqués (incohérences de montants ou de TVA), non envoyés ;
- ⚠ Pennylane a refusé N factures : le motif est sur chaque document ;
- N factures attendent votre réponse : un bon à qualifier, un réglage à compléter ;
- Envois vers Pennylane arrêtés : connexion, configuration ou licence à revoir, pour toute la boutique.
Un arrêt des envois n'affiche qu'une cause à la fois (par exemple la situation fiscale, puis la connexion à Pennylane) : la suivante apparaît quand celle-ci est réglée. L'écran de configuration présente toutes les étapes, numérotées.
« Consulter les documents » ouvre la liste sur ces seuls documents. Les reprises après une erreur temporaire de connexion sont signalées sans alerte : le module réessaie seul. Les documents simplement « À valider » ne déclenchent rien. L'encadré disparaît quand tout est traité ; seuls les employés qui peuvent ouvrir Commandes > Pennylane le voient.
La liste des documents (Commandes > Pennylane)
L'encadré « État » de la configuration compte les documents au moment où la page s'affiche ; l'analyse continue ensuite en arrière-plan. Rechargez la page pour des compteurs à jour : la liste des documents fait foi.
Envoyer une période : choisissez les dates (ou un raccourci : « Aujourd'hui », « Ce mois-ci », « Mois dernier »), puis « Afficher la période » : le module recense et contrôle les documents de ces dates, et la liste n'affiche plus qu'eux, avec leur résumé par statut. Rien n'est envoyé. Le bouton « Envoyer les N documents prêts » apparaît ensuite ; « Tout afficher » retire le filtre.
Barre de progression des envois : après « Envoyer maintenant » ou « Envoyer les documents prêts », un encadré « Envoi vers Pennylane » montre où en est l'envoi (documents traités sur le total, envoyés, refusés, revenus à valider), le temps restant estimé, puis « Envoi terminé » ; la liste se recharge alors avec les statuts à jour. Les documents sont traités progressivement, par vagues, et la barre suit l'avancement : la durée dépend du nombre de documents, de l'hébergement, de PrestaShop et des réponses de Pennylane. Tant que la page reste ouverte, elle relance elle-même l'envoi toutes les quelques secondes. Si vous la quittez, l'envoi continue en arrière-plan, plus lentement (au plus toutes les 5 minutes pendant que vous utilisez le back-office, ou avec la tâche planifiée) ; la barre reprend où il en est quand vous revenez sur la liste.
| Statut | Signification | Que faire |
|---|---|---|
| À analyser | Pas encore contrôlé | Rien : l'analyse est automatique. |
| À valider | Contrôles réussis | Envoyer, programmer, exclure. Avec le motif « Débloqué par la mise à jour » : document bloqué avant une mise à jour du module, valide depuis ; il ne part jamais seul, même en envoi automatique. Vérifiez qu'il n'a pas été saisi à la main dans Pennylane, puis envoyez-le ou marquez-le « traité hors module ». |
| À qualifier | Une question vous est posée (nature d'un bon, réglage manquant, répartition à confirmer) | Répondre sur la fiche du document ou dans la configuration. |
| Bloqué | Le document est incohérent | Lire le diagnostic. Corriger dans PrestaShop pour les prochains documents ; pour celui-ci, le traiter avec votre comptable puis le marquer « traité hors module ». |
| En file, programmé, nouvel essai, à vérifier | Envoi en cours ou reporté | Rien : le module réessaie sans jamais créer de doublon. |
| Envoyé | Présent dans Pennylane | — |
| Refusé | Pennylane l'a refusé (motif affiché) | Corriger puis renvoyer. |
| Exclu, traité hors module | Décision tracée, avec justification | Réintégrer si besoin. |
Défauts de PrestaShop que le module détecte
Le module ne corrige jamais une facture émise. Il la bloque et explique :
| Situation | Cause | Pour les prochaines commandes |
|---|---|---|
| PrestaShop 1.6, facture avec un bon qui réduit le prix des produits (code promo, carte cadeau, crédit client) | Défaut connu de 1.6 : la TVA imprimée ne correspond pas à la base | Passer à PrestaShop 1.7 ou plus récent. La livraison offerte n'est pas concernée |
| Produit « Aucune taxe » vendu avec des produits taxés | PrestaShop ajoute sa base à un autre taux | Donner au produit une règle de taxe à 0 % |
| Écotaxe sans TVA | Réglage « taxe de l'écotaxe » sur « Aucune taxe » | Appliquer à l'écotaxe la règle de taxe des produits |
| Produit offert par règle panier, bon ciblé sur un produit (1.7) | Répartition de PrestaShop sur tous les taux | Prix spécifique à 0 €, ou PrestaShop 8 |
| Avoir avec « bon déduit » ou montant saisi à la main | PrestaShop ne donne pas la TVA du montant remboursé | Établir les avoirs en cochant les produits et quantités remboursés |
| Carte cadeau à usages multiples vendue avec TVA | Sa vente n'en supporte pas | Règle de taxe à 0 % sur le produit carte |
Avoirs : quand une intervention comptable est nécessaire
Les avoirs sont envoyés tels qu'émis et liés à leur facture. Le module n'en envoie pas certains, et le dit :
| Situation | À faire |
|---|---|
| Avoir avec « bon déduit » ou montant saisi à la main | Le saisir dans Pennylane avec votre comptable, puis « traité hors module ». À l'avenir, cocher produits et quantités remboursés |
| Avoirs dont le total dépasse la facture | Vérifier les avoirs dans PrestaShop |
| Avoir d'une facture traitée hors module | Le traiter hors module lui aussi |
| Avoir dont la facture n'est pas suivie par le module (émise avant la date de départ, jamais recensée) | Sa fiche nomme la facture. Recenser sa période (« Envoyer une période ») et l'envoyer d'abord ; ou, si elle a été enregistrée autrement dans Pennylane, enregistrer l'avoir de la même façon, puis « traité hors module ». Sinon, il reste « À valider » sans jamais partir |
| Remboursement d'une commande payée par carte cadeau ou crédit client | L'avoir part normalement ; le remboursement est à comptabiliser par vous |
Liste complète : limites connues.
Ce que le module ne fait pas
- Il ne choisit pas votre traitement fiscal ou comptable à votre place.
- Il ne modifie ni ne refait aucun document émis par PrestaShop.
- Il ne comptabilise pas les règlements (paiements, remboursements, rapprochements bancaires) : Pennylane les rapproche de vos relevés.
- Il n'envoie qu'en euros.
- Il ne transmet pas lui-même de facture électronique : c'est Pennylane, plateforme agréée, qui convertit et transmet les documents des clients professionnels, quand l'option de la section 5 est cochée.
Limites connues
Version 1.0.9. Le module est un outil de synchronisation : il transmet à Pennylane les factures et avoirs émis par PrestaShop, avec leurs totaux d'origine et des protections contre les doublons, selon les réglages que vous validez. Il ne remplace ni un logiciel de comptabilité ni un expert-comptable.
Périmètre
- Factures et avoirs clients uniquement. Ne sont pas transmis : les règlements (paiements, remboursements, rapprochements bancaires : Pennylane les rapproche de vos relevés), les factures fournisseurs, les produits, les stocks.
- Euro uniquement.
- Facture électronique (réforme 2026-2027) : en option (section 5), le module fait transmettre par Pennylane, plateforme agréée, les factures et avoirs des clients professionnels situés en France et munis d'un SIRET. Ne sont pas transmis : clients particuliers et étrangers (e-reporting : voir Pennylane), clients sans SIRET, numéros contenant un caractère refusé par Pennylane (le « # » du préfixe par défaut de PrestaShop). Le suivi de la facture chez le client se consulte dans Pennylane. Sans l'option, les factures sont importées dans Pennylane comme des factures émises par PrestaShop, avec leur PDF. L'avertissement « Facture électronique : le client professionnel français n'a pas de SIRET dans la boutique… » n'empêche pas l'envoi : le document part comme une facture ordinaire, et le SIRET est à compléter pour les suivants.
- Fiche d'un document : elle ne montre pas les lignes, codes TVA et comptes qui seront envoyés ; « Vérifier ma configuration » les simule pour les derniers documents recensés (vide tant qu'aucune période n'a été recensée).
- Interface en français.
- Vendeur établi en France métropolitaine (Corse et Monaco compris). Un vendeur établi dans un DOM, des ventes réalisées par une place de marché qui facture elle-même, les acomptes encaissés avant la facture et l'état récapitulatif des ventes intracommunautaires ne sont pas pris en charge.
- Une société Pennylane par boutique (en multiboutique, chaque boutique peut avoir la sienne).
- Un autre module qui envoie vos factures à Pennylane (module officiel, autre connecteur) ou un export comptable (CSV, EBP…) ne doit pas traiter les mêmes factures : le module ne le détecte pas. Avant d'envoyer, il vérifie qu'aucune facture ne porte déjà le même numéro dans Pennylane ; une facture que l'autre module aurait fait numéroter par Pennylane (mode brouillon) ne serait pas reconnue.
Documents que le module n'envoie pas (et explique)
Le module ne modifie jamais un document émis par PrestaShop. Un document incohérent n'est pas envoyé : le motif et la marche à suivre sont affichés, et vous le traitez avec votre comptable puis le marquez « traité hors module ».
| Situation | Pourquoi |
|---|---|
| PrestaShop 1.6, facture avec un bon qui réduit le prix des produits (code promo, carte cadeau, crédit client) | Défaut systématique de PrestaShop 1.6 : la TVA imprimée ne correspond pas à la base. Ces factures sont à traiter manuellement ; la livraison offerte, les prix réduits du catalogue et toutes les autres factures partent normalement. PrestaShop 1.7 et plus récents ne sont pas concernés |
| Produit « Aucune taxe » vendu avec des produits taxés ; écotaxe sans TVA ; produit offert par une règle panier sur plusieurs taux (et bon ciblé sur un produit en 1.7) | Tableau des taxes de PrestaShop incohérent |
| Carte cadeau à usages multiples vendue avec TVA | Sa vente n'en supporte pas : la facture émise est à rectifier |
| Facture dont le TTC imprimé diffère de la somme de ses lignes | Le montant juste est incertain, et le PDF émis n'est pas forcément correct. Le marchand ou son comptable vérifie les montants, la TVA et les paiements par rapport aux documents d'origine, saisit la facture dans Pennylane, puis la marque « traité hors module ». Un écart d'un centime entre HT et TVA au même TTC, lui, est réglé automatiquement |
| Facture française à 0 % en autoliquidation (sous-traitance du bâtiment) ou sous le régime de la TVA sur la marge (biens d'occasion) | Le module ne sait pas la distinguer d'une erreur de taux : bloquée si « Ventes à 0 % en France exonérées » vaut Non (à saisir dans Pennylane avec votre comptable). Avec Oui, elle partirait comme exonérée : ne répondez Oui que pour des opérations réellement exonérées |
Avoirs : situations qui demandent une intervention comptable
Les avoirs sont envoyés tels qu'émis et liés à leur facture. Restent à traiter par vous ou votre comptable :
| Situation | Ce que fait le module | À faire |
|---|---|---|
| Avoir établi avec « bon déduit » ou avec un montant saisi à la main | Bloqué : PrestaShop ne donne pas la TVA du montant remboursé | Saisir l'avoir dans Pennylane avec votre comptable ; à l'avenir, établir les avoirs en cochant produits et quantités |
| Avoirs dont le total dépasse la facture | Bloqué | Vérifier les avoirs dans PrestaShop |
| Avoir d'une facture traitée hors module (par exemple une facture 1.6 avec bon) | Reste « en attente de sa facture » | Le traiter hors module lui aussi |
| Remboursement d'une commande payée par carte cadeau ou crédit client | L'avoir est envoyé tel qu'émis | Le remboursement lui-même (virement, nouvelle carte, recrédit) est un règlement : à comptabiliser par vous |
Cartes cadeaux et crédits clients
- Vous choisissez leur nature (usage unique ou usages multiples) et leur comptabilisation ; le module applique votre choix.
- Pour une carte à usages multiples ou un crédit client, la facture remise au client montre la TVA calculée par PrestaShop (trop basse). La comptabilité et la TVA déclarée seront justes grâce au relevé à comptabiliser ou à l'écriture complémentaire ; le document client, non : établissez une facture rectificative pour un client professionnel qui la demande.
- Quand une carte s'ajoute à une autre remise sur plusieurs taux, PrestaShop ne conserve pas la part de chacune : le module la reconstitue au prorata et vous demande de la confirmer.
- Remboursements de commandes payées par carte, cartes non utilisées à leur échéance : comptabilisation manuelle.
- L'écriture complémentaire automatique demande des droits Pennylane supplémentaires (comptes, écritures, journaux) et un compte de carte ; si Pennylane comptabilise la carte d'une façon que le module ne reconnaît pas avec certitude, l'écriture est laissée au relevé.
Comportements de Pennylane à connaître
- Un compte imposé à une ligne remplace la nature biens/services : Pennylane applique alors le traitement de TVA de ce compte. Exemple constaté : un compte de port 708 (7085) reçoit une TVA sur les encaissements (44574).
- Un compte de carte 4191 est traité par Pennylane comme un acompte (TVA mise en attente sur 4458) ; le module en tient compte.
- Les documents sont traités progressivement, par vagues : chacun demande plusieurs échanges avec Pennylane, qui en limite le nombre. Aucun débit n'est garanti : il dépend du volume, de l'hébergement, de PrestaShop et des réponses de Pennylane. La barre de progression suit l'avancement (1.0.8).
- Une boutique réglée sur « Arrondir pour chaque ligne » imprime parfois des totaux HT et TVA qui diffèrent d'un centime de la somme des lignes (même TTC). Le module envoie les totaux imprimés et reporte ce centime sur la ligne principale du taux concerné : sur cette ligne, le HT et la TVA affichés dans Pennylane diffèrent d'un centime du PDF ; la comptabilité est identique à la facture. Pennylane, lui, ne sait pas recevoir une facture dont les lignes ne font pas les totaux.
Licence et technique
- PHP 7.1 minimum ; extensions cURL et OpenSSL.
- L'activation de la licence passe par le serveur de licences (ou par e-mail, hors ligne). Ensuite, le module fonctionne sans lui : une panne du serveur n'arrête jamais les envois.
- Pas de limite de documents. Volume vérifié : 752 documents, analysés à environ 12 ms par document ; l'envoi se fait progressivement, comme décrit plus haut.
- Un mauvais paquet ou une version plus ancienne installés lors d'une mise à jour ne peuvent pas être refusés avant que PrestaShop remplace les fichiers (il ne laisse intervenir le module qu'après) : le module s'arrête alors et indique le ZIP à installer. Ce contrôle est dans le code installé : il existe à partir de la 1.0.4. Un ZIP 1.0.3 ou antérieur posé sur une version plus récente remplace ce code par un code qui ne contrôle rien, et rien ne prévient. Ne réinstallez jamais un ancien ZIP ; pour revenir en arrière, demandez au support.
- Shopify : non disponible.
Support
Contact : en répondant à l'e-mail d'achat (ou à l'adresse de support indiquée sur la page du produit). Le support est inclus pendant la maintenance (12 mois après l'achat, renouvelable).
Ce que couvre le support : vos questions sur le fonctionnement du module, par e-mail, pendant la maintenance. Ne sont pas inclus : l'installation, la formation, la configuration comptable, la migration de boutique et toute intervention technique. Les autres demandes sont étudiées au cas par cas et peuvent faire l'objet d'une prestation payante (CGV, article 4).
À joindre à toute demande :
- le rapport de diagnostic : configuration du module, section 6, « Télécharger le rapport de diagnostic » ;
- le numéro du document concerné (facture ou avoir) et le motif affiché dans Commandes > Pennylane ;
- si utile, une capture d'écran.
Le rapport contient : versions de PrestaShop, de PHP et du module, extensions PHP, état de la licence (clé masquée), pour chaque boutique la société Pennylane, les réglages, la validation de la configuration, les compteurs par statut, les 30 derniers incidents (numéro, statut, code du motif) et les 40 dernières actions du journal. Il ne contient jamais le jeton Pennylane, la clé de licence complète, l'adresse de la tâche planifiée, ni le nom ou l'adresse d'un client.
Questions fréquentes
| Situation | Cause habituelle | Que faire |
|---|---|---|
| Rien ne part | Configuration non validée, licence non activée, jeton refusé, domaine changé | Configuration > « Vérifier ma configuration » : la cause est indiquée |
| « Ce paquet n'est pas fait pour PrestaShop… » ou « Une version plus ancienne… a été installée » | Mauvais ZIP lors d'une mise à jour (autre génération de PrestaShop, ou version plus ancienne) | Installer le ZIP indiqué (Modules > Installer un module) : réglages et historique sont conservés |
| Document « À qualifier » | Le module vous pose une question (nature d'un bon, réglage des cartes, répartition à confirmer) | Répondre sur la fiche du document ou dans la configuration |
| Document « Bloqué » | Incohérence du document émis par PrestaShop (voir le diagnostic sur la fiche) | Pour ce document : traitement avec votre comptable, puis « Traité hors module ». Pour la suite : le réglage PrestaShop indiqué |
| Avoir « en attente de sa facture » | La facture d'origine n'est pas encore dans Pennylane | Envoyer la facture ; si elle a été traitée hors module, traiter aussi l'avoir hors module |
| « Licence à activer » | Pas de licence, ou société Pennylane réelle sans licence | Section Licence |
| « Le domaine a changé » | Migration ou copie de la boutique | Section Licence : transférer ; section 1 : confirmer le domaine |
| Serveur de licences injoignable | Panne ou réseau | Aucun effet sur les envois ; l'activation peut se faire hors ligne (demande par e-mail) |
| Envoi automatique : rien ne part | Statut déclencheur non atteint, document antérieur à l'activation du mode automatique, tâche planifiée absente | Liste des documents ; section 5 ; section 6 |