KSeF w e-commerce i na marketplace: faktury przy tysiącach zamówień

Kiedy siadamy do KSeF ze sklepem internetowym, pierwsze pytanie brzmi zawsze tak samo: ile faktur wystawiacie miesięcznie i ile z nich idzie do firm. Druga liczba przestawia zakres prac bardziej niż cokolwiek innego, bo w e-commerce większość dokumentów sprzedażowych nie musi w ogóle trafić do systemu.

Druga sprawa to skala. Przy trzydziestu fakturach miesięcznie podłączenie do KSeF jest kwestią konfiguracji programu. Przy trzech tysiącach zamówień robi się kwestią architektury: kolejki, limitów API i tego, co dzieje się, gdy w Black Friday walidacja odrzuci dwieście dokumentów, a nikt nie zauważy tego do poniedziałku.

To nie jest porada podatkowa. Harmonogram obowiązku i progi rozpisaliśmy w tekście o KSeF i automatyzacji obiegu faktur. Tutaj piszemy o warstwie technicznej i operacyjnej sklepu.

TL;DR: Faktury konsumenckie zostają poza KSeF, więc obowiązkiem objęta jest tylko ta część sprzedaży, w której kupujący podał NIP. Przy tysiącach dokumentów wysyłaj je trybem wsadowym, nie pojedynczo: limit wysyłki w sesji interaktywnej to 180 faktur na godzinę, a w paczce mieści się do 10 000. Odrzucenia i korekty zwrotów obsłuż kolejką z alarmem.

Faktury konsumenckie zostają poza KSeF

Wystawianie w KSeF faktur na rzecz osób prywatnych jest dobrowolne, tak przed 1 lutego 2026 roku, jak i po tej dacie. Ministerstwo Finansów pisze to wprost, a mimo to informacja rzadko dociera do sklepów. Konsument dostaje fakturę na żądanie, w dotychczasowej formie: PDF-em na maila albo wydrukiem w paczce. Tak samo traktowany jest zakup, który osoba prowadząca jednoosobową działalność robi na cele prywatne.

Sklep z czterema tysiącami zamówień miesięcznie, z czego dwoma setkami na firmę, ma więc do obsłużenia dwieście dokumentów w KSeF. Rozmowa o wydajności wygląda wtedy zupełnie inaczej.

Ten sam mechanizm działa przy przejściowym wyjątku dla drobnej sprzedaży. Do limitu 10 000 zł miesięcznie wlicza się wyłącznie faktury, które obowiązkowo idą do KSeF. Sprzedaż konsumencka, sprzedaż zaewidencjonowana na kasie i paragony z NIP do 450 zł uznane za faktury uproszczone nie liczą się do niego wcale.

Czy wysyłać faktury konsumenckie do KSeF dobrowolnie? Bez konkretnego powodu nie. Wolumen wysyłki rośnie kilkunastokrotnie, każdy dokument może zostać odrzucony, a klientowi i tak trzeba dostarczyć wizualizację, tyle że teraz z kodem QR i numerem KSeF.

NIP w zamówieniu przełącza transakcję na drugi tor

Skoro obowiązek zależy od tego, kim jest kupujący, sklep musi to rozpoznać w momencie zamówienia. Wszystko wisi na jednym polu w koszyku.

Waliduj NIP w koszyku i pobieraj dane firmy z rejestrów. Format i suma kontrolna to kilka linijek kodu, a wyłapują literówki, zanim zrobią szkodę. Nazwa i adres nabywcy mają być zgodne z rejestrami publicznymi, więc stosujemy wzorzec z każdego wdrożenia fakturowego: klient podaje wyłącznie NIP, workflow dociąga resztę, do systemu trafia komplet.

Oznacz zamówienie jako firmowe i przepuść je inną ścieżką. Dokument B2B idzie do kolejki KSeF, konsumencki do zwykłego generatora PDF. Te dwie ścieżki nie powinny blokować się nawzajem.

Rozstrzygnij z góry, co robicie, gdy NIP pojawia się po fakcie. „Prosiłem o fakturę na firmę" po wystawieniu dokumentu konsumenckiego to nie poprawka, tylko osobna procedura. Przy tysiącach zamówień taki mail przychodzi codziennie.

Na marketplace'ach to samo pole wędruje przez integrator. Sprawdź, czy NIP przechodzi całą drogę do systemu fakturowego, bo zgubiony po drodze oznacza dokument konsumencki tam, gdzie wymagana była faktura w KSeF. Jak wygląda ta droga, opisaliśmy przy automatyzacji sprzedaży na Allegro i w tekście o Erli oraz Allegro w jednym panelu.

Wolumen: pojedyncza wysyłka się nie skaluje

API KSeF 2.0 ma dwa tryby wysyłki i limity, które wymuszają wybór właściwego. Wartości z dokumentacji technicznej Ministerstwa Finansów (stan na sierpień 2026, limity są korygowane w trakcie działania systemu).

Do tego dochodzą limity na kontekst: maksymalnie 10 000 faktur w jednej sesji, 1 MB na fakturę bez załącznika, 3 MB z załącznikiem. Przekroczenie kończy się odpowiedzią HTTP 429 z nagłówkiem Retry-After, a czas blokady rośnie przy powtarzających się naruszeniach.

Liczba, którą trzeba zapamiętać, to 180. Tyle faktur na godzinę przepuści sesja interaktywna, czyli tryb „wystaw i wyślij od razu", w którym domyślnie pracuje większość prostych integracji. Przy równomiernym ruchu wystarcza z zapasem. Gdy pięćset firmowych zamówień wpada w cztery godziny, kończy się blokadą w najgorszym momencie.

Rozwiązaniem jest tryb wsadowy: faktury pakujesz w jedno archiwum, szyfrujesz i wysyłasz jako paczkę. Ministerstwo wskazuje sklepy internetowe jako modelowy scenariusz tego trybu i sugeruje wprost, żeby wydzielony proces agregował wystawione dokumenty i wysyłał je cyklicznie, na przykład co pięć minut. Jedna paczka to jedna wiadomość w kolejce systemu, niezależnie od tego, czy zawiera jedną fakturę, czy tysiąc.

„W e-commerce KSeF rzadko przewraca się na przepisach. Przewraca się na tym, że ktoś podpiął sklep w trybie »wyślij od razu« i przez pół roku wszystko działało, bo firmowych zamówień było dziesięć dziennie. Pierwsza duża akcja sprzedażowa i integracja dostaje 429, a kolejka rośnie w ciszy. Tryb wsadowy nie jest optymalizacją dla dużych. To domyślne ustawienie dla każdego, kto ma sezonowość." — Mikołaj Brunka, założyciel NoCodeWork

Pułapka na koniec: limity naliczane są dla pary kontekst i adres IP, a rozbijanie ruchu na wiele adresów dokumentacja opisuje jako wzorzec traktowany jak nadużycie. Przy realnie dużej skali właściwą drogą jest wniosek o podniesienie limitów.

Odrzucenia, czyli dokument, którego nie ma

Faktura odrzucona przez walidację nie jest fakturą z błędem. Jej po prostu nie ma w obrocie, więc nie wystawia się do niej korekty ani nie anuluje: przygotowujesz poprawny plik i wysyłasz go jeszcze raz. Przy dwustu dokumentach w jednej paczce to proces, który ktoś musi zaprojektować.

Sesja wsadowa daje do tego narzędzia. Status sesji zwraca liczbę przesłanych, poprawnie i niepoprawnie przetworzonych faktur, osobny endpoint wylicza te odrzucone, a po zamknięciu sesji system generuje zbiorcze UPO. Dokumentacja zaleca przy tym rzecz, o której łatwo zapomnieć: policz skrót SHA-256 każdego pliku XML przed zaszyfrowaniem i zapisz mapowanie u siebie. Bez tego powiązanie statusu z konkretnym zamówieniem robi się zgadywanką.

Minimalny zestaw, który budujemy przy każdym większym sklepie:

• Stan przy dokumencie, nie w logu. Do wysyłki, wysłana, przyjęta z numerem KSeF, odrzucona, do poprawy. Ten stan widzi obsługa klienta obok zamówienia.
• Ponawianie z narastającym odstępem. Po 429 czekasz tyle, ile mówi Retry-After, a nie próbujesz w pętli.
• Alarm od czasu, nie od zdarzenia. Reguła brzmi „dokument bez numeru KSeF starszy niż godzina" i idzie na czat zespołu.
• Archiwum UPO. Referencje do zbiorczych UPO zapisujesz razem z sesją, bo to one potwierdzają przyjęcie dokumentów.

Kolejka, która nie krzyczy, jest gorsza od jej braku. Wygląda dokładnie jak zdrowy proces.

Faktury prowizyjne od marketplace'ów przychodzą tą samą drogą

Odbieranie faktur z KSeF objęło wszystkie firmy od 1 lutego 2026 roku, niezależnie od tego, kiedy zaczynają wystawiać. Dla sprzedawcy na marketplace to zmiana po stronie kosztów: rozliczenia od platform, kurierów i dostawców opakowań przestają przychodzić mailem. Erli wystawia faktury za prowizje przez KSeF od 1 lutego 2026. Przy pozostałych platformach sprawdź to u siebie, bo terminy i sposób udostępniania dokumentów zmieniają się w czasie.

Pobieranie rządzi się własnymi prawami. Limit zapytań o metadane to 20 na godzinę, a dokumentacja zaleca cykl synchronizacji nie krótszy niż piętnaście minut; nocą limity są wyższe. Przy dużych wolumenach zamiast ciągnąć dokumenty pojedynczo używa się asynchronicznego eksportu paczek, a wyszukiwanie i raportowanie robi się na lokalnej kopii, nie przez odpytywanie KSeF na żywo. Jak to poukładać po stronie księgowości, opisujemy przy automatycznym obiegu faktur zakupowych i w przewodniku po automatyzacji faktur i księgowości.

Korekty przy zwrotach

Żadna inna branża nie generuje tylu korekt co e-commerce: czternaście dni na odstąpienie od umowy, zwroty częściowe, wymiany rozmiarów, reklamacje. Zasady, które trzeba znać, zanim zaczniesz to automatyzować:

• Faktury z nadanym numerem KSeF nie da się edytować ani usunąć. Jedyną drogą jest korekta, w skrajnym przypadku do zera.
• Liczba korekt do jednej faktury nie jest ograniczona.
• Błędny NIP nabywcy poprawia się korektą do zera z błędnym numerem i nową fakturą z poprawnym. To wymóg systemowy, nie kwestia preferencji.
• Korekta zbiorcza musi wskazywać wszystkie faktury pierwotne: numery nadane przez podatnika, numery KSeF i daty wystawienia. Numer KSeF trzymaj więc przy zamówieniu, a nie wyłącznie w archiwum.
• Noty korygującej nabywca już nie wystawi. Wszystko robi sprzedawca.

W automatyzacji wygląda to tak: przyjęcie zwrotu generuje korektę z pozycji faktycznie zwróconych, dokument idzie tą samą kolejką co faktury, a zwrot płatności rusza przez API bramki. Człowiek wchodzi tam, gdzie potrzebna jest ocena stanu towaru, nie tam, gdzie trzeba przepisać kwoty. Cały proces posprzedażowy rozłożyliśmy na części w tekście o zwrotach i reklamacjach na autopilocie.

Te automatyzacje najczęściej wykładają się na rabatach. Jeśli sklep zapisuje zniżkę jako osobną pozycję zamiast rozbić ją na wiersze zamówienia, korekta częściowego zwrotu nie zejdzie się co do grosza i ktoś liczy ją ręcznie. Sprawdź to na trzech zamówieniach, zanim zbudujesz resztę.

Platformy i integratorzy: co sprawdzić u dostawcy

Wsparcie dla KSeF w platformach sklepowych i integratorach zmienia się z miesiąca na miesiąc, więc każda lista funkcji byłaby nieaktualna, zanim ją przeczytasz.

Zacznij od modelu. Najczęstszy i przez nas rekomendowany polega na tym, że sklep ani integrator w ogóle nie rozmawiają z KSeF: robi to system fakturowy, do którego trafiają dane zamówienia. Stronę techniczną dwóch popularnych polskich platform rozpisaliśmy przy Fakturowni i inFakcie przez API. Wariant drugi to moduł KSeF w ERP albo integratorze, trzeci to własna integracja z API KSeF 2.0, sensowna przy dużym wolumenie i nietypowym źródle faktur, o czym piszemy przy własnym panelu zamówień.

Pytania do dostawcy, niezależnie od modelu:

1. Czy wysyłka idzie trybem wsadowym, czy fakturami pojedynczo?
2. Gdzie zobaczę fakturę odrzuconą i czy dostanę o niej powiadomienie?
3. Czy numer KSeF wraca do zamówienia w sklepie i do integratora?
4. Czy obsługiwany jest tryb offline24 razem z generowaniem obu kodów QR?
5. Czy korekty zbiorcze wskazują numery KSeF faktur pierwotnych?
6. Czy mogę przetestować całość na środowisku DEMO, które ma limity replikowane z produkcji?

Sprawdź też stan dostępów. Tokeny z KSeF 1.0 nie działają w wersji 2.0, a stare uprawnienia nie przechodzą poza tymi z ZAW-FA i właścicielskimi. „Mieliśmy już integrację z KSeF" nie oznacza, że dziś cokolwiek z niej działa.

Offline24 w szczycie sprzedażowym

KSeF przewiduje trzy procedury na sytuacje, w których wysyłka nie jest możliwa: offline24 z dosyłką najpóźniej następnego dnia roboczego, tryb offline na czas ogłoszonych prac serwisowych z dosyłką dzień po zakończeniu przerwy oraz tryb awaryjny przy ogłoszonej awarii, z siedmioma dniami roboczymi na przesłanie dokumentów.

Certyfikat KSeF pobierz, zanim będzie potrzebny. Faktura wystawiona offline i przekazana nabywcy przed dosłaniem musi mieć dwa kody QR, a do wygenerowania drugiego, z napisem „CERTYFIKAT", potrzebny jest wcześniej pobrany certyfikat typu 2. Jest ważny maksymalnie dwa lata, więc wpisz odnowienie do kalendarza.

Tryb online kończy się o północy. Fakturę wystawioną w trybie online trzeba wysłać tego samego dnia; wysłana następnego zostanie potraktowana jako offline24. Nocny import zamówień z poprzedniej doby oznaczy więc całą paczkę jako wystawioną offline, z dwoma kodami QR na wydruku. Trzeba to zaplanować, a nie odkryć w reklamacji od klienta.

Sprzedaż konsumencka jest tu Twoim buforem. Skoro faktury B2C nie muszą iść do KSeF, awaria w Black Friday dotyka wyłącznie firmowego wycinka zamówień. Zaprojektuj kolejkę tak, żeby dokumenty konsumenckie nigdy nie czekały za firmowymi.

Checklist gotowości sklepu

1. Policz, ile zamówień miesięcznie ma NIP. To Twój realny wolumen KSeF.
2. Sprawdź, w ilu miejscach powstają faktury: sklep, marketplace'y, zamówienia hurtowe mailem, abonamenty.
3. Włącz walidację NIP w koszyku i pobieranie danych firmy z rejestrów.
4. Ustal, czy wysyłacie faktury konsumenckie do KSeF, i zapiszcie tę decyzję.
5. Sprawdź u dostawcy, czy wysyłka idzie trybem wsadowym.
6. Zbuduj kolejkę ze stanem przy dokumencie i alarmem od czasu.
7. Zapisuj numer KSeF przy zamówieniu, bo bez niego nie wystawisz korekty zbiorczej.
8. Przetestuj korektę zwrotu częściowego z rabatem na trzech realnych zamówieniach.
9. Pobierz certyfikat KSeF typu 2 i sprawdź, czy system generuje oba kody QR.
10. Przejdź całą ścieżkę na środowisku DEMO, łącznie z fakturą odrzuconą.

Najwięcej czasu zajmuje zwykle punkt drugi, a nie żaden z technicznych. Jeśli nie wiecie, ile miejsc w firmie wystawia faktury, zacznijcie od mapy procesu.

Na co uważać

• Numeracja to nie numer KSeF. Serię faktur nadal prowadzisz Ty i musi być ciągła, także gdy część dokumentów idzie do KSeF, a część nie.
• Nie wysyłaj klientowi faktury przed potwierdzeniem. Mail wychodzi po nadaniu numeru KSeF, nigdy zaraz po utworzeniu dokumentu w sklepie.
• Sprzedaż zagraniczna zachowuje się inaczej. Faktura idzie do KSeF, ale nabywca bez polskiego NIP jej stamtąd nie pobierze, więc dokument przekazujesz uzgodnioną drogą, z kodem QR.
• Paragony z NIP do 450 zł i faktury z kas rejestrujących mają własny kalendarz. Do końca 2026 roku zostają poza KSeF, ale od 2027 faktura do transakcji z kasy wystawiona dla podatnika musi przejść przez system. Sklep ze sprzedażą stacjonarną obok internetowej ma tu osobny wątek do przygotowania.

FAQ

Czy sklep internetowy musi wystawiać faktury dla konsumentów w KSeF?

Nie. Wystawianie faktur B2C, czyli dla osób prywatnych nieprowadzących działalności, jest w KSeF dobrowolne zarówno przed 1 lutego 2026 roku, jak i po tej dacie. Konsument dostaje fakturę na żądanie i w uzgodnionej formie, najczęściej jako PDF na maila. Sprzedawca, który wyśle ją do KSeF dobrowolnie, i tak musi przekazać dokument klientowi poza systemem, z kodem QR i numerem KSeF. Dla większości sklepów obowiązek obejmuje więc tylko sprzedaż do firm.

Skąd sklep ma wiedzieć, że kupujący jest firmą?

Z NIP-u podanego przy zamówieniu: pole „faktura na firmę" w koszyku albo odpowiednie pole w zamówieniu z marketplace'u. Warto walidować NIP już w koszyku i pobierać nazwę oraz adres firmy z rejestrów publicznych, bo dane nabywcy powinny być z nimi zgodne. Zamówienie oznaczone jako firmowe kierujesz potem inną ścieżką niż konsumenckie.

Ile faktur można wysłać do KSeF w ciągu godziny?

W sesji interaktywnej, czyli przy wysyłce dokument po dokumencie, limit wynosi 180 żądań na godzinę, 30 na minutę i 10 na sekundę. Przy większym wolumenie stosuje się tryb wsadowy: faktury pakuje się w jedno archiwum i wysyła jako paczkę, a w jednej sesji mieści się do 10 000 dokumentów. Ministerstwo Finansów wskazuje sklepy internetowe jako modelowy przypadek tego trybu. Przekroczenie limitu kończy się odpowiedzią HTTP 429 i czasową blokadą.

Jak wygląda korekta faktury przy zwrocie towaru w KSeF?

Faktury z nadanym numerem KSeF nie da się edytować ani usunąć, więc każdy zwrot oznacza fakturę korygującą, przy zwrocie pełnym do zera. Liczba korekt do jednego dokumentu nie jest ograniczona. Korekta zbiorcza musi wskazywać wszystkie faktury pierwotne razem z ich numerami KSeF i datami wystawienia, dlatego numer KSeF trzeba zapisywać przy zamówieniu. Noty korygującej nabywca już nie wystawi.

Co się dzieje, gdy KSeF przestanie działać w szczycie sprzedażowym?

Są trzy procedury: offline24 z dosyłką najpóźniej następnego dnia roboczego, tryb offline na czas ogłoszonych prac serwisowych oraz tryb awaryjny przy ogłoszonej awarii, z siedmioma dniami roboczymi na przesłanie dokumentów. Faktura przekazana nabywcy przed dosłaniem musi mieć dwa kody QR, a drugi wymaga wcześniej pobranego certyfikatu KSeF. Sklepy mają przy tym bufor, którego nie ma większość branż: faktury konsumenckie nie muszą trafiać do systemu, więc awaria dotyka wyłącznie sprzedaży do firm.

Podsumowanie

Sklepy mają w KSeF łatwiejszy start, niż same sądzą. Sprzedaż konsumencka zostaje poza systemem, więc obowiązek dotyczy zwykle kilku procent wolumenu. Zamiast projektować integrację pod cztery tysiące dokumentów, projektujesz ją pod dwieście, a to zupełnie inna rozmowa o kosztach.

Trudność siedzi w dwóch miejscach. Pierwsze to rozpoznanie, kiedy kupujący jest firmą, i przepuszczenie takiego zamówienia inną ścieżką, z kompletem danych z rejestrów. Drugie to kolejka: tryb wsadowy zamiast wysyłki pojedynczo, stan przy każdym dokumencie, ponawianie po odrzuceniu i alarm, gdy coś stoi dłużej niż powinno.

Do końca 2026 roku macie okno bez kar administracyjnych. Wykorzystajcie je na przetestowanie rzeczy, które idą źle: faktury odrzuconej, korekty zwrotu częściowego i szczytu, w którym paczka nie wychodzi przez trzy godziny.

Chcecie sprawdzić, jak KSeF wpłynie na Wasz proces zamówień i fakturowania? Umów bezpłatną konsultację — powiemy wprost, jeśli Wasz obecny system fakturowy obsługuje to wystarczająco dobrze i żadne wdrożenie nie jest potrzebne.

Przeczytaj również

• KSeF a automatyzacja obiegu faktur: co realnie zmienia się w firmie
• Faktury zakupowe prosto z KSeF: koniec zbierania PDF-ów mailem
• Fakturownia i inFakt przez API: faktury, które wystawiają się same
• Własny panel zamówień przy 5000+ zamówień miesięcznie
• Zwroty i reklamacje na autopilocie: obsługa posprzedażowa w e-commerce