Přes REST API lze rozeslat výplatní pásky e-mailem. Které mzdy se mají odeslat, určuje filtr v URL; pásky jdou na e-mailové adresy, které mají zaměstnanci uvedené v personalistice na záložce Adresa jako kontaktní.
Předpoklady
Na serveru je nastavené připojení k SMTP serveru.
Existuje uživatelská e-mailová šablona, která má na záložce Použití zvolené použití pro aktualizaci mezd, a na záložce Nastavení vyplněného odesílatele a předmět.
Zaměstnanci mají v personalistice vyplněný kontaktní e-mail.
Celé nastavení včetně Freemarker proměnných pro šablonu popisuje článek Zasílání výplatních pásek přes SMTP.
Sestavení URL
Služba je subevidencí automaticky-odeslat nad evidencí mzda a volá se metodou PUT nebo POST. Do kulatých závorek patří filtr, který vybere mzdy k odeslání:
PUT https://demo.flexibee.eu/c/demo/mzda/(rok="2019" and mesic in ("1","2","3") and osbCis = "1")/automaticky-odeslat.xml?jeden-mail-prijemci=true
Ve filtru se nejčastěji používají vlastnosti evidence mzda: rok, mesic a osbCis (osobní číslo zaměstnance). Filtr je povinný — bez něj by šlo o výběr všech mezd v databázi.
🚨 Volání skutečně rozešle e-maily zaměstnancům a nemá testovací režim. Před spuštěním si proto vždy ověřte, které mzdy filtr vybere — stejný filtr stačí poslat metodou GET na /c/{firma}/mzda/(…).json?detail=custom:rok,mesic,osbCis.
Výsledek
Odpověď má podobu standardního výsledku importu se souhrnem v elementu stats. Pokud filtru neodpovídá žádná mzda, vrací služba 400, success s hodnotou false a varování mzdyNejsouZaznamy:
<?xml version="1.0" encoding="utf-8"?>
<winstrom version="1.0">
<success>false</success>
<stats>
<created>0</created>
<updated>0</updated>
<deleted>0</deleted>
<skipped>0</skipped>
<failed>1</failed>
</stats>
<results>
<result>
<warnings>
<warning messageCode="mzdyNejsouZaznamy">Pro zadaný filtr neexistují mzdy.</warning>
</warnings>
</result>
</results>
</winstrom>