--- title: Zástupné symboly v e-mailových šablonách a upomínkách url: /article/335-zastupne-symboly-v-e-mailovych-sablonach-a-upominkach description: 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-mailo category: Online prodej categorySlug: 9-online-prodej categorySlugs: - 9-online-prodej keywords: - Zástupné symboly v e-mailových šablonách a upomínkách - Online prodej sourceUrl: https://napoveda.fapi.cz/article/335-zastupne-symboly-v-e-mailovych-sablonach-a-upominkach order: 282 updatedAt: 2026-10-30T11:29:29.798Z legacyAnchors: - id: Nejdve-zvolte-kam-chcete-symbol-vloit-NJ6gB tag: h2 text: Nejdříve zvolte, kam chcete symbol vložit occurrence: 0 headingIndex: 0 - id: Jak-symbol-vloit-oG97g tag: h2 text: Jak symbol vložit occurrence: 0 headingIndex: 1 - id: Faktura-eOuFk tag: h2 text: Faktura occurrence: 0 headingIndex: 2 - id: Platba-UqE7v tag: h2 text: Platba occurrence: 0 headingIndex: 3 - id: Podmnn-bloky-platbu-v-e-mailech-NKysM tag: h3 text: Podmíněné bloky platbu v e-mailech occurrence: 0 headingIndex: 4 - id: Zkaznk-ZgEkK tag: h2 text: Zákazník occurrence: 0 headingIndex: 5 - id: Produkt-G36DO tag: h2 text: Produkt occurrence: 0 headingIndex: 6 - id: Podmnn-obsah-yW8KB tag: h2 text: Podmíněný obsah occurrence: 0 headingIndex: 7 - id: Dodavatel-2rpvu tag: h2 text: Dodavatel occurrence: 0 headingIndex: 8 - id: Vlastn-pole-aCfRa tag: h2 text: Vlastní pole occurrence: 0 headingIndex: 9 - id: Nejastj-chyby-ovJAl tag: h2 text: Nejčastější chyby occurrence: 0 headingIndex: 10 - id: Symbol-se-nezobrazil-nebo-se-nenahradil-nZp9E tag: h2 text: Symbol se nezobrazil nebo se nenahradil occurrence: 0 headingIndex: 11 - id: V-e-mailu-se-nezobrazil-symbol-z-dkovac-strnky-unZxG tag: h2 text: V e-mailu se nezobrazil symbol z děkovací stránky occurrence: 0 headingIndex: 12 - id: Na-vlastn-dkovac-strnce-se-data-objednvky-nenaetla-xW2Jx tag: h2 text: Na vlastní děkovací stránce se data objednávky nenačetla occurrence: 0 headingIndex: 13 - id: Shrnut-4UX7B tag: h2 text: Shrnutí occurrence: 0 headingIndex: 14 redirects: [] --- 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. Nastavení sad a pravidla odesílání zpráv popisuje návod Odesílání e-mailů z FAPI přes šablony zpráv. ## 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 1. Otevřete **Prodej →** **Šablony zpráv** nebo **Šablony upomínek** a upravte příslušnou šablonu. 2. Umístěte kurzor do předmětu nebo obsahu e-mailu. 3. Klikněte na tlačítko **Zástupné symboly** a zvolte skupinu, ve které hledaný údaj najdete. ![Zástupné symboly v e-mailových šablonách a upomínkách](/assets/articles/c74106fde5f7a189.png) **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. ![Zástupné symboly v e-mailových šablonách a upomínkách](/assets/articles/dd6aad09d43615de.png) 1. 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 primárního platebního QR kódu - `{qrCodes}` – všechny relevantní formáty platebního QR kódu pro danou platbu; pokud je dostupných více formátů, první je označený jako doporučený ### Podmíněné bloky pro 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 - `{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; v HTML těle e-mailu také odkazy na soubory těchto produktů po zaplacení - `{itemsList}` – zakoupené položky včetně množství na samostatných řádcích; v HTML těle e-mailu také odkazy na jejich produktové soubory po zaplacení - `{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 Produktové soubory se přes `{items}` a `{itemsList}` zpřístupní jen u zaplacené, nestornované objednávky a zakoupeného produktu s kladným množstvím. Symbol vložte **přímo do těla e-mailu**, nikoli do pole URL odkazu. Odkazy můžete doručit běžným **E-mailem při zaplacení objednávky** bez další akce. Postup najdete v návodu Odesílání e-booků a dalších souborů. Nezaměňujte je se soubory vloženými přímo do šablony pomocí `{file:}` ani se symboly děkovací stránky. ## Podmíněný obsah Místo `` 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 nabídce **Prodej →** Produkty v levém sloupci **Kód**. ![Zástupné symboly v e-mailových šablonách a upomínkách](/assets/articles/9b00647553fd1740.png) - `{item-}...{/item-}`        – obsah se zobrazí pouze tehdy, když objednávka obsahuje produkt s daným kódem. :::info **Příklad:** ::: ```text {item-EBOOK}

Děkujeme za nákup. Odkaz ke stažení e-booku najdete zde: Stáhnout e-book.

{/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:}` – hodnota vlastního pole faktury se zadaným číselným ID. Místo `` vložte číselné ID konkrétního vlastního pole, například `{customField:123}`       . - `{file:}` – zabezpečený odkaz ke stažení souboru šablony se zadaným číselným ID. Místo `` vložte číselné ID souboru připojeného k dané šabloně, například `{file:123}`       . - `{}` – vlastní symbol předaný jako dvojice klíč–hodnota přes endpoint, který vlastní symboly podporuje; `` nahraďte předaným klíčem. :::tip 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. ::: :::danger # 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.