Dawap relie vos ventes, achats, ERP et outils documentaires à Pennylane sans confondre facture créée, pièce importée et écriture rapprochée. Chaque dossier conserve la société, le tiers, la référence externe, les montants, le document, le statut comptable et le checkpoint qui permet à la finance de comprendre puis de reprendre un écart.
Réponse immédiate
Dawap développe le middleware entre Pennylane API v2 et vos ERP, CRM, e-commerce ou outils documentaires. Le flux borne l’authentification Company, Firm ou OAuth 2.0, applique les scopes utiles, crée ou relit clients et factures, importe les PDF en deux temps, consomme les changelogs avec un checkpoint complet et rapproche le résultat avant de confirmer le dossier source.
Dossier de clôture · scénario illustratif
Les sociétés, références et montants ci-dessous sont fictifs. Ils illustrent le dossier qu’un connecteur Pennylane doit rendre lisible : identité, facture, pièce, réconciliation et reprise.
sha256 · 9c4…e18/api/external/v2/customer_invoices201| Contrôle | Source | Pennylane |
|---|---|---|
| Hors taxe | 8 400,00 | 8 400,00 |
| TVA | 1 680,00 | 1 680,00 |
| Total | 10 080,00 | 10 080,00 |
Aucune résolution silencieuse par libellé.
Upload et import gardent leurs statuts.
Le total est réconcilié avant confirmation.
Le checkpoint n’avance pas à mi-parcours.
Premier lot recommandé
Le premier lot doit prouver l’identité, les montants, la pièce, la clôture et la reprise sur cinq contre-tests avant de toucher le reste du portefeuille.
Quand la facture existe des deux côtés
Identité, fichier, facture, écriture et journal de changements avancent selon des cycles distincts. Le connecteur doit garder leurs preuves séparées avant de confirmer le flux au système source.
Token, company ID, external_reference et identité client ou fournisseur doivent former le même périmètre. Une correspondance par nom ou email ne suffit pas à engager la comptabilité.
Les montants sont transmis comme chaînes et le statut draft ou finalized change l’effet attendu. La réponse API doit être suivie d’un contrôle du total, de la ventilation et de la période.
Le curseur ne doit avancer qu’après traitement de toutes les pages. Sinon un incident entre deux appels peut perdre des changements ou les appliquer deux fois.
Contrats d’intégration Pennylane
Pennylane expose les ressources. Votre entreprise garde la décision qui relie société, tiers, document, écriture et clôture.
Company API Token, Firm API Token ou OAuth 2.0, company ID et scopes effectifs sont conservés. GET /me sert de contrôle, pas de découverte implicite en production.
ID métier, ID Pennylane, statut, pays et données nécessaires sont rapprochés dans une table versionnée ; aucune fusion n’est décidée sur un libellé ressemblant.
external_reference, lignes, taxes, devise, montants sous forme de chaînes et état draft ou finalized sont contrôlés avant de confirmer la création.
Le fichier PDF autorisé est déposé, son file_attachment_id est conservé, puis l’import est suivi séparément afin de localiser précisément un rejet.
Compte, journal, période, ventilation, taxes et total cible sont vérifiés selon le périmètre autorisé ; une facture visible ne suffit pas à valider la clôture.
Les changements sont lus du plus ancien au plus récent avec next_cursor et has_more. Le curseur durable n’est enregistré qu’après traitement complet du lot.
Méthode de réconciliation
Dawap part d’un dossier qui pose déjà problème. Finance, opérations et IT nomment la société, la source du tiers, les règles de ligne et de taxe, le document attendu, le statut autorisé et la preuve de clôture. Le flux ne s’étend qu’après avoir résisté à un fichier invalide, un total divergent, une limite atteinte et une reprise de curseur.
Relier société, tiers et référence métier aux IDs Pennylane sans rapprochement implicite.
Distinguer fichier reçu, upload réussi, import accepté et document réellement rattaché.
Comparer lignes, taxes, total et devise avant de fermer le dossier source.
Rejouer un sous-lot depuis une corrélation et un checkpoint connus, sans sauter de changement.
Premier lot Pennylane
On choisit une société, un type de facture et une période qui produisent déjà des corrections. Le lot est accepté lorsque sa référence, son tiers, ses montants, sa pièce, son état Pennylane et son effet comptable peuvent être reconstruits depuis une même trace.
Sorties attendues
Carte source–société–tiers–facture–pièce–écriture avec une source de vérité et un responsable par décision.
Inventaire des tokens ou OAuth, company IDs, scopes, endpoints v2, limites, webhooks et changelogs mobilisés.
Contrat du dossier témoin : références, lignes, taxes, montants, devise, statut, document et verdict de rapprochement.
Cinq contre-tests : tiers inconnu, PDF rejeté, total divergent, 429 puis retry et panne avant la dernière page de changelog.
Journal expurgé reliant corrélation interne, external_reference, IDs Pennylane, file_attachment_id, curseur et décision.
Recette finance–opérations–IT, seuils d’arrêt, quarantaine, reprise ciblée, documentation et runbook de clôture.
Recette Pennylane
Ces scénarios sont illustratifs et doivent être rejoués dans votre environnement Pennylane, avec vos droits et règles comptables. Ils ne constituent pas des résultats clients ni une référence Pennylane déjà livrée.
Pennylane, ERP, paiements ou documents ?
Nous connectons Pennylane aux données nécessaires au dossier comptable. Le CRM, l’ERP, les paiements et la gestion documentaire conservent les règles et les validations propres à leur activité.
Cette offre cadre accès, sociétés, tiers, factures, pièces, écritures, changements, contrôles et run du middleware.
Le hub ERP porte le modèle source et ses règles ; Pennylane reçoit ou restitue uniquement le contrat comptable utile.
Le hub paiements possède la transaction marchande avant son rapprochement avec facture, banque ou comptabilité.
Frontières de responsabilité
Pennylane porte le dossier comptable. ERP, paiements et documents conservent leurs décisions amont.
Saybus devait transformer une demande d’autocar en commande exploitable sans perdre calcul, paiement ni suivi interne. Dawap a conçu une plateforme avec Google Places, ViaMichelin, Stripe, empreinte bancaire, documents PDF, facturation et back-office pour piloter chaque dossier jusqu’à l’exploitation.
Dawap a sécurisé chaque transition du cycle de commande 1UP Distribution : panier métier, relecture, adresses, réservation temporaire, découpage par zones, import Odoo idempotent, progression, reprise, annulation, expédition, facture et avoir. Un workflow qui distingue clairement demande reçue, stock protégé et engagement confirmé.
L’API Pennylane synchronise achats, ventes et pièces comptables avec des statuts et périodes qui conditionnent les corrections possibles. Le point clé consiste à partir des faits pour gérer identifiants, documents et rejets, afin d’automatiser les échanges sans réémettre une facture ni modifier silencieusement une écriture clôturée.
Facturation électronique, PDP et API ne tiennent qu’avec un contrat stable, des statuts lisibles et des rejets classés dès la première alerte. Cette synthèse rappelle l’arbitrage utile : figer les référentiels, borner les retries et garder la preuve exploitable avant que la conformité ne vire au bricolage, surtout au go-live.
Une intégration API peut sembler fonctionner correctement pendant des semaines, puis générer soudainement des doublons de commandes, de paiements ou d’écritures comptables. Ce type d’incident coûte rarement seulement du temps technique. Il mobilise aussi le support, la finance et le commerce dans le run métier.
La réconciliation API devient utile quand chaque écart est relié à une source de vérité, à une preuve d’exécution et à une action bornée. Elle évite les resync massifs et transforme un doute sur la donnée en décision lisible. Le dispositif conserve la fenêtre, le watermark, la clé métier et le droit de correction avant tout replay ou compensation.
Questions fréquentes
Réponses sur les accès, scopes, factures, pièces PDF, changelogs, limites v2 et premier lot.
Il relie Pennylane à vos ERP, CRM, e-commerce ou outils documentaires avec des contrats d’identité, de facture, de pièce et de rapprochement. Dawap développe le middleware, les contrôles, l’observabilité et la reprise adaptés à votre processus.
Un Company API Token agit pour une société, un Firm API Token pour un cabinet et OAuth 2.0 convient aux intégrations partenaires. Le choix dépend du périmètre réel ; les secrets restent côté serveur et GET /me vérifie société et scopes effectifs.
POST /api/external/v2/customer_invoices requiert le scope customer_invoices:all. Le contrat contrôle notamment le client, les lignes, les montants sous forme de chaînes, external_reference et le statut draft ou finalized, puis relit et rapproche le résultat.
L’import se fait en deux temps : dépôt du PDF sur /file_attachments, puis appel d’import avec le file_attachment_id. La documentation limite le fichier au PDF et à 100 MB ; le connecteur suit séparément upload, import, rejet et rattachement.
Les résultats sont lus du plus ancien au plus récent avec next_cursor et has_more. La taille par défaut est 20 et peut aller jusqu’à 1 000. Le checkpoint durable n’avance qu’après la dernière page ; la rétention documentée de quatre semaines impose aussi un contrôle du retard.
L’API v2 documente 25 requêtes par cinq secondes et par token, avec HTTP 429, retry-after et en-têtes de limite. Les webhooks sont vérifiés par HMAC avec un secret présenté une seule fois ; le récepteur déduplique puis relit la ressource avec les scopes encore valides.
Pennylane API v2 · facturation et comptabilité
Dawap peut cadrer un dossier témoin puis construire le middleware, les contrôles, les changelogs et la reprise qui rendent Pennylane exploitable par finance, opérations et IT.
Cadrer mon dossier Pennylane
