Przejdź do treści

[FAQ] Integracja Fakturowni z WooCommerce

Wyświetleń: 18375 7 min czytania
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.

 

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 Domyślna stawka podatku na dokumentach tego działu wybierz 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).    
  4. Następnie, przy tworzeniu produktu wybierz stawkę Opodatkowany i klasę podatkową 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.   
  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.
  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.  
  4. Wejdź w zakładkę Checkout Form.
  5. Dodaj nowe pole.
  6. Uzupełnij pole według wzoru.  
  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
Produkty - baza produktów w systemie Kody produktu Kojarzenie produktów o innej nazwie po kodzie produktów Integracje i dodatki Fakturowni

Czy ten wpis był pomocny?

Udostępnij

Główna odpowiedź Daniel Śmiech 2026-02-09 11:43

Dzień dobry,

integracja o której Państwo piszą to zewnętrzne rozwiązanie, w związku z tym w tej sprawie należy kontaktować się bezpośrednio z jej twórcami, ponieważ nie wiemy czy zastosowano w niej możliwości obsługi takiej funkcji.  



Pozdrawiam

Komentarze (3)

Anonymous 2026-02-21 08:48
Dzień dobry, Czy w związku z wprowadzeniem KSEF planują Państwo dodanie do integracji Fakturowni z Woocommerce opcji, która pozwalałaby wysyłać do klienta automatycznego maila z fakturą, ale dopiero tej zatwierdzonej przez KSEF? Chodzi mi o pracę w trybie ręcznym, w którym faktury byłyby sprawdzane wieczorem i wtedy wysyłane do Ksef. Nie chciałbym żeby w tym trybie ręcznym faktury wysyłały się od razu po zamówieniu (bez numeru ksef) bo to nie byłyby jeszcze pełnoprawne dokumenty księgowe.
Daniel Śmiech 2026-02-09 11:43 Główna odpowiedź
Dzień dobry,
integracja o której Państwo piszą to zewnętrzne rozwiązanie, w związku z tym w tej sprawie należy kontaktować się bezpośrednio z jej twórcami, ponieważ nie wiemy czy zastosowano w niej możliwości obsługi takiej funkcji.  

Pozdrawiam
Anonymous 2026-02-03 11:18
Korzystam ze standardowej integracji Woocommerce by WPhocus oferowanej przez Fakturownię. W jaki sposób mój sklep Woocommerce może wystawiać faktury w różnych działach? Korzystam ze zwolnienia VAT na podstawie art 113 lub art 43 - na fakturach powinna znaleźć się stosowna adnotacja w zależnosci od sprzedawanej usługi/produktu. Skonfigurowałem w dziale głównym domyślną podstawę zastosowania stawki zw na art 43. Stworzyłem dodatkowy dział ze zwolnieniem na podstawie art 113. Teraz muszę w jakiś sposób określi, które produkty/usługi powinny należeć do tego dodatkowego działu.