KSeF + n8n — darmowa automatyzacja faktur kosztowych z open-source workflow

n8n to open-source'owe narzędzie do automatyzacji, które zyskuje coraz większą popularność w Polsce. Self-hosted, darmowe w wersji community, z setkami gotowych integracji. Nic dziwnego, że pojawił się też natywny template n8n do KSeF (n8n.io/workflows/13925), który pozwala pobierać faktury bezpośrednio z API Ministerstwa Finansów.

Brzmi idealnie? Prawie. Jest jeden problem: template n8n używa tokenów KSeF, które wygasają 31 grudnia 2026. Od 1 stycznia 2027 Ministerstwo Finansów zamyka możliwość autoryzacji tokenem — zostają wyłącznie certyfikaty kwalifikowane i pieczęcie elektroniczne. Jeśli zbudujesz cały workflow na tokenie, za kilka miesięcy przestanie działać.

W tym artykule pokażemy dwa podejścia do łączenia KSeF z n8n — i dlaczego KSeF Import + n8n daje Ci automatyzację, która przetrwa zmianę przepisów.

n8n i KSeF — dwa podejścia, jedno lepsze

Zacznijmy od tego, co oferuje natywny template n8n dla KSeF. To workflow złożony z kilkunastu nodów, który:

• Autoryzuje się do API KSeF za pomocą tokena autoryzacyjnego (generowanego w portalu MF)
• Inicjuje sesję interaktywną z szyfrowaniem RSA-OAEP
• Wysyła zapytanie o faktury (query metadata)
• Pobiera XML każdej faktury
• Parsuje dane z XML i zapisuje do arkusza lub bazy danych

To solidna implementacja — jeśli masz programistę, który ją skonfiguruje i utrzyma. Problem polega na tym, że:

• Token KSeF wygasa 31.12.2026 — po tej dacie workflow przestanie się autoryzować
• Self-hosting n8n jest wymagany od początku — musisz postawić serwer, zadbać o aktualizacje, certyfikaty SSL, backupy
• Konfiguracja RSA-OAEP, challenge-response i pollingu — to nie jest „kliknij i działa". Wymaga zrozumienia kryptografii i API KSeF
• Parsowanie XML FA(3) — schemat faktury ustrukturyzowanej ma dziesiątki pól, zagnieżdżeń i wariantów. Wyciągnięcie danych XPath w n8n to praca na kilka godzin
• Rate limiting — API KSeF ma ściśle limity (20 zapytań o metadane na godzinę). Brak obsługi 429 i backoff = zablokowane IP

Alternatywa: KSeF Import pobiera faktury za Ciebie (z certyfikatem, który nie wygasa), eksportuje je do Google Sheets, a n8n czyta gotowe dane z arkusza. Zamiast budować całą integrację KSeF od zera w n8n, używasz n8n do tego, w czym jest najlepszy — automatyzacji dalszych kroków.

Porównanie: n8n native template vs. KSeF Import + n8n

Kluczowa różnica: n8n native template wymaga, żebyś sam zbudował i utrzymywał całą integrację z API KSeF. KSeF Import przejmuje tę część — Ty skupiasz się na tym, co zrobić z danymi, a nie na tym, jak je wyciągnąć.

Jak podłączyć KSeF Import do n8n — krok po kroku

Cała integracja składa się z czterech kroków. Nie wymaga znajomości API KSeF, kryptografii ani XML.

1. Krok 1: KSeF Import → Google Sheets

   Rejestrujesz się w KSeF Import, wgrywasz certyfikat .p12 i konfigurujesz eksport do Google Sheets. System automatycznie pobiera nowe faktury (co kilka godzin, zależnie od planu) i dopisuje je do arkusza. Każdy wiersz to jedna faktura z pełnym zestawem danych: numer, data, NIP, kwoty, pozycje.

2. Krok 2: W n8n → node „Google Sheets Trigger"

   Dodajesz node „Google Sheets Trigger" z ustawieniem „Row Added". n8n odpytuje arkusz co kilka minut i uruchamia workflow, gdy pojawi się nowy wiersz — czyli nowa faktura z KSeF.

3. Krok 3: Filtrowanie danych

   Dodajesz node „IF" lub „Switch", żeby reagować tylko na konkretne faktury. Przykład: kwota brutto > 5 000 zł, NIP sprzedawcy = nowy kontrahent, albo faktura z określoną kategorią.

4. Krok 4: Akcja docelowa

   Podłączasz docelowy node: powiadomienie na Microsoft Teams lub Slack, wpis do Notion, email do zarządu, zapis do CRM, request HTTP do własnego API. n8n ma setki gotowych integracji.

3 przykładowe workflow n8n z danymi KSeF

Kiedy dane faktur są już w Google Sheets, możliwości n8n są praktycznie nieograniczone. Oto trzy workflow, które możesz postawić w 15 minut:

Workflow 1: Faktura > 5 000 zł → Teams + Notion

Scenariusz: Chcesz wiedzieć o każdej dużej fakturze kosztowej natychmiast — zanim księgowa ją zaksięguje.

• Trigger: Google Sheets → nowy wiersz
• Filtr: IF → kolumna „Brutto" > 5000
• Akcja 1: Microsoft Teams → wiadomość na kanał #finanse: „Nowa faktura od [Sprzedawca] na [Kwota] zł"
• Akcja 2: Notion → nowy rekord w bazie „Duże koszty" z polami: data, kontrahent, kwota, numer faktury

Efekt: zarząd widzi duże koszty w czasie rzeczywistym, bez czekania na miesięczny raport.

Workflow 2: Codzienny raport faktur → email

Scenariusz: Codziennie o 8:00 rano chcesz dostać email z podsumowaniem wczorajszych faktur kosztowych.

• Trigger: Schedule → codziennie o 8:00
• Pobranie danych: Google Sheets → filtruj wiersze z wczorajszą datą
• Agregacja: n8n Function → policz sumę netto, VAT, brutto, liczbę faktur
• Akcja: Email (SMTP lub SendGrid) → „Wczoraj: 7 faktur na łącznie 12 450 zł brutto"

Efekt: zaczynasz dzień z pełnym obrazem kosztów, bez logowania się gdziekolwiek.

Workflow 3: Nowy kontrahent → alert + CRM

Scenariusz: Pojawia się faktura od NIP-u, którego nie ma w Twojej bazie kontrahentów. Może to pomyłka, może nowy dostawca — chcesz o tym wiedzieć.

• Trigger: Google Sheets → nowy wiersz
• Sprawdzenie: n8n Function → porównaj NIP sprzedawcy z listą znanych kontrahentów (osobny arkusz lub baza)
• Filtr: IF → NIP nie istnieje na liście
• Akcja 1: Slack → alert: „Faktura od nowego kontrahenta: [Nazwa], NIP: [NIP], kwota: [Brutto] zł"
• Akcja 2: HTTP Request → POST do CRM z danymi kontrahenta (lub Google Sheets → dopisz NIP do listy)

Efekt: żadna faktura od nieznanego podmiotu nie przejdzie niezauważona.

Kiedy wybrać n8n native, a kiedy KSeF Import + n8n

Oba podejścia mają swoje miejsce. Wybór zależy od Twojej sytuacji:

Wybierz n8n native template, jeśli:

• Masz programistę, który zna API KSeF i potrafi skonfigurować RSA-OAEP, challenge-response i polling
• Obsługujesz jeden NIP i nie planujesz skalowania
• Nie przeszkadza Ci, że od 1 stycznia 2027 będziesz musiał przebudować autoryzację na certyfikat
• Chcesz mieć pełną kontrolę nad każdym krokiem (i jesteś gotów za to zapłacić czasem)

Wybierz KSeF Import + n8n, jeśli:

• Chcesz gotowe rozwiązanie, które działa od pierwszego dnia — bez programisty
• Obsługujesz wiele NIP-ów (np. biuro rachunkowe, grupa spółek)
• Chcesz automatyzację, która przetrwa zmianę przepisów w 2027 (certyfikat zamiast tokenu)
• Nie masz czasu na parsowanie XML FA(3), obsługę rate limitów i debugging kryptografii
• Wolisz skupić się na workflow n8n (powiadomienia, raporty, integracje), a nie na budowaniu konektora KSeF

W praktyce większość użytkowników n8n nie jest programistami KSeF API — są specjalistami od automatyzacji. KSeF Import zajmuje się częścią KSeF, n8n zajmuje się resztą. Każde narzędzie robi to, w czym jest najlepsze.

Ile to kosztuje

Całkowity koszt rozwiązania KSeF Import + n8n zależy od tego, jak hostujesz n8n:

• KSeF Import plan Solo: 9 zł/msc — 1 NIP, 50 faktur, eksport do Google Sheets, sync co 24h
• KSeF Import plan Firma: 29 zł/msc — 1 NIP, 200 faktur, Sheets + Excel + CSV + PDF, sync co 6h
• n8n Community (self-hosted): 0 zł — hostujesz na własnym serwerze (VPS od 20-30 zł/msc) lub na tym samym serwerze co inne usługi
• n8n Cloud: od ~85 zł/msc (20 EUR) — nie musisz nic hostować, gotowe środowisko z aktualizacjami

Minimalna konfiguracja: 9 zł/msc (KSeF Import Solo + n8n self-hosted na istniejącym serwerze). Dla firmy z większą liczbą faktur: 29 zł/msc + n8n community = 29 zł za pełną automatyzację od KSeF do Slacka, Teamsa czy CRM.

Dla porównania: ręczne pobieranie faktur z KSeF, eksport, filtrowanie i wysyłanie powiadomień to minimum 2-3 godziny pracy miesięcznie. Przy stawce 100 zł/h — automatyzacja zwraca się już po pierwszym miesiącu.

Jak zacząć

1. Zarejestruj się w KSeF Import i wgraj certyfikat

   Darmowy okres próbny: 7 dni, do 1000 faktur. Wystarczy, żeby przetestować cały flow.

2. Skonfiguruj eksport do Google Sheets

   Wybierz pola, które chcesz widzieć. System zacznie automatycznie pobierać faktury.

3. Podłącz Google Sheets do n8n

   Dodaj trigger „Google Sheets — Row Added" i zbuduj swój pierwszy workflow. 15 minut wystarczy na powiadomienia o dużych fakturach.

Zamiast budować konektor KSeF od zera, dostajesz dane w arkuszu i automatyzujesz dalsze kroki w n8n. Prościej, szybciej i — co najważniejsze — bezpiecznie po 2027.