Wo WooCommerce Początkujący

Faktury proforma PDF dla WooCommerce — Dokumentacja

Instalacja, konfiguracja i obsługa DataFirefly Faktury pro forma 2.0 dla WooCommerce: wzory i podgląd na żywo, dane firmy i dane bankowe, numeracja, przyciski dla klientów, e-maile, zamówienia i aktualizacja z wersji 1.x.

Zaktualizowano Wersja modułu 2.0.0

Przegląd

DataFirefly Faktury pro forma tworzy profesjonalne faktury pro forma w PDF dla zamówień i koszyków WooCommerce. Tworzysz je jednym kliknięciem z dowolnego zamówienia, dołączasz do e-maili WooCommerce albo pozwalasz klientom pobierać je z koszyka, z konta lub ze strony potwierdzenia zamówienia.

Faktura pro forma pokazuje, ile klient zapłaci, zanim zamówienie zostanie opłacone: pozwala klientowi zapłacić z góry przelewem bankowym, uzyskać akceptację zakupu w dziale zakupów lub przygotować dokumenty celne.

Faktura pro forma nie jest fakturą VAT. Dokument domyślnie o tym informuje; faktury końcowe wystawiaj tak jak dotychczas.

Wymagania i instalacja

Wymagania

  • WordPress 6.4 lub nowszy (testowano do 7.1)
  • WooCommerce 8.2 lub nowszy (testowano do 11.2), z HPOS lub bez
  • PHP od 7.4 do 8.5 z rozszerzeniami dom i mbstring (dostępnymi na niemal każdym hostingu). GD służy do spłaszczania przezroczystych logo.

Silnik PDF (Dompdf) jest w zestawie: nie trzeba instalować niczego więcej.

Instalacja

  1. Przejdź do Wtyczki > Dodaj wtyczkę > Wyślij wtyczkę na serwer, wybierz plik df-proforma-woo-2.0.0.zip i kliknij Zainstaluj teraz.
  2. Włącz wtyczkę. WooCommerce musi być włączony.
  3. Otwórz WooCommerce > Pro forma.

Przewodnik konfiguracji i przegląd

Zakładka Przegląd otwiera się przewodnikiem w czterech krokach: wpisz dane firmy, dodaj logo i wybierz wzór, wybierz, gdzie klienci mogą pobrać dokument, otwórz testowy PDF. Każdy krok jest automatycznie oznaczany jako wykonany.

Przegląd pokazuje następnie liczbę wystawionych faktur pro forma (łącznie i w tym miesiącu), następny numer, miejsca, z których klienci mogą pobrać dokument, e-maile, do których jest dołączany, ostatnie faktury pro forma z linkiem do ich PDF oraz stan systemu.

DataFirefly Faktury pro forma – Panel faktur pro forma: przewodnik konfiguracji, wystawione dokumenty, następny numer i ostatnie faktury
Panel faktur pro forma: przewodnik konfiguracji, wystawione dokumenty, następny numer i ostatnie faktury

Dokument: wzór i podgląd na żywo

Zakładka Dokument określa wygląd pliku PDF. Podgląd na żywo obok ustawień korzysta z tego samego szablonu i czcionek co PDF i zmienia się w trakcie pisania, jeszcze przed zapisaniem. Nad podglądem wybierz przykładowe dane lub jedno z 12 ostatnich zamówień; Otwórz jako PDF pokazuje prawdziwy plik. Podgląd nigdy nie nadaje numeru.

DataFirefly Faktury pro forma – Ustawienia dokumentu z podglądem faktury pro forma na żywo
Ustawienia dokumentu z podglądem faktury pro forma na żywo

Wzór

  • Szablon: Nowoczesny, Klasyczny, Minimalistyczny lub Wyrazisty.
  • Kolor marki: wybierz jeden z proponowanych kolorów lub własny. Tekst na tym kolorze automatycznie zmienia się na biały lub czarny, aby pozostał czytelny.
  • Czcionka: bezszeryfowa lub szeryfowa. Format papieru: A4 lub Letter (USA).
  • Logo: wybierane z biblioteki mediów, w trzech rozmiarach. Bez logo wyświetlana jest nazwa firmy.
DataFirefly Faktury pro forma – Cztery szablony faktury pro forma: Nowoczesny, Klasyczny, Minimalistyczny i Wyrazisty
Cztery szablony faktury pro forma: Nowoczesny, Klasyczny, Minimalistyczny i Wyrazisty
DataFirefly Faktury pro forma – Szablon Wyrazisty z kolorem marki i logo w podglądzie na żywo
Szablon Wyrazisty z kolorem marki i logo w podglądzie na żywo

Produkty i kwoty

  • Ceny na dokumencie: netto (typowe dla klientów biznesowych, z podatkiem doliczonym na końcu) lub brutto. Pozycje i sumy zawsze używają tego samego trybu.
  • Opcjonalne kolumny i bloki: kolumna SKU, zdjęcia produktów, kolumna stawki podatku, podsumowanie podatku według stawek, adres wysyłki (jeśli jest inny), metoda płatności, uwagi od klienta.

Teksty i informacje prawne

  • Tytuł dokumentu: pozostaw puste, aby użyć „Faktura pro forma” w języku każdego klienta.
  • Ważność (dni): 0 ukrywa datę „Ważna do”.
  • Wstęp, Warunki i Stopka (wyświetlana na dole każdej strony, nad identyfikatorami firmy).
  • Zaznacz, że dokument nie jest fakturą VAT: zalecane.

W tekstach można używać zmiennych {customer_name}, {order_number}, {proforma_number}, {valid_until} i {site_title}.

Dane firmy i dane bankowe

Zakładka Firma wypełnia blok wystawcy na dokumencie. Użyj adresu sklepu WooCommerce kopiuje adres sklepu jednym kliknięciem.

  • Nazwa firmy, adres, kod pocztowy, miasto, kraj, telefon, e-mail i strona internetowa.
  • Identyfikatory i informacje prawne: numer VAT, numer rejestrowy z jego lokalną nazwą (na przykład SIRET, Handelsregister, KvK, NIP, CIF, Codice fiscale) oraz inne informacje, jedna na wiersz.
  • Dane bankowe: właściciel rachunku, bank, IBAN i BIC / SWIFT, wyświetlane na każdym dokumencie, gdy opcja jest włączona. Jeśli nie podasz własnych danych, używane są konta z metody WooCommerce „Przelew bankowy”.
DataFirefly Faktury pro forma – Dane firmy, numer VAT, numer rejestrowy i dane bankowe na fakturze pro forma
Dane firmy, numer VAT, numer rejestrowy i dane bankowe na fakturze pro forma

Numeracja

Zakładka Numeracja pokazuje następny numer w trakcie zmiany ustawień.

  • Numer oparty na: własnej sekwencji (zalecane: kolejne numery bez luk, w kolejności wystawiania dokumentów, nawet gdy dwa dokumenty są wystawiane jednocześnie) lub numerze zamówienia.
  • Prefiks i Sufiks: kliknij znacznik, aby wstawić {Y} (rok), {y} (rok dwucyfrowy), {m} (miesiąc), {d} (dzień) lub {order_number}.
  • Cyfry, Zeruj licznik (co roku lub nigdy) i Następna wartość licznika (zmieniaj ją tylko wtedy, gdy kontynuujesz istniejącą numerację).

Numer jest nadawany przy pierwszym otwarciu, pobraniu, dołączeniu do e-maila lub wysłaniu dokumentu zamówienia. Jest zapisywany w zamówieniu i nigdy się nie zmienia.

DataFirefly Faktury pro forma – Numeracja faktur pro forma: własna sekwencja lub numer zamówienia, prefiks z rokiem, reset co roku
Numeracja faktur pro forma: własna sekwencja lub numer zamówienia, prefiks z rokiem, reset co roku

Klienci i e-maile

Zakładka Klienci i e-maile określa, gdzie klienci mogą otrzymać dokument. Te przyciski są wyłączone, dopóki ich nie włączysz.

  • Przycisk w Moje konto > Zamówienia (lista zamówień i strona zamówienia) i Przycisk na stronie potwierdzenia zamówienia, dla wybranych statusów zamówień. Kierownicy sklepu zawsze mogą otworzyć dokument z poziomu zamówienia.
  • Koszyk: dodaj do koszyka przycisk „Pobierz fakturę pro forma”, wybierz jego tekst, udostępnij go wszystkim odwiedzającym lub tylko zalogowanym klientom i pytaj o imię i nazwisko, firmę i adres do umieszczenia na dokumencie.
  • E-maile: dołączaj PDF do wybranych e-maili WooCommerce (domyślnie „Zamówienie wstrzymane”, używany przy przelewach bankowych) i włącz e-mail „Faktura pro forma”. Edytuj e-mail otwiera go w WooCommerce > Ustawienia > E-maile, gdzie zmienisz jego temat, nagłówek i treść.
DataFirefly Faktury pro forma – Przyciski dla klientów w Moje konto, na potwierdzeniu zamówienia i w koszyku oraz załączniki e-maili
Przyciski dla klientów w Moje konto, na potwierdzeniu zamówienia i w koszyku oraz załączniki e-maili

Dokument PDF

Każdy dokument powstaje na podstawie aktualnego zamówienia, więc zawsze jest z nim zgodny:

  • bloki wystawcy i klienta, z nazwą kraju i formatem adresu właściwym dla danego kraju;
  • numer, data wystawienia, data ważności, numer zamówienia i metoda płatności;
  • pozycje produktów z ich opcjami (na przykład Kolor: Czerwony), SKU, zdjęciem i stawką podatku, gdy te kolumny są włączone;
  • suma częściowa, rabaty z kodami kuponów, wysyłka, opłaty, suma netto, jeden wiersz na każdą stawkę podatku, suma, zwroty i kwota do zapłaty, w walucie zamówienia;
  • podsumowanie podatku według stawek, dane bankowe, warunki, stopka i numery stron.

Długie zamówienia są kontynuowane na kolejnych stronach, z powtarzanym nagłówkiem tabeli i stopką na każdej stronie. Czcionki obejmują alfabet łaciński, grecki i cyrylicę.

DataFirefly Faktury pro forma – Faktura pro forma w PDF z dwiema stawkami VAT, podsumowaniem podatków i danymi bankowymi
Faktura pro forma w PDF z dwiema stawkami VAT, podsumowaniem podatków i danymi bankowymi

Praca z zamówieniami

Pole Faktura pro forma

Każde zamówienie ma pole Faktura pro forma z numerem i datami oraz przyciskami Zobacz PDF, Pobierz, Wyślij fakturę pro forma do klienta i Ustaw dzisiejszą datę, który rozpoczyna okres ważności od nowa. Pole informuje też, czy klient może pobrać dokument, a jeśli nie, to dlaczego.

DataFirefly Faktury pro forma – Panel Faktura pro forma zamówienia WooCommerce: podgląd, pobieranie i wysyłka do klienta
Panel Faktura pro forma zamówienia WooCommerce: podgląd, pobieranie i wysyłka do klienta

Lista zamówień

Kolumna Pro forma pokazuje numer każdego zamówienia (kliknij, aby otworzyć PDF) lub Utwórz. Dodawane są dwa działania zbiorcze: Pobierz faktury pro forma (PDF), które umieszcza do 50 zamówień w jednym pliku PDF, oraz Wyślij faktury pro forma e-mailem. Każde działanie jest potwierdzane komunikatem.

DataFirefly Faktury pro forma – Lista zamówień WooCommerce z kolumną Pro forma i zbiorczym pobieraniem
Lista zamówień WooCommerce z kolumną Pro forma i zbiorczym pobieraniem

Pro forma z koszyka

Gdy przycisk w koszyku jest włączony, klienci mogą otrzymać fakturę pro forma przed złożeniem zamówienia, w klasycznym koszyku i w bloku Koszyk. Krótki formularz pyta o imię i nazwisko, firmę, adres, kraj, numer VAT i e-mail do umieszczenia na dokumencie, wstępnie wypełnione dla zalogowanych klientów; nic nie jest zapisywane na ich koncie. PDF pobiera się bez opuszczania koszyka.

Dokumenty z koszyka otrzymują oznaczenie zaczynające się od C i nie korzystają z Twojej numeracji. Aby zapobiec nadużyciom, odwiedzający może utworzyć 10 dokumentów z koszyka co 10 minut.

Aby umieścić przycisk w innym miejscu, użyj bloku Przycisk pro forma (tekst, styl i wyrównanie) lub shortcode’u [df_proforma_cart_button].

DataFirefly Faktury pro forma – Pro forma z koszyka: formularz z imieniem, firmą, adresem i numerem VAT przed pobraniem PDF
Pro forma z koszyka: formularz z imieniem, firmą, adresem i numerem VAT przed pobraniem PDF

Moje konto i potwierdzenie zamówienia

Dla wybranych statusów klient znajdzie przycisk pobierania w Moje konto > Zamówienia i na stronie potwierdzenia zamówienia, zarówno w motywach klasycznych, jak i blokowych. Linki wymagają tajnego klucza zamówienia, a zarejestrowani klienci muszą być zalogowani.

DataFirefly Faktury pro forma – Strona zamówienia w Moje konto z polem pobierania faktury pro forma
Strona zamówienia w Moje konto z polem pobierania faktury pro forma

Narzędzia, języki i prywatność

Zakładka Narzędzia zawiera:

  • Język dokumentów: język klienta (język konta, WPML lub Polylang) lub język witryny.
  • Prywatność: dokumenty są generowane na żądanie i nie są przechowywane na serwerze; załączniki e-maili to pliki tymczasowe w folderze prywatnym, usuwane zaraz po wysłaniu; bez plików cookie i bez zewnętrznych żądań. Proponowany tekst do polityki prywatności jest dodawany do poradnika polityki prywatności WordPressa.
  • Pliki z wersji 1: usuń pliki PDF pozostawione przez wersję 1.
  • System: silnik PDF, rozszerzenia PHP, folder prywatny i czcionki, z przyciskami Usuń pliki tymczasowe i Pokaż ponownie przewodnik konfiguracji.
  • Po usunięciu wtyczki: wybierz Zachowaj ustawienia, aby zachować je po usunięciu wtyczki. Numery pro forma pozostają w zamówieniach, a liczniki są zawsze zachowywane, więc ponowna instalacja nigdy nie nada dwa razy tego samego numeru.

Wtyczka jest przetłumaczona na angielski, francuski, hiszpański, niemiecki, portugalski (Portugalia), włoski, polski i niderlandzki.

Aktualizacja z wersji 1.x

Zainstaluj wersję 2.0.0 na wersję 1.x (Wtyczki > Dodaj wtyczkę > Wyślij wtyczkę na serwer, a następnie Zastąp obecną wersję wgraną). Przy pierwszym załadowaniu:

  • dane firmy, logo, kolor, ważność i ustawienia e-maili zostają zachowane;
  • numeracja pozostaje identyczna: ten sam licznik, ten sam prefiks, numery już nadane zamówieniom zostają zachowane;
  • pliki PDF z wersji 1, które można było otworzyć po ich adresie, są przenoszone do folderu prywatnego; możesz je usunąć w zakładce Narzędzia;
  • nowe przyciski dla klientów pozostają wyłączone, dopóki ich nie włączysz, a komunikat wyjaśnia nowości.

TCPDF nie jest już używany: możesz usunąć każdą kopię TCPDF zainstalowaną na potrzeby wersji 1.

Dla deweloperów

Szablon

Skopiuj templates/document.php do yourtheme/df-proforma-woo/document.php, aby zmienić układ.

Hooki

  • dfpw_order_data (array $doc, WC_Order $order) i dfpw_cart_data (array $doc, WC_Cart $cart, array $buyer): dane dokumentu.
  • dfpw_proforma_number (string $number, WC_Order $order): nowy numer.
  • dfpw_document_css, dfpw_template_file, dfpw_document_locale.
  • dfpw_customer_can_download, dfpw_cart_allowed, dfpw_cart_rate_limit, dfpw_attach_to_email, dfpw_customer_vat_number.
  • dfpw_capability (ustawienia, domyślnie manage_woocommerce) i dfpw_order_capability (dokumenty zamówień, domyślnie edit_shop_orders).
  • Akcje: dfpw_number_issued, dfpw_pdf_generated, dfpw_cart_document_created.

WP-CLI

  • wp dfpw status
  • wp dfpw generate <order>... [--output=<file>] lub wp dfpw generate 0 --sample
  • wp dfpw next-number [<value>]
  • wp dfpw cleanup

Rozwiązywanie problemów

Plik PDF nie jest tworzony

Otwórz Pro forma > Narzędzia > System lub Narzędzia > Kondycja witryny: muszą być dostępne rozszerzenia PHP dom i mbstring, a folder prywatny musi mieć prawa zapisu.

Klient nie widzi przycisku pobierania

Sprawdź, czy przycisk jest włączony w zakładce Klienci i e-maile i czy status zamówienia należy do wybranych statusów. Pole Faktura pro forma w zamówieniu wyjaśnia, dlaczego klient nie może pobrać dokumentu.

Brakuje niektórych znaków

Czcionki obejmują alfabet łaciński, grecki i cyrylicę. Język chiński, japoński, koreański, arabski i hebrajski nie są obsługiwane.

Kwoty nie zgadzają się z zamówieniem

Dokument zawsze odzwierciedla aktualne zamówienie. Jeśli zmieniłeś zamówienie po wysłaniu faktury pro forma, otwórz dokument ponownie lub wyślij go jeszcze raz.

Czy ta strona była pomocna?

Nadal utknąłeś? Napisz do wsparcia