Tato nápověda je pro obsah děkovací stránky FAPI v poli thanks_content prodejního formuláře a pro vlastní děkovací stránku. Po dokončení objednávky FAPI automaticky nahradí symboly údaji právě vytvořené objednávky.
Nejdříve zvolte, kam chcete symbol vložit
| Kde symbol používáte | Syntaxe | Příklad |
|---|---|---|
| Interní děkovací stránka FAPI | dvě dvojice závorek | {{number}} |
| E-mailová šablona nebo upomínka | jedna dvojice závorek | {invoiceNumber} |
Výjimkou jsou produktové podmínky: i na děkovací stránce používají jednu dvojici závorek, například {item-EBOOK}...{/item-EBOOK}.
Pozor: Interní děkovací stránka není e-mail. Symboly mezi těmito místy nezaměňujte; e-mailový postup popisuje článek Zástupné symboly v e-mailových šablonách a upomínkách.
Tato část platí pouze pro obsah interní děkovací stránky FAPI, tedy pro pole thanks_content .
Na interní děkovací stránce FAPI používejte zástupné symboly se dvěma dvojicemi závorek, například:
{{number}}
FAPI zde objednávku zná automaticky. Nepřidávejte proto SDK script ani identifikátor objednávky do URL.
Na interní děkovací stránce vybírejte symboly z aktuální nabídky podle skupin:
- Objednávka,
- Platba,
- Zákazník,
- Produkt,
- Podmíněný obsah,
- Ostatní.
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 <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 nabídce Prodej → Produkty v levém sloupci Kód.
Například {{items.0.name}}vypíše název první zakoupené položky.
{{items}}– JSON* pole zakoupených položek{{itemList}}– seznam zakoupených položek{{items.<index>}}– jedna zakoupená položka na daném indexu ve formátu JSON*{{items.<index>.name}}– název zakoupené položky{{items.<index>.code}}– kód zakoupeného produktu{{items.<index>.count}}– množství zakoupené položky{{items.<index>.type}}– typ zakoupené položky{{items.<index>.vat}}– sazba DPH zakoupené položky{{items.<index>.unitPrice}}– jednotková cena bez DPH{{items.<index>.unitPriceIncDph}}– jednotková cena včetně DPH{{subscriptionId}}– ID předplatného{{subscriptionQrCode}}– QR kód předplatného
Podmíněný obsah
{item-<kód_produktu>}...{/item-<kód_produktu>}– obsah se zobrazí pouze tehdy, když objednávka obsahuje produkt s daným kódem. Produktové bloky mají jednu dvojici závorek; stavové a platební bloky na děkovací stránce mají dvě.
Blok se zobrazí jen kupujícímu, jehož objednávka obsahuje produkt s kódem EBOOK. Vložte do něj text určený pro tento produkt.
{item-EBOOK}
<p>Děkujeme za nákup e-booku.</p>
{/item-EBOOK}
Ostatní
{{formName}}– název prodejního formuláře{{userName}}– jméno dodavatele{{customFields}}– JSON* pole vyplněných vlastních polí{{customFields.<index>}}– jedno vlastní pole na daném indexu ve formátu JSON*{{customFields.<index>.name}}– název vlastního pole{{customFields.<index>.value}}– hodnota vlastního pole
Podmíněné bloky na děkovací stránce
{{ifPaid}}...{{/ifPaid}}– pouze pokud je faktura zaplacená{{ifIssued}}...{{/ifIssued}}– pouze pokud je faktura vystavená a nezaplacená{{ifCancelled}}...{{/ifCancelled}}– pouze pokud je objednávka stornovaná
Párové bloky vložte na samostatné řádky. Otevírací a zavírací značku ponechte ve stejném formátování. Text mezi nimi vložte do vlastního odstavce.
Bloky nevnořujte.
{{ifPaid}}
<p>Děkujeme, objednávka č. {{number}} je zaplacená.</p>
{{/ifPaid}}
{{ifIssued}}
<p>Objednávka č. {{number}} čeká na úhradu. Zaplatit můžete zde: <a href="{{orderStatusPage}}">Přejít na přehled objednávky</a>.</p>
{{/ifIssued}}
{item-EBOOK}
<p>Odkaz ke stažení e-booku zobrazte zde.</p>
{/item-EBOOK}
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
pathv 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:
<script src="https://web.fapi.cz/js/sdk/fapi.js"></script>
FAPI k URL přidá parametr path . Podle něj SDK načte data objednávky a zástupné symboly nahradí.
Parametr pathnemažte, nepřejmenovávejte, nevytvářejte ručně a odkaz s tímto parametrem nikomu neposílejte.
<p style="text-align: center;"><a href="{{orderStatusPage}}">Zaplatit online</a></p>
<p style="text-align: center;"><a href="{{orderStatusPage}}">Zaplatit online</a></p>
<p style="text-align: center;"><a href="{{orderStatusPage}}">Zaplatit online</a></p>
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.