Présentation
L'API Commandes vous permet de créer, mettre à jour et lister des commandes depuis n'importe quel système externe, que vous utilisiez Shopify, WooCommerce, Lightspeed ou une boutique en ligne sur mesure. Les commandes apparaissent dans votre tableau de bord Bugalou et peuvent déclencher des automatisations. Vous avez besoin d'une clé API pour vous authentifier.
Authentification
Incluez votre clé API dans chaque requête :
X-API-Key: bg_live_your_key_hereAuthorization: Bearer bg_live_your_key_here
Créer ou mettre à jour une commande
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"
}
Les commandes sont créées ou mises à jour (upsert) : envoyer la même combinaison orderNumber + platform met à jour la commande existante au lieu de créer un doublon.
Lister les commandes
GET https://app.bugalou.com/api/v1/orders?page=1&limit=20 X-API-Key: bg_live_your_key_here
Webhook Zapier
POST https://app.bugalou.com/api/zapier/order X-API-Key: bg_live_your_key_here Content-Type: application/json
Mêmes champs que ci-dessus. Utilisez cet endpoint pour une intégration via Zapier.
Référence des champs de commande
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
platform | string | Oui | Nom de la plateforme (par ex. « custom », « shopify », « woocommerce », « lightspeed ») |
orderNumber | string | Oui | Identifiant unique de la commande |
orderStatus | string | Oui | « processing », « shipped », « delivered », « cancelled » |
customerEmail | string | Non | Adresse e-mail du client |
customerName | string | Non | Nom complet du client |
items | tableau JSON | Non | [{name, quantity, price}] |
total | string | Non | Montant total de la commande |
currency | string | Non | « EUR », « USD », etc. |
trackingCode | string | Non | Code de suivi de l'expédition |
trackingUrl | string | Non | URL de suivi |
paymentStatus | string | Non | « paid », « pending », « refunded », « failed » |
paymentMethod | string | Non | « iDEAL », « creditcard », « PayPal » |
Format de réponse
Succès : {"success": true, "order": {...}}
Erreur : {"error": "Invalid or expired API key"} (401/403)
Guides par plateforme
Pour les intégrations de plateformes intégrées, consultez :
Déclencheurs d'automatisation
Les commandes créées via l'API peuvent déclencher automatiquement des modèles d'automatisation, par exemple l'envoi d'un e-mail ou d'un message WhatsApp de confirmation à l'arrivée d'une nouvelle commande.