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 PDF

Installation, 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émentExigence
PrestaShop1.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)
PHP7.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 PHPcURL et OpenSSL (obligatoires) ; intl recommandée (noms de domaine accentués)
RéseauConnexions HTTPS sortantes vers app.pennylane.com et licences.romain-couzon.fr
PennylaneUn compte qui permet de créer un jeton d'API (Paramètres > Connectivité > Développeurs)
Autre connecteurSi 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)
NavigateurCelui 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 PrestaShopPaquet
1.6.1.xrcinvoicesync-1.0.9-ps16.zip
1.7.0 à 8.2rcinvoicesync-1.0.9-ps17.zip
9.xrcinvoicesync-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

  1. Back-office PrestaShop : Modules > Gestionnaire de modules > Téléverser un module, puis choisissez le ZIP.
  2. Ouvrez la configuration du module.
  3. 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).
  4. 1. Connexion à Pennylane : collez le jeton d'API. Le module affiche la société Pennylane trouvée.
  5. 2. Situation fiscale, 3. Bons et cartes cadeaux et, avec votre comptable si besoin, 4. Comptes et ventilation : voir le guide de configuration.
  6. 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.
  7. 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.
  8. Menu Commandes > Pennylane : la liste des documents. Envoyez un premier document et vérifiez-le dans Pennylane.
  9. 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

5. Mettre à jour

  1. 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.
  2. 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.
  3. 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.
  4. 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).
  5. 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 ».
  6. Ne désinstallez jamais le module pour le mettre à jour : la désinstallation retire les réglages.
  7. 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

7. Désinstaller

8. En cas de problème

  1. Lisez le motif affiché sur le document (Commandes > Pennylane) : il explique la cause et la marche à suivre.
  2. Vérifier ma configuration signale ce qui empêche les envois (connexion, licence, validation, comptes).
  3. 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

Avant de commencer

  1. 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.
  2. 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églagePar défautEffet
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éproductionProduction ; 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églagePar défautConsé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éesNonOui 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 produitaucunePour 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églagePar défautConsé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éditsaucunNumé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 :

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églagePar défautConséquences
Compte des ventes de marchandises707 (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 prestations706 (Pennylane)TVA sur les encaissements.
Compte des frais de portcomme les produitsAttention : 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 remisesdéduites des ventesAvec 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 demanderUne 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églagePar défautEffet
ModeManuelManuel : 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élai0 hLaisse le temps de corriger une commande avant l'envoi automatique.
Date de départjour de l'installationLes documents antérieurs ne partent jamais automatiquement ; « Envoyer une période » permet de reprendre l'historique.
Clients particuliersregroupésUn client « Clients particuliers » dans Pennylane, ou un client par acheteur.
Facture électroniquenon cochéeFacultatif. 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 » :

« 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 :

  1. Des contrôles : connexion et droits du jeton, licence, situation fiscale, comptes relus dans Pennylane, traitements des cartes, choix particuliers (port en 708…).
  2. 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.
  3. 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).
  4. 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 :

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.

StatutSignificationQue faire
À analyserPas encore contrôléRien : l'analyse est automatique.
À validerContrôles réussisEnvoyer, 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 ».
À qualifierUne 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érentLire 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érifierEnvoi 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 moduleDécision tracée, avec justificationRé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 :

SituationCausePour 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 basePasser à PrestaShop 1.7 ou plus récent. La livraison offerte n'est pas concernée
Produit « Aucune taxe » vendu avec des produits taxésPrestaShop ajoute sa base à un autre tauxDonner au produit une règle de taxe à 0 %
Écotaxe sans TVARé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 tauxPrix spécifique à 0 €, ou PrestaShop 8
Avoir avec « bon déduit » ou montant saisi à la mainPrestaShop 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 TVASa vente n'en supporte pasRè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 mainLe 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 factureVérifier les avoirs dans PrestaShop
Avoir d'une facture traitée hors moduleLe 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 clientL'avoir part normalement ; le remboursement est à comptabiliser par vous

Liste complète : limites connues.

Ce que le module ne fait pas

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

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 ».

SituationPourquoi
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 TVASa vente n'en supporte pas : la facture émise est à rectifier
Facture dont le TTC imprimé diffère de la somme de ses lignesLe 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 :

SituationCe que fait le moduleÀ faire
Avoir établi avec « bon déduit » ou avec un montant saisi à la mainBloqué : 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 factureBloqué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 clientL'avoir est envoyé tel qu'émisLe remboursement lui-même (virement, nouvelle carte, recrédit) est un règlement : à comptabiliser par vous

Cartes cadeaux et crédits clients

Comportements de Pennylane à connaître

Licence et technique

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 :

  1. le rapport de diagnostic : configuration du module, section 6, « Télécharger le rapport de diagnostic » ;
  2. le numéro du document concerné (facture ou avoir) et le motif affiché dans Commandes > Pennylane ;
  3. 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

SituationCause habituelleQue faire
Rien ne partConfiguration 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 PennylaneEnvoyer 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 licenceSection Licence
« Le domaine a changé »Migration ou copie de la boutiqueSection Licence : transférer ; section 1 : confirmer le domaine
Serveur de licences injoignablePanne ou réseauAucun effet sur les envois ; l'activation peut se faire hors ligne (demande par e-mail)
Envoi automatique : rien ne partStatut déclencheur non atteint, document antérieur à l'activation du mode automatique, tâche planifiée absenteListe des documents ; section 5 ; section 6