Fakturownia w WooCommerce - automatyczne faktury i integracja z ksiegowoscia

Przez 13 lat wdrażałem sklepy WooCommerce dla klientów z Polski i Niemiec i przez długi czas ręczne wystawianie faktur było jedną z największych bolaczek mniejszych firm. Ktoś musiał siedzieć po godzinach, przepisywać dane z zamówień do Excela albo do programu ksiegowego, a błędy wkradały się same. Dobra integracja z Fakturownią zmienia ten obraz o 180 stopni - system sam wystawia dokument, wysyła go mailem do klienta i czeka na potwierdzenie z KSeF. Tę integrację konfigurowałem kilkadziesiąt razy i poniżej opisuję wszystko, czego potrzebujesz, żeby zrobić to dobrze.

Fakturownia WooCommerce integracja to temat, który z roku na rok zyskuje na znaczeniu - szczególnie odkąd KSeF zaczął stawać się twardym obowiązkiem, a nie opcją. Jeśli prowadzisz sklep WooCommerce i sprzedajesz firmom (B2B), nie masz już wyboru co do formy faktury. W tym artykule pokażę ci, jak zestawić integrację krok po kroku, jakich błędów unikać i jak zorganizować eksport danych tak, żeby ksiegowa była zadowolona bez dodatkowych telefonów od ciebie.

Co daje integracja Fakturownia z WooCommerce

Na poziomie zasady działania mechanizm jest prosty: plugin lub bezposrednia integracja przez REST API nasłuchuje na zdarzenia w WooCommerce (zmiana statusu zamówienia, nowa płatność) i wywołuje endpoint Fakturowni, który tworzy dokument z danymi z zamówienia. Klient dostaje mailem PDF z fakturą lub paragonem. Ty masz dokument w Fakturowni gotowy do eksportu.

Konkretne korzyści, które widzę u klientów:

• zero ręcznego przepisywania danych kupującego
• faktura wystawiona w ciągu kilku sekund od opłacenia zamówienia
• automatyczna wysyłka PDF na e-mail klienta
• wszystkie dokumenty w jednym miejscu, posegregowane chronologicznie
• eksport do CSV, XLS lub JPK_FA bez dodatkowej pracy
• gotowość na KSeF - numer jest nadawany i wróżony do dokumentu

Dwie drogi do integracji - plugin czy API

Zanim zaczniesz konfigurację, zdecyduj, którą ścieżką idziesz.

Plugin WP Desk (oficjalny, rekomendowany) - to wtyczka dostępna bezpłatnie w repozytorium WordPress.org pod nazwą "Fakturownia WooCommerce". Pobiera ok. 4000 aktywnych instalacji, ostatnia aktualizacja miała miejsce 12.05.2026, co oznacza aktywne utrzymanie. Konfiguracja zajmuje ok. 30 minut nawet bez technicznego tła.

Bezpośrednia integracja przez Fakturownia REST API - dla programistów lub gdy potrzebujesz niestandardowej logiki. Fakturownia udostępnia dobrze udokumentowane API (token Bearer, JSON). Ma sens przy złożonych scenariuszach: faktury proforma przed płatnością, zestawy produktów z różnymi stawkami VAT, własna logika nadawania serii numerów. Oficjalna strona integracji: https://fakturownia.pl/apps/woocommerce_app.

Dla 90% sklepów plugin WP Desk jest właściwym wyborem. Poniższe kroki dotyczą tej ścieżki.

Konfiguracja krok po kroku

1. Pobierz i aktywuj plugin

W panelu WordPress przejdź do Wtyczki, kliknij Dodaj nową, wpisz "Fakturownia WooCommerce" i zainstaluj wtyczkę od WP Desk. Po aktywacji nowe menu pojawi się w WooCommerce.

2. Zdobądź klucz API Fakturowni

Zaloguj się do swojego konta Fakturownia.pl. Wejdź w Ustawienia, kliknij Ustawienia konta, a następnie zakładkę Integracja. Tam znajdziesz Kod autoryzacyjny API - to długi ciąg znaków wyglądający jak twojlogin/abc123xyz.... Skopiuj go.

3. Wklej klucz w pluginie

W panelu WordPress przejdź do WooCommerce, wybierz Ustawienia, zakładkę Integracje i kliknij Fakturownia. W polu API Token wklej skopiowany kod autoryzacyjny. Zapisz ustawienia.

4. Zdecyduj, kiedy wystawiać fakturę

To jest najważniejsza decyzja konfiguracyjna. Plugin pozwala wybrać, po jakim statusie zamówienia faktura ma być wystawiana. Typowe opcje:

• Opłacone (processing) - faktura wystawiana natychmiast po potwierdzeniu płatności. Dobry wybór dla sklepów z produktami cyfrowymi.
• Skompletowane (completed) - faktura po wysyłce towaru. Bezpieczniejsze podatkowo przy sprzedaży fizycznej.
• Oba - wystawiasz proformę przy opłaceniu, właściwą fakturę przy skompletowaniu.

U klienta sprzedającego meble dziecięce (zulakids.de) używam statusu "completed", bo zamówienia często mają kilkudniowy czas realizacji i chcę, żeby data faktury pokrywała się z datą realnej dostawy.

5. Ustaw typ dokumentu

Plugin pozwala skonfigurować, czy domyślnie wystawiasz faktury czy paragony. Jeśli chcesz, żeby system sam decydował na podstawie tego, czy klient podał NIP - włącz opcję "Faktura dla firm, paragon dla konsumentów". Wymaga to, żeby w formularzu zamówienia WooCommerce były widoczne pola NIP i nazwa firmy (można to ustawić przez Germanized, WooCommerce B2B lub dedykowany plugin do pól zamówienia).

6. Skonfiguruj dane sprzedawcy i stopkę faktury

Dane sprzedawcy (NIP, adres, numer konta) pobierane są z profilu firmy w Fakturowni - upewnij się, że są aktualne i kompletne. W ustawieniach pluginu możesz też dodać dodatkowe informacje na fakturze: termin płatności, uwagi, numer zamówienia WooCommerce jako referencję.

Numeracja faktur - jak to zorganizować

Fakturownia umożliwia definiowanie własnych schematów numeracji. Domyślnie faktury numerowane są jako NUMER/ROK (np. 1/2026, 2/2026...). Dla sklepów warto rozważyć dodanie prefiksu identyfikującego kanał sprzedaży.

Jeśli prowadzisz kilka sklepów lub kilka działalności, możesz stworzyć serie numerów: np. WEB/NUMER/ROK dla WooCommerce i BOK/NUMER/ROK dla faktur wystawianych ręcznie przez biuro. Serie konfiguruje się w Ustawieniach Fakturowni w sekcji Numeracja. Plugin pozwala wybrać w ustawieniach, która seria ma być używana dla faktur z WooCommerce.

Eksport do ksiegowej - CSV, XLS i JPK_FA

Ksiegowa nie chce logować się do twojego panelu WooCommerce. Chce plik. Fakturownia daje kilka opcji eksportu, z których wszystkie można uruchomić z menu Faktury w panelu.

CSV i XLS - filtruj po zakresie dat i typie dokumentu, pobierz plik. CSV jest idealny do importu do każdego programu ksiegowego lub arkusza kalkulacyjnego. Kolumny obejmują numer faktury, datę, dane nabywcy, wartości netto/brutto/VAT, numery NIP.

JPK_FA - Jednolity Plik Kontrolny w formacie XML. To oficjalny format wymagany przez polskie organy podatkowe. Z panelu Fakturowni pobierzesz go w kilka sekund i możesz przekazać ksiegowej lub przesłać do US na żądanie. WP Desk ma też oddzielny plugin "Zaawansowane Raporty dla Faktur WooCommerce" z bardziej rozbudowanymi opcjami eksportu.

Cykliczny raport e-mail - w Fakturowni można skonfigurować automatyczne wysyłanie zestawienia faktur na adres ksiegowej co miesiąc lub co kwartał. Dla małych sklepów to wygodna opcja, żeby nie musieć pamiętać o pobieraniu pliku.

KSeF 2026 - co zmienia się dla sklepu WooCommerce

Od 1 lutego 2026 roku KSeF jest obowiązkowy dla największych podatników VAT. Od 1 kwietnia 2026 roku obejmuje wszystkich czynnych podatników VAT - w tym właścicieli sklepów WooCommerce sprzedających w modelu B2B. To oznacza, że faktury wystawiane firmom muszą trafić do Krajowego Systemu e-Faktur i dostać numer KSeF, zanim zostaną przekazane nabywcy.

Fakturownia obsługuje KSeF 2.0 i jest zintegrowana z systemem Ministerstwa Finansów. W integracji z WooCommerce mechanizm wygląda tak: po spełnieniu warunku (status zamówienia), plugin wywołuje Fakturownię, ta tworzy fakturę ustrukturyzowaną i przesyła do KSeF. E-mail z PDF do klienta jest wysyłany dopiero po otrzymaniu numeru KSeF - lub po oznaczeniu dokumentu w trybie offline (np. gdy KSeF jest niedostępny).

Sprzedaż konsumentom (B2C) pozostaje poza obowiązkowym KSeF - w tym przypadku wystawiasz paragon lub fakturę na życzenie klienta, ale nie musisz wysyłać jej do KSeF.

Jeśli zbuduję ci sklep WooCommerce w ramach usługi sklepy internetowe, zawsze omawiam kwestię KSeF i konfigurację Fakturowni razem - bo lepiej zrobić to raz porządnie niż naprawiać pół roku po starcie.

Czeste błedy i jak ich unikać

Błąd połączenia z API WooCommerce

Najczęstszy problem przy pierwszej konfiguracji. Fakturownia nie może pobrać danych zamówienia. Przyczyny:

• Permalinki ustawione na "zwykły" (domyślny) - zmień na np. "Nazwa wpisu" w Ustawienia, Bezposrednie odnośniki
• Legacy REST API wyłączone w WooCommerce - włącz je w WooCommerce, Ustawienia, Zaawansowane, Legacy API
• Klucze REST API WooCommerce nieprawidłowe lub nieaktywne - wygeneruj nowe w WooCommerce, Ustawienia, Zaawansowane, REST API

Podwójne faktury

Zdarzają się, gdy webhook jest wywoływany dwukrotnie (np. przez wtyczkę cache'ującą lub błąd sieciowy). W ustawieniach pluginu WP Desk włącz ochronę przed duplikatami. W Fakturowni możesz też sprawdzić logi dokumentów - duplikat będzie widoczny jako drugi dokument z identycznym numerem zamówienia w opisie.

GTU kody nie trafiają na fakturę

Kody GTU (grupy towarów i usług) należy przypisywać w Fakturowni na kartotece produktu, a nie w WooCommerce. Nawet jeśli plugin GTU for Flexible Invoices oznaczy produkty w WooCommerce, te tagi nie są automatycznie przekazywane do Fakturowni przez REST API. Poprawna procedura: zsynchronizuj produkty raz, potem w Fakturowni przypisz GTU do każdej pozycji.

Data faktury niezgodna z datą opłacenia

Jeśli wystawiasz fakturę po statusie "skompletowane", a zamówienie czeka kilka dni na wysyłkę, data faktury będzie późniejsza niż data płatności. To może być zgodne z przepisami (faktura powinna być wystawiona do 15. dnia miesiąca następującego po miesiącu dostawy), ale warto omówić z ksiegową, który model jest właściwy dla twojego sklepu.

Cennik Fakturowni - co wybrać dla sklepu

Fakturownia oferuje plan bezpłatny Micro (do 3 faktur miesięcznie) oraz płatne plany abonamentowe rozliczane z góry za min. 6 miesięcy. Plan Start kosztuje ok. 9,99 zł miesięcznie przy rozliczeniu rocznym (najtańszy płatny), Standard to ok. 22,77 zł miesięcznie. Plan Pro Plus - najbardziej rozbudowany - kosztuje ok. 83,46 zł miesięcznie i obsługuje do 10 użytkowników. Dodatkowe bloki po 5 użytkowników kosztują 49,99 zł miesięcznie.

Dla typowego sklepu WooCommerce z kilkunastoma zamówieniami dziennie wystarczy plan Standard lub Pro - zapewniają nieograniczoną liczbę dokumentów i obsługę wielu firm. Porównując z alternatywami: wFirma i iFirma mają zbliżone cenniki, ale Fakturownia ma szerszą listę bezpośrednich integracji z platformami e-commerce - WooCommerce, Shoper, Allegro, BaseLinker, PrestaShop, Shopify, CS-Cart i Selly Shop.

Alternatywy i kiedy wybrać inne rozwiązanie

Fakturownia to mój domyślny wybór dla sklepów WooCommerce, ale nie jedyna opcja. Warto wiedzieć, kiedy patrzeć gdzie indziej.

wFirma - dobry wybór, jeśli klient sam prowadzi pełną ksiegowość i chce mieć faktury, kadry, rozliczenia ZUS i US w jednym miejscu. Integracja z WooCommerce działa, KSeF obsługiwane bez dodatkowych kroków. Cennik zbliżony do Fakturowni.

iFirma - popularna wśród freelancerów i JDG, integracja z WooCommerce istnieje, ale jest mniej rozbudowana niż Fakturowni. Wybierz iFirmę, jeśli klient już z niej korzysta i nie chce zmieniać.

Flexible Invoices (WP Desk, standalone) - wtyczka generująca faktury bezpośrednio w WooCommerce, bez zewnętrznego systemu. Dobra, jeśli klient nie chce płacić za SaaS i wystarczają mu podstawowe funkcje. Minusy: brak pełnego eksportu ksiegowego, KSeF jako osobny addon, ograniczone raporty.

Czytaj też: kompletny przewodnik po WooCommerce na 2026 rok i jak przygotować sklep na e-faktury KSeF.

Jeśli przenosisz sklep z Shopera na WooCommerce, temat integracji z Fakturownią warto omówić przy migracji - szczegóły o samym procesie znajdziesz w artykule o migracji Shoper do WooCommerce.

Synchronizacja stanów magazynowych

Jedna z mniej oczywistych funkcji integracji: dokumenty sprzedaży z WooCommerce mogą automatycznie aktualizować stan magazynowy w Fakturowni. Działa to jednostronnie - zamówienie w WooCommerce pomniejsza magazyn w Fakturowni. Odwrotna synchronizacja (stan magazynowy Fakturowni do WooCommerce) nie jest dostępna automatycznie.

Praktyczne zastosowanie: jeśli korzystasz z Fakturowni jako podstawy do rozliczeń magazynowych i chcesz mieć spójne dane zarówno dla księgowości, jak i dla sklepu, musisz albo prowadzić stany magazynowe tylko po stronie WooCommerce (polecam dla sklepów), albo zsynchronizować produkty raz przy uruchomieniu i traktować Fakturownię wyłącznie jako system fakturowania.

Testowanie przed startem - co sprawdzić

Zanim włączysz automatyczne fakturowanie na produkcji, przeprowadź kilka testów w trybie testowym lub na zamówieniu o wartości 1 zł:

Po pierwsze, złóż zamówienie testowe w sklepie i sprawdź, czy faktura pojawia się w panelu Fakturowni w ciągu minuty. Po drugie, sprawdź czy e-mail z fakturą dotarł na adres klienta testowego z poprawnym PDF-em. Po trzecie, otwórz PDF i sprawdź dane sprzedawcy, numer NIP, stawkę VAT i numer dokumentu. Po czwarte, wyeksportuj fakturę testową do CSV i otwórz w Excelu - sprawdź, czy kolumny są czytelne. Po piąte, jeśli używasz KSeF, sprawdź w panelu Fakturowni, czy dokument dostał numer KSeF.

U klienta z branży tekstylnej, który miał sklep z ok. 80 zamówieniami dziennie, testy zajęły nam popołudnie. Okazało się, że permalink był ustawiony na domyślny i cała integracja nie działała przez ten drobiazg. Teraz zawsze sprawdzam to jako pierwsze.

Jeśli potrzebujesz pomocy przy wdrożeniu lub masz niestandardowe wymagania (kilka sklepów, OSS, faktury wielowalutowe), napisz przez formularz kontaktowy albo wejdź na stronę usług sklepów internetowych i opisz projekt.

Najczęstsze pytania

Czy Fakturownia WooCommerce integracja jest bezplatna?

Sam plugin WP Desk do pobrania z repozytorium WordPress jest bezplatny. Platforma Fakturownia ma darmowy plan Micro (do 3 faktur miesiecznie), ale sklep produkcyjny potrzebuje platnego abonamentu - najtanszy plan Start kosztuje ok. 9,99 zl miesiecznie przy rozliczeniu rocznym. Do 30 dni mozna testowac kazdy plan bez podawania danych platnosci.

Jak czesto Fakturownia synchronizuje dane z WooCommerce?

Synchronizacja odbywa sie w czasie rzeczywistym przez webhook - faktura jest wystawiana natychmiast po spelnieniu warunku (np. zmianie statusu zamowienia na oplacone). Nie ma cyklicznego harmonogramu; jesli webhook nie dotrze, mozna recznie wyzwolic wystawienie faktury z poziomu panelu zamowien WooCommerce.

Czy moge wystawiac faktury tylko dla firm (NIP), a paragony dla osob prywatnych?

Tak - integracja wykrywa, czy klient podal NIP i nazwe firmy w zamowieniu. Jesli oba pola sa wypelnione, system wystawia fakture VAT; jesli brakuje NIPu, wystawia paragon. Wymaga to odpowiedniego formularza zamowienia w WooCommerce - checkbox lub pole NIP musi byc widoczne i przekazywane do pluginu.

Co z KSeF - czy Fakturownia obsluguje obowiazkowe e-faktury od 2026?

Tak, Fakturownia jest gotowa na KSeF 2.0. Obsluguje wysylke ustrukturyzowanych faktur do Krajowego Systemu e-Faktur, pobieranie faktur zakupowych i monitorowanie statusu. W integracji z WooCommerce e-mail z faktura jest wysylany do klienta dopiero po nadaniu numeru KSeF lub oznaczeniu w trybie offline. Jestem developerem, nie ksiegowym - kwestie prawne KSeF warto omowic z doradca podatkowym.

Czy moge uzywac Fakturowni dla kilku sklepow WooCommerce?

Tak, jeden plan Fakturowni moze obslugiwac kilka integraciach e-commerce. Kazdy sklep podlacza sie oddzielnym zestawem kluczy REST API WooCommerce, a faktury moga miec oddzielna serie numeracji (np. WEB1/2026, WEB2/2026). Plan Standard i wyzsze obsluguja zarzadzanie kilkoma firmami lub podmiotami w jednym koncie.

Jak wyeksportowac faktury do ksiegowej?

Z panelu Fakturowni mozna pobrac zestawienie faktur w formatach CSV, XLS, PDF zbiorczy lub JPK_FA - ten ostatni jest bezposrednio gotowy do przekazania ksiegowej lub dostarczenia do US na zadanie. Eksport filtrujesz po zakresie dat, statusie i typie dokumentu. Mozna tez skonfigurowac cykliczne wysylanie raportu emailem.

Wtyczka WP Desk czy integracja bezposrednia z API - co wybrac?

Dla wiekszosci sklepow wtyczka WP Desk jest wystarczajaca i znacznie prostsza we wdrozeniu. Bezposrednia integracja przez Fakturownia REST API ma sens, jesli potrzebujesz niestandardowej logiki (np. faktury proforma przed platnoscia, zlozone zestawy produktow, kilka stawek VAT na jednym dokumencie) lub chcesz uniknac dodatkowej zaleznosci wtyczkowej. Obie sciezki sa oficjalnie wspierane przez Fakturownie.

Czy integracja dziala z zamowieniami platnosci odroczonej (Klarna, PayPo)?

Tak, ale trzeba uwazac na moment wystawienia faktury. Przy platnosci odroczonej klient nie placi od razu, wiec wystawienie faktury po statusie 'oplacone' moze nastapic z opoznieniem. Rekomenduje ustawienie wystawiania faktury po statusie 'skompletowane' (completed) lub dedykowanym statusie po potwierdzeniu platnosci od Klarna/PayPo, zeby data faktury zgadzala sie z realna data rozliczenia.