REST API: zamówienia i e-commerce

Zarządzaj zamówieniami ze sklepów internetowych i własnych systemów. Śledź status zamówień, wysyłkę i płatności przez REST API.

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

PoleTypWymaganeOpis
platformstringTakNazwa platformy (np. „custom”, „shopify”, „woocommerce”, „lightspeed”)
orderNumberstringTakUnikalny identyfikator zamówienia
orderStatusstringTak„processing”, „shipped”, „delivered”, „cancelled”
customerEmailstringNieAdres e-mail klienta
customerNamestringNieImię i nazwisko klienta
itemstablica JSONNie[{name, quantity, price}]
totalstringNieŁączna kwota zamówienia
currencystringNie„EUR”, „USD” itd.
trackingCodestringNieKod śledzenia przesyłki
trackingUrlstringNieAdres URL śledzenia
paymentStatusstringNie„paid”, „pending”, „refunded”, „failed”
paymentMethodstringNie„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.

Nie możesz znaleźć tego, czego szukasz?

Zapytaj nas bezpośrednio, a otrzymasz osobistą odpowiedź.

Zadaj pytanie