API REST: pedidos y comercio electrónico

Gestiona pedidos de tiendas online y sistemas personalizados. Haz seguimiento del estado de los pedidos, los envíos y los pagos mediante la API REST.

Visión general

La API de pedidos te permite crear, actualizar y listar pedidos desde cualquier sistema externo, ya uses Shopify, WooCommerce, Lightspeed, Magento o una tienda online personalizada. Los pedidos aparecen en tu panel de Bugalou y pueden activar automatizaciones. Necesitas una clave de API para autenticarte.

Autenticación

Incluye tu clave de API en cada solicitud:

X-API-Key: bg_live_your_key_here
Authorization: Bearer bg_live_your_key_here

Crear o actualizar un pedido

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": "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"
}

Los pedidos se insertan o actualizan (upsert): si envías la misma combinación de orderNumber + platform, se actualiza el pedido existente en lugar de crear un duplicado.

Listar pedidos

GET https://app.bugalou.com/api/v1/orders?page=1&limit=20
X-API-Key: bg_live_your_key_here

Webhook de Zapier

POST https://app.bugalou.com/api/zapier/order
X-API-Key: bg_live_your_key_here
Content-Type: application/json

Los mismos campos que arriba. Usa este endpoint cuando integres mediante Zapier.

Referencia de campos del pedido

Campo	Tipo	Obligatorio	Descripción
`platform`	string	Sí	Nombre de la plataforma (p. ej. "custom", "shopify", "woocommerce", "lightspeed")
`orderNumber`	string	Sí	Identificador único del pedido
`orderStatus`	string	Sí	"processing", "shipped", "delivered", "cancelled"
`customerEmail`	string	No	Dirección de email del cliente
`customerName`	string	No	Nombre completo del cliente
`items`	JSON array	No	[{name, quantity, price}]
`total`	string	No	Importe total del pedido
`currency`	string	No	"EUR", "USD", etc.
`trackingCode`	string	No	Código de seguimiento del envío
`trackingUrl`	string	No	URL de seguimiento
`paymentStatus`	string	No	"paid", "pending", "refunded", "failed"
`paymentMethod`	string	No	"iDEAL", "creditcard", "PayPal"

Formato de la respuesta

Éxito: {"success": true, "order": {...}}

Error: {"error": "Invalid or expired API key"} (401/403)

Guías por plataforma

Para las integraciones de plataformas incluidas, consulta:

Desencadenantes de automatización

Los pedidos creados mediante la API pueden activar automáticamente plantillas de automatización, por ejemplo enviar un email o un mensaje de WhatsApp de confirmación cuando llega un pedido nuevo.