[FAQ] Integracja Fakturowni z WooCommerce

Utworzono: 2022-11-22
Ostatnia aktualizacja: 2025-05-14
Liczba odwiedzin posta: 8458

W tym wpisie znajdziesz najczęściej zadawane pytania dotyczące integracji Fakturowni z WooCommerce. Sprawdź, czy wśród najczęściej zadawanych przez użytkowników pytań (FAQ) dostępne jest rozwiązanie Twojego problemu.
 
  1. Faktury nie wystawiają się.
  2. Jak dodać domyślne uwagi na fakturach?
  3. Na fakturach nie tworzy się stawka VAT 'zw'.
  4. Przy próbie zainstalowania aplikacji występuje komunikat dotyczący API.
  5. Jak wyświetlić NIP na fakturze?
  6. Jak używać wtyczek, które oferują checkbox "inne dane do faktury"?
  7. Czy mogę wystawiać e-paragony w integracji z WooCommerce?
  8. Obsługa kodów GTU
  9. Jak używać opcji synchronizacji magazynów w integracji z WooCommerce?

 

Faktury nie wystawiają się.

Poniżej opisane są najczęstsze przyczyny:  

 

Jak dodać domyślne uwagi na fakturach?

Domyślne uwagi na fakturach można ustawić w zakładce Ustawienia > Dane firmy. Następnie wybrać firmę i w szczegółach wypełnić pole Domyślne uwagi na fakturach.

Formularz edycji działu lub firmy z polem na wprowadzenie domyślnych uwag na fakturach.

 

Na fakturach nie tworzy się stawka VAT 'zw'.

  Aby stawka VAT 'zw' na fakturach wystawiała się w poprawny sposób, postępuj zgodnie z poniższymi krokami:
  1. W pierwszej kolejności ustaw domyślną stawkę VAT w Fakturowni w zakładce Ustawienia > Dane firmy > Edycja firmy (wystarczy kliknąć w nazwę). W sekcji Dokumenty w polu  zw. W tym miejscu wybierz także powód zwolnienia z VAT.
  2. Ustaw po stronie WooCommerce stawkę ZW jako osobną klasę podatkową dla produktów. Wtedy produkty na fakturze też będą się tworzyć z taką stawką.
  3. Dodatkową klasę podatkową tworzy się w ten sposób:
    WooCommerce > Ustawenia > Podatek > Opcje podatku > Dodatkowe klasy podatków (tutaj dopisać np. ZW) 
    Po zapisaniu zmian powinna pojawić się dodatkowa zakładka Stawki:ZW. UWAGA! Szczegóły tej klasy podatkowej pozostaw puste (nie twórz żadnych dodatkowych wierszy).

    Ustawienia podatków w WooCommerce z zaznaczonymi opcjami wpisywania cen z podatkiem oraz klasą podatkową wysyłki ustawioną na obniżoną stawkę.
      Ustawienia stawek podatkowych ZW w WooCommerce z opcjami dodania lub usunięcia wierszy oraz przyciskami eksportu i importu CSV.
     
  4. Następnie, przy tworzeniu produktu wybierz stawkę Opodatkowany i klasę podatkową ZW.

    Edycja produktu w WooCommerce z zaznaczonymi opcjami statusu podatku 'Opodatkowany' i klasy podatkowej 'ZW'.

 

Przy próbie zainstalowania aplikacji występuje komunikat dotyczący API.

Jeśli podczas próby zainstalowania aplikacji występuje komunikat "Nie możemy połączyć się z API Twojego sklepu WooCommerce. Skontaktuj się z administratorem pod adresem integracje@fakturownia.pl", oznacza to, że ustawienia WooCommerce nie pozwalają na połączenie się z API sklepu. W takiej sytuacji postępuj zgodnie z poniższymi krokami:
  1. W pierwszej kolejności zaznacz checkbox Włącz przestarzałe REST API w WooCommerce > Ustawienia > Zaawansowane > Przestarzałe API. 

    Ustawienia WooCommerce z zaznaczoną opcją włączenia przestarzałego REST API w zakładce 'Zaawansowane'.
     
  2. Włącz w Ustawienia > Bezpośrednie odnośniki, wejdź w zakładkę Ustawienia Wspólne i wybierz Strukturę stałych odnośników inną niż Prosty. Możesz wybrać np. Nazwa wpisu.

    Ekran ustawień permalinków w WooCommerce z wybraną opcją 'Nazwa wpisu' dla struktury stałych odnośników.
  3. Oficjalne instrukcje od WooCommerce można znaleźć pod poniższymi linkami:
    1. WooCommerce REST API
    2. WooCommerce REST API - techniczna instrukcja dla administratorów i developerów
  4. Jeśli posiadasz wersję WooCommerce 9.0 lub wyższą, poniższe linki mogą być przydatne dla Ciebie lub Twojego administratora:
    1. Przeniesienie Legacy REST API do dedykowanej wtyczki
    2. Usunięcie Legacy REST API z WooCommerce Core - informacja dla developerów

Jak wyświetlić NIP na fakturze?

Ustawienie NIP-u na fakturach odbywa się po stronie WooCommerce.
  1. Wejdź w zakładkę Wtyczki oraz kliknij Dodaj nową.
  2. Znajdź wtyczkę Checkout Field Editor for WooCommerce.
  3. Zainstaluj i włącz.

    Ekran WordPress z wyświetlonym wynikiem wyszukiwania wtyczki 'Checkout Field Editor (Checkout Manager) for WooCommerce'.
     
  4. Wejdź w zakładkę Checkout Form.
  5. Dodaj nowe pole.
  6. Uzupełnij pole według wzoru.

    Ekran WooCommerce z edycją nowego pola formularza Checkout, skonfigurowanego do wprowadzenia numeru NIP.
     
  7. Zapisz.
  8. Teraz Klienci dostaną możliwość wpisania NIP-u, który pojawi się na tworzonych fakturach.

 

Jak używać wtyczek, które oferują checkbox "inne dane do faktury"?

Aby móc korzystać z wtyczek w WooCommerce, które oferują dodatkowe pola, takie jak checkbox "inne dane do faktury" należy postępować według poniższej instrukcji:

  1. Zainstaluj i aktywuj wtyczkę, np. Flexible Checkout Fields PRO WooCommerce.

  2. Przejdź do ustawień wtyczki, dodaj checkbox o nazwie "inne dane do faktury" lub "wystaw fakturę na firmę" i wprowadź nowe pola (nazwy firmy, NIP, ulica firmy, kodu pocztowy firmy oraz miasto firmy).

  3. Ważne jest, aby nazwy pól zostały ustawione zgodnie z poniższą listą:

    • Nazwa firmy - _billing_company_name

    • NIP - _billing_tax_no

    • Ulica firmy - _billing_company_address

    • Kod pocztowy firmy - _billing_company_postcode

    • Miasto firmy - _billing_company_city

  4. Po ustawieniu takich nazw, będziesz miał pewność, że po zaznaczeniu checkboxa przez Klienta, faktura wystawi się z odpowiednimi danymi. 

  5. W razie jakichkolwiek problemów z korzystaniem z wtyczek, warto skontaktować się z ich twórcami lub zapoznać się z dokumentacją wtyczki, aby uzyskać więcej informacji na temat ustawień i konfiguracji.

Czy mogę wystawiać e-paragony w integracji z WooCommerce?

Tak, możesz wystawiać e-paragony w integracji z WooCommerce, ale musisz mieć wykupiony moduł Paragony.pl z opcją e-paragonów.

Jak to skonfigurować?

  1. Wykup moduł Paragony.pl
    Moduł jest niezbędny do fiskalizacji i wystawiania e-Paragonów. Instrukcja dot. uruchomienia e-Paragonów w Fakturowni.

  2. Włącz automatyczną fiskalizację
    W Fakturowni przejdź do Ustawienia > Ustawienia konta i aktywuj opcję Automatyczna fiskalizacja paragonów po utworzeniu przez API oraz Automatyczne wysyłanie e-paragonów emailem.

  3. Ustaw domyślny sposób wydruku na e-Paragon
    W Ustawienia > Drukarki fiskalne edytuj swoją drukarkę i zmień Domyślny sposób wydruku na e-Paragon.

  4. Wybierz domyślną drukarkę fiskalną
    Możesz ustawić ją globalnie w Ustawieniach konta lub osobno dla każdego Działu. Jeśli tego nie zrobisz, system wybierze najstarszą drukarkę na Twoim koncie.

  5. Dodaj link do e-Paragonu w wiadomościach do kupujących
    W szablonie maili e-paragonów wysyłanych z Fakturowni umieść URL do podglądu e-Paragonu jako {{{e_receipt_view_url}}}. Dzięki temu kupujący otrzyma link z paragonem na maila.

Po tej konfiguracji system automatycznie będzie wystawiał e-paragony i udostępniał je kupującym.

Obsługa kodów GTU

Jeśli przypisujesz kody GTU bezpośrednio w WooCommerce, nie zostaną one automatycznie przeniesione do Fakturowni wraz z zamówieniem ze sklepu.

Aby kody GTU były widoczne na dokumentach sprzedażowych generowanych w ramach integracji, należy przypisać je bezpośrednio na karcie produktu w zakładce Produkty w Fakturowni. Dzięki temu system automatycznie uwzględni je podczas wystawiania dokumentów.

Szczegółowa instrukcja przypisywania kodów GTU na karcie produktu dostępna jest tutaj: Kody GTU - grupowanie towarów i usług

Aby integracja działała prawidłowo, upewnij się, że spełnione są dwa warunki:

  1. Aktywna opcja kojarzenia produktów po kodzie produktu - umożliwia powiązanie produktów z WooCommerce z produktami utworzonymi w Fakturowni.

  2. Zgodność kodów produktów - kod produktu w WooCommerce musi być identyczny z kodem w Fakturowni.

Jeśli oba warunki są spełnione, kod GTU przypisany w Fakturowni zostanie automatycznie przeniesiony na dokument sprzedażowy wygenerowany za pomocą integracji.

Jak używać opcji synchronizacji magazynów w integracji z WooCommerce?

Aby skutecznie zsynchronizować stany magazynowe między WooCommerce a Fakturownią, produkty muszą już istnieć w obu systemach. 


Włączenie synchronizacji magazynów

Aby uruchomić synchronizację, należy w ustawieniach integracji WooCommerce włączyć opcję Synchronizuj stany magazynowe. Szczegóły znajdziesz tutaj: Integracja Fakturowni z WooCommerce

Po aktywacji zostanie uruchomiona podstawowa, jednostronna synchronizacja - stany magazynowe z Fakturowni będą przesyłane do WooCommerce. Na tym etapie możesz również skonfigurować dodatkowe opcje:
  • automatyczna aktualizacja cen,
  • wybór nazw produktów widocznych na dokumentach,
  • wskazanie konkretnego magazynu Fakturowni dla synchronizacji.
Wskazówka:
Przy pierwszym uruchomieniu synchronizacji warto skorzystać z opcji „Synchronizuj produkty z Fakturownią”, by zaktualizować stany produktów już istniejących.


Ustawienia produktów w Fakturowni

Aby produkty zostały poprawnie powiązane:
  1. Upewnij się, że każdy produkt ma unikalny kod - zarówno w WooCommerce, jak i w Fakturowni.
  2. Włącz opcję kojarzenia produktów po kodzie w Fakturowni. Instrukcja: Kojarzenie produktów po kodzie
  3. Wprowadź kody produktów w Fakturowni: Magazyn > Produkty > Edycja produktu > Kod produktu.
Po wykonaniu tych kroków produkty z dokumentów sprzedażowych będą automatycznie kojarzone z produktami z bazy Fakturowni.


Dodatkowe informacje

Obsługa Produktów dostępna jest we wszystkich planach abonamentowych, ale pełna funkcjonalność modułu magazynowego (również moduł Magazyn) wymaga abonamentu Standard lub wyższego.

Należy również pamiętać o tym, że synchronizacja nie działa dwustronnie. Produkty z Fakturowni nie są automatycznie dodawane do WooCommerce. Natomiast w drugą stronę to możliwe - produkty dodane na dokumentach sprzedaży w WooCommerce mogą być automatycznie zapisywane w bazie produktów Fakturowni.

Przydatne linki:

Automatyczne dodawanie produktów
Dodawanie produktu przy pomocy faktury sprzedażowej

Nie znalazłeś odpowiedzi na swoje pytania? Napisz do nas na integracje@fakturownia.pl

Sprawdź również: 
Jak wystawiać e-paragony dla klientów sklepu internetowego?
Produkty - baza produktów w systemie
Kody produktu
Kojarzenie produktów o innej nazwie po kodzie produktów

Integracje i dodatki Fakturowni


Powrót


Dodaj komentarz