Forum Discussion
LLD_API
Première note
Première noteAPI : comment rattacher un justificatif PDF à une transaction bancaire ?
Bonjour, Nous développons une intégration avec l’API Pennylane. Nous savons déjà récupérer les transactions bancaires via l’API. Existe-t-il un endpoint officiel permettant : d’envoyer un justif...
Bonjour LLD_API
Oui pour l'envoi d'un PDF, non pour un rattachement direct à une transaction bancaire.
Envoi du fichier — L'API publique v2 fournit un endpoint officiel POST /api/external/v2/file_attachments. Il accepte notamment les fichiers PDF (et images), jusqu'à 100 Mo, et renvoie un identifiant de pièce jointe (file_attachment_id). Il nécessite le scope file_attachments:all.
Rattachement — Ce file_attachment_id peut être rattaché à toute ressource qui expose ce champ, c'est-à-dire les factures (clients et fournisseurs) et les écritures comptables (ledger entries). Les cas d'usage officiellement supportés mentionnent explicitement le rattachement de fichiers « aux factures ou aux écritures comptables ».
Transaction bancaire — Il n'existe pas, dans l'API publique, d'endpoint permettant de rattacher directement un justificatif à une transaction bancaire existante. Les endpoints de transactions couvrent la consultation, la création, la mise à jour et le rapprochement avec des factures, mais pas l'ajout d'une pièce jointe. Le justificatif d'une transaction passe donc par le rapprochement de cette transaction avec une facture ou une écriture qui, elle, porte la pièce jointe.
Angélique_
Pennylaneur
PennylaneurBonjour LLD_API
Oui pour l'envoi d'un PDF, non pour un rattachement direct à une transaction bancaire.
Envoi du fichier — L'API publique v2 fournit un endpoint officiel POST /api/external/v2/file_attachments. Il accepte notamment les fichiers PDF (et images), jusqu'à 100 Mo, et renvoie un identifiant de pièce jointe (file_attachment_id). Il nécessite le scope file_attachments:all.
Rattachement — Ce file_attachment_id peut être rattaché à toute ressource qui expose ce champ, c'est-à-dire les factures (clients et fournisseurs) et les écritures comptables (ledger entries). Les cas d'usage officiellement supportés mentionnent explicitement le rattachement de fichiers « aux factures ou aux écritures comptables ».
Transaction bancaire — Il n'existe pas, dans l'API publique, d'endpoint permettant de rattacher directement un justificatif à une transaction bancaire existante. Les endpoints de transactions couvrent la consultation, la création, la mise à jour et le rapprochement avec des factures, mais pas l'ajout d'une pièce jointe. Le justificatif d'une transaction passe donc par le rapprochement de cette transaction avec une facture ou une écriture qui, elle, porte la pièce jointe.
LLD_APIPremière note
Première noteMerci Angélique, c’est exactement ce que nous avions compris. 🙂
Notre objectif n’est pas d’attacher directement un PDF à une transaction bancaire.
Notre workflow est le suivant :
- Nous récupérons automatiquement les factures fournisseurs (PDF) depuis Gmail.
- Nous envoyons ces PDF dans Pennylane via l’endpoint file_attachments.
- Nous créons (ou utilisons) la facture fournisseur en y rattachant le file_attachment_id.
- La facture apparaît alors dans Pennylane avec son PDF original, comme un véritable justificatif.
- Enfin, nous laissons Pennylane effectuer le rapprochement avec la transaction bancaire correspondante.
Nous ne cherchons donc jamais à ajouter une pièce jointe directement sur une transaction bancaire, mais à suivre le workflow recommandé par l’API publique, où le justificatif est porté par la facture, puis rapproché automatiquement avec le paiement.
C’est précisément cette architecture que nous sommes en train de mettre en place. Merci pour votre confirmation.
