KSeF w WooCommerce 2026 — kompletny przewodnik
Kompletny przewodnik po KSeF w sklepie WooCommerce: format FA(3), autoryzacja, automatyczne faktury z zamówień, koszty, korekty i co robić przy awarii systemu.
Obowiązek KSeF — od kiedy i kogo dotyczy
Krajowy System e-Faktur (KSeF) to centralna platforma Ministerstwa Finansów do wystawiania i odbioru faktur ustrukturyzowanych. Obowiązek wystawiania faktur w KSeF wchodzi etapami: od 1 lutego 2026 dla podatników z obrotem powyżej 200 mln zł, a od 1 kwietnia 2026 dla pozostałych (w tym większości sklepów); najmniejsi (sprzedaż do 10 tys zł brutto miesięcznie) mają czas do 1 stycznia 2027. Odbierać faktury z KSeF trzeba jednak u wszystkich już od 1 lutego 2026, a w 2026 r. nie ma kar za błędy. W praktyce faktura sprzedaży musi powstać w formacie XML zgodnym ze schemą FA(3) i zostać wysłana do KSeF, który nadaje jej numer KSeF oraz UPO (urzędowe poświadczenie odbioru).
Jeśli prowadzisz sklep na WooCommerce i wystawiasz faktury firmom, ten obowiązek dotyczy także Ciebie. Masz dwie drogi: ręcznie eksportować dane do zewnętrznego systemu albo zintegrować sklep z KSeF tak, by faktury powstawały automatycznie z zamówień. Ten przewodnik pokazuje to drugie podejście — najszybsze i najmniej pracochłonne.
Jak działa KSeF w praktyce — od zamówienia do UPO
Zanim przejdziemy do konfiguracji, warto zrozumieć cały obieg dokumentu. W sklepie wygląda on tak:
- Klient składa i opłaca zamówienie w WooCommerce.
- Wtyczka buduje fakturę w formacie FA(3) na podstawie danych zamówienia.
- Faktura zostaje wysłana do KSeF, który ją weryfikuje i nadaje numer KSeF.
- System zwraca UPO — dowód przyjęcia faktury.
- Klient dostaje e-mailem PDF z numerem KSeF; Ty masz komplet w panelu.
Co musisz przygotować
- WordPress 6.0+ i PHP 8.1+ (oraz WooCommerce 7.0+, jeśli chcesz fakturować zamówienia).
- Konto w KSeF i sposób autoryzacji wtyczki — token autoryzacyjny albo certyfikat XAdES.
- Połączenie wychodzące HTTPS do
api.ksef.mf.gov.pl. - Wtyczkę łączącą WooCommerce z KSeF — np. Prosta Faktura KSeF.
Autoryzacja w KSeF — token, certyfikat czy profil zaufany
Zanim wyślesz pierwszą fakturę, musisz potwierdzić w KSeF prawo do działania w imieniu danego NIP. Sama wtyczka łączy się z KSeF na dwa sposoby — tokenem autoryzacyjnym albo certyfikatem XAdES. Profil zaufany przydaje się do zalogowania w aplikacji KSeF MF, w której token wygenerujesz:
| Metoda | Dla kogo | Plusy | Minusy |
|---|---|---|---|
| Token autoryzacyjny | JDG, małe i średnie sklepy | Najszybszy start, bez podpisu kwalifikowanego | Token trzeba bezpiecznie przechować |
| Certyfikat KSeF | Większe organizacje, biura | Precyzyjna kontrola uprawnień | Więcej kroków konfiguracji |
| Profil zaufany | Logowanie jak w e-urzędzie | Znany z usług publicznych | Mniej wygodny przy automatyzacji |
Najprostszy start to token autoryzacyjny wygenerowany w aplikacji KSeF MF. Szczegółowe porównanie znajdziesz we wpisie KSeF: token czy certyfikat, a pełną instrukcję połączenia w jak połączyć WordPress z KSeF.
Automatyczne faktury z zamówień WooCommerce
Sednem wdrożenia jest auto-wystawianie. Po połączeniu z KSeF w Ustawienia → Ogólne wskazujesz status zamówienia, przy którym ma powstać faktura. Od tej chwili każda transakcja zamienia się w fakturę FA(3), wędruje do KSeF, a klient może dostać PDF z numerem KSeF na e-mail (auto-wysyłka PDF to funkcja Pro). Najczęściej wybierany moment to:
- Po opłaceniu — bezpieczny domyślny wybór dla większości sklepów.
- Po złożeniu zamówienia — gdy fakturujesz od razu, niezależnie od płatności.
- Po realizacji — gdy faktura ma odpowiadać wysyłce/wykonaniu usługi.
Pełną instrukcję krok po kroku opisaliśmy w artykule jak wysłać fakturę do KSeF z WooCommerce.
Faktury kosztowe i korekty
KSeF to nie tylko sprzedaż. Wtyczka powinna też pobierać faktury kosztowe wystawione na Twój NIP oraz umożliwiać wystawianie korekt FA(3) z automatycznym blokiem DaneFaKorygowanej. Dzięki temu w jednym panelu masz całość: sprzedaż, koszty i korekty — bez przeklejania danych z aplikacji MF.
Co, gdy KSeF jest niedostępny
KSeF bywa chwilowo niedostępny. Najważniejsze, by faktura wtedy nie przepadła — Prosta Faktura KSeF zapisuje ją i pozwala ponowić wysyłkę, gdy system wróci (numer KSeF i UPO dochodzą po przyjęciu). Czym jest formalny tryb offline wg MF i co dokładnie robi wtyczka, opisujemy w artykule tryb offline KSeF.
Ile to kosztuje
Nie potrzebujesz drogiego systemu księgowego, żeby spełnić obowiązek KSeF w sklepie. Dedykowana wtyczka jak Prosta Faktura KSeF kosztuje 10 zł/mies. (120 zł rocznie), a na start jest plan darmowy z fakturami bez limitu. Dlaczego nie warto przepłacać za ERP, tłumaczymy w artykule KSeF bez programu księgowego, a co brać pod uwagę przy wyborze — w porównaniu wtyczek.
Checklist wdrożenia KSeF w WooCommerce
- Potwierdź u księgowej, od kiedy obowiązek dotyczy Twojej firmy.
- Zainstaluj wtyczkę i aktywuj konto (plan darmowy nie wymaga karty).
- Wygeneruj token w aplikacji KSeF i połącz sklep.
- Przetestuj kilka faktur — sprawdź numer KSeF i UPO.
- Włącz auto-wystawianie i wskaż status zamówienia.
- Skonfiguruj pobieranie kosztów i numerację korekt.
- Ustal z księgową format eksportu (CSV/PDF) i rytm przekazywania.
Podsumowanie
Wdrożenie KSeF w WooCommerce sprowadza się do trzech rzeczy: zainstaluj wtyczkę, autoryzuj się w KSeF i włącz auto-wystawianie. Reszta — format FA(3), numer KSeF, UPO, koszty i korekty — powinna dziać się automatycznie. Im wcześniej to ustawisz, tym spokojniej przejdziesz przez obowiązek od lutego 2026.