Pełna lista funkcji

Wszystko czego potrzebujesz do KSeF

ByteWave Faktury to kompletne rozwiązanie integrujące WooCommerce z Krajowym Systemem e‑Faktur. Wersja darmowa daje Ci pełne fakturowanie — Pro dodaje automatyzację.

Funkcje oznaczone PRO wymagają rozszerzenia ByteWave Faktury Pro

60+

Funkcji

Środowiska KSeF

FA(3)

Format XML

HPOS

Kompatybilność

Integracja z WooCommerce

Pełna współpraca z zamówieniami, statusami i akcjami WooCommerce

Kolumna statusu KSeF

Dodatkowa kolumna na liście zamówień z kolorowymi znacznikami: wysłano, w kolejce, błąd, szkic, offline.

Metabox KSeF w zamówieniu

Panel boczny z pełnym statusem, referencją sesji, numerem KSeF, podglądem HTML faktury i opcjami sterowania.

Akcje masowe PRO

Wystawiaj i wysyłaj faktury masowo — zaznacz zamówienia i jednym kliknięciem dodaj do kolejki KSeF. Limit 200 na operację.

Automatyzacja po statusie PRO

Automatyczne wystawianie faktur po zmianie statusu zamówienia (np. zakończone, przetwarzane) lub po potwierdzeniu płatności.

Podgląd HTML faktury

Renderuje fakturę jako sformatowaną stronę HTML bezpośrednio w przeglądarce, bez pobierania pliku.

Kompatybilność HPOS + CPT

Pełna obsługa zarówno nowego High‑Performance Order Storage jak i klasycznego Custom Post Type.

Wykluczenia per-zamówienie

Możliwość wykluczenia konkretnego zamówienia z automatyzacji lub wymuszenia trybu B2C bezpośrednio z metaboxa.

Blokada duplikacji

Mechanizm transient lock zapobiega podwójnemu dodaniu zamówienia do kolejki przy równoczesnym odpaleniu wielu hooków.

Generowanie faktur XML FA(3)

Kompletna budowa e-faktur ustrukturyzowanych zgodnych ze schematem Ministerstwa Finansów

Schemat FA(3)

Generuje kompletny XML w oficjalnym formacie FA(3) — nagłówek, dane sprzedawcy/nabywcy, pozycje, podatki, sumy.

Walidacja XSD przed wysyłką

Każdy XML jest walidowany względem oficjalnych schematów XSD Ministerstwa Finansów. Blokuje wysyłkę błędnych faktur.

Automatyczne rozpoznawanie NIP

Przeszukuje 12+ pól meta zamówienia w poszukiwaniu NIP nabywcy. Obsługuje popularne polskie wtyczki fakturowe.

Mapowanie stawek VAT (P_12)

Mapuje stawki WooCommerce na kody FA(3): 23%, 8%, 5%, 0% KR, WDT, EX, zw, np, oo. Konfigurowalna mapa + heurystyka.

Hash SHA‑256 integralności

Po wygenerowaniu XML oblicza i zapisuje hash SHA‑256. Gwarantuje, że plik nie został zmodyfikowany po wystawieniu.

Prywatny magazyn plików

Pliki XML zapisywane poza katalogiem uploads, chronione przed bezpośrednim dostępem z przeglądarki.

Komunikacja z API KSeF

Szyfrowane sesje, uwierzytelnianie tokenem i pełna obsługa protokołu KSeF v2

2 środowiska: Testowe i Produkcyjne

Przełączanie między środowiskiem testowym (sandbox) a produkcyjnym jednym kliknięciem w ustawieniach.

Szyfrowanie AES‑256‑CBC + RSA

XML szyfrowany AES‑256‑CBC, klucz szyfrowany RSA‑OAEP SHA‑256 kluczem publicznym KSeF. Zgodne z wymogami API.

Sesje online

Automatyczne otwieranie i zamykanie sesji online KSeF. Każda faktura to osobna, bezpieczna sesja.

Automatyczne re‑uwierzytelnianie

Po wygaśnięciu tokena (HTTP 401) automatycznie ponownie się uwierzytelnia i powtarza operację bez interwencji.

Obsługa HTTP 429 (Rate Limiting)

Odczytuje nagłówek Retry‑After i automatycznie przeplanowuje wysyłkę z odpowiednim opóźnieniem.

Detekcja WAF / blokad

Wykrywa gdy KSeF zwraca stronę HTML (blokada WAF/Cloudflare) zamiast JSON i traktuje to jako błąd dostępności.

Tryb symulacji

Generuje i waliduje XML bez wysyłania do KSeF. Idealny do testów integracji bez skutków prawnych.

Test połączenia i sesji

Narzędzia diagnostyczne: test uwierzytelnienia tokena i test otwierania/zamykania sesji online — wprost z panelu admin.

Tryb awaryjny offline PRO

Gdy KSeF nie odpowiada — faktury są bezpiecznie buforowane i wysyłane automatycznie po przywróceniu

Automatyczna detekcja niedostępności

Po 2 kolejnych błędach HTTP (502/503/504/timeout) automatycznie przełącza na tryb offline na 15 minut.

Ręczny tryb offline

Administrator może ręcznie włączyć/wyłączyć tryb offline jednym przyciskiem w panelu.

Terminy ustawowe (od 2026)

Automatycznie oblicza ustawowe terminy wysyłki offline zgodnie z polskim prawem VAT — z uwzględnieniem świąt i dni wolnych.

Alerty o terminach

Powiadomienia w panelu gdy termin wysyłki offline się zbliża (<4h) lub minął. Błyskające bannery z liczbą zaległych faktur.

Automatyczne wysyłanie po przywróceniu

Co 5 minut sprawdza dostępność KSeF — gdy wróci, automatycznie wysyła zaległe faktury offline.

Masowe wysyłanie offline

Przycisk do ręcznego wysłania wszystkich faktur offline jednym kliknięciem lub wysyłka pojedynczych faktur.

Kolejka i automatyzacja PRO

Inteligentna kolejka zadań z automatycznymi ponownymi próbami i konfigurowalnymi wyzwalaczami

Własna kolejka zadań

Dedykowana tabela bazy danych z blokadami, ponownymi próbami (exponential backoff) i historią błędów.

Przetwarzanie co 5 minut

WP‑Cron automatycznie przetwarza kolejkę. Do 10 zadań na uruchomienie. Ręczny przycisk „Przetwórz teraz".

Konfigurowalne wyzwalacze

Wybierz które statusy zamówień wyzwalają fakturę. Opcja wyzwalania po płatności. Tryby: B2B / B2B+B2C na żądanie / pełne auto.

Wykluczenia metod płatności i kategorii

Wyklucz wybrane metody płatności lub kategorie produktów z automatycznego fakturowania.

Dead‑letter queue

Faktury z błędami 4xx lub po wyczerpaniu prób trafiają do osobnej kolejki do ręcznej obsługi.

Powiadomienia email o błędach

Konfigurowalny email gdy faktura osiągnie próg nieudanych prób. Ustawialny adres i próg powiadomień.

UPO — Urzędowe Poświadczenie Odbioru

Automatyczne pobieranie, archiwizacja i udostępnianie poświadczeń z KSeF

Automatyczne pobieranie UPO

30 sekund po wysyłce automatycznie harmonogramuje pobranie UPO. Fallback co godzinę szuka brakujących UPO.

Bezpieczne przechowywanie

UPO zapisywane w prywatnym katalogu poza uploads. Ochrona przed path traversal przy pobieraniu.

Pobieranie pliku UPO

Administrator i księgowy mogą pobrać plik XML UPO bezpośrednio z panelu faktur.

Walidacja URL‑i UPO

Sprawdza ważność podpisanych URL‑i (AWS S3) przed próbą pobrania. Pomija wygasłe i czeka na nowe wywołanie.

Raporty, audyt i eksport PRO

Dashboard z KPI, audyt zgodności, pełna historia zdarzeń i eksport danych

✓	Funkcja	Opis
✓	Dashboard KPI	Podsumowanie liczby faktur wg statusu, średni czas wysyłki, tabela najczęstszych błędów
✓	Audyt zgodności	Skanuje zamówienia WooCommerce i pokazuje listę wymagających uwagi: brak faktury, błędy, oczekuje na akcję
✓	Historia zdarzeń	Kompletna historia: wysyłki, błędy, zmiany trybu offline, operacje UPO — z datą, użytkownikiem i IP
✓	Lista faktur KSeF	Tabela z sortowaniem i paginacją: ID, zamówienie, status, numer KSeF, błąd, data wysyłki, data UPO
✓	Eksport CSV	Eksportuj faktury do CSV z BOM (kompatybilność z Excel), separator średnikowy, filtrowanie po NIP
✓	Pobieranie XML	Pobierz plik XML faktury bezpośrednio z listy faktur. Chroniony przed path traversal
✓	Filtrowanie po statusie KSeF	Nakładka KSeF na listę zamówień WooCommerce z filtrowaniem i wyszukiwaniem po ID lub NIP
✓	Log zmian ustawień	Każda zmiana ustawień jest logowana: kto, kiedy, z jakiego IP, jakie klucze zmienił

Bezpieczeństwo i uprawnienia

Szyfrowanie danych, weryfikacja aktualizacji, granularne role i uprawnienia

Szyfrowanie tokena XChaCha20

Token API przechowywany zaszyfrowany XChaCha20‑Poly1305 (libsodium). Klucz derywowany z soli WordPress + URL strony.

Weryfikacja podpisu Ed25519 PRO

Przed instalacją aktualizacji weryfikuje hash SHA‑256 i podpis Ed25519 pakietu. Blokuje niepodpisane paczki.

Redakcja danych w logach

Automatyczne maskowanie tokenów, kluczy API, JWT i ciągów base64 przed wyświetleniem lub zapisem w transientach.

Rola „Księgowy KSeF" PRO

Dedykowana rola WordPress z 6 granularnymi uprawnieniami. Konfigurowalny zakres dostępu w ustawieniach.

Ochrona przed path traversal

Akcje pobierania XML i UPO weryfikują że żądana ścieżka należy do katalogu wtyczki.

Idempotentność akcji

Blokady transient na krytycznych akcjach POST zapobiegają podwójnemu wykonaniu przy wielokrotnym kliknięciu.

Zacznij fakturować w KSeF już dziś

Darmowa wtyczka daje Ci pełne fakturowanie KSeF. Pro dodaje automatyzację, kolejkę i raporty.

Pobierz za darmo Kup Pro