Faktury WooCommerce – KSeF

Instalacja

Instrukcja instalacji →

Aktywacja subskrypcji

Instrukcja aktywacji →

Aktualizacja

Instrukcja aktualizacji →

Co robi wtyczka

Podstawową funkcją dodatku jest rozszerzenie działania wtyczki Faktury WooCommerce, lub Faktury WooCommerce PRO o opcję wysyłania faktur do Krajowego Systemu e-Faktur (KSeF).

Wymagania

Faktury WooCommerce – KSeF wymagają do działania:

• • Faktur WooCommerce w wersji min. 6.2.0 lub
  • Faktur WooCommerce PRO w wersji min. 5.3.0

1. Ustawienia główne

Po instalacji wtyczki przejdź do Faktury → Raporty → KSeF, aby połączyć sklep z systemem e-Faktur.

• Środowisko
  Opis: Wybór wersji środowiska KSeF, z którą ma łączyć się system.
  • Wersja Test: Środowisko testowe umożliwiające swobodne testowanie integracji. Możesz zalogować się przy użyciu dowolnych danych i wystawiać dowolne faktury. Wystawiane dokumenty nie mają skutku prawnego. W przeciwieństwie do wersji Demo, środowisko Test różni się uproszczonym sposobem logowania.
  • Wersja Demo: Środowisko testowe. Używaj go do nauki systemu i testów. Nie ma wpływu na księgowość. Wymaga logowania zgodnie z zasadami środowiska demo KSeF.
  • Wersja Produkcyjna: Środowisko rzeczywiste. Faktury wysłane tutaj mają moc prawną.

2. Token

• Token
  Opis: Unikatowy klucz API (ciąg alfanumeryczny), który autoryzuje Twój system w KSeF.
  • Gdzie znaleźć: Token generuje się w oficjalnej aplikacji Ministerstwa Finansów (KSeF). Instrukcja generowania tokenu dostępna jest tutaj.
• Status Weryfikacji
  Opis: Informacja o poprawności wprowadzonych danych.
  • ❌ Sprawdź numer NIP i token API.
    Jeśli widzisz ten komunikat, oznacza to błąd logowania. Sprawdź, czy wpisany NIP oraz Token są poprawne i czy odpowiadają wybranemu środowisku (Demo/Produkcja).

3. Automatyczna Wysyłka

• Automatycznie wysyłaj do KSeF po zapisaniu faktury
  Opis: Decyduje o momencie wysłania faktury do urzędu.
  • Zaznaczone: System wyśle fakturę do KSeF automatycznie w momencie jej zapisania w programie.
  • Odznaczone: Faktura pomimo zapisu do sklepu nie zostanie wysłana do KSeF i będzie wymagała ręcznego kliknięcia Wyślij do KSeF.

4. Domyślne Ustawienia Stawek

System musi wiedzieć, jak mapować specyficzne stawki VAT na kody wymagane przez KSeF.

• Stawka ZW (Zwolniona)
  Opis: Wybierz z listy pozycję, której używasz w systemie do oznaczania sprzedaży zwolnionej z podatku.
  • Przykład: Wybierz opcję “Podatek” lub “ZW”.
  • Ważne: Jeśli wystawiasz faktury ze stawką “ZW”, to pole jest obowiązkowe, aby uniknąć błędów walidacji.
• Stawka 0%
  Opis: Wybierz z listy pozycję, której używasz w systemie do oznaczania sprzedaży ze stawką 0%.
  • Przykład: Wybierz opcję “VAT” lub “0%”.
  • Ważne: Konieczne do poprawnego raportowania transakcji ze stawką 0% (np. eksport towarów).

Wtyczka zaciąga stawki i ich opisy bezpośrednio z ustawień podatkowych sklepu WooCommerce.

Ręczna rejestracja faktur do w KSeF

Faktury możesz zarejestrować w KSeF na trzy sposoby:

• Automatycznie – po włączeniu opcji w ustawieniach głównych wtyczki.
• Ręcznie, masowo – za pomocą masowych akcji na liście faktur (Faktury → Wszystkie).
• Ręcznie, pojedynczo w metaboxie w edycji faktury Faktury → Wszystkie → Numer faktury).

Pobieranie XML faktury do weryfikacji

W niektórych scenariuszach — na przykład podczas testów, audytów księgowych lub weryfikacji poprawności danych wysyłanych do KSeF — może być konieczne pobranie wygenerowanego pliku XML faktury. Integracja umożliwia udostępnienie pliku XML bezpośrednio z poziomu edycji dokumentu w panelu administracyjnym WordPressa.

Poniższe filtry pozwalają włączyć możliwość pobierania pliku XML i (w razie potrzeby) zmodyfikować jego nazwę.

Filtry należy dodać do pliku functions.php. Możesz to zrobić np. przechodząc w swoim panelu WordPress do Wygląd → Edytor plików motywu → functions.php.

Włączenie przycisku „Download XML” w metaboxie

Przycisk „Download XML” w metaboxie dokumentu jest domyślnie wyłączony. Aby umożliwić ręczne pobieranie pliku XML faktury do weryfikacji, należy włączyć go za pomocą odpowiedniego filtra.
add_filter( 'fiksef_download_xml_button_enabled', '__return_true' );
Po zastosowaniu filtra przycisk „Download XML” będzie widoczny w metaboxie dokumentu w panelu administracyjnym WordPressa.

Zmiana nazwy generowanego pliku XML

Po włączeniu przycisku pobierania możesz dodatkowo zmienić nazwę generowanego pliku XML. Jest to przydatne m.in. wtedy, gdy plik ma być archiwizowany lub przekazywany do zewnętrznych systemów.
add_filter( 'fiksef_download_xml_filename', function ( $default ) {
return 'other_filename.xml';
} );

Wartość other_filename.xml należy zastąpić nazwą pliku, jaką chcesz nadać pobieranemu plikowi XML.

Generowanie tokena autoryzacyjnego w KSeF

Token autoryzacyjny w Krajowym Systemie e-Faktur służy do łączenia zewnętrznych programów,
takich jak aplikacje do fakturowania, z kontem podatnika w KSeF.

Wejście do systemu KSeF

1. Otwórz stronę logowania do Krajowego Systemu e-Faktur:
   https://ap.ksef.mf.gov.pl/web/.
2. Zaloguj się, korzystając z dostępnej metody uwierzytelniania, np. Profilu Zaufanego lub kwalifikowanego certyfikatu.

Przejście do sekcji tokenów

1. Po zalogowaniu odszukaj w menu panelu użytkownika pozycję Tokeny → Generuj Token.
2. W polu Nazwa własna tokena nadaj tokenowi czytelne oznaczenie, na przykład powiązane z Flexible Invoices i Twoim sklepem.
3. W sekcji wyboru uprawnień wskaż role, które mają być powiązane z tokenem: Dostęp i Wystawianie.

Utworzenie i zapis tokena

1. Zatwierdź wprowadzone ustawienia, aby system wygenerował nowy token.
2. Po utworzeniu tokena wyświetli się jego wartość – skopiuj ją i wklej do pola Token w Fakturach WooCommerce.

Bezpieczeństwo tokena

Token należy traktować jak dane logowania – nie udostępniać osobom trzecim oraz w razie podejrzenia naruszenia bezpieczeństwa wygenerować nowy i usunąć poprzedni.