Wtyczki WordPress do KSeF: porównanie i wdrożenie krok po kroku

Kiedy w grudniu 2025 r. skończyłem kolejną integrację sklepu WooCommerce z KSeF, jeden z klientów zapytał: "Ale po co mi to, skoro jeszcze nie muszę?". Dwa miesiące później dzwonił, że chce zrobić to przed terminem, bo konkurencja już ma, a on traci czas na ręczne faktury. Ten artykuł jest dla wszystkich, którzy są w tym samym miejscu - i chcą wybrać właściwą wtyczkę WordPress do KSeF bez tracenia czasu na testowanie pięciu opcji na raz.

Jestem programistą WordPress i WooCommerce, nie księgowym ani doradcą podatkowym - jeśli masz wątpliwości co do prawnego obowiązku KSeF w Twojej konkretnej sytuacji, skonsultuj je z biurem rachunkowym. Moja rola to pomóc Ci wybrać narzędzie i sprawnie przeprowadzić instalację od tokena autoryzacyjnego po pierwszą fakturę wysłaną produkcyjnie.

Terminy, które musisz znać

Od 1 lutego 2026 r. wszyscy przedsiębiorcy muszą odbierać faktury zakupowe w KSeF. Od 1 kwietnia 2026 r. obowiązek wystawiania e-faktur przez KSeF objął większość podatników VAT - JDG, spółki, MŚP. Mikroprzedsiębiorcy z miesięczną sprzedażą fakturowaną do 10 000 zł dostali czas do 1 stycznia 2027 r.

Jeśli prowadzisz sklep WooCommerce i wystawiasz faktury VAT - kwiecień 2026 to Twoja data graniczna. Można działać dalej bez integracji, ale przy kontroli skarbowej brak e-faktur w KSeF to podstawa do zakwestionowania całej ewidencji. Wolę skończyć wdrożenie w spokoju w ciągu jednego popołudnia niż gonić deadline z pistoletem przy skroni.

Jak dziala integracja WordPress z KSeF

KSeF to system Ministerstwa Finansow przyjmujacy faktury w formacie XML (schemat FA). Twoja wtyczka musi:

1. Pobrać dane zamówienia z WooCommerce
2. Zbudować poprawny XML zgodny ze schematem FA(3)
3. Uwierzytelnić się tokenem API (wystawiasz go raz w systemie KSeF)
4. Wysłać dokument do KSeF i odebrać potwierdzenie UPO
5. Zapisać numer referencyjny KSeF przy zamówieniu

Różnice między wtyczkami dotyczą głównie stopnia automatyzacji tego procesu, ceny licencji i integracji z ekosystemem faktur, którego już używasz.

Porównanie czterech wtyczek

Flexible Invoices KSeF Add-on (WP Desk)

To moje pierwsze polecenie dla sklepów, które już działają na Flexible Invoices od WP Desk. Add-on pobierasz z WordPress.org za darmo i od razu masz dostęp do wysyłki faktur do KSeF, podglądu statusu i numeru referencyjnego bezpośrednio z listy faktur. Możesz wysyłać pojedynczo lub hurtowo.

Wtyczka korzysta z oficjalnego API KSeF przez token autoryzacyjny. Pełna automatyzacja (wysyłka zaraz po wystawieniu faktury) działa najlepiej z Flexible Invoices PRO, gdzie fakturowanie jest wyzwalane zdarzeniem WooCommerce. Jeśli zaczynasz od zera, musisz liczyć koszt obu komponentów.

ByteWave Faktury

Najlepsza darmowa opcja na rynku. Wersja bezpłatna dostępna na WordPress.org daje pełny zestaw ręczny: generujesz XML, walidacja przed wysyłką, wysyłka do KSeF, pobieranie UPO. Bez limitów dokumentów, bez okresu próbnego.

Wersja Pro za 69 zł netto rocznie odblokowuje automatyczne generowanie i wysyłkę faktury zaraz po opłacie zamówienia. Dodaje też tryb offline (faktury wysłane gdy KSeF wróci po przestoju), raporty i operacje masowe. To jeden z lepszych stosunków jakości do ceny na polskim rynku WP.

Przetestowałem to rozwiązanie przy wdrożeniu dla klienta z ~200 zamówieniami miesięcznie - działa stabilnie, a wsparcie techniczne odpowiedziało w ciągu kilku godzin na maila z pytaniem o B2B.

Integracja przez Fakturownia lub inFakt

Jeśli prowadzisz księgowość w Fakturowni lub inFakcie, masz inną opcję: wtyczka WooCommerce wysyła dane zamówień do zewnętrznego systemu fakturowania, a ten ogarnia KSeF po swojej stronie. Koszt to abonament SaaS (Fakturownia od ~29 zł/mies.) plus licencja wtyczki.

To podejście ma sens gdy:

• Masz biuro rachunkowe obsługujące Fakturownie/inFakt
• Potrzebujesz spójnego rejestru faktur ze wszystkich źródeł (sklep + sprzedaż offline)
• Chcesz delegować zarządzanie KSeF do systemu zewnętrznego

Wadą jest uzależnienie od dwóch zewnętrznych systemów i wyższy koszt miesięczny niż w przypadku wtyczek natywnych.

Studio Kalmus (rozwiązanie custom)

Dla większych sklepów z niestandardowymi potrzebami (własne schematy faktur, integracja z ERP, zarządzanie wieloma podmiotami VAT) istnieją firmy oferujące integrację KSeF-WooCommerce na zamówienie. Studio Kalmus to jeden z polskich dostawców specjalizujących się w tym obszarze. Wycena indywidualna, ale też indywidualnie dopasowane rozwiązanie.

Rozsądne gdy masz sklep z 1000+ zamówieniami miesięcznie i specyficzne wymagania, których żadna gotowa wtyczka nie obsługuje w pełni.

Wdrożenie krok po kroku (na przykładzie ByteWave)

Pokazuję na ByteWave, bo to najczęstszy wybór przy prostych wdrożeniach. Proces dla Flexible Invoices jest analogiczny.

Na co zwrócić szczególną uwagę:

• Mapowanie stawek VAT: WooCommerce może mieć kilka stawek (23%, 8%, 0%, zw.) - każda musi być poprawnie przypisana w konfiguracji wtyczki
• NIP kupującego dla B2B: checkout musi zbierać NIP, a wtyczka musi go przekazywać do faktury
• Faktury korygujące: sprawdź czy wtyczka obsługuje korekty gdy klient zwróci towar
• Dane sprzedawcy: adres, NIP, bank muszą być identyczne z danymi w KSeF

Najczęstsze błędy przy integracji

Przez ostatnie pół roku robiłem kilka takich wdrożeń i te problemy powtarzały się najczęściej:

Zły format daty. KSeF wymaga daty w formacie ISO 8601 (YYYY-MM-DD). Jeśli wtyczka do faktur generuje daty w formacie polskim (DD.MM.YYYY) i nie przelicza ich przy eksporcie do XML - otrzymasz błąd walidacji. Objaw: faktura wysyła się, ale KSeF zwraca status błędu z komunikatem o polu DataWystawienia.

Brakujące pole jednostki miary. FA(3) wymaga jednostki dla każdej pozycji. Dla produktów cyfrowych lub usług wpisuje się "szt." lub "usł." - jeśli pole jest puste, KSeF odrzuci dokument. To klasyczny problem przy sklepach sprzedających e-booki lub kursy online - koniecznie sprawdź tę konfigurację wcześniej.

Duplikacja faktur. Przy automatycznym fakturowaniu i retry po timeout możesz wysłać tę samą fakturę dwa razy. Dobra wtyczka sprawdza status przed powtórną wysyłką - zapytaj wprost dostawcę jak to obsługują. Cofnięcie duplikatu przez KSeF wymaga wystawienia faktury korygującej, co jest niepotrzebnym bałaganem w ewidencji.

Token wygasa. Tokeny KSeF mają datę ważności. Wpisz datę wygaśnięcia do kalendarza (np. Google Calendar z alertem 7 dni wcześniej) i odnów token przed terminem - wygaśnięcie tokena oznacza zatrzymanie wysyłki faktur do czasu odnowienia.

Niezgodność NIP. NIP w konfiguracji wtyczki musi być dokładnie tym samym NIP, dla którego wystawiłeś token. Błąd literowy lub brakujący myślnik skutkuje odrzuceniem każdej faktury.

Dla jakich sklepów które rozwiązanie

Skrót decyzyjny, żebyś nie musiał czytać wszystkiego od nowa:

• Mały sklep, proste faktury, budżet 0-70 zł/rok - ByteWave darmowa lub Pro
• Już używasz Flexible Invoices - Flexible Invoices KSeF Add-on (zero dodatkowego kosztu do wtyczki, liczy się tylko ewentualny koszt FI Pro)
• Pełna księgowość w SaaS (Fakturownia, inFakt) - integracja przez ten system, wtyczka WooCommerce jako most danych
• Duży sklep, specyficzne wymagania, 1000+ faktur/mies. - wycena custom u dewelopera

Jeden praktyczny tip: jeśli sklep ma kilka kanałów sprzedaży (sklep + Allegro przez BaseLinker + sprzedaż offline), zintegrowane podejście przez Fakturownie lub inFakt daje spójny rejestr z jednego miejsca. Natywna wtyczka WooCommerce nie widzi faktur z innych kanałów i możesz skończyć z dwoma różnymi numeracjami faktur w KSeF.

Jeśli budujesz sklep od zera i szukasz kompleksowego rozwiązania dla rynku polskiego, zajrzyj do mojej oferty sklepów internetowych na WooCommerce - KSeF wdrażam jako część projektu, nie jako dodatek.

Możesz też zajrzeć na wpisy o sklepach z subskrypcjami (tam KSeF dla cyklicznych faktur ma swoją specyfikę) oraz o obowiązkach GPSR w WooCommerce 2026 - oba tematy często idą w parze przy kompleksowym audycie sklepu.

Najczęstsze pytania

Czy sklep WooCommerce musi mieć wtyczkę do KSeF?

Jeśli wystawiasz faktury VAT przez sklep - tak, to kwestia czasu. Od 1 kwietnia 2026 r. obowiązek dotyczy większości przedsiębiorców w Polsce. Sklep, który generuje faktury poza KSeF, działa niezgodnie z prawem. Wtyczka to najprostszy sposób na automatyzację tego procesu.

Jaka jest najlepsza darmowa wtyczka WordPress do KSeF?

ByteWave Faktury dostępna na WordPress.org to aktualnie jedyna sensowna darmowa opcja bez ukrytych limitów. Pozwala ręcznie wystawiać faktury KSeF, generować XML, walidować i pobierać UPO. Automatyzacja (wysyłka po opłacie zamówienia) wymaga wersji Pro za 69 zł/rok.

Czy Flexible Invoices KSeF Add-on jest darmowy?

Sama wtyczka KSeF Add-on dostępna na WordPress.org jest bezpłatna, ale wymaga zainstalowanej wtyczki Flexible Invoices (dostępna w wersji darmowej i płatnej Pro). W praktyce pełna automatyzacja działa najlepiej z Flexible Invoices PRO.

Jak długo trwa wdrożenie wtyczki KSeF w WooCommerce?

Przy prostym sklepie z jedną stawką VAT to 2-4 godziny pracy: instalacja, konfiguracja API, mapowanie danych zamówień i testy w środowisku demo. Sklepy z produktami cyfrowymi, B2B, wieloma stawkami VAT lub integracjami z BaseLinkerem mogą wymagać 1-2 dni dodatkowego dostosowania.

Co to jest token KSeF i jak go wygenerować?

Token to klucz API wystawiony przez system KSeF, który autoryzuje Twoją aplikację do wysyłki faktur w imieniu firmy. Generujesz go przez stronę podatki.gov.pl, logując się profilem zaufanym lub podpisem kwalifikowanym. Każda wtyczka opisana w artykule ma pole na ten token w ustawieniach.

Czy integracja KSeF działa z trybem B2B w WooCommerce?

Tak, ale wymaga odpowiedniego mapowania danych. Faktura B2B wymaga NIP kupującego, co oznacza, że Twój checkout musi go zbierać. Większość wtyczek ma pole NIP w formularzu zamówienia, jednak należy sprawdzić czy automatyczna wysyłka poprawnie obsługuje faktury dla firm i faktury dla osób prywatnych jako osobne ścieżki.