# Faktury proforma PDF dla WooCommerce — Dokumentacja

> 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),…

- Strona: <https://www.datafirefly.com/pl/documentation/df-proforma-woo/>
- Język: pl
- Zaktualizowano: 2026-08-06
- Inne języki: [fr](https://www.datafirefly.com/documentation/df-proforma-woo/index.md), [en](https://www.datafirefly.com/en/documentation/df-proforma-woo/index.md), [es](https://www.datafirefly.com/es/documentation/df-proforma-woo/index.md), [de](https://www.datafirefly.com/de/documentation/df-proforma-woo/index.md), [it](https://www.datafirefly.com/it/documentation/df-proforma-woo/index.md), [nl](https://www.datafirefly.com/nl/documentation/df-proforma-woo/index.md), [pt](https://www.datafirefly.com/pt/documentation/df-proforma-woo/index.md)
- Indeks: <https://www.datafirefly.com/pl/documentation/llms.txt>

## 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

1. W panelu WordPress przejdź do **Wtyczki → Dodaj nową → Wyślij wtyczkę na serwer**.
2. Wybierz archiwum ZIP wtyczki i kliknij **Zainstaluj teraz**.
3. 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.