Integracja WooCommerce z Fakturownia - faktury, korekty i paragony krok po kroku
Technical Implementation Expert
Integracja WooCommerce z Fakturownia - faktury, korekty i paragony krok po kroku
Integracja WooCommerce z Fakturownia polega na połączeniu sklepu z kontem Fakturowni przez klucz API, tak aby faktury, paragony i korekty powstawały na podstawie zamówień bez przepisywania danych. Fakturownia oferuje własny moduł do WooCommerce, który tworzy faktury do zamówień i wysyła dokumenty klientom przy zmianie statusu, a rozbudowane wtyczki dodają wybór statusu, szablony z serią numeracji, paragony i faktury korygujące. Konfiguracja zajmuje zwykle kilka godzin razem z testami.
Fakturownia to jeden z popularniejszych programów do fakturowania w polskim e-commerce. Sama integracja to jednak nie tylko wklejenie klucza API. Trzeba zdecydować, jaki dokument dostaje konsument, a jaki firma, jak numerować dokumenty ze sklepu, co dzieje się przy zwrocie i jak to wszystko ma się do KSeF. W tym wpisie przechodzimy przez konfigurację krok po kroku: od wyboru wtyczki, przez numerację i szablony, po korekty przy zwrotach.
[#wazne] W skrócie: integrację WooCommerce z Fakturownia zrobisz modułem Fakturowni, płatną wtyczką lub przez Base. Po podaniu klucza API ustawiasz status zamówienia, przy którym powstaje dokument, mapujesz stawki VAT, wybierasz szablon i serię numeracji, a na koniec ustalasz obsługę korekt przy zwrotach. W Vinson budujemy i rozwijamy sklepy na WooCommerce oraz wdrażamy integracje z programami do faktur i z Base.
Jak działa integracja WooCommerce z Fakturownia
Integracja WooCommerce z Fakturownia to wymiana danych przez API Fakturowni. Klucz API to unikalny ciąg znaków wygenerowany w ustawieniach konta Fakturowni, który pozwala sklepowi tworzyć dokumenty w Twoim imieniu. Sklep przesyła dane nabywcy, pozycje zamówienia, ceny, stawki VAT i metodę płatności, a Fakturownia tworzy dokument według wybranego szablonu. Klucza API nie udostępniaj nikomu poza osobami konfigurującymi integrację, bo daje dostęp do Twoich dokumentów.
Do wyboru masz trzy rozwiązania, które różnią się zakresem funkcji:
Moduł Fakturowni do WooCommerce - według opisu Fakturowni do instalacji wystarczy adres sklepu i klucz API. Moduł automatycznie tworzy faktury do zamówień i może wysyłać dokumenty klientowi przy zmianie statusu zamówienia.
Płatna wtyczka do WooCommerce - np. Fakturownia WooCommerce od WP Desk, za ok. 229 zł netto za licencję na jeden sklep (stan na czerwiec 2026 - sprawdź aktualny cennik). Według producenta pozwala wybrać status dla automatycznych dokumentów, wystawiać faktury VAT, korygujące, proforma, rachunki i paragony oraz korzystać z szablonów z serią numeracji.
Integracja przez Base - zamówienia ze sklepu i marketplace'ów trafiają do Base, a dokumenty w Fakturowni wystawiają akcje automatyczne.
Moduł Fakturowni wystarczy, gdy potrzebujesz prostych faktur do zamówień. Wtyczka sprawdzi się, gdy chcesz kontrolować status, szablony i rodzaje dokumentów bezpośrednio w WooCommerce. Base wybierz, gdy sprzedajesz także na Allegro i chcesz wystawiać dokumenty dla wszystkich kanałów w jednym miejscu.
Konfiguracja integracji WooCommerce z Fakturownia krok po kroku
Niezależnie od wybranego rozwiązania kolejność prac jest podobna. Zacznij od ustawień w Fakturowni, bo integracja korzysta z danych firmy, numeracji i szablonów, które tam zdefiniujesz:
[#chart:woo34a]
Pierwsze kroki wykonujesz raz, ale testy powtarzaj po każdej większej aktualizacji WooCommerce, motywu lub wtyczki integracji. Zmiana w checkoucie potrafi np. przestać przekazywać numer NIP, a sklep zorientuje się dopiero po skardze klienta, który dostał fakturę na osobę prywatną.
Numeracja i szablony dokumentów
Przepisy nie narzucają jednego formatu numeru faktury, ale numeracja musi być kolejna i jednoznacznie identyfikować dokument. Wiele sklepów wydziela osobną serię dla dokumentów ze sklepu internetowego, np. z prefiksem, żeby łatwo odróżnić je od faktur wystawianych ręcznie. W Fakturowni możesz korzystać z działów, a każdy dział może mieć własną numerację. To wygodne, gdy prowadzisz kilka sklepów lub marek na jednej firmie i chcesz, by dokumenty każdego sklepu miały własną serię i dane.
| Ustawienie | Gdzie | Na co zwrócić uwagę |
|---|---|---|
| Dane firmy i konto bankowe | Ustawienia konta Fakturowni | Zgodne z danymi w regulaminie sklepu |
| Seria numeracji | Fakturownia, szablon lub dział | Osobna seria dla sklepu ułatwia kontrolę |
| Klucz API | Ustawienia konta Fakturowni | Przechowuj bezpiecznie, nie wysyłaj e-mailem |
| Status dla dokumentów | Ustawienia wtyczki w WooCommerce | Uzgodniony z księgowym |
| Mapowanie stawek VAT | Klasy podatkowe WooCommerce i wtyczka | Osobno dla wysyłki i opłat |
| Wysyłka do klienta | Wtyczka lub Fakturownia | Jeden kanał, żeby klient nie dostał dwóch e-maili |
Status zamówienia, który uruchamia dokument
W WooCommerce zamówienie przechodzi przez statusy, m.in. „Oczekujące na płatność”, „W trakcie realizacji”, „Wstrzymane”, „Zrealizowane”, „Anulowane” i „Zwrócone”. Dokument najczęściej wystawia się przy statusie „W trakcie realizacji”, czyli po zaksięgowaniu płatności online, albo przy „Zrealizowane”, czyli po wysyłce. Przy płatności za pobraniem zamówienie trafia do realizacji przed zapłatą, więc ustal z księgowym, czy faktura ma powstać przy wysyłce, czy po rozliczeniu pobrania. Jedno jest pewne: nie ustawiaj wystawiania na status oczekujący na płatność, bo dokumenty powstaną także do zamówień, których klient nigdy nie opłaci.
Dane nabywcy i pole NIP
WooCommerce nie ma w standardzie pola NIP, więc dodaje je wtyczka integracji albo wtyczka do pól zamówienia. Dobrą praktyką jest pole wyboru „Chcę fakturę na firmę”, które dopiero po zaznaczeniu pokazuje pola nazwy firmy i NIP. Konsument nie widzi wtedy zbędnych pól, a firma podaje wszystko, czego potrzebuje faktura. Sprawdź, czy rozwiązanie działa w blokowym checkoucie i czy NIP trafia do zamówienia oraz do dokumentu w Fakturowni.
- Przegląd sklepu, wtyczek i wydajności
- Płatności, wysyłki i integracje
- Plan rozwoju sklepu
Konsultację poprowadzi Łukasz Palej, Technical Implementation ExpertFaktury, paragony i proformy z WooCommerce w Fakturowni
Sklep internetowy wystawia różne dokumenty w zależności od tego, kto kupuje i jak płaci. Zanim ustawisz automat, ustal z księgowym, który dokument powstaje w jakiej sytuacji. Poniżej rodzaje dokumentów, które obsługują rozbudowane integracje z Fakturownią:
[#chart:woo34b]
Najprostszy podział wygląda tak: firma z NIP dostaje fakturę VAT, konsument dostaje dokument zgodny z przyjętym sposobem ewidencji sprzedaży, a fakturę tylko na żądanie. Sprzedawca zwolniony z VAT wystawia fakturę bez VAT z podstawą zwolnienia albo rachunek. Proforma przydaje się przy płatności przelewem tradycyjnym, zwłaszcza dla firm, które przed zapłatą potrzebują dokumentu do akceptacji.
Paragony z zamówień WooCommerce
Paragon fiskalny wymaga kasy lub drukarki fiskalnej, więc sama integracja z programem do faktur nie wystarczy. Wtyczki do Fakturowni mogą wystawiać paragony jako dokumenty w Fakturowni, ale to, czy potrzebujesz paragonów fiskalnych, zależy od sposobu ewidencji sprzedaży konsumentom w Twojej firmie. Przy sprzedaży wysyłkowej część firm korzysta ze zwolnienia z kasy fiskalnej, gdy zapłata wpływa na rachunek bankowy, a ewidencja pozwala zidentyfikować transakcję (stan na czerwiec 2026 - sprawdź aktualne przepisy). Zanim włączysz paragony w integracji, potwierdź z księgowym, który wariant dotyczy Twojego sklepu.
Korekty przy zwrotach w integracji WooCommerce z Fakturownia
Zwrot towaru po wystawieniu faktury wymaga faktury korygującej. W WooCommerce zwrot wykonujesz w edycji zamówienia: dla całego zamówienia albo dla wybranych pozycji i kwot. Integracja, która obsługuje korekty, wykorzystuje te dane do wystawienia korekty w Fakturowni. Jeśli Twoja wtyczka tego nie robi, korekty wystawiasz ręcznie, a w WooCommerce zostawiasz ich numer w notatce zamówienia.
Przyjmij zwrot i sprawdź stan towaru.
Wykonaj zwrot pieniędzy w edycji zamówienia WooCommerce, z wyborem pozycji i kosztu dostawy.
Sprawdź, czy integracja utworzyła korektę w Fakturowni, albo wystaw ją ręcznie.
Upewnij się, że korekta odnosi się do właściwej faktury pierwotnej.
Wyślij korektę klientowi i zapisz jej numer w zamówieniu.
Przy fakturach wystawionych w KSeF korekta również powstaje jako faktura ustrukturyzowana. Od 1 kwietnia 2026 r. obowiązek KSeF objął większość firm, a najmniejsi podatnicy mają okres przejściowy do końca 2026 r. (stan na czerwiec 2026 - sprawdź aktualne przepisy). Integracja przekazuje dane do Fakturowni, a wysyłkę do KSeF realizuje program, dlatego sprawdź, czy masz ją włączoną i jak Fakturownia obsługuje korekty faktur z KSeF.
[#uwaga] Nie usuwaj faktury w Fakturowni, gdy klient zwraca towar albo zamówienie zostaje anulowane po wystawieniu dokumentu. Dokument wystawiony i przekazany klientowi, a tym bardziej przesłany do KSeF, koryguje się fakturą korygującą. Usunięcie dokumentu robi lukę w numeracji i rozjeżdża dane między sklepem a księgowością. Jeśli nie masz pewności, jak skorygować konkretny dokument, zapytaj księgowego, zanim cokolwiek zmienisz w Fakturowni.
Jak mierzyć liczbę korekt
Liczba korekt to dobry wskaźnik jakości integracji i obsługi zamówień. Jeśli rośnie, przyczyną bywa zbyt wczesny status wystawiania faktur, błędne stawki VAT albo dużo zwrotów w jednej kategorii. Wskaźnik łatwo policzyć z zestawienia dokumentów w Fakturowni:
[#chart:woo34c]
Sprawdzaj go co miesiąc i porównuj z liczbą zwrotów w WooCommerce. Jeśli korekt jest wyraźnie więcej niż zwrotów, część z nich nie wynika ze zwrotów, tylko z błędów w danych, np. pustego NIP, złej stawki VAT dla wysyłki albo faktur wystawionych do zamówień, które potem anulowano.
Integracja WooCommerce z Fakturownia przy subskrypcjach i produktach cyfrowych
Przy subskrypcjach każde odnowienie tworzy w WooCommerce nowe zamówienie, więc integracja wystawia dokument dla każdego okresu rozliczeniowego. Sprawdź, czy wtyczka obsługuje zamówienia odnowień i czy nie wystawia dokumentów do nieudanych płatności. Zasady planowania abonamentów opisujemy we wpisie
Przy produktach cyfrowych dochodzą stawki VAT dla klientów z innych krajów UE i procedura OSS. Wtyczka musi umieć wystawić dokument ze stawką kraju klienta, jeśli przekroczyłeś łączny próg 10 000 euro rocznie. Więcej o fakturach i VAT przy plikach do pobrania piszemy w artykule
Najczęstsze błędy przy integracji WooCommerce z Fakturownia
Integracje z programami do faktur psują się zwykle w tych samych miejscach. Przed uruchomieniem automatu sprawdź listę:
dwie integracje naraz, np. moduł Fakturowni i wtyczka albo wtyczka i Base, co daje podwójne dokumenty,
brak mapowania klas podatkowych, przez co produkty z 8% lub 5% dostają 23%,
pole NIP, które nie działa w blokowym checkoucie,
status wystawiania ustawiony na „Oczekujące na płatność”, co tworzy dokumenty do nieopłaconych zamówień,
wysyłka dokumentu do klienta jednocześnie z wtyczki i z Fakturowni.
[#tip] Po każdej aktualizacji WooCommerce lub wtyczki integracji złóż jedno testowe zamówienie na firmę i jedno na osobę prywatną, a potem sprawdź dokumenty w Fakturowni. Taki test zajmuje kilka minut i wyłapuje większość problemów, zanim zauważy je klient albo księgowa przy zamknięciu miesiąca.
Fakturownia, WooCommerce i Allegro - jedno źródło dokumentów
Gdy sprzedajesz jednocześnie w sklepie WooCommerce i na Allegro, łatwo skończyć z dwiema integracjami: wtyczką w sklepie i osobnym połączeniem marketplace'u z Fakturownią. Każda ma własne ustawienia stawek, statusów i numeracji, a księgowa dostaje dokumenty z dwóch źródeł. Prostszy układ to jedno miejsce, które wystawia dokumenty dla wszystkich kanałów, np. Base. Zamówienia ze sklepu i z Allegro trafiają do jednego panelu, a akcje automatyczne wystawiają faktury lub paragony w Fakturowni według wspólnych reguł.
Przechodząc na taki układ, wyłącz wcześniejsze wystawianie dokumentów w sklepie i ustal datę, od której dokumenty powstają w nowym miejscu. Zamówienia złożone przed tą datą dokończ starą metodą, żeby żadne nie zostało bez dokumentu ani nie dostało dwóch.
Jak Vinson pomaga zintegrować WooCommerce z Fakturownia
Vinson to agencja e-commerce z Bochni, działająca od 2021 roku. Jesteśmy certyfikowanym partnerem Base, Allegro Ads Partner+, Google Partner i Meta Business Partner. Współpracowaliśmy z ponad 500 firmami, a klienci oceniają nas na 4,9/5 ze 171 opinii. Budujemy i rozwijamy sklepy na WooCommerce, a przy integracji z Fakturownią dobieramy rozwiązanie do skali sprzedaży, konfigurujemy statusy, stawki VAT i numerację, dodajemy pole NIP zgodne z blokowym checkoutem i testujemy zwroty z korektami. Gdy sprzedajesz też na Allegro, łączymy sklep i Fakturownię przez
Najczęściej zadawane pytania
Jak połączyć WooCommerce z Fakturownią?
Potrzebujesz modułu Fakturowni, wtyczki do WooCommerce albo integracji przez Base oraz klucza API z ustawień konta Fakturowni. Po podaniu klucza ustawiasz status zamówienia, przy którym powstaje dokument, mapujesz stawki VAT i wybierasz szablon. Przed startem przetestuj kilka zamówień z różnymi scenariuszami.
Czy integracja z Fakturownią wystawia faktury korygujące?
Zależy od rozwiązania. Rozbudowane wtyczki do WooCommerce obsługują faktury korygujące, a prostsze integracje tworzą tylko faktury do zamówień. Jeśli Twoja integracja nie robi korekt automatycznie, wystawiasz je ręcznie w Fakturowni po zwrocie wykonanym w WooCommerce.
Czy Fakturownia może wystawiać paragony do zamówień z WooCommerce?
Niektóre wtyczki integrujące WooCommerce z Fakturownią wystawiają paragony jako dokumenty w programie. Paragon fiskalny wymaga jednak kasy lub drukarki fiskalnej. Czy potrzebujesz paragonów fiskalnych, zależy od sposobu ewidencji sprzedaży konsumentom, który ustalasz z księgowym.
Jak ustawić osobną numerację faktur dla sklepu internetowego?
W Fakturowni możesz ustawić serię numeracji w szablonie dokumentu lub skorzystać z działów, z których każdy może mieć własną numerację. Osobna seria dla sklepu ułatwia kontrolę dokumentów z integracji. Numeracja musi pozostać kolejna i jednoznaczna.
Co zrobić, gdy integracja wystawiła dwie faktury do jednego zamówienia?
Najpierw sprawdź, czy nie działają dwie integracje jednocześnie lub czy zamówienie nie wróciło do statusu, który uruchamia wystawianie. Zbędny dokument skoryguj zgodnie z zaleceniem księgowego, zamiast go usuwać. Potem wyłącz drugie źródło dokumentów i zostaw jeden status wyzwalający.
Dobrze ustawiona integracja WooCommerce z Fakturownią oszczędza codzienną pracę i ogranicza liczbę korekt. Jeśli chcesz ją wdrożyć razem z KSeF, paragonami i obsługą zwrotów, sprawdź
Łukasz Palej
Technical Implementation Expert
Sklep na WooCommerce z Vinson
Łukasz i nasz zespół pomogą Ci wdrożyć to na Twoim koncie - bez zobowiązań.
- Analiza Twojego konta i obecnych działań
- Konkretny plan poprawek do wdrożenia
- Bezpłatna konsultacja – bez zobowiązań
Przeczytaj także
Więcej porad z naszej bazy wiedzy - przesuń, aby zobaczyć kolejne artykuły.
Wybierz dogodny termin w kalendarzu - bez wymiany maili w tę i z powrotem.