Jak połączyć KSeF z n8n i czy natywny template n8n jest bezpieczny po 2026?
Natywny template n8n do KSeF używa tokenów autoryzacyjnych, które wygasają 31 grudnia 2026 – od 1 stycznia 2027 Ministerstwo Finansów dopuszcza wyłącznie certyfikaty. Trwałe podejście to: KSeF Import (certyfikat .p12) pobiera faktury i eksportuje je do Google Sheets, a n8n czyta dane z arkusza i uruchamia dowolne workflow. Żadna kryptografia KSeF, żaden XML – tylko gotowe wiersze z danymi.
- Tokeny KSeF wygasają 31.12.2026 – szablony n8n oparte na tokenach przestaną działać od 1 stycznia 2027.
- KSeF Import używa certyfikatu .p12 (bez daty ważności) – to jedyna metoda autoryzacji działająca pewnie po 2026.
- Architektura mostu: KSeF Import → Google Sheets → n8n. n8n nie dotyka API KSeF ani XML FA(3).
- Solo wystarcza do Sheets + n8n; Excel/CSV/PDF od Firma+. Historia = ostatnie 90 dni, potem sync wg planu.
- n8n self-hosted jest darmowy – płacisz tylko za plan KSeF Import.
- To jedna z wielu integracji z KSeF – tym samym mostem wpinasz też Airtable, Notion, Zapier i Make.
W tym artykule
Od problemu do efektu
PWENatywny workflow n8n do KSeF korzysta z tokenów autoryzacyjnych. Token działa teraz, ale Ministerstwo Finansów zamyka tę metodę z końcem 2026 – zbudowany na nim workflow przestanie działać dokładnie 1 stycznia 2027.
KSeF Import autoryzuje się certyfikatem .p12, parsuje XML FA(3), respektuje limity API KSeF i eksportuje gotowe wiersze do Google Sheets – bez jednej linii kodu po Twojej stronie.
Skoro dane faktur lądują w arkuszu, n8n robi to, w czym jest najlepszy: powiadomienia Slack/Teams, wpisy Notion, raporty email, integracje CRM – dziś i po 2027.
Dlaczego natywny template n8n do KSeF jest przejściowy
n8n.io udostępnia gotowy workflow do pobierania faktur z KSeF (n8n.io/workflows/13925). Template autoryzuje się do API Ministerstwa Finansów tokenem autoryzacyjnym, inicjuje szyfrowaną sesję RSA-OAEP, odpytuje metadane i pobiera XML każdej faktury. To solidna implementacja – o ile masz programistę, który ją skonfiguruje i utrzyma.
Ministerstwo Finansów ogłosiło, że od 1 stycznia 2027 tokeny autoryzacyjne przestają być obsługiwane. Jedynymi metodami autoryzacji do KSeF pozostaną certyfikaty kwalifikowane i pieczęcie elektroniczne. Workflow n8n oparty na tokenie przestanie działać dokładnie tej nocy – bez ostrzeżenia.
Poza kwestią daty ważności natywna integracja n8n+KSeF ma kilka innych pułapek:
- Konfiguracja RSA-OAEP, challenge-response i pollingu – to nie jest „kliknij i działa". Wymaga zrozumienia kryptografii i protokołu KSeF.
- Parsowanie XML FA(3) – schemat faktury ustrukturyzowanej ma dziesiątki pól i zagnieżdżeń. Wyciągnięcie danych przez XPath w n8n to kilka godzin pracy.
- Rate limiting – API KSeF ma ściśle narzucone limity. Brak obsługi HTTP 429 i backoff = zablokowane IP.
- Self-hosting n8n jest wymagany od początku – serwer, aktualizacje, certyfikat SSL, backupy.
Trwałe podejście: KSeF Import jako most do n8n
Zamiast budować całą integrację z API KSeF wewnątrz n8n, warto podzielić odpowiedzialności: KSeF Import zajmuje się częścią KSeF (autoryzacja certyfikatem, pobieranie XML, parsowanie FA(3), obsługa limitów), a n8n zajmuje się automatyzacją dalszych kroków – powiadomieniami, raportami, integracjami z CRM czy Notion.
Połączenie między nimi to Google Sheets: KSeF Import dopisuje nowe faktury do arkusza, n8n czyta arkusz i reaguje na nowe wiersze.
| Cecha | n8n native template | KSeF Import + n8n |
|---|---|---|
| Autoryzacja do KSeF | Token (wygasa 31.12.2026) | Certyfikat .p12 (trwały) |
| Gotowość na 2027 | Nie – wymaga przebudowy | Tak – certyfikat działa dalej |
| Konfiguracja KSeF API | Ręczna (RSA-OAEP, challenge, polling) | Automatyczna (KSeF Import) |
| Parsowanie XML FA(3) | Ręczne (XPath w n8n) | Automatyczne (36+ pól) |
| Rate limiting KSeF | Ręczne zarządzanie | Automatyczne |
| Obsługa wielu NIP | Osobny workflow na każdy NIP | 1 konto, wiele NIP |
| Wymagania techniczne | Programista znający KSeF API | Konto + certyfikat .p12 |
KSeF API (certyfikat) → KSeF Import (auto-sync, parsowanie FA(3)) → Google Sheets (gotowe wiersze) → n8n trigger → Slack / Teams / Notion / CRM / email
Zobacz, jak KSeF Import pobiera faktury kosztowe i układa je w gotowy arkusz.
Jak skonfigurować KSeF Import + n8n – krok po kroku
Cała konfiguracja sprowadza się do czterech kroków. Nie wymaga znajomości API KSeF, kryptografii ani XML.
-
1
Wgraj certyfikat i uruchom sync
Zarejestruj się w KSeF Import, wgraj plik
.p12lub.pfxz portalu KSeF. Certyfikat szyfrujemy AES-256-GCM kluczem generowanym osobno per użytkownik; serwery w Unii Europejskiej (OVH). Pierwsze pobranie obejmuje ostatnie 90 dni – dochodzą automatycznie w tle. -
2
Podłącz Google Sheets
W panelu skonfiguruj eksport do wybranego arkusza Google. KSeF Import będzie dopisywać nowe faktury zgodnie z harmonogramem planu (Solo: co 24 h; Firma: co 6 h; Grupa: co 2 h; Biuro: co 15 min). Plan Solo wystarczy do uruchomienia n8n – masz Sheets i nowe faktury na bieżąco.
-
3
Dodaj trigger w n8n
W n8n dodaj 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. Połącz konto Google przez OAuth.
-
4
Zbuduj workflow
Dodaj node „IF" lub „Switch" – np. kwota brutto > 5 000 zł albo NIP sprzedawcy = nowy kontrahent. Potem akcja: Microsoft Teams, Slack, Notion, email SMTP, HTTP Request do CRM. n8n ma setki gotowych integracji.
Przy pierwszym, dużym imporcie zostaw synchronizację na noc. API KSeF udostępnia ok. 60 faktur na godzinę dla jednego NIP – zaległości dociągają się partiami w tle, rano masz pełny zestaw.
3 przykładowe workflow n8n z danymi KSeF
Kiedy faktury są w Google Sheets, możliwości n8n są praktycznie nieograniczone. Oto trzy workflow, które możesz postawić w ok. 15 minut:
Workflow 1 – Faktura > 5 000 zł → Teams + Notion
Chcesz wiedzieć o każdej dużej fakturze kosztowej natychmiast – zanim trafi do księgowości. Trigger: Google Sheets, nowy wiersz. IF: kolumna „Brutto" > 5000. Akcja: Teams – wiadomość na kanał #finanse oraz Notion – nowy rekord w bazie „Duże koszty" (data, kontrahent, kwota, numer faktury).
Workflow 2 – Codzienny raport kosztów na email
Codziennie o 8:00 dostajesz email z podsumowaniem wczorajszych faktur kosztowych. Trigger: Schedule, codziennie 08:00. Google Sheets: filtruj wiersze z wczorajszą datą. Function: zsumuj netto/VAT/brutto i policz faktury. Email: „Wczoraj: 7 faktur na 12 450 zł brutto" – zaczynasz dzień z pełnym obrazem kosztów.
Workflow 3 – Nowy kontrahent → alert + CRM
Pojawia się faktura od NIP-u spoza bazy kontrahentów. Trigger: Google Sheets, nowy wiersz. Function: porównaj NIP sprzedawcy z listą znanych kontrahentów. IF: NIP nieznany. Akcja: Slack – alert z nazwą i kwotą; HTTP Request – POST do CRM z danymi nowego dostawcy.
n8n Community Edition możesz postawić na VPS lub na tym samym serwerze co inne usługi – bez opłat. n8n Cloud (płatny, w pełni hostowany) eliminuje konieczność własnego serwera, jeśli wolisz środowisko zarządzane.
Kiedy wybrać n8n native, a kiedy KSeF Import + n8n
Oba podejścia mają swoje miejsce – wybór zależy od Twojej sytuacji i horyzontu czasowego.
| Sytuacja | Rekomendacja |
|---|---|
| Programista zna API KSeF, obsługujesz 1 NIP, nie przeszkadza przebudowa w 2027 | n8n native template (przejściowo) |
| Chcesz gotowe rozwiązanie bez programisty | KSeF Import + n8n |
| Obsługujesz wiele NIP-ów (biuro rachunkowe, grupa spółek) | KSeF Import + n8n |
| Zależy Ci na pewności działania po 1 stycznia 2027 | KSeF Import + n8n (certyfikat) |
| Brak czasu na parsowanie XML FA(3) i rate limiting | KSeF Import + n8n |
Większość użytkowników n8n to specjaliści od automatyzacji, nie inżynierowie KSeF API. KSeF Import zajmuje się częścią KSeF, n8n zajmuje się resztą – każde narzędzie robi to, w czym jest najlepsze. Szczegóły planów i limitów eksportu znajdziesz w cenniku.
Plan Solo daje eksport do Google Sheets (jedyna potrzeba do uruchomienia n8n) i sync co 24 h. Excel, CSV i PDF są dostępne od planu Firma+. Porównaj plany.
Najczęstsze pytania
Krótkie, konkretne odpowiedzi na pytania, które zadają użytkownicy i wyszukiwarki.
Tak, ale tylko do 31 grudnia 2026. Od 1 stycznia 2027 tokeny autoryzacyjne KSeF przestają działać i workflow przestanie się łączyć z API Ministerstwa Finansów. Jeśli chcesz uniknąć przebudowy, zacznij od razu od podejścia z certyfikatem.
Nie – KSeF Import nie udostępnia publicznego API dla n8n. Most przez Google Sheets jest celowy: arkusz działa jako bufor danych, a n8n reaguje na nowe wiersze. To prostsze i nie wymaga tokenu API ani konfiguracji OAuth poza standardowym Google.
Plan Solo wystarczy – masz eksport do Google Sheets i sync co 24 godziny. Jeśli potrzebujesz szybszego syncu lub eksportu do Excela i CSV, sięgnij po plan Firma lub wyższy. Szczegóły na stronie cennik.
Pierwsze pobranie obejmuje ostatnie 90 dni. To okno stałe – nie możesz pobrać starszych faktur przez KSeF Import. Starsze dokumenty pozostają w KSeF (Ministerstwo Finansów przechowuje je 10 lat) i w razie potrzeby pobierzesz je z portalu po numerze KSeF.
Tak. Trigger Google Sheets i dalsze nody działają identycznie w obu wariantach. Różnica to koszt i obowiązek utrzymania serwera: self-hosted jest darmowy, ale wymaga własnego VPS; n8n Cloud jest managed, ale płatny.
Certyfikat szyfrujemy algorytmem AES-256-GCM kluczem generowanym osobno dla każdego użytkownika (HKDF). Serwery w Unii Europejskiej (OVH). Połączenie z KSeF przez oficjalne, szyfrowane API. Dane każdego klienta izolowane identyfikatorem tenant_id. Szczegóły w polityce prywatności.
Inżynier integracji KSeF. Odpowiada za połączenia z API Krajowego Systemu e-Faktur, automatyzacje i parsowanie struktury logicznej FA(3).