Présentation
L'API Facturation et paiements vous permet d'envoyer des données de factures et de paiements à Bugalou depuis des systèmes de facturation externes. Elle est idéale pour les entreprises de services (architectes, consultants, indépendants, ZZP'ers) qui souhaitent automatiser leurs relances de paiement et suivre le statut de leurs factures dans un seul tableau de bord. Vous avez besoin d'une clé API pour vous authentifier.
Authentification
Incluez votre clé API dans chaque requête :
X-API-Key: bg_live_your_key_hereAuthorization: Bearer bg_live_your_key_here
Envoyer des données de facture
Utilisez l'endpoint de l'API Commandes avec les champs propres aux factures :
POST https://app.bugalou.com/api/v1/orders
X-API-Key: bg_live_your_key_here
Content-Type: application/json
{
"platform": "custom",
"orderNumber": "INV-2026-042",
"orderStatus": "processing",
"customerEmail": "klant@bedrijf.nl",
"customerName": "Architectenbureau De Groot",
"items": [
{"name": "Ontwerp woning - fase 1", "quantity": 1, "price": "2500.00"},
{"name": "Bouwtechnisch advies", "quantity": 3, "price": "150.00"}
],
"total": "2950.00",
"currency": "EUR",
"paymentStatus": "pending",
"invoiceNumber": "INV-2026-042",
"invoiceUrl": "https://mijn-boekhouding.nl/facturen/INV-2026-042.pdf"
}
Mettre à jour le statut de paiement
Lorsqu'un paiement arrive, mettez à jour le statut en envoyant le même numéro de facture/commande :
POST https://app.bugalou.com/api/v1/orders
X-API-Key: bg_live_your_key_here
Content-Type: application/json
{
"platform": "custom",
"orderNumber": "INV-2026-042",
"orderStatus": "delivered",
"paymentStatus": "paid",
"paymentMethod": "bankoverschrijving",
"amountPaid": "2950.00"
}
La commande est créée ou mise à jour (upsert) : l'enregistrement existant est mis à jour lorsque orderNumber + platform correspondent.
Référence des champs de facture
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
platform | string | Oui | Utilisez « custom » ou le nom de votre outil de facturation |
orderNumber | string | Oui | Numéro de facture (par ex. « INV-2026-042 ») |
orderStatus | string | Oui | « processing » (envoyée), « delivered » (payée), « cancelled » |
customerEmail | string | Non | Adresse e-mail du client |
customerName | string | Non | Nom du client ou de l'entreprise |
items | tableau JSON | Non | Services/produits : [{name, quantity, price}] |
total | string | Non | Montant total de la facture |
currency | string | Non | « EUR », « USD », etc. |
paymentStatus | string | Non | « pending », « paid », « overdue », « refunded » |
paymentMethod | string | Non | « bankoverschrijving », « iDEAL », « Tikkie » |
invoiceNumber | string | Non | Référence de la facture |
invoiceUrl | string | Non | Lien vers le PDF de la facture |
amountPaid | string | Non | Montant effectivement payé |
Idées d'automatisation
- Relance de paiement : déclenchez un WhatsApp ou un e-mail lorsqu'une facture est en retard
- Confirmation de paiement : remerciez automatiquement le client lorsque
paymentStatuspasse à « paid » - Aperçu mensuel : utilisez l'API pour synchroniser vos factures et voir le statut des paiements dans un seul tableau de bord
Pour qui ?
- Les architectes et bureaux d'études qui suivent leurs factures de projet
- Les indépendants et ZZP'ers qui gèrent la facturation de leurs clients
- Les consultants qui envoient des relances de paiement
- Toute entreprise de services utilisant des outils comme Moneybird, Exact ou une facturation sur mesure
Format de réponse
Succès : {"success": true, "order": {...}}
Erreur : {"error": "Invalid or expired API key"} (401/403)