Zástupné symboly v e-mailových šablonách a upomínkách

Zástupný symbol při odeslání e-mailu nahradí konkrétním údajem z faktury, objednávky, platby, zákazníka nebo produktu. Použijete jej v předmětu i obsahu e-mailové šablony nebo upomínky.

Nejdříve zvolte, kam chcete symbol vložit

Kde symbol používáte	Syntaxe	Příklad
E-mailová šablona nebo upomínka	jedna dvojice závorek	`{invoiceNumber}`
Interní děkovací stránka FAPI	dvě dvojice závorek	`{{number}}`

Pozor: Symboly pro e-mail a interní děkovací stránku mezi sebou nezaměňujte. Pro interní děkovací stránku používejte symboly se dvěma dvojicemi závorek.

Jak symbol vložit

Otevřete Prodej → Šablony zpráv nebo Šablony upomínek a upravte příslušnou šablonu.
Umístěte kurzor do předmětu nebo obsahu e-mailu.
Klikněte na tlačítko Zástupné symboly a zvolte skupinu, ve které hledaný údaj najdete.

Na výběr máte několik sekcí zástupných symbolů:

Faktura,
Platba,
Zákazník,
Produkt,
Podmíněný obsah,
Dodavatel,
Vlastní pole.

Vybraný symbol nechte jako jeden nepřerušený celek. Uvnitř značky nepřidávejte mezeru ani zalomení řádku a neformátujte jen její část.

Jednoduchý symbol může být přímo ve větě: Děkujeme za objednávku č. {invoiceNumber}.

Před použitím u zákazníků proveďte testovací objednávku. Náhled e-mailu nemusí věrně nasimulovat odkazy na soubory, vouchery ani podmíněný obsah.

Faktura

{invoiceNumber} – číslo faktury
{variableSymbol} – variabilní symbol
{amount} – fakturovaná částka včetně měny
{amountWithoutVat} – částka bez DPH včetně měny
{createDate} – datum vystavení ve formátu d. m. Y
{payDayDate} – datum splatnosti ve formátu d. m. Y
{pdf} – odkaz ke stažení PDF faktury
{pdfPrinterFriendly} – odkaz ke stažení tiskové verze PDF faktury
{project} – název projektu
{shipping} – způsob dopravy včetně výdejního místa, pokud je dostupné
{packetTrackingLink} – odkaz na sledování zásilky
{cancellationReason} – důvod storna
{paymentType} – lokalizovaný způsob platby
{repaymentNumber} – číslo splátky
{countOfRepayments} – počet splátek

Platba

{orderStatusPage} – přehled objednávky a odkaz na online platbu
{bankAccountName} – název bankovního účtu dodavatele
{bankAccount} – číslo bankovního účtu dodavatele
{iban} – IBAN dodavatele
{swift} – BIC/SWIFT dodavatele
{qrCode} – obrázek platebního QR kódu

Podmíněné bloky platbu v e-mailech

{ifCash}...{/ifCash} – pouze pro platbu v hotovosti
{ifWire}...{/ifWire} – pouze pro platbu bankovním převodem
{ifCreditCard}...{/ifCreditCard} – pouze pro platbu kartou
{ifCollectOnDelivery}...{/ifCollectOnDelivery} – pouze pro dobírku
{ifSms}...{/ifSms} – pouze pro platbu SMS
{ifPaypal}...{/ifPaypal} – pouze pro platbu přes PayPal
{ifGopay}...{/ifGopay} – pouze pro platbu přes GoPay
{ifWireGopay}...{/ifWireGopay} – pouze pro bankovní převod přes GoPay
{ifBitcoin}...{/ifBitcoin} – pouze pro platbu Bitcoinem
{ifGpay}...{/ifGpay} – pouze pro platbu přes Google Pay
{ifBarter}...{/ifBarter} – pouze pro barterovou platbu
{ifTwisto}...{/ifTwisto} – pouze pro platbu přes Twisto
{ifApplePay}...{/ifApplePay} – pouze pro platbu přes Apple Pay
{ifSkippay}...{/ifSkippay} – pouze pro platbu přes Skip Pay
{ifQrCode}...{/ifQrCode} – pouze pro platbu QR kódem
{ifKlarna}...{/ifKlarna} – pouze pro platbu přes Klarna
{ifNotCollectOnDelivery}...{/ifNotCollectOnDelivery} – pouze pro platby jiné než dobírka

Zákazník

{vocativeName} – jméno zákazníka v 5. pádě
{vocativeSurname} – příjmení zákazníka v 5. pádě
{vocativeFullName} – celé jméno zákazníka v 5. pádě
{clientFirstName} – fakturační jméno zákazníka
{clientLastName} – fakturační příjmení zákazníka
{clientName} – fakturační jméno zákazníka
{fullName} – celé jméno zákazníka
{clientEmail} – e-mail zákazníka
{clientPhone} – telefon zákazníka
{company} – firma zákazníka
{clientIc} – IČ zákazníka
{clientDic} – DIČ zákazníka
{clientIcDph} – slovenské IČ DPH zákazníka
{clientAddress} – fakturační adresa zákazníka
{shippingAddress} – doručovací adresa zákazníka
{notes} – poznámka zákazníka k objednávce
{clientId} – ID zákazníka

Produkt

{items} – názvy zakoupených položek včetně množství, oddělené čárkami
{itemsList} – zakoupené položky včetně množství jako HTML seznam
{voucherCodes} – kódy voucherů
{voucherQrCodes} – samostatné QR kódy voucherů
{voucherQrCodeAllInOne} – jeden QR kód obsahující všechny vouchery
{vouchersList} – vouchery jako HTML seznam
{voucherExpirations} – data expirace voucherů
{subscriptionId} – ID předplatného
{subscriptionQrCode} – QR kód předplatného

Podmíněný obsah

Místo <kód_produktu> vložte kód produktu, nikoli jeho ID. Velikost písmen se nerozlišuje a bloky nevnořujte. Kód produktu najdete ve FAPI v kartě Prodej > Produkty, levý sloupec kód.

{item-<kód_produktu>}...{/item-<kód_produktu>} – obsah se zobrazí pouze tehdy, když objednávka obsahuje produkt s daným kódem.

Příklad:

{item-EBOOK}<p>Děkujeme za nákup. Odkaz ke stažení e-booku najdete zde: <a href="{file:123}">Stáhnout e-book</a>.</p>{/item-EBOOK}

Blok se zobrazí jen kupujícímu, jehož objednávka obsahuje produkt s kódem EBOOK . Číslo 123 v {file:123} nahraďte ID souboru připojeného k e-mailové šabloně.

Dodavatel

{userName} – fakturační jméno dodavatele
{userEmail} – e-mail dodavatele
{userPhone} – telefon dodavatele
{userWeb} – web dodavatele

Vlastní pole

{customFieldsList} – vyplněná vlastní pole jako HTML seznam
{customField:<ID>} – hodnota vlastního pole faktury se zadaným číselným ID. Místo <id> vložte číselné ID konkrétního vlastního pole, například {customField:123} .
{file:<ID>} – zabezpečený odkaz ke stažení souboru šablony se zadaným číselným ID. Místo <ID> vložte číselné ID souboru připojeného k dané šabloně, například {file:123} .
{<key>} – vlastní symbol předaný jako dvojice klíč–hodnota přes endpoint, který vlastní symboly podporuje; <key> nahraďte předaným klíčem.

Před ostrým odesláním doporučujeme šablonu otestovat na skutečné objednávce.

Náhled nemusí vždy věrně nasimulovat odkazy na soubory, vouchery ani podmíněný obsah.

Nejčastější chyby

Symbol se nezobrazil nebo se nenahradil

Zkontrolujte, zda:

používáte správnou syntaxi pro dané místo,
symbol není rozdělený mezerou, zalomením řádku nebo formátováním,
používáte symbol dostupný pro daný kontext,
u vlastní děkovací stránky funguje SDK a parametr path .

V e-mailu se nezobrazil symbol z děkovací stránky

E-mailové šablony a děkovací stránka používají odlišnou syntaxi.

Do e-mailu patří například:

{invoiceNumber}

Na děkovací stránku patří například:

{{number}}

Na vlastní děkovací stránce se data objednávky nenačetla

Zkontrolujte, zda:

stránka běží na HTTPS,
je vložený FAPI SDK script,
ve formuláři je zapnuté vložení identifikátoru objednávky do URL,
v URL zůstal zachovaný parametr path .

Shrnutí

Zástupné symboly vždy vybírejte podle toho, kde je chcete použít.

Pro e-mailové šablony a upomínky používejte symboly s jednou dvojicí závorek, například {invoiceNumber} .

Pro interní děkovací stránku FAPI používejte symboly se dvěma dvojicemi závorek, například {{number}} .

Pro vlastní externí děkovací stránku je potřeba navíc HTTPS, FAPI SDK script a zachovaný parametr path .

Před ostrým použitím doporučujeme vše otestovat na skutečné objednávce.