Przegląd
Orders API pozwala tworzyć, aktualizować i pobierać zamówienia z dowolnego zewnętrznego systemu — niezależnie od tego, czy korzystasz z Shopify, WooCommerce, Lightspeed, innej platformy, czy własnego sklepu. Zamówienia pojawiają się w panelu Bugalou i mogą uruchamiać automatyzacje. Do uwierzytelniania potrzebujesz klucza API.
Uwierzytelnianie
Dołączaj klucz API do każdego żądania:
X-API-Key: bg_live_your_key_hereAuthorization: Bearer bg_live_your_key_here
Tworzenie lub aktualizacja zamówienia
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"
}
Zamówienia są tworzone lub aktualizowane (upsert) — wysłanie tej samej kombinacji orderNumber + platform aktualizuje istniejące zamówienie zamiast tworzyć duplikat.
Pobieranie listy zamówień
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
Te same pola co powyżej. Używaj tego punktu końcowego przy integracji przez Zapier.
Pola zamówienia
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
platform | string | Tak | Nazwa platformy (np. „custom”, „shopify”, „woocommerce”, „lightspeed”) |
orderNumber | string | Tak | Unikalny identyfikator zamówienia |
orderStatus | string | Tak | „processing”, „shipped”, „delivered”, „cancelled” |
customerEmail | string | Nie | Adres e-mail klienta |
customerName | string | Nie | Imię i nazwisko klienta |
items | tablica JSON | Nie | [{name, quantity, price}] |
total | string | Nie | Łączna kwota zamówienia |
currency | string | Nie | „EUR”, „USD” itd. |
trackingCode | string | Nie | Kod śledzenia przesyłki |
trackingUrl | string | Nie | Adres URL śledzenia |
paymentStatus | string | Nie | „paid”, „pending”, „refunded”, „failed” |
paymentMethod | string | Nie | „iDEAL”, „creditcard”, „PayPal” |
Format odpowiedzi
Sukces: {"success": true, "order": {...}}
Błąd: {"error": "Invalid or expired API key"} (401/403)
Przewodniki po platformach
Wbudowane integracje z platformami opisują artykuły:
Wyzwalacze automatyzacji
Zamówienia utworzone przez API mogą automatycznie uruchamiać szablony automatyzacji — np. wysyłać e-mail z potwierdzeniem lub wiadomość WhatsApp, gdy wpłynie nowe zamówienie.