Factures
Créez, envoyez et suivez des factures ponctuelles ou récurrentes.
Une facture demande à un client un montant fixe, une seule fois ou selon un cycle récurrent. Consultez Facturation → Facture pour le guide complet du produit.
Côté serveur, live uniquement
Appelez les endpoints des factures depuis votre serveur, avec votre clé privée (sk.). Ils
ne sont disponibles qu'en live : il n'y a pas de facturation en sandbox.
Endpoints
| Méthode | Chemin | Description |
|---|---|---|
POST | /invoices | Créer une facture |
GET | /invoices | Lister les factures |
GET | /invoices/{id} | Récupérer une facture |
PUT | /invoices/{id} | Modifier une facture (si elle est modifiable) |
DELETE | /invoices/{id} | Supprimer une facture (si elle est modifiable) |
POST | /invoices/{id}/send | Envoyer la facture au client par e-mail |
POST | /invoices/{id}/mark-paid | Marquer la facture comme payée (en totalité ou en partie) |
POST | /invoices/{id}/cancel | Annuler une facture |
POST | /invoices/{id}/stop-recurring | Arrêter une facture récurrente, quel que soit son statut |
Factures récurrentes
Passez is_recurring: true et un recurring_interval à la création pour que Wajub génère la
facture suivante à chaque cycle, sous forme de brouillon que vous envoyez vous-même. Seule une
facture peut être récurrente : un devis, une estimation ou une copie générée répond 422. La
première est due un intervalle après invoice_date, et next_invoice_date sur la facture indique
la date de la suivante. Une copie générée porte l'id de sa facture récurrente dans
recurring_parent.
POST /invoices/{id}/stop-recurring met fin à la série à tout moment, facture payée comprise ; les
copies déjà générées restent. Consultez Facturation → Factures récurrentes
pour le déroulé complet.
Événements
Un changement de statut fait par l'API (envoyée, consultée, payée, annulée, remboursée) est livré
sous la forme invoice.updated : lisez data.status pour savoir lequel a eu lieu. Deux changements
n'envoient rien : une facture qui passe overdue, et tout
ce qui est fait dans le Dashboard. Interrogez GET /invoices?status=overdue pour voir le premier.
Consultez le catalogue complet des événements.
| Événement | Déclencheur |
|---|---|
invoice.created | Une nouvelle facture a été créée : une seule fois, avec ses lignes et ses totaux |
invoice.updated | La facture a changé par l'API (une fois par PUT, aucun pour un PUT qui ne change rien), ou a été consultée ou payée en ligne |
invoice.payment_succeeded | Un paiement fait sur la page de la facture a réussi, tranches comprises |
invoice.paid | La facture est entièrement réglée |
invoice.deleted | La facture a été supprimée |
Le PDF
GET https://api.wajub.com/i/{id}/pdf renvoie la facture en PDF, sans clé, une fois qu'elle a été
envoyée (un brouillon répond 404). Il est rédigé dans la language de la facture ; ?locale=fr
ou ?locale=en demande l'autre. Consultez le guide des factures.