Jak zintegrować WooCommerce z KSeF krok po kroku

Połączenie sklepu na WooCommerce z Krajowym Systemem e-Faktur brzmi technicznie, ale w praktyce sprowadza się do kilku przemyślanych kroków. W tym poradniku przeprowadzimy Cię przez cały proces, od przygotowania danych firmy, przez uzyskanie dostępu do systemu, aż po moment, w którym faktury zaczynają wysyłać się automatycznie po opłaceniu zamówienia. Tekst jest praktyczny, więc możesz potraktować go jako listę zadań do odhaczenia.

Zanim zaczniesz, czyli co warto przygotować

Na początek upewnij się, że dane Twojej firmy w sklepie są kompletne i poprawne. Mowa o numerze NIP, pełnej nazwie, adresie oraz danych do kontaktu. To właśnie te informacje trafią na każdą fakturę, a system nie przyjmie dokumentu z brakami. Warto też uporządkować stawki podatku przy produktach, ponieważ faktura ustrukturyzowana wymaga jednoznacznego przypisania VAT do każdej pozycji.

Drugą rzeczą jest aktualne i działające środowisko sklepu. WooCommerce powinien być w bieżącej wersji, a sam sklep dostępny przez bezpieczne połączenie. To standard, ale w przypadku komunikacji z systemem państwowym ma realne znaczenie.

Krok pierwszy, dostęp do KSeF i token

Aby sklep mógł wysyłać faktury, potrzebuje uprawnienia do działania w imieniu Twojej firmy. Uzyskujesz je w portalu KSeF, gdzie generujesz token autoryzacyjny. Token to długi ciąg znaków, który pełni funkcję klucza. Traktuj go jak hasło i nie udostępniaj nikomu postronnemu. W trakcie konfiguracji wklejasz go raz w ustawieniach integracji, a od tej pory sklep posługuje się nim przy każdej wysyłce.

Na etapie testów warto skorzystać ze środowiska testowego, które udostępnia Ministerstwo Finansów. Pozwala ono sprawdzić cały obieg faktury bez wpływu na rzeczywiste rozliczenia. Dopiero gdy upewnisz się, że wszystko działa, przełączasz integrację na środowisko produkcyjne.

Krok drugi, instalacja i konfiguracja wtyczki

Gotową integrację dla WooCommerce instalujesz tak samo jak każdą inną wtyczkę. Po aktywacji przechodzisz do ustawień, gdzie wskazujesz dane sprzedawcy, wklejasz token oraz wybierasz środowisko, czyli testowe albo produkcyjne. To dobry moment, aby skorzystać z opcji sprawdzenia połączenia, która potwierdzi, że sklep poprawnie komunikuje się z systemem.

Cały proces opisaliśmy dokładnie, ekran po ekranie, w poradniku Instalacja i konfiguracja w sześciu krokach. Jeśli wolisz mieć pewność, że nic nie pominiesz, warto mieć go otwartego obok.

Krok trzeci, pierwsza faktura testowa

Najlepszym sprawdzianem konfiguracji jest wystawienie faktury z prawdziwego zamówienia w środowisku testowym. Wybierasz zamówienie, uruchamiasz wystawienie faktury i obserwujesz, czy dokument przechodzi walidację oraz czy system nadaje mu numer. Jeżeli pojawi się komunikat o błędzie, najczęściej wskazuje on dokładnie, którego pola brakuje lub które dane wymagają poprawy. To naturalny etap i nie ma powodu się go obawiać.

Po udanym teście pobierasz UPO, czyli potwierdzenie odbioru. Gdy widzisz, że faktura została przyjęta i masz potwierdzenie, wiesz że integracja jest gotowa do pracy na żywo.

Krok czwarty, automatyzacja sprzedaży

Tu zaczyna się prawdziwa oszczędność czasu. Zamiast wystawiać każdą fakturę ręcznie, ustawiasz reguły, według których dokument powstaje i wysyła się sam. Najczęściej wybierany scenariusz to wystawienie faktury zaraz po opłaceniu zamówienia. Możesz też zdecydować, czy automatyzacja ma obejmować wyłącznie klientów firmowych z numerem NIP, czy również osoby prywatne na ich żądanie.

Dzięki temu obsługa faktur znika z listy codziennych obowiązków. Klient płaci, a sklep w tle tworzy fakturę ustrukturyzowaną, wysyła ją do KSeF i pobiera potwierdzenie. Możliwości automatyzacji, w tym masowe wystawianie i raporty, opisaliśmy na stronie funkcji wtyczki.

Co zrobić, gdy coś pójdzie nie tak

Czasem zdarza się, że system KSeF jest chwilowo niedostępny albo faktura wymaga ponownej wysyłki. Dobra integracja radzi sobie z takimi sytuacjami, kolejkując dokumenty i ponawiając próby, gdy połączenie wróci. Dzięki temu nie tracisz faktur i nie musisz pilnować całego procesu ręcznie. Warto wybrać rozwiązanie, które ma wbudowany tryb offline oraz czytelne komunikaty o stanie każdej faktury.

Integracja WooCommerce z KSeF to inwestycja, która zwraca się już po kilku dniach pracy, bo eliminuje powtarzalne czynności i ogranicza ryzyko pomyłek. Jeśli chcesz przejść tę drogę najprościej jak to możliwe, sprawdź naszą wtyczkę do automatycznych e-faktur KSeF, przygotowaną z myślą o sklepach internetowych.