Relier votre logiciel métier à Pennylane par l'API v2

Que peut lire et écrire un logiciel dans Pennylane ?

Par l'API v2, un logiciel métier agit sur presque toute la chaîne qui va de la facture à l'écriture comptable. La documentation développeur de Pennylane distingue trois API : l'API Company, pour une entreprise ; l'API Firm, pour un cabinet comptable qui consulte plusieurs dossiers ; l'API Firm Group, accordée sur demande pour créer des sociétés ou des utilisateurs en masse. Pour relier votre logiciel, c'est l'API Company qui compte.

La page des cas d'usage de Pennylane signale aussi ce qui n'est pas encore couvert, par exemple la création de factures d'acompte ou de bons de livraison ; un guide consacré à la facture d'acompte figure pourtant dans la même documentation, donc vérifiez votre cas avec Pennylane avant de chiffrer. Pour de l'analyse en volume, Pennylane propose le Data Sharing, une connexion en lecture seule, avec quelques heures de décalage, pensée pour les outils de BI.

Jeton d'entreprise ou OAuth 2.0 : quel accès demander ?

Le mode d'accès dépend de qui construit l'intégration et pour qui. Une entreprise qui fait relier son propre logiciel utilise un jeton d'entreprise ; un éditeur qui vend son logiciel à de nombreux clients Pennylane enregistre une application OAuth 2.0.

La limite d'appels est la même partout : 25 requêtes par fenêtre de 5 secondes et par jeton, en production comme en bac à sable. Au-delà, Pennylane répond par une erreur 429 et un en-tête retry-after qui indique le nombre de secondes à attendre. Pour les essais, une entreprise crée elle-même un compte bac à sable depuis son menu de profil (Test environment) ; un intégrateur le demande à l'équipe partenariats.

Webhooks ou journal des modifications : comment suivre ce qui change ?

Pour savoir qu'une facture a été payée ou qu'un fournisseur a changé d'adresse, votre logiciel dispose de deux mécanismes, qu'il est prudent de combiner.

• Les webhooks, encore en bêta en 2026 selon Pennylane, qui conseille de s'appuyer en parallèle sur les journaux de modifications. Trois événements sont listés : changement du statut de facturation électronique d'une facture client, création d'un fichier dans la gestion documentaire, réception d'une facture fournisseur par la facturation électronique. L'adresse de réception doit être en HTTPS. En cas d'échec temporaire, Pennylane réessaie avec des délais croissants, de 30 secondes à 12 heures ; une réponse 401, 403, 404 ou 410 désactive l'abonnement immédiatement, sans réactivation automatique.
• Les journaux de modifications (changelogs), disponibles pour les factures clients et fournisseurs, les clients, les fournisseurs, les produits, les lignes d'écriture et les transactions. Les changements y sont conservés quatre semaines. La méthode décrite par Pennylane : parcourir toutes les pages de résultats, puis seulement enregistrer la date du dernier changement traité comme point de départ du passage suivant.

Conséquence pratique : une synchronisation arrêtée plus de quatre semaines ne rattrape plus son retard par le journal ; la resynchronisation complète doit être prévue dès la conception. Voir aussi notre définition du webhook.

Cinq flux concrets entre un logiciel métier et Pennylane

1. De l'intervention à la facture. Le technicien fait signer le bon d'intervention sur sa tablette. Le logiciel métier vérifie que le client existe dans Pennylane (sinon il le crée), retrouve les produits facturés, puis crée la facture client ; Pennylane génère le PDF. Le numéro de facture remonte dans la fiche d'intervention.
2. Des factures déjà émises par votre outil. Si votre logiciel numérote et produit lui-même ses factures, on les importe : dépôt du fichier, puis appel d'import avec toutes les données. L'import ne lit pas le PDF, précise la documentation (pas de reconnaissance de caractères) : chaque montant doit être transmis.
3. Du devis signé à la facture. Le devis accepté dans votre outil est créé dans Pennylane, puis converti en facture à la livraison, sans ressaisie des lignes.
4. Du paiement à l'arrêt des relances. Chaque nuit, le service d'intégration lit le journal des transactions et les rapprochements ; une facture soldée passe au statut payé dans le logiciel métier, qui cesse de la relancer. Le sujet est détaillé dans notre page sur les relances d'impayés.
5. De la facture fournisseur au chantier. Quand une facture fournisseur arrive par la facturation électronique, le webhook prévient le logiciel métier, qui propose de la rattacher à la commande d'achat ou au chantier concerné. Ce flux prend place dans la réforme décrite sur notre page consacrée à la facture électronique dans un logiciel métier.

Ce qui casse une intégration Pennylane, et comment l'éviter

• Les évolutions de l'API v2. Pennylane a publié pour 2026 un calendrier de changements : préversion le 14 janvier, nouveau comportement par défaut le 8 avril, ancien comportement supprimé le 1er juillet 2026. Le périmètre « ledger » y est remplacé par des périmètres plus fins (journaux, comptes, écritures) et plusieurs listes passent à une pagination par curseur. Une intégration écrite en 2025 sans suivi de ces annonces a pu cesser de fonctionner.
• Les factures finalisées. Une facture client créée hors brouillon est considérée comme finalisée : pour l'annuler, la documentation de Pennylane indique qu'il faut créer un avoir. Les montants se contrôlent donc dans le logiciel métier avant l'envoi, pas après.
• Les doublons. Un appel répété après une coupure réseau peut créer deux fois le même client ou la même facture. Le service d'intégration conserve la correspondance entre l'identifiant de votre logiciel et celui de Pennylane, et la consulte avant toute création.
• Les jetons. Un jeton n'est affiché qu'une fois et peut expirer : il se range dans un coffre de secrets, avec une alerte avant l'échéance. Autre piège : un jeton privé du périmètre de lecture d'un événement ne reçoit rien (la documentation des webhooks évoque selon les passages un refus de l'abonnement ou des envois sautés) ; les périmètres se vérifient donc avant de s'abonner.
• Les données personnelles. Les fiches clients d'un artisan ou d'une profession libérale concernent souvent des particuliers. Le flux ne transmet que les champs utiles et figure dans votre registre des traitements ; notre guide RGPD et logiciel métier détaille ces obligations.

Faut-il développer, ou une liaison existante suffit-elle ?

Si votre logiciel métier est un produit du marché, demandez d'abord à son éditeur s'il propose déjà une liaison avec Pennylane : cela ne coûte rien. Pour un besoin d'analyse, le Data Sharing alimente un outil de BI sans service à maintenir.

Le développement sur mesure devient pertinent quand :

• votre logiciel est spécifique ou ancien, et aucun connecteur ne le connaît ;
• le flux suit des règles propres à votre métier (facturation à l'avancement, regroupement de bons, ventilation analytique par chantier) ;
• vous devez rejouer sans perte ce qui a échoué, avec un journal consultable ;
• plusieurs outils gravitent autour de Pennylane : paiement, CRM, application terrain.

La mécanique générale de ces liaisons est décrite dans notre page connecter ses outils par API.

Ce que YMHB Web construit et vous remet

YMHB Web écrit un petit service d'intégration (Node.js, avec une base PostgreSQL pour la table de correspondance et le journal), hébergé sur votre compte. Le jeton Pennylane est généré par votre administrateur et reste à votre nom. Vous recevez :

• le code source, déposé chez vous et documenté, qui vous appartient au paiement intégral ;
• un journal où chaque facture envoyée apparaît avec la réponse de Pennylane ;
• des alertes en cas d'erreurs répétées, de jeton proche de l'expiration ou d'abonnement webhook désactivé ;
• une procédure de resynchronisation complète, testée en bac à sable.

Le projet commence par un cadrage des flux et des règles comptables, si possible avec votre expert-comptable ; le chiffrage vient ensuite, en forfait global. L'architecture de ces services est présentée dans notre offre API et microservices.