API de facturation
Il n'existe pas encore d'API publique de facturation. Voici ce que vous pouvez automatiser aujourd'hui pour les factures, devis et dépenses, et ce qui arrive ensuite.
Pas encore disponible
Il n'existe aucun endpoint public pour les factures, devis, avoirs, factures récurrentes,
l'inventaire ou les dépenses. https://api2.bunnydoc.com/v1 ne sert aujourd'hui que
l'API de signature électronique. Tout ce que vous pourriez lire sur un
appel à /v1/invoices ne correspond à rien que nous proposions.
La facturation se gère dans l'application. Si vous préparez une intégration, voici exactement ce qui est possible ou non aujourd'hui, afin que vous puissiez concevoir en conséquence plutôt que de le découvrir en cours de route.
Ce que vous pouvez automatiser aujourd'hui
Recevoir les événements de facturation par webhook
C'est le seul point d'accroche programmatique de la facturation et, pour la plupart des intégrations, l'essentiel : il permet à votre système de réagir à un paiement sans interrogation répétée.
Configurez-le dans l'application sous Paramètres → Webhooks, en choisissant Facturation
comme produit. Vous ne pouvez pas créer ces abonnements via l'API (/v1/webhooks ne gère que les
abonnements de signature électronique), mais une fois enregistrés, ils sont livrés exactement comme
les webhooks de signature : même enveloppe, même signature HMAC, mêmes règles de réessai et de
désactivation automatique.
| Événement | Se déclenche quand |
|---|---|
invoice.issued | Une facture a été émise. |
invoice.sent | Une facture a été envoyée au client. |
invoice.viewed | Le client a ouvert la facture. |
invoice.partially_paid | Un paiement partiel a été appliqué. |
invoice.paid | Une facture a été intégralement payée. |
invoice.voided | Une facture a été annulée. |
invoice_payment.succeeded | Un paiement sur une facture a réussi. |
invoice_payment.failed | Un paiement sur une facture a échoué. |
invoice_payment.refunded | Un paiement sur une facture a été remboursé. |
expense.confirmed | Une dépense est sortie de l'état brouillon. |
expense.ocr_completed | L'OCR a fini d'extraire les données d'un reçu. |
expense.ocr_failed | L'OCR n'a pas pu extraire les données d'un reçu. |
Les webhooks de facturation sont facturés séparément de ceux de la signature électronique, et tous les événements ci-dessus relèvent du palier standard de facturation.
Aucun événement invoice.overdue
« En retard » est un filtre calculé (due_date dans le passé), pas un statut enregistré : rien ne
fait basculer une facture dans cet état, donc l'événement ne pourrait jamais se déclencher. Suivez
les échéances de votre côté à partir de invoice.issued ou invoice.sent.
Pour vérifier les signatures, gérer les réessais et comprendre l'enveloppe de livraison, utilisez le guide des webhooks : les sections 2 à 5 s'appliquent à tout abonnement, quel que soit le produit.
Encaisser à l'intérieur d'un document en cours de signature
Si ce que vous voulez vraiment, c'est « faire payer le client au moment où il signe », cela relève
de la signature électronique, pas de la facturation, et c'est entièrement disponible via l'API.
Placez un bloc de paiement sur le modèle, envoyez-le avec
POST /v1/envelopes/from-template et abonnez-vous à
payment.succeeded.
Sortir les données de l'application
- Les rapports s'exportent en CSV/XLSX : voir Rapports.
- Les e-mails de reçu et la page de paiement publique couvrent le côté client sans aucun travail d'intégration. Voir La page de paiement publique.
Ce qui n'est pas encore possible
- Créer, émettre, envoyer ou annuler une facture par programmation.
- Lire des données de factures, devis ou avoirs en HTTP.
- Gérer les produits, le stock, les catégories, les remises ou les taux de taxe.
- Créer ou lire des dépenses. (Les dépenses peuvent être créées en envoyant les reçus par e-mail à votre boîte de dépenses — voir Boîte de réception e-mail — ce qui remplace utilement une API d'ingestion.)