Spis treści
Czym są wtyczki WordPress do KSeF
Wtyczki WordPress do KSeF to dodatki, które łączą Twój sklep WooCommerce z Krajowym Systemem e-Faktur i pozwalają wysyłać e-faktury w wymaganym przez państwo formacie. Najczęściej działają one jako rozszerzenie istniejącej wtyczki do fakturowania, takiej jak Faktury WooCommerce lub Faktury PDF WooCommerce, dodając do niej funkcję wysyłki dokumentów do KSeF.
Tego typu wtyczka pobiera dane z zamówienia, generuje fakturę, przekształca ją do formatu XML zgodnego z wymaganiami KSeF i wysyła do systemu Ministerstwa Finansów, a następnie zapisuje numer KSeF oraz status wysyłki przy danym dokumencie. Dzięki temu nie trzeba logować się osobno do zewnętrznego programu, a pełen obieg zamówienie – płatność – faktura – KSeF odbywa się w jednym miejscu.
Typowe scenariusze użycia wtyczek KSeF na WordPressie
Najczęściej integracja z KSeF jest potrzebna w sklepach WooCommerce, które wystawiają faktury dla firm i muszą raportować je do Krajowego Systemu e-Faktur. W takim scenariuszu wtyczka automatycznie tworzy fakturę po złożeniu i opłaceniu zamówienia, po czym wysyła ją do KSeF i zapisuje informację o powodzeniu lub błędzie.
Coraz częściej integracje KSeF wdrażane są także na stronach usługowych na WordPressie, gdzie klient zamawia usługę przez formularz, a system automatycznie generuje fakturę i wysyła ją do KSeF wraz z potwierdzeniem do klienta. W obu przypadkach celem jest wyeliminowanie ręcznego przepisywania danych i ograniczenie ryzyka pomyłek przy wysyłce faktur do systemu.
Popularne wtyczki KSeF dla WooCommerce
Jednym z popularnych rozwiązań dostępnych w oficjalnym repozytorium WordPress jest wtyczka „KSeF – wysyłka e-faktur”, która działa jako dodatek do Faktury PDF WooCommerce. Umożliwia ona wysyłkę pojedynczych lub wielu faktur naraz z panelu WordPress do KSeF, pokazuje status rejestracji, datę, identyfikator referencyjny oraz ewentualne błędy zwrócone przez API KSeF.
Z kolei dodatek „Faktury WooCommerce – KSeF” rozszerza wtyczkę Faktury WooCommerce lub Faktury WooCommerce PRO o funkcję wysyłki faktur do KSeF, z możliwością automatycznego lub ręcznego rejestrowania dokumentów oraz pobierania pliku XML bezpośrednio z edycji faktury. Na rynku dostępne są także komercyjne wtyczki dedykowane KSeF dla WooCommerce, które oferują między innymi pobieranie UPO, tryb offline oraz różne warianty licencji abonamentowej.
Istnieją również integracje oparte na zewnętrznych systemach fakturowych, takich jak Fakturownia czy inFakt, gdzie specjalna wtyczka WooCommerce wysyła dane zamówienia do zewnętrznego systemu, a ten zajmuje się generowaniem i wysyłką faktur do KSeF. Takie podejście bywa wygodne, jeśli firma i tak korzysta już z danego systemu księgowego i chce mieć wszystkie dokumenty w jednym miejscu.
Jak działają wtyczki KSeF od strony użytkownika
Z punktu widzenia użytkownika obsługa wtyczki KSeF sprowadza się najczęściej do instalacji, wprowadzenia danych autoryzacyjnych oraz wybrania, czy faktury mają być wysyłane automatycznie czy ręcznie. Po złożeniu zamówienia w WooCommerce wtyczka do fakturowania generuje dokument, a dodatek KSeF konwertuje go do formatu XML i inicjuje wysyłkę do systemu Ministerstwa Finansów.
Po udanej wysyłce w panelu WordPress przy fakturze widoczny jest status, data rejestracji oraz identyfikator KSeF, co umożliwia łatwe sprawdzenie, czy dokument został poprawnie zarejestrowany. W przypadku błędów wtyczka najczęściej pokazuje komunikat zwrócony przez API KSeF, co pozwala szybko zidentyfikować problem, na przykład niepoprawne dane nabywcy czy błąd w konfiguracji tokena.
Token KSeF i połączenie z systemem Ministerstwa Finansów
Aby wtyczka mogła wysyłać faktury w imieniu Twojej firmy, potrzebny jest tzw. token autoryzacyjny, czyli specjalny klucz generowany w panelu Krajowego Systemu e-Faktur. Taki token działa jak hasło dostępu, które wpisujesz w ustawieniach wtyczki, żeby mogła połączyć się z KSeF i rejestrować faktury w Twoim imieniu.
Token generuje się po zalogowaniu na konto w KSeF i wybraniu odpowiednich uprawnień, najczęściej dostępu i wystawiania faktur, a następnie jego wartość wkleja się do pola w konfiguracji wtyczki. Token należy traktować jak poufne dane logowania i w razie podejrzenia wycieku wygenerować nowy.
Automatyczna vs ręczna wysyłka faktur do KSeF
Większość wtyczek KSeF oferuje wybór między automatyczną a ręczną wysyłką faktur. W trybie automatycznym faktura po zapisaniu jest natychmiast wysyłana do KSeF, co dobrze sprawdza się przy prostych procesach sprzedaży i dużej liczbie zamówień.
W trybie ręcznym możesz sam decydować, które faktury trafią do KSeF, wysyłając je pojedynczo z poziomu edycji dokumentu lub masowo z listy faktur, korzystając z akcji zbiorczych. Takie podejście przydaje się na początku wdrożenia lub w sytuacji, gdy część faktur jest wystawiana dla klientów, których nie trzeba raportować w KSeF.
Kryteria wyboru wtyczki KSeF do WordPressa
Przy wyborze wtyczki KSeF warto zacząć od sprawdzenia, czy współpracuje ona z Twoją obecną wtyczką do fakturowania, na przykład Faktury PDF WooCommerce, Faktury WooCommerce lub zewnętrznym systemem fakturowym. Kluczowe jest też to, czy wtyczka używa aktualnej wersji struktury faktur oraz oficjalnego API KSeF, co gwarantuje zgodność z przepisami.
Dobrze jest zwrócić uwagę na dostępne tryby wysyłki (automatyczna, ręczna, masowa), możliwość pobierania pliku XML i identyfikatora KSeF oraz czytelne komunikaty błędów. W przypadku większych sklepów znaczenie ma też dostępność wsparcia technicznego i regularne aktualizacje, aby integracja działała poprawnie przy zmianach w przepisach lub API.
Kroki wdrożenia wtyczki KSeF na hostingu
Z technicznego punktu widzenia wdrożenie zwykle zaczyna się od zainstalowania i skonfigurowania wtyczki do fakturowania, która będzie generować faktury w Twoim sklepie. Następnie instalujesz dodatek KSeF, na przykład KSeF – wysyłka e-faktur lub Faktury WooCommerce – KSeF, i w jego ustawieniach wpisujesz dane firmy oraz token autoryzacyjny wygenerowany w panelu KSeF.
Kolejnym krokiem jest wybór środowiska: testowego (sandbox) lub produkcyjnego, przy czym dobrym zwyczajem jest rozpoczęcie od środowiska testowego, żeby spokojnie sprawdzić konfigurację. Po pomyślnych testach można włączyć środowisko produkcyjne, ustawić automatyczną wysyłkę faktur lub pozostać przy wysyłce ręcznej i wdrożyć nowe zasady pracy w zespole.
Od strony hostingu ważne jest, aby strona działała stabilnie, korzystała z aktualnej wersji PHP oraz aby nie blokować połączeń wychodzących do adresów API KSeF i ewentualnych usług pośredniczących. Przy większej liczbie zamówień warto też zadbać o wydajność serwera i odpowiednią konfigurację zadań cron w WordPressie, jeśli wtyczka wykorzystuje je do kolejkowania wysyłki faktur.
Najczęstsze problemy i jak ich uniknąć
Jednym z najczęstszych problemów jest założenie, że sama instalacja wtyczki KSeF wystarczy, bez przetestowania pełnego procesu wystawiania i wysyłki faktur. Konieczne jest poprawne skonfigurowanie danych firmy, danych klientów, stawek VAT oraz przetestowanie integracji w środowisku testowym KSeF przed przejściem na produkcję.
Problemy często pojawiają się także przy źle wygenerowanym lub wprowadzonym tokenie KSeF, co skutkuje błędami autoryzacji po stronie systemu Ministerstwa Finansów. Aby tego uniknąć, warto dokładnie przejść procedurę generowania tokena, zachować go w bezpiecznym miejscu i w razie wątpliwości ponownie wygenerować.
W większych sklepach niewłaściwie zaplanowany obieg dokumentów potrafi doprowadzić do chaosu, gdy część faktur jest wysyłana automatycznie, część ręcznie, a część wcale. Dobrym rozwiązaniem jest spisanie prostych procedur, określenie, kto odpowiada za kontrolę statusów KSeF i monitorowanie błędów, a przy bardziej skomplikowanych instalacjach – zlecenie konfiguracji specjaliście od WooCommerce i KSeF.
