Preskoči na glavno vsebino

Zamykanie dokladov cez API

Akcie lock, unlock a lock-for-ucetni — a prečo odomknutie a úpravu nemožno spojiť

Avtor: Petr Pech

Jednotlivé doklady je možné cez API zamknúť proti zmenám — a rovnako aj odomknúť. Slúžia na to akcie nad evidenciou dokladu.


Akcie

Akcia

Čo robí

lock

Zamkne záznam.

lock-for-ucetni

Zamkne záznam pre účtovníka.

unlock

Odomkne záznam.

Zápis je bežný import s atribútom action:

<winstrom version="1.0">
<faktura-vydana action="lock">
<id>123</id>
</faktura-vydana>
</winstrom>

Akciu je možné spustiť aj hromadne nad skupinou záznamov určenou filtrom:

<winstrom version="1.0">
<faktura-vydana action="lock"
filter="stavUhrK = 'stavUhr.uhrazeno' and typDokl = 'code:INTERNET'">
</faktura-vydana>
</winstrom>


Zmena zamknutého dokladu

Pokus o úpravu zamknutého záznamu skončí chybou:

Záznam je zamčený.

🚨 Odomknutie a úpravu nie je možné spojiť do jedného požiadavku. Ak pošlete action="unlock" a zároveň zmenené vlastnosti, server odpovie success=true, ale zmeny zahodí — prejaví sa iba odomknutie. Rozdeľte preto operáciu na dva samostatné požiadavky: najprv odomknúť, potom upraviť.


Doklad v zamknutom období

Zámok dokladu je niečo iné ako zámok obdobia. Doklad do zamknutého obdobia nie je možné vložiť, kým zámok neprepnete na zamek.otevreno — postup popisuje článok Zamykanie období cez REST API.


Súvisiace

Ste s tem dobili odgovor na svoje vprašanje?