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:
## Objednávka
- `{{number}}` – číslo objednávky
- `{{totalAmount}}` – celková částka
- `{{totalAmountIncVat}}` – celková částka včetně DPH
- `{{totalAmountWithoutShipping}}` – celková částka bez dopravy
- `{{totalAmountWithoutShippingIncVat}}` – celková částka včetně DPH bez dopravy
- `{{vatAmount}}` – částka DPH
- `{{currencyCode}}` – kód měny
- `{{exchangeRate}}` – směnný kurz
- `{{statusTranslated}}` – lokalizovaný stav faktury
- `{{shippingMethod}}` – zvolený způsob dopravy
- `{{discountCode}}` – použitý slevový kód
- `{{clientsNote}}` – poznámka zákazníka k objednávce
- `{{orderStatusPage}}` – odkaz na přehled objednávky
- `{{paid}}` – informace, zda je faktura zaplacená
- `{{cancelled}}` – informace, zda je objednávka stornovaná
- `{{status}}` – surový stav faktury
- `{{createDate}}` – datum vystavení faktury
- `{{paidOn}}` – datum zaplacení faktury
## Platba
- `{{paymentMethod}}` - zvolená platební metoda
- `{{bankAccountName}}` – název bankovního účtu dodavatele
- `{{iban}}` – IBAN dodavatele
- `{{swift}}` – BIC/SWIFT dodavatele
- `{{accountNumber}}` – číslo bankovního účtu dodavatele
- `{{qrCodeImage}}` – obrázek platebního QR kódu
- `{qrCodePath}}` – identifikátor platebního QR kódu
- `{{qrCodeUrl}}` – URL platebního QR kódu
### Podmíněné bloky pro platbu v děkovací stránce
- `{{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
- `{{customerInvoiceEmail}}` – e-mail zákazníka
- `{{customerInvoicePhone}}` – telefon zákazníka
- `{{customerInvoiceAddressName}}` – jméno na fakturační adrese
- `{{customerInvoiceAddressStreet}}` – ulice fakturační adresy
- `{{customerInvoiceAddressCity}}` – město fakturační adresy
- `{{customerInvoiceAddressZip}}` – PSČ fakturační adresy
- `{{customerInvoiceAddressCountry}}` – stát fakturační adresy
- `{{customerInvoiceAddressIc}}` – IČ zákazníka
- `{{customerInvoiceAddressDic}}` – DIČ zákazníka
- `{{customerInvoiceAddressIcDph}}` – slovenské IČ DPH zákazníka
- `{{customerShippingAddressName}}` – jméno na doručovací adrese
- `{{customerShippingAddressStreet}}` – ulice doručovací adresy
- `{{customerShippingAddressCity}}` – město doručovací adresy
- `{{customerShippingAddressZip}}` – PSČ doručovací adresy
- `{{customerShippingAddressCountry}}` – stát doručovací adresy
## Produkt
Index je číslovaný od nuly: první položka používá index `0` , druhá index `1`.
Místo `Děkujeme za nákup e-booku.
{/item-EBOOK} ``` ## Ostatní - `{{formName}}` – název prodejního formuláře - `{{userName}}` – jméno dodavatele - `{{customFields}}` – JSON\* pole vyplněných vlastních polí - `{{customFields.Děkujeme, objednávka č. {{number}} je zaplacená.
{{/ifPaid}} {{ifIssued}}Objednávka č. {{number}} čeká na úhradu. Zaplatit můžete zde: Přejít na přehled objednávky.
{{/ifIssued}} {item-EBOOK}Odkaz ke stažení e-booku zobrazte zde.
{/item-EBOOK} ``` :::info První dva bloky zobrazí odpovídající informaci podle stavu objednávky. Třetí blok se zobrazí jen tehdy, pokud objednávka obsahuje produkt s kódem `EBOOK` . ::: :::note **Vysvětlení pro JSON (\*JSON)** Některé zástupné symboly nevypisují jednu jednoduchou hodnotu, ale více údajů najednou **ve formátu JSON.** JSON je technický zápis dat, který slouží hlavně pro další zpracování. Pro běžného zákazníka nemusí být čitelný, proto se obvykle nepoužívá přímo jako text na děkovací stránce. Příklady JSON symbolů: `{{items}}` – vypíše zakoupené položky jako JSON pole `{{customFields}}` – vypíše vyplněná vlastní pole jako JSON pole Pokud chcete zákazníkovi zobrazit konkrétní údaj, doporučujeme použít konkrétní zástupný symbol, ne celý JSON výpis. Například místo: `{{items}}` použijte: `{{items.0.name}}` Tento symbol vypíše název první zakoupené položky. U položek objednávky se používá číslování od nuly: `{{items.0.name}}` – název první položky `{{items.1.name}}` – název druhé položky `{{items.2.name}}` – název třetí položky Stejný princip platí i pro vlastní pole: `{{customFields.0.name}}` – název prvního vlastního pole `{{customFields.0.value}}` – hodnota prvního vlastního pole JSON symboly využijete hlavně tehdy, pokud s daty dál pracujete technicky, například ve vlastním kódu na děkovací stránce. Pokud chcete zobrazit zákazníkovi běžný text, použijte raději konkrétní symbol s názvem nebo hodnotou. ::: :::caution ## Vlastní externí děkovací stránka ::: Vlastní externí děkovací stránka není interní děkovací stránka FAPI. Pokud používáte vlastní děkovací stránku přes `thanks_url` , musí být splněné podmínky pro načtení dat objednávky. Bez nich se zástupné symboly nenahradí. ## Co je potřeba Vlastní děkovací stránka musí: - používat HTTPS, - mít vložené FAPI SDK, - zachovat parametr `path` v URL, - mít ve formuláři zapnuté vložení identifikátoru objednávky do URL. Do patičky vlastní stránky vložte jednou tento script: ```text ``` FAPI k URL přidá parametr `path` . Podle něj SDK načte data objednávky a zástupné symboly nahradí. Parametr `path` nemažte, nepřejmenovávejte, nevytvářejte ručně a odkaz s tímto parametrem nikomu neposílejte. :::caution ## MioWeb a Konverzky Pokud editor platformy nepřijme symbol `{{orderStatusPage}}` přímo do tlačítka nebo odkazu, vložte HTML/Embed element a použijte celý odkaz: ::: ```text ``` :::caution SDK a parametr `path` jsou nutné i v tomto případě. Více podrobný postup je zde: **Mioweb** Na platformě **MioWeb** fungují zástupné symboly, s výjimkou přímého vložení symbolu `{{orderStatusPage}}` do odkazu nebo tlačítka. MioWeb kontroluje vkládané odkazy, proto takto zadaný odkaz na přehled objednávky nefunguje:  Vložte HTML element a do něj tento kód: ::: ```text ``` :::caution  Kód vytvoří funkční odkaz na přehled objednávky. **Konverzky** Na platformě **Konverzky** nelze symbol `{{orderStatusPage}}`vložit přímo do odkazu nebo tlačítka ani přímo vložit platební QR kód, protože Konverzky kontrolují vkládané odkazy:
Vložte Embed komponentu a do ní tento HTML kód:
:::
```text
```
:::caution
Výsledek je kliknutelný odkaz:
:::
:::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.