API REST : facturation et paiements

Suivez vos factures et paiements via l'API REST. Idéal pour les entreprises de services, les indépendants et les systèmes de facturation sur mesure.

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_here
  • Authorization: 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

ChampTypeObligatoireDescription
platformstringOuiUtilisez « custom » ou le nom de votre outil de facturation
orderNumberstringOuiNuméro de facture (par ex. « INV-2026-042 »)
orderStatusstringOui« processing » (envoyée), « delivered » (payée), « cancelled »
customerEmailstringNonAdresse e-mail du client
customerNamestringNonNom du client ou de l'entreprise
itemstableau JSONNonServices/produits : [{name, quantity, price}]
totalstringNonMontant total de la facture
currencystringNon« EUR », « USD », etc.
paymentStatusstringNon« pending », « paid », « overdue », « refunded »
paymentMethodstringNon« bankoverschrijving », « iDEAL », « Tikkie »
invoiceNumberstringNonRéférence de la facture
invoiceUrlstringNonLien vers le PDF de la facture
amountPaidstringNonMontant 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 paymentStatus passe à « 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)

Vous ne trouvez pas ce que vous cherchez ?

Posez-nous directement votre question et vous recevrez une réponse personnelle.

Poser votre question