KSeF i e-faktury w sklepie internetowym - jak przygotować e-commerce

Obowiązkowy KSeF to temat, który od kilku miesięcy pojawia się na każdej konferencji e-commerce i w każdej rozmowie z klientem, który prowadzi sklep internetowy. Rozumiem ten niepokój - obowiązek wystawiania faktur ustrukturyzowanych przez Krajowy System e-Faktur zmienia sposób pracy z dokumentami sprzedażowymi i wymaga dostosowania narzędzi, które używasz na co dzień. Napisałem ten artykuł, bo w ostatnich miesiącach wdrożyłem integracje KSeF w kilku sklepach WooCommerce i na Shoperze - i widzę, że większość pytań klientów dotyczy tych samych kwestii.

Jestem webdeveloperem, nie prawnikiem ani księgowym, więc szczegóły podatkowe zawsze polecam weryfikować z doradcą lub biurem rachunkowym. Natomiast to, jak spiąć sklep z systemem fakturowym, jak skonfigurować plugin i na co uważać technicznie - to właśnie tutaj.

Co to jest KSeF i co się zmieniło w 2026 roku

KSeF, czyli Krajowy System e-Faktur, to centralny rejestr faktur prowadzony przez Ministerstwo Finansów. Zamiast wysyłać klientowi PDF-a mailem lub drukować papierową fakturę, od teraz faktura B2B musi trafić najpierw do systemu MF, gdzie otrzymuje numer KSeF (unikalny identyfikator), a dopiero potem trafia do nabywcy.

Terminy wdrożenia podzielono na dwa etapy. Od 1 lutego 2026 r. obowiązek objął największe przedsiębiorstwa - firmy, których obrót w 2024 r. przekroczył 200 mln zł. Od 1 kwietnia 2026 r. system stał się obowiązkowy dla wszystkich czynnych podatników VAT. Oznacza to, że jeśli prowadzisz sklep internetowy, jesteś vatowcem i wystawiasz faktury dla firm - od drugiego kwartału 2026 r. musisz to robić przez KSeF. Dodatkowy bufor (do końca 2026 r.) przysługuje mikroprzedsiębiorcom, których miesięczna sprzedaż udokumentowana fakturami nie przekracza 10 000 zł brutto.

Format faktury zmienił się ze schematu FA(2) na FA(3). Stary format przestał obowiązywać 31 stycznia 2026 r. - jeśli Twój system fakturowy działał przed lutym, upewnij się, że dostawca zaktualizował go do nowego schematu.

Które faktury wchodzą do KSeF, a które nie

To jest jedno z najczęściej mylonych zagadnień. Nie każda faktura wystawiana przez sklep musi trafić do KSeF.

Do KSeF wchodzą obowiązkowo: faktury B2B - czyli wystawiane dla firm i przedsiębiorców (nabywca podaje NIP), gdy zarówno wystawca, jak i nabywca są polskimi podatnikami VAT. Wchodzą też faktury dla firm zagranicznych (B2B wewnątrzwspólnotowe), jeśli wystawiasz je jako polski vatowiec.

Poza KSeF pozostają: faktury B2C dla konsumentów indywidualnych (osoby fizyczne bez NIP lub z NIP prywatnym), faktury w procedurze VAT OSS (sprzedaż do konsumentów w UE z rozliczeniem w jednym okienku), faktury IOSS (import towarów do 150 EUR dla konsumentów w UE), faktury dla nabywców spoza UE, a w 2026 r. nadal faktury z kasy fiskalnej (ten wyjątek wygasa z końcem roku).

Szczególna sytuacja pojawia się, gdy klient składa zamówienie jako osoba prywatna, ale przy kasie podaje NIP firmowy. Technicznie to zamienia transakcję w B2B i powstaje obowiązek KSeF. Warto w checkout sklepu rozdzielić ścieżkę: osobna opcja "chcę fakturę na firmę" z polem NIP - to uprości rozróżnienie i zmniejszy ryzyko błędów.

Jak działa integracja sklepu z KSeF technicznie

KSeF udostępnia REST API (wersja 2.0 od 1 lutego 2026 r.) z uwierzytelnianiem opartym na tokenach JWT. Żeby sklep mógł wysyłać faktury do systemu MF, potrzebujesz tokenu autoryzacyjnego - generujesz go raz w panelu na stronie ksef.podatki.gov.pl przy użyciu profilu zaufanego lub podpisu kwalifikowanego, a następnie wpisujesz w ustawieniach systemu fakturowego lub pluginu.

Faktura musi być w formacie XML zgodnym ze schematem FA(3). Po poprawnym przyjęciu system nadaje fakturze numer KSeF - unikalny 36-znakowy identyfikator. Ten numer jest potwierdzeniem, że faktura została zarejestrowana i nabywca może ją odnaleźć w KSeF za pomocą swojego NIP. Jeśli system odrzuci fakturę (np. błędny NIP, brak wymaganego pola), dostajesz komunikat błędu i musisz poprawić dokument i wysłać ponownie.

Dla właściciela sklepu nie musisz pisać żadnego kodu - to robią za Ciebie pluginy i systemy fakturowe. Ale musisz rozumieć przepływ danych: zamówienie w sklepie -> generowanie faktury -> walidacja XML -> wysyłka do API KSeF -> odbiór numeru KSeF -> zapis numeru w zamówieniu -> wysyłka faktury do klienta.

WooCommerce i KSeF - konkretne rozwiązania

WooCommerce to platforma open-source, więc sposobów na integrację z KSeF jest kilka. W projektach, które robiłem, sprawdziły się dwa główne podejścia.

Podejście 1 - plugin bezpośredni (WP Desk)

WP Desk, twórca najpopularniejszego systemu fakturowego dla WooCommerce w Polsce, udostępnił darmowy dodatek KSeF do swojego pluginu Faktury WooCommerce. Wymagania: Faktury WooCommerce w wersji minimum 6.2.0 (darmowa) lub PRO 5.3.0. Po instalacji wchodzisz w Faktury - Raporty - KSeF, wklejasz token z portalu MF i decydujesz, czy wysyłka ma być automatyczna przy wystawieniu faktury, czy ręczna. Faktura generowana jest w WooCommerce, konwertowana do XML FA(3) i wysyłana bezpośrednio do API KSeF - bez pośrednictwa zewnętrznego systemu.

U klienta z branży odzieżowej (ok. 300 zamówień B2B miesięcznie) wdrożyłem ten setup w tydzień. Największy ból? Stare zamówienia sprzed integracji - trzeba je obsłużyć ręcznie lub zaimportować przez API historię, bo plugin wystawia faktury tylko dla nowych zamówień po aktywacji.

Podejście 2 - system fakturowy z integracją KSeF (Fakturownia, wFirma, iFirma)

Jeśli klient ma już biuro rachunkowe i system fakturowy, lepiej spiąć WooCommerce z tym systemem, a system niech obsługuje KSeF. Fakturownia, wFirma i iFirma oferują integrację z WooCommerce przez oficjalne pluginy lub przez BaseLinker jako pośrednika.

Przykładowy przepływ z BaseLinkerem: zamówienie wpada do BaseLinker, trigger zmiany statusu uruchamia akcję wystawienia faktury w Fakturowni, Fakturownia generuje XML FA(3) i wysyła do KSeF, numer KSeF zapisuje się w dokumencie, faktura PDF trafia mailem do klienta. Wszystko automatycznie.

wFirma wyróżnia się tym, że KSeF działa po wpisaniu tokenu bez dodatkowej konfiguracji per-faktura. Fakturownia ma prostszy panel i lepszą bazę wiedzy dla integratorów. iFirma oferuje gotowy konektor do Shopera - co prowadzi nas do następnego punktu.

Shoper i KSeF - co dostępne na platformie

Shoper to platforma SaaS, więc nie instalujesz pluginów jak w WooCommerce - zależysz od ekosystemu integracji dostępnych w Shoper App Store. Aktualnie integrację Shoper z KSeF oferuje przede wszystkim iFirma, która ma oficjalny konektor do tej platformy.

Przepływ danych: zamówienie w Shoper - eksport do iFirmy - generowanie faktury XML FA(3) - wysyłka do KSeF - numer KSeF w dokumencie - faktura PDF do klienta. Konfiguracja odbywa się po stronie iFirmy po wpisaniu tokenu API Shopera i tokenu KSeF.

Alternatywą jest przejście przez BaseLinker: Shoper - BaseLinker - wybrany system fakturowy (Fakturownia, wFirma). Ten setup daje więcej elastyczności i pozwala zarządzać sprzedażą z wielu kanałów (Allegro, Amazon, własny sklep) w jednym miejscu.

U klienta, który migrował ze Shopera na WooCommerce (pisałem o tym procesie w artykule o migracji Shoper na WooCommerce), jednym z argumentów za migracją była właśnie większa elastyczność w doborze pluginów fakturowych. Na WooCommerce ma teraz bezpośrednią integrację przez WP Desk bez miesięcznej opłaty za system zewnętrzny.

Faktury korygujące i anulowanie faktury w KSeF

To jeden z tych obszarów, gdzie KSeF różni się od dotychczasowego procesu i potrafi zaskoczyć. Jeśli wystawisz fakturę z błędem (zły NIP, zła kwota, błędny towar), nie ma opcji "anuluj i wystaw od nowa" - musisz wystawić fakturę korygującą w systemie KSeF.

Korekta "do zera" i ponowna faktura to standardowa procedura przy błędnym NIP nabywcy. Przy drobnych korektach kwotowych (np. zwrot części towaru) wystawiasz korektę na różnicę. Obie operacje muszą przejść przez KSeF - nie możesz wysłać klientowi papierowej korekty i pominąć systemu.

W WooCommerce oznacza to, że Twój system fakturowy musi obsługiwać faktury korygujące zintegrowane z KSeF - nie tylko faktury pierwotne. Sprawdź ten punkt przed wyborem rozwiązania, bo nie wszystkie pluginy i tanie plany subskrypcji to oferują.

Kary i ryzyko - co realnie grozi w 2026 roku

W mediach branżowych pojawiają się sprzeczne komunikaty: "2026 to rok bez kar" kontra "grożą poważne sankcje". Rzeczywistość jest pośrodku.

Kary administracyjne wynikające z ustawy o VAT (do 100% kwoty podatku) mają zostać zastosowane dopiero od 2027 r. - rok 2026 ma charakter przejściowy i edukacyjny w zakresie tych konkretnych sankcji. Natomiast przepisy Kodeksu karnego skarbowego obowiązują od momentu wejścia KSeF w życie. Brak faktury lub wadliwe jej sporządzenie to wykroczenie/przestępstwo skarbowe, za które grozi grzywna do 180 stawek dziennych, w poważniejszych przypadkach do 720 stawek dziennych.

Praktycznie: US raczej nie będzie ścigał za błąd techniczny na początku, gdy sklep ewidentnie próbuje się dostosować. Ryzyko rośnie, gdy świadomie pomijasz KSeF dla udokumentowanych faktur B2B. Na stronie Mf obowiązuje też zasada, że faktura odrzucona przez KSeF nie jest prawidłowo wystawioną fakturą - co może kwestionować prawo nabywcy do odliczenia VAT.

Sklep zwolniony z VAT - czy KSeF dotyczy też Ciebie

Jeśli Twój sklep korzysta ze zwolnienia z VAT (obrót poniżej 200 000 zł rocznie lub działalność objęta zwolnieniem przedmiotowym), obowiązek KSeF Cię nie dotyczy. Nie musisz wystawiać faktur ustrukturyzowanych ani integrować się z systemem MF.

Pamiętaj jednak, że przy przekroczeniu progu zwolnienia z VAT i rejestracji jako czynny vatowiec - od tego momentu wchodzisz w obowiązek KSeF. Jeśli planujesz wzrost sklepu lub wiesz, że zbliżasz się do progu, warto wdrożyć integrację profilaktycznie, zamiast robić to pod presją czasu.

Jeśli Twój sklep obsługuje klientów z Niemiec lub innych krajów UE, zajrzyj też do artykułu o obowiązkach prawnych sklepu i kalendarzu terminów 2026 - KSeF to jeden z kilku obowiązków, które właśnie zmieniły się równocześnie.

Jak powinno wyglądać wdrożenie krok po kroku

Na podstawie projektów, które realizowałem, wyróżniam cztery etapy sensownego wdrożenia.

Etap 1 - analiza (1-3 dni): Sprawdź, ile masz faktur B2B miesięcznie i przez jaki system je teraz wystawiasz. Oceń, czy masz integrację z biurem rachunkowym i co ono używa. Ustal, czy sprzedajesz do firm zagranicznych (obowiązek KSeF) i czy rozliczasz OSS (brak obowiązku).

Etap 2 - wybór i konfiguracja narzędzia (3-7 dni): Wybierz podejście (plugin WP Desk vs system zewnętrzny). Wygeneruj token KSeF w panelu MF. Skonfiguruj plugin lub system fakturowy na środowisku testowym lub staging sklepu.

Etap 3 - testy (5-10 dni): Środowisko sandbox KSeF (test.ksef.podatki.gov.pl) pozwala wystawiać faktury testowe bez skutków prawnych. Testuj: zamówienie B2B, zamówienie B2C z NIP, zamówienie z innym podatkiem (0%, zwolnienie), korekta, zwrot. Sprawdź, czy numer KSeF pojawia się w zamówieniu w panelu WP.

Etap 4 - wdrożenie produkcyjne i monitoring (dzień 1 + tydzień obserwacji): Włącz integrację na środowisku produkcyjnym. Przez pierwsze 2 tygodnie sprawdzaj panel KSeF codziennie - czy faktury trafiają bez odrzuceń. Zrób krótkie szkolenie dla osoby obsługującej zamówienia, jak reagować na błąd odrzucenia faktury.

Jeśli potrzebujesz wsparcia przy wdrożeniu na sklepie internetowym WooCommerce lub Shoper, mogę to zrobić razem z Tobą - zakres od konfiguracji pluginu po pełną integrację z systemem fakturowym.

Co jeszcze warto zaplanować przy okazji wdrożenia KSeF

Wdrożenie KSeF to dobry moment na audyt całego procesu fakturowania w sklepie. Kilka rzeczy, które warto sprawdzić przy okazji:

Checkout B2B - czy masz oddzielne pole NIP, czy walidacja NIP działa (suma kontrolna), czy adres firmy pobierany jest automatycznie przez API GUS? W WooCommerce można to zrobić przez dedykowane pluginy lub krótki customowy kod.

Automatyzacja emaili - klient po zakupie B2B powinien dostać potwierdzenie z informacją, że faktura trafi do KSeF i może ją pobrać przez NIP. Edycja szablonu mailowego w WooCommerce to 30 minut pracy.

Zapis numeru KSeF w zamówieniu - upewnij się, że Twój plugin zapisuje numer referencyjny KSeF w meta danych zamówienia. Bez tego nie będziesz mógł szybko odszukać faktury w razie reklamacji.

Integracja z BaseLinkerem - jeśli sprzedajesz też przez Allegro lub inne kanały, przepływ fakturowania przez BaseLinker pozwoli obsłużyć KSeF centralnie dla wszystkich kanałów, bez konfigurowania integracji osobno dla każdej platformy. Więcej o automatyzacji wielokanałowej pisałem przy okazji artykułu o migracji PrestaShop do Shopera - te same zasady centralizacji działają w obie strony.

Jeśli Twój sklep jest jeszcze na etapie planowania lub myślisz o zmianie platformy, koniecznie zajrzyj na stronę o sklepach internetowych - KSeF to jeden z czynników, który warto uwzględnić przy wyborze platformy jeszcze przed startem.

Najczęstsze pytania

Czy KSeF dotyczy każdego sklepu internetowego w Polsce?

Od 1 kwietnia 2026 r. obowiązek KSeF obejmuje wszystkich czynnych podatników VAT prowadzących działalność w Polsce - w tym właścicieli sklepów internetowych. Wyjątek stanowią mikroprzedsiębiorcy, których miesięczna sprzedaż fakturowana nie przekracza 10 000 zł brutto - ci mają dodatkowy bufor do końca 2026 r. Sklepy zwolnione z VAT (sprzedaż poniżej 200 000 zł rocznie) nie wchodzą w obowiązek KSeF.

Co z fakturami wystawianymi klientom indywidualnym (B2C)?

Faktury dla konsumentów - czyli osób fizycznych nieprowadzących działalności - nie muszą być wystawiane w KSeF. Możesz je wystawiać dobrowolnie w systemie, ale nie jest to obowiązkowe. Sytuacja komplikuje się, gdy klient poda NIP swojej firmy przy zakupie prywatnym - wtedy masz do czynienia z fakturą B2B i obowiązek KSeF obowiązuje.

Jak działają faktury dla sprzedaży zagranicznej i procedury OSS?

Sprzedaż rozliczana w procedurze VAT OSS (do konsumentów z UE) oraz IOSS (import towarów do 150 EUR) jest wyłączona z obowiązku KSeF. Faktury do tych transakcji wystawiasz poza systemem - tak jak do tej pory. Natomiast faktury dla firm zagranicznych (B2B wewnątrzwspólnotowe) wchodzą do KSeF, jeśli wystawiasz je jako polski podatnik VAT.

Jakie są kary za brak wdrożenia KSeF?

W roku 2026 zawieszone są kary administracyjne wynikające z ustawy o VAT (do 100% kwoty podatku). Jednak od dnia wejścia w życie przepisów obowiązują grzywny z Kodeksu karnego skarbowego - brak faktury lub wadliwe jej sporządzenie może skutkować karą do 180 stawek dziennych, a w poważniejszych przypadkach nawet do 720 stawek dziennych. Nie jest to więc bezpieczny rok na ignorowanie tematu.

Czy WooCommerce posiada gotowy plugin do KSeF?

Tak - WP Desk oferuje darmowy plugin KSeF jako rozszerzenie do swojego systemu Faktury WooCommerce. Działa na bazie tokenu autoryzacyjnego generowanego w panelu KSeF Ministerstwa Finansów. Alternatywą jest integracja z zewnętrznym systemem fakturowym (Fakturownia, wFirma, iFirma) przez BaseLinker lub bezpośrednie API sklepu.

Kiedy powinienem zacząć wdrożenie KSeF w sklepie?

Jeśli masz sklep WooCommerce lub na Shoperze i już wystawiasz faktury B2B, powinieneś zacząć przygotowania natychmiast - integracja trwa zwykle 2-4 tygodnie łącznie z testami. Jeśli dopiero zaczynasz, wybierz system fakturowy z wbudowaną obsługą KSeF od początku.

Co to jest schemat FA(3) i czy muszę się tym martwić jako właściciel sklepu?

FA(3) to aktualny format XML faktury ustrukturyzowanej obowiązujący od 1 lutego 2026 r. - zastąpił starszy FA(2). Jeśli korzystasz z gotowego pluginu lub systemu fakturowego, dostawca powinien zadbać o właściwy schemat. Jeśli integrujesz się samodzielnie przez API, musisz sprawdzić, czy Twój kod używa FA(3), a nie przestarzałego FA(2).

Czy sklep z kasą fiskalną musi wystawiać e-faktury przez KSeF?

Do końca 2026 r. sklep posiadający kasę fiskalną może wystawiać faktury bezpośrednio z kasy (lub paragon fiskalny z NIP do 450 zł zamiast faktury B2B). To przejściowe ułatwienie, które wygasa z końcem roku - od 2027 r. trzeba będzie wystawiać faktury ustrukturyzowane przez KSeF niezależnie od posiadania kasy.