Przejdź do treści
KSeF Kit

Integracja z KSeF: jak wybrać swoją drogę

Nie ma jednej „integracji z KSeF”. Jeśli wystawiasz faktury w polskim programie do faktur, KSeF masz już w środku i wystarczy go włączyć. Jeśli sprzedajesz przez polską platformę e-commerce, ma ona własny moduł. Jeśli rozliczasz płatności przez Stripe, potrzebujesz mostu i dopiero tu zaczyna się nasza rola. Jeśli piszesz własne oprogramowanie, idziesz prosto do API. A jeśli wystawiasz kilka faktur miesięcznie ręcznie, wystarczy darmowa rządowa Aplikacja Podatnika.

Czym dziś wystawiasz faktury Co zrobić
Fakturownia, inFakt, wFirma, iFirma, Comarch, Symfonia Włącz KSeF w ustawieniach programu. Nic nie integrujesz.
BaseLinker, Allegro, idoSell, Shoper Użyj modułu KSeF swojej platformy.
Stripe (Billing, Checkout, subskrypcje) Potrzebujesz mostu ze Stripe'a do KSeF.
Własne oprogramowanie Integrujesz się bezpośrednio z API KSeF.
Kilka faktur miesięcznie, ręcznie Aplikacja Podatnika, za darmo.

Wystawiasz faktury w polskim programie do faktur

Fakturownia, inFakt, wFirma, iFirma, Comarch, Symfonia i cała reszta polskich programów księgowych mają KSeF wbudowany od dawna, bo musiały. Obowiązek objął ich klientów 1 lutego i 1 kwietnia 2026 r. Nie integrujesz więc niczego. Wchodzisz w ustawienia, wklejasz token KSeF albo wgrywasz certyfikat i od tej pory faktury lecą do systemu.

W usługach chmurowych, czyli w Fakturowni, inFakcie, wFirmie i iFirmie, KSeF jest zwykle bez dopłaty, w każdym planie. W systemach ERP bywa inaczej: Comarch Optima wprowadził za KSeF osobną opłatę od 1 sierpnia 2026 r., a Symfonia liczy za niego rocznie. Sprawdź własny cennik, ale nie kupuj drugiego narzędzia po to, żeby zrobić coś, co Twój program już umie.

To jest odpowiedź dla większości osób, które pytają o integrację z KSeF. My nic tu nie wnosimy.

Sprzedajesz przez polską platformę e-commerce

BaseLinker, Allegro, idoSell i Shoper wypuściły własne moduły KSeF w pierwszym kwartale 2026 r., pod ten sam obowiązek. Faktury powstają w panelu platformy i tam też jest przełącznik do KSeF. Włącz go u siebie i sprawdź na pierwszym zamówieniu.

Nasze narzędzie nie ma tu czego szukać. Nie czyta zamówień z marketplace'ów, tylko faktury ze Stripe'a.

Rozliczasz płatności przez Stripe

Stripe wystawia i finalizuje faktury, ale o polskim KSeF nie wie nic: nie zna schematu FA(3), nie zna numeru KSeF, nie odbierze UPO. Potrzebujesz pośrednika, który nasłuchuje zdarzenia invoice.finalized, buduje z faktury XML w FA(3), uwierzytelnia się w KSeF, szyfruje dokument i odbiera numer.

Dokładnie to robi KSeF Kit i na tym się kończy. To nie jest program do fakturowania: nie wystawisz w nim faktury ręcznie, nie wprowadzisz sprzedaży gotówkowej, nie wpiszesz kosztów. Bez konta Stripe nie ma z niego żadnego pożytku. Jeśli szukasz programu do faktur, wróć do pierwszej drogi.

Cała mechanika, razem z miejscami, w których ta droga najczęściej pęka, jest w integracji Stripe z KSeF. Co trzeba zebrać po stronie Stripe'a, żeby faktura w ogóle przeszła walidację, opisujemy w danych klienta. Jeśli wystawiasz do 6 faktur miesięcznie, zmieścisz się w planie darmowym.

Piszesz własne oprogramowanie

KSeF ma publiczne, darmowe REST-owe API w wersji 2, a kontrakt produkcyjny jest zamrożony od 22 grudnia 2025 r., więc integracja napisana raz nie rozjeżdża się co miesiąc. Zakres pracy jest jednak większy, niż się wydaje: uwierzytelnienie, sesja z własnym kluczem AES, budowa i walidacja FA(3), obsługa odrzuceń, korekty, przechowywanie UPO. Rozkładamy to na czynniki w API KSeF dla programistów.

Nie musisz zaczynać od zera. Publikujemy gem ksef na licencji Apache-2.0: czysty Ruby, bez Rails i bez Stripe'a, sam protokół. Uwierzytelnianie tokenem i podpisem XAdES, szyfrowanie RSA-OAEP i AES-256-CBC, sesje online i wsadowe, budowanie oraz walidacja FA(3) po schemacie XSD, parsowanie UPO, sprawdzanie sumy kontrolnej NIP-u i przeliczanie kwot po kursie NBP. Możesz go wziąć niezależnie od tego, czy korzystasz z naszej aplikacji. Jeśli wolisz uruchomić całość u siebie, opisujemy to w samodzielnym hostingu.

Wystawiasz kilka faktur miesięcznie ręcznie

Aplikacja Podatnika KSeF to darmowa aplikacja Ministerstwa Finansów. Działa w przeglądarce, bez instalacji i bez umowy. Wystawisz w niej fakturę, odbierzesz te, które przyszły do Ciebie, pobierzesz UPO i wygenerujesz token dla innych programów. Przy kilku fakturach miesięcznie to wystarczy. Adresy: ap.ksef.mf.gov.pl dla produkcji, ap-test.ksef.mf.gov.pl dla środowiska testowego. Co dokładnie w niej zrobisz, a kiedy przestaje mieć sens, opisujemy w Aplikacji Podatnika.

Ręczne przepisywanie działa do momentu, w którym faktur robi się kilkadziesiąt miesięcznie albo zaczynają powstawać w tle, bez Twojego udziału. Wtedy przepisywanie staje się osobną pracą, którą ktoś musi wykonywać codziennie.

Co jest wspólne dla każdej drogi

Niezależnie od tego, który wiersz tabeli jest Twój, cztery rzeczy wyglądają tak samo, bo narzuca je sam system.

Dalej dochodzą rzeczy zależne od tego, co sprzedajesz: kod QR na dokumencie przekazywanym poza systemem, korekta KOR zamiast anulowania, faktura eksportowa przy klientach zagranicznych i kurs NBP przy fakturach w walucie obcej. Kogo i od kiedy obowiązek dotyczy, sprawdzisz w KSeF obowiązkowy 2026, a jeśli prowadzisz jednoosobową działalność, zacznij od KSeF dla JDG.

Zapier i Make: dlaczego tej integracji nie ma

W katalogu Zapiera nie ma aplikacji KSeF. W Make również jej nie ma. To nie jest luka, którą ktoś za chwilę zapełni.

Powód jest techniczny. Żeby wysłać jedną fakturę, trzeba pobrać challenge z API, podpisać go kluczem z certyfikatu .p12 podpisem XAdES albo zaszyfrować token algorytmem RSA-OAEP, wygenerować na tę jedną sesję klucz AES-256, opakować go kluczem publicznym Ministerstwa Finansów, zaszyfrować XML w AES-256-CBC i zadeklarować naraz cztery skróty oraz rozmiary. Węzeł HTTP w narzędziu no-code nie robi żadnej z tych rzeczy, bo nie ma dostępu do materiału kryptograficznego ani miejsca, w którym mógłby go trzymać.

Dostawcy programów do faktur też się do tego nie palą. Fakturownia ma zgłoszenie „integracja przez Zapier” otwarte od listopada 2016 r., ze 109 głosami, i w lutym 2025 r. odpowiedziała, że natywnej integracji z Zapierem ani z Make nie zrobi, powołując się na bezpieczeństwo i ograniczenia po stronie samego Zapiera. Najbliżej no-code jest inFakt, który ma aplikację w Zapierze, tyle że to on wystawia fakturę, a KSeF-em zajmuje się już po swojej stronie. No-code potrafi więc dowieźć dane do programu do faktur, ale nie do KSeF.

Jeśli masz Stripe'a i szukałeś właśnie „Zapiera do KSeF”, tym brakującym elementem jest most ze Stripe'a do KSeF, czyli dokładnie ta część, której no-code zrobić nie może.

Najczęstsze pytania

Jak zintegrować się z KSeF?

To zależy od tego, czym dziś wystawiasz faktury. Jeśli używasz polskiego programu do faktur, KSeF jest w nim wbudowany i wystarczy go włączyć w ustawieniach. Jeśli sprzedajesz przez polską platformę e-commerce, ma ona własny moduł. Jeśli rozliczasz płatności przez Stripe, potrzebujesz mostu do KSeF. Jeśli piszesz własne oprogramowanie, integrujesz się bezpośrednio z API. Wybierz jedną z tych dróg, nie kilka naraz.

Czy muszę się integrować, skoro mam już program do faktur?

Prawdopodobnie nie. Fakturownia, inFakt, wFirma, iFirma, Comarch i Symfonia mają KSeF w środku, bo ich klientów obowiązek objął w lutym i kwietniu 2026 r. Wchodzisz w ustawienia, wklejasz token albo wgrywasz certyfikat i tyle. Nie kupuj drugiego narzędzia do czegoś, co Twój program już potrafi.

Ile kosztuje integracja z KSeF?

Sam KSeF jest darmowy: API, środowisko testowe, tokeny, certyfikaty i Aplikacja Podatnika nic nie kosztują. Płacisz wyłącznie za oprogramowanie po swojej stronie. W usługach chmurowych KSeF jest zwykle w cenie planu, w systemach ERP bywa dodatkowo płatny, a własna integracja kosztuje czas programisty, nie opłatę dla Ministerstwa Finansów.

Czy jest integracja KSeF przez Zapier albo Make?

Nie. W katalogu Zapiera nie ma aplikacji KSeF, w Make też jej nie ma i nie chodzi o brak chętnych. KSeF wymaga uwierzytelnienia tokenem albo certyfikatem (podpis XAdES) i klucza AES szyfrowanego kluczem publicznym Ministerstwa Finansów na każdą sesję. Węzeł HTTP w narzędziu no-code nie robi żadnej z tych rzeczy. Najbliżej jest inFakt, którego aplikacja w Zapierze wystawia fakturę, a KSeF-em zajmuje się już sam inFakt.

Od czego zacząć: od TEST czy od PROD?

Od TEST, zawsze. Środowisko testowe KSeF działa na fikcyjnych tożsamościach, więc bierzesz wymyślony NIP, generujesz token i wysyłasz, co chcesz, bez skutków prawnych. Na PROD przechodzisz dopiero wtedy, gdy zobaczysz pierwszy numer KSeF i pierwsze UPO. Adresy to ap-test.ksef.mf.gov.pl dla testu i ap.ksef.mf.gov.pl dla produkcji.

Czy KSeF Kit zastąpi mój program do faktur?

Nie i nie do tego służy. KSeF Kit bierze faktury, które wystawił Stripe, i składa je w KSeF. Nie wystawisz w nim faktury ręcznie ani nie wprowadzisz sprzedaży spoza Stripe'a. Bez konta Stripe nie ma z niego pożytku. Jeśli szukasz programu do fakturowania, szukasz czegoś innego.