Kā veikt dokumentu izpildi un grāmatošanu REST?

[#1]

Horizon dokumentiem, kuri ietekmē virsgrāmatu, pārsvarā ir 3 statusi - Sagatave, Izpildīts un Grāmatots. Izveidojot dokumentu tas ir statusā Sagatave. Pēc tam tos nepieciešams izpildīt un grāmatot, dažkārt to iespējams veikt arī integrācijas sistēmai.

Statusa nomaiņa tiek veikta konkrētā dokumenta entītes resursā. 

Lai nodrošinātu, ka neviens cits lietotājs nav paralēli veicis darbības ar dokumentu, nepieciešams noskaidrot aktuālo dokumenta counter vērtību. To iespējams izdarīt konkrēto dokumentu atlasot pēc ID. Piemērs ar ienākošo maksājumu.

GET
/rest/TDdmInMu/591 (maksājuma ID)

Atbilde 
<description>Entītijas ieraksts</description>
    <title>234654</title>
    <entity xmlns="TDdmInMu.xsd" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="TDdmInMu.xsd TDdmInMu.xsd">
        <PK_DOKT>
            <href>/rest/TdmDocType/10</href>
        </PK_DOKT>
        <PAMV_ID>3306</PAMV_ID>
        <COUNTER>0</COUNTER>
        <PK_DOK>
            <href rel="self">/rest/TDdmInMu/591</href>
        </PK_DOK>
.....

Dokumentu izpildīšana

Dokumenta izpildi iespējams veikt ar metodi ExecuteFromKey

Piemērs ienākošajam maksājumam, kura resurss ir TDdmInMu.

POST ../rest/TDdmInMu/ExecuteFromKey

<resource>
<aKey>591</aKey>
<CounterVal>0</CounterVal>
<GramDate>2020-09-01</GramDate>
</resource>

aKey - dokumenta ID

CounterVal - akutālā counter vērtība

GramDate - izpildes datums

Dokumenta grāmatošana

Dokumenta izpildi iespējams veikt ar metodi BookFromKey

Piemērs ienākošajam maksājumam, kura resurss ir TDdmInMu.

POST .../rest/TDdmInMu/BookFromKey

<resource>
<aKey>591</aKey>
<CounterVal>1</CounterVal>
<aSchemaPk>1125</aSchemaPk>
<DeleteDraft>1</DeleteDraft>
</resource>

aKey - dokumenta ID

CounterVal - akutālā counter vērtība

aSchemaPk - kontēšanas shēmas ID (kontēšanas shēmu saraksts nav pieejamas REST API)

DeleteDraft - 1 (kontējums tiks veidots pēc norādītās kontēšanas shēmas)