## 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
### Přehled platebních bloků
- `{{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.