Opis
wFirma WooCommerce łączy twój sklep WooCommerce z popularnym systemem księgowym wFirma, używanym przez tysiące polskich firm.
Kluczowe funkcje (DARMOWE)
- Ręczne generowanie faktur – Twórz faktury bezpośrednio z ekranu edycji zamówienia WooCommerce
- Synchronizacja klientów – Automatycznie synchronizuj dane klientów z kontrahentami wFirma
- Obsługa pola NIP – dodaj pole numeru NIP do kasy
- Obsługa bloków WooCommerce – Pełna kompatybilność z blokami kasy Gutenberg
- Zaawansowane mapowanie VAT – Mapuj klasy podatkowe WooCommerce
- Pobieranie faktur – Pobieraj faktury bezpośrednio z panelu administracyjnego WordPress
- Pobieranie przez klienta – Pozwala klientom pobierać faktury z poziomu strony Moje konto
- Uwagi do faktur – Ustaw domyślne uwagi dla wszystkich faktur i proform z zmiennymi zastępczymi ({order_number}, {customer_name}, itd.)
- Szczegółowe logowanie – śledź całą komunikację API na potrzeby debugowania
- Zgodny z HPOS – pełna obsługa wysokowydajnego systemu przechowywania zamówień WooCommerce
Funkcje PRO
- Automatyczne generowanie faktur – Twórz faktury automatycznie przy zmianie statusu zamówienia
- Automatyczne faktury pro forma – Automatyczne wystawianie faktur pro forma przy zmianie statusu zamówienia
- Obsługa paragonów – Automatyczne generowanie paragonów dla klientów detalicznych, w tym paragonów fiskalnych oraz dowodów sprzedaży / paragonów niefiskalnych
- Uwagi do paragonów – Ustaw domyślne uwagi dla wszystkich paragonów z użyciem zmiennych zastępczych ({order_number}, {customer_name}, itp.)
- E-mail z załącznikami PDF – Wysyłaj faktury bezpośrednio do klientów jako załączniki PDF
- Zbiorcze generowanie dokumentów – Generuj faktury, proformy i paragony dla wielu zamówień jednocześnie z podglądem postępu
- Zbiorcze wysyłanie e-maili – Wysyłaj faktury i proformy e-mailem do wielu klientów zbiorczo
- Obsługa MOSS / unijnego VAT OSS – Automatyczna obsługa MOSS dla usług cyfrowych sprzedawanych klientom z UE z odpowiednimi fakturami VAT
- Zaawansowana automatyzacja – Skonfiguruj wiele statusów wyzwalaczy i warunków
- Ryczałt ewidencjonowany – Globalne i per‑produkt ustawienia podatku ryczałtowego (ryczałtu) z automatycznym identyfikatorem stawki na fakturach i paragonach
- Dekretacja – Księgowa klasyfikacja faktur
- Integracja magazynu – Dwukierunkowa synchronizacja stanów magazynowych między WooCommerce a wFirma
- Webhooki w czasie rzeczywistym – Natychmiastowe aktualizacje stanów magazynowych z wFirma
- WooCommerce Subscriptions – Pełne wsparcie dla cyklicznych zamówień
- Priorytetowa pomoc techniczna – Bezpośredni kontakt z naszym zespołem pomocy technicznej
- Automatyczne aktualizacje – Otrzymuj nowe funkcje i poprawki automatycznie
Wymagania
- WordPress 5.8 lub wyższy
- WooCommerce 5.0 lub wyższy
- PHP 7.4 lub wyższy
- Aktywne konto wFirma z dostępem do API
Usługi zewnętrzne
Ta wtyczka opiera się na API wFirma, zewnętrznej usłudze księgowej, aby generować faktury i zarządzać danymi klientów.
Czym jest wFirma API?
wFirma to polski internetowy system księgowy, który zapewnia usługi fakturowania i księgowości dla firm. Ta wtyczka korzysta z oficjalnego API, aby:
* Tworzyć i zarządzać klientami (kontrahentami) na twoim koncie wFirma.
* Generować faktury i faktury proforma (wersja PRO).
* Generować paragony fiskalne oraz niefiskalne (dowody sprzedaży) dla klientów detalicznych (wersja PRO).
* Pobierać rachunki bankowe, kody VAT i inne dane księgowe z twojego konta wFirma.
* Pobierać pliki PDF faktur.
* Synchronizować stany magazynowe pomiędzy WooCommerce a wFirma (wersja PRO).
Jakie dane są wysyłane i kiedy?
Wtyczka wysyła następujące dane do API wFirma (https://api2.wfirma.pl/) w następujących sytuacjach:
Po kliknięciu „Utwórz fakturę” lub gdy zostanie uruchomione automatyczne generowanie faktury (wersja PRO):
* Dane rozliczeniowe klienta: imię, nazwisko, nazwa firmy, numer VAT (NIP), e-mail, numer telefonu, adres rozliczeniowy (ulica, miasto, kod pocztowy, kraj).
* Informacje o zamówieniu: pozycje zamówienia (nazwy produktów, ilości, ceny, stawki VAT), szczegóły wysyłki, metoda płatności, data zamówienia, łączna kwota zamówienia.
Gdy wtyczka łączy się z wFirma API (podczas wczytywania strony ustawień lub gdy jest to potrzebne):
* Twój klucz dostępu wFirma i klucz prywatny (do uwierzytelniania).
* Żądania pobrania ustawień twojego konta: rachunków bankowych, stawek VAT, kategorii przychodów, danych magazynowych (wersja PRO).
Żadne dane nie są wysyłane automatycznie bez twojej akcji. Wtyczka komunikuje się z API wFirma tylko wtedy, gdy:
* Ręcznie tworzysz fakturę z ekranu zamówienia.
* Włączasz automatyczne generowanie faktur w wersji PRO.
* Otwierasz stronę ustawień wtyczki (aby wczytywać konfigurację konta).
* Synchronizacja magazynu jest włączona w wersji PRO (webhook).
Informacje o dostawcy usług
- Nazwa usługi: wFirma API
- Adres URL usługi: https://www.wfirma.pl/
- Dokumentacja API: https://doc.wfirma.pl/
- Regulamin świadczenia usług: https://pomoc.wfirma.pl/-regulamin-swiadczenia-uslug
- Polityka prywatności: https://pomoc.wfirma.pl/-polityka-prywatnosci
Korzystając z tej wtyczki, przyjmujesz do wiadomości, że dane klientów oraz zamówień będą przekazywane do wFirma w celu wystawiania faktur. Odpowiadasz za zapewnienie zgodności z obowiązującymi przepisami o ochronie danych (w tym RODO) oraz poinformowanie klientów o takim przetwarzaniu danych.
Zrzuty ekranu
Instalacja
- Dodaj pliki wtyczki do
/wp-content/plugins/invoicing-integration-for-wfirma-and-woocommerce/ - Włącz wtyczkę w menu „Wtyczki” w WordPress
- Przejdź do WooCommerce wFirma
- Wpisz twój klucz dostępu wFirma i klucz prywatny
- Przetestuj połączenie i skonfiguruj ustawienia
Najczęściej zadawane pytania
-
Gdzie znajdę moje klucze API wFirma?
-
Zaloguj się do twojego konta wFirma, przejdź do Ustawienia Aplikacje Klucze API i wygeneruj swój klucz dostępu oraz klucz prywatny.
-
Czy to działa z WooCommerce Blocks?
-
Tak, wtyczka jest zgodna z zarówno klasycznym procesem realizacji zamówienia, jak i procesem realizacji zamówienia WooCommerce Blocks.
-
Czy klienci mogą pobierać swoje faktury?
-
Tak, klienci mogą pobierać faktury ze strony Moje konto Zobacz zamówienie.
-
Czy to jest zgodne z wtyczką nip-field-woocommerce?
-
Tak! Wtyczka automatycznie wykrywa, czy nip-field-woocommerce jest aktywna i używa jej zamiast dodawać własne pole NIP.
Kontrybutorzy i deweloperzy
„wFirma WooCommerce” jest oprogramowaniem open source. Poniższe osoby miały wkład w rozwój wtyczki.
ZaangażowaniWtyczka „wFirma WooCommerce” została przetłumaczona na 1 język. Podziękuj tłumaczom za ich wkład.
Przetłumacz wtyczkę “wFirma WooCommerce” na swój język.
Interesuje cię rozwój wtyczki?
Przeglądaj kod, sprawdź repozytorium SVN lub czytaj dziennik rozwoju przez RSS.
Rejestr zmian
1.0.12
- Fixed: save_admin_order_nip – WooCommerce may pass WP_Post instead of WC_Order; use instanceof WC_Order check to avoid „Call to undefined method WP_Post::update_meta_data()”
1.0.11
- Dodano: NIP jest teraz edytowalny w panelu administratora zamówień (sekcja rozliczeniowa) – tak jak pola adresu
- Ulepszone: usunięto zduplikowane tylko do odczytu wyświetlanie NIP podczas edycji zamówienia
1.0.10
- Naprawiono: Zapobieganie duplikowaniu faktur, gdy create_invoice_for_order jest wywoływane wielokrotnie (np. podczas masowego generowania)
1.0.9
- Dodano: Ostrzeżenie o całkowitej rozbieżności (zamówienie vs suma faktury/proformy) jest teraz wyświetlane w kolumnie wFirma na liście zamówień, a nie tylko w metaboxie zamówienia
- Ulepszone: Zbiorcze generowanie faktur – widoczne na pierwszy rzut oka wykrywanie niezgodności na liście zamówień
1.0.7
- Ulepszono: polskie tłumaczenia dla uwag na fakturze i napisów związanych z paragonami
- Ulepszone: sekcja Uwagi na paragonie wyszarzona w wersji DARMOWEJ (funkcja PRO)
- Ulepszone: dokumentacja Readme – globalne uwagi do faktur, uwagi do paragonów, ryczałt
1.0.6
- Dodano: globalne uwagi do faktur w ustawieniach – domyślne uwagi dla wszystkich faktur i faktur proforma
- Dodano: globalne uwagi paragonów w ustawieniach – domyślne uwagi dla niefiskalnych dowodów sprzedaży
- Dodano: Zmienne pola podstawienia dla uwag: {order_id}, {order_number}, {customer_name}, {order_total} itd. (takie same jak w Fakturowni)
1.0.5
- Dodano: 5‑minutowe opóźnienie wysyłki e-maili dla automatycznych faktur, aby umożliwić przetwarzanie w KSeF (Krajowy System e-Faktur)
- Dodano: obsługę Action Scheduler do opóźnionej wysyłki e-maila z fakturą
- Ulepszenie: Ręczne wysyłanie e-maili z panelu administracyjnego oraz e-maile z proformą/paragonem nadal są wysyłane natychmiastowo
- Dodano: polskie tłumaczenia nowych komunikatów o opóźnieniu KSeF
1.0.4
- Dodano: Zrzuty ekranu dodane do katalogu zasobów wtyczki i dokumentacji readme
1.0.3
- Dodano: Informacje o obsłudze dowodów sprzedaży / paragonów niefiskalnych w wersji PRO do pliku readme
- Ulepszenie: interfejs użytkownika wersji FREE teraz pokazuje wszystkie funkcje PRO, w tym wysyłanie e-mail, termin płatności oraz ustawienia konta bankowego dla paragonów
- Naprawiono: Dodano brakujące tłumaczenia dla funkcjonalności e-maila z paragonem
1.0.2
- Dev: Automatyzacja wydania dla WordPress.org SVN (bez zmian funkcjonalnych)
1.0.1
- Naprawiono: Dodano wsparcie dla serii faktur bez VAT (rodzaj rachunku) oprócz faktur VAT (zwykły rodzaj)
- Naprawiono: użytkownicy mogą teraz wybierać spośród wszystkich dostępnych serii faktur, a nie tylko faktur VAT
- Naprawiono: rodzaj faktury jest teraz prawidłowo ustawiany na podstawie wybranego rodzaju serii, aby zapobiec błędom w przypadku firm niebędących podatnikami VAT.
1.0.0
- Początkowe wydanie
- Ręczne generowanie faktur
- Synchronizacja klientów
- Zaawansowane mapowanie VAT
- Pobieranie faktury klienta
- Obsługa pola NIP z kompatybilnością












