KSeF + WooCommerce — jak wystawiać faktury automatycznie ze sklepu (2026)

WooCommerce to najpopularniejsza platforma e-commerce na świecie (oparta na WordPress) — open-source, darmowa w bazowej wersji, wysoka elastyczność. W Polsce używana zarówno przez małe sklepy hobbystyczne jak i średnie firmy z dziesiątkami tysięcy zamówień miesięcznie. Po wprowadzeniu obowiązkowego KSeF (1 lutego 2026 dla dużych firm, 1 kwietnia 2026 dla wszystkich pozostałych) wszyscy sprzedawcy z VAT muszą wystawiać faktury elektroniczne dla zamówień B2B — a WooCommerce tego NIE robi natywnie.

Ten przewodnik pokazuje jak skonfigurować integrację WooCommerce → Fakturium → KSeF, żeby faktury wystawiały się automatycznie po każdym zamówieniu B2B (z NIP-em nabywcy w polu „NIP do faktury"). Setup: ok. 15 minut. Działa dla każdej wersji WooCommerce 5.x i nowszej (REST API v3).

Dlaczego WooCommerce nie wystawia faktur KSeF?

WooCommerce w bazowej wersji ma moduł „Faktury" generujący proste PDF-y z numerem zamówienia, datą i kwotą. Ten moduł nie zna schematu FA(2) wymaganego przez KSeF od 1 lutego 2026, nie ma tokenów API KSeF, nie pobiera UPO. Pluginów społecznościowych z KSeF jest kilka, ale rzadko aktualizowane — większość niezgodna z wariantem schematu FA(2) z 2026 r.

Najpewniejsza opcja: zewnętrzny integrator (Fakturium, ifirma, fakturownia + plugin), który pobiera zamówienia przez REST API, generuje fakturę zgodną ze schematem KSeF, wysyła do MF, pobiera UPO i odsyła do klienta.

Konfiguracja integracji — krok po kroku

Krok 1: Załóż konto Fakturium (3 min)

Wejdź na fakturium.pl/signup. Wprowadź email, hasło, dane firmy (NIP, adres). Plan Free pozwala wystawić 5 faktur miesięcznie — wystarczy do testowania. Plan Pro (99 zł netto / mies, do 70 faktur, 5 użytkowników, KSeF produkcja) — typowy plan dla małego sklepu WooCommerce. Bez karty kredytowej dla planu Free.

Krok 2: Wygeneruj klucze REST API w WooCommerce (3 min)

Zaloguj się do panelu WordPress jako administrator. Idź do: WooCommerce → Ustawienia → zakładka „Zaawansowane" → „REST API". Kliknij „Dodaj klucz". W formularzu:

• Opis: „Fakturium" (dowolna nazwa, dla rozróżnienia)
• Użytkownik: konto z uprawnieniami administratora sklepu
• Uprawnienia: „Read/Write" (pełen odczyt + tworzenie zamówień/faktur)
• Klik „Generuj klucz API"

Krok 3: Połącz konta w Fakturium (3 min)

W panelu Fakturium → Integracje → WooCommerce. Wpisz:

• URL sklepu: pełen adres (np. https://twojsklep.pl)
• Consumer Key: skopiowany z WooCommerce
• Consumer Secret: skopiowany z WooCommerce

Kliknij „Połącz". Fakturium zweryfikuje klucze przez REST API endpoint /wp-json/wc/v3/ — w 2-5 sekundach zobaczysz status „Połączono" + listę produktów synchronizowaną do katalogu Fakturium.

Krok 4: Włącz auto-faktura dla zamówień z NIP (5 min)

W Fakturium → Ustawienia → Reguły automatyzacji. Włącz „Auto-faktura dla zamówień WooCommerce z NIP". Konfiguracja:

• Wyzwalacz: nowe zamówienie WooCommerce ze statusem "Processing" lub "Completed" + NIP w polu „billing.company" lub „billing.tax_id"
• Akcja: pobierz dane zamówienia, wygeneruj fakturę KSeF z pozycjami z koszyka
• Wysyłka: do KSeF + email do nabywcy z PDF + link do UPO
• Numeracja: FV/2026/05/0001 (auto-incrementing per miesiąc)

Krok 5: Test (2 min)

Zrób testowe zamówienie w sklepie z własnym NIP-em (lub od współpracownika) w polu „NIP do faktury". Po ~30 sekundach w Fakturium pojawi się faktura. Sprawdź: dane nabywcy (auto-fill z Białej Listy), numery KSeF nadany, UPO odebrane (zielony badge), email do nabywcy wysłany.

Cennik — ile to kosztuje

Łączny koszt sklepu WooCommerce + Fakturium dla typowego sklepu B2B:

• WooCommerce: darmowy (open-source) — ale potrzebujesz hosting WordPress (zwykle 30-100 zł/mies za dobry serwer LAMP)
• Plugin NIP w checkout: zwykle darmowy (społecznościowe) lub jednorazowo 100-200 zł (premium typu „PL Faktura VAT")
• Fakturium Free (5 fv / mies): 0 zł — testowanie + bardzo małe sklepy
• Fakturium Pro (do 70 fv / mies, 5 users, KSeF prod): 99 zł netto / mies — typowy plan
• Fakturium Business (nielimitowane fv + users, priority): 199 zł netto / mies — większe sklepy lub powyżej 70 fv B2B

Częste problemy

Problem 1: REST API zwraca 401 Unauthorized

Sprawdź: (a) czy Consumer Key i Secret są dokładnie skopiowane (bez spacji), (b) czy uprawnienia klucza to „Read/Write" (a nie tylko „Read"), (c) czy WooCommerce REST API jest włączone (Settings → Advanced → Legacy API → upewnij się że jest "Enabled" lub używasz nowszego v3 API), (d) czy SSL na sklepie działa (REST API wymaga HTTPS).

Problem 2: Pole NIP nie zapisuje się w zamówieniu

Standard WooCommerce nie ma pola NIP — używaj pluginu polskiego (np. WooCommerce dla Polski, WooFunnels EU VAT) lub dodaj snippet do functions.php który mapuje pole „NIP" do „billing.company" lub custom meta. Fakturium odczytuje NIP z obu miejsc.

Problem 3: Faktury duplikują się

Jeśli zamówienie zmienia status (np. „Pending" → „Processing" → „Completed") i Fakturium traktuje każdą zmianę jako nowy event — może powstać duplikat faktury. Fix: w Fakturium → Ustawienia → Reguły → ustaw triggera tylko na ONE konkretny status (zwykle „Completed" — po opłaceniu). Plus deduplication przez WC order ID.

FAQ

Czy mogę używać Fakturium bez wyłączania wbudowanego modułu Faktury WooCommerce?

Technicznie tak (są niezależne), ale stworzysz duplikaty PDF-ów które klient dostanie dwa razy. Lepsza praktyka: wyłącz moduł WC Faktury (Settings → Tax/Invoices) i zostaw tylko Fakturium jako jedyny generator faktur.

Co z kasą fiskalną dla B2C?

WooCommerce + kasa fiskalna z drukarką paragonową to standard dla sklepów hybrydowych B2C+B2B. Fakturium generuje TYLKO faktury B2B (gdy NIP). Paragony B2C zostają w kasie fiskalnej (zgodnie z ETAP 3 KSeF od 1 stycznia 2027 — kasy nadal mogą wystawiać paragony, ale faktury B2B przez KSeF od lutego/kwietnia 2026).

Czy jest oficjalny plugin Fakturium dla WooCommerce w katalogu WordPress?

Aktualnie nie — integracja działa przez REST API (server-to-server), nie wymaga instalacji pluginu na sklepie. Plugin do publikacji w WP Plugin Directory jest w opracowaniu (Q3 2026). Setup obecnym REST API jest szybszy niż instalacja pluginu (15 min vs godzinę z konfiguracją).

Co jeśli mam wiele sklepów WooCommerce na różnych domenach?

Plan Business Fakturium (199 zł / mies) wspiera multi-store — łączysz wiele kluczy REST API z różnymi domenami w jeden panel. Każdy sklep ma osobną numerację faktur i osobny token KSeF (jeśli prowadzisz formalnie różne firmy) lub wspólną (jeśli wszystkie sklepy to ta sama firma).

Czy zwroty z WooCommerce automatycznie generują FK?

Tak — gdy zamówienie zmienia status na „Refunded" (pełny zwrot) lub „Partially Refunded" (częściowy), Fakturium automatycznie tworzy fakturę korygującą (FK) in minus z odwołaniem do oryginalnego numeru KSeF. Bez ręcznej akcji.

“WooCommerce przez open-source jest mocno wykorzystywany w PL e-commerce. Brak natywnego KSeF to nie jego "wina" — to global platform. Sprzedawcy muszą zorganizować to sami przez integratora. Plus dla nas: niska konkurencja na ten konkretny use case.”