Module Pennylane Sync - Revision history

Arcchester: Pennylane Sync 1.0.5 : Dolibarr 18 à 24, section « Quel PDF part » (scan fournisseur déposé, .pdf, refus si plusieurs scans, relance au dépôt), historique 1.0.1 à 1.0.5

2026-10-19T15:57:56Z

Pennylane Sync 1.0.5 : Dolibarr 18 à 24, section « Quel PDF part » (scan fournisseur déposé, <REF>.pdf, refus si plusieurs scans, relance au dépôt), historique 1.0.1 à 1.0.5

← Older revision		Revision as of 15:57, 19 October 2026
Line 11:		Line 11:
	! Licence \|\| GPL v3		! Licence \|\| GPL v3
	\|-		\|-
	! Compatibilité Dolibarr \|\| 20.0 à 24.x (testé sur 20.0.4 et 24.0.0, PHP 8.2)		! Compatibilité Dolibarr \|\| 18.0 à 24.x (testé sur 18.0.5, 20.0.4 et 24.0.0, PHP 8.2)
	\|-		\|-
	! PHP \|\| 7.4 à 8.3		! PHP \|\| 7.4 à 8.3
Line 25:		Line 25:

	# '''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.		# '''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.
	# '''Factures fournisseurs''' saisies dans Dolibarr, envoyées avec ~~leur pièce jointe~~.		# '''Factures fournisseurs''' saisies dans Dolibarr, envoyées avec le scan du fournisseur déposé dans l'onglet ''Documents'' (voir [[#Quel PDF part\|Quel PDF part]]).
	# '''Création des tiers''' au premier envoi (société ou particulier, fournisseur sous son propre rôle), puis mise à jour ensuite.		# '''Création des tiers''' au premier envoi (société ou particulier, fournisseur sous son propre rôle), puis mise à jour ensuite.
	# '''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.		# '''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.
	# '''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.		# '''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.
	# '''Rapport d'écart''' : mois par mois, ce que Dolibarr a validé face à ce que Pennylane a reçu — à vérifier avant une clôture.		# '''Rapport d'écart''' : mois par mois, ce que Dolibarr a validé face à ce que Pennylane a reçu — à vérifier avant une clôture.
	# '''Panneau sur la fiche facture''' : date d'envoi, identifiant distant, lien vers la pièce.		# '''Panneau sur la fiche facture''' : PDF qui partira, 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.		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.
Line 61:		Line 61:

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

			== Quel PDF part ==

			Pennylane n'importe une facture qu'avec son PDF, et une pièce importée ne se remplace plus par l'API. Le module choisit donc le fichier avant l'envoi :

			* '''Facture client''' : le PDF généré par Dolibarr.
			* '''Facture fournisseur''' : le scan du fournisseur déposé dans l'onglet ''Documents'' de la facture, choisi dans cet ordre :
			*# le fichier nommé <code><REF>.pdf</code>, où <REF> est la référence Dolibarr de la facture ;
			*# sinon, le seul scan déposé ;
			*# sinon, le scan dont le nom contient la référence du fournisseur.
			* '''Sans aucun scan''', c'est le PDF généré par Dolibarr qui part. Quand une facture fournisseur a à la fois un PDF généré et un scan, c'est le scan qui part.
			* '''Plusieurs scans sans indice''' : l'envoi est refusé avec le motif « PDF ambigu ». Renommez le bon fichier en <code><REF>.pdf</code> ou retirez les autres.
			* '''Relance automatique''' : déposer, renommer ou retirer un PDF sur la facture remet en file un envoi bloqué pour PDF manquant ou ambigu, sans rejeu manuel. Même chose quand on génère le PDF d'une facture client. Les autres échecs restent en l'état.

			Le panneau de la fiche facture indique le PDF qui partira, ou ce qu'il faut faire pour débloquer l'envoi.

	== Historique des versions ==		== Historique des versions ==
Line 69:		Line 84:
	\|-		\|-
	\| 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		\| 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
			\|-
			\| 1.0.1 \|\| Corrections : la file d'attente ne distribue plus un même job à deux exécutions, la fusion de tiers ne crée plus de doublon chez Pennylane, la purge des journaux respecte l'entité, la reprise à 12 h est atteignable et les numéros de compte courts sont résolus
			\|-
			\| 1.0.2 \|\| PDF obligatoire pour tout import ; factures abandonnées exclues ; recherche par référence externe avant de créer un tiers ou d'importer une facture ; devises non prises en charge refusées ; guide de démarrage FR/EN et messages d'erreur dépliables
			\|-
			\| 1.0.3 \|\| Interface harmonisée (compteurs, filtres, tableaux, badges, panneau de la facture) ; moteur de synchronisation inchangé
			\|-
			\| 1.0.4 \|\| Facture fournisseur : le scan déposé dans l'onglet ''Documents'' part avec la facture (<code><REF>.pdf</code>, sinon le seul scan, sinon celui dont le nom contient la référence du fournisseur ; refus « PDF ambigu » s'il y a plusieurs scans sans indice). Relance automatique au dépôt, au renommage ou au retrait d'un PDF. Le panneau de la facture indique le PDF qui partira
			\|-
			\| 1.0.5 \|\| Compatible Dolibarr 18 et 19 (20 minimum auparavant) : le module s'installe de Dolibarr 18 à 24. En 18 et 19, le panneau de la fiche facture s'affiche dans le tableau des attributs. Moteur d'envoi inchangé
	\|}		\|}

Arcchester: Documentation du module externe Pennylane Sync (editeur arcchester)

2026-09-06T12:02:07Z

Documentation du module externe Pennylane Sync (editeur arcchester)

New page

== 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'''.

{| class="wikitable"
|-
! É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 || [https://www.dolistore.com/product.php?id=3483 Fiche sur le Dolistore]
|}

== Fonctionnalités ==

# '''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.
# '''Factures fournisseurs''' saisies dans Dolibarr, envoyées avec leur pièce jointe.
# '''Création des tiers''' au premier envoi (société ou particulier, fournisseur sous son propre rôle), puis mise à jour ensuite.
# '''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.
# '''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.
# '''Rapport d'écart''' : mois par mois, ce que Dolibarr a validé face à ce que Pennylane a reçu — à vérifier avant une clôture.
# '''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 [[Module Stripe Payment Links|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 ==

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

== Configuration ==

# Dans Pennylane : ''Settings → Connectivity → Developers'' → créer un jeton d'API. '''Un jeton correspond à une société.'''
# Coller le jeton dans la configuration du module et tester la connexion.
# Choisir ce qui est envoyé (factures clients, factures fournisseurs), et activer la tâche planifiée qui traite la file d'attente.
# 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 ==

{| class="wikitable"
|-
! 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 : [https://www.dolistore.com/recherche?controller=search&search_query=arcchester recherche « arcchester » sur le Dolistore]

[[Category:Modules complémentaires]]