Parametry techniczne Fakturownia API
5 sposobów automatyzacji z Fakturownia API
Poniżej znajdziesz konkretne zastosowania Fakturownia API w projektach automatyzacji procesów B2B — z opisem logiki, endpointów i realnej oszczędności czasu.
Automatyczne fakturowanie po zamknięciu deala w CRM
Gdy handlowiec zamknie deal w HubSpot lub Pipedrive (etap "Closed Won"), webhook triggeruje Make. Make pobiera dane deala — nazwa firmy, NIP, kwota, pozycje usług — i wysyła POST /invoices.json do Fakturowni. Faktura trafia do klienta e-mailem w ciągu 10 sekund.
POST /invoices.jsonGET /clients.jsonPOST /clients.jsonWystawianie faktur cyklicznych za subskrypcje
Firmy oferujące usługi w modelu SaaS lub retainer mogą zautomatyzować wystawianie faktur co miesiąc. Skrypt n8n lub Make iteruje po liście aktywnych kontraktów i wywołuje POST /invoices.json z odpowiednimi datami i kwotami — bez udziału działu finansowego.
POST /invoices.jsonGET /invoices.json?period=last_monthSynchronizacja zamówień e-commerce z fakturami
Integracja BaseLinker → Fakturownia przez Make: nowe zamówienie na Allegro lub w WooCommerce automatycznie generuje fakturę lub paragon. System sprawdza, czy kupujący podał NIP — jeśli tak, wystawia FV, jeśli nie, wystawia paragon fiskalny.
POST /invoices.jsonGET /clients.json?name=Sprawdzanie statusu płatności i alerty przeterminowania
Codziennie rano automatyzacja odpytuje GET /invoices.json?status=issued i filtruje faktury, których termin minął. Dla każdej przeterminowanej faktury wysyła e-mail przypomnienie przez SendGrid API i tworzy zadanie w ClickUp dla opiekuna klienta.
GET /invoices.json?status=issuedPOST /invoices/{id}/send_by_email.jsonEksport danych do BigQuery lub Google Sheets na potrzeby analiz
Miesięczny skrypt pobiera wszystkie faktury przez paginację (GET /invoices.json?page=1..N), transformuje JSON do tabelarycznej struktury i ładuje do BigQuery lub Google Sheets. Dzięki temu CFO ma aktualny dashboard sprzedaży bez ręcznych eksportów CSV.
GET /invoices.json?page={n}&per_page=100Kluczowe endpointy Fakturownia API
Poniżej lista endpointów najczęściej używanych w automatyzacjach. Każdy endpoint jest częścią standardowego REST API i obsługuje autentykację przez API Token (nagłówek X-AUTH-TOKEN).
/invoices.json
Lista faktur z filtrowaniem po statusie, dacie, kontrahencie
/invoices.json
Utwórz fakturę (FV, FV pro forma, paragon, nota)
/invoices/{id}.json
Pobierz pojedynczą fakturę
/invoices/{id}.json
Zaktualizuj fakturę (tylko szkice)
/invoices/{id}/send_by_email.json
Wyślij fakturę e-mailem
/clients.json
Lista kontrahentów z wyszukiwaniem po NIP/nazwie
/clients.json
Utwórz kontrahenta
Zanim wdrożysz integrację produkcyjnie, przetestuj endpointy w środowisku sandbox (jeśli dostępne) lub na dedykowanym koncie testowym. Dla Fakturownia API dokumentację techniczną znajdziesz na https://app.fakturownia.pl/api.
Przykładowy przepływ: Przepływ: HubSpot Deal → Faktura Fakturownia → E-mail do klienta
- HubSpot (deal stage = "Closed Won") wysyła webhook do Make
- Make pobiera dane deala: firmę, kwotę, usługi, właściwości NIP/adres
- Make sprawdza w Fakturowni czy kontrahent istnieje (GET /clients.json?name=)
- Jeśli brak kontrahenta — tworzy go (POST /clients.json) z danymi z HubSpota
- Make tworzy fakturę (POST /invoices.json) z pozycjami i terminem 14 dni
- Fakturownia zwraca {"id": 123, "view_url": "https://..."}
- Make wysyła fakturę e-mailem (POST /invoices/123/send_by_email.json)
- Make aktualizuje deal w HubSpot — dodaje notatkę z linkiem do faktury
Jak JustAutomate wdraża integracje Fakturownia
W projektach JustAutomate integracja Fakturownia API to jeden z najczęstszych elementów automatyzacji. Nasz proces zaczyna się od audytu API — sprawdzamy dostępne endpointy, rate limity, stabilność tokenów i formatów danych po stronie klienta.
W większości przypadków używamy Make lub n8n jako middleware — narzędzia, które łączą Fakturownia z innymi systemami bez pisania kodu. Dla złożonych przypadków (własna logika transformacji danych, integracja z legacy systemem, niestandardowe formaty) piszemy skrypty Node.js lub Python z pełną obsługą błędów i logowaniem.
Każda integracja, którą budujemy, ma monitoring — wiemy natychmiast, gdy API zwróci błąd 5xx lub przekroczymy rate limit. Klient nie dowiaduje się o awarii z opóźnieniem — system jest samo-naprawiający i alertuje nas zanim wpłynie to na procesy.
Jeśli chcesz zintegrować Fakturownia ze swoimi systemami, możemy omówić zakres i ROI w 30-minutowej rozmowie. Pierwsza konsultacja jest bezpłatna.
FAQ — najczęstsze pytania o Fakturownia API
Jak uzyskać klucz API Fakturowni?
W panelu Fakturowni wejdź w Ustawienia → Dane API. Token jest widoczny po pierwszym zalogowaniu i pozostaje stały (nie wygasa). Przekazuj go w nagłówku HTTP X-AUTH-TOKEN przy każdym zapytaniu.
Czy Fakturownia API obsługuje faktury korygujące?
Tak. Typ dokumentu ustawiasz przez pole "kind" w POST /invoices.json — wartości: "vat", "proforma", "receipt", "correction". Faktura korygująca wymaga podania ID faktury pierwotnej w polu "correction_reason_id".
Ile zapytań API mogę wysłać w ciągu minuty?
Fakturownia stosuje rate limiting na poziomie 50–100 requestów na minutę w zależności od planu. Przy masowych operacjach (np. import faktur) stosuj kolejkowanie z opóźnieniem 1–2 sekund między żądaniami.
Czy mogę dodać logo firmy do faktury przez API?
Logo ustawia się raz w panelu Fakturowni (Ustawienia → Logo), a następnie automatycznie pojawia się na wszystkich fakturach generowanych przez API. Nie ma potrzeby przekazywania obrazu w każdym żądaniu.
Jak sprawdzić NIP kontrahenta przed wystawieniem faktury?
Fakturownia ma endpoint GUS: GET /clients/gus_lookup.json?nip={NIP} — pobiera dane firmy z rejestru GUS po numerze NIP. Dzięki temu możesz uzupełnić dane kontrahenta automatycznie bez ręcznego wpisywania nazwy i adresu.
Potrzebujesz integracji Fakturownia
w swoich procesach?
Budujemy integracje Fakturownia API z CRM, ERP, fakturowaniem i narzędziami AI. Bezpłatna konsultacja — 30 minut, konkretny plan z ROI.