Pola we wzorach dokumentów

We własnych wzorach dokumentów tekstowych (pisma, umowy, oświadczenia) można wstawiać pola — program zamienia je na dane firmy, właściciela lub pracownika. Dzięki temu jeden wzór wystarcza dla wszystkich podmiotów.

Sam plik wzoru przygotowuje się w edytorze tekstu programu i wskazuje w konfiguracji — zobacz Własne wzory dokumentów.

Uwaga: ta strona dotyczy wzorów dokumentów tekstowych (pisma, umowy, oświadczenia). Wydruki faktur i dokumentów płatniczych powstają z szablonów HTML, które mają inny zapis pól (<% Numer %>) i inny zestaw danych — opisano je na stronie Szablony HTML wydruków.

Jak zapisuje się pole

Pole składa się z nazwy obiektu i nazwy pola, ujętych w nawiasy klamrowe:

{Firma.Nazwa}
{Firma.NIP}
{Właściciel.Nazwisko}
{Pracownik.PESEL}

Kiedy program podstawia dane: w chwili tworzenia nowego dokumentu z wzoru. Program wczytuje wzór, uzupełnia wszystkie pola i dopiero taki gotowy dokument pokazuje do edycji. Pola żyją więc wyłącznie w pliku wzoru — w utworzonym dokumencie są już zwykłym tekstem i nie odświeżają się później.

Dostępne obiekty

To, które obiekty są dostępne, zależy od miejsca zapisania wzoru w drzewie danych:

Wzór zapisany pod…	Dostępne obiekty
firmą (księgi, płace, środki trwałe, samochody)	Firma
właścicielem	Właściciel
pracownikiem	Pracownik oraz Firma (dane pracodawcy)
pozostałe miejsca	tylko pola z datą bieżącą i kwota słownie

Oznacza to m.in., że we wzorze zapisanym pod właścicielem nie ma dostępu do danych firmy, a we wzorze zapisanym pod firmą — do danych właściciela ani pracownika.

Listy wszystkich pól:

• Pola firmy — dane podmiotu, adres siedziby, adres zamieszkania przedsiębiorcy, rejestracja, urząd skarbowy, bank
• Pola właściciela — dane osobowe, adresy, urząd skarbowy, udziały
• Pola pracownika — dane osobowe, adresy, zatrudnienie, ZUS

Pola z datą bieżącą

Te pola nie wymagają nazwy obiektu — działają w każdym wzorze:

Pole	Wstawia
{Data}	dzisiejszą datę
{Rok}	bieżący rok, np. 2026
{Miesiąc}	numer bieżącego miesiąca, np. 7
{Miesiąc2}	numer miesiąca zawsze dwucyfrowo, np. 07
{Dzień}	numer dnia miesiąca
{OstatniDzieńPoprzedniegoRoku}	31 grudnia poprzedniego roku

Kwota słownie

{system.słownie(1234,56)}

W nawiasie można podać także inne pole — program najpierw ustali jego wartość, a potem zapisze ją słownie.

Tekst zastępczy, gdy pole jest puste

Po znaku | można podać tekst, który program wstawi, gdy pole okaże się puste:

{Firma.NIPUE|nie dotyczy}
{Właściciel.Paszport|—}

Bez tego zapisu puste pole nie wstawia nic (znika z dokumentu).

O czym warto pamiętać

• Wielkość liter w nazwie pola nie ma znaczenia — {Firma.NIP} i {Firma.nip} dadzą ten sam wynik. Dla czytelności warto pisać tak jak w tabelach.
• Nazwę obiektu Właściciel trzeba pisać z polskimi znakami (ł, ś). Zapis {Wlasciciel.Nazwisko} nie zadziała. To samo dotyczy pól {Miesiąc}, {Dzień} i {system.słownie()}.
• Błędna nazwa pola nie zgłasza błędu — pole zostanie po prostu usunięte z dokumentu i w tym miejscu nie pojawi się nic. Jeśli w gotowym dokumencie brakuje danych, w pierwszej kolejności sprawdź pisownię nazwy pola i to, czy dane są wypełnione w kartotece.
• Część pól jest wyliczana i składa kilka danych w jeden ciąg (np. {Firma.Adres}, {Firma.NazwaAdresNIP}, {Firma.KodPoczta}). Warto z nich korzystać zamiast składać adres z pojedynczych pól.
• Daty wstawiane są w formacie ustawionym w systemie Windows.

Najczęstsze pytania

Adres zamieszkania przedsiębiorcy

Dane z zakładki Adres zamieszkania w kartotece firmy to pola z przedrostkiem OF (od „osoba fizyczna"). Dla tego adresu nie ma gotowego pola złożonego, więc adres składa się z części:

{Firma.OFUlica} {Firma.OFDom}/{Firma.OFLokal}
{Firma.OFKod} {Firma.OFMiejscowosc}

Pełna lista: {Firma.OFUlica}, {Firma.OFDom}, {Firma.OFLokal}, {Firma.OFKod}, {Firma.OFPoczta}, {Firma.OFMiejscowosc}, {Firma.OFGmina}, {Firma.OFPowiat}, {Firma.OFWojewodztwo}, {Firma.OFKraj}.

Uwaga: {Firma.Adres} i pozostałe pola bez przedrostka OF to adres siedziby, a nie zamieszkania.

Numer w rejestrze (KRS)

W kartotece firmy, na zakładce Rejestracja, są dwa różne pola:

Pole w programie	Pole we wzorze
Numer w rejestrze (numer wpisu do rejestru)	{Firma.NumerWpisuDoRejestru}
Numer KRS	{Firma.KRS}

Jeżeli numer KRS wpisywany jest w polu Numer w rejestrze, we wzorze należy użyć {Firma.NumerWpisuDoRejestru}. Przydatne są też {Firma.NazwaRejestru}, {Firma.NazwaOrganuRejestrowego} i {Firma.DataWpisuDoRejestru}.

Numer dowodu osobistego

Skąd dane	Pole we wzorze
kartoteka firmy (dane przedsiębiorcy)	{Firma.OFNrDowodu}
kartoteka właścicieli	{Właściciel.NrDowodu}
kartoteka pracowników	{Pracownik.NrDowodu}

Odpowiednikiem dla paszportu są {Firma.OFPaszport}, {Właściciel.Paszport} i {Pracownik.Paszport}.