Overzicht

De Bestellingen API laat je orders aanmaken, bijwerken en ophalen vanuit elk extern systeem — of je nu Shopify, WooCommerce, Lightspeed, Magento of een eigen webshop gebruikt. Bestellingen verschijnen in je Bugalou-dashboard en kunnen automatiseringen triggeren. 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

Bestelling Aanmaken of Bijwerken

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

{
  "platform": "custom",
  "orderNumber": "ORD-12345",
  "orderStatus": "processing",
  "customerEmail": "klant@voorbeeld.nl",
  "customerName": "Jan de Vries",
  "items": [{"name": "Product A", "quantity": 1, "price": "29.99"}],
  "total": "29.99",
  "currency": "EUR",
  "paymentStatus": "paid",
  "paymentMethod": "iDEAL",
  "trackingCode": "3SPOST1234567",
  "trackingUrl": "https://postnl.nl/track/3SPOST1234567"
}

Bestellingen worden ge-upsert — hetzelfde orderNumber + platform stuurt een update in plaats van een duplicaat.

Bestellingen Ophalen

GET https://app.bugalou.com/api/v1/orders?page=1&limit=20
X-API-Key: bg_live_jouw_sleutel_hier

Zapier Webhook

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

Dezelfde velden als hierboven. Gebruik dit endpoint bij integratie via Zapier.

Bestelvelden Referentie

Veld	Type	Verplicht	Beschrijving
platform	string	Ja	Platformnaam (bijv. "custom", "shopify", "woocommerce", "lightspeed")
orderNumber	string	Ja	Uniek bestelnummer
orderStatus	string	Ja	"processing", "shipped", "delivered", "cancelled"
customerEmail	string	Nee	E-mailadres van klant
customerName	string	Nee	Volledige naam van klant
items	JSON array	Nee	[{name, quantity, price}]
total	string	Nee	Totaalbedrag bestelling
currency	string	Nee	"EUR", "USD", enz.
trackingCode	string	Nee	Verzend-trackingcode
trackingUrl	string	Nee	Tracking URL
paymentStatus	string	Nee	"paid", "pending", "refunded", "failed"
paymentMethod	string	Nee	"iDEAL", "creditcard", "PayPal"

Response Formaat

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

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

Platformhandleidingen

Voor ingebouwde platformintegraties, zie:

• Shopify instellen
• WooCommerce instellen
• bol.com instellen
• Zapier instellen

Automatiseringstriggers

Bestellingen aangemaakt via de API kunnen automatisch automatiseringstemplates triggeren — bijvoorbeeld het versturen van een bevestiging per e-mail of WhatsApp wanneer er een nieuwe bestelling binnenkomt.