Integracja z KSeF — jak polaczyc system z Krajowym Systemem e-Faktur

Czym jest integracja z KSeF?

Integracja z KSeF to proces polaczenia Twojego systemu fakturowego — czy to programu ksiegowego, aplikacji ERP, czy wlasnego oprogramowania — z Krajowym Systemem e-Faktur prowadzonym przez Ministerstwo Finansow. Dzieki integracji mozesz automatycznie wysylac faktury ustrukturyzowane do centralnego systemu, odbierac numery referencyjne KSeF oraz pobierac faktury przypisane do Twojego numeru NIP, bez koniecznosci recznego logowania sie do portalu.

Integracja z KSeF nabiera szczegolnego znaczenia w kontekscie obowiazku KSeF od 2026 roku. Od 1 lutego 2026 roku duze przedsiebiorstwa (przychody powyzej 200 mln zl), a od 1 kwietnia 2026 roku wszyscy czynni podatnicy VAT musza wystawiac faktury wylacznie przez Krajowy System e-Faktur. Reczne wprowadzanie faktur przez portal internetowy moze byc wystarczajace dla firm wystawiajacych kilka dokumentow miesiecznie, ale dla wiekszosci przedsiebiorstw jedynym praktycznym rozwiazaniem jest integracja przez API.

Istnieja dwa podstawowe podejscia do pracy z KSeF. Pierwsze to korzystanie z portalu internetowego na stronie ksef.mf.gov.pl, gdzie mozna recznie logowac sie profilem zaufanym lub podpisem kwalifikowanym, a nastepnie przesylac pliki XML z fakturami. Drugie podejscie — i to wlasnie jest tematem tego przewodnika — to integracja przez API REST, ktora umozliwia automatyczne wysylanie i odbieranie faktur bez ingerencji czlowieka. API KSeF pozwala na pelna automatyzacje procesu fakturowania, od wygenerowania dokumentu XML po odebranie urzedowego potwierdzenia odbioru (UPO).

Metody uwierzytelniania w KSeF

Zanim zaczniesz wysylac faktury do KSeF przez API, musisz wybrac i skonfigurowac metode uwierzytelniania. System KSeF oferuje kilka sposobow potwierdzenia tozsamosci, kazdy z nich ma swoje zastosowanie i ograniczenia. Wybor wlasciwej metody zalezy od tego, czy planujesz integracje automatyczna (maszynowa), czy reczna obsluge systemu przez pracownikow.

Token autoryzacyjny

Token autoryzacyjny to zalecana metoda uwierzytelniania dla integracji API. Jest to dlugi ciag znakow generowany w portalu KSeF, ktory mozna zapisac w konfiguracji aplikacji i uzywac do automatycznego logowania bez udzialu czlowieka. Token wiaze sie z konkretnymi uprawnieniami (np. wystawianie faktur, odczytywanie faktur) i moze byc w kazdej chwili uniewazniony. Aby wygenerowac token, zaloguj sie na ksef.mf.gov.pl za pomoca profilu zaufanego lub podpisu kwalifikowanego, przejdz do sekcji zarzadzania tokenami, nadaj odpowiednie uprawnienia i skopiuj wygenerowany token. Pamietaj, by przechowywac token w bezpiecznym miejscu — traktuj go jak haslo dostepu do systemu fakturowego Twojej firmy.

Podpis kwalifikowany

Podpis kwalifikowany (e-podpis) to metoda uwierzytelniania oparta na certyfikacie wydanym przez akredytowanego dostawce uslug zaufania. Mozna go uzywac zarowno do logowania w portalu KSeF, jak i do podpisywania faktur przesylanych przez API. Podpis kwalifikowany zapewnia najwyzszy poziom bezpieczenstwa i jest wymagany w niektorych scenariuszach, np. przy pierwszej rejestracji podmiotu w KSeF. W kontekscie integracji API podpis kwalifikowany moze byc uzywany do inicjalizacji sesji, ale w praktyce czesciej stosuje sie go w polaczeniu z tokenem autoryzacyjnym — podpis sluzy do jednorazowej konfiguracji, a token do codziennej pracy.

Profil zaufany (ePUAP)

Profil zaufany to darmowa metoda uwierzytelniania dostepna dla kazdego obywatela RP. Pozwala na logowanie sie do portalu KSeF i reczne operacje, takie jak przegladanie faktur, generowanie tokenow czy nadawanie uprawnien. Profil zaufany nie jest jednak przystosowany do automatycznej integracji API — wymaga interaktywnego logowania przez przegladarke. Dlatego jest uzywany glownie na etapie konfiguracji: logujesz sie profilem zaufanym, generujesz token autoryzacyjny, a nastepnie uzywasz tokenu w swoim systemie do automatycznego komunikowania sie z API KSeF.

Pieczec elektroniczna

Pieczec elektroniczna (e-pieczec) to odpowiednik podpisu kwalifikowanego, ale przeznaczony dla organizacji, a nie osob fizycznych. Pieczec potwierdza, ze dokument zostal wystawiony przez dany podmiot (np. spolke z o.o.), bez wskazywania konkretnej osoby fizycznej. W KSeF pieczec elektroniczna moze sluzyc do uwierzytelniania sesji API oraz do podpisywania faktur. Jest szczegolnie przydatna w duzych organizacjach, gdzie faktury sa wystawiane automatycznie przez systemy informatyczne bez bezposredniego udzialu czlowieka. Wymagany jest certyfikat pieczeci elektronicznej wydany przez kwalifikowanego dostawce uslug zaufania, powiazany z numerem NIP podmiotu.

Jak wygenerowac token autoryzacyjny w portalu KSeF

Proces generowania tokenu autoryzacyjnego sklada sie z kilku krokow. Najpierw wejdz na strone ksef.mf.gov.pl i zaloguj sie za pomoca profilu zaufanego lub podpisu kwalifikowanego. Po zalogowaniu przejdz do zakladki zarzadzania uprawnieniami i tokenami. Wybierz opcje wygenerowania nowego tokenu, nadaj mu opisowa nazwe (np. „Integracja ERP — produkcja”) i okresl zakres uprawnien: wystawianie faktur, odczytywanie faktur lub oba. Po zatwierdzeniu system wyswietli token — skopiuj go natychmiast, poniewaz nie bedzie mozliwosci ponownego wyswietlenia pelnej wartosci tokenu. Przechowuj token w bezpieczny sposob, np. w menedzerze sekretow lub zaszyfrowanym pliku konfiguracyjnym.

Srodowisko testowe KSeF

Ministerstwo Finansow udostepnia pelne srodowisko testowe KSeF pod adresem ksef-test.mf.gov.pl. Srodowisko testowe jest replika systemu produkcyjnego i pozwala na przetestowanie calego procesu integracji bez ryzyka wystawienia prawdziwej faktury. Kazdy programista i kazda firma planujaca integracje z KSeF powinna zaczac od testow na tym srodowisku.

Jak zarejestrowac sie i testowac

Rejestracja w srodowisku testowym przebiega analogicznie do rejestracji na produkcji, z ta roznica, ze mozna uzyc dowolnego numeru NIP (w tym fikcyjnego). Na srodowisku testowym nie obowiazuja ograniczenia produkcyjne — mozesz swobodnie wysylac faktury, generowac tokeny i testowac rozne scenariusze bez obaw o konsekwencje prawne. Wejdz na ksef-test.mf.gov.pl, zaloguj sie (na srodowisku testowym dostepne sa uproszczone metody logowania) i rozpocznij testowanie. Warto przetestowac pelny cykl zycia faktury: od wygenerowania XML, przez wyslanie do API, po odebranie numeru referencyjnego i pobranie UPO.

Roznice miedzy srodowiskiem testowym a produkcyjnym

Srodowisko testowe rozni sie od produkcyjnego w kilku kluczowych aspektach. Po pierwsze, dane na srodowisku testowym sa okresowo czyszczone — nie nalezy traktowac go jako trwalego magazynu faktur. Po drugie, srodowisko testowe moze byc chwilowo niedostepne z powodu aktualizacji, podczas gdy srodowisko produkcyjne ma gwarantowana dostepnosc. Po trzecie, na srodowisku testowym nie sa wymuszane wszystkie walidacje biznesowe (np. weryfikacja aktywnosci NIP na Bialej Liscie), co ulatwia testowanie, ale oznacza, ze faktura zaakceptowana na tescie moze zostac odrzucona na produkcji. Zawsze przeprowadz finalny test na srodowisku testowym z prawdziwymi danymi firmy przed przejsciem na produkcje.

Dlaczego testowanie jest kluczowe przed kwietniem 2026

Termin 1 kwietnia 2026 roku to moment, od ktorego wszyscy czynni podatnicy VAT musza wystawiac faktury przez KSeF. Jesli Twoja integracja nie bedzie dzialac poprawnie w tym dniu, nie bedziesz mogl legalnie wystawiac faktur — a to oznacza problemy z obiegiem dokumentow, opoznienia w platnosciach i potencjalne straty finansowe. Dlatego zdecydowanie zalecamy rozpoczecie testow co najmniej dwa miesiace przed planowanym wdrozeniem produkcyjnym. Testuj rozne scenariusze: faktury z roznymi stawkami VAT, faktury korygujace, faktury zaliczkowe, faktury w walutach obcych. Im wiecej przypadkow przetestujesz, tym mniejsze ryzyko problemow po uruchomieniu na produkcji.

Schemat XML FA(2) — format faktury ustrukturyzowanej

Kazda faktura przesylana do KSeF musi byc zapisana w formacie XML zgodnym ze schematem FA(2), ktory jest oficjalnym standardem Ministerstwa Finansow. Schemat FA(2) definiuje dokladna strukture dokumentu fakturowego — kazde pole, jego typ danych, wymagalnosc i dopuszczalne wartosci. Zrozumienie tego schematu jest podstawa udanej integracji z KSeF.

Wymagane pola faktury XML

Schemat FA(2) wymaga wypelnienia szeregu obowiazkowych pol. Do najwazniejszych naleza: dane sprzedawcy (NIP, nazwa, adres), dane nabywcy (NIP lub inne dane identyfikacyjne), numer faktury, data wystawienia, data sprzedazy (lub okresu rozliczeniowego), pozycje faktury (nazwa towaru lub uslugi, ilosc, cena jednostkowa, wartosc netto, stawka VAT, kwota VAT), laczna wartosc netto i brutto faktury oraz kwota naleznosci ogolem. Kazda pozycja faktury musi zawierac prawidlowa stawke VAT (23%, 8%, 5%, 0%, zw., np., oo.) oraz poprawnie obliczone kwoty.

Oprocz pol obowiazkowych schemat FA(2) przewiduje szereg pol opcjonalnych, takich jak: numer zamowienia, numer umowy, termin platnosci, forma platnosci, numer rachunku bankowego, uwagi do faktury, kod GTU (grupa towarow i uslug), oznaczenia procedur szczegolnych (np. MPP — mechanizm podzielonej platnosci) oraz dane dotyczace faktur korygujacych (numer i data faktury korygowanej, przyczyna korekty).

Gdzie znalezc oficjalna definicje schematu

Oficjalna definicja schematu XML FA(2) jest publikowana przez Ministerstwo Finansow na stronie ksef.mf.gov.pl w sekcji dokumentacji technicznej. Schemat jest dostepny w formacie XSD (XML Schema Definition), ktory mozna uzyc do automatycznej walidacji generowanych faktur przed wyslaniem ich do KSeF. Warto regularnie sprawdzac, czy nie pojawiala sie nowa wersja schematu — Ministerstwo moze wprowadzac zmiany i uzupelnienia, szczegolnie w okresie przejsciowym. Aktualna wersja schematu to FA(2), ale mozliwe sa kolejne rewizje oznaczane numerami podwersji.

Najczestsze bledy walidacji i jak je naprawic

Podczas generowania faktur XML czesto pojawiaja sie bledy walidacji, ktore uniemozliwiaja wyslanie dokumentu do KSeF. Oto najczestsze z nich: nieprawidlowy format NIP (powinien zawierac dokladnie 10 cyfr bez myslnikow i spacji), brakujace pola obowiazkowe (np. brak daty sprzedazy), niezgodnosc sum — wartosc netto pozycji nie odpowiada iloczynowi ceny i ilosci, nieprawidlowa stawka VAT (np. uzycie wartosci „23” zamiast „23%” w wymaganym formacie), bledy w strukturze XML (np. elementy w niewlasciwej kolejnosci — schemat XSD wymaga scislej kolejnosci elementow). Przed wyslaniem faktury do KSeF zawsze waliduj plik XML wzgledem schematu XSD lokalnie — to pozwoli wychwycic bledy zanim trafie na serwer.

Krok po kroku: wysylanie faktury do KSeF przez API

Ponizej przedstawiamy kompletny proces wysylania faktury do KSeF przez API REST. Kazdy krok opisany jest szczegolowo, abys mogl zaimplementowac integracje samodzielnie lub zlecic ja zespolowi programistycznemu z pelnym zrozumieniem procesu.

Krok 1: Przygotuj token autoryzacyjny

Pierwszym krokiem jest uzyskanie tokenu autoryzacyjnego, ktory pozwoli Twojemu systemowi uwierzytelnic sie w API KSeF. Jezeli jeszcze nie wygenerowales tokenu, zaloguj sie na portal ksef.mf.gov.pl (lub ksef-test.mf.gov.pl dla testow) za pomoca profilu zaufanego lub podpisu kwalifikowanego. Przejdz do sekcji tokenow, wygeneruj nowy token z uprawnieniami do wystawiania faktur i skopiuj go do bezpiecznego miejsca w konfiguracji Twojej aplikacji. Token bedzie uzywany do inicjalizacji sesji API — jest to odpowiednik logowania uzytkownika, ale wykonywany automatycznie przez oprogramowanie.

Krok 2: Wygeneruj fakture w formacie XML FA(2)

Na podstawie danych z Twojego systemu fakturowego wygeneruj dokument XML zgodny ze schematem FA(2). Upewnij sie, ze wszystkie pola obowiazkowe sa wypelnione: dane sprzedawcy i nabywcy, numer faktury, daty, pozycje z poprawnymi kwotami i stawkami VAT. Przed przejsciem do nastepnego kroku zwaliduj plik XML wzgledem oficjalnego schematu XSD — to pozwoli uniknac bledow na etapie wysylania. Wiele jezykow programowania oferuje biblioteki do walidacji XML/XSD, np. lxml w Pythonie, javax.xml.validation w Javie czy xmllint w srodowisku Linux.

Krok 3: Podpisz dokument

Faktura przesylana do KSeF musi byc podpisana. W zaleznosci od wybranej metody uwierzytelniania mozesz uzyc podpisu kwalifikowanego (e-podpis) lub tokenu autoryzacyjnego. Przy uzyciu tokenu podpis jest realizowany po stronie serwera KSeF — nie musisz recznie podpisywac pliku XML. Jezeli uzywasz podpisu kwalifikowanego lub pieczeci elektronicznej, musisz podpisac dokument XML lokalnie przed wyslaniem. W praktyce wiekszosc integracji API korzysta z tokenu autoryzacyjnego, co znacznie upraszcza proces.

Krok 4: Wyslij fakture do API KSeF

Wyslij podpisana fakture XML do endpointu API KSeF za pomoca zadania HTTP POST. Naglowki zadania musza zawierac token sesji (uzyskany podczas uwierzytelniania) oraz typ zawartosci (application/xml lub application/octet-stream, w zaleznosci od endpointu). Tresc zadania to plik XML faktury. API KSeF przetworzy dokument i w odpowiedzi zwroci potwierdzenie przyjecia wraz z identyfikatorem przetwarzania. Pamietaj o obsluzeniu bledow HTTP (kody 400, 401, 403, 500) — kazdy z nich moze wskazywac na inny problem, od blednego XML po wygasly token sesji.

Krok 5: Odbierz numer referencyjny KSeF

Po pomyslnym wyslaniu faktury system KSeF przydzieli jej unikalny numer referencyjny KSeF. Numer ten jest oficjalnym identyfikatorem faktury w Krajowym Systemie e-Faktur i musi byc przechowywany w Twoim systemie. Numer referencyjny KSeF mozna otrzymac w odpowiedzi na wyslanie faktury lub poprzez odpytanie API o status przetwarzania. Numer ma format numeryczny i jest globalnie unikalny — kazda faktura w calym systemie KSeF ma inny numer referencyjny. Zapisz go w bazie danych obok danych faktury, poniewaz bedzie potrzebny do ewentualnych korekt i weryfikacji.

Krok 6: Zweryfikuj status faktury

Po wyslaniu faktury i otrzymaniu numeru referencyjnego warto zweryfikowac jej status w systemie KSeF. API udostepnia endpoint do sprawdzania statusu przetwarzania faktury na podstawie identyfikatora zwroconego przy wyslaniu. Mozliwe statusy to: przyjeta do przetwarzania, przetworzona pomyslnie, odrzucona z powodu bledow walidacji. Jesli faktura zostala odrzucona, odpowiedz API zawiera szczegolowy opis bledu — popraw XML i wyslij fakture ponownie. Zalecamy implementacje mechanizmu automatycznego sprawdzania statusu (polling) z odpowiednimi opoznieniami miedzy zapytaniami, np. co 5-10 sekund przez pierwsze 2 minuty.

Krok 7: Pobierz UPO (Urzedowe Potwierdzenie Odbioru)

Urzedowe Potwierdzenie Odbioru (UPO) to elektroniczny dokument potwierdzajacy, ze faktura zostala przyjeta przez system KSeF. UPO ma moc prawna i stanowi dowod wystawienia faktury w Krajowym Systemie e-Faktur. Pobierz UPO za pomoca API KSeF, podajac numer referencyjny faktury. UPO zawiera m.in. date i czas przyjecia faktury, numer referencyjny KSeF oraz skrot (hash) dokumentu. Przechowuj UPO razem z faktura — moze byc potrzebne w przypadku kontroli skarbowej lub sporu z kontrahentem. UPO jest dostepne w formacie XML i moze byc pobierane wielokrotnie.

Odbieranie faktur z KSeF

Integracja z KSeF to nie tylko wysylanie faktur, ale takze ich odbieranie. Kazdy podatnik zarejestrowany w KSeF moze pobierac faktury, na ktorych figuruje jako nabywca (odbiorca). Jest to szczegolnie wazne dla dzialu ksiegowosci, ktory musi ksiegowac faktury zakupowe — zamiast czekac na fakture mailowa lub papierowa, mozna automatycznie pobierac dokumenty z KSeF.

Pobieranie faktur przypisanych do NIP

API KSeF udostepnia endpointy do wyszukiwania i pobierania faktur na podstawie numeru NIP. Mozesz wyszukac faktury, na ktorych Twoj NIP figuruje jako nabywca, i pobrac je w formacie XML FA(2). Kazda pobrana faktura zawiera pelne dane ustrukturyzowane — mozna je automatycznie zaimportowac do systemu ksiegowego bez recznego przepisywania. To jedna z najwiekszych zalet KSeF: eliminacja recznego wprowadzania danych z faktur zakupowych i minimalizacja bledow.

Polling a powiadomienia

Istnieja dwa podejscia do monitorowania nowych faktur w KSeF. Podejscie oparte na pollingu polega na okresowym odpytywaniu API o nowe faktury (np. co godzine lub co dzien). Jest prostsze w implementacji, ale wiaze sie z opoznieniem — faktura moze czekac w systemie, zanim zostanie pobrana. Alternatywnie KSeF planuje mechanizm powiadomien (webhookow), ktory pozwoli na natychmiastowe informowanie Twojego systemu o nowej fakturze. Na chwile obecna polling jest bardziej niezawodna metoda, poniewaz mechanizm powiadomien moze nie byc jeszcze w pelni dostepny we wszystkich srodowiskach.

Zapytania o faktury z okreslonego zakresu dat

API KSeF pozwala na filtrowanie faktur po zakresie dat. Mozesz pobrac wszystkie faktury wystawione lub otrzymane w danym przedziale czasowym, np. z ostatniego tygodnia, miesiaca lub kwartalu. Parametry zapytania obejmuja date poczatkowa i koncowa oraz typ faktury (wystawione lub otrzymane). Pamietaj, ze daty w KSeF odnosza sie do momentu przyjecia faktury przez system, a nie do daty wystawienia widniacej na dokumencie — moze wystapic roznica, jesli faktura zostala wyslana z opoznieniem. Przy pobieraniu duzej liczby faktur API stosuje paginacje — musisz iterowac po kolejnych stronach wynikow.

Najczestsze bledy integracji z KSeF

Proces integracji z KSeF moze napotkac na rozne przeszkody techniczne. Ponizej opisujemy najczestsze bledy, ich przyczyny i sposoby rozwiazania. Znajomosc tych problemow pozwoli Ci uniknac wielu godzin debugowania.

Nieprawidlowy schemat XML

Najczestszym bledem jest niezgodnosc pliku XML ze schematem FA(2). Moze to byc spowodowane brakujacymi elementami obowiazkowymi, elementami w zlej kolejnosci (schemat XSD wymaga scislej kolejnosci), nieprawidlowymi typami danych (np. tekst zamiast liczby) lub uyciem przestarzalej wersji schematu. Rozwiazanie: zawsze waliduj XML lokalnie przed wyslaniem. Uzyj oficjalnego pliku XSD do walidacji i upewnij sie, ze korzystasz z najnowszej wersji schematu.

Bledy uwierzytelniania

Bledy uwierzytelniania pojawiaja sie, gdy token autoryzacyjny jest nieprawidlowy, wygasl lub nie ma wystarczajacych uprawnien. Token moze wygasnac, jesli minal jego okres waznosci lub jesli zostal uniewazniony recznie w portalu KSeF. Rozwiazanie: sprawdz, czy token jest aktualny, czy ma uprawnienia do wystawiania (lub odczytywania) faktur i czy nie zostal przypadkiem odwolany. W razie potrzeby wygeneruj nowy token.

Niezgodnosc NIP

System KSeF weryfikuje, czy NIP sprzedawcy na fakturze zgadza sie z NIP podmiotu uwierzytelnionego w sesji API. Jesli Twoj token jest powiazany z NIP 1234567890, a na fakturze XML sprzedawca ma NIP 9876543210, faktura zostanie odrzucona. Rozwiazanie: upewnij sie, ze NIP w danych sprzedawcy na fakturze dokladnie odpowiada NIP podmiotu, dla ktorego wygenerowales token autoryzacyjny.

Brakujace pola obowiazkowe

Schemat FA(2) wymaga wypelnienia wielu pol, a pominiecie nawet jednego z nich skutkuje odrzuceniem faktury. Najczesciej brakuje: daty sprzedazy (lub okresu rozliczeniowego), kodu kraju w adresie, numeru kolejnego pozycji faktury, oznaczenia waluty lub typu dokumentu. Rozwiazanie: przed wyslaniem faktury porownaj ja z lista pol obowiazkowych ze schematu XSD. Zaimplementuj walidacje po stronie swojego systemu, ktora sprawdzi kompletnosc danych przed wygenerowaniem XML.

Wskazowki dotyczace rozwiazywania problemow

Oto kilka praktycznych wskazowek, ktore pomoga w debugowaniu integracji z KSeF: loguj pelne zadania i odpowiedzi HTTP (wlacznie z naglowkami i trescia) — to kluczowe przy diagnozowaniu problemow. Testuj najpierw na srodowisku testowym (ksef-test.mf.gov.pl) — bledy na produkcji moga miec konsekwencje prawne. Sprawdzaj dokumentacje API KSeF po kazdej aktualizacji — Ministerstwo moze zmieniac endpointy lub formaty odpowiedzi. Uzyj narzedzi takich jak Postman lub curl do recznego testowania zapytan API przed implementacja w kodzie. Dolacz do spolecznosci programistow integrujacych KSeF — na forach i grupach dyskusyjnych mozna znalezc rozwiazania wielu problemow.

Faktuj jako gotowe narzedzie do KSeF

Jesli nie chcesz budowac integracji z KSeF od zera, mozesz skorzystac z gotowego narzedzia. Faktuj to darmowy generator faktur VAT online, ktory generuje profesjonalne faktury w formacie PDF i planuje pelna integracje z Krajowym Systemem e-Faktur. Dzieki Faktuj mozesz juz dzis wystawiac faktury VAT, faktury proforma, faktury korygujace i inne rodzaje dokumentow — za darmo, bez rejestracji i bez ograniczen.

Faktuj jest tworzony z mysla o pelnej zgodnosci z wymaganiami KSeF. Nasz zespol aktywnie pracuje nad integracja z API KSeF, w tym generowaniem faktur w formacie XML FA(2), automatycznym wysylaniem do systemu i odbieraniem numerow referencyjnych. Gdy integracja bedzie gotowa, uzytkownicy Faktuj beda mogli wystawiac faktury zgodne z KSeF jednym kliknieciem — bez koniecznosci samodzielnej implementacji API.

Zacznij wystawiac faktury z Faktuj — za darmo

Nie musisz budowac integracji z KSeF samodzielnie. Faktuj to darmowy generator faktur VAT, ktory przygotowuje sie na pelna integracje z Krajowym Systemem e-Faktur. Wystawiaj profesjonalne faktury juz dzis — bez rejestracji, bez oplat.

Wystaw fakture za darmo →

Najczesciej zadawane pytania

Czy integracja z KSeF jest obowiazkowa?

Tak, od 1 kwietnia 2026 roku wszyscy czynni podatnicy VAT musza wystawiac faktury przez Krajowy System e-Faktur. Integracja przez API nie jest jedyna opcja — mozna rowniez korzystac z portalu internetowego KSeF — ale dla firm wystawiajacych wiecej niz kilka faktur miesiecznie integracja API jest jedynym praktycznym rozwiazaniem. Wiecej o obowiazku KSeF przeczytasz na stronie KSeF obowiazek 2026.

Ile kosztuje integracja z KSeF?

Sam dostep do API KSeF jest bezplatny — Ministerstwo Finansow nie pobiera oplat za korzystanie z systemu. Koszty integracji wynikaja z pracy programistycznej: dostosowania istniejacego systemu fakturowego lub wdrozenia nowego oprogramowania. Dla malych firm koszty moga byc minimalne, jesli korzystaja z gotowych narzedzi (takich jak Faktuj), ktore obsluguja KSeF. Dla duzych przedsiebiorstw z rozbudowanymi systemami ERP koszt integracji moze wyniesc od kilku do kilkudziesieciu tysiecy zlotych, w zaleznosci od zlozonosci systemu.

Czy moge testowac KSeF przed wdrozeniem?

Tak, Ministerstwo Finansow udostepnia pelne srodowisko testowe pod adresem ksef-test.mf.gov.pl. Na srodowisku testowym mozesz swobodnie wysylac faktury, testowac uwierzytelnianie i sprawdzac walidacje XML bez ryzyka wystawienia prawdziwej faktury. Testowanie jest bezplatne i nie wymaga zadnych dodatkowych formalnosci. Zdecydowanie zalecamy przetestowanie calego procesu integracji na srodowisku testowym przed uruchomieniem na produkcji.

Jak dlugo trwa integracja z KSeF?

Czas integracji zalezy od zlozonosci Twojego systemu fakturowego i doswiadczenia zespolu programistycznego. Prosta integracja (wysylanie faktur z istniejacego systemu) moze zajac od 2 do 4 tygodni. Pelna integracja obejmujaca wysylanie, odbieranie, obsluge faktur korygujacych i automatyczne sprawdzanie statusow to 4 do 8 tygodni. Warto zarezerwowac dodatkowy czas na testy i ewentualne poprawki. Jesli korzystasz z gotowego oprogramowania z wbudowana obsluga KSeF (jak planuje Faktuj), integracja sprowadza sie do aktualizacji oprogramowania i konfiguracji tokenu autoryzacyjnego.

Czy faktuj.pl obsluguje KSeF?

Faktuj aktywnie przygotowuje sie na integracje z KSeF. Nasz zespol pracuje nad generowaniem faktur w formacie XML FA(2) oraz automatycznym przesylaniem dokumentow do Krajowego Systemu e-Faktur. Juz teraz mozesz wystawiac profesjonalne faktury VAT w Faktuj za darmo — a gdy integracja z KSeF bedzie gotowa, bedziesz mogl korzystac z niej bez dodatkowych oplat. Sledz nasz blog, aby byc na biezaco z postepami prac.

Integracja z KSeF — jak polaczyc system z KSeF