Przewodnik krok po kroku

Instalacja i konfiguracja

Q: Co jeśli test połączenia nie działa?

Sprawdź trzy najczęstsze przyczyny: 1) Token nie pasuje do środowiska — token testowy działa tylko w sandboxie, produkcyjny tylko w produkcji. 2) NIP nie zgadza się z tokenem — NIP musi być identyczny z tym, na który wygenerowano token. 3) Brak rozszerzenia libsodium — skontaktuj się z hostingiem aby je włączyć.

Q: Czy mogę testować bez ryzyka?

Tak! Ustaw środowisko na Testowe (sandbox) i tryb na Symulacja. W tej konfiguracji wtyczka generuje XML i symuluje wysyłkę, ale żadna faktura nie trafia do prawdziwego KSeF. Możesz bezpiecznie testować cały przepływ.

Q: Jak przejść z testów na produkcję?

Trzy proste kroki: 1) Zmień środowisko z Testowe na Produkcyjne. 2) Wklej token produkcyjny (wygenerowany na ksef.mf.gov.pl). 3) Zmień tryb z Symulacja na Rzeczywisty.

Zainstaluj darmową wtyczkę z WordPress.org i wystawiaj faktury w KSeF w kilka minut. Kroki oznaczone PRO dotyczą wersji Pro.

1 Zainstaluj

2 Licencja PRO

3 Konfiguracja

4 Test

5 Automatyzacja PRO

6 Produkcja

6 kroków do działania

Zainstaluj wtyczkę

Wersja Free — wyszukaj w katalogu WordPress i zainstaluj jednym kliknięciem:

Szukaj „ByteWave Faktury"

Zainstaluj

Aktywuj

WP Admin → Wtyczki → Dodaj nową → Wyszukaj „ByteWave Faktury" → Zainstaluj → Aktywuj

Wersja Pro PRO — najpierw zainstaluj Free (jak wyżej), potem wgraj addon Pro:

Pobierz ZIP Pro

Wgraj do WP

Aktywuj

Aktywuj licencję PRO

Ten krok dotyczy tylko wersji Pro. Wersja Free działa w pełni bez licencji. Po zakupie Pro aktywuj klucz aby odblokować automatyzację.

KSeF → Ustawienia → Licencja

Wklej token licencji

Kliknij „Aktywuj"

Status: Aktywna

Skonfiguruj połączenie z KSeF

Uzupełnij 4 kluczowe pola aby wtyczka mogła komunikować się z Krajowym Systemem e‑Faktur:

KSeF → Ustawienia → Połączenie

ŚrodowiskoTestowe (sandbox) lub Produkcyjne

Token KSeFKlucz uwierzytelniający z KSeF

NIP sprzedawcy10-cyfrowy numer NIP firmy

Tryb pracySymulacja (test) lub Rzeczywisty

Zacznij od środowiska Testowego + tryb Symulacja — to bezpieczne i nie wysyła faktur do prawdziwego KSeF.

Przetestuj połączenie

Sprawdź czy wtyczka poprawnie łączy się z serwerem KSeF. Masz dwie opcje:

KSeF → Narzędzia → Połączenie

Test połączenia

Serwer KSeF

Połączenie OK

Sprawdź token i NIP

Włącz automatyzację PRO

Funkcja dostępna w wersji Pro. Ustaw aby faktury generowały się i wysyłały automatycznie po opłacie zamówienia. W wersji Free wystawiasz faktury ręcznie z poziomu zamówienia.

KSeF → Ustawienia → Automatyzacja

Zamówienie
opłacone

Generowanie
faktury XML

Wysyłka
do KSeF

Pobranie
UPO

Kolejka wysyłkowa przetwarza się automatycznie co 5 minut przez WP‑Cron.

Przejdź na produkcję

Gdy testy w sandboxie przejdą pomyślnie, przełącz się na środowisko produkcyjne:

Sandbox Środowisko testowe

Testy zaliczone

Token produkcyjny

Tryb: Rzeczywisty

Produkcja Gotowe do pracy!

Przepływ faktury od zamówienia do UPO

Zamówienie
WooCommerce

XML
FA(3)

Walidacja
XSD

Kolejka
wysyłkowa

API
KSeF

UPO

KSeF niedostępny? Wtyczka automatycznie przełącza się w tryb offline i ponawia wysyłkę po przywróceniu systemu.

Wymagania systemowe

WordPress 7.x+

Najnowsze wersje WordPressa z pełnym wsparciem REST API

WooCommerce 8.x+

Z obsługą HPOS (High-Performance Order Storage)

PHP 7.4+ z libsodium

Rozszerzenie libsodium do szyfrowania tokena KSeF

Token KSeF

Klucz z portalu ksef.mf.gov.pl (testowy lub produkcyjny)

Checklist: gotowy do startu?

Upewnij się, że masz wszystko przed uruchomieniem na produkcji:

Wtyczka zainstalowana i aktywna

Licencja Pro aktywowana (tylko dla wersji Pro)

Token KSeF wklejony i zaszyfrowany

NIP sprzedawcy uzupełniony (10 cyfr)

Test połączenia zaliczony

Pierwsza faktura testowa wysłana w sandboxie

Środowisko zmienione na Produkcyjne

Tryb pracy: Rzeczywisty

Najczęstsze pytania

Skąd wziąć token KSeF?

Token generujesz na portalu Ministerstwa Finansów. Dla środowiska testowego: ksef-test.mf.gov.pl, dla produkcyjnego: ksef.mf.gov.pl. Zaloguj się profilem zaufanym, przejdź do sekcji „Tokeny" i wygeneruj nowy token z uprawnieniami do wystawiania faktur.

Co jeśli test połączenia nie działa?

Sprawdź trzy najczęstsze przyczyny:

Token nie pasuje do środowiska — token testowy działa tylko w sandboxie, produkcyjny tylko w produkcji
NIP nie zgadza się z tokenem — NIP musi być identyczny z tym, na który wygenerowano token
Brak rozszerzenia libsodium — skontaktuj się z hostingiem aby je włączyć

Czy mogę testować bez ryzyka?

Tak! Ustaw środowisko na Testowe (sandbox) i tryb na Symulacja. W tej konfiguracji wtyczka generuje XML i symuluje wysyłkę, ale żadna faktura nie trafia do prawdziwego KSeF. Możesz bezpiecznie testować cały przepływ.

Jak przejść z testów na produkcję?

Trzy proste kroki:

Zmień środowisko z Testowe na Produkcyjne
Wklej token produkcyjny (wygenerowany na ksef.mf.gov.pl)
Zmień tryb z Symulacja na Rzeczywisty

Zacznij fakturować w KSeF już dziś

Darmowa wtyczka na WordPress.org. Gotowa do działania w kilka minut.

Pobierz za darmo Kup Pro