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.
LLD_APIPremière note
Première noteBonjour 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
