Integracja KSeF z WooCommerce krok po kroku (2026)
Opublikowano: 11 lipca 2026
Od 1 kwietnia 2026 każdy czynny podatnik VAT — również właściciel sklepu internetowego — ma obowiązek wystawiać faktury B2B jako faktury ustrukturyzowane w KSeF (Krajowym Systemie e-Faktur). Do końca 2026 trwa okres przejściowy bez kar, ale od 1 stycznia 2027 fiskus zaczyna je egzekwować. W tym poradniku pokazujemy, jak podłączyć sklep na WooCommerce do KSeF w około 30 minut — bez pośredników, bez opłat za fakturę i bez zewnętrznego systemu księgowego.
Czego potrzebujesz
- Sklep na WordPress + WooCommerce (WordPress 6.5+, PHP 8.1+),
- NIP Twojej firmy i dostęp do aplikacji KSeF Ministerstwa Finansów (Profil Zaufany lub podpis kwalifikowany),
- ok. 30 minut.
Krok 1. Wygeneruj token KSeF
Integracja uwierzytelnia się w KSeF tokenem z uprawnieniami InvoiceWrite i InvoiceRead. Token generujesz w aplikacji KSeF Ministerstwa Finansów — najpierw w środowisku testowym, żeby bezpiecznie przećwiczyć cały proces, a dopiero potem w produkcyjnym. Szczegółowa instrukcja: jak wygenerować token KSeF krok po kroku.
Krok 2. Zainstaluj darmową wtyczkę FakturFlow
W panelu WordPress przejdź do Wtyczki → Dodaj nową i wyszukaj FakturFlow – E-Invoicing for KSeF. Wtyczka jest darmowa, bez limitu faktur i bez opłat prowizyjnych: generuje pliki FA(3), waliduje je lokalnie względem oficjalnego schematu XSD i wysyła bezpośrednio do API KSeF 2.0 Ministerstwa Finansów. Dane faktur nie przechodzą przez żadne serwery pośredniczące.
Krok 3. Skonfiguruj połączenie
Przejdź do WooCommerce → KSeF Invoices i uzupełnij:
- Środowisko — zacznij od „Test”; na produkcję przełączysz się jednym kliknięciem,
- NIP sprzedawcy i nazwę firmy,
- Token KSeF — zostanie zapisany w formie zaszyfrowanej i nigdy nie trafia do logów.
Kliknij Test connection — wtyczka sprawdzi, czy Twój hosting w ogóle może połączyć się z API KSeF (niektóre hostingi współdzielone blokują ruch wychodzący).
Krok 4. Pole NIP na checkoucie robi całą robotę
FakturFlow dodaje do kasy (klasycznej i blokowej) pole NIP z walidacją sumy kontrolnej. Zamówienie z NIP-em jest automatycznie oznaczane jako B2B — i tylko takie zamówienia trafiają do KSeF. Klienci detaliczni przechodzą przez kasę bez żadnych zmian.
Krok 5. Wystaw pierwszą fakturę testową
Złóż zamówienie testowe z NIP-em, a następnie na ekranie zamówienia użyj przycisków Generate → Validate → Send. Po kilku sekundach zobaczysz nadany numer KSeF, pobierzesz UPO (Urzędowe Poświadczenie Odbioru), a wizualizacja faktury dostanie kod QR KOD I, którym kontrahent zweryfikuje dokument w systemie Ministerstwa. Gdy wszystko działa — przełącz środowisko na produkcyjne i podmień token na produkcyjny.
Krok 6 (opcjonalny). Włącz pełną automatyzację
Darmowa wersja obsługuje pełny ręczny obieg. Jeśli chcesz, żeby faktury „płynęły same”, dodatek FakturFlow Pro dokłada:
- automatyczną wysyłkę faktury do KSeF po opłaceniu zamówienia (z ponowieniami przy awariach),
- automatyczne korekty przy zwrotach WooCommerce,
- tryb offline24 — sklep wystawia faktury nawet, gdy KSeF nie działa, i dosyła je w ustawowym terminie,
- panel zgodności z pełnym dziennikiem zdarzeń i eksportem CSV.
Pro kosztuje 249 zł rocznie za jeden sklep, z 14-dniową gwarancją zwrotu — kup licencję tutaj.
Najczęstsze pytania
Czy muszę wysyłać do KSeF faktury dla konsumentów (B2C)? Nie — obowiązek dotyczy faktur między firmami. FakturFlow kieruje do KSeF wyłącznie zamówienia z NIP-em nabywcy.
Co z fakturą, gdy KSeF ma awarię? Przepisy przewidują tryby offline: fakturę wystawiasz lokalnie i dosyłasz do KSeF w ustawowym terminie. W wersji Pro dzieje się to automatycznie.
Czy potrzebuję dodatkowego programu do faktur? Nie. Faktura powstaje bezpośrednio z zamówienia WooCommerce, a jej oryginałem w rozumieniu przepisów jest dokument w KSeF.