Faktury proforma PDF dla WooCommerce — Dokumentacja
Instalacja, konfiguracja i użytkowanie wtyczki generującej faktury proforma PDF dla WooCommerce.
Przegląd
Wtyczka Faktury proforma PDF dla WooCommerce generuje profesjonalne faktury proforma w formacie PDF bezpośrednio z zamówień WooCommerce. Każdy dokument automatycznie zawiera produkty wraz z ich atrybutami (wymiary, opcje, personalizacje), komplet sum WooCommerce (suma częściowa, wysyłka, rabaty, VAT) oraz dane Twojej firmy.
Faktura proforma to dokument niewiążący, wystawiany przed dokonaniem płatności. Nie zastępuje faktury końcowej.
Instalacja
1. Instalacja wtyczki
- W panelu WordPress przejdź do Wtyczki → Dodaj nową → Wyślij wtyczkę na serwer.
- Wybierz archiwum ZIP wtyczki i kliknij Zainstaluj teraz.
- Aktywuj wtyczkę.
2. Wymagania
- WordPress 6.0 lub nowszy
- WooCommerce 7.0 lub nowszy (zgodność z HPOS)
- PHP 8.0 lub nowszy
Konfiguracja
Ustawienia znajdują się w WooCommerce → Proforma i są podzielone na trzy zakładki.
Zakładka Firma
Uzupełnij dane, które pojawią się w bloku wystawcy na PDF: logo (z biblioteki mediów), nazwa firmy, pełny adres, telefon, e-mail, numer VAT UE oraz numer rejestrowy firmy.
Zakładka Dokument
- Prefiks numeracji: np.
PRO-daje PRO-00001, PRO-00002 itd. Licznik zwiększa się automatycznie, a każdy numer pozostaje przypisany do swojego zamówienia. - Ważność: liczba dni ważności proformy (data ważności jest drukowana na dokumencie).
- Symbol i pozycja waluty: 10,00 € lub € 10,00.
- Kolor akcentu: kolor pasków, tytułów i nagłówków tabeli w PDF.
- Tekst stopki: informacja prawna drukowana na dole każdej strony.
Zakładka E-mail
Włącz Załączaj automatycznie, aby proforma była dołączana do e-maili potwierdzających zamówienie (nowe zamówienie, w realizacji, wstrzymane).
Generowanie proformy
Z poziomu zamówienia
W bocznej kolumnie każdego zamówienia pojawia się ramka Faktura proforma. Pozwala wygenerować PDF, pobrać go i wygenerować ponownie po zmianie zamówienia. Akcja jest również dostępna w rozwijanym menu Akcje zamówienia.
Z listy zamówień
- Dedykowana kolumna: ikona wskazuje, czy proforma istnieje (niebieska), czy nie (szara); kliknięcie pobiera ją lub generuje.
- Akcja masowa: zaznacz kilka zamówień i wybierz Generuj proformy, aby przetworzyć je zbiorczo.
Po zmianie zamówienia (dodanie produktu, zastosowanie rabatu) użyj przycisku Generuj ponownie, aby zaktualizować PDF — numer proformy pozostaje bez zmian.
Zawartość PDF
- Bloki wystawca / odbiorca z pełnymi adresami
- Tabela produktów z numerem SKU, nazwą i atrybutami produktu (wymiary, opcje personalizacji…)
- Kompletne sumy identyczne z WooCommerce: suma częściowa, wysyłka, rabaty i kupony, VAT, suma całkowita
- Metoda płatności i uwagi klienta (opcjonalnie)
- Numeracja, data wystawienia i data ważności
Przechowywanie i bezpieczeństwo
Pliki PDF zapisywane są w wp-content/uploads/df-proforma/ — katalogu chronionym przed listowaniem. Tylko użytkownicy z uprawnieniem manage_woocommerce mogą generować lub pobierać dokumenty.
Najczęstsze pytania
PDF się nie generuje
Sprawdź, czy biblioteka PDF jest zainstalowana (w razie jej braku w panelu pojawia się powiadomienie) oraz czy katalog uploads ma prawa zapisu.
Czy mogę zmienić numer istniejącej proformy?
Numer jest ustalany przy pierwszym wygenerowaniu i zapisywany w zamówieniu, aby zagwarantować identyfikowalność. Ponowne wygenerowanie dokumentu zachowuje ten sam numer.
Czy rabaty i koszty wysyłki są widoczne?
Tak, dokument odwzorowuje dokładnie wiersze sum obliczone przez WooCommerce, łącznie z darmową wysyłką i kuponami.