Přes REST API (i webové rozhraní) lze vytvořit a získat mailové šablony pro posílání dokladů a Aktualizaci mezd. Tato evidence je dostupná pouze pro licenci Premium.
Chceme-li získat šablonu, použijeme standardně URL
/c/{firma}/sablona-mail/{id}
.
Lze samozřejmě použít i úroveň detailu.
Pro vytvoření šablony pošleme XML/JSON na URL /c/{firma}/sablona-mail
.
Chceme-li šablonu připojit k typu dokladu (zde konkrétně typ faktury vydané), na výše zmíněné URL pošleme například takovéto XML:
<?xml version="1.0"?>
<winstrom version="1.0">
<typ-faktury-vydane>
<kod>{kod}</kod>
<nazev>FAV se šablonou</nazev>
<modul>FAV</modul>
<radaPrijem>code:FAKTURA-STANDARD</radaPrijem>
<typDoklK>typDokladu.faktura</typDoklK>
<sablonaMail> {text-sablony} </sablonaMail>
<poznam>Šablona pro faktury vydané</poznam>
</typ-faktury-vydane>
</winstrom>
Příklad šablony a Freemarker proměnné
Využívá se šablonovací systém FreeMarker.
Před uložením šablony program zkontroluje, zda šablona neobsahuje nepovolené výrazy.
V šablonách je možné použít následující proměnné:
${application} – Název aplikace, tedy „ABRA Flexi“
${user} – Objekt uživatele, se kterým můžeme dále pracovat
${company} – Nastavení firmy
${uzivatelJmeno} – Vaše křestní jméno
${uzivatelPrijmeni} – Vaše příjmení
${titulJmenoPrijmeni} – Vaše celé jméno, včetně dosažených titulů
${nazevFirmy} – Název firmy
${object} – Obecný přístup na předávaný objekt
${doklad} – Doklad určený k odeslání
Příklad použití těchto proměnných v šabloně
Dobrý den, zasílám Vám doklad ${doklad}, jehož interní číslo je ${doklad.kod}. Jmenuji se ${uzivatelJmeno} ${uzivatelPrijmeni}, včetně mého titulu ${titulJmenoPrijmeni}, pracuji pro ${nazevFirmy}. Mé telefonní číslo je ${user.mobil}, DIČ firmy je ${company.dic}.