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 justificatif PDF ;
- de rattacher ce justificatif à une transaction bancaire existante ?
Si oui, pouvez-vous indiquer la documentation correspondante ?
Si ce n’est pas encore disponible dans l’API publique, pouvez-vous le confirmer ?
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.
4 Réponses
LLD_APIBonjour Angélique_
Nous ne voulons pas créer de facture client pour les payouts Shopify Payments.
Chaque PDF est un justificatif de payout agrégé Shopify Payments : un payout peut contenir plusieurs ventes, plusieurs commandes et plusieurs clients. Il n’y a donc pas de customer_id unique.
Nous voulons faire :
1. POST /api/external/v2/file_attachments pour envoyer le PDF ;
2. créer une écriture comptable / ledger entry portant ce file_attachment_id ;
3. laisser Pennylane rapprocher cette écriture avec la transaction bancaire Shopify Payments existante.
Pouvez-vous nous confirmer :
- l’endpoint exact à utiliser pour créer cette écriture comptable ;
- le payload attendu ;
- les scopes API nécessaires ;
- si le champ file_attachment_id est accepté dès la création de l’écriture ;
- comment Pennylane rapproche ensuite cette écriture avec la transaction bancaire ?
Merci !- LLD_API
Je crois que nous avons trouvé notre réponse ici :
https://pennylane.readme.io/docs/create-a-ledger-entry
- Angélique_
Pennylaneur
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.- LLD_API
Merci 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.
