KSeF w WooCommerce: wtyczki i jak wdrożyć
W skrócie: WooCommerce sam nie wysyła faktur do KSeF, więc potrzebujesz wtyczki. Są dwa typy: wtyczki, które same tworzą plik FA(3) i wysyłają go do API KSeF, oraz wtyczki łączące sklep z programem do faktur, który zajmuje się KSeF. Wybór zależy od tego, gdzie chcesz mieć numerację i archiwum faktur, kto obsługuje korekty i czym program loguje się do KSeF.
Informacje o wtyczkach i programach sprawdziliśmy 19 października 2026 r. w katalogu WordPress.org i na stronach producentów. Nie jesteśmy partnerem żadnego z nich.
KSeF w WooCommerce: dwa typy wtyczek
| Wtyczka wysyła wprost do KSeF | Wtyczka przekazuje zamówienie do programu do faktur | |
|---|---|---|
| Gdzie powstaje faktura | w WordPressie | w programie (np. Fakturownia, wFirma, iFirma) |
| Gdzie leży token lub certyfikat KSeF | w bazie Twojego WordPressa | w programie do faktur |
| Numeracja i archiwum | we wtyczce | w programie, razem z resztą faktur firmy |
| Koszt | często darmowa wersja podstawowa, automatyzacja w płatnej | abonament programu i często płatna wtyczka |
| Dla kogo | sklep, który chce mieć wszystko w jednym panelu | firma, która już wystawia faktury w programie online albo ma tam księgową |
Wtyczki łączące się bezpośrednio z KSeF
- Flexible Invoices (WP Desk) z dodatkiem „KSeF dla WooCommerce, wysyłka e-faktur”. Dodatek jest darmowy w katalogu WordPress.org (ponad 700 aktywnych instalacji) i wymaga wtyczki Flexible Invoices. Wysyła faktury do KSeF pojedynczo lub zbiorczo i pokazuje status oraz numer KSeF. Automatyczne wystawianie faktur wymaga płatnej wersji PRO. Od wersji 2.5.0 z 5 października 2026 r. działa także z certyfikatem KSeF, a nie tylko z tokenem. Opis w katalogu nadal wspomina strukturę FA(2), choć od 1 lutego 2026 r. obowiązuje FA(3), więc warto to potwierdzić u producenta.
- FakturFlow. Darmowa wtyczka (wersja 0.3.0 z 26 września 2026 r., mniej niż 10 instalacji) tworzy FA(3) z zamówienia, sprawdza plik ze schematem MF, wysyła go i pobiera UPO. Dodaje pole NIP do formularza zamówienia, wystawia korekty ze zwrotów i PDF z kodem QR. Łączy się tokenem. Automatyczną wysyłkę po opłaceniu zamówienia daje osobny dodatek Pro.
- ByteWave Faktury. Darmowa wtyczka (wersja 1.2.0 z 10 października 2026 r., mniej niż 10 instalacji) wystawia fakturę ręcznie z ekranu zamówienia, sprawdza plik, zapisuje numer KSeF i UPO. Wymaga tokenu KSeF. Automatyczne wystawianie po płatności, akcje zbiorcze i monitoring dostępności KSeF są w płatnym dodatku Pro.
- Wtyczki wielokrajowe, na przykład POP (SdI, PEPPOL, KSeF). Do wysyłki potrzebne jest konto w usłudze producenta, więc faktury przechodzą przez jego serwery.
Integracje z programami do faktur
Fakturownia, wFirma i iFirma opisują na swoich stronach wysyłkę faktur do KSeF, a Fakturownia podaje, że integracja jest bezpłatna w każdym abonamencie i może wysyłać faktury automatycznie. Ze sklepem łączy je wtyczka: WP Desk sprzedaje płatne wtyczki dla Fakturowni, inFakt, wFirmy i iFirmy, które wystawiają faktury do zamówień ręcznie albo automatycznie po zmianie statusu, a iFirma ma własną integrację z WooCommerce. Ścieżka wygląda wtedy tak: zamówienie, faktura w programie, wysyłka do KSeF przez program.
Ogólne porównanie obu dróg i kryteria wyboru opisujemy w artykule integracja sklepu z KSeF.
Pole NIP w zamówieniu WooCommerce
Standardowy formularz zamówienia WooCommerce ma pole „Nazwa firmy”, ale nie ma osobnego pola NIP. Dodają je wtyczki do faktur albo wtyczki do edycji pól zamówienia. Zwróć uwagę na trzy rzeczy:
- Pole działa w nowym, blokowym koszyku. Część starszych rozwiązań obsługuje tylko klasyczny formularz.
- NIP jest sprawdzany przed płatnością, przynajmniej sumą kontrolną. Literówka w NIP oznacza fakturę wysłaną do obcej firmy i korektę do zera.
- Klient wybiera: firma czy osoba prywatna. Faktury dla konsumentów nie muszą trafiać do KSeF (art. 106ga ust. 2 pkt 4 ustawy o VAT; FAQ MF, kategoria „Wystawianie i otrzymywanie faktur”, pyt. 5).
Więcej: NIP w koszyku sklepu.
Korekty przy zwrotach
Zwrot w WooCommerce (refund) to dopiero zapis w sklepie. Jeśli do zamówienia była faktura w KSeF, potrzebna jest faktura korygująca, też w KSeF, z numerem KSeF faktury pierwotnej (art. 106j ust. 2 pkt 2a i ust. 4). Sprawdź, czy wtyczka tworzy korektę sama ze zwrotu, czy musisz ją wystawić ręcznie, i czy uwzględnia zwrot kosztów dostawy. Proces opisujemy w artykule korekta faktury przy zwrocie towaru.
Na co uważać przy wyborze
- Token czy certyfikat. Większość wtyczek prosi o token KSeF. MF zapowiada, że tokeny zostaną po 2026 r. (FAQ MF, kategoria „Uprawnienia i autoryzacja”, pyt. 39), ale rozporządzenie (Dz.U. 2025 poz. 1815, § 13) na 19 października 2026 r. nadal mówi o 31 grudnia 2026 r., a MF konsultował ważność tokenu od 1 do 365 dni. Zapytaj, czy wtyczka obsługuje też certyfikat KSeF. Porównanie: token czy certyfikat KSeF.
- Bezpieczeństwo hostingu. Przy wtyczce bezpośredniej token, pliki XML i UPO leżą na Twoim serwerze. Kopia zapasowa, aktualizacje WordPressa i ochrona katalogu z plikami to Twoja odpowiedzialność. Jedna z wtyczek wprost zaznacza, że na serwerze Nginx trzeba samemu dodać regułę blokującą dostęp do katalogu z fakturami.
- Automatyzacja. W darmowych wersjach faktury często wystawia się przyciskiem przy każdym zamówieniu. Przy kilkudziesięciu zamówieniach dziennie policz czas.
- Harmonogram zadań. Wysyłka „w tle” w WordPressie często opiera się na WP-Cron, który uruchamia się przy odwiedzinach strony. W małym sklepie nocą może to opóźnić wysyłkę, a fakturę online wysyła się w dniu wystawienia.
- Przerwy w KSeF. Zapytaj, co wtyczka robi, gdy KSeF nie odpowiada: czeka w kolejce czy wystawia offline i pilnuje terminu. Terminy dla każdego trybu zebraliśmy w artykule awaria KSeF.
- Jedno narzędzie wysyła faktury. Jeśli wtyczka i program do faktur mają włączoną wysyłkę do KSeF, ta sama sprzedaż może trafić tam dwa razy.
- Dojrzałość. Kilka wtyczek pojawiło się w 2026 r. i ma pojedyncze instalacje. Przetestuj je najpierw na środowisku testowym KSeF.
Wdrożenie krok po kroku
- Wybierz drogę: wtyczka bezpośrednia albo program do faktur z integracją.
- Przygotuj dostęp do KSeF: certyfikat albo token z uprawnieniem do wystawiania faktur. Certyfikat generujesz bezpłatnie w Aplikacji Podatnika KSeF.
- Skonfiguruj wtyczkę na środowisku testowym i wystaw kilka faktur oraz jedną korektę.
- Dodaj i sprawdź pole NIP w koszyku, także na telefonie.
- Ustal numerację i serię dla korekt, tak żeby nie dublowała się z innymi fakturami firmy.
- Przełącz na środowisko produkcyjne i przez pierwszy tydzień porównuj zamówienia z fakturami w KSeF.
- Nadaj księgowej uprawnienie do przeglądania faktur w KSeF.
Wtyczka KSeF Faktury dla WooCommerce jest w przygotowaniu i jeszcze nie jest dostępna. Dziś nasza aplikacja działa tylko w Shopify. Jeśli chcesz dostać informację o starcie, zapisz się na listę na stronie głównej.
Najczęstsze pytania
Czy WooCommerce ma wbudowaną obsługę KSeF?
Nie. Faktury do KSeF wysyła wtyczka albo program do faktur połączony ze sklepem.
Czy darmowa wtyczka wystarczy?
Przy kilku fakturach dla firm w miesiącu często tak, bo ręczne wystawienie z ekranu zamówienia zajmuje chwilę. Przy większej sprzedaży liczy się automatyczna wysyłka po płatności i automatyczne korekty, zwykle w płatnych wersjach.
Czy muszę wysyłać do KSeF faktury dla klientów indywidualnych?
Nie. Dla konsumentów KSeF jest dobrowolny (FAQ MF, kategoria „Wystawianie i otrzymywanie faktur”, pyt. 5). Większość wtyczek pozwala ustawić, czy zamówienia bez NIP mają trafiać do KSeF.
Czy mogę wystawiać faktury bez żadnej wtyczki?
Tak. MF udostępnia bezpłatną Aplikację Podatnika KSeF i Aplikację Mobilną KSeF (FAQ MF, kategoria „Wystawianie i otrzymywanie faktur”, pyt. 35). Przy każdej fakturze przepisujesz wtedy dane z zamówienia ręcznie.
Artykuł ma charakter ogólnej informacji i nie jest poradą podatkową.
Źródła
- Katalog WordPress.org: KSeF dla WooCommerce, wysyłka e-faktur (WP Desk), Flexible Invoices, FakturFlow, ByteWave Faktury, POP e-invoicing for WooCommerce, tag „ksef” (stan na 19.10.2026)
- WP Desk: Fakturownia WooCommerce, inFakt WooCommerce, wFirma WooCommerce, iFirma WooCommerce
- Fakturownia: integracja z KSeF, wFirma: integracja z KSeF, iFirma: integracja z WooCommerce
- Pytania i odpowiedzi KSeF 2.0, Ministerstwo Finansów: kategoria „Wystawianie i otrzymywanie faktur”, pyt. 5 i 35; kategoria „Uprawnienia i autoryzacja”, pyt. 39
- Ustawa o podatku od towarów i usług, tekst jednolity Dz.U. 2026 poz. 1263: art. 106ga ust. 2 pkt 4, art. 106j ust. 2 i 4
- Rozporządzenie w sprawie korzystania z KSeF, Dz.U. 2025 poz. 1815, § 13
Stan prawny na 19 października 2026 r.