KSeF a WooCommerce: jak sklep internetowy wystawia e-faktury
Od 2026 roku faktury dla firm wystawia się w Krajowym Systemie e-Faktur. Część mniejszych sprzedawców korzysta jeszcze z ulg przejściowych, ale te kończą się 31 grudnia 2026 r. Od 1 stycznia 2027 r. każda faktura dla firmy, także ta ze sklepu internetowego, musi przejść przez KSeF.
Wyjaśniamy, jak działa KSeF w WooCommerce: które zamówienia trafiają do systemu, jak połączyć z nim sklep, co sprawdzić i jak bezpiecznie to przetestować. Stan prawny na 3 listopada 2026 r.
Czym jest KSeF i od kiedy dotyczy Twojego sklepu
KSeF to platforma Ministerstwa Finansów do wystawiania, przesyłania, otrzymywania i przechowywania faktur. Faktura w KSeF to nie PDF, tylko plik XML w ustalonej strukturze (obecnie FA(3)). Po przyjęciu przez system dostaje numer KSeF, który jednoznacznie ją identyfikuje.
Terminy wyglądają tak:
- 1 lutego 2026 r.: obowiązek wystawiania faktur w KSeF dla firm, których sprzedaż w 2024 r. przekroczyła 200 mln zł (z VAT). Od tego dnia wszystkie firmy odbierają też faktury przez KSeF.
- 1 kwietnia 2026 r.: obowiązek dla pozostałych podatników.
- Do 31 grudnia 2026 r.: ulgi przejściowe. Faktury poza KSeF (papierowe lub elektroniczne) można wystawiać, jeśli ich łączna wartość z VAT w danym miesiącu nie przekracza 10 000 zł. Kto przekroczy limit, wystawia w KSeF już tę fakturę, którą go przekroczył, i wszystkie kolejne. Do końca roku działają też faktury z kas rejestrujących i paragony z NIP do 450 zł uznawane za faktury uproszczone.
- 1 stycznia 2027 r.: koniec ulg, KSeF staje się obowiązkowy dla wszystkich przedsiębiorców.
Osobna sprawa to kary. Według obowiązującej ustawy kary pieniężne za nieprawidłowości związane z KSeF, np. za fakturę wystawioną poza systemem mimo obowiązku, mają być stosowane od 1 stycznia 2027 r. i mogą sięgnąć 100% kwoty VAT z faktury. 20 października 2026 r. rząd przyjął projekt, który przesuwa ich stosowanie na 1 stycznia 2028 r. (druk sejmowy nr 3245). Na 3 listopada 2026 r. projekt jest w Sejmie i nie został jeszcze uchwalony. Ministerstwo zaznacza, że odroczenie kar nie zwalnia z obowiązku, a organy KAS będą reagować na faktury wystawiane poza systemem.
Zamówienia B2C i B2B: co trafia do KSeF
Klient indywidualny (B2C). Faktury dla konsumentów nie są objęte obowiązkowym KSeF. Możesz je tam wystawiać dobrowolnie. Jeśli to zrobisz, konsument nie odbierze faktury w systemie tak jak firma, więc przekazujesz mu ją w uzgodniony sposób, np. jako PDF z kodem QR. KSeF dotyczy faktur, więc paragon z kasy fiskalnej do niego nie trafia. To, czy faktury konsumenckie mają iść do KSeF, warto ustalić z księgowością. O innych obowiązkach sklepu piszemy w liście wymogów prawnych dla sklepu internetowego.
Klient firmowy (B2B). Gdy klient poda w zamówieniu polski NIP, faktura musi powstać w KSeF. Firma dostaje ją automatycznie w systemie, a za datę otrzymania uznaje się dzień nadania numeru KSeF. Możesz dodatkowo wysłać klientowi PDF, ale taka wizualizacja musi mieć kod QR z numerem KSeF. Klient zagraniczny bez polskiego NIP nie ma dostępu do KSeF: fakturę wystawiasz w systemie, a przekazujesz mu ją w uzgodniony sposób, również z kodem QR.
W sklepach B2B z odroczonym terminem płatności dochodzi jeszcze jedna zmiana. Od 1 stycznia 2027 r. firma będąca czynnym podatnikiem VAT, która płaci przelewem za fakturę z KSeF, podaje w tytule przelewu jej numer KSeF. Dobrze, żeby ten numer był widoczny w e-mailu z fakturą i na koncie klienta. Więcej o takich sklepach piszemy w artykule o sklepie B2B dla producentów i hurtowni.
Trzy sposoby połączenia WooCommerce z KSeF
Sam WooCommerce nie wysyła faktur do KSeF. Potrzebny jest system, który przygotuje plik XML, wyśle go, odbierze numer KSeF i obsłuży korekty. W praktyce są trzy drogi.
1. Program do fakturowania połączony ze sklepem
To najczęstsze rozwiązanie w naszych projektach. Sklep przekazuje zamówienie do programu do faktur (np. Fakturowni, która ma połączenie z produkcyjnym KSeF i integrację z WooCommerce), a program wystawia fakturę po osiągnięciu wybranego statusu i wysyła ją do KSeF. Po jednorazowej konfiguracji KSeF w programie dzieje się to automatycznie. Sprawdza się w sklepach, które nie mają ERP albo nie wystawiają w nim faktur. Gotowe połączenia mają jednak ograniczony zakres funkcji. Zanim je włączysz, sprawdź, jak radzą sobie z Twoimi statusami, częściowymi zwrotami i zmianami zamówienia po opłaceniu.
2. Faktury z systemu ERP
Jeśli sprzedaż i magazyn prowadzisz w ERP, faktura może powstawać tam, gdzie powstają dokumenty magazynowe. Warunek: ERP musi mieć funkcję wysyłki do KSeF i API, przez które sklep przekaże zamówienie i odbierze status faktury. To dobra droga, gdy sklep jest jednym z kilku kanałów sprzedaży, a księgowość pracuje na danych z ERP. Samo połączenie sklepu z ERP opisaliśmy w poradniku integracja WooCommerce z ERP.
3. Własna integracja
Przydaje się, gdy gotowe połączenie nie pasuje do procesu: faktura ma powstać dopiero po wysyłce z kilku magazynów, klienci B2B mają indywidualne warunki, a korekty muszą wynikać z konkretnych zwrotów. Zwykle łączy sklep z ERP albo z programem do faktur, bo to one rozmawiają z KSeF. Bezpośrednie połączenie sklepu z API KSeF jest możliwe, ale wtedy po stronie sklepu trzeba obsłużyć m.in. uwierzytelnianie, tryby offline, kody QR i korekty. Dlatego tego unikamy: nie budujemy wysyłki do KSeF z WooCommerce, tylko łączymy sklep z programem do faktur albo z ERP, które mają KSeF wbudowany i same pilnują numerów, trybów awaryjnych i zmian w przepisach.
Co sprawdzić w sklepie
Pole NIP i dane firmy
Klient musi mieć jasny wybór „kupuję jako firma” i pola na NIP, nazwę firmy i adres. NIP warto sprawdzać już w formularzu (format i suma kontrolna) i zapisywać w zamówieniu jako osobne pole, a nie w uwagach. Błąd jest kosztowny: faktura z cudzym NIP trafi w KSeF do firmy, która nic nie kupiła. Takiej faktury nie da się anulować. Trzeba wystawić korektę „do zera” i nową fakturę z poprawnym NIP.
Statusy zamówień i data faktury
Ustal, który status uruchamia wystawienie faktury (np. opłacone albo zrealizowane), i upewnij się, że dzieje się to tylko raz. Zdublowane zdarzenie oznacza dwie faktury, każdą z własnym numerem KSeF, i dodatkową korektę. Zwróć też uwagę na datę: faktura w trybie online powinna trafić do KSeF tego samego dnia, którego datę nosi. Wysłana dzień później zostanie potraktowana jak faktura wystawiona w trybie offline24.
Korekty i zwroty
Po przyjęciu do KSeF faktury nie można zmienić, anulować ani usunąć. Zwrot, częściowy zwrot pieniędzy czy rabat po fakcie wymagają faktury korygującej wystawionej przez sprzedawcę. Od 1 lutego 2026 r. nie ma już not korygujących, więc klient nie poprawi błędu po swojej stronie. Dlatego zwrot w WooCommerce powinien uruchamiać korektę albo przynajmniej zadanie dla księgowości.
Spójność danych
KSeF sprawdza zgodność pliku ze strukturą, ale nie weryfikuje obliczeń. Nie odrzuci faktury z błędnie wyliczonym VAT, więc pomyłka trafi prosto do klienta. Sprawdź, czy ceny, stawki VAT, zaokrąglenia, koszt dostawy, rabaty z kuponów i waluty wyglądają tak samo w sklepie i na fakturze.
Awarie i uwierzytelnianie
Program do faktur lub ERP powinien obsługiwać tryby szczególne. W trybie offline24 fakturę dosyła się do KSeF najpóźniej następnego dnia roboczego. Przy niedostępności KSeF ogłoszonej przez MF termin to następny dzień roboczy po jej zakończeniu, a przy awarii 7 dni roboczych od jej zakończenia. Faktura offline przekazana klientowi przed wysłaniem do KSeF ma dwa kody QR, a do drugiego potrzebny jest certyfikat KSeF typu 2.
Połączenie z KSeF wymaga uwierzytelnienia. Certyfikat KSeF jest ważny najwyżej 2 lata, więc jego odnowienie warto mieć w kalendarzu. Tokeny według obecnego rozporządzenia działają do 31 grudnia 2026 r. Ministerstwo zapowiedziało, że utrzyma je bezterminowo, ale przepisy nie zostały jeszcze zmienione. Jeśli Twoje połączenie działa na tokenie, sprawdź przed końcem roku, czy nie trzeba przejść na certyfikat.
Testy: najpierw środowisko testowe, potem produkcja
Ministerstwo udostępnia dwa środowiska bez skutków prawnych: testowe (na zanonimizowanych danych) i przedprodukcyjne Demo (z prawdziwym uwierzytelnieniem firmy). Faktury wysłane tam są po pewnym czasie usuwane. Skutki prawne ma dopiero środowisko produkcyjne.
Integracje testujemy na kopii ERP albo testowym magazynie, z fakturowaniem wyłączonym lub przełączonym w tryb testowy. Powód jest prosty: faktury z numerem KSeF nie da się anulować, można ją tylko skorygować. Jedno zamówienie testowe złożone na produkcji to od razu dwie faktury w KSeF: pierwotna i korekta. Więcej o tym etapie piszemy w artykule jak projektujemy integracje z ERP.
Przetestuj co najmniej te scenariusze: zamówienie konsumenta, zamówienie firmy z NIP, błędny NIP, zwrot całości i części, anulowanie po opłaceniu, klient zagraniczny oraz brak połączenia z KSeF.
Lista kontrolna
- Wiesz, który system wystawia faktury (program do faktur, ERP czy własna integracja) i czy ma działające połączenie z produkcyjnym KSeF.
- W zamówieniu jest wyraźna opcja zakupu na firmę, sprawdzane pole NIP i komplet danych firmy.
- Fakturę uruchamia jeden ustalony status, bez duplikatów, a faktura online trafia do KSeF w dniu, którego datę nosi.
- Zwroty i zmiany zamówień uruchamiają faktury korygujące.
- PDF wysyłany klientowi ma kod QR z numerem KSeF, a numer jest widoczny w e-mailu i na koncie klienta.
- Z księgowością ustalone, czy faktury dla konsumentów idą do KSeF.
- Program obsługuje tryby offline, a termin ważności certyfikatu KSeF jest zapisany.
- Całość przetestowana na kopii sklepu i w środowisku testowym MF.
Najczęstsze pytania
Czy faktury dla klientów indywidualnych muszą trafiać do KSeF?
Nie. Są wyłączone z obowiązku, ale można je wystawiać w KSeF dobrowolnie. Wtedy klient dostaje fakturę w uzgodniony sposób, np. jako PDF z kodem QR.
Co zrobić, gdy klient poda błędny NIP?
Jeśli faktura z błędnym NIP trafiła już do KSeF, wystawiasz fakturę korygującą „do zera” na ten błędny NIP, a potem nową fakturę z poprawnymi danymi. Błędnego NIP nie poprawia się korektą na właściwy, bo fakturę i tak otrzymała w KSeF niewłaściwa firma.
Czy można usunąć fakturę wysłaną do KSeF przez pomyłkę?
Nie. Faktura z numerem KSeF weszła do obrotu prawnego i jest przechowywana w systemie przez 10 lat od końca roku wystawienia. Błąd poprawia się wyłącznie fakturą korygującą.
Czy mały sklep może jeszcze wystawiać faktury poza KSeF?
Tylko do 31 grudnia 2026 r. i tylko wtedy, gdy wartość faktur objętych obowiązkiem (z VAT) nie przekracza 10 000 zł w miesiącu. Faktury dla konsumentów nie wliczają się do tego limitu. Od 1 stycznia 2027 r. ulga przestaje działać.
Jak możemy pomóc
KSeF w sklepie internetowym to przede wszystkim kwestia danych. O tym, czy faktury będą poprawne, decyduje to, co sklep przekazuje dalej: NIP, statusy i zwroty. Łączymy WooCommerce z programami do faktur i z systemami ERP, a gdy gotowe połączenie nie wystarcza, budujemy własną integrację. Samą wysyłkę do KSeF zostawiamy programowi, który ma ją wbudowaną. Taka integracja z ERP zaczyna się u nas od 3 500 zł netto i zwykle zajmuje 2-4 tygodnie od podjęcia decyzji do uruchomienia. Bieżący monitoring integracji obejmuje nasz pakiet opieki. Zobacz, czym zajmujemy się w ramach integracji ERP, PIM i CRM, albo poproś o bezpłatną wycenę.
