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 v tom, že z pozície desktopovej aplikácie službu spúšťate nad danou faktúrou — tu, pri funkcii v API, potrebujete naopak identifikátor platby.
Postup môže byť považovaný za rýchlejší oproti funkcii na odpočet zálohy alebo ZDD. Nepotrebujete tu identifikátor zálohy, ale identifikátor platby.
Ako funkcia funguje
Základ tela požiadavky vyzerá rovnako ako pri ktorejkoľvek inej faktúre. Uvádzajú sa doňho povinné aj voliteľné vlastnosti, ako je typDokl, cisDosle alebo datSplat. Všetky dostupné vlastnosti nájdete v tzv. evidence listu.
Do elementu <vytvorZUhrazenychZaloh> je nutné uviesť uhrazujiciDokl na identifikáciu dokladu, ktorým bola záloha uhradená:
<vytvorZUhrazenychZaloh>
<uhrazujiciDokl>code:B+0005/2022</uhrazujiciDokl>
</vytvorZUhrazenychZaloh>
Je tiež potrebný element uhrazujiciEvidence na identifikáciu evidencie, do ktorej tento doklad patrí. Vyberať možno z banka, pokladni-pohyb a vzajemny-zapocet:
<vytvorZUhrazenychZaloh>
<uhrazujiciDokl>code:B+0005/2022</uhrazujiciDokl>
<uhrazujiciEvidence>banka</uhrazujiciEvidence>
</vytvorZUhrazenychZaloh>
🚨 Evidencia pokladne sa v tomto elemente volá pokladni-pohyb, nie pokladna. Element je povinný a pri chybnej alebo chýbajúcej hodnote volanie skončí chybou 400 s kódom akceEvidenceList: „Akce je dostupná pro evidence: banka, pokladni-pohyb, vzajemny-zapocet."
Obmedzenia služby
Službu je možné použiť iba pre rovnaké typy pohybu. V opačnom prípade volanie skončí chybou
400: „Typ pohybu zálohy (Výdej) musí být stejný jako typ pohybu nového dokladu (Příjem)."Službu je možné použiť iba pri novo vytváraných dokladoch. V opačnom prípade volanie skončí chybou
400: „Akce „vytvorZUhrazenychZaloh" není povolena na existujících dokladech."Zálohy s výrobnými číslami API v súčasnosti nepodporuje.
Kompletné príklady
Vytvorenie vydanej faktúry zo záloh uhradených bankou:
<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>
Vytvorenie prijatej faktúry zo záloh uhradených pokladňou:
<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>