Cez REST API je možné prepojiť zálohový daňový doklad (ZDD) s platbou bankového alebo pokladničného dokladu, ktorý uhrádza zálohu.
Nie je však možné ZDD na základe prijatej platby rovno vytvoriť, obdobne ako je to v desktopovej aplikácii. Najprv je potrebné ho vytvoriť a potom vytvoriť väzbu k príslušnej platbe.
ℹ️ Ak chcete ZDD z platby vytvoriť jedným volaním, použite službu vytvorZDD nad bankou alebo pokladňou — pozri Tvorba ZDD přes REST API.
Vytvorenie väzby ZDD
Väzbu medzi ZDD a bankovým dokladom vytvoríte elementom <vytvor-vazbu-zdd>:
<?xml version="1.0"?>
<!-- vytvoření vazby zdd mezi zdd a bankou -->
<winstrom version="1.0">
<faktura-vydana>
<!-- zálohový daňový doklad -->
<id>code:VF1-0001/2017</id>
<!-- lze normálně uvést další vlastnosti dokladu jako při běžném importu -->
<vytvor-vazbu-zdd>
<uhrada type="banka">code:B+0001/2017</uhrada>
</vytvor-vazbu-zdd>
</faktura-vydana>
</winstrom>
Rovnakým spôsobom je možné naviazať pokladničný doklad, len sa zmení atribút type:
<?xml version="1.0"?>
<!-- vytvoření vazby zdd mezi zdd a pokladnou -->
<winstrom version="1.0">
<faktura-vydana>
<id>code:VF1-0001/2017</id>
<vytvor-vazbu-zdd>
<uhrada type="pokladni-pohyb">code:P+0001/2017</uhrada>
</vytvor-vazbu-zdd>
</faktura-vydana>
</winstrom>
Identifikátor platobného dokladu (tag <uhrada>) je možné uviesť podľa obvyklých pravidiel. Ak tento platobný doklad nie je nájdený, import skončí chybou 400 s kódom parovaniZddNenalezenUhrazujiciDoklad:
Úhrada (id = code:B+9999/2017) nebyla nalezena.
Ak nie je uvedený typ úhrady (atribút type), predpokladá sa, že typ úhrady je bankový doklad:
<?xml version="1.0"?>
<!-- vytvoření vazby zdd mezi zdd a úhradou bez uvedení typu platby -->
<winstrom version="1.0">
<faktura-vydana>
<id>code:VF1-0001/2017</id>
<vytvor-vazbu-zdd>
<uhrada>code:B+0001/2017</uhrada>
</vytvor-vazbu-zdd>
</faktura-vydana>
</winstrom>
⚠️ Väzba je vždy 1 : 1 — jeden ZDD je možné naviazať iba na jednu platbu a na jednu platbu môže byť naviazaný iba jeden ZDD. Ak je ZDD (alebo platba) už naviazaný a malo by dôjsť k naviazaniu na iný doklad, import skončí chybou.
Zrušenie väzby ZDD
Cez REST API je tiež možné väzbu ZDD zrušiť. Slúži na to prázdny element <zrus-vazbu-zdd/>:
<?xml version="1.0"?>
<!-- zrušení vazby zdd -->
<winstrom version="1.0">
<faktura-vydana>
<!-- zálohový daňový doklad -->
<id>code:VF1-0001/2017</id>
<zrus-vazbu-zdd/>
</faktura-vydana>
</winstrom>