Parametry techniczne iFirma API
5 sposobów automatyzacji z iFirma API
Poniżej znajdziesz konkretne zastosowania iFirma API w projektach automatyzacji procesów B2B — z opisem logiki, endpointów i realnej oszczędności czasu.
Automatyczne wystawianie faktur po zamknięciu projektu w CRM
Gdy projekt w ClickUp lub deal w HubSpot przechodzi do statusu "Zakończony", webhook triggeruje Make. Make pobiera dane klienta, kwotę i pozycje usług z CRM, wywołuje POST /faktura/nowy.json w iFirma — faktura jest wystawiona i wysłana klientowi e-mailem w ciągu kilku sekund.
POST /faktura/nowy.jsonGET /kontrahenci/lista.jsonPOST /kontrahenci/nowy.jsonFaktury cykliczne dla klientów retainerowych
Agencje i freelancerzy z klientami na miesięcznym retainerze mogą zautomatyzować wystawianie faktur 1. dnia miesiąca. Skrypt n8n iteruje po liście aktywnych kontraktów w Notion lub Airtable i wywołuje POST /faktura/nowy.json dla każdego klienta — bez ręcznego wystawiania dziesiątek faktur.
POST /faktura/nowy.jsonGET /faktury/lista.jsonSynchronizacja faktur z Google Sheets lub Airtable dla przeglądu finansowego
Tygodniowy skrypt pobiera listę faktur (GET /faktury/lista.json) z danego okresu i zapisuje do Google Sheets z kolumnami: klient, kwota netto/brutto, status płatności, termin. Szybki przegląd cash flow bez otwierania iFirmy.
GET /faktury/lista.jsonGET /faktura/{id}.jsonWeryfikacja NIP i auto-uzupełnianie danych kontrahenta
Przed wystawieniem faktury Make odpytuje GUS przez NIP (iFirma ma endpoint GET /kontrahenci/gus/{nip}.json), uzupełnia dane firmy i sprawdza czy kontrahent istnieje w bazie iFirma. Eliminuje błędy w danych nabywcy, które uniemożliwiają rozliczenie VAT.
GET /kontrahenci/gus/{nip}.jsonGET /kontrahenci/lista.jsonPOST /kontrahenci/nowy.jsonAlert o przeterminowanych fakturach i automatyczne przypomnienia
Codziennie rano Make pobiera faktury (GET /faktury/lista.json?status=wyslana) i filtruje przeterminowane. Dla każdej wystawia e-mail przypomnienie przez SendGrid i tworzy zadanie "Windykacja" w ClickUp przypisane do odpowiedniego handlowca — zero faktur ukrytych w systemie.
GET /faktury/lista.jsonGET /faktura/{id}/pdf.jsonKluczowe endpointy iFirma 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 Key + HMAC-SHA1 (podpis per endpoint).
/faktura/nowy.json
Utwórz fakturę VAT, proformę lub rachunek
/faktury/lista.json
Lista faktur z filtrowaniem po dacie i statusie
/faktura/{id}.json
Szczegóły faktury
/faktura/{id}/pdf.json
Pobierz fakturę jako PDF
/kontrahenci/lista.json
Lista kontrahentów
/kontrahenci/nowy.json
Utwórz kontrahenta
/kontrahenci/gus/{nip}.json
Pobierz dane firmy z GUS po NIP
Zanim wdrożysz integrację produkcyjnie, przetestuj endpointy w środowisku sandbox (jeśli dostępne) lub na dedykowanym koncie testowym. Dla iFirma API dokumentację techniczną znajdziesz na https://api.ifirma.pl.
Przykładowy przepływ: Przepływ: ClickUp projekt "Zakończony" → iFirma faktura → e-mail klient
- ClickUp webhook (task.status.changed → "Zakończone") → Make
- Make pobiera dane projektu: klient (nazwa firmy, NIP, adres), kwota, pozycje
- Make sprawdza czy kontrahent istnieje w iFirma: GET /kontrahenci/lista.json?nip=
- Jeśli nie — Make tworzy kontrahenta: POST /kontrahenci/nowy.json
- Make tworzy fakturę: POST /faktura/nowy.json z pozycjami usług i terminem 14 dni
- Make wysyła fakturę e-mailem do klienta bezpośrednio z iFirma
- Make dodaje notatkę w ClickUp z numerem faktury i linkiem
Jak JustAutomate wdraża integracje iFirma
W projektach JustAutomate integracja iFirma 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ą iFirma 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ć iFirma ze swoimi systemami, możemy omówić zakres i ROI w 30-minutowej rozmowie. Pierwsza konsultacja jest bezpłatna.
FAQ — najczęstsze pytania o iFirma API
Jak uwierzytelnić się w API iFirma?
iFirma używa HMAC-SHA1 — każde żądanie musi zawierać nagłówek Authentication z podpisem: HMAC-SHA1(klucz_prywatny, {endpoint}{treść}). Jest to bardziej skomplikowane niż prosty API token — sprawdź przykłady w dokumentacji api.ifirma.pl. Dostępne są gotowe biblioteki PHP i Python na GitHubie społeczności iFirma.
Jaka jest różnica między iFirmą a Fakturownią w kontekście API?
Fakturownia: prostszy, nowocześniejszy API (zwykły token w nagłówku), więcej integracji gotowych w Make/Zapier. iFirma: starszy, bardziej skomplikowane uwierzytelnianie (HMAC-SHA1), mniej native integracji. Dla nowych projektów Fakturownia jest łatwiejsza w integracji. iFirma jest popularna wśród użytkowników którzy już ją mają.
Czy iFirma API obsługuje wysyłkę faktury e-mailem?
Tak — po stworzeniu faktury (POST /faktura/nowy.json) możesz wywołać endpoint wysyłki e-mail. Podaj adres odbiorcy i iFirma wyśle PDF faktury z Twojego konta. Treść e-maila można dostosować w szablonach w panelu iFirma.
Czy iFirma obsługuje faktury w walutach obcych?
Tak. W POST /faktura/nowy.json podaj pole "waluta" (EUR, USD, GBP itp.) i kurs NBP. iFirma przeliczy kwotę na PLN dla celów podatkowych. Dla faktur eksportowych stawka VAT = 0%, co ustawiasz w pozycji faktury.
Czy można integrować iFirmę przez Make bez kodu?
Make ma moduł iFirma — możesz tworzyć faktury i pobierać listę bez pisania kodu. Ze względu na HMAC-SHA1 integracja jest bardziej złożona niż Fakturownia, ale Make obsługuje ją natywnie. Dla zaawansowanych scenariuszy (masowe wystawianie, walidacja NIP, warunkowe stawki VAT) zalecamy własny skrypt.
Potrzebujesz integracji iFirma
w swoich procesach?
Budujemy integracje iFirma API z CRM, ERP, fakturowaniem i narzędziami AI. Bezpłatna konsultacja — 30 minut, konkretny plan z ROI.