Jak wybrać wtyczkę KSeF do WooCommerce? 7 kryteriów

Wybór wtyczki KSeF to decyzja na lata, bo raz wdrożone fakturowanie trudno potem wymieniać. Na rynku jest kilka rozwiązań dla WooCommerce i na pierwszy rzut oka wszystkie obiecują to samo, czyli wysyłkę faktur do Krajowego Systemu e-Faktur. Różnice widać dopiero wtedy, gdy przyjrzysz się szczegółom, a to właśnie szczegóły decydują o tym, czy system będzie działał bezobsługowo, czy stanie się źródłem problemów. W tym poradniku zebraliśmy siedem kryteriów, które warto sprawdzić przed instalacją jakiejkolwiek wtyczki KSeF.

Kryterium pierwsze, walidacja faktury przed wysyłką

Krajowy System e-Faktur przyjmuje wyłącznie dokumenty zgodne ze schematem FA(3). Faktura z brakującym polem, złym formatem daty albo niezgodną sumą zostanie odrzucona. Kluczowe pytanie brzmi, kiedy się o tym dowiesz. Dobra wtyczka sprawdza dokument względem oficjalnego schematu XSD jeszcze przed wysyłką i pokazuje konkretny błąd do poprawienia. Słabe rozwiązanie wysyła w ciemno i zostawia Cię z komunikatem odrzucenia, który trzeba samodzielnie rozszyfrować. Przy większej liczbie zamówień ta różnica przekłada się na godziny pracy. Więcej o samym schemacie piszemy w tekście o fakturze ustrukturyzowanej FA(3), a o typowych odrzuceniach w poradniku o najczęstszych błędach przy wysyłce.

Kryterium drugie, zachowanie przy braku połączenia

KSeF miewa przerwy serwisowe, a Twój serwer może chwilowo stracić łączność. Przepisy przewidują na te sytuacje tryby szczególne, w tym tryb offline24, ale wtyczka musi umieć z nich skorzystać. Sprawdź, czy rozwiązanie ma kolejkę dokumentów, czyli mechanizm, który przechowuje faktury wystawione w czasie przerwy i automatycznie dosyła je do systemu, gdy połączenie wróci. Bez kolejki każda przerwa oznacza ręczne pilnowanie zaległości, a terminy dosłania faktur są określone przepisami. Jak działają poszczególne tryby, wyjaśniamy we wpisie o trybie awaryjnym i offline w KSeF.

Kryterium trzecie, bezpieczeństwo tokenu i certyfikatu

Token KSeF pozwala wystawiać faktury w imieniu Twojej firmy, więc jest równie wrażliwy jak hasło do banku. Zapytaj, jak wtyczka go przechowuje. Poprawna odpowiedź brzmi, w postaci zaszyfrowanej silnym algorytmem, na przykład XChaCha20-Poly1305, nigdy jawnym tekstem w bazie danych. To ważne także dlatego, że kopie bazy krążą po serwerach hostingowych i byle wyciek kopii zapasowej nie powinien oznaczać przejęcia dostępu do Twoich faktur. Warto też upewnić się, że rozwiązanie jest gotowe na certyfikaty KSeF, ponieważ tokeny działają tylko do końca 2026 roku. Szczegóły znajdziesz w tekście o tokenie i certyfikacie KSeF.

Kryterium czwarte, pobieranie UPO i statusy dokumentów

Wysłanie faktury to połowa procesu. System nadaje dokumentowi numer KSeF, a urzędowym dowodem przyjęcia jest UPO, czyli Urzędowe Poświadczenie Odbioru. Dobra wtyczka sama pobiera UPO, zapisuje je przy zamówieniu i pokazuje status każdego dokumentu, od wysłanego przez przyjęty po odrzucony. Bez tego musisz logować się do zewnętrznej aplikacji i sprawdzać dokumenty jeden po drugim. Numer KSeF ma zresztą coraz większe znaczenie księgowe, bo nowa struktura JPK wymaga go w ewidencji, o czym piszemy w artykule o KSeF a JPK_V7.

Kryterium piąte, zgodność z HPOS i aktualnym WordPressem

WooCommerce przechodzi na HPOS, czyli nowy magazyn zamówień, a WordPress wydaje kolejne wersje. Wtyczka, która nie deklaruje zgodności z HPOS albo od miesięcy nie była testowana z nowym WordPressem, będzie generować konflikty przy każdej większej aktualizacji sklepu. Sprawdź w opisie wtyczki pole z przetestowaną wersją WordPressa oraz informację o zgodności z HPOS. Zwróć też uwagę, czy autor reaguje na nowe wydania, bo fakturowanie to nie jest miejsce na porzucony projekt.

Kryterium szóste, środowisko testowe zanim dotkniesz produkcji

Ministerstwo Finansów udostępnia testową wersję KSeF, w której można bezpiecznie ćwiczyć wystawianie faktur bez skutków podatkowych. Wtyczka powinna pozwalać na przełączenie środowiska jednym ustawieniem, tak aby najpierw sprawdzić cały proces na niby, a dopiero potem przejść na produkcję. Rozwiązania bez trybu testowego zmuszają do nauki na żywym organizmie, czyli na prawdziwych fakturach Twojej firmy. Jak wygląda bezpieczne przejście od testów do produkcji, opisujemy w instrukcji instalacji i konfiguracji.

Kryterium siódme, model cenowy bez niespodzianek

Na koniec sprawdź, za co dokładnie płacisz. Część rozwiązań wymaga zakupu osobnej wtyczki bazowej i dopiero do niej dokupienia modułu KSeF, co podwaja koszty. Inne liczą opłaty od liczby dokumentów, co przy rosnącej sprzedaży robi się nieprzewidywalne. Najbezpieczniejszy jest model, w którym podstawowe wystawianie faktur jest darmowe i nielimitowane, a płaci się wyłącznie za wygodę automatyzacji, stałą kwotę rocznie niezależnie od liczby faktur. Zestawienie realnych kosztów różnych podejść znajdziesz w naszym artykule o tym, ile kosztuje wdrożenie KSeF w sklepie internetowym.

Czerwone flagi, czyli po czym poznać słabe rozwiązanie

Oprócz kryteriów pozytywnych warto znać sygnały ostrzegawcze. Pierwszy to brak informacji o wersji testowanej z aktualnym WordPressem, bo skoro autor nie testuje, to nie utrzymuje. Drugi to przechowywanie tokenu jawnym tekstem, co czasem widać wprost w opisie bazy danych albo w odpowiedziach na forum wsparcia. Trzeci to cennik uzależniony od liczby dokumentów, który przy rosnącym sklepie zamienia się w podatek od sukcesu. Czwarty to brak jakiejkolwiek wzmianki o trybach offline, co oznacza, że autor nie przemyślał scenariusza awarii, a ten scenariusz na pewno kiedyś nastąpi. Piąty wreszcie to martwe forum wsparcia, na którym pytania wiszą tygodniami bez odpowiedzi. Fakturowanie to funkcja krytyczna sklepu i zasługuje na dostawcę, który odpowiada.

Zwróć też uwagę na jakość dokumentacji. Dobra instrukcja przeprowadza od instalacji przez konfigurację tokenu po pierwszą fakturę testową i nie zakłada, że wiesz, czym jest schemat XSD. Jeżeli dostawca ma opisany cały proces krok po kroku, z zrzutami ekranu i odpowiedziami na typowe problemy, to znak, że przeszedł tę drogę z wieloma użytkownikami. Brak dokumentacji oznacza, że każdy problem będziesz rozwiązywał przez formularz kontaktowy.

Dobrym testem końcowym jest pytanie o proces aktualizacji przy zmianie przepisów. Schemat faktury już się w historii KSeF zmieniał i zmieni się znowu, podobnie jak metody uwierzytelnienia, o czym piszemy w tekście o tokenie i certyfikacie. Rozwiązanie, którego autor jasno komunikuje takie zmiany i wydaje aktualizacje z wyprzedzeniem, oszczędzi Ci nerwowych poranków po każdej nowelizacji.

Jak wypada ByteWave Faktury na tej liście

Nie ukrywamy, że ta lista kryteriów powstała na bazie naszych własnych decyzji projektowych. ByteWave Faktury waliduje każdy dokument względem XSD przed wysyłką, ma kolejkę offline z automatycznym dosyłaniem, szyfruje token algorytmem XChaCha20-Poly1305, pobiera UPO i pokazuje statusy przy zamówieniach, deklaruje zgodność z HPOS i jest testowana z najnowszym WordPressem, w tym z wersją 7.1. Środowisko testowe i produkcyjne przełączysz jednym polem w ustawieniach. Wersja darmowa pozwala wystawiać faktury bez limitu, a płatna dodaje pełną automatyzację za stałą kwotę od 69 złotych rocznie.

Niezależnie od tego, które rozwiązanie wybierzesz, przejdź przez wszystkie siedem punktów. Pół godziny sprawdzania oszczędza miesiące frustracji, a fakturowanie to ta część sklepu, która po prostu musi działać. Pełną listę możliwości naszej wtyczki znajdziesz na stronie funkcji, a darmową wersję pobierzesz z katalogu WordPress.org w kilka minut.