REST API: Bestellingen & E-commerce
Beheer bestellingen vanuit webshops en eigen systemen. Volg orderstatus, verzending en betalingen via de REST API.
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_hierAuthorization: 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:
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.