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_hereAuthorization: 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
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
platform | string | Tak | Użyj „custom” lub nazwy swojego narzędzia do fakturowania |
orderNumber | string | Tak | Numer faktury (np. „INV-2026-042”) |
orderStatus | string | Tak | „processing” (wysłana), „delivered” (opłacona), „cancelled” |
customerEmail | string | Nie | Adres e-mail klienta |
customerName | string | Nie | Imię i nazwisko klienta lub nazwa firmy |
items | tablica JSON | Nie | Usługi/produkty: [{name, quantity, price}] |
total | string | Nie | Suma faktury |
currency | string | Nie | „EUR”, „USD” itd. |
paymentStatus | string | Nie | „pending”, „paid”, „overdue”, „refunded” |
paymentMethod | string | Nie | „bankoverschrijving”, „iDEAL”, „Tikkie” |
invoiceNumber | string | Nie | Numer referencyjny faktury |
invoiceUrl | string | Nie | Link do faktury PDF |
amountPaid | string | Nie | Faktycznie 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
paymentStatuszmieni 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)