BerlinettaBerlinetta

Blog9 min czytania

Integracja KSeF z WooCommerce: jak połączyć sklep w 2026 roku

Jak połączyć WooCommerce z KSeF: terminy, sposoby integracji, dane z zamówienia, konfiguracja krok po kroku, błędy, korekty i tryb offline.

Zespół BerlinettySprzedaż wielokanałowa w praktyce

W tym artykule

WooCommerce sam nie wysyła faktur do KSeF. Potrzebny jest łącznik, który z zamówienia zrobi fakturę ustrukturyzowaną, wyśle ją do systemu Ministerstwa Finansów i zapisze przy zamówieniu numer KSeF. Najmniej pracy daje jeden system, który zbiera zamówienia z WooCommerce i z pozostałych kanałów sprzedaży, a z każdego zamówienia wystawia fakturę wysyłaną do KSeF. Tak działa Berlinetta: fakturę lub paragon wystawiasz z zamówienia i wysyłasz do KSeF albo korzystasz z połączenia z inFaktem i Subiektem nexo PRO. Poniżej znajdziesz zasady, sposoby połączenia, potrzebne dane i konfigurację krok po kroku.

Krótko mówiąc

  • Od 1 kwietnia 2026 r. większość firm musi wystawiać faktury w KSeF. Do końca 2026 r. działa jeszcze limit 10 000 zł brutto miesięcznie dla faktur wystawianych poza systemem.
  • Faktury dla konsumentów nie muszą trafiać do KSeF. Obowiązek dotyczy faktur dla firm z NIP.
  • WooCommerce potrzebuje łącznika: wtyczki, programu fakturowego albo systemu do sprzedaży wielokanałowej z obsługą KSeF.
  • Najważniejsze dane z zamówienia to NIP nabywcy w poprawnym polu, pełne dane firmy i poprawne stawki VAT.
  • Przyjętej faktury z numerem KSeF nie poprawisz ani nie anulujesz. Błąd usuwasz fakturą korygującą.

Kiedy sklep na WooCommerce musi korzystać z KSeF

KSeF, czyli Krajowy System e-Faktur, to według Ministerstwa Finansów system do wystawiania, przesyłania, odbierania i przechowywania faktur ustrukturyzowanych. Faktura ustrukturyzowana to plik XML o układzie ustalonym przez ministerstwo, a nie PDF.

Terminy wyglądają tak, zgodnie z materiałem Zakres obowiązkowego KSeF:

Obowiązek Od kiedy Kogo dotyczy
Odbieranie faktur w KSeF 1 lutego 2026 r. wszystkich podatników
Wystawianie faktur w KSeF 1 lutego 2026 r. firm, których sprzedaż z VAT w 2024 r. przekroczyła 200 mln zł
Wystawianie faktur w KSeF 1 kwietnia 2026 r. pozostałych podatników
Faktury poza KSeF do 10 000 zł brutto miesięcznie do końca 2026 r. podatników z małą wartością faktur

Typowy mały sklep internetowy wystawia więc faktury w KSeF od 1 kwietnia 2026 r. Wyjątek z limitem 10 000 zł działa prosto: liczy się suma faktur wystawionych poza KSeF w danym miesiącu. Gdy ją przekroczysz, obowiązek zaczyna się od faktury, która przekracza limit. Wyjątek kończy się z końcem 2026 r., więc jeśli dziś z niego korzystasz, połączenie sklepu z KSeF i tak musisz przygotować.

Co z klientami indywidualnymi? Ministerstwo wyjaśnia, że faktury dla konsumentów nie podlegają obowiązkowi wystawiania w KSeF. Możesz je wysłać do systemu dobrowolnie, a klientowi przekazujesz je uzgodnionym sposobem, na przykład e-mailem. Do KSeF nie trafiają też faktury pro forma, faktury wewnętrzne oraz noty uznaniowe i obciążeniowe.

Dla sklepu oznacza to jedną praktyczną zasadę: każde zamówienie, w którym kupujący podał NIP polskiej firmy i chce fakturę, musi skończyć się fakturą w KSeF. Więcej o obowiązkach w handlu internetowym piszemy w tekście Faktury KSeF w e-commerce.

Dlaczego WooCommerce nie wyśle faktury sam

WooCommerce to silnik sklepu: przyjmuje zamówienie, płatność i dane do wysyłki. Nie tworzy faktur w strukturze wymaganej przez KSeF. Od 1 lutego 2026 r. faktura ustrukturyzowana korzysta ze struktury FA(3) w formacie XML. Ktoś musi zamienić dane z zamówienia na taki plik, wysłać go, odebrać odpowiedź systemu i zapisać przy zamówieniu numer KSeF.

To zadanie wykonuje łącznik. Ważne jest, kto w Twoim układzie wystawia dokument, bo to on odpowiada za poprawne dane i wysyłkę. Jeśli coś pójdzie źle, szukasz błędu właśnie tam.

Trzy sposoby połączenia sklepu z KSeF

Sposób Jak działa Co to oznacza w pracy
System do sprzedaży wielokanałowej z KSeF, np. Berlinetta pobiera zamówienia z WooCommerce i marketplace’ów, fakturę wystawiasz z zamówienia i wysyłasz do KSeF bezpośrednio albo przez inFakt lub Subiekt nexo PRO jedno miejsce na zamówienia, faktury, wysyłki i magazyn ze wszystkich kanałów
Wtyczka do programu fakturowego wtyczka w WordPressie przekazuje dane zamówienia do programu, który tworzy fakturę i wysyła ją do KSeF osobne rozwiązanie dla każdego kanału sprzedaży
Wtyczka wysyłająca faktury z WordPressa dokument powstaje w sklepie i stamtąd trafia do KSeF faktury tylko z jednego sklepu, pozostałe kanały obsługujesz gdzie indziej

Przy dwóch ostatnich sposobach każdy kanał sprzedaży wymaga osobnego rozwiązania. Faktura do zamówienia z Allegro powstaje wtedy gdzie indziej niż faktura do zamówienia z WooCommerce, a numeracja, kontrahenci i statusy rozjeżdżają się między programami. Przy pierwszym sposobie wszystkie zamówienia i faktury masz w jednym miejscu.

Przykład: sklep sprzedaje te same produkty w WooCommerce i na Allegro. W miesiącu ma kilkadziesiąt zamówień firmowych z obu kanałów. Przy osobnych wtyczkach księgowa dostaje faktury z dwóch źródeł, a Ty sprawdzasz statusy KSeF w dwóch miejscach. Gdy klient z Allegro zwraca towar, korekty szukasz w innym programie niż zamówienie. W jednym panelu zamówienie, faktura, korekta i przesyłka są ze sobą powiązane, więc odpowiedź na pytanie klienta o fakturę zajmuje chwilę.

Kartonowa paczka jest gotowa do odbioru w sklepie internetowym

Porównanie dostępnych rozwiązań znajdziesz w naszym rankingu integracji KSeF z WooCommerce.

Jakie dane zebrać w zamówieniu

Faktura w KSeF zawiera te same dane co każda faktura VAT: dane sprzedawcy i nabywcy, datę wystawienia i sprzedaży, pozycje, ilości, ceny netto, stawki i kwoty VAT oraz sumę. Różnica polega na tym, że system sprawdza je automatycznie i odrzuca plik z błędem.

W sklepie najczęściej brakuje lub jest źle zapisany jeden element: NIP kupującego. Ministerstwo w broszurze o FA(3) wskazuje, że polski NIP nabywcy wpisuje się w polu NIP w części Podmiot2, czyli w danych nabywcy. Faktura zostanie udostępniona nabywcy w KSeF tylko wtedy, gdy NIP jest w polu NIP, a nie w polu numeru VAT UE ani innego identyfikatora.

Przed uruchomieniem połączenia sprawdź formularz zamówienia:

  1. Pole NIP. Jeśli formularz nie ma osobnego pola NIP, kupujący wpisuje numer w nazwie firmy albo w uwagach i łącznik go nie odczyta.
  2. Wybór „Chcę fakturę”. Dzięki niemu odróżnisz zamówienie firmowe, które idzie do KSeF, od zamówienia konsumenta.
  3. Format NIP. Kupujący wpisują numer z kreskami, spacjami albo prefiksem PL. W polu NIP powinny trafić same cyfry.
  4. Pełna nazwa i adres firmy. Dane do faktury często różnią się od adresu dostawy, więc formularz powinien je rozdzielać.
  5. Stawki VAT przy produktach. Błędna stawka w karcie produktu przechodzi na każdą fakturę.

Konfiguracja krok po kroku

Poniżej pokazujemy, jak wygląda połączenie WooCommerce z KSeF w Berlinettcie i gdzie najczęściej pojawiają się problemy.

1. Uporządkuj dane firmy i dostęp do KSeF

Sprawdź dane sprzedawcy: NIP, nazwę i adres. Ustal też, kto w firmie ma uprawnienia do KSeF i w jaki sposób system wystawiający faktury ma się w nim uwierzytelniać. Częsty problem to dostęp przypisany do osoby, która nie zajmuje się już sprzedażą. Załatw to przed podłączeniem sklepu, bo bez dostępu żadna faktura nie zostanie wysłana.

2. Podłącz sklep WooCommerce

W Berlinettcie dodajesz WooCommerce jako kanał sprzedaży, tak samo jak Allegro, Erli, OLX, Shopera czy PrestaShop. Zamówienia ze wszystkich kanałów trafiają do jednego panelu, więc fakturę wystawiasz zawsze w tym samym miejscu, niezależnie od tego, skąd przyszło zamówienie.

3. Wybierz, gdzie powstaje faktura

Masz dwie drogi. Fakturę wystawiasz z zamówienia w Berlinettcie i wysyłasz ją do KSeF albo korzystasz z połączenia z inFaktem lub Subiektem nexo PRO, jeśli Twoje biuro rachunkowe pracuje na jednym z tych programów. Pierwszą drogę opisujemy na stronie faktury z zamówień i wysyłka do KSeF, a drugą w tekście o integracji z inFakt API.

4. Ustal numerację

Numer faktury nadajesz Ty, a numer KSeF nadaje system ministerstwa po przyjęciu dokumentu. To dwa różne numery i oba warto widzieć przy zamówieniu. Jak przypisujemy numery, wyjaśniamy w artykule o numeracji faktur KSeF.

5. Rozdziel faktury firmowe i paragony

Zamówienie z NIP kończy się fakturą w KSeF. Zamówienie konsumenta dokumentujesz paragonem albo fakturą poza obowiązkiem KSeF. W Berlinettcie z zamówienia wystawiasz zarówno faktury, jak i paragony, więc oba przypadki obsługujesz w jednym miejscu. Do powtarzalnych czynności masz w systemie reguły automatyczne.

6. Wyślij fakturę testową i sprawdź wynik

Wystaw pierwszą fakturę dla zamówienia z NIP i sprawdź, czy otrzymała numer KSeF. Dopiero wtedy wysyłaj dokument klientowi. Najczęstszy błąd na tym etapie to wysłanie PDF-a, zanim system przyjął fakturę: jeśli KSeF ją odrzuci, klient ma dokument bez numeru.

Status, odrzucenie i korekta faktury

Po wysłaniu faktura przechodzi weryfikację. Według podręcznika KSeF 2.0 z 19 lutego 2026 r. system nadaje numer KSeF po pozytywnej weryfikacji i przetworzeniu faktury. Wtedy możesz pobrać UPO, czyli urzędowe poświadczenie odbioru.

W praktyce faktura może mieć trzy wyniki:

  • Przetwarzana. System jeszcze weryfikuje plik. Poczekaj i sprawdź status ponownie.
  • Odrzucona lub z błędem walidacji. Faktura nie dostała numeru KSeF. Odczytaj komunikat błędu, popraw dane, najczęściej NIP, adres albo stawkę VAT, i wyślij dokument jeszcze raz.
  • Przyjęta z numerem KSeF. Faktura jest w obrocie prawnym.

Przyjętej faktury nie można już zmienić. Ten sam podręcznik mówi, że dokumentu z numerem KSeF nie da się edytować ani anulować, a błąd poprawia się fakturą korygującą. Dotyczy to też zwrotów: gdy klient firmowy odsyła towar, wystawiasz korektę, która również trafia do KSeF. Jak to zrobić przy zwrocie, opisujemy w poradniku faktura korygująca przy zwrocie.

Ministerstwo Finansów zapowiedziało w komunikacie z 26 marca 2026 r., że za 2026 r. nie będzie nakładać sankcji za błędy popełnione przy korzystaniu z KSeF. To dobry czas, żeby dopracować dane w sklepie. Jeśli masz wątpliwości, jak rozliczyć konkretną korektę, zapytaj swoją księgową lub doradcę podatkowego.

Co zrobić, gdy KSeF nie działa

Awaria lub przerwa techniczna KSeF nie zatrzymuje sprzedaży. Fakturę wystawiasz wtedy w trybie offline, zgodną ze strukturą FA(3), i wysyłasz do systemu po przywróceniu jego działania. Według wytycznych ministerstwa trzeba to zrobić nie później niż w następnym dniu roboczym po zakończeniu niedostępności.

Dla sklepu z dużą liczbą zamówień oznacza to jedno: po awarii trzeba wysłać wszystkie zaległe faktury i sprawdzić, czy każda dostała numer. Łatwiej to zrobić, gdy wszystkie faktury ze wszystkich kanałów są w jednym panelu, a nie w kilku programach.

Faktury KSeF dla WooCommerce i marketplace’ów w jednym panelu

Berlinetta zbiera zamówienia z WooCommerce, Shopera, PrestaShop, Allegro, Erli, OLX i InPost Von Halsky. Z każdego zamówienia wystawiasz fakturę lub paragon i wysyłasz dokument do KSeF albo korzystasz z połączenia z inFaktem i Subiektem nexo PRO. W tym samym panelu nadajesz paczki przez InPost, DHL, GLS, DPD, Pocztę Polską i FedEx, prowadzisz magazyn oraz obsługujesz zwroty i reklamacje.

Pulpit Berlinetty: sprzedaż z dziś z wykresem, zamówienia spakowane i wysłane, statusy zamówień, skróty i najnowsze zamówienia.

KSeF, wszystkie integracje, magazyn i sprzedaż B2B są w każdym pakiecie, bez płatnych dodatków. Płacisz tylko za liczbę zamówień w miesiącu: Berlinetta 250 kosztuje 89 zł netto miesięcznie lub 890 zł netto rocznie, bez opłaty od zamówienia. Konto testowe zakładasz sam i przez 30 dni korzystasz za darmo.

Nasze zdanie

Dla sklepu na WooCommerce KSeF to nie tylko nowa wtyczka. To zmiana w sposobie wystawiania faktur: każda faktura dla firmy musi przejść weryfikację, dostać numer i dopiero wtedy trafić do klienta. Im więcej kanałów sprzedaży, tym więcej miejsc, w których coś może się nie zgadzać.

Dlatego budujemy Berlinettę tak, żeby faktura powstawała tam, gdzie jest zamówienie. Zamówienie z WooCommerce, Allegro czy Erli wygląda w panelu tak samo i z każdego wystawiasz dokument w ten sam sposób. Jeśli Twoja księgowość pracuje w inFakcie albo Subiekcie nexo PRO, korzystasz z połączenia z tymi programami.

Nie pobieramy opłaty od zamówienia i nie sprzedajemy KSeF jako płatnego dodatku. Jest w każdym pakiecie, bo dziś to podstawowa część obsługi zamówień.

Zespół Berlinetta

Źródła

  1. 1.Drugi etap wdrożenia Krajowego Systemu e-Faktur, Ministerstwo Finansów
  2. 2.Zakres obowiązkowego KSeF, Ministerstwo Finansów
  3. 3.Szkolenie KSeF dla branży usług prawniczych, Ministerstwo Finansów
  4. 4.Zasady obowiązywania KSeF i przepisy prawne, Ministerstwo Finansów
  5. 5.Podręcznik KSeF 2.0, część II: wystawianie i otrzymywanie faktur, 19 lutego 2026 r.
  6. 6.Broszura informacyjna o strukturze logicznej FA(3), Ministerstwo Finansów
  7. 7.Tryb offline: niedostępność KSeF, Ministerstwo Finansów

Pytania

Najczęstsze pytania

Czy muszę wysyłać do KSeF faktury dla klientów indywidualnych?

Nie. Faktury dla konsumentów nie podlegają obowiązkowi wystawiania w KSeF. Możesz je wysłać do systemu dobrowolnie, a klientowi przekazujesz je uzgodnionym sposobem, na przykład e-mailem z PDF-em.

Czy do KSeF wystarczy mi wtyczka w WooCommerce?

Wtyczka obsłuży faktury tylko z jednego sklepu. Jeśli masz też Allegro, Erli lub drugi sklep, a nawet jeśli dopiero to planujesz, wygodniej od razu wystawiać faktury w jednym systemie, takim jak Berlinetta, który pobiera zamówienia z każdego kanału. Wtedy numeracja, korekty i statusy KSeF są w jednym miejscu.

Co zrobić, gdy KSeF odrzuci fakturę?

Odczytaj komunikat błędu, popraw dane i wyślij fakturę ponownie. Odrzucona faktura nie ma numeru KSeF, więc możesz ją poprawić. Faktury przyjętej, z numerem, nie edytujesz: błąd poprawiasz fakturą korygującą.

Czy mogę wystawiać faktury poza KSeF, jeśli mam mało faktur firmowych?

Do końca 2026 r. tak, jeśli suma faktur wystawionych poza KSeF nie przekracza 10 000 zł brutto w miesiącu. Faktura, która przekracza limit, musi już trafić do KSeF. Od 2027 r. ten wyjątek nie obowiązuje.

Sprzedajesz w kilku miejscach naraz?

Obsługuj Allegro, Erli, własny sklep i kurierów w jednym panelu. Bez przepisywania danych.