wFirma WooCommerce

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

Sprawdź wersję PRO

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

  • Ustawienia wtyczki
  • Ustawienia wtyczki
  • Ustawienia wtyczki
  • Ustawienia wtyczki
  • Ustawienia wtyczki
  • Ustawienia wtyczki
  • Ustawienia wtyczki
  • Ustawienia wtyczki
  • Ustawienia wtyczki
  • Ustawienia wtyczki
  • Ustawienia wtyczki
  • Ustawienia wtyczki
  • Ustawienia wtyczki

Instalacja

  1. Dodaj pliki wtyczki do /wp-content/plugins/invoicing-integration-for-wfirma-and-woocommerce/
  2. Włącz wtyczkę w menu „Wtyczki” w WordPress
  3. Przejdź do WooCommerce wFirma
  4. Wpisz twój klucz dostępu wFirma i klucz prywatny
  5. 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.

Recenzje

Przeczytaj 1 recenzje

Kontrybutorzy i deweloperzy

„wFirma WooCommerce” jest oprogramowaniem open source. Poniższe osoby miały wkład w rozwój wtyczki.

Zaangażowani

Wtyczka „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ą