Pobieranie faktur z KSeF w n8n: scenariusz krok po kroku

Co robi przepływ od harmonogramu do maila

Schedule Trigger uruchamia przepływ, na przykład co trzy godziny w dni robocze.
Uwierzytelnienie. Węzły HTTP Request pobierają wyzwanie (challenge), przekazują zaszyfrowany token i odbierają krótkotrwały token dostępowy. Szyfrowanie kluczem publicznym MF robię w węźle Code.
Zapytanie o metadane. Przepływ pyta o faktury, w których firma występuje jako nabywca, od daty zapamiętanej przy poprzednim przebiegu. Wyniki przychodzą stronami, więc pętla pobiera kolejne strony do końca listy.
Odsiew powtórek. Węzeł Remove Duplicates w trybie pomijania elementów z poprzednich wykonań porównuje numery KSeF i przepuszcza tylko nowe.
Pobranie XML. Dla każdej nowej faktury przepływ pobiera plik po numerze KSeF, a węzeł XML zamienia go na dane, z których biorę pola do zestawienia, na przykład P_15 z kwotą należności ogółem.
Zapis. Plik trafia do folderu na Dysku Google lub OneDrive z nazwą złożoną z daty, NIP sprzedawcy i numeru KSeF. Do arkusza dopisuję wiersz: sprzedawca, NIP, numer faktury, kwota brutto, termin płatności i link do pliku.
Powiadomienie. Księgowa dostaje jeden mail z listą nowych dokumentów, a nie osobną wiadomość o każdej fakturze.

Token, uprawnienia i ich ważność

Do API potrzebny jest sposób uwierzytelnienia nadany w KSeF dla Twojego NIP. W KSeF 2.0 to najczęściej token KSeF albo certyfikat KSeF. Przepływ niczego nie wystawia, więc daję mu wyłącznie uprawnienie do przeglądania faktur.

Token przechowuję w poświadczeniach n8n, a nie w treści węzła, i nie wysyłam go w powiadomieniach ani logach. Na własnym serwerze klucz szyfrujący n8n (zmienna N8N_ENCRYPTION_KEY) trzymam w kopii zapasowej osobno, bo bez niego zapisane poświadczenia są bezużyteczne.

Część źródeł podaje, że tokeny KSeF mają działać do końca 2026 roku, a potem ich miejsce zajmą certyfikaty KSeF. Przed wdrożeniem sprawdzam aktualne zasady w dokumentacji na ksef.podatki.gov.pl i ustawiam przypomnienie o odnowieniu. To opis techniczny, a nie porada podatkowa.

Pułapki, które wychodzą dopiero po kilku tygodniach

Data przyjęcia zamiast daty wystawienia

Faktura wystawiona w trybie offline może trafić do KSeF kilka dni po dacie na dokumencie. Filtruję po dacie, w której faktura znalazła się w systemie, z oknem nachodzącym na poprzedni przebieg. Powtórki i tak odsiewa numer KSeF.

Limity zapytań

API ogranicza liczbę zapytań w czasie. Przy wielu plikach ustawiam w węźle HTTP Request partie z odstępem i ponowienia po błędzie, zamiast pobierać wszystko naraz.

Przepływ, który cicho przestał działać

Wygasły token nie wysyła żadnego maila, faktury po prostu przestają przychodzić. Dlatego dodaję Error Workflow z alertem oraz codzienną kontrolę, czy przebieg w ogóle się wykonał.

Korekty

Faktura korygująca ma własny numer KSeF. W arkuszu dostaje osobny wiersz z numerem faktury pierwotnej, żeby księgowa widziała pary dokumentów.

Kiedy n8n wystarczy, a kiedy potrzebna jest pełna integracja

Sytuacja	Przepływ w n8n	Pełna integracja
Faktury zakupowe mają trafić do arkusza, na dysk i do księgowej	wystarcza	zbędna
Faktury mają powstawać jako dokumenty w ERP lub programie magazynowym	tylko gdy program ma API lub import	zwykle pewniejsza
Wystawianie faktur sprzedaży z własnego systemu	nie polecam	tak, z kolejką, trybem offline i korektami
Kilka firm z osobnymi NIP	możliwe, z osobnym uwierzytelnieniem dla każdej	przy dużej liczbie firm

Wysyłkę faktur sprzedaży, zapis numeru KSeF w ERP i tryb offline opisuję na stronie integracja z KSeF. Jeśli Twój program do faktur sam pobiera dokumenty z KSeF, sprawdź najpierw tę funkcję, bo może zastąpić cały przepływ. Najmniejsze firmy, które do końca 2026 wystawiają poza KSeF, znajdą terminy w tekście KSeF dla mikrofirmy.

Co dalej z pobraną fakturą

Pobranie to dopiero początek obiegu. Ten sam przepływ może wysłać fakturę do akceptacji kierownika albo przekazać ją do dekretacji, co opisuję na stronie automatyczne księgowanie faktur kosztowych.

Przepływ działa w chmurze n8n albo na własnym serwerze. Przy fakturach wybieram zwykle serwer w UE, który opisuję na stronie hosting n8n. Inne przepływy oparte na polskich systemach zbieram w gotowych scenariuszach n8n, a jeśli dopiero poznajesz narzędzie, zacznij od tekstu co to jest n8n. Koszty wdrożenia rozbijam na części w poradniku ile kosztuje wdrożenie n8n.

Najczęstsze pytania

Czy do pobierania faktur z KSeF potrzebuję płatnej wersji n8n?

Nie. Przepływ korzysta z węzłów dostępnych w wersji community na własnym serwerze: harmonogramu, HTTP Request, Code, XML i Google Drive. Płatne plany n8n dodają głównie funkcje dla zespołów i administracji, a nie dostęp do KSeF.

Czy przepływ może pobierać faktury dla kilku firm?

Tak, jeśli każda z nich nadała uprawnienie do przeglądania faktur. Dla każdego NIP przepływ loguje się osobno i zapisuje dokumenty w osobnym folderze, a błąd jednej firmy nie zatrzymuje pozostałych.

Co się stanie, gdy KSeF nie odpowiada?

Przebieg kończy się błędem i wysyła alert. Kolejny przebieg zaczyna od daty ostatniego udanego pobrania, więc zaległe faktury dociągnie sam. Nic nie ginie, najwyżej przychodzi z opóźnieniem.

Czy mogę od razu zapisywać faktury w programie księgowym?

Zależy od programu. Część przyjmuje dokumenty przez API lub import pliku, część ma własną obsługę KSeF i wtedy przepływ jest zbędny. Sprawdzam to w dokumentacji konkretnej wersji przed wyceną.

Automatyczne pobieranie faktur z KSeF w n8n do arkusza i na dysk