KSeF 2026 w sklepie internetowym. Co naprawdę trzeba zrobić

Kto i od kiedy

Obowiązek wystawiania faktur ustrukturyzowanych wchodzi w dwóch krokach: od 1 lutego 2026 dla podatników, u których sprzedaż wraz z podatkiem przekroczyła w 2024 roku 200 mln zł, i od 1 kwietnia 2026 dla wszystkich pozostałych, łącznie z podatnikami zwolnionymi. Rok odniesienia to 2024, choć w wielu artykułach można spotkać 2025.

Jest jeszcze jeden termin, który w praktyce dotyczy każdego sklepu i najczęściej ginie w streszczeniach: odbieranie faktur przez KSeF obowiązuje wszystkich od 1 lutego 2026. Odroczenie do kwietnia dotyczy wyłącznie wystawiania. Jeśli Twój dostawca wystawił Ci fakturę w KSeF w lutym, to jest ona doręczona w dniu nadania numeru KSeF, niezależnie od tego, czy ktoś u Ciebie ją pobrał.

Do końca 2026 roku działa jeszcze próg dla najmniejszych: można zostać przy dotychczasowej formie, jeśli sprzedaż udokumentowana fakturami w danym miesiącu jest mniejsza lub równa 10 000 zł brutto, a prawo traci się począwszy od faktury, którą przekroczono tę wartość. Dla sklepu detalicznego to próg mniej groźny, niż wygląda, bo nie wlicza się do niego sprzedaży dokumentowanej paragonami ani faktur B2C.

Kary z art. 106ni ustawowo startują 1 stycznia 2027. Ministerstwo Finansów ogłosiło 16 września 2026 przedłużenie odroczenia do końca 2027 roku, ale w tym samym komunikacie napisało, że wymaga to zmiany ustawowej i że prace nad projektem dopiero się rozpoczynają. Traktuj to jako zapowiedź, nie jako stan prawny.

Które faktury ze sklepu w ogóle idą do KSeF

To jest główne rozwidlenie całej architektury i warto je przejść przed pisaniem kodu.

Faktury dla konsumentów są w KSeF dobrowolne. Ministerstwo potwierdza to wprost w FAQ: zarówno przed 1 lutego 2026, jak i po tej dacie wystawianie faktur B2C w KSeF jest dobrowolne. Obowiązkowe są faktury dla firm, więc realnym wyzwalaczem jest NIP kupującego. Tymczasem ani Shopify, ani Stripe nie zbierają NIP-u domyślnie. Zanim zaczniesz rozmawiać o API, sprawdź, czy checkout w ogóle pyta o NIP, gdzie ten NIP ląduje i co się dzieje, gdy klient poprosi o fakturę firmową po złożeniu zamówienia.

Poza tym:

• paragon z NIP do 450 zł wystawiony z kasy fiskalnej zostaje poza KSeF do 31 grudnia 2026;
• faktura uproszczona wystawiona poza kasą idzie do KSeF już od 1 lutego 2026, z rodzajem dokumentu „UPR”;
• sprzedaż zagraniczna (eksport, WDT, usługi rozliczane przez nabywcę w UE) powstaje w KSeF, ale kupującemu przekazuje się ją poza systemem, w sposób z nim uzgodniony, zawsze z kodem QR;
• OSS i IOSS są poza KSeF, tak samo jak procedury szczególne dla przewozu międzynarodowego;
• pro formy, noty obciążeniowe i dokumenty wewnętrzne nie są fakturami, więc do KSeF nie trafiają.

Osobny przypadek to firmy zagraniczne z polskim numerem VAT. Sama rejestracja obowiązku nie tworzy: liczy się to, czy podatnik ma w Polsce siedzibę albo stałe miejsce prowadzenia działalności i czy to miejsce uczestniczy w danej transakcji. Ministerstwo wydało w tej sprawie osobne objaśnienia podatkowe z 28 stycznia 2026 i konsekwentnie odsyła do indywidualnej oceny stanu faktycznego.

Jak wysyłać: paczki, nie pojedyncze żądania

Najbardziej praktyczna wskazówka leży w dokumentacji limitów API i prawie nikt jej nie cytuje. Ministerstwo opisuje tam sklep internetowy jako osobny scenariusz i zaleca wprost: pojedyncza faktura nie musi być przesyłana do KSeF natychmiast po wystawieniu, wydzielony proces może agregować faktury i cyklicznie, na przykład co 5 minut, wysyłać je w paczkach wsadowych.

To zdanie zdejmuje większość pytań o limity. Zamiast wołać API przy każdym zamówieniu, zbierasz faktury w kolejce i wysyłasz je sesją wsadową. Liczby, które warto znać przy projektowaniu:

Limit	Wartość
Rozmiar faktury bez załącznika	1 MB
Faktur w jednej sesji	10 000
Plików ZIP w jednej wysyłce wsadowej	50
Jedna paczka przed szyfrowaniem	100 MB
Wysłanie faktur w sesji interaktywnej	10 na sekundę, 30 na minutę, 180 na godzinę

Limity liczone są w oknie przesuwnym dla pary kontekst plus adres IP, a przekroczenie kończy się odpowiedzią 429 z nagłówkiem Retry-After i blokadą, która przy powtórkach się wydłuża. Środowisko testowe ma limity około dziesięciokrotnie wyższe niż produkcja, więc problem z limitami zwykle wychodzi dopiero po starcie.

Druga rzecz, którą Ministerstwo mówi wprost: API pobierania to mechanizm synchronizacji z lokalną bazą, a nie backend do zapytań użytkownika. Odpytywanie w pętli krócej niż co 15 minut albo pobieranie faktur po jednej zamiast eksportem jest wskazane jako zachowanie prowadzące do blokady.

Pułapka północy

Ten błąd trafia zwykle do nocnego przetwarzania i jest bardzo trudny do zauważenia w testach.

Faktura, której data wystawienia (pole P_1) jest wcześniejsza niż dzień przyjęcia przez KSeF, automatycznie zostaje potraktowana jako wystawiona w trybie offline24, nawet jeśli w żądaniu nie ustawiłeś trybu offline. Zmienia to skutki prawne: datą wystawienia pozostaje P_1, ale dochodzi obowiązek przesłania w terminie właściwym dla offline24.

Do tego moment odniesienia zależy od typu sesji: dla sesji wsadowej liczy się chwila otwarcia sesji, a dla interaktywnej chwila wysłania faktury. Paczka otwarta o 23:59 uratuje więc dokumenty z tego dnia, a sesja interaktywna nie. Jeśli planujesz nocny prog, zaplanuj go świadomie, a najlepiej nie w okolicy północy.

Duplikaty i ponowienia

KSeF odrzuca duplikaty i robi to na podstawie trzech pól naraz: NIP sprzedawcy, rodzaj faktury i numer faktury (P_2). Odpowiedź to kod 440, a unikalność trzymana jest przez dziesięć pełnych lat. Faktura i korekta o tym samym numerze nie kolidują, bo różnią się rodzajem dokumentu.

Ten mechanizm chroni Cię przy ponowieniach, ale tylko pod jednym warunkiem: numer faktury musi być stabilny. Typowy błąd integracji wygląda tak, że numer nadawany jest przy każdym zapisie, więc ponowienie tworzy nowy numer. KSeF przyjmuje wtedy oba dokumenty jako różne faktury, nadaje dwa numery KSeF i do obiegu wchodzą dwie faktury, a jedyne wyjście to korekta do zera.

Formalnego klucza idempotencji API nie ma. W praktyce buduje się go z trzech rzeczy: stabilnej numeracji, sumy SHA-256 liczonej z XML przed szyfrowaniem i trzymanej lokalnie przy zamówieniu, oraz odpytania stanu przed każdym ponowieniem, łącznie z listą faktur odrzuconych w sesji.

Przy okazji jedna rzecz, która uspokaja przy projektowaniu kolejki: Ministerstwo dopuszcza wprost sytuację, w której faktury trafią do KSeF w kolejności niezgodnej z numeracją, bo jedna z nich została odrzucona i poprawiona później. Nie jest to powód do odrzucenia ani do wystawiania korekty.

Zwroty i korekty

Tu jest największa zmiana organizacyjna. Noty korygujące nie istnieją od 1 lutego 2026, bo uchylono art. 106k. Kupujący nie poprawi już sam nawet literówki w nazwie: każdą pomyłkę koryguje wystawca fakturą korygującą.

Faktura korygująca musi zawierać numer KSeF faktury pierwotnej, poza przypadkami, gdy taki numer nie był nadany. Z tego bierze się konsekwencja, o której łatwo zapomnieć przy projektowaniu kolejki: korektę do faktury wystawionej offline można wystawić dopiero po nadaniu numeru KSeF fakturze pierwotnej. Kolejka wysyłki nie może więc być zwykłym FIFO, musi znać zależność korekty od dokumentu źródłowego. W sklepie, gdzie zwrot potrafi przyjść tego samego dnia co zamówienie, to realny scenariusz, a nie teoria.

Anulowanie faktury w KSeF nie istnieje. Przy błędnym NIP kupującego Ministerstwo wprost odradza korygowanie numeru NIP na inny: właściwa droga to korekta do zera i nowa faktura.

Zmieniły się też zasady ujmowania korekt in minus. Korekta wysłana do KSeF jest ujmowana w okresie przesłania i nie wymaga potwierdzenia odbioru przez kupującego. Dla korekt wystawionych poza KSeF dotychczasowy wymóg potwierdzenia zostaje.

Waluty: uważaj na nieaktualne źródła

To miejsce, w którym najłatwiej powtórzyć cudzy błąd. Nowelizacja z 2023 roku miała dodać do ustawy o VAT przepis pozwalający brać kurs z ostatniego dnia roboczego przed datą wystawienia, pod warunkiem szybkiego przesłania faktury. Ten przepis został uchylony przed wejściem w życie ustawą z 5 sierpnia 2025 roku. Innymi słowy, KSeF nie wprowadza własnej reguły kursowej, a art. 31a działa w niezmienionym kształcie.

Problem w tym, że tekst jednolity ustawy o VAT opublikowano wcześniej niż tę zmianę, więc w wielu opracowaniach uchylony przepis nadal figuruje jako przyszłe prawo. Jeśli ktoś pokazuje Ci „nową zasadę kursu w KSeF”, sprawdź datę źródła.

Praktycznie: kurs bierze się z ostatniego dnia roboczego poprzedzającego powstanie obowiązku podatkowego, a gdy faktura jest wystawiona wcześniej, z ostatniego dnia roboczego przed jej wystawieniem. Sama data przesłania do KSeF w tym przepisie nie występuje, wpływa co najwyżej pośrednio, przez to, co uznaje się za dzień wystawienia. To jest analiza przepisów, a nie cytat z objaśnień Ministerstwa, więc konkretny przypadek potwierdź z księgową lub doradcą podatkowym.

Tryby offline

Tryb	Kto uruchamia	Termin przesłania do KSeF
offline24	sam podatnik, bez podawania przyczyny	następny dzień roboczy po dacie wystawienia
niedostępność	KSeF, ogłoszenie w BIP i w oprogramowaniu	następny dzień roboczy po zakończeniu
awaria	KSeF, ogłoszenie w BIP i w oprogramowaniu	7 dni roboczych od zakończenia
awaria całkowita	minister, komunikat w mediach	obowiązek przesłania odpada

Technicznie wszystkie trzy pierwsze tryby to jedna flaga w żądaniu, różnica jest prawna i dotyczy terminów. Warto o tym wiedzieć, zanim zbuduje się skomplikowaną logikę tam, gdzie wystarczy jedno pole i poprawnie policzony termin.

Ciekawostka, która mówi coś o stabilności systemu: w komunikatach technicznych Ministerstwa za 2026 rok nie ma ani jednego ogłoszenia awarii samego KSeF. Problemy z pierwszych tygodni dotyczyły głównie logowania przez Profil Zaufany i Węzeł Krajowy.

Co dostaje kupujący

Faktura ustrukturyzowana to plik XML. PDF jest tylko wizualizacją, więc nie należy wysyłać do KSeF „gołego” minimum danych i dokładać reszty dopiero na wydruku.

Numer KSeF ma 35 znaków i składa się z NIP sprzedawcy, daty przyjęcia faktury, części losowej i sumy kontrolnej, więc jego poprawność można sprawdzić lokalnie, bez odpytywania API. Nie jest tym samym co numer faktury.

Kod QR jest obowiązkowy zawsze, gdy faktura jest używana poza KSeF: przy sprzedaży zagranicznej, przy przekazaniu faktury konsumentowi, przy wydruku. Faktura wystawiona offline nosi dwa kody, a po jej przesłaniu wraca do jednego, tym razem z numerem KSeF pod spodem. Jeśli wystawiasz fakturę B2C w KSeF dobrowolnie, przepisy pozwalają przekazać kupującemu sam kod QR wraz z danymi dostępowymi, bez wydruku i bez PDF.

Kiedy wystarczy gotowe rozwiązanie

Uczciwie: bardzo często wystarczy. Jeśli sprzedajesz głównie konsumentom, masz jeden sklep, jedną walutę i zwroty obsługiwane ręcznie, wtyczka do sklepu albo program do faktur, który sam wysyła dokumenty do KSeF, zamknie temat taniej niż jakakolwiek integracja szyta na miarę.

Własna integracja zaczyna mieć sens, gdy pojawia się przynajmniej kilka z tych rzeczy: korekty i zwroty częściowe, kilka sklepów albo kilka kont płatności rozliczanych na jeden NIP, subskrypcje w Stripe, sprzedaż B2B z NIP-em i danymi z rejestrów, własny system, do którego i tak trzeba oddać numer KSeF, albo wymóg, żeby faktura wracała do zamówienia i do księgowości bez udziału człowieka.

Checklist przed wdrożeniem

1. Czy checkout zbiera NIP i czy wiadomo, w którym polu on siedzi.
2. Czy numeracja faktur jest stabilna przy ponowieniach.
3. Czy kolejka rozumie zależność korekty od faktury pierwotnej.
4. Czy nocne przetwarzanie nie przecina północy.
5. Czy odrzucone faktury trafiają do człowieka, a nie tylko do logu.
6. Czy ktoś odbiera faktury zakupowe z KSeF, bo ten obowiązek ruszył wcześniej niż wystawianie.
7. Czy środowisko testowe i produkcyjne mają osobne poświadczenia, a testy nie zostawiają śmieci na produkcji.

Jeśli chcesz, żeby ktoś przeszedł przez tę listę razem z Tobą na konkretnym sklepie, opisz go w formularzu niżej. Odpowiem, co dokładnie trzeba zrobić i ile to kosztuje, także wtedy, gdy wniosek będzie brzmiał „wystarczy wtyczka”.