Jakich zmiennych można użyć podczas wysyłania dokumentów e-mailem?

Utworzono: 2022-12-28
Ostatnia aktualizacja: 2024-10-08

Liczba odwiedzin posta: 1667

W ramach konfiguracji wysyłki dokumentów e-mailem istnieje możliwość dostosowania treści wiadomości do własnych potrzeb, czyli umieszczenia w niej informacji, które są dla Ciebie, jako użytkownika, niezbędne. Wysyłaną wiadomości możesz skonfigurować w oparciu o zmienne, które dostępne są w systemie.

Treść wysyłanej wiadomości możesz ustawić w Ustawienia > Ustawienia konta > Wysyłanie e-mailem dla ustawień ogólnych konta. Jeśli chcesz ustalić treść wiadomości dla wybranego działu przejdź do zakładki Ustawienia > Dane firmy > kliknij zębatkę przy dziale i wybierz Edytuj > zaznacz checkbox przy Osobna konfiguracja wysyłania dokumentów e-mailem. Szczegółowo wysyłanie dokumentów e-mailem opisujemy tutaj.

Po wybraniu opcji własny szablon e-mail, rubryka z treścią stanie się edytowalna.

Treść wiadomości możesz dostosować korzystając ze zmiennych, których jednorazowe użycie pozwala na automatyczne zaczytywanie danych z systemu przy każdej kolejnej wysyłce. Raz tworzysz uniwersalny szablon wiadomości, w który wplatasz nazwy zmiennych, a przy każdej kolejnej wysyłce system wczytuje konkretne dane, odpowiednie dla dokumentu lub klienta.

Listę zmiennych, z których możesz skorzystać, system wskaże Ci w momencie, gdy klikniesz w niebieski przycisk Pomoc, który znajdziesz pod rubryką z treścią wiadomości.

Do najczęściej stosowanych zmiennych należą np.:

{{document_type}} - rodzaj dokumentu;
{{number}} - numer dokumentu;
{{total_price_gross}} - cena całkowita brutto;
{{total_price_net}} - cena całkowita netto;
{{view_link}} - link do podglądu;
{{view_url}} - adres url;
{{payment_url}} - adres płatności;
{{payment_link}} - link do płatności.

Dla przykładu: Wzór wiadomości e-mail zapisany w systemie ze wskazanymi zmiennymi jaki widzisz Ty.

Treść, jaką po wysłaniu e-maila widzi Kontrahent, do którego wysłałeś wiadomość z fakturą.

Oprócz zmiennych, które stosowane są przez użytkowników Fakturowni najczęściej, możesz skorzystać również z szerokiej gamy bardziej szczegółowych zmiennych. Wszystko zależne jest od tego, jakie istotne informacje chcesz umieścić w przesyłanej wiadomości.

Poniżej znajdziesz listę dostępnych do użycia zmiennych wraz z ich tłumaczeniem oraz opisem.

Pamiętaj, widoczność dostępnych do użycia zmiennych zależy od ustawień Twojego konta.

Aby wyszukać czy na liście jest dostępna zmienna, która wyświetli w wiadomości wartość, na której Ci zależy, skorzystaj z opcji wywołania wyszukiwarki kontekstowej, która dostępna będzie po użyciu klawiszy CTRL + F.

ZMIENNA	TŁUMACZENIE	DODATKOWY OPIS
{{absolute_outstanding}}	do zapłaty	wartość z rubryki do zapłaty wraz z oznaczeniem waluty
{{absolute_outstanding_in_exchange_currency}}	do zapłaty po przeliczeniu wg kursu	wartość z rubryki do zapłaty po przeliczeniu według wybranego kursu z oznaczeniem waluty przeliczenia
{{absolute_outstanding_in_words}}	do zapłaty słownie
{{absolute_outstanding_in_words_in_exchange_currency}}	do zapłaty słownie po przeliczeniu wg kursu
{{absolute_outstanding_without_currency}}	do zapłaty bez waluty	zmienna wskazuje tylko wartość liczbową do zapłaty bez oznaczenia waluty
{{accounting_doc}}	rodzaj dokumentu wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli dokument jest księgowy lub false jeśli dokument jest nieksięgowy
{{accounting_expense_discount_code}}	kod księgowy rabatu w wydatkach
{{accounting_income_discount_code}}	kod księgowy rabatu w przychodach
{{accounting_note_kind}}	rodzaj noty księgowej	zmienna zwraca wartość credit dla noty obciążeniowej i debit dla nowy uznaniowej
{{additional_address_seller_name}}	nazwa wyświetlana na fakturze zamiast "Wystawca" (Sprzedawca)	zmienna zwraca nazwę z rubryki ‘Nazwa wyświetlana na fakturze zamiast "Wystawca" (Sprzedawca)’
{{additional_field_name}}	nazwa dodatkowego pola na fakturze	zmienna zwraca nazwę rubryki ‘Dodatkowe pole na fakturze’
{{additional_field_value}}	wartość dodatkowego pola na fakturze	zmienna zwraca wartość z rubryki określonej na fakturze jako dodatkowe pole na fakturze
{{additional_info}}	dodatkowe pole na pozycjach faktury wartość TRUE lub FALSE	Zmienna zwraca wartość true jeśli na dokumencie jest dodatkowe pole na pozycjach faktury lub false jeśli go nie ma
{{additional_info_desc}}	nazwa dodatkowego pola na pozycjach faktury	zmienna zwraca nazwę rubryki ‘Dodatkowe pole na pozycjach faktury’
{{address}}	adres Sprzedawcy	zmienna zwraca wartość z rubryk ulica i nr, kod pocztowy i miejscowość Sprzedawcy
{{advanced}}	powiązane zaliczki do faktury końcowej
{{advanced_num}}	ilość powiązanych faktur zaliczkowych dla faktury końcowej
{{advanced_total_price_gross}}	suma brutto powiązanych zaliczek
{{all_in_words}}	suma brutto słownie
{{all_in_words_in_exchange_currency}}	suma brutto słownie po przeliczeniu
{{bank}}	bank (nazwa banku)
{{bank_account}}	numer konta bankowego
{{bilangual}}	dwujęzyczna faktura wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli faktura jest dwujęzyczna lub false jeśli nie jest
{{buyer}}	nabywca	zmienna zwraca imię i nazwisko nabywcy
{{buyer_address}}	adres nabywcy	zmienna zwraca wartość z rubryk ulica i nr, kod pocztowy, miejscowość i oznaczenie kraju nabywcy
{{buyer_company}}	nabywca firma wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli nabywca to firma i false jeśli nabywca to osoba prywatna
{{buyer_country_code}}	oznaczenie kraju nabywcy	zmienna zwraca oznaczenie kraju nabywcy np. PL dla Polska, DE dla Niemcy
{{buyer_email}}	e-mail klienta
{{buyer_first_name}}	imię Nabywcy
{{buyer_full_name}}	imię i nazwisko Nabywcy
{{buyer_last_name}}	nazwisko Nabywcy
{{buyer_mobile_phone}}	telefon komórkowy Nabywcy
{{buyer_note}}	dodatkowy opis Nabywcy
{{buyer_person}}	imię i nazwisko Odbiorcy	zmienna zwraca wartość z rubryki ‘Imię i nazwisko odbiorcy’ pod pozycjami na fakturze
{{buyer_phone}}	telefon Nabywcy
{{buyer_place}}	miejscowość Nabywcy
{{buyer_post_code}}	kod pocztowy Nabywcy
{{buyer_street}}	ulica i nr Nabywcy
{{buyer_tax_no}}	NIP Nabywcy
{{buyer_tax_no_kind}}	rodzaj numeru identyfikacyjnego Nabywcy
{{cancel_reason}}	powód anulowania dokumentu
{{canceled}}	anulowany dokument wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli dokument jest anulowany i false jeśli nie jest
{{client_external_id}}	ID klienta	zmienna zaciąga wartość z rubryki ID klienta w karcie klienta
{{{client_panel_view_link}}}	link do panelu klienta
{{{client_panel_view_link_unpaid}}}	link do panelu klienta (tylko nieopłacone faktury)
{{client_panel_view_url}}	adres URL do panelu klienta
{{client_url}}	ID klienta w systemie	przykładowa wartość zwracana przez zmienną: /clients/103877637
{{company}}	nazwa Sprzedawcy
{{corrected_content_after}}	treść prawidłowa	zmienna zwraca wartość z rubryki treść prawidłowa na fakturze korekcie lub nocie korygującej
{{corrected_content_before}}	treść korygowana	zmienna zwraca wartość z rubryki treść korygowana na fakturze korekcie lub nocie korygującej
{{corrected_issue_date}}	data wystawienia korygowanego dokumentu	!!! do upewnienia zanim pójdzie do wpisu
{{corrected_kind}}	typ dokumentu korygowanego
{{corrected_number}}	numer dokumentu korygowanego
{{corrected_sell_date}}	data sprzedaży dokumentu korygowanego
{{correction}}	dokument korygowany	Zmienna zwraca całą wartość z faktury korekty: Dokument korygowany: Faktura 90/03/2023 z dnia 2023-03-28
{{correction_reason}}	przyczyna korekty
{{country}}	kraj Sprzedawcy
{{currency}}	waluta
{{currency_short}}	skrócona nazwa waluty	zmienna zwraca wartość dla PLN - zł, dla EUR - €
{{currency_symbol}}	symbol waluty	zmienna dla ZŁ zwraca wartość PLN
{{delivery_address}}	adresat	zmienna zaciąga dane z rubryki Adresat po stronie Nabywcy
{{delivery_address_name}}	adres korespondencyjny	zmienna zwraca dosłownie wartość ‘Adres korespondencyjny’
{{description_footer}}	dodatkowe uwagi (drukowane na dole strony)	zmienna zwraca wartość z rubryki ‘Dodatkowe uwagi (drukowane na dole strony)
{{description_long}}	dodatkowe uwagi (drukowane na drugiej stronie)	zmienna zwraca wartość z rubryki ‘Dodatkowe uwagi (drukowane na drugiej stronie)
{{discount}}	rabat	zmienna zwraca sumę udzielonego rabatu
{{discount_kind}}	rodzaj rabatu	zmienna zwraca konkretne wartości: percent_total - rabat procentowy od ceny całkowitej netto percent_unit - rabat procentowy od ceny jednostkowej netto percent_unit_gross - rabat procentowy od ceny jednostkowej brutto (zgodnie z kasą fiskalną) amount - kwotowy
{{document_type}}	typ dokumentu
{{email}}	e-mail Sprzedawcy
{{exchange_currency}}	przeliczanie na walutę	zmienna wskazuje rodzaj waluty, na którą przeliczono wartość
{{exchange_currency_rate}}	kurs przeliczenia waluty
{{exchange_date}}	data kursu przeliczenia
{{exchange_note}}	notatka do kursu	zmienna zwraca nr przeliczenia w przypadku przeliczenia wg NBP lub jeśli kurs własny to wtedy wartość z rubryki ‘Notatka do kursu’
{{exchange_rate}}	kurs przeliczenia waluty
{{exchange_tax}}	przeliczona kwota VAT
{{exempt_tax_kind}}	podstawa zwolnienia z podatku VAT	zmienna dostępna tylko, jeśli na w ustawieniach konta włączona jest opcja “Wybór podstawy zastosowania stawki zw (zwolnione z opodatkowania) na fakturze
{{fax}}	fax Sprzedawcy
{{final}}	faktura końcowa wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli dokument to faktura końcowa i false jeśli nie
{{final_summary_table}}	faktura końcowa tabela z podsumowaniem wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli dokument to faktura końcowa z tabelą z podsumowaniem i false jeśli ten warunek nie jest spełniony
{{footer}}	stopka e-maila
{{forced_payment_to}}	wymuszony termin zapłaty	wymuszony termin zapłaty ustawiany jest na fakturze przy masowym żądaniu opłacenia faktur
{{from_recurring_payment}}	autopłatność z faktury cyklicznej wartość TRUE lub FALSE	zmienna zwraca true jeśli faktura posiada autopłatność pochodzącą z faktury cyklicznej lub false jeśli warunek nie jest spełniony
{{global_discount_gross}}	rabat od sumy brutto
{{global_discount_gross_with_currency}}	rabat od sumy brutto z oznaczeniem waluty
{{global_discount_net}}	rabat od sumy netto
{{global_discount_net_with_currency}}	rabat od sumy netto z oznaczeniem waluty
{{gtu_codes_list}}	lista kodów GTU
{{gtu_codes_note}}	nazwa + lista kodów GTU	zmienna zwraca kody wraz z wartością ‘Kody:’ np. Kody GTU: GTU_01, GTU_05,
{{has_corrected_content}}	treść korygowana wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli dokument jest korektą lub notą korygującą oraz false jeśli nie spełnia tego warunku
{{id}}	id dokumentu w systemie	numer id zaciągany jest z adresu URL przykład oznaczenia invoices/207974295
{{income}}	przychód wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli dokument jest po stronie przychodów oraz false jeśli po stronie wydatków
{{internal_note}}	notatka prywatna (niewidoczna na wydruku)
{{invoice_category}}	kategoria faktury	zmienna wskazuje kategorię przypisaną do faktury
{{issue_date}}	data wystawienia
{{issue_place}}	miejsce wystawienia
{{issuer}}	wystawca dokumentu	zmienna zwraca wartość z rubryki Wystawca, która dostępna jest po stronie Sprzedawcy po aktywacji opcji Dodaj wystawcę (Wystawca)
{{kind}}	typ dokumentu
{{kpir_col}}	numer kolumny w księdze
{{kpir_pos}}	numer pozycji w księdze
{{lang}}	język dokumentu	w przypadku faktur dwujęzycznych będzie oznaczenie np. pl/en
{{legal_cost_compensation}}	rekompensata kosztów prawnych
{{logo_url}}	adres URL logo
{{long_exchange_note}}	notatka o kursie przeliczenia	zmienna zwraca wartość ‘Kurs waluty PLN/USD 4,4356, tabela kursów średnich NBP nr 048/A/NBP/2023 / z dnia 2023-03-09’ Zaczytywanie danych zależne jest od statusu dokumentu: wystawiona - nie zaczytuje wystawiona wysłana - zaczytuje częściowo opłacona - zaczytuje opłacona - zaczytuje
{{long_exchange_note_for_tax}}	notatka o kursie przeliczenia	zmienna zwraca wartość ‘Kurs waluty PLN/USD 4,4356, tabela kursów średnich NBP nr 048/A/NBP/2023 / z dnia 2023-03-09’ Zaczytywanie danych zależne jest od statusu dokumentu: wystawiona - zaczytuje wystawiona wysłana - nie zaczytuje częściowo opłacona - zaczytuje opłacona - nie zaczytuje
{{negative_outstanding}}	wartość do zapłaty ujemna wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli do zapłaty jest ujemne lub false jeśli warunek nie jest spełniony
{{notes}}	uwagi
{{number}}	numer dokumentu
{{oid}}	nr zamówienia	zmienna zwraca wartość z rubryki numer zamówienia na dokumencie
{{outstanding}}	do zapłaty	zmienna zwraca wartość do zapłaty z oznaczeniem waluty
{{outstanding_in_exchange_currency}}	do zapłaty po przeliczeniu	zmienna zwraca wartość do zapłaty po przeliczeniu z oznaczeniem waluty przeliczenia
{{outstanding_in_words}}	do zapłaty słownie
{{outstanding_in_words_in_exchange_currency}}	do zapłaty słownie po przeliczeniu
{{overdue}}	zaległość wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli wartość do zapłaty jest większa niż 0 oraz false jeśli do zapłaty jest 0,00, czyli brak zaległości
{{paid}}	kwota opłacona
{{paid_date}}	data płatności
{{paid_mark_url}}	adres URL znaku opłacono
{{payment_button_url}}	adres URL przycisku ‘Kliknij i zapłacić online’
{{{payment_link}}}	link do bezpośredniej płatności online	zmienna zwraca wartość ‘Link do bezpośredniej płatności on-line’, pod tą frazą podpięty jest link do płatności
{{payment_reference_number}}	numer polecenia zapłaty	wartość pobierana z numeru dokumentu dla przykładu faktura o numerze 40/03/2023 jako numer polecenia zapłaty zwróci 40032023
{{payment_to}}	termin płatności
{{payment_type_sym}}	typ płatności	Zmienna określa wartość odnośnie typu płatności: off - nie wyświetlaj transfer - przelew card - karta płatnicza cash - gotówka cash on delivery - opłata za pobraniem paypal - PayPal payu - PayU dotpay - DotPay barter - barter cheque - czek bill of exchange - weksel compensation - kompensata letter of credit - akredytywa
{{payment_url}}	link do płatności
{{person}}	imię i nazwisko Wystawcy
{{phone}}	telefon Sprzedawcy	zmienna zwraca wartość z rubryki telefon i telefon komórkowy
{{place}}	miejscowość z danych firmy
{{positions_total_price_gross}}	suma brutto
{{positions_total_price_net}}	suma netto
{{positions_total_quantity}}	suma z rubryki ilość
{{positions_total_quantity_separated}}	suma ilości z jednostką	jeśli na dokumencie są produkty w różnych jednostkach wtedy system wykaże wartość z separatorem np. 3 szt<br>30 m
{{positions_total_tax}}	wartość podatku
{{positions_total_weight}}	waga produktu
{{post_code}}	kod pocztowy Sprzedawcy
{{print_option}}	wydruk faktury
{{procedure_designations_list}}	oznaczenia dotyczące procedur	zmienna zwraca listę procedur wybranych na dokumencie
{{procedure_designations_note}}	oznaczenia dotyczące procedur z opisem	zmienna zwraca dosłownie wartość: Oznaczenia dotyczące procedur: B_SPV
{{product_cache}}	pamięć podręczna produktu	w przypadku kilku pozycji na fakturze zmienna zwraca początki ich nazwy
{{proforma}}	numer proformy do faktury	zmienna zwraca oznaczenie faktury proformy do faktury dosłownie: ‘Faktura do faktury proforma nr: P1/04/2023’, jeśli opcja jest wyłączona zmienna nie zwraca nic
{{qrcode_img}}	oznaczenie kodu QR
{{receipt}}	numer paragonu do faktury	zmienna zwraca oznaczenie numeru paragonu do faktury dosłownie: ‘Faktura do paragonu nr: 1’, jeśli opcja jest wyłączona zmienna nie zwraca nic
{{recipient_address}}	adres Odbiorcy	zmienna zwraca wartość z rubryk ulica i nr + kod pocztowy + miejscowość + kraj
{{recipient_city}}	miejscowość Odbiorcy
{{recipient_country}}	kraj Odbiorcy
{{recipient_country_code}}	oznaczenie kraju Odbiorcy	zmienna zwraca oznaczenie kraju dla Polska zwraca wartość PL
{{recipient_email}}	e-mail Odbiorcy
{{recipient_name}}	nazwa Odbiorcy
{{recipient_note}}	dodatkowy opis Odbiorcy
{{recipient_phone}}	numer telefonu Odbiorcy
{{recipient_post_code}}	kod pocztowy Odbiorcy
{{recipient_present}}	Odbiorca wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli na dokumencie jest Odbiorca oraz false Odbiorca nie jest dodany
{{recipient_street}}	ulica i nr Odbiorcy
{{recipient_url}}	ID Odbiorcy w systemie	zmienna zwraca Id Odbiorcy z systemu widoczny w pasku URL np. /clients/105955997
{{reminder_no}}	liczba wysłanych przypomnień o nieopłaconej fakturze
{{reminder_number}}	numer kolejnego przypomnienia o nieopłaconej fakturze
{{sec_stamp_url}}	adres URL dodatkowej pieczęci na fakturze
{{sell_date}}	data sprzedaży
{{sell_date_MY}}	data sprzedaży w formacie mm/yyyy
{{sell_date_kind}}	oznaczenie czasu sprzedaży	zmienna zwraca nazwę, która jest wybrana na dokumencie jako oznaczenie czasu sprzedaży dostępne w zakładce Ustawienia > Ustawienia konta > Konfiguracja > Słowniki
{{seller_tax_no_kind}}	rodzaj numeru identyfikacyjnego Sprzedawcy
{{sent_at}}	data i godzina wysłania dokumentu
{{should_print_gtu_codes}}	wstaw kody GTU wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli opcja wstaw kody GTU jest w systemie włączona lub false jeśli opcja wstaw kody GTU jest wyłączona.
{{should_print_procedure_designations}}	wstaw oznaczenie dotyczące procedur wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli opcja wstaw oznaczenia dotyczące procedur jest w systemie włączona lub false jeśli jest wyłączona
{{show_buyer_note}}	wstaw dodatkowy opis Nabywcy wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli opcja wstaw dodatkowy opis Nabywcy jest włączona lub false jeśli jest wyłączona
{{show_discount}}	widoczna rubryka rabat wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli na dokumencie jest rubryka rabat lub false jeśli rubryka jest ukryta true pojawia się nawet jeśli rubryka rabat jest pusta
{{show_empty_buyer_person}}	wstaw puste pole na podpis wystawcy wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli opcja ‘Wstaw puste pole na podpis wystawcy’ jest włączona i false jeśli warunek nie został spełniony
{{show_empty_seller_person}}	wstaw puste pole na podpis odbiorcy wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli opcja Wstaw puste pole na podpis odbiorcy’ jest włączona i false jeśli warunek nie został spełniony
{{show_links}}	linki na podglądzie dokumentu wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli na podglądzie dokumentu widoczne są linki do produktu lub klienta lub false jeśli warunek nie jest spełniony
{{show_paid_date}}	wstaw datę płatności wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli opcja wstaw datę płatności jest w systemie włączona lub false jeśli nie jest
{{show_paid_logo}}	pokaż logo ‘zapłacono’ wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli opcja pokaż logo ‘zapłacono’ jest włączona lub false jeśl nie jest
{{show_paid_when_zero}}	kwota opłacona … wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli opcja “Kwota opłacona…” także w przypadku opłacenia 0,00 zł jest włączona lub false jeśli nie jest
{{show_price_offer_summary}}	pokaż z podsumowaniem wartość TRUE lub FALSE	zmienna zwraca true jeśli oferta cenowa jest tworzona z opcją ‘pokaż z podsumowaniem’ lub false jeśli warunek nie jest spełniony
{{show_product_description}	opis produktu na pozycjach faktury wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli opcja opis produktu na pozycjach faktury jest włączona lub false jeśli nie jest
{{show_sell_date}}	pokazuj datę sprzedaży wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli opcja ‘Show sell date on invoices’ jest włączona i false jeśli warunek nie jest spełniony \| dla wersji InvoiceOcean
{{show_tax_split}}	wyświetlaj podsumowanie podatku wartość TRUE lub FALSE	zmienna zwraca true jeśli opcja wyświetlaj podsumowanie podatku jest włączona lub false jeśli nie jest
{{show_unit_price_gross}}	wyświetlaj cenę jednostkową brutto wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli włączona jest opcja ‘Wyświetlaj cenę jednostkową brutto’ oraz false jeśli opcja jest wyłączona
{{sign_document_url}}	link do podpisu elektronicznego	zmienna zwraca link do podpisu elektronicznego przy włączonej opcji ‘Umożliwiaj elektroniczne podpisywanie zamówień i własnych dokumentów nieksięgowych’
{{signature_date}}	data podpisania elektronicznego dokumentu
{{signature_url}}	link do podpisu elektronicznego
{{skonto_active}}	używaj skonta na fakturach wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli opcja używaj skonta na fakturach jest włączona lub false jeśli nie jest
{{skonto_date}}	skonto termin płatności	zmienna zwraca datę do kiedy ma być płatność, żeby uwzględniło dodatkowy rabat
{{skonto_price}	suma rabatu za wcześniejszą płatność
{{skonto_value}}	% przyznanego upustu
{{split_payment}}	mechanizm podzielonej płatności wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli włączona jest opcja mechanizm podzielonej płatności lub false jeśli nie jest
{{split_payment_note}}	notatka o metodzie podzielonej płatności	zmienna zwraca dosłowną wartość ‘Metoda podzielonej płatności’.
{{stamp_below_sign_url}}	adres URL pieczęci na fakturze
{{stamp_url}}	adres URL pieczęci na fakturze
{{status_paid}}	status opłacona wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli faktura ma status opłacona lub false jeśli nie jest spełniony warunek
{{street}}	ulica i nr Sprzedawcy
{{swift}}	kod SWIFT
{{tax2_details}}	drugi podatek wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli na dokumencie są szczegóły dotyczące drugiego podatku lub false jeśl nie jest spełniony warunek
{{tax2_name}}	nazwa drugiego podatku
{{tax2_visible}}	drugi podatek wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli drugi podatek jest widoczny na dokumencie lub false jeśli warunek nie jest spełniony
{{tax_in_exchange_currency}}	wartość podatku po przeliczeniu
{{tax_name}}	nazwa podatku
{{tax_no}}	numer identyfikacji podatkowej	zmienna zwraca wartość z rubryki NIP lub inny jeśli w ustawieniach określony został inny numer identyfikacyjny
{{tax_value}}	wartość podatku
{{tax_value_in_exchange_currency}}	wartość podatku po przeliczeniu
{{tax_value_in_exchange_currency_with_currency}}	wartość podatku po przeliczeniu z określoną walutą
{{tax_value_name}}	nazwa wartości podatku	zmienna zwraca frazę ‘Wartość + nazwa podatku z ustawień konta’
{{tax_value_with_currency}}	wartość podatku z oznaczeniem waluty
{{tax_visible}}	widoczność podatku na dokumencie wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli na dokumencie jest widoczny podatek lub false jeśli warunek nie jest spełniony
{{today_date}}	aktualna data	zmienna zwraca dzisiejszą datę
{{total_discount}}	suma rabatu
{{total_discount_in_exchange_currency}}	suma rabatu po przeliczeniu
{{total_discount_in_exchange_currency_with_currency}}	suma rabatu po przeliczeniu z oznaczeniem waluty
{{total_discount_with_currency}}	suma rabatu z oznaczeniem waluty głównej dokumentu
{{total_price_gross}}	wartość brutto
{{total_price_gross_in_exchange_currency}}	wartość brutto po przeliczeniu
{{total_price_gross_in_exchange_currency_with_currency}}	wartość brutto po przeliczeniu z oznaczeniem waluty
{{total_price_gross_in_main_currency}}	wartość brutto przeliczona na walutę główną konta
{{total_price_gross_with_currency}}	wartość brutto z oznaczeniem waluty dokumentu
{{total_price_gross_without_discount}}	wartość brutto bez rabatu
{{total_price_gross_without_discount_with_currency}}	wartość brutto bez rabatu z oznaczeniem waluty dokumentu
{{total_price_net}}	wartość netto
{{total_price_net_in_exchange_currency}}	wartość netto po przeliczeniu
{{total_price_net_in_exchange_currency_with_currency}}	wartość netto po przeliczeniu z oznaczeniem waluty
{{total_price_net_in_main_currency}}	wartość netto po przeliczeniu na walutę główną konta
{{total_price_net_with_currency}}	wartość netto z oznaczeniem waluty dokumentu
{{total_price_net_without_discount}}	wartość netto bez rabatu
{{total_price_net_without_discount_with_currency}}	wartość netto bez rabatu z oznaczeniem waluty dokumentu
{{total_tax_inscription}}	opis wartości VAT	zmienna zwraca dosłownie: Wartość + nazwa podatku z ustawień konta
{{transaction_id}}	ID powiązanej z fakturą transakcji
{{type_of_payment}}	rodzaj płatności	zmienna zwraca wartość, która jest wybrana w rubryce Płatność na dokumencie
{{use_barcodes}}	kod EAN przy produkcie wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli przy produkcie jest podany kod EAN lub false jeśli ten warunek nie jest spełniony
{{use_delivery_address}}	inny adres korespondencyjny wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli na dokumencie podana jest wartość w rubryce ‘Inny adres korespondencyjny (Adresat)’ lub false jeśli warunek nie jest spełniony
{{use_paid_dates}}	używaj dat opłacenia na fakturach wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli włączona jest opcja ‘Używaj dat opłacenia na fakturach’ lub false jeśli warunek nie jest spełniony
{{use_product_code}	kod produktu wartość TRUE lub FALSE	zmienna zwraca true jeśli dla produktu jest podany kod produktu lub false jeśli warunek nie jest spełniony
{{valid_till_date}}	ważna do	zmienna zwraca wartość z rubryki ‘ważna do’ dla oferty cenowej
{{{view_link}}}	link do dokumentu	link do dokumentu ukryty pod nazwą dokumentu np. Faktura 101/03/2023 po kliknięciu przenosi do podglądu dokumentu
{{view_url}}	bezpośredni link do dokumentu	bezpośredni link do dokumentu w formacie widocznym w pasku URL
{{warehouse_document_numbers}}	numer powiązanego dokumentu magazynowego
{{www}}	adres strony www Sprzedawcy
{{zero_with_currency}}	zero z walutą dokumentu
{{zero_with_currency_in_exchange_currency}}	zero po przeliczeniu z oznaczeniem waluty

zmienne dotyczące płatności
aby zmienne zaczytywały wartości dla płatności dodanej do dokumentu
muszą zostać dodane do szablonu e-maila w znaczniku:
{{#each payments}}
zmienna
{{/each}}

ZMIENNA	TŁUMACZENIE	DODATKOWY OPIS
{{date}}	data płatności
{{price}}	zapłacona kwota
{{currency}}	waluta płatności
{{price_with_currency}}	zapłacona kwota z oznaczeniem waluty
{{name}}	tytuł płatności
{{provider}}	sposób płatności
{{cheque_number}}	numer czeku dla płatności czekiem

zmienne dotyczące podsumowania dokumentu
aby zmienne zaczytywały wartości dla całego dokumentu
muszą się one znaleźć w znaczniku:
{{#each final_summary}}
zmienna
{{/each}}

ZMIENNA	TŁUMACZENIE	DODATKOWY OPIS
{{tax}}	stawka podatku VAT
{{tax_value}}	wartość podatku
{{tax_value_with_currency}}	wartość podatku z oznaczeniem waluty
{{total_price_gross}}	cena całkowita brutto
{{total_price_gross_with_currency}}	cena całkowita brutto z oznaczeniem waluty
{{total_price_net}}	cena całkowita netto
{{total_price_net_with_currency}}	cena całkowita netto z oznaczeniem waluty

zmienne dotyczące pozycji
aby zmienne zaczytywały wartości dla całego dokumentu
muszą się one znaleźć w znaczniku:
{{#each positions}}
zmienna
{{/each}}

ZMIENNA	TŁUMACZENIE	DODATKOWY OPIS
{{additional_info}}	wartość dodatkowego pola na pozycjach faktury
{{additional_info_desc}}	nazwa dodatkowego pola na pozycjach faktury
{{barcode}}	kod kreskowy produktu
{{code}}	kod produktu
{{description}}	opis produktu
{{discount}}	rabat
{{discount_amount_gross}}	rabat brutto dla jednej sztuki
{{discount_amount_net}}	rabat netto dla jednej sztuki
{{dummy_position}}	rodzaj pozycji bez produktu wartość TRUE lub FALSE	zmienna zwraca true jeśli pozycja na fakturze jest z rodzaju "text_separator", "page_break", "subtotal", "subtotal_with_quantity" - są to rodzaje pozycji bez produktu lub false jeśli warunek nie jest spełniony
{{ean_code}}	kod EAN produktu
{{gtu_code}	kod GTU podany przy pozycji na fakturze	zmienna zwraca kod GTU, który podany jest w pozycji na fakturze, jeśli na koncie włączona jest opcja ‘Wybór kodu GTU na pozycjach faktury’
{{has_discount}}	dokument zawiera rabat wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli na fakturze jest dodany rabat, jeśli rubryka jest pusta albo w ogóle jej nie ma nie zwraca nic
{{image_url}}	adres URL zdjęcia produktu
{{item}}	nazwa produktu / usługi
{{item_url}}	ID produktu z adresu URL	zmienna zwraca część adresu URL produktu np. /products/222327107
{{kind}}	rodzaj pozycji
{{no}}	numer pozycji na dokumencie
{{product}}	dane o produkcie na pozycji faktury
{{quantity}}	ilość produktu z oznaczeniem jednostki
{{quantity_number}}	ilość produktu	zmienna zwraca wartość z rubryki ilość na dokumencie (sama wartość liczbowa)
{{quantity_unit}}	jednostka
{{supplier_code}}	kod u dostawcy	zmienna zwraca wartość z rubryki ‘Kod u dostawcy’ w karcie produktu
{{tax}}	stawka VAT
{{tax1_value_name}}	nazwa podatku	zmienna zwraca dosłownie: ‘Wartość + nazwa podatku’
{{tax2}}	stawka drugiego podatku na fakturze
{{tax2_name}}	nazwa drugiego podatku na fakturze
{{tax2_value_name}}	nazwa wartości drugiego podatku na fakturze	zmienna zwraca frazę ‘Wartość + nazwa drugiego podatku na fakturze’
{{tax_name}}	nazwa podatku
{{tax_value}}	wartość podatku VAT
{{total_price_gross}}	wartość brutto	jeśli na dokumencie jest rabat zmienna zwraca wartość z rabatem
{{total_price_gross_without_discount}}	wartość brutto bez rabatu
{{total_price_net}}	warość netto	jeśli na dokumencie jest rabat zmienna zwraca wartość z rabatem
{{total_price_net_without_discount}}	wartość netto bez rabatu
{{unit_price_gross}}	cena jednostkowa brutto
{{unit_price_gross_with_discount}}	cena jednostkowa brutto z rabatem
{{unit_price_net}}	cena jednostkowa netto
{{unit_price_net_with_discount}}	cena jednostkowa netto z rabatem

zmienne dotyczące podsumowania
aby zmienne zaczytywały wartości dla całego dokumentu
muszą się one znaleźć w znaczniku:
{{#each summary}}
zmienna
{{/each}}

ZMIENNA	TŁUMACZENIE	DODATKOWY OPIS
{{tax}}	stawka VAT
{{tax_value}}	wartość podatku
{{tax_value_with_currency}}	wartość podatku z oznaczeniem waluty
{{total_price_gross}}	wartość brutto
{{total_price_gross_with_currency}}	wartość brutto z oznaczeniem waluty
{{total_price_net}}	wartość netto
{{total_price_net_with_currency}}	wartość netto z oznaczeniem waluty

zmienne {{additional_fields}}:

ZMIENNA	TŁUMACZENIE	DODATKOWY OPIS
{{additional_fields.seller_bank_swift}}	SWIFT
{{additional_fields.tax_name}}	nazwa podatku na fakturze

zmienne dotyczące danych o kliencie
zmienne {{client}}:

ZMIENNA	TŁUMACZENIE	DODATKOWY OPIS
{{client.accounting_id}}	identyfikator w programie księgowym	zmienna zwraca wartość z rubryki ‘Identyfikator w programie księgowym’ w karcie klienta
{{client.additional_accounting_id}}	dodatkowy kod księgowy klienta
{{client.discount}}	domyślny rabat %	zmienna zwraca wartość z rubryki ‘Domyślny rabat %’ w karcie klienta
{{client.email}	e-mail klienta	zmienna zwraca wartość z rubryki ‘E-mail’ w karcie klienta
{{client.first_name}}	imię	zmienna zwraca wartość z rubryki ‘Imię’ w karcie klienta
{{client.id}}	id	zmienna zwraca wartość ID klienta z systemu (ten, który jest widoczny w URL)
{{client.last_name}}	nazwisko	zmienna zwraca wartość z rubryki ‘Nazwisko’ w karcie klienta
{{client.name}}	imię i nazwisko	zmienna zwraca imię i nazwisko jeśli klient jest osobą prywatną; jeśli klient to firma wtedy zaczytuje nazwę firmy
{{client.panel_link}}	link do panelu klienta	link do panelu widoczny pod frazą ‘Link do panelu klienta’
{{client.panel_link_unpaid}}	link do panelu klienta z nieopłaconymi fakturami	link do panelu klienta ukryty pod frazą ‘Link do panelu klienta (tylko nieopłacone faktury)
{{client.panel_url}}	link do panelu klienta jako adres URL

zmienne dotyczące danych o dziale / firmie
zmienne {{department}}:

ZMIENNA	TŁUMACZENIE	DODATKOWY OPIS
{{department.bank_account}}	numer konta bankowego Sprzedawcy
{{department.bank_swift}}	SWIFT banku	zmienna zwraca wartość z danych firmy - rubryka SWIFT
{{department.footer_content}}	treść stopki	jeśli zmienna footer_kind zwraca 'own' to wyświetli się wpisana wartość stopki, (ustawienie dostępne tylko dla starych kont)
{{department.footer_kind}}	rodzaj stopki w dziale firmy	zmienna określa rodzaj stopki, zwraca wartość ‘default’, ‘own’ lub ‘none’
{{department.id}}	ID działu	numer ID działu, który widoczny jest w danych firmy
{{department.kind}}	forma prawna	zmienna zwraca wartość z rubryki ‘Forma prawna’ z danych działu
{{department.name}}	nazwa firmy lub działu	zmienna zwraca wartość z rubryki ‘Nazwa firmy lub działu’ z danych działu
{{department.own_footer}}	własna treść stopki wartość TRUE lub FALSE	zmienna zwraca wartość true jeśli konto ma ustawione own_footer oraz false jeśli warunek nie jest spełniony (ustawienie dostępne tylko dla starych kont)
{{department.shortcut}}	nazwa skrócona	zmienna zwraca wartość z rubryki ‘Nazwa skrócona’ w danych działu
{{department.tax_no}}	numer NIP firmy	zmienna zwraca numer identyfikacyjny firmy podany w danych firmy

zmienne dotyczące zaliczek powiązanych z fakturą
aby zmienne zaczytywały informacje o zaliczkach
muszą się one znaleźć w znaczniku:
{{#each advanced}}
zmienna
{{/each}}

ZMIENNA	TŁUMACZENIE	DODATKOWY OPIS
{{no}}	liczba porządkowa powiązanej zaliczki
{{issue_date}}	data wystawienia zaliczki
{{number}}	numer systemowy zaliczki
{{currency}}	waluta zaliczki
{{price}}	wartość zaliczki
{{price_net}}	wartość netto zaliczki
{{price_tax}}	wartość VAT zaliczki
{{price_gross}}	wartość brutto zaliczki
{{price_net_with_currency}}	wartość netto zaliczki z oznaczeniem waluty
{{price_tax_with_currency}}	wartość VAT zaliczki z oznaczeniem waluty
{{price_gross_with_currency}}	wartość brutto zaliczki z oznaczeniem waluty

Sprawdź również: Wysyłanie dokumentów magazynowych e-mailem

Powrót

Komentarze

DariuszF

Dzień dobry, czym jest zmienna {{legal_cost_compensation}} rekompensata kosztów prawnych ?

2024-04-03 15:56

Ewelina

Pod zmienną {{legal_cost_compensation}} widnieje zapis 'W przypadku opóźnienia płatności, ustalona prawnie kwota kosztów odzyskiwania należności: 40 €' dotyczy on nieterminowych płatności.

8 marca 2013 roku została przyjęta ustawa o przeciwdziałaniu nadmiernym opóźnieniom w transakcjach handlowych umożliwiająca wystawianie not księgowych na 40 euro w przypadku wystąpienia opóźnień w opłacaniu należności. Zgodnie z treścią wspomnianej ustawy, wierzycielowi przysługuje od dłużnika, bez konieczności wezwania, rekompensata za koszty odzyskiwania należności.

2024-04-04 12:23

KasiaN

Dzień dobry,
czy można wykonywać operacje na zmiennych, np {today_date}}-{{payment_to}?
Jeśli tak, to jaki jest poprawny zapis?

2024-05-28 08:39

Ewelina

Zmienne wyłącznie zwracają wskazane żądania, czyli payment_to wskaże termin płatności ustawiony na dokumencie, a today_date dzisiejszą datę. Nie ma możliwości aby zmienne wykonały polecenia matematyczne.

2024-05-28 09:33

kasiaN

A czy zatem możliwe jest byście Państwo dołożyli "ilość dni do zbliżającej się płatności" do zestawu istniejących zmiennych liczonych jako {today_date}}-{{payment_to}?

2024-06-05 11:37

ewelinarychlik

Odpowiedź główna Dziękuję za przesłaną sugestię, przekażę tę propozycję do rozpatrzenia przez dział rozwoju i produkcji.

2024-06-05 13:22

Łukasz

Dzień dobry,
lista zmiennych jest bardzo bogata, ale miło by było, gdyby programiści w kodzie na GitHubie dodawali komentarze do tego co piszą, a nie podawali tylko parametry bez słowa komentarza.

Dlaczego marudzę?
Bo próbuję dojść, czy da się zrobić następujący warunek (piszę to konceptualnie, niezgodnie ze składnią, bo chcę wyjaśnić o co mi chodzi.

IF outstanding != 0 zł 0 gr
THEN bank_account
ELSE nic nie wyświetlaj

Czy da się to zrobić?

2024-09-02 20:00

Łukasz

To jeszcze raz ja, bo już ogarnąłem ;)

{{#if status_paid}}
Faktura jest już opłacona.
{{else}}
Faktura nieopłacona. Do zapłaty pozostaje {{outstanding}} (słownie: {{absolute_outstanding_in_words}}).
{{/if}}

2024-09-02 20:21

milenasz

Odpowiedź główna Dzień dobry,

dziękujemy za informację, że wskazany we wcześniejszej wiadomości warunek udało się określić w oparciu o zmienne wskazane w artykule.

W przypadku dodatkowych pytań pozostaję do dyspozycji.

Pozdrawiam
Milena

2024-09-03 13:08

ewelinarychlik

Odpowiedź główna Dzień dobry,

można użyć zmiennych zgodnie z naszą dokumentacją API

  "use_delivery_address": "1" lub "0", jeśli "1" wówczas można podać inny adres korespondencyjny w parametrze "delivery_address"
    "delivery_address": "" - inny adres korespondencyjny

Jeśli chodzi o konfigurację integracji z Woocommerce to nie ma tu takiej opcji.

2024-10-03 12:13

Jakich zmiennych można użyć podczas wysyłania dokumentów e-mailem?

Komentarze

Dodaj komentarz

Najnowsze