Symbole zastępcze: jakie są i gdzie obowiązują
Po przeczytaniu tego artykułu będziesz wiedzieć, w jakich trzech miejscach Univents używa symboli zastępczych, jak się je zapisuje, gdzie znajdziesz pełną listę i dlaczego nie możesz tworzyć własnych.
Symbol zastępczy to zastępnik w tekście: wpisujesz go raz w szablonie, a Univents podmienia go w każdym dokumencie i każdym e-mailu na właściwą, rzeczywistą wartość. Zamiast wpisywać nazwę klienta w każdej ofercie, w szablonie stoi {Customer_Name} — w gotowym PDF w tym miejscu pojawia się nazwa klienta.
Symboli zastępczych używasz w trzech miejscach. Wyglądają podobnie, ale to osobne listy: symbol z jednego miejsca nie działa w innym.
Trzy miejsca w skrócie
| Gdzie | Zapis | Przykład | Pełna lista |
|---|---|---|---|
| Szablony ofert, faktur, dowodów dostawy (WZ), not kredytowych (plik Word, zamieniany na PDF) | Jeden nawias klamrowy | {Customer_Name} | Jak tworzyć układy dokumentów finansowych? |
| Szablony e-maili w Ustawienia → Szablony e-maili | Dwa nawiasy klamrowe | {{customer_name}} | Przycisk symboli zastępczych w edytorze danego szablonu |
| Automatyzacje (temat, zmienne szablonu, teksty powiadomień) | Dwa nawiasy klamrowe | {{gross_total}} | Przycisk symboli zastępczych obok danego pola |
Listy są celowo rozdzielone, bo stoją za nimi różne dane: dokument zna pozycje, sumy i stawki podatku, e-mail zna odbiorcę i okazję, a automatyzacja zna tylko to, co przynosi jej wyzwalacz.
Szablony dokumentów: jeden nawias, stałe nazwy
W szablonie Word Twojego układu symbole zastępcze stoją w pojedynczych nawiasach klamrowych. Pełną tabelę ze wszystkimi nazwami i ich znaczeniem — dokument, klient, wydarzenie, Twoja firma, sumy, tabele pozycji, teksty dowolne — znajdziesz w artykule Jak tworzyć układy dokumentów finansowych?.
Trzy rzeczy, które łatwo tam przeoczyć:
- Zapis musi się zgadzać dokładnie — wielkość liter również.
{Customer_Name}zwraca nazwę klienta,{customer_name}nie. Przepisuj każdą nazwę dokładnie tak, jak stoi na liście. - Literówka w symbolu nie zawsze rzuca się w oczy. Jeśli pracujesz z szablonem Word, symbol pozostaje widoczny w PDF — czytasz tam
{Custmer_Name}i od razu widzisz błąd. W nowszych układach bez szablonu Word to miejsce zostaje natomiast puste. Nie zakładaj więc, że literówka sama się ujawni. - Puste pole oznacza pusty tekst. Jeśli klient nie ma podanego numeru VAT UE,
{Customer_Tax_ID}znika z PDF bez śladu. Puste miejsce nie musi więc oznaczać braku danych — bez szablonu Word równie dobrze może za nim stać literówka.
Szablony e-maili: dwa nawiasy, inne dla każdego szablonu
W Ustawienia → Szablony e-maili otwierasz szablon i obok tematu oraz treści widzisz przycisk z nawiasami klamrowymi. Wyświetla on dokładnie te zmienne, które zna ten szablon — przypomnienie o fakturze zna {{days_overdue}}, potwierdzenie zmiany nie.
Jeśli wpiszesz zmienną, której ten szablon nie zna, nie da się go zapisać: Univents zgłasza „Nieznane symbole zastępcze” i podaje nazwy, których dotyczy problem. To zabezpieczenie przed tym, żeby do klienta nie dotarł e-mail z surowym {{foo}}.
Kilka zmiennych znają natomiast wszystkie szablony, w których działa też {{sender_name}}: {{company_name}}, {{account_name}}, {{sender_name}} oraz — od 12.10.2026 — {{sender_email}} i {{sender_phone}}. Te dwie nowe oznaczają adres e-mail i numer telefonu osoby, która uruchamia wysyłkę — w e-mailach z dokumentami wysyłanych ze skrzynki osoby prowadzącej są to jej dane, w pozostałych przypadkach dane Twojego workspace.
Kilka symboli zastępczych istnieje tylko przy wysyłce dokumentu, nie w automatyzacjach: {{portal_url}} (link do portalu klienta), {{view_url}} (dokumenty w portalu), {{event_url}} i {{messages_url}} (tylko gdy dokument należy do wydarzenia) oraz {{quote_link}} (tylko oferty) i {{invoice_link}} (tylko faktury). W wiadomości z automatyzacji pozostałyby niezastąpione. Więcej w artykule Szablony e-mail i symbole zastępcze.
Automatyzacje: dwa nawiasy, zależnie od wyzwalacza
W automatyzacji symbole zastępcze mogą zawierać pola Temat, Zmienne szablonu (akcja „Wyślij e-mail”) oraz Tytuł i Wiadomość (akcja „Powiadom użytkownika”). To, które są dostępne, zależy od wyzwalacza reguły — reguła dla dokumentu finansowego zna {{document_number}}, reguła dla zapytania nie.
Dwa wyjątki:
- Pole Do (e-mail) nie przyjmuje symboli zastępczych, musi to być stały adres.
- Przy wyzwalaczu E-mail odebrany nie ma w ogóle symboli zastępczych — treści e-maili nie są dostępne ze względów ochrony danych.
Więcej w artykule Automatyzacje: akcje.
Własne symbole zastępcze — nie da się, a oto obejście
Nie możesz wymyślić własnego symbolu zastępczego: ani nowej nazwy dla dokumentów, ani nowej zmiennej dla szablonu e-maila. Obie listy są stałe.
Dla dokumentów służą do tego Pola tekstu dowolnego: dziesięć dowolnie wypełnianych bloków tekstu na układ, od {custom_text_0} do {custom_text_9}. To, co w nich stoi, ustalasz sam — a etykietę możesz zmienić, żeby w edytorze dokumentu widniało „Informacja o płatności” zamiast „Tekst dowolny 3”.
- Otwórz Ustawienia → Szablony i wybierz chip filtra Szablon układu.
- Wybierz swój układ i otwórz Teksty dowolne.
- Nadaj każdemu polu nazwę i tekst domyślny.
- W pojedynczym dokumencie nadpisujesz tekst w sekcji Pola tekstu dowolnego, nie zmieniając tekstu domyślnego.
Tekst dowolny sam może zawierać symbole zastępcze — w ten sposób zbudujesz np. własny zwrot do klienta z {Customer_First_Name} i {Customer_Last_Name}.
Jedenastego pola nie da się dodać, a nazwa techniczna (custom_text_3) pozostaje taka sama, nawet jeśli zmienisz etykietę. W szablonie Word nadal stoi więc {custom_text_3}.
Szybka droga: zapytaj asystenta
Zamiast przeszukiwać tabele, możesz zapytać asystenta AI w aplikacji: „Jakie symbole zastępcze są dostępne dla faktur?” albo „Jakie zmienne zna szablon przypomnienia o fakturze?”. Czyta on tę samą listę, której Univents używa przy generowaniu dokumentów, i odpowiada nazwą oraz znaczeniem.
Najczęstsze pytania
W moim PDF zamiast wartości stoi {Foo}. Co się stało? Univents nie zna tego symbolu zastępczego — niemal zawsze to literówka albo jeden nawias za dużo. To, czy w PDF przeczytasz błędną nazwę, czy zobaczysz tylko puste miejsce, zależy od układu: z szablonem Word nazwa pozostaje widoczna, bez szablonu Word miejsce zostaje puste. Sprawdź od razu: czy nazwa stoi dokładnie tak jak na liście, łącznie z wielkością liter? Czy to pojedyncze nawiasy (dokument), a nie podwójne (e-mail)? Czy symbol znajduje się w polu tekstowym lub kształcie w programie Word? Tam symbole zastępcze nie są podmieniane nigdy.
Czy mogę użyć symbolu zastępczego z dokumentu w szablonie e-maila? Nie. Nazwy różnią się już zapisem ({Customer_Name} w porównaniu z {{customer_name}}) i pochodzą z osobnych list.
Czy mogę zmienić nazwę symbolu zastępczego? Tylko Etykieta dziesięciu pól tekstu dowolnego. Wszystkie pozostałe nazwy są stałe, ponieważ określają wartość, którą wstawia Univents.
Dlaczego symbol zastępczy pozostał pusty? Najczęściej dlatego, że wartość nie jest uzupełniona w dokumencie, kontakcie lub wydarzeniu. Uzupełnij ją tam — np. numer podatkowy w Ustawienia → Firma dla {workspace_tax_number}. Jeśli pracujesz z układem bez szablonu Word, sprawdź dodatkowo zapis: błędnie wpisana nazwa również pozostaje tam pusta.