KSeF a sklep internetowy: co musi umieć Twój e-commerce
Remigiusz Mielcarz, , 6 min czytania
Krajowy System e-Faktur przestaje być tematem „na kiedyś”. Dla sklepów i hurtowni, które wystawiają faktury firmom, to zmiana w tym, jak powstaje i jak wygląda dokument sprzedaży. Dobra wiadomość: e-commerce w większości nie łączy się z KSeF bezpośrednio, tylko z systemem, który już dziś wystawia faktury. Zła: jeśli ten łańcuch nie jest spięty porządnie, faktury zaczną się „gubić” dokładnie wtedy, gdy nie wolno im się gubić. Poniżej konkret: co się zmienia, czego wymaga sklep i jak się przygotować.
To materiał techniczny o integracji, nie porada podatkowa. Terminy, progi i szczegóły rozliczeń potwierdź z księgowością albo na podatki.gov.pl.
Czym jest KSeF w skrócie
KSeF to centralny system Ministerstwa Finansów, przez który przechodzą faktury ustrukturyzowane, czyli dokumenty w ustalonym formacie XML, a nie dowolny PDF. Faktura nie jest „wysyłana mailem do klienta”, tylko wystawiana w systemie państwowym, który nadaje jej numer KSeF, unikalny identyfikator potwierdzający, że dokument trafił do bazy. Nabywca odbiera fakturę z KSeF, a nie ze skrzynki sprzedawcy.
Dla sklepu najważniejsza jest jedna konsekwencja: oryginałem faktury przestaje być plik, który wysyłasz. Oryginał żyje w KSeF, a to, co widzi człowiek, to wizualizacja z kodem QR do weryfikacji.
Co się zmienia i od kiedy
Zgodnie z obecnym harmonogramem (stan na lipiec 2026) obowiązek wystawiania faktur w KSeF wchodzi etapami:
| Termin | Kogo obejmuje |
|---|---|
| 1 lutego 2026 | Najwięksi podatnicy (sprzedaż z VAT w 2024 r. powyżej 200 mln zł) |
| 1 kwietnia 2026 | Pozostali przedsiębiorcy (praktycznie cały rynek B2B) |
| 1 stycznia 2027 | Najmniejsi podatnicy (faktury do 450 zł i sprzedaż do ok. 10 tys. zł miesięcznie) |
Jest jednak druga data, o której łatwo zapomnieć: odbieranie faktur przez KSeF staje się obowiązkowe dla wszystkich już od 1 lutego 2026, niezależnie od tego, kiedy dana firma zaczyna sama wystawiać w systemie. Innymi słowy, nawet mniejsza hurtownia, która swoje faktury wystawia „później”, musi umieć odebrać z KSeF faktury od dostawców od początku.
Traktuj te daty jako kierunek, a nie jako coś do wpisania na sztywno. Harmonogram bywał już przesuwany. Konkretny termin dla Twojej firmy zweryfikuj u księgowości.
Numer KSeF zamiast PDF-a
Najczęstsze pytanie od sprzedawców brzmi: „to klient nie dostanie już faktury PDF?”. Dostanie coś, co wygląda jak faktura, ale zmienia się jej status. Oryginałem jest ustrukturyzowany dokument w KSeF, opisany numerem KSeF. Wizualizacja (wydruk albo PDF) to czytelna kopia dla człowieka, opatrzona kodem QR, po którym można fakturę odnaleźć i zweryfikować w systemie.
Dla sklepu to oznacza kilka praktycznych rzeczy:
- W panelu klienta i w mailach warto pokazywać numer KSeF przy zamówieniu, a nie tylko link do PDF-a.
- Wizualizację nadal wysyłasz kupującemu dla wygody, ale nie jest ona „dowodem”. Dowodem jest wpis w KSeF.
- W trybie offline (gdy system jest chwilowo niedostępny) na wizualizacji pojawiają się dodatkowe kody QR. Twój proces musi to znieść, zamiast blokować sprzedaż.
Integracja: sklep nie gada z KSeF, gada z systemem fakturującym
To jest sedno całej układanki i miejsce, gdzie najłatwiej o kosztowny błąd projektowy. W typowym e-commerce fakturę wystawia program księgowy albo ERP (Subiekt, Comarch, enova i podobne), ewentualnie zewnętrzna platforma fakturowa. To ten system rozmawia z KSeF. Zadaniem sklepu jest przekazać mu komplet poprawnych danych i odebrać z powrotem status oraz numer KSeF.
Przepływ, który sprawdza się we wdrożeniach, wygląda tak:
- Klient B2B składa zamówienie, a sklep zbiera pełne dane do faktury (NIP, nazwa, adres, pozycje, stawki VAT).
- Zamówienie trafia do systemu fakturującego (przez integrację ERP albo warstwę pośrednią).
- System wystawia fakturę i wysyła ją do KSeF, po czym dostaje numer KSeF.
- Numer KSeF wraca do sklepu i ląduje przy zamówieniu oraz w mailu do klienta.
Kluczowe jest, żeby dane wychodzące ze sklepu były od razu poprawne. KSeF jest bardziej rygorystyczny niż luźny PDF: błędny NIP, brakująca stawka VAT czy nietrafiona jednostka potrafią wywrócić wystawienie. Dlatego walidację NIP-u i danych firmy warto robić już w koszyku, a nie dopiero na etapie księgowości. Pisaliśmy o tym szerzej przy okazji rejestracji firm po NIP i VIES. W kontekście KSeF ten sam mechanizm zaczyna po prostu pilnować, żeby faktura w ogóle się wystawiła.
To zakres, który u nas mieści się w automatyzacji zamówień i faktur: sklep, ERP i wystawianie dokumentów działają jako jeden łańcuch, a nie trzy osobne wyspy łączone ręcznym eksportem.
Korekty i codzienna praca
Wdrożenie KSeF to nie tylko „pierwsza faktura poszła”. Codziennie zdarzają się zwroty, pomyłki i zmiany, a faktury korygujące również są dokumentami ustrukturyzowanymi, które przechodzą przez KSeF. Dla sklepu oznacza to, że proces korekty musi być zaprojektowany tak samo starannie jak wystawianie. Zwrot z e-commerce nie może zostawać „poza systemem” w Excelu obok.
Warto z góry ustalić kilka rzeczy: jak zwrot ze sklepu uruchamia korektę w systemie fakturującym, gdzie zapisuje się numer KSeF dokumentu korygującego i co widzi klient w swoim koncie. Im więcej z tego dzieje się automatycznie, tym mniej ręcznej pracy po stronie obsługi i tym mniej rozjazdów między tym, co pokazuje sklep, a tym, co jest w KSeF.
Co z fakturami konsumenckimi
Tu jest ważne rozróżnienie. Obowiązek KSeF dotyczy obrotu z firmami. Wystawianie faktur konsumenckich (B2C) w KSeF pozostaje, według obecnych zasad, dobrowolne. To nie znaczy, że sprzedaż detaliczną można pominąć w projekcie:
- Paragony fiskalne i kasa (także wirtualna) działają swoim torem, niezależnie od KSeF.
- Konsument nadal może poprosić o fakturę do paragonu, więc ten proces w sklepie musi istnieć.
- Jeśli obsługujesz oba segmenty naraz, sklep musi rozpoznać, czy kupujący to firma, czy osoba prywatna, i pokierować dokument właściwym torem. W hurtowni z mieszanym ruchem B2B/B2C to nie kosmetyka, tylko logika biznesowa.
Jak się przygotować: checklist
Zanim wejdziesz w kod, przejdź przez listę, która porządkuje projekt:
- Ustal, kto wystawia fakturę. ERP, program księgowy czy platforma fakturowa? To on integruje się z KSeF, nie sklep.
- Sprawdź, czy ten system ma gotową obsługę KSeF i w jakim trybie (bezpośrednio czy przez pośrednika). To determinuje resztę.
- Zadbaj o jakość danych w koszyku. Walidacja NIP, poprawne stawki VAT, spójne jednostki. Śmieci na wejściu to odrzucone faktury na wyjściu.
- Zaprojektuj powrót numeru KSeF do sklepu: gdzie się zapisuje, co widzi klient, co idzie w mailu.
- Rozdziel tor B2B i B2C: faktura ustrukturyzowana kontra paragon i faktura na życzenie.
- Przewidź tryb offline i błędy. Co się dzieje, gdy KSeF nie odpowiada albo odrzuca dokument? Sprzedaż nie może stawać.
- Przetestuj na środowisku testowym przed produkcją. Tak samo jak przy integracji z InPostem sandbox ratuje przed niespodziankami na żywym ruchu.
KSeF nie jest rewolucją w tym, co sprzedajesz, tylko zmianą w tym, jak powstaje dokument. Sklepy, które mają już czysto spięty łańcuch od zamówienia, przez ERP, po fakturę, przejdą przez to spokojnie. Te, w których faktury powstają „ręcznie z eksportu”, poczują różnicę najmocniej. Jeśli chcesz sprawdzić, jak taki spięty przepływ wygląda w praktyce, można poklikać go w naszym pokazowym sklepie demo.koda.plus.