Module Pennylane Sync

Module Pennylane Sync

Pennylane Sync est un module complémentaire pour Dolibarr ERP/CRM qui envoie automatiquement vos factures vers Pennylane : gardez Dolibarr pour la gestion, donnez Pennylane à votre expert-comptable. Les factures clients et fournisseurs validées, leurs PDF et les tiers partent vers Pennylane sans ressaisie ni export mensuel.

Connecteur indépendant, non affilié à Pennylane SAS.

Éditeur	arcchester
Licence	GPL v3
Compatibilité Dolibarr	20.0 à 24.x (testé sur 20.0.4 et 24.0.0, PHP 8.2)
PHP	7.4 à 8.3
Prérequis	Modules Facturation et Tiers ; module Cron recommandé ; un jeton d'API Pennylane
Dépendances	Aucune (cURL pur)
Distribution	Fiche sur le Dolistore

Fonctionnalités

1. Factures clients validées envoyées avec leur PDF, leurs lignes, leurs taux de TVA et leur compte de produit. Avoirs et acomptes compris ; un avoir référence sa facture d'origine.
2. Factures fournisseurs saisies dans Dolibarr, envoyées avec leur pièce jointe.
3. Création des tiers au premier envoi (société ou particulier, fournisseur sous son propre rôle), puis mise à jour ensuite.
4. Résolution automatique des comptes comptables : le numéro de compte Dolibarr est traduit en identifiant Pennylane, avec mise en cache. Aucune table de correspondance à saisir à la main.
5. File d'attente tracée : chaque envoi est un job avec son statut, ses tentatives et le message exact renvoyé par l'API. Reprise automatique, rejeu manuel, rattrapage d'historique.
6. Rapport d'écart : mois par mois, ce que Dolibarr a validé face à ce que Pennylane a reçu — à vérifier avant une clôture.
7. Panneau sur la fiche facture : date d'envoi, identifiant distant, lien vers la pièce.

Le module respecte les limites de débit de l'API Pennylane (25 requêtes par tranche de 5 secondes) en se freinant sur les en-têtes de quota renvoyés par le serveur.

Les règlements : ce que le module fait, et pourquoi

L'API Pennylane ne permet pas d'attacher un paiement chiffré à une facture, et une écriture comptable créée par l'API ne peut pas être lettrée avec une pièce. Publier des règlements par ce biais laisserait des écritures à lettrer à la main et ferait double emploi avec le flux bancaire du cabinet.

Le module ne pousse donc aucune écriture de règlement. À la place, chaque facture part avec une référence de rapprochement qui indique à Pennylane comment reconnaître le mouvement bancaire correspondant : le numéro de facture, ou l'identifiant du paiement Stripe lorsque le module Stripe Payment Links est actif. Le lettrage devient exact parce que la référence l'est.

Ce que le module ne fait pas

• Il ne rapatrie rien de Pennylane vers Dolibarr : pas de double source de vérité.
• Il ne remplace pas la comptabilité de Dolibarr : il alimente celle du cabinet.
• Il n'envoie ni commandes, ni devis, ni notes de frais, ni salaires.

Installation

1. Copier pennylanesync/ dans htdocs/custom/, ou installer le zip depuis Accueil → Configuration → Modules/Applications → Déployer/installer un module externe.
2. Activer Pennylane Sync (famille « Finance / Facturation »).

Configuration

1. Dans Pennylane : Settings → Connectivity → Developers → créer un jeton d'API. Un jeton correspond à une société.
2. Coller le jeton dans la configuration du module et tester la connexion.
3. Choisir ce qui est envoyé (factures clients, factures fournisseurs), et activer la tâche planifiée qui traite la file d'attente.
4. Facultatif : lancer un rattrapage d'historique sur une période passée.

Utilisation

À la validation d'une facture, un job est déposé dans la file. La tâche planifiée l'exécute : le PDF est d'abord téléversé, puis la facture est importée avec sa référence au fichier. Le panneau de la fiche facture montre l'état de l'envoi, et la page de la file permet de rejouer un job en échec après correction. Avant une clôture, le rapport d'écart compare mois par mois les deux systèmes.

Historique des versions

Version	Apports principaux
1.0.0	Version initiale : envoi des factures clients et fournisseurs avec PDF, création et mise à jour des tiers, résolution des comptes comptables, file d'attente tracée avec rejeu et rattrapage, référence de rapprochement bancaire, rapport d'écart mensuel, panneau sur la fiche facture, FR/EN

Support

• Contact : support@arcchester.com
• Autres modules du même éditeur : recherche « arcchester » sur le Dolistore