REST API: faktury i płatności

Śledź faktury i płatności przez REST API. Idealne dla firm usługowych, freelancerów i własnych systemów rozliczeń.

Przegląd

API faktur i płatności pozwala przesyłać do Bugalou dane faktur i płatności z zewnętrznych systemów rozliczeniowych. To idealne rozwiązanie dla firm usługowych — architektów, konsultantów, freelancerów i jednoosobowych działalności — które chcą automatyzować przypomnienia o płatnościach i śledzić status faktur w jednym panelu. 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

Wysyłanie danych faktury

Użyj punktu końcowego Orders API z polami dotyczącymi faktur:

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

{
  "platform": "custom",
  "orderNumber": "INV-2026-042",
  "orderStatus": "processing",
  "customerEmail": "klant@bedrijf.nl",
  "customerName": "Architectenbureau De Groot",
  "items": [
    {"name": "Ontwerp woning - fase 1", "quantity": 1, "price": "2500.00"},
    {"name": "Bouwtechnisch advies", "quantity": 3, "price": "150.00"}
  ],
  "total": "2950.00",
  "currency": "EUR",
  "paymentStatus": "pending",
  "invoiceNumber": "INV-2026-042",
  "invoiceUrl": "https://mijn-boekhouding.nl/facturen/INV-2026-042.pdf"
}

Aktualizacja statusu płatności

Gdy wpłynie płatność, zaktualizuj status, wysyłając ten sam numer faktury/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": "INV-2026-042",
  "orderStatus": "delivered",
  "paymentStatus": "paid",
  "paymentMethod": "bankoverschrijving",
  "amountPaid": "2950.00"
}

Zamówienie jest tworzone lub aktualizowane (upsert) — gdy orderNumber + platform się zgadzają, aktualizowany jest istniejący rekord.

Pola faktury

PoleTypWymaganeOpis
platformstringTakUżyj „custom” lub nazwy swojego narzędzia do fakturowania
orderNumberstringTakNumer faktury (np. „INV-2026-042”)
orderStatusstringTak„processing” (wysłana), „delivered” (opłacona), „cancelled”
customerEmailstringNieAdres e-mail klienta
customerNamestringNieImię i nazwisko klienta lub nazwa firmy
itemstablica JSONNieUsługi/produkty: [{name, quantity, price}]
totalstringNieSuma faktury
currencystringNie„EUR”, „USD” itd.
paymentStatusstringNie„pending”, „paid”, „overdue”, „refunded”
paymentMethodstringNie„bankoverschrijving”, „iDEAL”, „Tikkie”
invoiceNumberstringNieNumer referencyjny faktury
invoiceUrlstringNieLink do faktury PDF
amountPaidstringNieFaktycznie zapłacona kwota

Pomysły na automatyzacje

  • Przypomnienie o płatności: wysyłaj wiadomość WhatsApp lub e-mail, gdy faktura jest przeterminowana
  • Potwierdzenie płatności: automatycznie dziękuj klientowi, gdy paymentStatus zmieni się na „paid”
  • Przegląd miesięczny: synchronizuj faktury przez API i przeglądaj statusy płatności w jednym panelu

Dla kogo to jest?

  • Architekci i biura projektowe śledzący faktury za projekty
  • Freelancerzy i jednoosobowe działalności rozliczające klientów
  • Konsultanci wysyłający przypomnienia o płatnościach
  • Każda firma usługowa korzystająca z narzędzi takich jak Moneybird, Exact lub własnego systemu fakturowania

Format odpowiedzi

Sukces: {"success": true, "order": {...}}

Błąd: {"error": "Invalid or expired API key"} (401/403)

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

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

Zadaj pytanie