KSeF w WooCommerce: faktury ustrukturyzowane w sklepie internetowym

Od 1 lutego 2026 r. polskie firmy wystawiają faktury w Krajowym Systemie e-Faktur, czyli KSeF 2.0, w strukturze XML FA(3). Najwięksi sprzedawcy zaczęli w lutym, pozostali w kwietniu, a ci z niewielką sprzedażą na fakturach mają czas do końca 2026 r. WooCommerce nie wystawia faktur, więc w sklepie ktoś inny musi zbudować FA(3), wysłać go, odebrać numer KSeF i zapisać go przy zamówieniu. Ten tekst opisuje terminy, różnicę między klientem z NIP-em a konsumentem, wybór wystawcy faktury, certyfikat, korekty ze zwrotów, faktury zakupowe i kolejność testów przed przejściem na produkcję.

Artykuł opisuje przepisy i stronę Ministerstwa Finansów według stanu na 27 października 2026 r. Nie jest indywidualną poradą podatkową. Decyzje o tym, kto w twojej firmie wystawia faktury i w jakiej procedurze rozliczasz sprzedaż zagraniczną, uzgodnij z księgowym.

#Od kiedy KSeF jest obowiązkowy dla sklepu internetowego

Harmonogram wynika z ustawy z 16 czerwca 2023 r. (Dz.U. 2023 poz. 1598) w brzmieniu zmienionym ustawą z 5 sierpnia 2025 r. (Dz.U. 2025 poz. 1203). Ministerstwo Finansów zebrało podstawy prawne i daty na jednej stronie (ksef.podatki.gov.pl, podstawy prawne), a tekst nowelizacji z 2025 r. jest w Dzienniku Ustaw, poz. 1203.

Art. 145m ust. 1 mówi o podatnikach, u których łączna wartość sprzedaży z podatkiem jest mniejsza lub równa 10 000 zł, gdy jest “udokumentowana tymi fakturami wystawionymi w danym miesiącu”. Z brzmienia przepisu wynika, że do limitu liczysz sprzedaż z faktur wystawionych w danym miesiącu. Przed oparciem się na tym wyjątku potwierdź to z księgowym. Ust. 2 dodaje, że prawo do faktur poza KSeF tracisz “począwszy od faktury, którą przekroczono wartość”. Jeśli w jakimś miesiącu przyjdzie duże zamówienie firmowe, ta faktura i następne idą już przez KSeF. Sklep, który chce korzystać z tego wyjątku, potrzebuje więc licznika sumy faktur w bieżącym miesiącu.

Ministerstwo opisuje rok 2027 krótko: “1 stycznia 2027 r. KSeF obowiązkowy dla wszystkich” (etapy wdrożenia KSeF). Do tego dnia możesz też spokojniej dopracować integrację, bo przepisy o karach z art. 106ni wchodzą w życie właśnie 1 stycznia 2027 r. Pytania i odpowiedzi MF mówią to wprost: “Kary za błędy w KSeF zostały odroczone do 1 stycznia 2027 r.” (pytania i odpowiedzi KSeF 2.0). Odroczenie kar nie przesuwa samego obowiązku.

#Czy faktura dla konsumenta musi iść do KSeF

Nie musi. MF pisze, że “zarówno przed 1 lutego 2026 r. jak i po tej dacie wystawianie faktur B2C (na rzecz osób prywatnych - konsumentów) w KSeF jest dobrowolne” (konsumenci i osoby fizyczne).

Sklep sprzedający za granicę musi pamiętać o wyjątku. Faktury w procedurze OSS nieunijnej, IOSS i w procedurze szczególnej dla małych przedsiębiorstw z art. 113a ust. 1 są wyłączone z KSeF bez możliwości dobrowolnego wystawienia. Strona MF mówi: “W powyższych przypadkach nie jest możliwe dobrowolne wystawianie faktur dokumentujących ww. czynności w KSeF” (zakres obowiązkowego KSeF). Jeśli twój sklep wysyła paczki poza UE i rozlicza je przez IOSS, wtyczka nie może tych faktur wysyłać do KSeF tylko dlatego, że w ustawieniach włączyłeś wysyłkę wszystkiego.

Wiersz z kodem QR wynika z art. 106gb ust. 4. Faktura wystawiona w KSeF, którą przekazujesz konsumentowi poza systemem, musi mieć kod weryfikujący (kody weryfikujące QR). Dla konsumenta PDF w mailu albo na koncie klienta to zwykle jedyna forma, w jakiej zobaczy fakturę, więc kod musi być na tym pliku.

W praktyce sklepy wybierają jedną z dwóch zasad. Pierwsza: wszystko z NIP-em idzie do KSeF, konsumenci dostają fakturę poza systemem. Druga: wszystkie faktury idą do KSeF, bo wtedy jest jeden obieg, jedna numeracja i jeden stan w panelu. Obie są zgodne z przepisami. Druga upraszcza księgowość, ale każda faktura konsumencka musi mieć wtedy kod QR na PDF-ie.

#Czy WooCommerce wystawia faktury do KSeF

Nie, WooCommerce w ogóle nie wystawia faktur. Rdzeń przechowuje zamówienie, adres rozliczeniowy, pozycje, podatki i zwroty. Numer faktury, plik PDF, dokument XML i wysyłka do KSeF pochodzą z dodatkowego oprogramowania. Pierwsza decyzja przy KSeF to więc wybór miejsca, w którym faktura powstaje.

Dwa miejsca wystawiające fakturę pojawiają się, gdy sklep ma wtyczkę fakturową z dawnych czasów, a firma podłączyła ERP. Wtedy jedno zamówienie ma dwa numery faktury, a do KSeF trafia jeden z nich albo oba. Zanim cokolwiek włączysz, ustal jedno źródło faktur i wyłącz wystawianie w pozostałych.

Jeśli faktury wystawia ERP, cała logika KSeF jest po jego stronie, a sklep potrzebuje tylko kanału, którym wraca numer KSeF. Ten podział opisujemy szczegółowo w przewodniku po integracji WooCommerce z ERP, a sposób budowania takich połączeń przez REST API w przewodniku API-first.

#Jak zbierać NIP w zamówieniu WooCommerce

WooCommerce nie ma pola NIP w kasie. Bez niego nie odróżnisz zamówienia firmowego od konsumenckiego, a od tego zależy, czy faktura musi iść do KSeF. Pole dodaje wtyczka albo własny kod. Przy jego wdrażaniu sprawdź pięć rzeczy:

1. Jedno pole, jedno miejsce zapisu. NIP powinien być zapisany raz, przy zamówieniu i w profilu klienta pod tym samym kluczem. Pole dodane jako część adresu potrafi pojawić się dwa razy, w adresie rozliczeniowym i w adresie dostawy, a wtedy nikt nie porównuje obu wartości.
2. Walidacja sumy kontrolnej. Polski NIP ma 10 cyfr i cyfrę kontrolną. Pole, które przyjmuje litery albo pusty ciąg jako “brak NIP-u”, spowoduje, że firma kupi jako konsument, a faktura nie trafi do KSeF.
3. Kasa blokowa i klasyczna. Nowe sklepy używają kasy z bloków, gdzie pola rejestruje się innym API niż w klasycznym shortcode. Sprawdź oba warianty, jeśli sklep kiedykolwiek przełączał kasę.
4. NIP z innego kraju UE. Klient z Niemiec poda numer VAT z prefiksem kraju, który nie przejdzie polskiej sumy kontrolnej. Logika pola musi rozróżniać polski NIP od numeru VAT UE, a sposób fakturowania sprzedaży do firm z innych krajów ustal z księgowym przed włączeniem automatycznej wysyłki.
5. Oznaczenie zamówienia. Po zapisie zamówienia z NIP-em ustaw flagę, którą widzi integracja fakturowa i osoba obsługująca sklep. Bez niej o tym, czy faktura poszła do KSeF, dowiesz się dopiero od księgowego.

Darmowa wtyczka Polski for WooCommerce robi część tej pracy: dodaje pole NIP z walidacją sumy kontrolnej i opcjonalnym pobraniem danych z rejestru GUS REGON, oznacza zamówienia z NIP-em flagą KSeF, pokazuje kolumnę statusu KSeF na liście zamówień i daje hooki dla wtyczek fakturowych oraz własnych integracji. Wersja darmowa wystawia numerowane faktury VAT do wydruku z przeglądarki, ale nie wysyła ich do KSeF.

#Kiedy faktura w KSeF jest wystawiona i co dostaje klient

Faktura ustrukturyzowana jest wystawiona w dniu, w którym wysyłasz ją do KSeF (art. 106na ust. 1). Jeśli wyślesz ją później niż data wystawienia wpisana w polu P_1, KSeF potraktuje ją jak fakturę w trybie offline24, a datą wystawienia zostanie data z P_1 (faktura ustrukturyzowana i struktura FA). Wysyłaj więc fakturę tego samego dnia, w którym ją tworzysz.

Klient z NIP-em odbiera fakturę w KSeF. Mimo to większość sklepów wysyła też PDF w mailu albo udostępnia go na koncie klienta. PDF faktury wystawionej online i przekazywanej poza KSeF ma jeden kod QR, KOD I, z numerem KSeF pod spodem. Kod zawiera adres zasobu w API, datę wystawienia, NIP sprzedawcy i skrót faktury SHA-256 (kody weryfikujące QR).

Faktura przekazana klientowi przed wysłaniem do KSeF to faktura offline. Potrzebuje dwóch kodów, pierwszego z napisem “OFFLINE” i drugiego z napisem “CERTYFIKAT”, a drugi kod (KOD II) wymaga certyfikatu KSeF typu 2. Jeśli twoja wtyczka nie obsługuje trybu offline, ustaw sklep tak, żeby mail z PDF-em szedł dopiero po przyjęciu faktury przez KSeF. Domyślny mail WooCommerce o zrealizowanym zamówieniu wychodzi od razu po zmianie statusu i nie czeka na KSeF, więc dołączanie do niego faktury trzeba przejrzeć osobno.

#Numeracja, korekty i zwroty w WooCommerce

KSeF nie zastępuje twojej numeracji. Fakturę numerujesz sam (na przykład FV/2026/10/001), a KSeF po przyjęciu nadaje jej własny numer KSeF. Przy zamówieniu przechowujesz oba. Trzy zasady oszczędzają później godzin szukania:

• Numer faktury nadawaj w chwili wystawienia faktury. Numer zamówienia WooCommerce rośnie także przy porzuconych płatnościach, więc nie nadaje się na numer faktury.
• Po przyjęciu przez KSeF faktury nie edytujesz. Zmiana adresu klienta albo pozycji w zamówieniu po wystawieniu nie może zmienić dokumentu, który już jest w systemie.
• Numer KSeF zapisuj w metadanych zamówienia, także gdy wtyczka trzyma go we własnej tabeli. Po zmianie wtyczki albo migracji do ERP numer znajdziesz wtedy przy zamówieniu.

Zwrot w WooCommerce zapisuje się jako osobny obiekt zwrotu powiązany z zamówieniem. Z niego najprościej zbudować fakturę korygującą: korekta powstaje jako nowy dokument z danymi zwrotu i trafia do KSeF tak samo jak każda inna faktura. Od 1 lutego 2026 r. korekty wystawiasz w FA(3), także do faktur wystawionych wcześniej w strukturze FA(2) albo FA(1) (struktura logiczna FA).

Sprawdź też, co robi twoja integracja przy zwrocie częściowym. Zwrot kosztu wysyłki, zwrot jednej pozycji z trzech i zwrot kwoty bez pozycji to w WooCommerce trzy różne sytuacje, a każda powinna dać korektę z innymi danymi.

#Jak uzyskać certyfikat KSeF dla sklepu

Integracja przez API KSeF 2.0 uwierzytelnia się certyfikatem KSeF, a każde żądanie uwierzytelnienia podpisuje się w formacie XAdES-BES. Ministerstwo opisuje dwa typy certyfikatów (certyfikaty KSeF):

Certyfikat jest ważny najwyżej 2 lata. Wpisz datę wygaśnięcia do kalendarza z zapasem kilku tygodni, bo wygasły certyfikat zatrzyma wysyłkę wszystkich faktur naraz. Certyfikatem nie zalogujesz się do Aplikacji Podatnika, służy wyłącznie integracjom.

Miejsce, w którym go uzyskasz, zmieniło się w trakcie wdrożenia. Według MF od listopada 2025 r. do końca stycznia 2026 r. certyfikaty generował Moduł Certyfikatów i Uprawnień (MCU), a od lutego 2026 r. wniosek o certyfikat i jego pobranie są w API KSeF 2.0 i w Aplikacji Podatnika KSeF 2.0. Jeśli dokumentacja wtyczki albo ekran ustawień wspomina jeszcze o MCU, chodzi o ten sam certyfikat. Pobierasz go dziś w Aplikacji Podatnika.

Tokeny KSeF to druga metoda uwierzytelnienia. MF zapowiedziało, że wbrew pierwotnym planom zostaną utrzymane bezterminowo, a rozporządzenie w sprawie korzystania z KSeF ma zostać znowelizowane. Zanim wybierzesz integrację opartą na tokenie, sprawdź, czy ta nowelizacja już się ukazała.

Klucz prywatny certyfikatu traktuj jak hasło do konta bankowego firmy. Nie wysyłaj go mailem do agencji, nie wklejaj w zgłoszenie do supportu i nie trzymaj w repozytorium z kodem sklepu. Jeśli integrację konfiguruje ktoś z zewnątrz, niech robi to na twoim koncie administratora w sklepie, a ty wklej certyfikat sam.

#Jak wysłać fakturę z WooCommerce do KSeF wtyczką Polski PRO

Jednym ze sposobów jest wtyczka, która wystawia fakturę i wysyła ją z poziomu zamówienia. Tak działa Polski PRO od wersji 1.29.0 z 27 października 2026 r. Według opisu funkcji wydania wtyczka buduje Fakturę VAT jako dokument FA(3), sprawdza go ze schematem Ministerstwa przed wysłaniem i wysyła w sesji online uwierzytelnionej certyfikatem KSeF z podpisem XAdES. Wysyłka idzie z ramki KSeF na ekranie zamówienia albo automatycznie przy utworzeniu faktury.

Zrzut pochodzi ze środowiska testowego. Certyfikat i klucz prywatny wklejasz w formacie PEM, hasło klucza osobno. Wysyłka automatyczna jest wyłączona, więc każdą fakturę wysyłasz przyciskiem, dopóki nie sprawdzisz kilku na teście. Pod polem certyfikatu wtyczka pokazuje, dla kogo został wystawiony i do kiedy jest ważny. Zrzut pochodzi z wersji 1.29.0, w której tekst na górze ekranu odsyłał jeszcze do MCU. Od wersji 1.29.1 ekran wskazuje Aplikację Podatnika KSeF 2.0.

Po wysłaniu wtyczka sprawdza status w tle, aż KSeF przyjmie albo odrzuci fakturę. Przy zamówieniu zapisuje numer KSeF albo powód odrzucenia, pobiera UPO, czyli urzędowe poświadczenie odbioru, i pozwala je pobrać z ekranu zamówienia.

Lista zamówień dostaje kolumnę KSeF ze statusem faktury każdego zamówienia. Faktury wysłane do środowiska testowego mają znacznik TEST, więc na sklepie, który przechodzi z testów na produkcję, od razu widać, które dokumenty nie mają skutków prawnych.

Korekty powstają ze zwrotu WooCommerce na ekranie zamówienia i idą do KSeF jak każda inna faktura. PDF faktury przyjętej przez KSeF ma kod QR KOD I z numerem KSeF pod spodem. Wtyczka nie obsługuje uwierzytelnienia tokenem ani trybu offline z KOD II, więc PDF dla klienta wysyłaj dopiero po przyjęciu faktury. Przy aktualizacji z wcześniejszej wersji token KSeF 1.0 jest usuwany, bo KSeF 2.0 go nie używa, a w sklepie ustawionym na produkcję z automatyczną wysyłką i bez certyfikatu automatyczna wysyłka zostaje wyłączona. Włączasz ją z powrotem ręcznie, gdy pierwsza faktura przejdzie przez KSeF.

#Środowisko testowe KSeF: jak sprawdzić sklep przed produkcją

Ministerstwo uruchomiło otwarte testy API KSeF 2.0 30 września 2025 r., a środowisko testowe działa także po starcie produkcji 1 lutego 2026 r. Obok testowego jest środowisko przedprodukcyjne (Demo) (etapy wdrożenia, struktura FA). MF zastrzega, że “w środowisku testowym API oraz testowej wersji Aplikacji Podatnika nie należy używać rzeczywistych danych firmy” (pytania i odpowiedzi). Testuj na kopii sklepu z danymi przykładowymi. Produkcyjna baza klientów nie powinna trafić na środowisko testowe.

Kolejność testu na kopii sklepu (staging):

1. Zamówienie z NIP-em. Złóż zamówienie z poprawnym NIP-em przykładowej firmy. Sprawdź, czy zamówienie dostało flagę firmową i czy faktura ma NIP w danych nabywcy.
2. Zamówienie konsumenckie. Złóż zamówienie bez NIP-u. Sprawdź, czy sklep postępuje według zasady, którą wybrałeś dla konsumentów.
3. Wysyłka ręczna. Wyślij fakturę z ekranu zamówienia. Status powinien przejść z przetwarzania na przyjętą, a przy zamówieniu powinien pojawić się numer KSeF i UPO.
4. Odrzucenie. Wymuś błąd, na przykład zmień NIP sprzedawcy w ustawieniach faktur na inny niż ten, dla którego wystawiono certyfikat. Powód odrzucenia musi być widoczny przy zamówieniu, tak żeby osoba obsługująca sklep nie musiała szukać go w logach.
5. Korekta. Zrób zwrot częściowy jednej pozycji i wystaw korektę. Sprawdź, czy korekta odwołuje się do faktury pierwotnej i jej numeru KSeF.
6. PDF i mail. Sprawdź, czy PDF ma kod QR z numerem KSeF i czy mail do klienta wychodzi dopiero po przyjęciu faktury.
7. Zamówienie IOSS lub zagraniczne. Jeśli sprzedajesz poza Polskę, złóż takie zamówienie i sprawdź, że nie trafia do KSeF.

Dopiero po przejściu wszystkich kroków zmień środowisko na produkcyjne, wklej certyfikat produkcyjny i wyślij pierwszą prawdziwą fakturę ręcznie. Wysyłkę automatyczną włącz po tym, jak ta faktura dostanie numer KSeF.

#Co zrobić, gdy KSeF nie działa albo odrzuci fakturę

MF przewiduje trzy tryby wystawiania faktur poza bieżącą wysyłką: tryb offline24 (art. 106nda), tryb offline przy niedostępności KSeF (art. 106nh) i tryb awaryjny (art. 106nf). Osobno opisuje awarię całkowitą ogłoszoną w mediach, gdy faktury wystawia się poza systemem (tryby szczególne).

Tryb offline24 może stosować każdy podatnik. Fakturę wysyłasz do KSeF niezwłocznie, najpóźniej w następnym dniu roboczym po dniu wystawienia. Jeśli przed wysłaniem MF ogłosi awarię KSeF, masz 7 dni roboczych od dnia jej zakończenia. Przy awarii całkowitej faktur do KSeF się nie dosyła (tryb offline24). Wtyczka bez trybu offline nie wystawi faktury z dwoma kodami. Podczas przerwy w KSeF zamówienia czekają wtedy w statusie oczekującym, a ty pilnujesz, żeby faktury poszły następnego dnia roboczego.

Najczęstsze sytuacje przy integracji sklepu:

#Czy sklep musi odbierać faktury zakupowe z KSeF

Tak, i ten obowiązek obejmuje także sklepy, które własne faktury mogą do końca 2026 r. wystawiać poza KSeF. MF pisze: “Otrzymywanie faktur przy użyciu KSeF będzie obowiązkowe już od 1 lutego 2026 r.” (zakres obowiązkowego KSeF). Faktury od hurtowni, firmy kurierskiej, operatora płatności czy hostingu przychodzą do twojego konta w KSeF, a PDF w mailu jest od dostawcy tylko dodatkiem.

WooCommerce nie ma tu nic do zrobienia, bo faktury zakupowe nie dotyczą zamówień klientów. Ustal za to, kto pobiera je z KSeF: biuro rachunkowe z nadanym uprawnieniem, program księgowy albo ERP. Wtyczka sklepu, która wysyła faktury sprzedażowe, zwykle zakupowych nie pobiera, więc nie zakładaj, że jedna konfiguracja załatwia obie strony.

#Co zmieni się 1 stycznia 2027 i w 2030 roku

Od 1 stycznia 2027 r. KSeF obejmuje także podatników z limitu 10 000 zł, kończy się wyjątek dla faktur z kas i paragonów z NIP-em, wchodzą w życie kary z art. 106ni, a przepisy o numerze KSeF w płatnościach (art. 108a i 108g) stosuje się do płatności od tej daty. Sklep, który płaci dostawcom z programu księgowego albo bankowości firmowej, powinien więc mieć numer KSeF zapisany przy każdej fakturze zakupowej, zanim zlecisz przelew.

Dyrektywa Rady (UE) 2025/516 z 11 marca 2025 r., czyli pakiet ViDA (EUR-Lex), pozwala państwom członkowskim wprowadzać krajowe e-faktury bez osobnej zgody UE, a od 1 lipca 2030 r. ustala zasadę, że faktury wystawia się jako faktury elektroniczne zgodne z normą EN 16931. Polska ma dziś KSeF na podstawie decyzji wykonawczej Rady (UE) 2022/1003. Kolejne części dyrektywy stosuje się od 1 stycznia 2027 r., 1 lipca 2028 r., 1 lipca 2029 r. i 1 lipca 2030 r., więc integracja z KSeF zbudowana dziś będzie wymagała zmian, gdy Polska dostosuje przepisy do ViDA.

#Lista kontrolna KSeF dla sklepu WooCommerce

Jeśli sklep ma nietypowy obieg, na przykład faktury z ERP, sprzedaż hurtową z cenami dla grup klientów albo kilka firm w jednym WooCommerce, zacznij od rozpisania, gdzie dziś powstaje każda faktura i gdzie ma wracać numer KSeF. Z takim opisem możesz przyjść na stronę programista WooCommerce. Najpierw sprawdzamy kopię sklepu według testu z tego artykułu, a zakres zmian ustalamy po wyniku.

Ostatnia aktualizacja: 27 października 2026 r.