Przejdź do treści

Personalizacja szablonu faktury - edytor HTML i CSS na bazie szablonu DEFAULT i BLUE

Wyświetleń: 16103 3 min czytania

Własny szablon wydruku faktury pozwala zmienić układ i wygląd dokumentów generowanych przez system. Opcja przydaje się każdemu, kto chce dostosować fakturę do identyfikacji wizualnej firmy. Po wklejeniu kodu HTML i CSS szablon jest gotowy do użycia na nowych i istniejących dokumentach.

UWAGA! Zarządzanie szablonami jest dostępne wyłącznie dla użytkowników z uprawnieniami administracyjnymi. Szablony mogą tworzyć i edytować osoby z systemową rolą właściciela konta lub administratora, ponieważ wymaga to dostępu do ustawień konta.

Jak otworzyć edytor szablonu faktury?

Aby stworzyć własny szablon faktury bazując na szablonach systemowych:

  1. przejdź do zakładki Ustawienia > Ustawienia konta > SzablonyUstawienia konta – zakładka Szablony w menu nawigacyjnym
  2. zjedź na dół strony do sekcji Własny szablon wydruku faktury i kliknij przycisk Dodaj nowy szablonSekcja Własny szablon wydruku faktury z przyciskiem Dodaj nowy szablon
WSKAZÓWKA! Możliwość tworzenia własnych szablonów dostępna jest w planach Standard, Pro Pro Plus.

Skąd pobrać pliki szablonu z GitHub?

System korzysta z szablonów w formacie Handlebars (HBS). Do wyboru jest kilka szablonów systemowych w tym: DEFAULT (układ podstawowy) i BLUE (wariant z niebieskim akcentem kolorystycznym). Pobierz odpowiednie pliki i skopiuj ich zawartość:

  1. pobierz plik HTML szablonu DEFAULT: default.hbs.html - skopiuj całą jego zawartość,
  2. pobierz plik CSS szablonu DEFAULT: default.css - skopiuj całą jego zawartość,
  3. jeśli chcesz użyć wariantu BLUE zamiast DEFAULT, pobierz plik CSS: blue.css - użyj go zamiast pliku Default CSS w kroku 2,

Wszystkie przykładowe szablony znajdziesz też w repozytorium na GitHub.

Jak wkleić kod HTML i CSS szablonu?

  1. W edytorze szablonu wklej skopiowany kod HTML do górnego pola (pole HTML) - możesz również skorzystać z opcji Załaduj przykładowy szablonEdytor szablonu faktury z wypełnionym polem HTML i opcją Załaduj przykładowy szablon
  2. Wklej skopiowany kod CSS do dolnego pola (pole CSS). Edytor szablonu faktury z wypełnionym polem CSS
  3. Wprowadź swoje modyfikacje w kodzie.
  4. Kliknij Zapisz, aby zatwierdzić zmiany .
WSKAZÓWKA! Podgląd szablonu jest dostępny dopiero po zapisaniu zmian - system wyrenderuje przykładowy dokument, który możesz sprawdzić przed użyciem szablonu na właściwych fakturach.
Podgląd wygenerowanego szablonu faktury po zapisaniu zmian
WAŻNE! Nie zamieniaj pól miejscami - nie wklejaj CSS do górnego pola ani HTML do dolnego. System nie zgłosi błędu, ale faktura będzie wyglądać niepoprawnie. Błąd będzie czysto wizualny i trudny do wykrycia.

Poniżej widok edytora z zaznaczonymi polami HTML (górne) i CSS (dolne):

Jak zmienić szablon DEFAULT na wygląd szablonu BLUE?

Szablon BLUE różni się od DEFAULT kolorystyką i wymaga jednej dodatkowej zmiany w kodzie HTML - przeniesienia konkretnego elementu w inne miejsce. Poniżej zaznaczono element, który należy przenieść.

HTML odpowiedzialny za wyświetlanie nazwy i numeru dokumentu przed zmianą.
Kod HTML szablonu faktury z zaznaczonym elementem nazwy i numeru dokumentu przed zmianą

HTML po zmianie.
Kod HTML szablonu faktury z przeniesionym elementem nazwy i numeru dokumentu po zmianie

  1. Pobierz plik blue.css i skopiuj jego zawartość.
  2. W edytorze szablonu wklej kod blue.css do dolnego pola (pole CSS) - zastąpi on domyślny CSS.
  3. W górnym polu (pole HTML) przenieś zaznaczony element w miejsce wskazane na obrazku powyżej.
  4. Kliknij Zapisz.

Co warto wiedzieć o działaniu szablonów?

Szablon utworzony w ten sposób jest nowym, niezależnym szablonem, nawet jeśli bazuje na jednym z szablonów systemowych.

Dokumenty wystawione wcześniej zachowują szablon, z którym zostały utworzone. Zmiana domyślnego szablonu w ustawieniach konta lub działu wpływa wyłącznie na nowe dokumenty. Szablon archiwalnego dokumentu zmieni się tylko wtedy, gdy zostanie wybrany ręcznie podczas edycji tego dokumentu.

UWAGA! Szablon można przypisać w ustawieniach ogólnych konta oraz do dedykowanego działu. Nie można natomiast przypisać szablonu do konkretnego kontrahenta lub typu dokumentu. Przy generowaniu dokumentu system sprawdza najpierw szablon przypisany do działu, a jeśli go nie ma - szablon domyślny konta.

UWAGA! Jeśli w szablonie używasz zewnętrznych czcionek (np. Google Fonts) lub obrazów hostowanych poza systemem, mogą one wydłużyć czas generowania PDF. Limit czasu na wygenerowanie dokumentu wynosi 30 sekund-— jeśli zewnętrzny zasób będzie niedostępny lub wolny, generowanie PDF może się nie powieść.

Czy ten wpis był pomocny?

Udostępnij

Główna odpowiedź Piotr 2022-02-09 15:11

Dzień dobry, dziękuję za zwrócenie uwagi. Oczywiście zgadza się edytowanie szablonów powinno być mniej skomplikowane w działaniu.
Skieruje zapytanie do programistów w sprawie aktualizacji tych aspektów w systemie.
Pozdrawiam,
Piotr

Komentarze (6)

Anonymous 2022-02-06 08:56

Edytowanie szablonów jest bardzo niewygodne. Dwa ograniczone wysokościowo okienka i do tego każdą zmianę trzeba zapisać i obejrzeć fakturę, następnie cofnąć się i scrollować do miejsca gdzie tworzyliśmy zmiany.

Piotr Wajszczuk
Piotr 2022-02-09 15:11 Główna odpowiedź

Dzień dobry, dziękuję za zwrócenie uwagi. Oczywiście zgadza się edytowanie szablonów powinno być mniej skomplikowane w działaniu.
Skieruje zapytanie do programistów w sprawie aktualizacji tych aspektów w systemie.
Pozdrawiam,
Piotr

Anonymous 2022-04-04 17:37

Ciężko jest pracować bez zmiennych nad wyglądem. Skąd mogę pobrać przykładowy plik ze zmiennymi? Mogą to być randomowe dane.

Kacper Seta
Kacper 2022-04-05 09:15 Odpowiedź

Dzień dobry,
dokumentację dotyczącą szablonów można znaleźć na GitHub:
https://github.com/fakturownia/szablony/

Pozdrawiam
Kacper

Anonymous 2025-06-05 13:07

Dzień Dobry
Jak zmienić w “sprzedawcy” ,żeby po nazwie firmy był adres firmy ,potem NIP i na końcu numer konta firmy .Bo aktualnie zmieniałam adres siedziby firmy i mi pokazuje na fakturze w nastepujący sposób :nazwa firmy ,NIP, Konto bankowe a na końcu dopiero adres firmy ,przyznam ,że razi mnie to w oczy i chiałabym wrócic do tej pierwszej wersji ale nie wiem jak.

Sandra Glajzner
Sandra 2025-06-05 16:33 Odpowiedź

Dzień dobry,

ze względu na fakt, że zgłoszenie wymaga przeprowadzenia analizy i udzielenia dodatkowych informacji, wiadomość została przesłana w korespondencji prywatnej.

Pozdrawiam
Sandra