API REST : commandes et e-commerce

Gérez les commandes de vos boutiques en ligne et systèmes sur mesure. Suivez le statut des commandes, l'expédition et les paiements via l'API REST.

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

ChampTypeObligatoireDescription
platformstringOuiNom de la plateforme (par ex. « custom », « shopify », « woocommerce », « lightspeed »)
orderNumberstringOuiIdentifiant unique de la commande
orderStatusstringOui« processing », « shipped », « delivered », « cancelled »
customerEmailstringNonAdresse e-mail du client
customerNamestringNonNom complet du client
itemstableau JSONNon[{name, quantity, price}]
totalstringNonMontant total de la commande
currencystringNon« EUR », « USD », etc.
trackingCodestringNonCode de suivi de l'expédition
trackingUrlstringNonURL de suivi
paymentStatusstringNon« paid », « pending », « refunded », « failed »
paymentMethodstringNon« 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.

Vous ne trouvez pas ce que vous cherchez ?

Posez-nous directement votre question et vous recevrez une réponse personnelle.

Poser votre question