Szablony paragonów
Szablony paragonów określają wygląd wydruków niefiskalnych i raportów na drukarkach termicznych: paragon z kasy, wydruk zamówienia, dzienne podsumowanie sprzedaży. Układasz je z klocków w edytorze z podglądem na żywo.
Szablon to układ wydruku: nagłówek firmy, lista pozycji, podsumowanie, stopka, kod QR. Dane (numer zamówienia, pozycje, kwoty) wstawiają się automatycznie w trakcie druku. Wydruk trafia do kolejki i na drukarkę połączoną przez Print Hub.
Lista szablonów#
Przyciski w nagłówku: Nowy szablon (paragon POS) i Nowy szablon raportu. Kolumny:
| Kolumna | Znaczenie |
|---|---|
| Nazwa | Etykieta oraz data utworzenia |
| Kategoria | POS (paragon, zamówienie) albo REPORT (raport na papierze) |
| Szerokość | 58 mm lub 80 mm |
| Wersja | Numer wersji i znacznik szkicu |
| Status | Domyślny, Aktywny, Nieaktywny |
| Akcje | Menu wiersza (edycja, duplikowanie, ustawienie jako domyślny) |
Status Domyślny oznacza szablon preferowany przy automatycznym wydruku z POS, o ile obieg lub Print Hub go nie zastąpi własnym wyborem.
Szablony raportów#
Nowy szablon raportu pozwala zacząć od gotowego wzoru: Dzień, zamówienia i metody płatności (SQL), Ecommerce, podsumowanie dnia, Gastronomia, podsumowanie dnia, Lista zamówień albo Top produkty. Szablon raportu można powiązać z konkretnym raportem, a podgląd w edytorze renderuje prawdziwe dane z wybranego okresu. Szeroką tabelę raportu rozbijasz na wiersze „etykieta : wartość”, bo 58 mm to tylko około 32 znaki.
Edytor szablonu#
Kliknij nazwę szablonu (/settings/receipt-templates/[id]).
Edytor ma cztery obszary:
- Elementy (lewa kolumna): Tekst, Separator, Odstęp, Wiersz, Tabela, Kod QR, Kod kreskowy, Obrazek, Podsumowanie.
- Sekcje: Nagłówek, Informacje o paragonie, Pozycje, Podsumowanie, Stopka oraz Cały paragon. Przycisk Zarządzaj sekcjami pozwala je ułożyć.
- Podgląd (środek): wygląd w skali papieru. Możesz wybrać zamówienie testowe, żeby zobaczyć prawdziwe dane.
- Właściwości (prawa kolumna): ustawienia klikniętego bloku.
Dane i wyrażenia#
Teksty używają pól w nawiasach klamrowych, np. {{seller.name}}, {{seller.taxId}}, {{meta.number}} i {{meta.numberShort}} (ostatni człon numeru). Pole zaczynające się od SELECT jest liczone jako wyrażenie, np. SELECT SUBSTRING_INDEX('{{meta.number}}', '-', -1). Wyrażenia działają wewnątrz edytora, bez dostępu do bazy danych, i obsługują listę bezpiecznych funkcji (CONCAT, LPAD, IF, ROUND, DATE_FORMAT i inne). Błędne wyrażenie zostawia pole bez zmian.
Szczegóły pozycji (kategoria, wariant, SKU, modyfikacje, notatki) włączasz osobnymi opcjami, a każdy komponent pozycji ma własny prefiks, poziom wcięcia i styl. Polskie znaki drukują się poprawnie na każdej drukarce, bo Print Hub wysyła paragon jako bitmapę.
Zapisz szablon tworzy nową wersję i, jeśli ją opublikujesz, zaczyna ona obowiązywać w następnych wydrukach.
Szablon to układ z klocków i pól danych. Utwórz osobne szablony dla paragonów (POS) i raportów, sprawdź je w podglądzie na zamówieniu testowym i ustaw jeden jako domyślny.