Spis treści
Instalacja
Aktywacja subskrypcji
Aktualizacja
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
-
Środowisko
Opis: Wybór wersji środowiska KSeF, z którą ma łączyć się system.- Wersja Demo: Środowisko testowe. Używaj go do nauki systemu i testów. Nie ma wpływu na księgowość.
- Wersja Produkcyjna: Środowisko rzeczywiste. Faktury wysłane tutaj mają moc prawną.
1. Ustawienia główne
Po instalacji wtyczki przejdź do Faktury → Raporty → KSeF, aby połączyć sklep z systemem e-Faktur.
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).
-
❌ Sprawdź numer NIP i token API.
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).
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).
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
- Otwórz stronę logowania do Krajowego Systemu e-Faktur:
https://ksef.mf.gov.pl/web/login. - Zaloguj się, korzystając z dostępnej metody uwierzytelniania, np. Profilu Zaufanego lub kwalifikowanego certyfikatu.
Przejście do sekcji tokenów
- Po zalogowaniu odszukaj w menu panelu użytkownika pozycję Tokeny → Generuj Token.
- W polu Nazwa własna tokena nadaj tokenowi czytelne oznaczenie, na przykład powiązane z Flexible Invoices i Twoim sklepem.
- W sekcji wyboru uprawnień wskaż role, które mają być powiązane z tokenem: Dostęp i Wystawianie.
Utworzenie i zapis tokena
- Zatwierdź wprowadzone ustawienia, aby system wygenerował nowy token.
- 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.