Overzicht

De Facturatie & Betalingen API laat je factuur- en betalingsgegevens naar Bugalou sturen vanuit externe boekhoudsystemen. Dit is ideaal voor dienstverlenende bedrijven — architecten, consultants, freelancers, ZZP'ers — die betalingsherinneringen willen automatiseren en factuurstatus in één dashboard willen bijhouden. Je hebt een API-sleutel nodig om te authenticeren.

Authenticatie

Voeg je API-sleutel toe aan elk verzoek:

• X-API-Key: bg_live_jouw_sleutel_hier
• Authorization: Bearer bg_live_jouw_sleutel_hier

Factuurgegevens Versturen

Gebruik het Orders API-endpoint met factuur-specifieke velden:

POST https://app.bugalou.com/api/v1/orders
X-API-Key: bg_live_jouw_sleutel_hier
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"
}

Betalingsstatus Bijwerken

Wanneer een betaling binnenkomt, update de status door hetzelfde factuur-/ordernummer te sturen:

POST https://app.bugalou.com/api/v1/orders
X-API-Key: bg_live_jouw_sleutel_hier
Content-Type: application/json

{
  "platform": "custom",
  "orderNumber": "INV-2026-042",
  "orderStatus": "delivered",
  "paymentStatus": "paid",
  "paymentMethod": "bankoverschrijving",
  "amountPaid": "2950.00"
}

De order wordt ge-upsert — het bestaande record wordt bijgewerkt wanneer orderNumber + platform overeenkomen.

Factuurvelden Referentie

Veld	Type	Verplicht	Beschrijving
platform	string	Ja	Gebruik "custom" of de naam van je boekhoudsysteem
orderNumber	string	Ja	Factuurnummer (bijv. "INV-2026-042")
orderStatus	string	Ja	"processing" (verzonden), "delivered" (betaald), "cancelled"
customerEmail	string	Nee	E-mailadres van klant
customerName	string	Nee	Klant- of bedrijfsnaam
items	JSON array	Nee	Diensten/producten: [{name, quantity, price}]
total	string	Nee	Factuurtotaal
currency	string	Nee	"EUR", "USD", enz.
paymentStatus	string	Nee	"pending", "paid", "overdue", "refunded"
paymentMethod	string	Nee	"bankoverschrijving", "iDEAL", "Tikkie"
invoiceNumber	string	Nee	Factuurreferentie
invoiceUrl	string	Nee	Link naar factuur-PDF
amountPaid	string	Nee	Daadwerkelijk betaald bedrag

Automatiseringsideeën

• Betalingsherinnering: Trigger een WhatsApp of e-mail wanneer een factuur achterstallig is
• Betalingsbevestiging: Bedank de klant automatisch wanneer paymentStatus verandert naar "paid"
• Maandoverzicht: Gebruik de API om facturen te synchroniseren en betalingsstatus in één dashboard te bekijken

Voor Wie Is Dit?

• Architecten en ontwerpbureaus die projectfacturen bijhouden
• Freelancers en ZZP'ers die klantfacturatie beheren
• Consultants die betalingsherinneringen versturen
• Elk dienstverlenend bedrijf dat tools gebruikt zoals Moneybird, Exact of eigen facturatiesoftware

Response Formaat

Succes: {"success": true, "order": {...}}

Fout: {"error": "Invalid or expired API key"} (401/403)