Panoramica
L'API degli ordini ti permette di creare, aggiornare ed elencare ordini da qualsiasi sistema esterno, che tu usi Shopify, WooCommerce, Lightspeed o un negozio online su misura. Gli ordini compaiono nella tua dashboard di Bugalou e possono avviare automazioni. La REST API è disponibile con il piano Enterprise. Per autenticarti ti serve una chiave API.
Autenticazione
Includi la tua chiave API in ogni richiesta:
X-API-Key: bg_live_your_key_hereAuthorization: Bearer bg_live_your_key_here
Creare o aggiornare un ordine
POST https://app.bugalou.com/api/v1/orders
X-API-Key: bg_live_your_key_here
Content-Type: application/json
{
"platform": "custom",
"orderNumber": "ORD-12345",
"orderStatus": "processing",
"customerEmail": "klant@voorbeeld.nl",
"customerName": "Emma 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"
}
Gli ordini vengono creati o aggiornati (upsert): inviando la stessa combinazione orderNumber + platform si aggiorna l'ordine esistente invece di crearne un duplicato.
Elencare gli ordini
GET https://app.bugalou.com/api/v1/orders?page=1&limit=20 X-API-Key: bg_live_your_key_here
Webhook di Zapier
POST https://app.bugalou.com/api/zapier/order X-API-Key: bg_live_your_key_here Content-Type: application/json
Stessi campi di sopra. Usa questo endpoint quando ti integri tramite Zapier.
Riferimento dei campi dell'ordine
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
platform | string | Sì | Nome della piattaforma (per esempio “custom”, “shopify”, “woocommerce”, “lightspeed”) |
orderNumber | string | Sì | Identificativo univoco dell'ordine |
orderStatus | string | Sì | “processing”, “shipped”, “delivered”, “cancelled” |
customerEmail | string | No | Indirizzo email del cliente |
customerName | string | No | Nome completo del cliente |
items | JSON array | No | [{name, quantity, price}] |
total | string | No | Importo totale dell'ordine |
currency | string | No | “EUR”, “USD”, ecc. |
trackingCode | string | No | Codice di tracciamento della spedizione |
trackingUrl | string | No | URL di tracciamento |
paymentStatus | string | No | “paid”, “pending”, “refunded”, “failed” |
paymentMethod | string | No | “iDEAL”, “creditcard”, “PayPal” |
Formato della risposta
Successo: {"success": true, "order": {...}}
Errore: {"error": "Invalid or expired API key"} (401/403)
Guide per piattaforma
Per le integrazioni integrate con le piattaforme, vedi:
Trigger di automazione
Gli ordini creati tramite l'API possono avviare automaticamente i modelli di automazione, per esempio per inviare un'email o un messaggio WhatsApp di conferma quando arriva un nuovo ordine.