↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz
    2. Jak działa lista dokumentów: miejsca pracy, rodzaje, statusy

    Jak skonfigurować słowniki dokumentów: typy, numerację, statusy i szablony wydruku

    6 min czytaniaZaktualizowano

    Typ, numer, status, sposób dostawy i płatności oraz wydruk dokumentu Elbuz bierze ze słowników, które dopasowujesz do siebie: własne statusy z kolorem, numeracja z rokiem, szablon faktury w kilku językach.

    Kiedy to się przyda:

    • Potrzebujesz roku w numerze faktury — licznik sam zeruje się z nowym rokiem.
    • Zamówienia utykają w statusie — norma w godzinach włącza ostrzeżenie na liście dokumentów.
    • Klient potrzebuje linku do śledzenia przesyłki — program dopisze numer listu przewozowego do adresu przewoźnika.
    • Klient z zagranicy potrzebuje faktury po angielsku — ten sam szablon przechowuje tekst dla każdego języka.

    Od czego zacząć: menu okna dokumentów → „Słowniki” → wybrany słownik.

    Co oferują słowniki dokumentów

    • Typy dokumentów — własny typ z własną nazwą i zachowaniem w ewidencji, w tym rolą w rozliczeniach.
    • Numeracja — prefiks, rok, miesiąc i licznik o wybranej szerokości, osobno dla każdej Twojej firmy.
    • Statusy dokumentów — własny status i kolor, etapy procesu dla przycisku „Następny etap”, norma czasu.
    • Statusy dostawy i płatności — kolor na liście i dopasowanie do statusów strony.
    • Sposoby dostawy i płatności — nowe opcje dla karty zamówienia i link do śledzenia.
    • Szablony wydruku — pola dokumentu w tekście, osobna wersja dla każdego języka, wydruk do PDF.

    Jak utworzyć własny typ dokumentu

    Wiersz okna „Typy dokumentów” to jeden typ: „Aktywność”, „Nazwa”, „Prefiks numeru”, „Nr dokumentu” (bieżąca wartość licznika), „Format numeru”, „Kolor”, „Uwagi”, „Kolejność”, „Kod” oraz kolumny zachowania: „Ruch magazynowy”, „Rola w rozliczeniach”, „Rezerwuje”, „Realizuje zamówienie”, „Dostawa”, „Płatność”.

    Nazwy typów systemowych nie da się zmienić. Typy dostarczane z programem — „Dokument WZ”, „Zamówienie klienta”, „Faktura” i inne — są systemowe; wyjątkiem jest „Transakcja”. Dwuklik na ich nazwie nie otwiera edycji, tylko pokazuje komunikat: „To typ systemowy. Nie można zmienić jego nazwy — na jego kodzie opierają się wydruki, integracje i logika karty. Utwórz własny typ i skonfiguruj go.”

    Zachowanie typu systemowego też jest stałe: „dokument WZ musi zdejmować ze stanu, PZ — przyjmować na stan”. Jeśli potrzebujesz innej nazwy lub własnego schematu ewidencji, dodaj własny typ przyciskiem „Dodaj”: w nim nazwę i zachowanie można edytować. Jeśli własny typ ma już dokumenty, zmiana zachowania działa tylko na przyszłe zatwierdzenia — wcześniejsze nie są przeliczane.

    Okno „Typy dokumentów” z podpowiedzią formatu numeru i tabelą typów
    1Przykłady formatu numeru
    2Kolumna formatu numeru
    3Nazwa typu dokumentu WZ
    1. Przykłady — kliknięcie kopiuje szablon numeru, np. prefiks, rok i licznik.
    2. Kolumna „Format numeru” — szablon, z którego powstaje numer dokumentu danego typu.
    3. Kolumna „Nazwa” — wiersz typu dokumentu WZ.

    Jak ustawić numerację: prefiks, rok, licznik

    Numer nowego dokumentu tworzy kolumna „Format numeru” jego typu. Nad tabelą są przykłady — kliknięcie kopiuje przykład: {PREFIX}, {YYYY}, {MM}, {NNNNN}, {PREFIX}{YYYY}-{NNNNN}. Co oznaczają znaczniki:

    • {NNNNN} — licznik; liczba liter N określa szerokość z zerami na początku: {NNNNN} daje 00001;
    • {PREFIX} — wartość kolumny „Prefiks numeru”;
    • {YYYY} lub {YY} — rok, {MM} — miesiąc, {DD} — dzień; brane z daty nadania numeru;
    • każdy inny tekst trafia do numeru bez zmian.

    Aby faktury miały numery w rodzaju FV/2026/00001, w wierszu „Faktura” wpisz w „Format numeru” FV/{YYYY}/{NNNNN}. Jeśli szablon zawiera {YYYY} lub {YY}, licznik sam zeruje się z nowym rokiem — pierwsza faktura w styczniu dostanie 00001.

    Licznik zapamiętuje rok od pierwszego numeru według nowego szablonu, więc zaraz po tym, jak pierwszy raz wpiszesz rok do formatu, numeracja tego typu zacznie się od 1. Puste „Format numeru” oznacza dotychczasowe działanie: prefiks plus numer. Jeśli w dokumencie wybrana jest Twoja firma, licznik jest prowadzony osobno dla każdej firmy.

    Jak dodać własny status dokumentu i nadać mu kolor

    Okno „Statusy dokumentów” to wspólna lista statusów dla wszystkich typów. Kolumny: „Aktywność”, „Nazwa”, „Kolor”, „Uwagi”, „Kolejność”, „Etap procesu”, „SLA, godz.”, „Kod”. Aby dodać status w rodzaju „Czeka na telefon” i oznaczyć go na żółto:

    1. Otwórz „Statusy dokumentów” z menu okna dokumentów.
    2. Kliknij „+” na pasku narzędzi (podpowiedź „Dodaj”) i wpisz nazwę w nowym wierszu.
    3. W kolumnie „Kolor” wybierz żółty z palety — w tym kolorze status jest rysowany jako plakietka na liście dokumentów.
    4. Jeśli status jest krokiem łańcucha pracy, zaznacz „Etap procesu” i ustaw „Kolejność” między sąsiednimi etapami: przycisk „Następny etap” w dokumencie idzie według tej kolejności.
    5. W razie potrzeby wpisz „SLA, godz.” — normę czasu w statusie. Gdy dokument wisi dłużej, na liście zapala się żółta kropka „W bieżącym statusie dłużej niż norma”. 0 — bez kontroli czasu.

    Dla pojedynczego typu dokumentu możesz ustawić własny łańcuch etapów: w oknie „Typy dokumentów” ikona w wierszu typu otwiera „Ścieżka statusów” — tam zaznaczasz etapy i przeciągasz je w odpowiedniej kolejności. Typ bez zaznaczonych etapów korzysta ze wspólnej ścieżki.

    W „Ścieżka statusów” typu zaznaczono etap „Sprawdzono” i przeciągnięto go za uchwyt nad „Zrealizowano” — łańcuch wygląda teraz tak: Nowy → Uzgodnienie → Potwierdzenie → Sprawdzono → Zrealizowano; przycisk „Zapisz” zapisuje kolejność
    Okno „Statusy dokumentów” z podpowiedzią o ścieżce statusów i tabelą statusów
    1Kolor
    2Etap procesu
    3SLA, godz.
    1. Kolumna „Kolor” — kolor statusu na liście dokumentów.
    2. Kolumna „Etap procesu” — zaznacz ją przy statusach tworzących łańcuch pracy dla przycisku „Następny etap”.
    3. Kolumna „SLA, godz.” — norma czasu w statusie; 0 oznacza brak limitu.

    Statusy dostawy i płatności: kolor i pole „Kod”

    To dwa osobne słowniki: „Statusy dostawy” i „Statusy płatności”. Menu po lewej: „Słowniki” → „Dokumenty” → „Statusy dostawy” lub „Statusy płatności”; z menu okna dokumentów, sekcja „Słowniki” — „Statusy dostawy” i „Statusy płatności”. Kolumny w obu są takie same: „Nazwa”, „Kolor”, „Uwagi”, „Kolejność”, „Aktywność”, „Kod”. Kolor wybrany z palety w komórce „Kolor” to kolor, w jakim status jest pokazywany w kolumnach „Status płatności” i „Status dostawy” listy dokumentów oraz w karcie zamówienia.

    Okno „Statusy płatności” z przyciskiem „Dodaj” i tabelą statusów
    1Przycisk „Dodaj”
    2Kolor
    3Kod
    1. Przycisk „Dodaj” — tworzy nowy wiersz statusu płatności.
    2. Kolumna „Kolor” — kolor plakietki statusu płatności.
    3. Kolumna „Kod” — kod systemowy statusu (wait, paid, prepayment i inne).

    Pole „Kod” to maszynowy klucz statusu i zwykle nie zmienia się go ręcznie. Program wypełnia je sam przy tworzeniu wiersza (w postaci delivery_status_code_17 lub payment_status_code_14) i zapisuje w dokumencie właśnie kod, a nie nazwę: na nim działają filtry listy (szablon filtra „Wymagają uwagi” to status dokumentu „Nowy” albo status płatności z kodem wait), API i reguły.

    Wbudowane statusy mają czytelne kody: płatności — wait („Oczekiwanie”), paid („Opłacono”), prepayment („Przedpłata”), not_paid („Nieopłacone”), return („Zwrócono”); dostawy — wait_sender („Oczekiwanie od nadawcy”), in_road („W drodze”), delivered („Dostarczono”). Nazwę statusu możesz swobodnie zmienić — kod się nie zmienia, więc nic się nie psuje.

    Dopasowanie do statusów strony lub przewoźnika ustawia się nie w tym słowniku, tylko w ustawieniach połączenia, z którego przychodzą zamówienia: w formularzu szablonu importu zamówień, sekcja „Powiązane ustawienia”, i w karcie połączenia API, blok „Ustawienia powiadomień”, są przyciski „Statusy dostawy” i „Statusy płatności”. Otwierają ten sam słownik, ale zamiast kolumny „Kolor” jest w nim kolumna „Kod (nazwa) na stronie (API)”: wpisuje się do niej kod lub nazwę statusu systemu zewnętrznego, kilka wartości — po przecinku.

    Jeśli słownik otwarto z połączenia Nova Poshta, pod tabelą widać listę „Statusy serwisu dostawy” z kodami jej statusów. Bez tego dopasowania import zamówień nie podstawi Twojego statusu — jak wyszukiwana jest zgodność, opisuje artykuł o imporcie zamówień.

    Jak dodać sposób dostawy lub płatności i link do śledzenia

    „Sposoby dostawy” („Rodzaje dostawy” w menu po lewej) i „Sposoby płatności” („Rodzaje płatności”) to listy, z których w karcie zamówienia wybiera się „Sposób dostawy” i „Forma płatności”. Kolumny w obu są takie same: „Aktywność”, „Nazwa”, „Kolor”, „Uwagi”, „Kolejność”. Nowy sposób, np. „BLIK na telefon”, dodajesz przyciskiem „Dodaj” w oknie „Sposoby płatności” — od razu pojawia się na liście wyboru w karcie.

    Sposób dostawy ma jeszcze kolumnę „Link do śledzenia przesyłki”. Wpisuje się tam adres strony śledzenia przewoźnika, na którego końcu trzeba podstawić numer przesyłki (numer , numer deklaracji).

    Gdy zamówienie z takim sposobem dostawy zostaje zapisane z numerem przesyłki, program dopisuje numer na końcu adresu i wstawia gotowy link do pola „Link do śledzenia” w karcie zamówienia (sekcja „Dostawa” → „Więcej pól”). Osobnej zmiennej na numer nie ma: numer zawsze trafia na sam koniec adresu. To pole możesz wstawić do szablonu wiadomości dla klienta, tak jak inne pola dokumentu — wtedy numer przesyłki dociera do kupującego jako link do śledzenia paczki.

    Jak skonfigurować szablon wydruku: pola, języki, format

    Okno „Szablony wydruku” z menu pokazuje szablony wszystkich typów (kolumna „Typ”), a ikona drukarki w wierszu okna „Typy dokumentów” — szablony jednego typu. „Dodaj” w oknie ogólnym rozwija listę typów dokumentów, ołówek w wierszu otwiera edytor szablonu.

    Edytor składa się z kart języków (flagi) i bloku „Lista pól”. Na każdej karcie są „Nazwa”, „Opis” i „Szablon” — tekst wydruku w edytorze wizualnym.

    Blok „Lista pól” wymienia makra, które można wstawić do tekstu, w czterech kolumnach: pola kontrahenta ({Kontrahent: …}), pola dokumentu ({Dokument: …}), pola Twojej firmy ({Firma: …}) i organizacji kontrahenta ({Organizacja kontrahenta: …}) — faktura jest wystawiana na firmę, a kontrahent w dokumencie bywa jej pracownikiem. Przy wydruku każde makro jest zastępowane wartością z danego dokumentu.

    Wiersze produktów szablon wypisuje w pętli — przykład jest w szablonie standardowym: {% for product in p %} … {{ product.name }}, {{ product.quantity }}, {{ product.unit_name }}, {{ product.price }}, {{ product.price_sum }} … {% endfor %}.

    Edytor szablonu wydruku z rozwiniętą listą pól
    1Makra kontrahenta
    2Makra dokumentu
    1. Kolumna kontrahenta — makra wstawiające do szablonu dane kontrahenta.
    2. Kolumna dokumentu — makra wstawiające do szablonu dane dokumentu.

    Kwota słownie. Nie ma jej w „Lista pól” — wstaw ją do szablonu ręcznie: {{ d.document_sum_to_word }} — kwota dokumentu słownie, {{ d.document_sum_tax_word }} — VAT słownie (20% kwoty dokumentu).

    Słowa i nazwa waluty w kwocie słownie są w języku dokumentu (sekcja „Dodatkowo” → „Język”), a jeśli język nie jest wybrany — w języku kraju Twojej firmy; waluta — dokumentu lub Twojej firmy. Dla języka lub waluty, których nie ma w słowniku, kwota słownie drukuje się pusta.

    Wersje językowe. Jeden szablon przechowuje tekst dla każdego języka programu — osobna karta na język. Faktura po angielsku dla klienta z zagranicy nie wymaga osobnego szablonu: wypełnij kartę angielską tego samego szablonu, a w dokumencie w sekcji „Dodatkowo” wybierz w polu „Język” angielski. Wydruk weźmie wersję językową zgodną z językiem dokumentu. Na kartach innych niż język główny obok szablonu jest ikona tłumaczenia „Przetłumacz na podstawie wartości w języku głównym” — tłumaczy tekst szablonu z języka głównego na język karty; makra po tłumaczeniu warto sprawdzić wzrokiem.

    Format. Wydruk dokumentu powstaje tylko w PDF — zarówno dla jednego dokumentu, jak i dla paczki („1 PDF” lub „ZIP” z plikami PDF). Eksportu do DOCX ani dla dokumentów nie ma; aby edytować fakturę w Wordzie, trzeba skopiować tekst z PDF.

    Jednorazową fakturę lub dokument WZ bez konfigurowania szablonu możesz wypełnić online i zapisać do PDF w bezpłatnym formularzu dokumentu WZ i faktury; szablon Elbuz jest potrzebny, gdy dokumenty z zamówień drukujesz codziennie.

    Najczęstsze pytania

    Dlaczego nie mogę zmienić nazwy „Dokument WZ”?

    To typ systemowy: na jego kodzie opierają się wydruki, integracje i logika karty, dlatego nazwy i zachowania nie można w nim edytować. Utwórz własny typ przyciskiem „Dodaj” — zob. typy dokumentów.

    Zmieniono zachowanie własnego typu — dlaczego wcześniejsze dokumenty się nie przeliczyły?

    Zmiana zachowania działa tylko na przyszłe zatwierdzenia. Już zatwierdzonych dokumentów program nie przelicza.

    Dlaczego po zmianie formatu numer zaczął się od 00001?

    Licznik zapamiętuje rok od pierwszego numeru według nowego szablonu. Dlatego gdy tylko po raz pierwszy wpiszesz rok do „Format numeru”, numeracja tego typu zaczyna się od 1 — a potem zeruje się z każdym nowym rokiem.

    Przycisk „Następny etap” pomija mój status. Dlaczego?

    Status trafia do łańcucha tylko wtedy, gdy ma zaznaczone „Etap procesu”, a miejsce w łańcuchu wyznacza „Kolejność”. Jeśli typ dokumentu ma własną „Ścieżka statusów”, obowiązuje ona, a nie wspólna.

    Czy mogę wyeksportować fakturę do Worda?

    Nie. Wydruk dokumentu powstaje tylko w PDF; DOCX ani HTML dla dokumentów nie ma. Aby edytować fakturę w Wordzie, trzeba skopiować tekst z PDF.

    Czym „Kod” różni się od „Kod (nazwa) na stronie (API)”?

    „Kod” to maszynowy klucz statusu, program wypełnia go sam. „Kod (nazwa) na stronie (API)” pojawia się, gdy słownik otwarto z połączenia — wpisuje się tam status systemu zewnętrznego, który ma stawać się Twoim statusem.

    Gdzie to jest i kto ma dostęp

    Menu
    Słowniki → Dokumenty → „Typy dokumentów”, „Statusy dokumentów”, „Statusy płatności” i inne
    Inne wejścia
    menu okna dokumentów → „Słowniki”; „Szablony wydruku” — tylko stąd

    Listy, z których karta dokumentu bierze typ, status, sposób dostawy i formę płatności, edytuje się w osobnych oknach-słownikach. Otworzysz je na dwa sposoby: z menu okna dokumentów („Operacje dodatkowe” na pasku narzędzi), sekcja „Słowniki”, albo z menu po lewej „Słowniki” → „Dokumenty”. Nazwy pozycji w obu menu częściowo się różnią — to te same okna:

    Gdzie otworzyć każdy słownik
    Menu okna → „Słowniki”Menu po lewej „Słowniki” → „Dokumenty”Co zawiera
    „Typy dokumentów”„Typy dokumentów”nazwa typu, prefiks i format numeru, kolor, zachowanie w ewidencji
    „Statusy dokumentów”„Statusy dokumentów”statusy, ich kolor, etapy procesu i norma czasu
    „Statusy dostawy”„Statusy dostawy”statusy dostawy zamówienia, ich kolor i kod
    „Statusy płatności”„Statusy płatności”statusy płatności zamówienia, ich kolor i kod
    „Sposoby dostawy”„Rodzaje dostawy”sposoby dostawy i link do śledzenia
    „Sposoby płatności”„Rodzaje płatności”sposoby płatności
    „Klasy podatkowe”„Klasy podatkowe”stawki VAT i klasa domyślna (klasy podatkowe)
    „Szablony wydruku”—wydruki dokumentów; otwierają się też ikoną drukarki w wierszu okna „Typy dokumentów”

    We wszystkich słownikach nowy wiersz dodaje przycisk „Dodaj” na pasku narzędzi, wartości edytuje się bezpośrednio w tabeli — kliknięciem lub dwuklikiem w komórkę, a kolor wybiera się z palety kolumny „Kolor”.

    Jeśli słownik statusów lub sposobów otwarto nie z menu, tylko z szablonu importu zamówień lub z karty połączenia , w tabeli jest jeszcze kolumna „Kod (nazwa) na stronie (API)” — wartość, pod jaką ten wiersz jest zapisany na platformie (więcej — statusy dostawy i płatności).

    Powiązane tematy

    Czy ten artykuł był pomocny?

    Brakuje funkcji? Napisz do nas.

    Dodamy ją za darmo, jeśli przyda się też innym.

    Jeśli potrzebujesz jej tylko ty — umówimy się osobno.

    Spis treści

    Zaproponuj usprawnienie

    Wypróbuj Elbuz za darmo