Przegląd funkcji (Wideo)
Wprowadzenie
wFirma WooCommerce to kompleksowe rozwiązanie łączące Twój sklep WooCommerce z popularnym polskim systemem księgowym wFirma. Wtyczka występuje w dwóch wersjach:
Wersja Darmowa (FREE): Umożliwia ręczne wystawianie faktur VAT i proform, zbieranie NIP w zamówieniu, synchronizację kontrahentów oraz pobieranie dokumentów PDF.
Wersja PRO: Rozszerza darmową wtyczkę o pełną automatyzację, paragony fiskalne, integrację magazynową, obsługę MOSS/OSS oraz akcje hurtowe. Wymaga zainstalowanej darmowej wersji wtyczki.
Poniższa dokumentacja opisuje konfigurację i funkcje obu wersji.
1. Aktywacja dostępu API w wFirma
WAŻNE: Aby korzystać z integracji, musisz posiadać aktywny dostęp do API wFirma.
Pobranie kluczy API
- Zaloguj się do swojego konta na wfirma.pl
- Przejdź do: Ustawienia → Aplikacje → Klucze API
- Wygeneruj nowy klucz API (jeśli nie masz)
- Skopiuj dwa parametry:
- Access Key (klucz dostępu)
- Secret Key (klucz tajny)
Uwaga: Klucze API należy przechowywać bezpiecznie. Nie udostępniaj ich osobom trzecim.
2. Instalacja wtyczki
Wersja FREE
- Pobierz wtyczkę z repozytorium WordPress lub prześlij plik ZIP
- W panelu WordPress przejdź do: Wtyczki → Dodaj nową
- Kliknij „Wyślij wtyczkę na serwer” i wybierz plik ZIP
- Aktywuj wtyczkę
Wersja PRO
- Upewnij się, że wersja FREE jest zainstalowana i aktywowana
- Prześlij plik ZIP wersji PRO analogicznie jak wersję FREE
- Aktywuj wtyczkę PRO
- Przejdź do zakładki „Licencja” i wprowadź klucz licencyjny
3. Konfiguracja połączenia
Po aktywacji wtyczki:
- W panelu WordPress przejdź do: WooCommerce → wFirma
- W zakładce „Ustawienia” wypełnij:
- Access Key – klucz dostępu z wFirma
- Secret Key – klucz tajny z wFirma
- Kliknij przycisk „Testuj połączenie”, aby sprawdzić poprawność danych
- Jeśli test zakończy się sukcesem, kliknij „Zapisz zmiany”
Wybór firmy (dla kont wielofirmowych)
Jeśli Twoje konto wFirma obsługuje wiele firm, po poprawnym połączeniu pojawi się lista rozwijana umożliwiająca wybór firmy, dla której mają być wystawiane dokumenty.
4. Ustawienia formularza zamówienia (Checkout)
W zakładce „Sklep” możesz skonfigurować sposób wyświetlania pola NIP dla klientów.
Widoczność pola NIP
- Zawsze widoczne – pole NIP jest zawsze dostępne w formularzu zamówienia.
- Checkbox „Chcę fakturę” – pole NIP pojawia się dopiero po zaznaczeniu opcji przez klienta. (Działa tylko w klasycznym checkout, nie w WooCommerce Gutenberg Blocks)
Etykieta checkboxa
Możesz dostosować tekst wyświetlany przy checkboxie, np. „Chcę otrzymać fakturę VAT”.
Walidacja NIP
Włącz opcję „Sprawdzaj format NIP”, aby wtyczka weryfikowała poprawność numeru (czy ma dokładnie 10 cyfr) przed złożeniem zamówienia.
Wymagalność
Możesz ustawić pole NIP jako wymagane, jeśli sprzedajesz tylko firmom (B2B).
Kompatybilność z WooCommerce Blocks
Wtyczka jest w pełni kompatybilna z nowym checkout opartym na Gutenberg Blocks. Pole NIP pojawia się w sekcji adresu rozliczeniowego.
Kompatybilność z innymi wtyczkami NIP
Wtyczka automatycznie wykrywa inne popularne wtyczki dodające pole NIP (np. Pole NIP dla WooCommerce PRO) i nie dodaje swojego pola, aby uniknąć duplikacji.
5. Konfiguracja dokumentów księgowych
W zakładce „Fakturowanie” dostosujesz dane, które trafią na fakturę.
Mapowanie stawek VAT
Przypisz klasy podatkowe z WooCommerce do odpowiednich kodów w wFirma:
- Stawka ZW: Wybierz klasę podatkową dla towarów zwolnionych z VAT.
- Stawka 0%: Wybierz klasę dla stawki 0% (np. eksport).
- Stawka NP: Wybierz klasę dla towarów niepodlegających opodatkowaniu w kraju.
Standardowe stawki (23%, 8%, 5%) są rozpoznawane automatycznie na podstawie wartości podatku w zamówieniu.
Termin płatności
Ustaw domyślną liczbę dni na opłacenie faktury dla nieopłaconego zamówienia (np. 7, 14, 30 dni).
Konto bankowe
Wybierz konto bankowe z wFirma, które ma widnieć na fakturze. Lista kont jest pobierana automatycznie z Twojego konta wFirma.
Seria numeracji
Wybierz serię numeracji faktur z wFirma. Możesz mieć różne serie dla różnych typów dokumentów.
6. Automatyzacja [TYLKO PRO]
Wersja PRO umożliwia automatyczne wystawianie dokumentów bez udziału administratora. Konfiguracja znajduje się w zakładce „Automatyzacja”.
Automatyczne faktury VAT
- Włącz automatyzację: Zaznacz, aby włączyć automatyczne wystawianie faktur.
- Warunek wystawiania:
- „Dla wszystkich zamówień” – każde zamówienie otrzyma fakturę
- „Tylko z NIP” – faktury tylko dla zamówień B2B
- „Tylko bez NIP” – faktury tylko dla zamówień B2C
- Statusy zamówienia: Wybierz statusy (np. „Zrealizowane”, „W realizacji”), które uruchomią wystawienie faktury.
- Wysyłka e-mail: Automatyczna wysyłka faktury PDF do klienta.
Automatyczne faktury proforma
Idealne dla zamówień „Oczekujących na płatność”. Klient otrzymuje proformę, opłaca ją, a po zmianie statusu na „Zrealizowane” system może wystawić fakturę VAT.
Konfiguracja analogiczna jak dla faktur VAT:
- Włącz/wyłącz automatyzację
- Warunek wystawiania (wszyscy/z NIP/bez NIP)
- Statusy wyzwalające
- Automatyczna wysyłka e-mail
Automatyczne paragony
Paragony fiskalne dla klientów detalicznych (B2C). Zazwyczaj wystawiane dla zamówień bez NIP.
- Włącz/wyłącz automatyzację
- Warunek wystawiania
- Statusy wyzwalające
7. Paragony fiskalne [TYLKO PRO]
Zakładka „Paragony” umożliwia konfigurację wystawiania paragonów fiskalnych.
Seria numeracji paragonów
Wybierz odpowiednią serię numeracji dla paragonów z wFirma.
8. Integracja magazynowa [TYLKO PRO]
Zakładka „Magazyn” umożliwia dwukierunkową synchronizację stanów magazynowych między WooCommerce a wFirma.
Włączenie synchronizacji
Zaznacz opcję „Włącz synchronizację magazynu”, aby aktywować funkcję.
Dopasowywanie produktów
Określ, jak wtyczka ma dopasowywać produkty między WooCommerce a wFirma:
- Po SKU: Dopasowanie na podstawie numeru SKU produktu
- Po kodzie produktu: Dopasowanie na podstawie kodu produktu
Webhook dla aktualizacji w czasie rzeczywistym
Wtyczka generuje unikalny URL webhook, który możesz skonfigurować w wFirma. Dzięki temu zmiany stanów magazynowych w wFirma są natychmiast odzwierciedlane w WooCommerce.
- Skopiuj powyższy adres URL i wklej go w konfiguracji webhooka w systemie wFirma. Ustawienia webhooków znajdziesz w menu: Ustawienia → Webhooks.
- W ustawieniach webhooka wybierz zdarzenie „Produkty » Zmiana ilości na magazynie” oraz format danych JSON
- Wprowadź klucz webhooka otrzymany z wFirma. Po dodaniu webhooka znajdziesz wygenerowany klucz tutaj:
9. MOSS / EU VAT OSS [TYLKO PRO]
Obsługa procedury MOSS (Mini One Stop Shop) / OSS (One Stop Shop) dla sprzedaży usług cyfrowych do klientów z UE.
Konfiguracja
- Wybierz klasę podatkową WooCommerce używaną dla produktów objętych procedurą MOSS/OSS.
- Wybierz kod rodzaju usługi
- Wybierz 2 dowody
Jak to działa
Gdy klient z innego kraju UE kupuje produkt z klasą podatkową MOSS:
- Wtyczka automatycznie pobiera odpowiedni kod VAT dla kraju klienta z wFirma
- Faktura jest wystawiana z prawidłową stawką VAT kraju docelowego
- Ewidencja zawiera wymagane dowody VAT (VAT evidence)
10. Akcje hurtowe [TYLKO PRO]
Wersja PRO umożliwia wykonywanie operacji na wielu zamówieniach jednocześnie.
Dostępne akcje hurtowe
Na liście zamówień WooCommerce dostępne są dodatkowe akcje zbiorcze:
- Generuj faktury wFirma: Wystawia faktury dla wszystkich zaznaczonych zamówień
- Generuj proformy wFirma: Wystawia proformy dla zaznaczonych zamówień
- Generuj paragony wFirma: Wystawia paragony dla zaznaczonych zamówień
- Wyślij faktury e-mail: Wysyła faktury e-mailem do klientów zaznaczonych zamówień
- Wyślij proformy e-mail: Wysyła proformy e-mailem do klientów zaznaczonych zamówień
Pasek postępu
Podczas wykonywania akcji hurtowych wyświetlany jest pasek postępu z informacją o przetworzonych zamówieniach oraz podsumowanie z wynikami (sukcesy/błędy).
11. Obsługa zamówień (Panel Administratora)
Na ekranie edycji zamówienia (po prawej stronie) znajduje się panel „Faktura wFirma”.
Funkcje dostępne w obu wersjach (FREE i PRO)
- Utwórz fakturę: Ręczne wystawienie faktury VAT dla zamówienia
- Pobierz PDF: Szybkie pobranie dokumentu w formacie PDF
Funkcje dodatkowe w wersji PRO
- Utwórz paragon: Ręczne wystawienie paragonu fiskalnego
- Utwórz proformę: Ręczne wystawienie faktury proforma
- Wyślij e-mail: Ręczne wysłanie faktury/proformy e-mailem do klienta
Kolumna na liście zamówień
Na liście zamówień WooCommerce dodana jest kolumna „wFirma” pokazująca status dokumentów dla każdego zamówienia z szybkim dostępem do akcji.
12. Pobieranie faktur przez klientów
Klienci mogą pobierać swoje faktury bezpośrednio z panelu „Moje konto”.
Jak to działa
- Klient loguje się do sklepu
- Przechodzi do: Moje konto → Zamówienia
- Klika „Zobacz” przy wybranym zamówieniu
- Jeśli faktura została wystawiona, pojawia się przycisk „Pobierz fakturę”
13. Ustawienia zaawansowane
W zakładce „Zaawansowane” znajdziesz dodatkowe opcje.
Jednostka miary produktu [TYLKO PRO]
Ustaw domyślną jednostkę miary dla produktów na fakturze (np. „szt.”, „kg”, „godz.”).
Możesz także ustawić indywidualną jednostkę miary dla każdego produktu w edycji produktu WooCommerce.
Dekretacja [TYLKO PRO]
Wybierz schemat dekretacji (klasyfikacji księgowej) dla automatycznie wystawianych faktur. Schematy pobierane są z Twojego konta wFirma.
Logi i diagnostyka
Włącz opcję „Szczegółowe logi”, aby wtyczka zapisywała pełną komunikację z API wFirma w logach WooCommerce.
Logi znajdziesz w: WooCommerce → Status → Logi (plik: devikit_wfirma_debug)
Włącz tę opcję tylko w razie problemów – szczegółowe logowanie może wpływać na wydajność.
14. Licencja [TYLKO PRO]
Aby funkcje PRO działały, musisz aktywować licencję.
Aktywacja licencji
- Przejdź do: WooCommerce → wFirma → Licencja
- Wpisz klucz licencyjny otrzymany po zakupie
- Kliknij „Aktywuj”
- Status licencji musi być „Aktywna”
Informacje o licencji
Po aktywacji wyświetlane są:
- Status licencji
- Data aktywacji
- Data wygaśnięcia (jeśli dotyczy)
Dezaktywacja licencji
Możesz dezaktywować licencję, aby przenieść ją na inną stronę. Kliknij przycisk „Dezaktywuj” i potwierdź operację.
Automatyczne aktualizacje
Aktywna licencja umożliwia automatyczne aktualizacje wtyczki PRO bezpośrednio z panelu WordPress.
15. Wsparcie techniczne
Użytkownicy wersji PRO
Jeśli masz pytania, potrzebujesz pomocy w konfiguracji lub napotkałeś problem, skontaktuj się z nami bezpośrednio:
- E-mail: hi@devikit.pl
- Formularz kontaktowy: devikit.pl/kontakt
Gwarantujemy niezwłoczną pomoc dla posiadaczy aktywnej licencji PRO.
Użytkownicy wersji FREE
Wsparcie dla wersji darmowej udzielane jest na oficjalnym forum WordPress:
Forum wsparcia: wordpress.org/support/plugin/invoicing-integration-for-wfirma-and-woocommerce