Integracje WooCommerce z księgowością i Base — wFirma, Fakturownia, IFIRMA

Ręczne przepisywanie danych z WooCommerce do programu księgowego działa, dopóki sklep ma kilka zamówień dziennie. Przy 30, 100 albo 300 zamówieniach zaczynają pojawiać się pomyłki: zły NIP, brak faktury, podwójny dokument, niezgodna kwota lub korekta, o której księgowość dowiaduje się po kilku tygodniach.

Integracja pozwala automatycznie przekazać dane zamówienia do wFirmy, Fakturowni albo IFIRMY. Można zrobić to bezpośrednio z WooCommerce lub przez Base, czyli system znany wcześniej jako BaseLinker.

Nie zawsze bardziej rozbudowany wariant jest lepszy. Sklep działający tylko na WooCommerce może potrzebować prostego połączenia z Fakturownią. Firma sprzedająca również na Allegro, Amazonie lub kilku sklepach zwykle skorzysta bardziej na centralnej obsłudze przez Base.

W tym poradniku pokazujemy, jak wybrać właściwą architekturę, jakie dane synchronizować, co może się zepsuć i jak przetestować integrację przed uruchomieniem. Przy bardziej niestandardowym procesie potrzebne mogą być dedykowane integracje systemów.

Odpowiedź wprost: WooCommerce możesz połączyć bezpośrednio z wFirmą, Fakturownią lub IFIRMĄ albo przekazywać zamówienia najpierw do Base, a dopiero później do księgowości. Połączenie bezpośrednie jest prostsze przy jednym sklepie. Base lepiej sprawdza się wtedy, gdy obsługujesz kilka kanałów sprzedaży, magazyn, kurierów i marketplace'y.

KSeF, czyli Krajowy System e-Faktur, to rządowa platforma służąca do wystawiania i odbierania faktur ustrukturyzowanych. Dlatego w 2026 roku integracja powinna uwzględniać nie tylko generowanie pliku PDF, ale również poprawny obieg dokumentu między sklepem, programem księgowym i KSeF.

W skrócie (TL;DR)

• Integracja może automatycznie tworzyć faktury, przesyłać je klientowi i przekazywać dane do księgowości.
• Przy jednym sklepie często wystarczy bezpośrednie połączenie WooCommerce z programem fakturowym.
• Przy wielu kanałach sprzedaży warto rozważyć przepływ WooCommerce → Base → księgowość.
• Trzeba wyznaczyć jeden system odpowiedzialny za numerację i wystawianie dokumentów.
• Najczęstsze błędy to podwójne faktury, zły moment wystawienia dokumentu i niezgodne SKU.
• Integracja powinna uwzględniać obieg dokumentów przez KSeF.
• Przed uruchomieniem trzeba przetestować płatność, anulowanie, zwrot, korektę i zamówienie firmowe.

Co daje integracja WooCommerce z księgowością?

Integracja przejmuje większość czynności, które bez niej trzeba wykonywać ręcznie po każdym zamówieniu.

Najprostszy proces bez integracji wygląda tak:

1. Klient składa zamówienie.
2. Pracownik otwiera WooCommerce.
3. Kopiuje dane klienta i produkty.
4. Loguje się do programu księgowego.
5. Wystawia dokument.
6. Pobiera PDF.
7. Wysyła fakturę klientowi.
8. Ręcznie oznacza zamówienie jako obsłużone.

Integracja może wykonać większość tych czynności automatycznie. Po zmianie statusu zamówienia (na przykład na „opłacone" albo „w realizacji") system może pobrać dane nabywcy, rozpoznać zamówienie firmowe po NIP-ie, utworzyć właściwy dokument, zastosować odpowiednią serię numeracji, przekazać pozycje, VAT, rabat i koszt dostawy, wysłać fakturę klientowi, zapisać numer dokumentu w zamówieniu, przekazać dokument do księgowości oraz uruchomić kolejne działania, na przykład przygotowanie przesyłki. Pracownik nadal powinien kontrolować wyjątki, ale nie musi ręcznie przepisywać każdego zamówienia.

Bezpośrednia integracja czy połączenie przez Base?

To najważniejsza decyzja przed wdrożeniem.

Wariant 1: WooCommerce łączy się bezpośrednio z księgowością. Schemat: WooCommerce → wFirma, Fakturownia albo IFIRMA → klient i KSeF. WooCommerce przekazuje dane bezpośrednio do wybranego programu. Integrację realizuje oficjalny moduł, wtyczka albo połączenie przez API. API to techniczny sposób, w jaki dwa systemy wymieniają dane bez ręcznego kopiowania — więcej o jego działaniu wyjaśniamy w artykule WooCommerce API — co to jest i do czego służy. Bezpośrednie połączenie zwykle wystarczy, gdy prowadzisz jeden sklep, nie sprzedajesz na wielu marketplace'ach, WooCommerce jest głównym źródłem zamówień, potrzebujesz przede wszystkim faktur i korekt, nie masz rozbudowanego procesu magazynowego, a pracownicy obsługują zamówienia w panelu WordPressa.

• Zalety: mniej systemów po drodze, prostsza konfiguracja, mniej miejsc, w których może wystąpić błąd, zwykle niższy koszt wdrożenia, łatwiejsze ustalenie źródła problemu.
• Ograniczenia: każde kolejne źródło zamówień wymaga osobnego połączenia, automatyzacje logistyczne mogą być ograniczone, trudniej centralnie obsługiwać kilka sklepów i marketplace'ów, funkcje zależą od możliwości konkretnej wtyczki lub API.

Wariant 2: WooCommerce łączy się z księgowością przez Base. Schemat: WooCommerce + Allegro + inne kanały → Base → księgowość → klient i KSeF. Base staje się centralnym miejscem obsługi zamówień: pobiera sprzedaż z WooCommerce i marketplace'ów, a następnie uruchamia ustalone działania — może na przykład pobrać zamówienie z WooCommerce, przypisać je do odpowiedniego statusu, utworzyć dokument sprzedażowy, przekazać dane do wFirmy/Fakturowni/IFIRMY, pobrać gotowy dokument PDF, wysłać fakturę do klienta, przygotować etykietę kurierską i zaktualizować status zamówienia. Ten wariant sprawdza się, gdy sprzedajesz przez WooCommerce i marketplace'y, masz więcej niż jeden sklep, zamówienia obsługuje kilka osób, chcesz centralnie zarządzać statusami, korzystasz z wielu magazynów, potrzebujesz automatyzacji wysyłki albo planujesz dalszy rozwój sprzedaży.

• Zalety: wszystkie zamówienia w jednym miejscu, jeden proces dla różnych kanałów, rozbudowane akcje automatyczne, łatwiejsza obsługa kurierów i marketplace'ów, centralne zarządzanie statusami oraz dokumentami.
• Ograniczenia: dodatkowy system i abonament, więcej ustawień do skonfigurowania, konieczność ustalenia, gdzie powstaje faktura, większe ryzyko duplikatów przy złej konfiguracji, bardziej złożone testy i obsługa błędów.

Najważniejsza zasada: wybierz jedno źródło prawdy

Źródło prawdy to system, którego dane uznajesz za nadrzędne.

Trzeba jednoznacznie określić, gdzie powstaje numer faktury, który system przechowuje właściwy dokument, skąd pobierany jest stan magazynowy, gdzie zmieniana jest cena, który status oznacza opłacone zamówienie, kto wysyła fakturę klientowi oraz który system przekazuje dokument do KSeF.

Jak działa integracja WooCommerce z Fakturownią?

Fakturownia ma bezpośrednią integrację z WooCommerce konfigurowaną z poziomu panelu systemu.

Połączenie korzysta z kluczy REST API wygenerowanych w WooCommerce. Po jego uruchomieniu można określić między innymi, przy jakim statusie ma powstać dokument, jaki rodzaj dokumentu wystawić, czy faktura ma zostać automatycznie wysłana, jak uwzględnić dostawę, czy tworzyć dokumenty dla zamówień na 0 zł, jak obsługiwać anulowanie i pełny zwrot oraz do jakiego działu przypisać sprzedaż. Fakturownia może też korzystać z kodów produktów, czyli SKU, do powiązania pozycji w obu systemach. SKU to wewnętrzny, unikalny kod produktu — przykładowo czarne krzesło w rozmiarze L może mieć kod KRZ-CZ-L. Ten sam kod powinien występować w WooCommerce i systemie magazynowym.

Synchronizacja magazynu w Fakturowni. Bezpośrednia integracja może aktualizować stany WooCommerce na podstawie magazynu w Fakturowni. Jest to synchronizacja jednostronna. Oznacza to, że przed jej uruchomieniem trzeba sprawdzić, który system jest głównym magazynem, czy wszystkie produkty mają poprawne SKU, czy warianty mają osobne kody, czy stany w Fakturowni są aktualne i co stanie się z produktami bez powiązania.

Kiedy Fakturownia będzie dobrym wyborem? Gdy zależy Ci głównie na fakturowaniu, prowadzisz jeden lub kilka sklepów WooCommerce, chcesz konfigurować dokumenty według statusów, potrzebujesz automatycznej wysyłki PDF, chcesz połączyć produkty po SKU i nie potrzebujesz rozbudowanego centrum obsługi marketplace.

Jak działa integracja WooCommerce z IFIRMĄ?

IFIRMA może pobierać z WooCommerce dane zamówień, klientów, produktów, kwot i statusów płatności, a na ich podstawie automatyzować wystawianie dokumentów oraz wysyłać je do klientów.

Ten wariant jest przydatny dla firm, które w jednym systemie chcą połączyć fakturowanie, obsługę księgową, ewidencję sprzedaży, przekazywanie dokumentów i dalszą pracę księgowości. Połączenie wymaga aktywnego konta i odpowiednich uprawnień API.

Co sprawdzić przed wdrożeniem IFIRMY? Czy NIP jest przekazywany z właściwego pola WooCommerce, jak rozpoznawany jest klient firmowy, jaki status zamówienia uruchamia wystawienie dokumentu, czy rabat i koszt dostawy trafiają na właściwe pozycje, jak system obsługuje różne stawki VAT, czy faktura jest automatycznie wysyłana klientowi, jak wykonywane są korekty, jak działa pełny i częściowy zwrot, czy warianty produktów są przekazywane z poprawnym SKU oraz czy wybrany pakiet IFIRMY obejmuje potrzebne funkcje. Warto również sprawdzić, czy integracja zapisuje numer dokumentu przy zamówieniu WooCommerce — dzięki temu obsługa sklepu może szybko ustalić, czy faktura została utworzona, bez logowania się do kilku systemów.

IFIRMA bezpośrednio czy przez Base? Bezpośrednie połączenie będzie prostsze, gdy WooCommerce jest jedynym źródłem sprzedaży. Base ma więcej sensu, gdy IFIRMA ma otrzymywać dokumenty również z Allegro, Amazonu, drugiego sklepu lub sprzedaży ręcznej. W wariancie z Base zamówienie trafia najpierw do centralnego panelu, a następnie Base przekazuje dane dokumentu do IFIRMY, pobiera gotowy plik albo zapisuje informacje potrzebne do dalszej obsługi. Nie należy zakładać, że każda integracja obsługuje identycznie paragony, korekty, częściowe zwroty, serie numeracji, waluty, zamówienia zagraniczne i kody SKU — zakres trzeba sprawdzić na konkretnym koncie i przetestować przed obsługą prawdziwych zamówień.

Kiedy IFIRMA będzie dobrym wyborem? Gdy firma korzysta już z księgowości lub fakturowania IFIRMA, chcesz ograniczyć ręczne przekazywanie dokumentów księgowej, zależy Ci na połączeniu faktur z dalszą ewidencją, sklep ma jeden główny kanał sprzedaży, a proces fakturowania nie wymaga wielu niestandardowych wyjątków.

Jak działa integracja WooCommerce z wFirmą?

WooCommerce można połączyć z wFirmą za pomocą wtyczki integracyjnej, API albo przez Base.

W zależności od wybranego rozwiązania możliwe jest między innymi tworzenie faktur, wystawianie proform, obsługa paragonów, przesyłanie danych nabywcy, przekazywanie produktów i stawek VAT, wysyłanie dokumentów do klienta oraz aktualizowanie informacji o płatności. Najważniejsze jest sprawdzenie, kto odpowiada za konkretną wtyczkę — część rozszerzeń WooCommerce jest rozwijana przez zewnętrzne firmy, a nie bezpośrednio przez producenta systemu księgowego. Przed zakupem wtyczki sprawdź datę ostatniej aktualizacji, zgodność z obecną wersją WordPressa i WooCommerce, obsługiwane wersje PHP, sposób uwierzytelniania API, zasady wsparcia technicznego, obsługę korekt i zwrotów, zgodność z KSeF oraz możliwość prowadzenia testów.

wFirma przez Base. Base może przekazywać dokumenty do wFirmy, pobierać gotowy dokument i używać go dalej w procesie obsługi zamówienia. W zależności od konfiguracji integracja może obsługiwać między innymi faktury i wybrane paragony, korekty, serie numeracji, typy płatności, przekazywanie SKU oraz scenariusze związane z OSS. OSS to uproszczony sposób rozliczania VAT przy sprzedaży konsumentom do innych krajów Unii Europejskiej. Dokładne ustawienia trzeba sprawdzić na konkretnym koncie i przetestować na rzeczywistych przykładach sprzedaży.

Czym dokładnie jest Base i kiedy warto go dodać?

Base, wcześniej działający pod nazwą BaseLinker, nie jest wyłącznie „wtyczką do Allegro".

To system, który może połączyć sklep WooCommerce, konta marketplace, magazyn, kurierów, księgowość, drukarki, komunikację e-mail i SMS, obsługę zwrotów oraz automatyczne akcje. Dla małego sklepu taki system może być niepotrzebnym dodatkowym elementem; dla firmy obsługującej kilkaset zamówień dziennie może stać się głównym centrum operacyjnym.

Porównanie integracji WooCommerce z księgowością

Rozwiązanie	Jak połączyć?	Dla kogo?	Na co uważać?
Fakturownia	bezpośrednia integracja, API lub Base	jeden lub kilka sklepów, automatyczne faktury	kierunek synchronizacji stanów, SKU, zwroty częściowe
IFIRMA	integrator e-commerce, API lub Base	firma łącząca fakturowanie z księgowością	zakres dokumentów, uprawnienia API, działanie przez Base
wFirma	wtyczka, API lub Base	firma korzystająca już z ekosystemu wFirma	producent wtyczki, aktualizacje, mapowanie dokumentów
Base	WooCommerce REST API	sprzedaż wielokanałowa, marketplace, kilka magazynów	większa liczba ustawień i ryzyko podwójnych dokumentów
Integracja dedykowana	własne API, webhooki lub n8n	niestandardowy proces, ERP, B2B, kilka firm	koszt budowy, monitoring i utrzymanie

n8n to narzędzie do budowania własnych automatyzacji łączących systemy bez gotowej wtyczki. Nie wybieraj programu wyłącznie na podstawie liczby dostępnych funkcji — najlepsza integracja to taka, która pasuje do rzeczywistego procesu firmy.

Jakie dane powinny być przesyłane?

Minimalny zakres obejmuje dane klienta, zamówienia, produktów i dane dodatkowe.

Dane klienta: imię i nazwisko, nazwa firmy, NIP, adres, kraj, adres e-mail.

Dane zamówienia: numer zamówienia, data sprzedaży, metoda płatności, status płatności, waluta, rabaty i kupony.

Dane produktów: nazwa, SKU, ilość, cena netto lub brutto, stawka VAT, wariant produktu.

Dane dodatkowe: koszt dostawy, metoda dostawy, numer przesyłki, uwagi klienta, numer dokumentu, identyfikator KSeF (gdy dotyczy).

Nie wszystkie dane muszą być przesyłane w obu kierunkach. Im bardziej rozbudowana synchronizacja, tym więcej przypadków trzeba przetestować.

W którym momencie wystawiać fakturę?

Dokument nie powinien powstawać automatycznie po samym kliknięciu „Zamawiam".

Zamówienie może pozostać nieopłacone, zostać anulowane albo nie przejść autoryzacji płatności. Najczęściej fakturę wystawia się po potwierdzeniu płatności, zmianie statusu na „w realizacji", ręcznym zatwierdzeniu zamówienia albo przygotowaniu przesyłki. Właściwy moment zależy od sposobu sprzedaży i ustaleń księgowych.

Przelew tradycyjny. Nie warto wystawiać faktury natychmiast, jeżeli klient może nigdy nie opłacić zamówienia.

Płatność online. Dokument może powstać po otrzymaniu poprawnego statusu płatności od operatora.

Pobranie. Firma musi ustalić, czy dokument powstaje przed wysyłką, czy po potwierdzeniu dostawy.

Sprzedaż B2B z terminem płatności. Faktura może być wystawiana po ręcznym zatwierdzeniu zamówienia lub przyznaniu kredytu kupieckiego. Regułę warto uzgodnić z księgowością przed konfiguracją.

Co najczęściej psuje się w integracjach?

Problem	Skutek	Co sprawdzić?
Dwa systemy wystawiają fakturę	podwójny dokument i błędna sprzedaż	jedno źródło numeracji
Faktura powstaje za wcześnie	dokument do nieopłaconego zamówienia	status uruchamiający
Brak NIP-u	faktura na osobę prywatną zamiast firmy	mapowanie pól checkoutu
Różne SKU	niewłaściwy produkt lub stan	unikalne kody produktów i wariantów
Zła stawka VAT	niepoprawny dokument	konfiguracja podatków i kraju sprzedaży
Rabat rozłożony inaczej	suma dokumentu nie zgadza się z zamówieniem	kupony, rabaty pozycji i dostawy
Brak obsługi zwrotu częściowego	faktura nie zgadza się ze zwrotem	scenariusz korekty częściowej
Dwie synchronizacje magazynu	stany nadpisują się nawzajem	nadrzędny system magazynowy
Wygasły klucz API	dokumenty przestają się tworzyć	alerty i logi błędów
Brak ponowienia po awarii	część zamówień pozostaje bez faktur	kolejka i mechanizm retry

Retry oznacza automatyczną ponowną próbę wykonania operacji, gdy zewnętrzny system chwilowo nie odpowiada. Integracja nie może zakładać, że API zawsze działa poprawnie — powinna zapisać błąd, powiadomić obsługę i umożliwić bezpieczne ponowienie bez tworzenia duplikatu.

Jak wdrożyć integrację krok po kroku?

1. Rozpisz obecny proces. Zapisz, co dzieje się od momentu zamówienia do zaksięgowania sprzedaży: płatność, potwierdzenie zamówienia, faktura lub paragon, magazyn, wysyłka, zwrot, korekta, KSeF. Najpierw trzeba zrozumieć proces — dopiero później wybierać wtyczkę.

2. Wybierz architekturę. Podejmij decyzję: WooCommerce → księgowość, WooCommerce → Base → księgowość albo WooCommerce → integracja dedykowana → ERP lub księgowość. Nie dodawaj Base tylko dlatego, że jest popularny — dodaj go wtedy, gdy rzeczywiście rozwiązuje problem wielu kanałów lub procesów.

3. Wyznacz systemy nadrzędne. Określ osobno dla każdego rodzaju danych, który system jest źródłem prawdy:

Rodzaj danych	System nadrzędny
Zamówienia	WooCommerce albo Base
Faktury	program księgowy
Stany magazynowe	WooCommerce, Base, WMS albo ERP
Ceny	sklep, ERP albo Base
Wysyłka	Base albo WooCommerce
Dane księgowe	wFirma, Fakturownia lub IFIRMA

Jedna odpowiedź nie musi dotyczyć wszystkich danych.

4. Uporządkuj produkty i SKU. Przed synchronizacją sprawdź brakujące kody, zduplikowane SKU, warianty bez własnych kodów, różne oznaczenia w systemach, nieaktualne produkty i błędne stawki VAT. Przy 50 produktach można poprawić dane ręcznie; przy 10 000 produktów potrzebny może być eksport, porównanie baz i automatyczne mapowanie.

5. Skonfiguruj statusy oraz dokumenty. Ustal, kiedy powstaje faktura, kiedy powstaje proforma, kiedy wysyłany jest dokument, jaki status oznacza błąd, co dzieje się przy anulowaniu, co dzieje się przy zwrocie i kto wykonuje korektę.

6. Przetestuj przypadki typowe i nietypowe. Nie wystarczy jedno zamówienie testowe. Sprawdź co najmniej:

1. klient indywidualny,
2. firma z NIP-em,
3. płatność online,
4. przelew tradycyjny,
5. pobranie,
6. rabat procentowy,
7. darmowa dostawa,
8. pełny zwrot,
9. częściowy zwrot,
10. zamówienie w innej walucie,
11. błąd API,
12. ponowną próbę po błędzie.

7. Uruchom monitoring. Po wdrożeniu warto kontrolować liczbę zamówień bez dokumentu, błędy API, dokumenty zdublowane, niezgodność kwot, brakujące numery KSeF oraz czas od płatności do wystawienia faktury. Integracja bez monitoringu może nie działać przez kilka dni, zanim ktoś zauważy problem.

Integracja WooCommerce z księgowością a KSeF w 2026 roku

W 2026 roku nie wystarczy sprawdzić, czy system generuje estetyczny PDF. Dla faktur objętych obowiązkiem trzeba również zaplanować przekazywanie dokumentów do KSeF i odbieranie odpowiedzi systemu.

W praktyce należy ustalić, który program wysyła dokument do KSeF, czy zwraca numer KSeF, gdzie zapisywany jest status wysyłki, co dzieje się przy odrzuceniu dokumentu, jak wygląda tryb awaryjny, kto obsługuje korekty, jaki dokument otrzymuje klient i czy faktura nie zostanie wysłana dwukrotnie.

Co możesz sprawdzić samodzielnie?

Przed zamówieniem integracji wykonaj prostą kontrolę.

1. Sprawdź źródła zamówień. Zapisz, czy sprzedaż pochodzi z WooCommerce, Allegro, Amazonu, Empiku, sprzedaży telefonicznej, zamówień B2B albo innych sklepów. Jeżeli źródeł jest kilka, Base może uprościć cały proces.

2. Sprawdź, gdzie dziś powstają faktury. Ustal, czy dokumenty tworzy WooCommerce, program księgowy, Base, pracownik ręcznie albo kilka systemów jednocześnie. Ostatni wariant wymaga pilnego uporządkowania.

3. Porównaj SKU. Wyeksportuj produkty z WooCommerce i programu magazynowego. Sprawdź, czy kody są identyczne i unikalne.

4. Sprawdź dane firmowe w zamówieniu. Złóż zamówienie testowe z NIP-em. Zobacz, gdzie WooCommerce zapisuje nazwę firmy oraz numer podatkowy.

5. Przetestuj zwrot. Sprawdź, czy pełny i częściowy zwrot automatycznie prowadzą do właściwego dokumentu albo zadania dla księgowości.

6. Zapytaj księgowość o KSeF. Ustal, który system ma odpowiadać za wysyłkę, odbieranie statusów i korekty.

Kiedy warto zlecić to specjaliście?

Pomoc techniczna jest potrzebna, gdy:

• sprzedajesz w kilku kanałach,
• masz więcej niż jeden magazyn,
• stany lub ceny regularnie się rozjeżdżają,
• dokumenty powstają w kilku systemach,
• korzystasz z niestandardowego checkoutu B2B,
• potrzebujesz częściowych korekt i wielu serii numeracji,
• łączysz WooCommerce z ERP, WMS lub własnym panelem,
• integracja przestała działać po aktualizacji,
• chcesz wdrożyć monitoring i automatyczne ponowienia,
• gotowe wtyczki nie obsługują Twojego procesu.

Przy prostym sklepie konfigurację często można wykonać samodzielnie. Przy większej sprzedaży błąd integracji może objąć setki dokumentów, dlatego potrzebne są środowisko testowe, kopia zapasowa i plan wycofania zmian. Stałe aktualizacje oraz kontrolę działania można również prowadzić w ramach opieki technicznej nad WooCommerce.

---

Uporządkuj faktury, zamówienia i magazyn

Dobra integracja nie polega na zainstalowaniu przypadkowej wtyczki. Najpierw trzeba ustalić, gdzie powstaje zamówienie, który system wystawia dokument, skąd pobierane są stany i co ma się wydarzyć przy błędzie lub zwrocie. Jeżeli chcesz połączyć WooCommerce z wFirmą, Fakturownią, IFIRMĄ, Base albo własnym systemem, rozpiszemy przepływ danych, dobierzemy technologię, skonfigurujemy integrację i przetestujemy ją na rzeczywistych scenariuszach sprzedaży:

• Integracje systemów dla e-commerce — główny zakres usługi.
• Automatyzacje i integracje dla firm — szersze możliwości łączenia systemów.
• WooCommerce API — co to jest i do czego służy — jak systemy wymieniają dane.
• Sklep B2B na WooCommerce — gdy integracja obejmuje ceny i procesy B2B.