Przejdź do treści

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

Wyświetleń: 6035 22 min czytania
Personalizuj e-maile z dokumentami w Fakturowni bez ręcznego uzupełniania treści. Dzięki zmiennym w szablonach wiadomości możesz automatycznie wstawiać m.in. numer faktury, kwotę, termin płatności czy link do dokumentu i wysyłać profesjonalne, spójne e-maile za każdym razem.

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

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 zakładce Ustawienia > Ustawienia konta > Wysyłanie e-mailem dla ustawień ogólnych konta. Jeśli chcesz ustalić treść wiadomości dla wybranego działu możesz to zrobić od planu Pro. 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 w artykule wysyłanie faktur e-mailem. Po wybraniu opcji własny szablon e-mail, rubryka z treścią stanie się edytowalna. Możliwość ustawienia własnej treści e-maila w ustawieniach ogólnych konta dostępna jest od planu Start 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 WAŻNE! Zmienna nie jest tłumaczona na język polski. Zalecamy używanie zmiennej {{type_of_payment}}. 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}}  Dodatkowe pole wartość TRUE lub FALSE zmienna zwraca wartość true jeśli na dokumencie podana jest wartość w rubryce ‘Dodatkowe pole’ 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  

Czy ten wpis był pomocny?

Udostępnij

Główna odpowiedź Ewelina Rychlik 2024-06-05 13:22

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

Komentarze (16)

Anonymous 2025-08-21 16:45
Niestety w systemie nie ma możliwości przygotowania wielojęzycznych treści wiadomości za pomocą kodu programistycznego czy warunków typu {% if lang == 'pl' %}. Rozwiązaniem w tym przypadku jest skorzystanie z funkcji osobnej konfiguracji wysyłania e-maili dla działów. Opcja ta jest dostępna w planach Pro oraz Pro Plus i pozwala na: - utworzenie wielu działów firmy np. z podziałem na języki, - wystawianie faktur w danej wersji językowej, - przygotowanie dedykowanej treści wiadomości i ustawienie innego adresu e-mail dla wysyłki z danego działu. Dzięki temu możesz w prosty sposób wysyłać wiadomości w różnych językach. Instrukcja konfiguracji dostępna jest w naszej Bazie Wiedzy: https://pomoc.fakturownia.pl/398042-Osobna-konfiguracja-wysylania-dokumentow-e-mailem Pozdrawiam, Ewelina
Anonymous 2025-08-21 15:49
Próbuję napisać w zależności od języka faktury, ale ciągle bez szans {% if lang == 'pl' %} Dzień dobry, Bardzo dziękujemy za skorzystanie z usług naszego portalu. Uprzejmie informujemy, że faktura została opłacona. Przesyłamy dokument potwierdzający zakup. Z pozdrowieniami, {{{footer}}} {% elsif lang == 'en' %} Hello, Thank you for using our services. We would like to inform you that your invoice has been paid. Please find the purchase confirmation document attached. Best regards, {{{footer}}} {% endif %}
Łukasz Szałajski
Łukasz Szałajski 2025-02-04 16:56 Odpowiedź
Dzień dobry, niestety na liście dostępnych parametrów nie ma takiego kodu. W przypadku pytań pozostaję do dyspozycji. Pozdrawiam, Łukasz
Anonymous 2025-02-04 11:12
Dzień dobry, nie znalazłem kodu do informacji ile dni jest po terminie płatności FV żeby wstawić do ponaglenia - czy istnieje taki kod?
Anonymous 2025-02-03 12:11
Dzień dobry, nie posiadamy takiej zmiennej ani mechanizmu w systemie, który by to wyliczał. Możliwość weryfikacji jest dostępna jedynie na liście wyfiltrowanych dokumentów przeterminowanych dla danego klienta. Pozdrawiam, Ewelina
Anonymous 2025-02-03 09:45
Dzień dobry, jakich zmiennych należy użyć, aby przesłać: - aktualne zadłużenie klienta - tylko przeterminowane zadłużenie klienta?
Ewelina Rychlik
Ewelina Rychlik 2024-10-03 12:13 Odpowiedź
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.
Milena Sztypka 2024-09-03 13:08 Odpowiedź
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
Anonymous 2024-09-02 20:21
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}}
Anonymous 2024-09-02 20:00
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ć?
Ewelina Rychlik
Ewelina Rychlik 2024-06-05 13:22 Główna odpowiedź
Dziękuję za przesłaną sugestię, przekażę tę propozycję do rozpatrzenia przez dział rozwoju i produkcji. 
Anonymous 2024-06-05 11:37
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}?
Anonymous 2024-05-28 09:33
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.
Anonymous 2024-05-28 08:39
Dzień dobry, czy można wykonywać operacje na zmiennych, np {today_date}}-{{payment_to}? Jeśli tak, to jaki jest poprawny zapis?
Anonymous 2024-04-04 12:23
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.
Anonymous 2024-04-03 15:56
Dzień dobry, czym jest zmienna {{legal_cost_compensation}} rekompensata kosztów prawnych ?