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 20 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.