REST API: ordini ed e-commerce

Gestisci gli ordini da negozi online e sistemi personalizzati. Monitora stato degli ordini, spedizioni e pagamenti tramite la REST API.

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

CampoTipoObbligatorioDescrizione
platformstringSìNome della piattaforma (per esempio “custom”, “shopify”, “woocommerce”, “lightspeed”)
orderNumberstringSìIdentificativo univoco dell'ordine
orderStatusstringSì“processing”, “shipped”, “delivered”, “cancelled”
customerEmailstringNoIndirizzo email del cliente
customerNamestringNoNome completo del cliente
itemsJSON arrayNo[{name, quantity, price}]
totalstringNoImporto totale dell'ordine
currencystringNo“EUR”, “USD”, ecc.
trackingCodestringNoCodice di tracciamento della spedizione
trackingUrlstringNoURL di tracciamento
paymentStatusstringNo“paid”, “pending”, “refunded”, “failed”
paymentMethodstringNo“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.

Non trovi quello che cerchi?

Chiedi direttamente a noi e riceverai una risposta personale.

Fai la tua domanda