Pomocou REST API je možné vytvoriť faktúru zo záloh uhradených bankou, pokladňou alebo vzájomným zápočtom.
Ide o obdobu služby "Vytvoriť faktúru zo zálohy" nad vydanými či prijatými faktúrami. Rozdiel je len v tom, že z pozície desktopovej aplikácie spúšťate službu nad danou faktúrou. Tu, pri funkcii v API, potrebujete naopak identifikátor platby.
Postup môže byť považovaný za rýchlejší v porovnaní s funkciou pre odpočet zálohy alebo ZDD. Nepotrebujete tu identifikátor zálohy, ale identifikátor platby.
Ako funguje funkcia na vytvorenie faktúry zo záloh?
Základ tela požiadavky vyzerá rovnako ako pri ktorejkoľvek inej faktúre. Uvádzajú sa v ňom povinné aj voliteľné vlastnosti, ako sú typDokl, cisDosle, datSplat. Všetky tieto dostupné vlastnosti nájdete v tzv. evidence liste.
API službu <vytvorZUhrazenychZaloh> je možné použiť iba pre rovnaké typy pohybu.
v opačnom prípade volanie končí chybou 400: "Typ pohybu zálohy (Výdaj) musí byť rovnaký ako typ pohybu nového dokladu (Príjem)."
API službu <vytvorZUhrazenychZaloh> je možné použiť iba pri novo vytváraných dokladoch.
v opačnom prípade volanie končí chybou 400: "Akcia "vytvorZUhrazenychZaloh" nie je povolená na existujúcich dokladoch.
Do elementu vytvorZUhrazenychZaloh je potom nutné uviesť uhrazujiciDokl na identifikáciu dokladu, ktorým bola záloha uhradená.
<vytvorZUhrazenychZaloh>
<uhrazujiciDokl>code:B+0005/2022</uhrazujiciDokl>
</vytvorZUhrazenychZaloh>
Je taktiež potrebný element uhrazujiciEvidence na identifikáciu evidencie (v tomto prípade je možné vyberať z banka, pokladna, vzajemny-zapocet), do ktorej tento doklad patrí.
<vytvorZUhrazenychZaloh>
<uhrazujiciDokl>code:B+0005/2022</uhrazujiciDokl>
<uhrazujiciEvidence>banka</uhrazujiciEvidence>
</vytvorZUhrazenychZaloh>
Kompletný príklad vytvorenia vydanej faktúry zo záloh uhradených bankou môže vyzerať takto:
<winstrom version="1.0">
<faktura-vydana>
<typDokl>code:FAKTURA</typDokl>
<cisDosle>123</cisDosle>
<datSplat>2022-01-17</datSplat>
<vytvorZUhrazenychZaloh>
<uhrazujiciDokl>code:B+0005/2022</uhrazujiciDokl>
<uhrazujiciEvidence>banka</uhrazujiciEvidence>
</vytvorZUhrazenychZaloh>
</faktura-vydana>
</winstrom>
Príklad vytvorenia prijatej faktúry zo záloh uhradených pokladňou vyzerá takto:
<winstrom version="1.0">
<faktura-prijata>
<typDokl>code:FAKTURA</typDokl>
<cisDosle>123</cisDosle>
<datSplat>2022-01-17</datSplat>
<vytvorZUhrazenychZaloh>
<uhrazujiciDokl>code:P-0001/2022</uhrazujiciDokl>
<uhrazujiciEvidence>pokladni-pohyb</uhrazujiciEvidence>
</vytvorZUhrazenychZaloh>
</faktura-prijata>
</winstrom>
Poznámka:
Zálohy s výrobnými číslami momentálne API nepodporuje.