À qui s’adresse cet article ? Cet article concerne les marchands qui ne souhaitent pas utiliser Pennylane comme plateforme agréée (PA) pour l’envoi de leurs factures, et qui ont désigné une autre plateforme agréée. Il explique comment récupérer régulièrement vos factures via l’API de ProAbono afin de les transmettre vous-même à votre plateforme agréée.
Contexte : les plateformes agréées
Dans le cadre de la facturation électronique, une entreprise dispose de :
- une seule plateforme agréée configurée en réception (pour les factures émises par ses fournisseurs) ;
- une ou plusieurs plateformes agréées configurées en émission (pour envoyer les factures à ses clients).
Une même entreprise peut donc avoir plusieurs plateformes agréées différentes. Par exemple :
- une PA configurée pour la réception des factures fournisseurs ;
- une PA (Pennylane) configurée pour l’émission des factures clients émises par ProAbono ;
- une autre PA configurée pour l’émission des factures émises par un autre logiciel de facturation, utilisé par une autre activité de l’entreprise.
Si vous avez choisi de ne pas passer par Pennylane pour transmettre les factures générées dans ProAbono, vous devez récupérer ces factures par vos propres moyens et les transmettre à votre plateforme agréée. C’est l’objet de cet article.
Principe : l’API backoffice de ProAbono
La récupération des factures s’effectue via l’API back-office de ProAbono, par plage de dates. Les dates sont attendues au format ISO AAAA-MM-JJ (par exemple 2026-07-22). Deux opérations complémentaires sont à réaliser régulièrement (par exemple quotidiennement) :
- Récupérer les nouvelles factures émises — sur la base de leur date d’émission.
- Récupérer les factures devenues payées — sur la base de leur date de dernière modification.
Le paramètre isCredit
Il existe deux types de factures : les factures et les factures d’avoir (notes de crédit). Le paramètre isCredit permet de les distinguer. Chaque étape ci-dessous doit donc être exécutée deux fois :
- isCredit=false → factures
- isCredit=true → factures d’avoir (notes de crédit)
Étape 1 — Récupérer toutes les nouvelles factures émises
- GET /Finance/Invoices?isCredit=false&DateIssueMin=AAAA-MM-JJ&DateIssueMax=AAAA-MM-JJ
- GET /Finance/Invoices?isCredit=true&DateIssueMin=AAAA-MM-JJ&DateIssueMax=AAAA-MM-JJ
Important
- Le champ DateIssue (date d’émission) permet de détecter les nouvelles factures émises sur la période demandée.
- Pour chaque facture retournée, téléchargez le PDF depuis le lien hosted-pdf fourni dans la réponse.
Étape 2 — Récupérer les factures devenues payées
- GET /Finance/Invoices?isCredit=false&DateUpdateMin=AAAA-MM-JJ&DateUpdateMax=AAAA-MM-JJ&StatusInvoice=Paid
- GET /Finance/Invoices?isCredit=true&DateUpdateMin=AAAA-MM-JJ&DateUpdateMax=AAAA-MM-JJ&StatusInvoice=Paid
Important
- Le filtre StatusInvoice=Paid inclut également les factures remboursées.
- Le champ DateUpdateMin (date de dernière modification) permet de détecter tout changement, quel que soit l’âge de la facture. Une facture émise avant la période interrogée mais payée récemment sera ainsi bien remontée.
En résumé
| Objectif | Filtre de date utilisé | Filtre de statut | À exécuter pour |
| Détecter les nouvelles factures émises | DateIssueMin / DateIssueMax | — | isCredit=false et isCredit=true |
| Détecter les factures devenues payées (ou remboursées) | DateUpdateMin / DateUpdateMax | StatusInvoice=Paid | isCredit=false et isCredit=true |
En combinant ces deux appels sur chaque période, vous disposez à la fois des nouvelles factures et des factures d’avoir, ainsi que des mises à jour de statut, prêtes à être transmises à votre propre plateforme agréée.