Přes REST API je možné provázat zálohový daňový doklad (ZDD) s platbou bankovního nebo pokladního dokladu, který uhrazuje zálohu.
Nelze však ZDD na základě přijaté platby rovnou vytvořit, obdobně jako tomu je v desktopové aplikaci. Nejprve je nutno jej vytvořit a poté vytvořit vazbu k příslušné platbě.
ℹ️ Pokud chcete ZDD z platby vytvořit jedním voláním, použijte službu vytvorZDD nad bankou nebo pokladnou — viz Tvorba ZDD přes REST API.
Vytvoření vazby ZDD
Vazbu mezi ZDD a bankovním dokladem vytvoříte elementem <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>
Stejným způsobem lze navázat pokladní doklad, jen se změní atribut 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 platebního dokladu (tag <uhrada>) lze uvést podle obvyklých pravidel. Pokud tento platební doklad není nalezen, import skončí chybou 400 s kódem parovaniZddNenalezenUhrazujiciDoklad:
Úhrada (id = code:B+9999/2017) nebyla nalezena.
Pokud není uveden typ úhrady (atribut type), má se za to, že typ úhrady je bankovní 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>
⚠️ Vazba je vždy 1 : 1 — jeden ZDD je možné navázat pouze na jednu platbu a na jednu platbu může být navázán pouze jeden ZDD. Pokud je ZDD (nebo platba) už navázán a mělo by dojít k navázání na jiný doklad, import skončí chybou.
Zrušení vazby ZDD
Přes REST API je také možné vazbu ZDD zrušit. Slouží k tomu prázdný 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>