- Type
- Intégration API
- Flux
- ERP ⇄ Pennylane
- Notre rôle
- Analyse, architecture, dev
- Livraison
- Code et doc remis au client
Le projet, étape par étape
Une intégration comptable se joue surtout avant le code : comprendre les données, les flux et ce qui fait foi.
- Étape 1
Cadrage et audit des flux existants
Avant d'écrire une ligne de code, on a cartographié comment la comptabilité circulait : exports manuels depuis l'ERP, ressaisie dans Pennylane, allers-retours avec le cabinet comptable.
- Recensement des documents concernés et de leurs volumes
- Identification des irritants : doublons, oublis, délais de clôture
- Périmètre validé avec le client et son expert-comptable
- Étape 2
Analyse des modèles de données
Les deux outils ne décrivent pas les mêmes objets de la même façon. On a établi, champ par champ, la correspondance entre l'ERP et Pennylane, et décidé pour chaque donnée quel outil fait foi.
Correspondance des données entre l'ERP et Pennylane Dans l'ERP Dans Pennylane Sens Fait foi Clients Clients ERP → Pennylane ERP Fournisseurs Fournisseurs ERP → Pennylane ERP Factures et avoirs de vente Factures clients ERP → Pennylane ERP Factures d'achat Factures fournisseurs ERP → Pennylane ERP Pièces PDF Pièces jointes ERP → Pennylane ERP Codes TVA, familles Comptes, taux de TVA Table de correspondance Pennylane Statut de règlement Paiement, lettrage Pennylane → ERP Pennylane - Étape 3
Analyse des workflows à interconnecter
Chaque flux a été décrit avec son déclencheur, ses règles et son comportement en cas d'erreur.
- ERP → Pennylane : à la validation d'une facture ou d'un avoir, création du tiers si besoin, de la pièce comptable et envoi du PDF
- Pennylane → ERP : remontée des règlements et du lettrage pour mettre à jour le statut des factures
- Idempotence : chaque pièce porte la référence de l'ERP, une même facture n'est jamais créée deux fois
- Conflits et rejets : mise en attente, journalisation et alerte plutôt qu'un échec silencieux
- Étape 4
Mise en place de l'API NestJS
Un service dédié, découpé en modules, fait le lien entre les deux outils et absorbe leurs contraintes techniques.
- Module connecteur ERP (lecture des pièces validées, écriture des statuts)
- Client Pennylane : authentification, pagination, respect de la limite de débit avec reprise progressive
- Module de mapping, isolé et testé, qui applique la table de correspondance
- Jobs planifiés pour la synchronisation et l'interrogation régulière des changements côté Pennylane
- Journal de synchro consultable : chaque échange tracé, rejouable en cas d'erreur
- Étape 5
Recette, reprise et mise en production
Les flux ont d'abord tourné sur un environnement de test Pennylane, puis en parallèle de l'ancien process le temps de valider les écritures avec le cabinet.
- Jeux de cas réels : avoirs, factures multi-taux, tiers sans SIRET, pièces sans PDF
- Reprise de l'historique nécessaire à l'exercice en cours
- Code source et documentation remis au client à la livraison
Vos outils ne se parlent pas ?
ERP, CRM, compta, outil métier : on analyse vos flux et on les connecte proprement.