fluxlab

KSeF

Integracja z KSeF

Krajowy System e-Faktur jest obowiązkowy, ale nikt nie każe przeklejać do niego faktur ręcznie z osobnej aplikacji. Spinamy z nim system, którego już używacie, żeby faktura wychodziła tam, gdzie powstaje, a numer KSeF i UPO zapisywały się przy dokumencie.

Sprawdź, co Was obowiązujeDwa kliknięcia, bez wpisywania czegokolwiek

Darmowe narzędzie: Co z KSeF obowiązuje Was już dziś

Co z KSeF obowiązuje Was już dziś, a co jeszcze nie

Terminy weszły etapami i większość z nich już minęła, ale do końca 2026 roku działa kilka wyjątków naraz. Naciśnijcie swój przypadek, a rozpiszemy, co obowiązuje, jaki wyjątek jeszcze Was chroni i ile dni mu zostało. Nic nie trzeba wpisywać.

Terminy i limity pochodzą z serwisu Ministerstwa Finansów: terminy wystawiania faktur oraz zasady limitu 10 tys. zł. To sprawdzenie techniczne, nie porada podatkowa, a przypadki nietypowe rozstrzyga treść ustawy i Wasz księgowy.

Lista na 1 stycznia 2027: co musicie mieć domknięte

Tego dnia kończą się naraz wszystkie przepisy przejściowe KSeF. Same kary mają zostać przesunięte na 2028 rok, ale obowiązki z tej listy zaczynają obowiązywać w styczniu 2027 niezależnie od nich. Sześć pytań, przy każdym zaznaczcie, czy macie to załatwione. Na końcu dostaniecie listę tego, co zostało, gotową do wysłania księgowej albo osobie od systemu.

  1. 1. Czy wszystkie faktury dla firm wystawiacie już w KSeF?

    Co się zmienia: 1 stycznia 2027 znika limit 10 tys. zł brutto miesięcznie na faktury wystawiane poza KSeF. Od tego dnia każda faktura dla firmy musi przejść przez system.

    Co zrobić: Jeżeli choć część faktur powstaje w Wordzie, w Excelu albo w programie bez KSeF, przenieście je do programu z KSeF albo do darmowej Aplikacji Podatnika KSeF jeszcze w 2026, kiedy pomyłka nic nie kosztuje.

  2. 2. Czy macie ustalone, gdzie od stycznia powstanie faktura do sprzedaży z kasy?

    Co się zmienia: Faktury wystawiane przy użyciu kasy rejestrującej, w tym paragony z NIP do 450 zł uznawane za faktury uproszczone, są poza KSeF tylko do 31 grudnia 2026.

    Co zrobić: Jeżeli sprzedajecie przez kasę, a klienci proszą o fakturę, wybierzcie program, w którym ta faktura powstanie od stycznia, i przećwiczcie to na jednym dokumencie. Jeżeli nie macie kasy, ten punkt Was nie dotyczy.

  3. 3. Czy numer KSeF faktury kosztowej jest pod ręką, kiedy robicie przelew?

    Co się zmienia: Od 1 stycznia 2027 przelew za fakturę z KSeF między czynnymi podatnikami VAT ma zawierać jej 35-znakowy numer KSeF. Przy zapłacie za wiele faktur jednego kontrahenta wystarczy jeden identyfikator zbiorczy wygenerowany w KSeF. Nie dotyczy to płatności kartą, BLIK-iem ani gotówką.

    Co zrobić: Sprawdźcie, czy numer KSeF trafia z programu księgowego do pliku przelewów albo do banku. Jeżeli przelewy robi ktoś, kto widzi tylko PDF faktury, numer będzie przepisywany ręcznie przy każdej płatności.

  4. 4. Czy ktoś regularnie pobiera faktury kosztowe z KSeF?

    Co się zmienia: Faktura od dostawcy jest uznana za otrzymaną w dniu nadania jej numeru w KSeF. Dostawca nie musi już wysyłać jej mailem, więc termin płatności biegnie także wtedy, gdy nikt do systemu nie zajrzał.

    Co zrobić: Ustalcie, kto i jak często pobiera faktury zakupowe i dokąd one trafiają. Bez tego o fakturze dowiecie się dopiero z upomnienia dostawcy.

  5. 5. Czy macie certyfikat KSeF do wystawiania faktur w trybie offline?

    Co się zmienia: Gdy KSeF nie działa albo nie ma internetu, fakturę wystawia się w trybie offline i wysyła do systemu później. Taka faktura przekazana klientowi poza systemem musi mieć dwa kody QR, a drugiego nie da się wygenerować bez certyfikatu KSeF typu 2, ważnego 2 lata.

    Co zrobić: Wygenerujcie certyfikat w Aplikacji Podatnika KSeF teraz, a nie w dniu awarii. Tokeny do logowania zostają, bo Ministerstwo Finansów zrezygnowało z ich wygaszenia, więc certyfikat nie zastępuje tokenu, tylko go uzupełnia.

  6. 6. Czy widzicie, która faktura została odrzucona albo jeszcze nie wysłana?

    Co się zmienia: Kary z art. 106ni ustawy o VAT, czyli do 100% kwoty VAT z faktury wystawionej poza KSeF albo do 18,7% kwoty należności przy fakturze bez VAT, miały zacząć obowiązywać 1 stycznia 2027. Ministerstwo Finansów zapowiedziało 16 września 2026, że przesunie je na 1 stycznia 2028, i rozpoczęło prace nad ustawą. To na dziś zapowiedź, a nie uchwalone prawo, więc nie planujcie w oparciu o pewność, że kary nie przyjdą wcześniej. Sam obowiązek wystawiania faktur w KSeF nie jest zawieszony ani o jeden dzień.

    Co zrobić: Program albo integracja muszą pokazywać stan każdej faktury: przyjęta z numerem KSeF, odrzucona albo czekająca na wysłanie po trybie offline. Faktura odrzucona po cichu wygląda w systemie tak samo jak wystawiona.

Źródła: serwis Ministerstwa Finansów o trybie offline24 i limicie 10 tys. zł, ustawa o VAT w brzmieniu obowiązującym od 1 lutego 2026. To lista techniczna, nie porada podatkowa.

Napisaliśmy klienta tego API i oddaliśmy go za darmo

Kod leży publicznie pod adresem github.com/rodorn/fluxlab-ksef-integracja: klient API v2 z uwierzytelnianiem tokenem, obsługą sesji, wysyłką faktury i pobraniem UPO, budowanie XML w schemacie FA(3) z walidacją struktury i numeru NIP, oraz gotowy przykład importu faktur kosztowych do pliku CSV. Repozytorium działa w trybie demo, bez konta w KSeF, więc można je uruchomić u siebie w kilka minut i ocenić przed rozmową z kimkolwiek.

Numer KSeF i UPO to nie są szczegóły techniczne

To najczęstszy błąd w takich wdrożeniach. Integracja wysyła fakturę, dostaje odpowiedź i wygląda na gotową, tylko nigdzie nie zapisuje numeru KSeF ani urzędowego poświadczenia odbioru. Bez nich nie ma czym wykazać, że faktura została przyjęta, a od 1 stycznia 2027 numer KSeF trzeba podawać przy płatności, czyli musi być dostępny poza systemem księgowym.

Faktura odrzucona wygląda jak wystawiona

Sesja potrafi nie odpowiedzieć, a dokument zostać odrzucony na poziomie schematu. Jeżeli nie ma kolejki z ponowieniami i miejsca, w którym widać stan każdej faktury, odrzucenie przechodzi po cichu i wychodzi dopiero przy zamknięciu miesiąca. Budujemy to jako kolejkę ze stanami, a nie jako jedno wywołanie po zapisaniu dokumentu.

Druga strona, czyli faktury kosztowe

Odbiór faktur w KSeF obowiązuje wszystkich od 1 lutego 2026, więc dokumenty od dostawców już tam są, niezależnie od tego, czy ktoś je stamtąd zabiera. Pobieranie ich automatycznie i wkładanie do systemu obiegu dokumentów albo do księgowości bywa większą oszczędnością niż sama wysyłka, bo tę i tak wykonuje program.

Co zostaje poza systemem

Sprzedaż dla osób prywatnych, procedury OSS i IOSS oraz, do 31 grudnia 2026, faktury z kas rejestrujących. Przy sprzedaży mieszanej te strumienie trzeba rozdzielić na etapie wdrożenia, inaczej do KSeF trafi dokument, którego tam być nie powinno.

Kiedy to się nie opłaca

Przy kilku fakturach miesięcznie wystarczy darmowa Aplikacja Podatnika KSeF od Ministerstwa Finansów albo zwykły program do fakturowania z wbudowaną obsługą systemu. Integracja ma sens tam, gdzie faktury powstają w Waszym systemie sprzedażowym albo jest ich na tyle dużo, że ktoś je dziś przenosi ręcznie.

Cennik

Rozpoznanie

0 zł

Zanim cokolwiek zlecicie.

  • Sprawdzamy, czy Wasz system da się z tym spiąć i czym
  • Informacja, czy wystarczy Wam gotowy program zamiast wdrożenia
  • Gotowy klient API do uruchomienia u siebie, publicznie
Zamów
Najczęściej wybierany

Odbiór faktur kosztowych

4 900 zł

Najczęstszy zakres na start.

  • Faktury zakupowe pobierane z KSeF automatycznie
  • Trafiają do księgowości, obiegu dokumentów albo arkusza
  • Numer KSeF i UPO zapisane przy każdym dokumencie
  • Kod i dostępy zostają u Was
Zamów

Wystawianie i odbiór

9 900 zł

Z wysyłaniem faktur z Waszego systemu.

  • Wszystko z wariantu podstawowego
  • Wysyłka w schemacie FA(3), z walidacją przed wysłaniem
  • Kolejka ponowień i widok stanu każdej faktury
  • Rozdzielenie sprzedaży dla firm i dla osób prywatnych
  • Pierwszy miesiąc opieki w cenie
Zamów

Najczęstsze pytania

Od kiedy KSeF jest obowiązkowy?
Podatnicy, u których wartość sprzedaży z podatkiem przekroczyła w 2024 roku 200 mln zł, wystawiają faktury wyłącznie w KSeF od 1 lutego 2026. Od tego samego dnia KSeF 2.0 działa produkcyjnie, na API v2. Wszyscy pozostali podatnicy, czynni i zwolnieni, wystawiają faktury w KSeF od 1 kwietnia 2026. Obowiązek nie zależy od wielkości firmy ani od tego, czy fakturuje się raz w miesiącu, czy codziennie. Jeżeli suma sprzedaży z podatkiem na fakturach w danym miesiącu nie przekracza 10 tys. zł, do 31 grudnia 2026 można wystawiać je poza KSeF, papierowo albo elektronicznie. Od 1 stycznia 2027 ten wyjątek znika i obowiązek obejmuje także Was. Faktury wystawiane przy zastosowaniu kas rejestrujących, w tym paragony z NIP do 450 zł uznawane za faktury uproszczone, są poza KSeF do 31 grudnia 2026. To osobny przepis przejściowy, niezależny od limitu 10 tys. zł. Podmioty bez siedziby i bez stałego miejsca prowadzenia działalności w Polsce nie mają obowiązku wystawiania faktur w KSeF. Poza systemem są też sprzedaż w procedurach OSS i IOSS oraz faktury dla osób prywatnych. Odbierać faktury w KSeF muszą wszyscy od 1 lutego 2026. Do 31 grudnia 2026 nie ma kar za błędy, a od 1 stycznia 2027 numer KSeF trzeba podawać przy płatności.
Co się zmienia w KSeF 1 stycznia 2027?
Kończą się naraz wszystkie przepisy przejściowe. Znika limit 10 tys. zł brutto miesięcznie na faktury poza KSeF, a faktury z kas rejestrujących, w tym paragony z NIP do 450 zł, też muszą przechodzić przez system. Kary z art. 106ni ustawy o VAT, do 100% kwoty VAT z faktury wystawionej poza KSeF albo do 18,7% kwoty należności przy fakturze bez VAT, miały ruszyć tego samego dnia, ale 16 września 2026 Ministerstwo Finansów zapowiedziało przesunięcie ich na 1 stycznia 2028 i rozpoczęło prace nad ustawą. To zapowiedź, a nie uchwalone prawo. Sam obowiązek wystawiania faktur w KSeF nie jest zawieszony ani o jeden dzień, więc terminy z tej listy zostają. Przelew za fakturę z KSeF między czynnymi podatnikami VAT ma zawierać jej numer KSeF albo identyfikator zbiorczy. Tokeny do logowania zostają, Ministerstwo Finansów zrezygnowało z ich wygaszenia, ale do faktur w trybie offline potrzebny jest certyfikat KSeF typu 2.
Mamy program księgowy, który obsługuje KSeF. Po co nam integracja?
Najprawdopodobniej po nic i tak powiemy, jeśli tak wyjdzie z rozpoznania. Integracja przydaje się wtedy, gdy faktury powstają poza programem księgowym, na przykład w sklepie, w systemie zamówień albo w CRM, i ktoś je dziś przenosi ręcznie. Drugi przypadek to faktury kosztowe, których program księgowy często nie pobiera sam.
Czy to znaczy, że musimy zmienić program do faktur?
Nie. Sens integracji polega właśnie na tym, żeby zostawić Wam narzędzie, w którym umiecie pracować, i dołożyć pod spodem warstwę rozmawiającą z KSeF. Zmiana programu jest osobną decyzją i jeżeli i tak ją rozważacie, lepiej najpierw ją podjąć, a dopiero potem spinać cokolwiek.
Skąd mamy wiedzieć, że umiecie to zrobić?
Z kodu, pod adresem github.com/rodorn/fluxlab-ksef-integracja. Jest tam klient API v2, budowanie faktury w schemacie FA(3), testy uruchamiane automatycznie przy każdej zmianie i tryb demo, który działa bez konta w KSeF. Możecie go uruchomić sami albo dać do oceny swojemu programiście, zanim cokolwiek zlecicie. To więcej niż referencja, bo referencji nie da się sprawdzić linijka po linijce.
Gdzie trzymane są nasze dane i token do KSeF?
U Was. Integrację stawiamy na Waszym serwerze, a klient czyta konfigurację wyłącznie ze zmiennych środowiskowych, więc w kodzie nie ma żadnych sekretów. Jeżeli wolicie rozwiązanie chmurowe, powiemy wprost, co przez czyją infrastrukturę przechodzi, zanim cokolwiek uruchomimy.
Zdążymy przed 1 stycznia 2027?
Przy typowym zakresie wdrożenie zajmuje kilka tygodni, więc tak, ale grudzień 2026 będzie najgorszym możliwym momentem na zaczynanie. Wtedy naraz kończą się wszystkie przepisy przejściowe i wszyscy, którzy odkładali temat, będą szukać tego samego w tym samym tygodniu.

Napiszcie, w czym dziś wystawiacie faktury

Wystarczy nazwa programu księgowego albo systemu sprzedażowego i jedno zdanie o tym, ile faktur miesięcznie z niego wychodzi. Odpiszemy, czy integracja ma sens, czy wystarczy Wam gotowy program.

Co dostajesz po zgłoszeniu:

  • ocenę, czy automatyzacja ma sens w Twoim przypadku
  • wskazanie pierwszego procesu do uruchomienia
  • orientacyjne widełki kosztu wdrożenia
  • odpowiedź w ciągu 24h

Pełna dokumentacja techniczna i mapa AS-IS → TO-BE to zakres płatnego audytu, diagnoza daje wstępny kierunek, nie pełny projekt.

Preferowany kontakt (opcjonalnie)

Ustalenia prowadzimy mailowo. Telefon, jeśli tak Wam wygodniej.