# DataFirefly Edytor faktur PDF dla PrestaShop

> Opis Moduł dfinvoiceeditor zastępuje układ faktur PDF w PrestaShop 8 i 9 Twoim własnym, ustawianym w panelu administracyjnym. Nie zmienia żadnego pliku .tpl i nie instaluje override: gdy PrestaShop generuje…

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

## Opis

Moduł **dfinvoiceeditor** zastępuje układ faktur PDF w PrestaShop 8 i 9 Twoim własnym, ustawianym w panelu administracyjnym. Nie zmienia żadnego pliku `.tpl` i nie instaluje override: gdy PrestaShop generuje fakturę, moduł dostarcza własny nagłówek, treść i stopkę. Wyłączenie modułu lub jego głównego przełącznika przywraca oryginalną fakturę.

Ustawienia dotyczą wszystkich faktur tworzonych przez PrestaShop: dołączanych do e-maili zamówienia, pobieranych z konta klienta oraz drukowanych pojedynczo lub zbiorczo w panelu. Opcjonalnie dowody dostawy otrzymują ten sam wygląd.

## Instalacja

1. W **Moduły > Menedżer modułów** kliknij **Załaduj moduł** i wyślij plik `dfinvoiceeditor.zip`.
2. Moduł tworzy tabelę ustawień, folder `img/dfinvoiceeditor` na logo i stronę **Zamówienia > Edytor faktur**.
3. Otwórz tę stronę. Układ modułu działa od instalacji z prostymi ustawieniami domyślnymi: wygeneruj podgląd, aby go zobaczyć.

Moduł działa w PrestaShop od 8.0 do 9.x, w trybie multistore (ustawienia dla każdego sklepu) i wielojęzycznym. Nie wymaga zależności Composer.

## Edytor

Strona jest podzielona na sekcje wymienione w lewej kolumnie. Pod listą szkic strony A4 podświetla edytowaną strefę faktury. Pasek na dole pokazuje, czy są niezapisane zmiany, i zawiera przycisk **Zapisz**.

Drukowane teksty istnieją w każdym języku sklepu. Przyciski języków pod nagłówkiem wybierają język wyświetlany we wszystkich polach wielojęzycznych.

### Podgląd i porównanie

U góry strony wybierz ostatnią fakturę sklepu, a potem **Faktura** lub **Dowód dostawy**:

- **Podgląd** otwiera PDF w nowej karcie z ustawieniami z ekranu, nawet niezapisanymi. Tylko nowo przesłane logo czeka na zapis.
- **Porównaj z fakturą PrestaShop** otwiera ten sam dokument w oryginalnym układzie.

## Ustawienia ogólne

- **Używaj tego układu dla faktur**: główny przełącznik. Po wyłączeniu PrestaShop znów drukuje własną fakturę, bez utraty ustawień.
- **Używaj tego układu także dla dowodów dostawy**: zob. sekcja Dowody dostawy.
- **Język faktury**: język zamówienia (zalecane) lub pracownika generującego PDF.
- **Czcionka**: automatyczna według języka, Helvetica, DejaVu Sans, Times lub Courier. DejaVu Sans obsługuje polskie znaki, grekę i cyrylicę; dla polskiego wybierz ją lub tryb automatyczny.
- **Rozmiar tekstu** od 7 do 12 pt i cztery kolory: akcent (tytuł, nagłówek tabeli, kwota do zapłaty, tytuły sekcji), tekst, tekst pomocniczy i tekst na kolorze akcentu.

## Nagłówek i logo

Wybierz logo faktury sklepu, osobne logo dla faktur lub brak logo. Osobne logo przyjmuje PNG, JPG lub GIF do 2 MB; PNG o szerokości co najmniej 600 px drukuje się ostro. Ustaw szerokość od 10 do 90 mm i położenie z lewej lub z prawej. Wysokość jest ograniczona do 26 mm, aby nagłówek nie nachodził na treść.

## Adresy i podsumowanie

**Blok sprzedawcy** to dowolny tekst ze zmiennymi, domyślnie `{shop_name}`, `{shop_address}` i `{shop_details}` (dane z _Preferencje sklepu > Kontakt_). Adresy rozliczeniowy i dostawy używają formatu adresu kraju; adres dostawy można ukryć, gdy jest taki sam jak rozliczeniowy. Moduł porównuje adresy w takiej postaci, w jakiej się drukują (firma, imię i nazwisko, ulica, kod pocztowy, miasto, kraj), bez telefonu, numeru VAT i DNI: ten sam adres zapisany przez klienta dwa razy również zostanie ukryty. Numer VAT, telefon i e-mail klienta są opcjonalne.

**Gdzie drukować blok sprzedawcy**: w wierszu adresów (domyślnie) lub **pod logo**, w nagłówku. Pod logo blok dzieli około 35 mm, które PrestaShop rezerwuje na nagłówek. Moduł mierzy tekst na każdej fakturze i zostawia logo pozostałą wysokość, nigdy mniej niż 12 mm. Gdy blok jest za długi, układa się w dwóch kolumnach pod logo, a potem mniejszą czcionką. Żaden wiersz nie jest obcinany. W rzadkim przypadku, gdy dwie kolumny nie wystarczą, logo zachowuje swój rozmiar, a blok drukuje się tuż pod nagłówkiem, na górze pierwszej strony. Aby zachować duże logo, użyj `{shop_address_inline}`, która mieści adres w jednym wierszu. Tekst drukowany na dole każdej strony to stopka modułu, ustawiana osobno w sekcji Stopka.

**Pasek podsumowania**, kolorowy pas pod adresami, pokazuje do wyboru numer i datę zamówienia, płatność, termin płatności, przewoźnika i numer przesyłki oraz umieszczone w nim pola własne.

## Pozycje produktów

Tabela zawiera 12 dostępnych kolumn: zdjęcie, indeks, nazwa, EAN-13, indeks dostawcy, cena jednostkowa netto, cena jednostkowa brutto, rabat, stawka VAT, ilość, wartość netto, wartość brutto. Dla każdej kolumny zaznacz drukowanie, zmień tytuł w każdym języku, ustaw względną szerokość i wyrównanie, a kolejność zmieniaj strzałkami. Pasek nad tabelą pokazuje podział szerokości, dopasowanych do strony.

- Kombinacje („Rozmiar: M, Kolor: Niebieski”) trafiają do drugiego, mniejszego wiersza.
- Personalizacje wpisane przez klienta drukują się pod nazwą produktu.
- Miniatura produktu ma od 6 do 25 mm.
- Linia pod każdym wierszem, pełna siatka lub brak obramowań; opcjonalne naprzemienne cieniowanie.
- Tytuły kolumn powtarzają się na górze każdej strony długiej faktury.

## Sumy

- **Zestawienie VAT według stawek**: podstawa i kwota dla każdej stawki, z produktami, dostawą, opakowaniem prezentowym i ekotaksą razem.
- **Ukryj wiersze zerowe** rabatu i opakowania prezentowego.
- **Wypisz otrzymane płatności** z metodą, kwotą i datą.
- **Treść dodana przez inne moduły**: to, co inne moduły dodają do faktur przez hook `displayPDFInvoice`, nadal się drukuje, po sumach, po pozycjach produktów lub jest ukryte.

## Płatność i termin

### Termin i kwota do zapłaty

**Okres płatności** w dniach od daty faktury drukuje termin płatności na pasku podsumowania i wypełnia zmienną `{due_date}`. Pozostaw 0, aby nie drukować terminu.

Gdy faktura jest opłacona częściowo, pod kwotą brutto pojawiają się wiersze **Zapłacono** i **Do zapłaty**. Kwota zapłacona to suma płatności powiązanych z fakturą w PrestaShop. Opcjonalna pieczątka **Opłacona** drukuje się pod sumami, gdy faktura jest w pełni opłacona.

### Dane bankowe i kod QR SEPA

Wybierz, kiedy drukować blok bankowy: nigdy, tylko gdy pozostaje kwota do zapłaty, lub zawsze. Wpisz odbiorcę (nazwa sklepu, jeśli puste), bank, IBAN, BIC i tytuł przelewu, domyślnie `{invoice_number}`. IBAN jest sprawdzany sumą kontrolną: błędny IBAN jest oznaczany i blokuje zapis.

**Kod QR SEPA** (format EPC069-12) zawiera odbiorcę, IBAN, BIC, kwotę pozostałą do zapłaty i tytuł. Klient skanuje go aplikacją bankową i przelew jest wypełniony. Drukuje się tylko na fakturach w euro i tylko wtedy, gdy pozostaje kwota do zapłaty; faktury w złotych nie otrzymują kodu.

## Pola własne

Dodaj tyle pól, ile potrzeba: numer zamówienia zakupu, NIP lub REGON klienta, warunki płatności, wiadomość klienta. Każde pole ma:

- etykietę i treść w każdym języku, z pogrubieniem, kursywą i podkreśleniem;
- miejsce: pasek podsumowania, pod adresami, pod pozycjami produktów, pod sumami lub w stopce;
- wybór **Drukuj na**: faktury, dowody dostawy lub oba;
- opcję **Ukryj, gdy zmienne są puste**;
- warunki drukowania (zob. niżej).

Panel **Zmienne** wstawia zmienną do ostatnio edytowanego pola. Zmienne obejmują sklep (nazwa, adres, e-mail, telefon, dane), zamówienie i fakturę (numer, daty, termin, kwota do zapłaty, płatność, przewoźnik, numer przesyłki, numer dowodu dostawy, waluta) oraz klienta (imię i nazwisko, firma, e-mail, numer VAT, SIRET, APE, DNI, telefony, wiadomość z zamówienia).

## Adnotacje prawne według kraju

Każda reguła zawiera tekst w każdym języku i warunki. Wszystkie reguły pasujące do faktury drukują się w kolejności listy, w ramce pod sumami lub w stopce.

### Warunki

- **Miejsce przeznaczenia**: wszystkie kraje, kraj sklepu, Unia Europejska, UE bez kraju sklepu, poza UE lub lista krajów. Kliknięcie kraju zaznacza go lub usuwa.
- **Klient**: każdy, z numerem VAT lub bez, firma lub osoba prywatna.
- **Podatek na fakturze**: z podatkiem lub bez.

**Kraj brany pod uwagę** to domyślnie kraj adresu, którego PrestaShop używa do obliczania podatków; możesz wymusić adres rozliczeniowy lub adres dostawy.

### Przykładowe reguły

Trzy reguły są instalowane jako **nieaktywne**: zwolniona dostawa wewnątrzwspólnotowa (art. 138 dyrektywy 2006/112/WE, z numerem VAT klienta), eksport poza UE (art. 146) i francuskie zasady opóźnień B2B (odsetki i ryczałt 40 EUR). Przed włączeniem sprawdź ich treść z księgowym.

## Stopka

Tekst stopki drukuje się na dole każdej strony, domyślnie `{shop_name}, {shop_address_inline}`. Ogranicz go do trzech wierszy: PrestaShop rezerwuje na stopkę mało miejsca, dłuższe teksty umieść w polu własnym pod sumami. Można dodać dowolny tekst prawny i tekst stopki z _Zamówienia > Faktury_.

## Teksty

Sekcja Teksty zawiera każde słowo drukowane na fakturze: tytuł, numer, daty, tytuły adresów, sumy, zestawienie VAT, termin, dane bankowe, teksty dowodów dostawy. Są wstępnie wypełnione po polsku, angielsku, francusku, hiszpańsku, niemiecku, włosku, niderlandzku i portugalsku, i edytowalne w każdym języku.

## Dowody dostawy

Włącz **Używaj tego układu także dla dowodów dostawy** w ustawieniach ogólnych. Dowód dostawy przejmuje logo, kolory, adresy, pasek podsumowania i pozycje produktów, bez cen: drukują się tylko kolumny zdjęcie, indeks, nazwa, EAN-13, indeks dostawcy i ilość. Sumy, dane bankowe, adnotacje prawne i tekst prawny faktury się nie pojawiają. Nagłówek pokazuje numer dowodu dostawy, datę i numer faktury.

## Kopia zapasowa i przeniesienie

**Eksportuj ustawienia** pobiera plik JSON ze wszystkimi ustawieniami sklepu, łącznie z tekstami. Teksty są zapisane według kodu języka, więc plik można zaimportować w innym sklepie lub innej instalacji, nawet gdy identyfikatory języków się różnią. Logo nie jest dołączane. **Importuj** zastępuje po potwierdzeniu wszystkie ustawienia bieżącego sklepu.

**Przywróć ustawienia domyślne** na dolnym pasku przywraca wszystkie ustawienia i teksty, zachowując przesłane logo.

## Rozwiązywanie problemów

### Podgląd informuje, że edytor nie mógł przejąć faktury

Komunikat po tym zdaniu podaje przyczynę, zapisaną też w _Zaawansowane > Logi_. W takim przypadku PrestaShop tworzy oryginalną fakturę: żadna faktura nie jest blokowana.

### Pracownik otrzymuje oryginalną fakturę

PrestaShop nie uruchamia hooków modułu, gdy profil zalogowanego pracownika nie ma uprawnienia **Widok** dla tego modułu. Nadaj je w _Zaawansowane > Zespół > Uprawnienia > Moduły_. Nie dotyczy to faktur wysyłanych klientom ani pobieranych z ich konta.

### Stopka nachodzi na treść

Skróć tekst stopki, przenieś długie adnotacje do pola własnego pod sumami lub wybierz dla adnotacji prawnych miejsce „W ramce pod sumami”.

### Kod QR się nie wyświetla

Sprawdź, czy blok bankowy jest włączony, IBAN zapisany, faktura wystawiona w euro i czy pozostaje kwota do zapłaty. W trybie „Zawsze” opłacona faktura pokazuje dane bankowe bez kodu QR.

### Adres dostawy jest widoczny, choć wygląda tak samo

Oba adresy różnią się co najmniej jednym drukowanym elementem: firmą, drugą linią adresu, kodem pocztowym, województwem lub pisownią ulicy. Wielkość liter, spacje i interpunkcja są pomijane. Otwórz zamówienie w panelu, aby porównać oba adresy.

### Ustawienie nie zmienia niczego w podglądzie

Niektóre elementy drukują się tylko wtedy, gdy faktura zawiera daną informację: numer VAT klienta, numer przesyłki, kwotę do zapłaty na fakturze opłaconej częściowo, pieczątkę Opłacona na fakturze w pełni opłaconej, termin płatności przy okresie płatności powyżej 0 dni, wiersze rabatu i opakowania równe zero. Wybierz u góry edytora fakturę z tą informacją, aby sprawdzić ustawienie.

### Korekty zachowują stary układ

Moduł obejmuje faktury i dowody dostawy. Korekty zachowują układ PrestaShop.