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 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ć.

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. Numer VAT, telefon i e-mail klienta są opcjonalne.

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.

Korekty zachowują stary układ

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