WP Desk Care - zadbaj o swój biznes online!

Sprawdzona opieka techniczna dla Twojego sklepu

wFirma WooCommerce

Spis treści

Instalacja

Instrukcja instalacji →

Aktywacja Subskrypcji

Aktywacja subskrypcji →

Aktualizacja

Instrukcja aktualizacji →

Zasada działania wtyczki

Wtyczka wystawia faktury do zamówień WooCommerce w następujący sposób. Informacje z zamówienia są przesyłane do serwisu księgowego wFirma, gdzie zamówienie jest odnotowywane, a wraz z nim wystawiana jest faktura/paragon.

Następnie w sklepie WooCommerce, w zamówieniu generowany jest link, który umożliwia pobranie faktury w formie pliku PDF na urządzenie, z którego zarządzasz sklepem. Wtyczka pozwala również synchronizować magazyny, o czym szerzej piszemy w dokumentacji.

Konto w wFirma

Korzystanie z wtyczki wymaga posiadania konta w serwisie wFirma, jeśli jeszcze nie masz konta, zarejestruj się →

Ustawienia główne

Ustawienia zlokalizowane są w menu WooCommerce → Ustawienia → Integracja → wFirma

Aby uniknąć różnic wynikających z zaokrągleń podatków, w WooCommerce należy przy opcji “Ceny wpisywane z podatkiem” zaznaczyć opcję “Nie, będę wpisywać ceny bez podatku”. Zmiana tego ustawienia będzie wymagała aktualizacji cen przy produktach.​​​​​

Autoryzacja w wFirma

WooCommerce wFirma – Autoryzacja w wFirma

Login – login w serwisie wFirma.

Hasło – hasło w serwisie wFirma.

Wtyczka obsługuje wyłącznie autoryzację przy pomocy loginu i hasła. W serwisie wFirma logowanie dwuetapowe musi być wyłączone.
Ważne: Jeśli posiadasz kilka firm na jednym koncie w serwisie księgowym i chcesz zintegrować ze sklepem konkretny podmiot, możesz to zrobić poprzez dodanie do konta firmy w wFirma, pracownika. Wówczas przy integracji WooCommerce i wFirma należy podać dane do logowania do tego konkretnego użytkownika, który z kolei ma dostęp do tylko tej jednej firmy.

 

Autoryzacja za pomocą OAuth 2.0.

Ważne: od początku lipca zmienia się spsób autoryzacji w wFirma z Basic na OAuth 2.0.

W tym celu, aby dokonać autoryzacji przejdź po zalegowaniu do panelu wFirmy :

Kliknij “Ustawienia“.

Następnie w sekcji “Bezpieczeństwo” kliknij “Aplikacje“.

Następnie klinij “Dodaj”.

Po wykonaniu tego kroku pojawi się okno poniżej :

  • W polu : “Nazwa aplikacji” wpisz wartość intuicyjną dla Ciebie np. nazwę firmy,
  • W polu : “Zakres (scope)” wybierz :  wszystkie 
  • W polu: “Adres zwrotny” – adres zwrotny, który jest w ustawieniach wtyczki (obraz poniżej) :

  • W polu: “Adres zwrotny” – adres zwrotny, który jest w ustawieniach wtyczki (obraz poniżej) :
  • W polu : “Adres IP klienta” – 127.0.0.1
Ważne: po podłączeniu proszę skontaktować się z wFirma, aby zmienić adres IP klienta na “dowolny”

Po zaakceptowaniu aplikacji ze strony wFirmy w naszej aplikacji pojawi się ID klienta, który następnie należy uzupełnić w ustawieniach wtyczki :

Autoryzacja za pomocą klucza API

W tym celu, aby dokonać autoryzacji przejdź po zalogowaniu do panelu wFirmy.

Kliknij “Ustawienia“.

Następnie w sekcji “Bezpieczeństwo” kliknij “Aplikacje“.

Następnie w sekcji “Klucze API” kliknij “Dodaj“.

 

Następnie w sekcji “Nazwa aplikacji” wpisz wartość intuicyjną np. nazwa firmy.

Aby zautoryzować operację należy wpisać swoje hasło do portalu wFirma.

Po uzupełnieniu hasła pojawią się nasze klucze do wpisania w ustawieniach wtyczki w zakładce “Autoryzacja w wFirma”.

 

Ważne! Secret key pojawi się jednorazowo, dlatego skopiuj go w bezpieczne miejsce. Nie będzie możliwości, aby zobaczyć go drugi raz.

 

Uzupełnij pola zaznaczone na  czerwone  zgodnie z tym, które pojawiły się w oknie podczas tworzenia kluczy.

Po wykonaniu tej czynności skontaktuj się za pomocą tego adresu : https://wfirma.pl/kontakt/1#appKey wFirma w celu nadania App Key dla nowej aplikacji, która przed chwilą została utworzona.

Gdy uzyskasz kod App Key wpisz go w polu zaznaczonym na niebiesko. 

Dodawanie domyślnej firmy do wystawiania dokumentów

Jeżeli posiadasz więcej kont w wFirma potrzebne będzie wprowadzenie ID firmy, z którego będą wystawiane dokumenty.

W tym celu po zalogowaniu do https://wfirma.pl wybierz firmę z listy.

Następnie przejdź do ustawień.

ID firmy (dla którego mają zostać wystawione dokumenty) znajdziesz w polu zaznaczonym na czerwono powyżej.

Skopiuj ten numer i następnie wprowadź go w ustawieniach wtyczki. (Od wersji 2.7.2.)

Następnie zapisz zmiany.

 

 

 

 

 

Paragony

WooCommerce wFirma – Ustawienia paragonów

Wystawianie paragonów

Wystawianie paragonów – sposób wystawiania paragonów.

  • Ręcznie – paragony nie będą wystawiane automatycznie. Wystawianie paragonów będzie dostępne w edycji zamówienia po jego opłaceniu.
  • Zawsze (automatycznie) – paragony będą wystawiane automatycznie po zmianie statusu zamówienia wg. ustawienia Status zamówienia.
  • Automatycznie, jeśli kupujący nie chce faktury – paragony będą wystawiane automatycznie w momencie osiągnięcia przez zamówienie określonego statusu wg ustawienia Status zamówienia, ale tylko pod warunkiem że kupujący nie zaznaczy opcji “Chcę otrzymać fakturę” (więcej informacji poniżej)

Status zamówienia – w przypadku automatycznego wystawiania paragonów, wybierz status zamówienia przy którym paragon zostanie automatycznie wystawiony.

Rodzaj paragonu – wybierz rodzaj paragonu Fiskalny lub Niefiskalny. Paragony fiskalne należy skonfigurować w panelu wFirma.

Ważne: Paragon fiskalny, w przeciwieństwie do paragonu niefiskalnego nie zostanie pobrany/otworzony w formacie PDF z linku wygenerowanego do zamówienia. Możesz go wydrukować w serwisie księgowym wFirma, o czym szerzej piszemy w tym poradniku.

Automatycznie wysyłaj paragony po wystawieniu – dotyczy wyłącznie paragonów niefiskalnych. Paragony fiskalne muszą być wydrukowane na drukarce fiskalnej i ich postać elektroniczna nie jest dostępna.

Parametry paragonu

Termin płatności dla paragonów wysyłkowych – termin płatności dla paragonów wysyłkowych w dniach.

Seria numeracji paragonów niefiskalnych – seria numeracji zdefiniowana w serwisie wFirma.

Numer konta bankowego – numer konta bankowego widoczny na paragonie. Konto bankowe musi być zdefiniowane w serwisie wFirma.

Nr zamówienia w uwagach – w uwagach do paragonu zostanie dopisany numer zamówienia.

Metoda płatności w uwagach – jeśli potrzebujesz dodać informację o metodzie płatności np. PayU, zaznacz tą opcję.

Tekst przy metodzie płatności – jeśli włączyłeś Metoda płatności w uwagach możesz wpisać dodatkowy tekst, który pojawi się przed metodą płatności np. Zapłacono przez:.

Etykiety (tagi) paragonów – jeśli masz skonfigurowane etykiety w wFirmie to możesz wybrać etykietę którą będą oznaczane paragony np. sklepzetykieta.pl

Faktury

Wystawianie faktur - ekran konfiguracji wtyczkiWystawianie faktur

Konfiguracja faktur we wtyczce wFirma

Wystawianie faktur – sposób wystawiania faktur.

    • Ręcznie – faktury nie będą wystawiane automatycznie. Wystawianie dokumentów fiskalnych będzie dostępne w edycji zamówienia po jego opłaceniu.
    • Pytaj kupującego i nie wystawiaj automatycznie – zaznacz jeśli chcesz aby kupujący zdecydował czy chce otrzymać fakturę i wystaw ją ręcznie.
    • Pytaj kupującego i wystawiaj automatycznie – zaznacz jeśli chcesz aby kupujący zdecydował czy chce otrzymać fakturę i została ona wystawiona automatycznie.

Status zamówienia – w przypadku automatycznego wystawiania  faktur, wybierz status zamówienia przy którym faktura zostanie automatycznie wystawiona.

Jeśli zostanie wybrana opcja Pytaj kupującego… w trakcie składania zamówienia w Szczegółach płatności pojawi się opcja zaznaczenia przez kupującego Chcę otrzymać fakturę VAT.

  • Automatycznie – faktury będą wystawiane automatycznie po zmianie statusu zamówienia wg. ustawienia Status zamówienia.

Automatycznie wysyłaj faktury po wystawieniu – zaznacz jeśli chcesz aby faktury były wysyłane automatycznie po wystawieniu.

Poprawność numeru NIP – włącz sprawdzanie poprawności numeru NIP na stronie zamówienia. Niepoprawny NIP zablokuje możliwość złożenia zamówienia. Wtyczka sprawdza numer pod kątem ilości wpisanych cyfr.

Wtyczka nadaje unikalny ID billing_nip dla pola NIP, który możesz wykorzystać w połączeniu z inną naszą wtyczką Flexible Checkout Fields PRO, jeśli zależy Ci na dopasowanym do rodzaju klienta formularzu zamówienia. Pole NIP może bowiem pojawiać się w zamówieniu, kiedy klient zaznaczy checkbox Chcę otrzymać fakturę.

Parametry faktury

Parametry faktury - konfiguracja wtyczki wFirma

Termin płatności dla faktur wysyłkowych – termin płatności dla faktur wysyłkowych w dniach.

Format daty sprzedaży – dzień lub miesiąc.

Seria numeracji – seria numeracji faktury zdefiniowana w wFirma.

Numer konta bankowego – numer konta bankowego widoczny na fakturze. Konto bankowe musi być zdefiniowane w serwisie wFirma.

Tłumaczenie faktur walutowych – język dla faktur walutowych.

Dostępne opcje:

  • Język kraju klienta jeżeli jest dostępny, lub angielski
  • Angielski
  • Zawsze język polski

Nr zamówienia w uwagach – w uwagach do faktury zostanie dopisany numer zamówienia.

Metoda płatności w uwagach – jeśli potrzebujesz dodać informację o metodzie płatności np. PayU, zaznacz tą opcję.

Tekst przy metodzie płatności – jeśli włączyłeś Metoda płatności w uwagach możesz wpisać dodatkowy tekst, który pojawi się przed metodą płatności np. Zapłacono przez:.

Etykiety (tagi) paragonów – jeśli masz skonfigurowane etykiety w wFirmie to możesz wybrać etykietę którą będą oznaczane faktury np. sklepzetykieta.pl

Rodzaj transakcji w JPK V7 – jeśli chcesz, aby wystawiane faktury VAT były oznaczane szczególnymi rodzajami transakcji, wybierz z listy rodzaj transakcji. Więcej o szczególnych rodzajach transakcji w JPK V7 dowiesz się z informacji na stronie wFirmy →.  Pamiętaj, że aby korzystać z oznaczania faktur w ten sposób, musisz aktywować pola dla ustawienia Rodzaj transakcji w JPK V7:

Parametry faktury proforma

Termin płatności dla faktur pro forma – termin płatności dla faktur pro forma w dniach.

Status zamówienia – wybierz status zamówienia przy którym proforma zostanie automatycznie wystawiona.

Automatycznie wysyłaj faktury proformy po wystawieniu – zaznacz, jeśli chcesz aby faktury proforma były wysyłane automatycznie po wystawieniu.

Seria numeracji faktur pro forma – seria numeracji faktury proforma zdefiniowana w wFirma.

OSS (dawniej procedura MOSS)

Nowość od wersji 2.5.0 OSS jest rozszerzeniem MOSS. Od 07.2021 r. podatek VAT od wszystkich towarów musi być obliczany na podstawie lokalizacji klienta po przekroczeniu progu sprzedaży do krajów UE w wysokości 42.000 zł. Dlatego podczas transakcji należy potwierdzić adres IP i adres rozliczeniowy.

WFirma mechanizm OSS w WooCommerce

Walidacja VIES – po włączeniu opcji numer VAT wprowadzony na stronie zamówienia jest walidowany w bazie VIES.

Nie dodawaj VAT do zamówień z kraju sklepu – opcja pozwala na usuwanie z zamówienia wartości podatku VAT nawet w przypadku zamówień złożonych z kraju, w którym prowadzony jest sklep.

Stawka podatkowa dla OSS – opcja pozwala na wybór stawek podatkowych z jakich ma korzystać wtyczka dla zamówień z krajów Unii Europejskiej.

Wybierz co robić jeśli walidacja się nie powiedzie:

  • Nie pozwalaj na złożenie zamówienia i wyświetl komunikat błędu
  • Pozwól na złożenie zamówienia ale nie usuwaj VAT
  • Pozwól na złożenie zamówienia i usuń VAT

Pozwól na deklarowanie poprawności adresu – Opcja sprawdza poprawność adresu IP klienta na podstawie jego adresu płatności i monituje klienta o zadeklarowanie swojego adresu, jeśli się nie zgadza.

Klasy podatkowe dla OSS – wskaż klasę podatkową utworzoną na potrzeby OSS.

Kod rodzaju usługi elektronicznej – wybierz kod, który odpowiada rodzajowi usługi elektronicznej, którą oferujesz.

Dowód potwierdzający kraj nabywcy – wybierz z listy dowód potwierdzający kraj nabywcy.

Drugi dowód potwierdzający kraj nabywcy – wybierz z listy dowód potwierdzający kraj nabywcy.

Uwaga! W tym rozwiązaniu bazujemy na mechanizmie WooCommerce, który jest dostosowany do krajów, dla których podatki są inne w różnych regionach. Mechanizm ten zakłada wypełnienie oprócz pola numeru NIP również inne obowiązkowe pola z formularza zamówień takie jak miasto, kod pocztowy, ulica. Jeśli pola te nie będą wypełnione, mechanizm odejmowania podatku podczas weryfikacji numeru NIP w bazie VIES, nie zadziała.

Pozycje dokumentów

Nazwa na dokumencie – wstaw atrybut produktu, z którego będzie pobierana nazwa produktu na dokument. Jeżeli produkt będzie miał zdefiniowany ten atrybut na dokumencie jako nazwa produktu będzie wartość tego atrybutu.

Jednostka miary na dokumencie – wstaw atrybut produktu, będzie pobierana jednostka miary dla produktu na dokument. Jeżeli produkt będzie miał zdefiniowany ten atrybut, na dokumencie jako jednostka miary produktu będzie wartość tego atrybutu. Jeżeli produkt nie będzie miał zdefiniowanego tego atrybutu jednostką miary zostanie pobrana z pola Domyślna jednostka miary.

Domyślna jednostka miary – wstaw domyślną jednostkę miary, która zostanie pobrana do dokumentu sprzedaży, jeżeli produkt nie będzie miał zdefiniowanego atrybutu jednostki miary.

Pozycje o zerowej wartości – jeśli chcesz, na fakturze mogą się pojawić pozycje o zerowej wartości (np. produkt ze 100-procentowym rabatem).

Wysyłka o zerowej wartości – jeśli chcesz, na fakturze może znaleźć się pozycja wysyłki nawet jeśli w danym przypadku oferujesz ją za darmo.

Konfiguracja dla firm zwolnionych z VAT

Jeśli nie jesteś czynnym podatnikiem VAT (potocznie: nie jesteś VATowcem), przejdź do ustawień głównych WooCommerce i wyłącz podatki w sklepie:

Wyłączenie podatków w sklepie

Firmy korzystające ze zwolnienia przedmiotowego z VAT (czyli ze względu na rodzaj sprzedaży) muszą dodatkowo umieścić na fakturze podstawę zwolnienia z VAT. Podstawę zwolnienia trzeba wpisać w polu uwagi, które można dodać do każdej faktury.

Dostępność dokumentów

Dokumenty wystawione za pomocą wtyczki przekazywane są za pomocą wiadomości email wysyłanej do klienta po utworzeniu faktury. Klienci mogą również znaleźć fakturę w zakładce Zamówienia na /moje-konto

Administrator sklepu dodatkowo może pobrać fakturę z poziomu edycji zamówienia:

Ważne: Dokumenty tworzone za pomocą wtyczki nie są zapisywane w katalogu uploads
Wtyczka jest kompatybilna z naszą aplikacją Flexibile Printing WooCommerce, która pozwala integrować sklep z drukarkami za pomocą PrintNode. Po poprawnej konfiguracji konta w PrintNode nastąpi, automatyczna integracja wtyczek co pozwoli na drukowanie dokumentów z chwilą ich wystawienia.

Stany magazynowe

Wtyczka umożliwia integrację z serwisem wFirma w zakresie stanów magazynowych. Jest to integracja dwustronna – aktualizacja stanów magazynowych w serwisie wFirma (wystawienie dokumentów magazynowych) aktualizuje stany magazynowe w sklepie WooCommerce oraz sprzedaż w sklepie (wystawienie dokumentu sprzedaży) powoduje aktualizację stanów magazynowych w serwisie wFirma.

Ważne: Wtyczka zawsze synchronizuje stany tylko z tym magazynem, który w systemie ustawiony jest jako Główny

Import produktów z WooCommerce do wFirmy

Rozpoczynając pracę z integracją, należy pamiętać o tym że produkty muszą być wcześniej utworzone zarówno w WooCommerce, jak w wFirmie. Przygotowaliśmy poradnik objaśniający w jaki sposób przeprowadzić proces importu produktów z WooCommerce do wFirmy →

Powiązanie produktów wFirma i WooCommerce

Przejdź do WooCommerce → Ustawienia → Integracja → wFirma.

Aby aktualizacja stanów magazynowych mogła być przeprowadzona należy odpowiednio skonfigurować wtyczkę oraz produkty w sklepie, tak aby możliwe było powiązanie produktów w serwisie wFirma i w sklepie WooCommerce.

Po stronie serwisu wFirma możliwe są dwa rodzaje powiązania:

  1. Przy użyciu pola Kod produktu z serwisu wFirma
  2. Przy użyciu dodatkowego pola produktu, które definiuje się w serwisie wFirma

Po stronie sklepu WooCommerce możliwe są dwa rodzaje powiązania:

  1. Przy użyciu pola SKU
  2. Przy użyciu pola Kod produktu, które dodaje wtyczka w edycji produktu, w zakładce Magazyn

W konfiguracji wtyczki należy wskazać pola, które identyfikują produkty w sklepie i serwisie wFirma.

W przypadku, gdy jako Identyfikator produktu w wFirma zostanie wybrane Własne pole, należy zdefiniować Identyfikator pola produktu wFirma. Ponieważ API wFirma nie udostępnia definicji pól dodatkowych należy ten identyfikator uzyskać ze źródła strony wFirma, podczas edycji produktu.

wFirma - modyfikacja produktu
wFirma – modyfikacja produktu

W podanym przykładzie należy kliknąć prawym przyciskiem myszki w etykietę SKU i z menu wybrać Zbadaj.

wFirma - sprawdzanie id pola
wFirma – sprawdzanie id pola

W dolnej części przeglądarki wyświetli się okno z elementami strony z podświetlonym wskazanym elementem (w tym przykładzie etykieta SKU).

wFirma - id pola
wFirma – id pola

Wartość atrybutu data-field-id, to wartość, którą należy wpisać w konfiguracji wtyczki jako Identyfikator pola produktu wFirma. W przykładzie to: 5406.

Aktualizacja stanów magazynowych WooCommerce

Aktualizacja stanów magazynowych odbywa się przy pomocy webhooks. Aby uruchomić mechanizm webhooks należy po stronie wtyczki zdefiniować unikalny Token.

WooCommerce wFirma – Ustawienie tokena

Domyślnie w polu Token, wprowadzany jest losowy ciąg znaków, można pozostawić go bez zmian. Po zmianie tokena należy zawsze zapisać konfigurację wtyczki.

wFirma WooCommerce - ustawianie webhook
wFirma WooCommerce – ustawianie webhook

W polu Webhook wyświetlany jest adres webhooka, który należy wprowadzić podczas definiowania webhooka w serwisie wFirma.

wFirma - modyfikacja webhooka
wFirma – modyfikacja webhooka

Jako Zdarzenie należy wybrać Produkty » Zmiana ilości na magazynie, Typ danych: JSON.

wFirma wprowadziła dodatkowe zabezpieczenie. W konfiguracji należy wprowadzić również klucz webook. Znajdziesz go w konfiguracji po stronie wFirmy:

Po zdefiniowaniu webhooka, każda zmiana stanów magazynowcyh w serwisie wFirma będzie przesyłana do sklepu WooCommerce i stany magazynowe produktów w sklepie zostaną zaktualizowane. Produkty, których stany magazynowe zostaną zaktualizowane identyfikowane są na podstawie pól, które zostały wskazane w konfiguracji wtyczki.

Aktualizacja stanów magazynowych wFirma

Aktualizacja stanów magazynowych po sprzedaży w sklepie WooCommerce odbywa się po wystawieniu dokumentów sprzedaży. Podczas wystawiania dokumentów sprzedaży produkty w serwisie wFirma identyfikowane są na podstawie pól wskazanych w konfiguracji wtyczki i przypisywane do pozycji dokumentu sprzedaży. Jeżeli produkt nie zostanie zidentyfikowany, to w dokumencie sprzedaży nie zostanie on powiązany z produktem w serwisie wFirma. Na dokumencie sprzedaży nazwą produktu będzie nazwa produktu ze sklepu WooCommerce.

Jeżeli wdrażasz integrację z wFirmą od zera, zarówno na poziomie produktu w WooCommerce (pole Stan magazynowy), jak i na poziomie produktu w wFirma, powinny być identyczne wartości dotyczące stanu magazynowego. Należy ręcznie przepisać stan magazynowy dla każdego produktu do WooCommerce na podstawie danych o produktach, które są w wFirmie (lub odwrotnie). Ważne by od początku działania integracji w sklepie wartości stanów magazynowych w sklepie i w wFirmie były takie same.

Produkty proste i produkty z wariantami

Wtyczka umożliwia aktualizację stanów magazynowych dla produktów prostych oraz dla poszczególnych wariantów produktów z wariantami. Jeżeli stany magazynowe są prowadzone dla wariantów, wówczas powiązanie wariantów z produktami w serwisie wFirma definiuje się na poziome wariantu. W takiej sytuacji jeden wariant odpowiada jednemu produktowi w serwisie wFirma.

Edycja zamówienia

W edycji zamówienia dostępny jest metabox wFirma, w którym w zależności od statusu zamówienia i ustawień wtyczki dostępne są dokumenty do pobrania i możliwe jest wystawianie dokumentów sprzedaży (paragonów i faktur).

Faktura Proforma

Edycja zamówienia - faktura proforma
WooCommerce wFirma – Edycja zamówienia, faktura proforma

Wystawienie faktury proforma możliwe jest dla zamówień jeszcze nieopłaconych – posiadających statusy: Wstrzymane (oczekujące na płatność), Oczekujące na płatność, Anulowane, Nieudane). Przed wystawieniem faktury proforma można zmienić jej domyślne parametry.

Paragony i faktury

Edycja zamówienia - wystawianie paragonu / faktury
WooCommerce wFirma – Edycja zamówienia, wystawianie paragonu / faktury

Dla zamówień opłaconych istnieje możliwość wystawiania paragonów i faktur. W zależności od konfiguracji są to paragony fiskalne lub niefiskalne oraz faktury VAT lub faktury bez VAT. Przed wystawieniem faktury lub paragonu można zmienić ich domyślne parametry.

W przypadku automatycznego wystawiania dokumentów, gdy zamówienie przyjmie status zdefiniowany w konfiguracji, dokumenty sprzedaży zostaną wystawione automatycznie.

Po wystawieniu faktury lub paragonu niefiskalnego można pobrać dokumenty poprzez kliknięcie w sygnaturę.

Paragonu fiskalnego nie można pobrać, ponieważ nie ma on postaci dokumentu elektronicznego – musi zostać wydrukowany na drukarce fiskalnej (fiskalizację obsługuje serwis wFirma).

Mail wysyłany do kupującego

Kupujący otrzyma maila z wystawionym dokumentem. Plik PDF z fakturą (lub paragonem niefiskalnym) zostanie wysłany w mailu:

  • jako link do pobrania pliku PDF
  • jako załącznik z plikiem PDF dołączonym do maila
Mail z dokumentem sprzedaży wysłany do klienta sklepu

Możesz modyfikować wiadomości zgodnie z własnymi potrzebami. Wskazówki dotyczące modyfikacji znajdziesz w tym artykule.

Integracja z wtyczką Kalkulator Jednostek dla WooCommerce

Wtyczka WFirma WooCommerce jest kompatybilna z wtyczką Kalkulator Jednostek dla WooCommerce. Wtyczka Kalkulator Jednostek dla WooCommerce umożliwia włączenie kalkulacji ceny produktu na podstawie wymiarów na stronie produktowej.

Aby wyświetlić jednostkę miary na fakturze, która została ustawiona w Kalkulatorze Jednostek dla WooCommerce, przejdź do edycji produktu i wybierz zakładkę Kalkulator Jednostek. Następnie zaznacz checkbox z opcją Zaznacz to pole, aby stany magazynowe były zmniejszane według ustalonej jednostki.

Ważne: Pamiętaj, że przy włączonej opcji Zaznacz to pole, aby stany magazynowe były zmniejszane według ustalonej jednostki. jednostki ustawione w Kalkulatorze Jednostek dla WooCommerce, muszą być takie same, jak w ustawieniach produktu w magazynie wFirma. Jeżeli, nie masz włączonej synchronizacji stanów magazynowych we wtyczce wFirma WooCommerce, to możesz ustawić dowolną jednostkę w kalkulatorze.

Tryb debugowania

Wtyczka posiada opcję zapisu komunikatów błędów do logów WooCommerce oraz sprawdzenia żądań API. Debugowanie włączysz w WooCommerce → Ustawienia → Integracje → wFirma → Tryb debugowania.

inFakt WooCommerce - Tryb debugowania

Tryb debugowania – zaznacz checkbox i zapisz zmiany, aby włączyć tryb debugowania.

Zablokuj żądanie API – możesz też zaznaczyć to pole, aby sprawdzać treść żądań do API wFirmy. Aktywna blokowanie żądań API zadziała jedynie dla administratora podczas testów, ale nie wpłynie na działanie wtyczki w sklepie (wystawienie faktur dla klientów, wysyłka maili itp.). Aby aktywować tę opcję zaznacz checkbox i zapisz zmiany.

Automatyczne wyłączenie – Wybierz, kiedy debugowanie ma zostać wyłączone automatycznie. Możesz ustawić, aby logowanie:

  • nie było wyłączane,
  • zostało wyłączone automatycznie po 1 godzinie,
  • po 4 godzinach,
  • po 1 dniu,
  • po 7 dniach,
  • albo po 30 dniach.

Po wyborze opcji pamiętaj o zapisaniu zmian.

Jeśli spotkasz się z niepoprawnym działaniem wtyczki, napisz do nas. Możesz włączyć zapis błędów i przesłać plik z zapisanymi logami. Tryb debugowania pozwoli nam szybciej znaleźć przyczynę i rozwiązanie.

Opcje dla zaawansowanych użytkowników

Przechwytywanie danych faktury

Jeśli jesteś deweloperem, możesz skorzystać z filtra woocommerce_wfirma_invoice_data. Przez filtr “przechodzą” dane faktury tuż przed wysłaniem do API wFirmy. W tym filtrze będzie można zmodyfikować dane przesyłane do API.

Kod zapisze w error.log/debug.log strukturę przesyłaną do API. Przykład:

Modyfikacja w locie danych przesyłanych do API wFirma

Użyj filtra woocommerce_wfirma_invoice_data aby zmodyfikować w locie dane które są przesyłane podczas żądania wystawienia dokumentu sprzedaży.

Przykłady wykorzystania filtra:

Powyższy filtr spowoduje modyfikację pola Uwagi na fakturze.

Ten filtr pozwoli na usunięcie znaku – z nazw produktów na tworzonych dokumentach.

Wystawianie paragonu bez danych klienta

Paragon bez danych klienta będzie wystawiony, gdy zostanie dodany poniższy filtr.

Aktywny checkbox Chcę fakturę na stronie zamówienia

Poniższy kod pozwala ustanowić checkbox Chcę fakturę na stronie zamówienia w pozycji włączonej. Składając zamówienie, klient nie zapomni poinformować sklep, o konieczności wystawienia faktury.

Możliwość usunięcia rekordów z bazy danych

Po usunięcia dokumentów w wFirmie, numer dokumentu nie zniknie automatycznie z bazy danych sklepu. Rekordy są umieszczone w tabeli wp_postmeta dla meta_keys: _woo_wfirma_faktura oraz _woo_wfirma_paragon.

Aby użyć zapytania SQL musisz zalogować się do panelu phpMyAdmin dla twojego hostingu. Jeśli nie wiesz, jak zarządzać bazą danych, nie próbuj stosować tej metody aby nie uszkodzić bazy. Przed użyciem poniższych zapytań koniecznie wykonaj backup bazy danych.

Możesz je znaleźć poprzez zapytania sql:
SELECT * FROM wp_postmeta WHERE meta_key LIKE '%_woo_wfirma_faktura%'
oraz
​SELECT * FROM wp_postmeta WHERE meta_key LIKE '%_woo_wfirma_paragon%'

Komunikaty błędów

Poniżej znajdziesz opisy komunikatów błędów, jakie mogą wystąpić podczas korzystania z wtyczki.
Kliknij w komunikat błędu, aby przeczytać kiedy występuje i jak sobie z nim poradzić:

Błąd 200 name, zip, city pole nie może być puste

Problem zostanie rozwiązany po wypełnieniu niezbędnych w formularzu zamówienia pól, takich jak kraj, kod pocztowy, imię, nazwisko, miasto. Zamówienie z niepełnymi danymi, zablokuje możliwość wystawienia dokumentu.

Komunikat błędu pochodzi z API. Błąd ten zdarza się najczęściej podczas próby wystawienia paragonu. Część sklepów customizuje np. za pomocą wtyczki Flexible Checkout Fields. Formularz zamówienia wyłącznie do pola adres e-mail.

Faktycznie w polskim prawie podatkowym dozwolone jest wystawianie paragonu bez podawania danych klienta. Możesz to osiągnąć również z naszą wtyczką, po dodaniu do sklepu odpowiedniego filtra:

  • przejdź do pliku functions.php używanego przez siebie motywu Wygląd > Edytor motywu > Funkcje motywu (functions.php)

  • upewnij się, że pracujesz na pliku functions.php używanego przez siebie motywu

  • dodaj dwa poniższe kody do pliku functions.php

  • zatwierdź zmiany wybierając przycisk Zaktualizuj plik

  • przelicz istniejące zamówienie (status Oczekujące na płatność) lub złóż nowe
  • ponów próbę wystawienia dokumentu

Z tak zmodyfikowanym plikiem functions.php będziesz mógł wystawiać paragony w przypadku gdy klient podał wyłącznie swój adres e-mail.

Uwaga! Korzystaj z motywu potomnego, który działa w oparciu o inny motyw. Pozwala wprowadzać zmiany do oryginalnego motywu bez konieczności jego bezpośredniej edycji. W przeciwnym wypadku, za każdym razem gdy będziesz aktualizować motyw sklepu, będziesz aktualizować plik functions.php co będzie wiązało się z usunięciem dodanego filtra.

Błąd API wFirma! Kod błędu: 200 komunikat input error"

Problem zostanie rozwiązany wówczas gdy wszystkie dane z API ponownie będą przesyłane. Spróbuj ponownie później wystawić dokument. Jeśli po kilku próbach nie będziesz w stanie wystawić faktury/paragonu skontaktuj się z naszym supportem.

Błąd API WFirma! Kod błędu: 200. Komunikat: nip Nieprawidłowy prefiks kraju Unii Europejskiej

Problem zostanie rozwiązany poprzez konfigurację i przypisanie produktom oraz wysyłce prawidłowych klas podatkowych

  • skonfiguruj podatki w sklepie zgodnie ze wskazówkami opisanymi w poradniku podatkowym WooCommerce
  • przelicz istniejące zamówienie (status "oczekujące na płatność") lub złóż nowe

  • sprawdź, czy w zamówieniu znajdują się stawki podatkowe

  • ponów próbę wystawienia dokumentu

Błąd 200 nieprawidłowy format etykiet

Problem zostanie rozwiązany poprzez aktualizację wtyczki, możesz to zrobić z kokpitu Wordpress. Jeśli nie masz powiadomienia o aktualizacji, możesz zaktualizować wtyczkę ręcznie.

Błąd API WFirma! Kod błędu: 401. Komunikat: AUTH

Problem zostanie rozwiązany poprzez poprawienie danych autoryzacyjnych, za pomocą których wtyczka łączy sklep z serwisem księgowym.

  • przejdź do ustawień wtyczki zakładka Autoryzacja w wFirma
  • upewnij się, że pola login oraz hasło mają prawidłowe wartości, są to dokładnie te same dane, za pomocą których logujesz się do serwisu księgowego wFirma
  • kiedy już będziesz mieć pewność, że pole Login oraz Hasło mają prawidłowe wartości, zapisz zmiany wybierając przycisk poniżej.

Dopiero teraz możesz ponownie wystawić dokument księgowy. Możesz to zrobić z poziomu panelu edycji zamówienia wybierając w metaboksie wFirma przyciski Wystaw paragon, Wystaw fakturę, Wystaw pro formę 

Jeśli nadal dokument nie chce się wystawić, odczekaj kilka minut i ponów próbę. Jeżeli to nie pomoże, skontaktuj się z nami poprzez formularz kontaktowy.

Błąd API WFirma! Kod błędu: 200. Komunikat: type Pole nie może być puste.evidence1_type Pole nie może być puste.evidence2_type Pole nie może być puste.

Jeśli sprzedajesz produkty w ramach procedury OSS, dawniej MOSS, upewnij się, że produkty mają przypisaną klasę podatkową ustawioną dla procedury OSS.

  • przejdź w ustawienia wtyczki Wystawianie faktur > Wsparcie dla OSS
  • ustaw w polu klasy podatkowe dla OSS, właściwą klasę podatkową

  • upewnij się, że przypisałeś tę samą klasę podatkową produktom

  • przelicz istniejące zamówienie (status oczekujące na płatność) lub złóż nowe

  • ponów próbę wystawienia dokumentu

Innym powodem dla wystąpienia tego błędu może być brak jednego z pól w formularzu zamówień np. Kraj/Region. Dzieje się tak zwłaszcza kiedy WooCommerce ma zmodyfikowany formularz zamówień. W takim przypadku, przywróć do formularza zamówień pole Kraj/Region. Po złożeniu zamówienia błąd nie będzie występować.

Jeśli pomimo tego błąd nadal występuje, proszę skontaktuj się z nami poprzez ten formularz.

Błąd API WFirma! Kod błędu: 200. Komunikat: type Fakturę VAT/Pro Formę VAT/Dowód sprzedaży można wystawić, jedynie będąc płatnikiem VAT

Jeśli w sklepie podatki są włączone, problem zostanie rozwiązany poprzez ustawienie w serwisie księgowym firmy jako płatnika VAT.

  • przejdź do serwisu księgowego wFirma, wybierz Ustawienia > Podatki > Podatek VAT

  • zaznacz opcję płatnik VAT

  • przelicz istniejące zamówienie (status oczekujące na płatność) lub złóż nowe

  • ponów próbę wystawienia dokumentu
Uwaga! Jeśli kwestie podatkowe są dobrze ustawione w serwisie księgowym wFirma, oznacza to, że powinieneś włączyć podatki w sklepie WooCommerce. 

Błąd API WFirma! Kod błędu: 200. Komunikat: type Fakturę (bez VAT)/ Pro Formę (bez VAT)/ Dowód sprzedaży (bez VAT) można wystawić, jedynie nie będąc płatnikiem VAT

Problem zostanie rozwiązany poprzez ustawienie w serwisie księgowym firmy jako podmiotu niepodlegającego podatkowi VAT.

  • przejdź do serwisu księgowego wFirma, wybierz Ustawienia > Podatki > Podatek VAT
  • odznacz opcję płatnik VAT

  • przelicz istniejące zamówienie (status oczekujące na płatność) lub złóż nowe

  • ponów próbę wystawienia dokumentu
Uwaga! Jeśli kwestie podatkowe są dobrze ustawione w serwisie księgowym wFirma, oznacza to, że powinieneś wyłączyć podatki w sklepie WooCommerce.

Błąd API WFirma! Kod błędu: 200. Komunikat: nip Nieprawidłowy prefiks kraju Unii Europejskiej. W przypadku stosowania stawki nie podl. ue lub 0% WDT należy podać prawidłowy numer VAT UE.

Problem zostanie rozwiązany poprzez przypisanie produktom właściwej stawki podatkowej 5% lub 23%. Jeśli sprzedajesz produkty zwolnione z podatku, a na fakturze powinien być w rubryce VAT dopisek nie podl. lub ZW, zgłoś ten problem na nasz support.

  • wyszukaj wszystkie produkty z zerową stawką podatkową
  • przejdź do edycji wspomnianych produktów i ustaw ich stawkę podatkową na 5% lub 23%
  • przejdź do zamówienia, w którym wystąpił problem z wystawieniem dokumentu
  • przelicz istniejące zamówienie (status oczekujące na płatność) lub złóż nowe
  • ponów próbę wystawienia dokumentu

Błąd API WFirma! Kod błędu: 200. Komunikat: type Total requests limit exceeded

Problem zostanie rozwiązany kiedy obciążenia serwerów będą mniejsze lub zapytania będą wysyłane z mniejszą ilością danych. Zalecamy również wysyłać zapytania do API w większych odstępach czasu, nocą, dzięki temu będzie możliwe uniknięcie blokad nałożonych przez API.

Błąd API WFirma! Kod błędu: 200. Komunikat: nip Nieprawidłowy identyfikator

Problem zostanie rozwiązany poprzez poprawienie numeru NIP, który został wpisany przez klienta w formularzu zamówienia. Jeśli numer NIP zawiera niewłaściwą ilość, lub niedozwolone znaki, podczas próby wystawienia faktury, pojawi się komunikat Błąd API WFirma! Kod błędu: 200. Komunikat: nip Nieprawidłowy identyfikator.

Możesz uniknąć tej sytuacji, włączając w ustawieniach wtyczki opcję Poprawność numeru NIP. Opcja uruchamia sprawdzanie poprawności numeru NIP na stronie zamówienia. Jeśli klient wpisze niepoprawny NIP, wtyczka zablokuje złożenie zamówienia i poinformuje o tym klienta za pomocą komunikatu.

Błąd API WFirma! Kod błędu: 200. Komunikat: vat_code_id Nieprawidłowa stawka.

Problem zostanie rozwiązany poprzez ustawienie prawidłowych stawek podatkowych, w klasach podatkowych WooCommerce. Wtyczka wFirma WooCommerce, umożliwia obsługę podatku VAT w obrocie krajowym  (5, 8, 23%). Przejdź do WooCommece > Ustawienia > Podatek i zdefiniuj prawidłowe stawki dla klas podatkowych:

  • Standardowa 23%,
  • Obniżona 8%,
  • Obniżona 5%

Mechanizm podatkowy WooCommerce, jest opisany w tym poradniku. Jeśli prowadzisz sprzedaż do krajów UE, powinieneś rozliczać sklep zgodnie z procedurą OSS. Wszystkie transakcje realizowane przez firmy z krajów UE, będą mieć odjęty podatek VAT. Sprzedaż do 10.000 euro rocznie do klientów indywidualnych, będzie rozliczana wg. polskich stawek podatkowych. Sprzedaż powyżej 10.000 euro rocznie będzie rozliczana zgodnie ze stawkami podatkowymi obowiązującymi w krajach, w których zostało złożone zamówienie.

Błąd API WFirma! Kod błędu: 200. Komunikat: positions Nie można mieszać stawek zagranicznych (MOSS) z pozostałymi stawkami VAT.

Problem zostanie rozwiązany poprzez aktualizację wtyczki do wersji powyżej 2.5.0. Od tej wersji wtyczka wspiera mechanizm OSS.

Od lipca 2021 roku mechanizm MOSS został rozszerzony do OSS. Jeśli w komunikacie błędu pojawia się MOSS, oznacza to, że korzystasz ze starszej wersji wtyczki obsługującej nieaktualny już mechanizm.

Aby wywołać ręczne sprawdzenie dostępności aktualizacji, skorzystaj z funkcji Sprawdź ponownie. Jeśli w kokpicie Wordpress, nie ma powiadomienia o dostępnej aktualizacji wtyczki, możesz zrobić to ręcznie.

Jeśli posiadasz już wtyczkę w wersji obsługującej mechanizm OSS. Jest on niezbędny jeśli prowadzisz sprzedaż do krajów UE, powinieneś rozliczać sklep zgodnie z procedurą OSS. Wszystkie transakcje realizowane przez firmy z krajów UE, będą mieć odjęty podatek VAT. Sprzedaż do 10.000 euro w skali roku w wypadku klientów indywidualnych, będzie rozliczana wg polskich stawek podatkowych. Sprzedaż powyżej 10.000 euro w skali roku będzie rozliczana zgodnie ze stawkami podatkowymi obowiązującymi w krajach, w których zostało złożone zamówienie.

Błąd API WFirma! Komunikat: Default exception: SSL certificate problem: certificate has expired.

Problem jest spowodowany wygaśnięciem ważności certyfikatu SSL dla domeny, na której zainstalowany jest sklep. Skontaktuj się z dostawcą usług hostingowych i poproś o odnowienie ważności certyfikatu SSL. Jeśli certyfikat SSL jest aktualny, a mimo tego podczas wystawiania dokumentu nadal występuję błąd, proszę, skontaktuj się z nami poprzez ten formularz.

Błąd API wFirma! Kod błędu: 200. Komunikat: NOT FOUND

Problem wystąpi jeśli w serwisie księgowym wFirma nie jest ustawiony magazyn, natomiast w ustawieniach wtyczki, zakładka Magazyn, włączona jest synchronizacja magazynów. Jeśli nie planujesz zarządzaniem magazynem z poziomu serwisu księgowego, wyłącz w ustawieniach wtyczki synchronizację magazynów.

Z kolei jeśli planujesz synchronizację magazynową pomiędzy serwisem księgowym a sklepem WooCommerce, włącz moduł magazyn w wFirmie. W sytuacji kiedy w serwisie księgowym jest włączony magazyn, a we wtyczce włączona jest synchronizacja magazynowa i błąd nadal występuje, proszę, skontaktuj się z nami poprzez ten formularz.