Přeskočit na hlavní obsah

Zamykání období přes REST API

Jak zamknout období v API Flexi?

Autor: Petr Pech

Zámky účetních období jsou v API dostupné jako evidence zamek. Lze je číst i zakládat, takže zamykání období se dá zautomatizovat stejně jako v desktopové aplikaci.


Čtení zámků

GET /c/{firma}/zamek.xml?detail=full&limit=0

Každý zámek popisují tři skupiny údajů:

Pole

Význam

zamekK

Stav zámku — zamek.otevreno, zamek.polozamceno (zamknuto mimo účetní) nebo zamek.zamceno.

platiOdData, platiDoData

Období, na které se zámek vztahuje.

modulFav, modulFap, modulBan, modulSkl, …

Moduly, kterých se zámek týká. Každý modul má vlastní logické pole, takže lze zamknout třeba jen vydané faktury.


Založení zámku

<winstrom version="1.0">
<zamek>
<zamekK>zamek.zamceno</zamekK>
<platiOdData>2024-03-01</platiOdData>
<platiDoData>2024-03-31</platiDoData>
<modulFav>true</modulFav>
</zamek>
</winstrom>

Stav existujícího zámku změníte běžnou aktualizací — stačí uvést id a nový zamekK. Zámek lze i smazat atributem action="delete".


Co zámek způsobí

Pokus založit doklad s datem uvnitř zamčeného období skončí chybou:

Doklad nelze vložit do zamčeného období.

ℹ️ Zámek platí jen pro moduly, které v něm mají nastaveno true. Je-li zamčený modul vydaných faktur, bankovní doklad se stejným datem se založí bez problémů. Stav zamek.polozamceno doklad běžnému uživateli rovněž nepustí.

💡 Potřebujete-li doklad do zamčeného období opravdu vložit, přepněte zámek na zamek.otevreno, doklad založte a zámek vraťte zpět — obojí jde přes API.


Související

Dostali jste odpověď na svou otázku?