Dobropis lze přes API vytvořit i provázat s fakturou jedním požadavkem. Slouží k tomu služba dobropisuj, která zároveň založí doklad, přenese na něj vybrané položky v záporném množství a vytvoří vazbu na dobropisovanou fakturu.
Dobropis jedním požadavkem
<winstrom version="1.0">
<faktura-vydana>
<typDokl>code:DOBROPIS</typDokl>
<dobropisuj>
<dobropisovanyDokl>code:VF1-0001/2026</dobropisovanyDokl>
<polozkyDokladu>
<polozka>
<id>123</id>
<mnozMj>1</mnozMj>
</polozka>
</polozkyDokladu>
</dobropisuj>
</faktura-vydana>
</winstrom>
V elementu polozka je id položky dobropisované faktury a mnozMj množství, které se má dobropisovat. Vznikne doklad se zápornými položkami a vazbou typVazbyDokl.hlavaDobropis. Má-li položka evidovaná výrobní čísla, uvedou se v elementu vyrobniCislaId.
Provázání už existujícího dobropisu
Máte-li dobropis hotový a chcete jen doplnit vazbu, použijte vytvor-vazbu-dobropis:
<winstrom version="1.0">
<faktura-vydana>
<id>code:DOBROPIS1</id>
<vytvor-vazbu-dobropis>
<dobropisovanyDokl>code:VF1-0001/2026</dobropisovanyDokl>
<vytvorZapocet>true</vytvorZapocet>
<typDoklZapocet>code:ZAPOCET</typDoklZapocet>
</vytvor-vazbu-dobropis>
</faktura-vydana>
</winstrom>
Volitelný vytvorZapocet rovnou vytvoří vzájemný zápočet, kterým se faktura i dobropis uhradí; v tom případě je povinný typDoklZapocet. Vazbu lze také zrušit prázdným elementem <zrus-vazbu-dobropis></zrus-vazbu-dobropis>.
⚠️ Jeden dobropis lze navázat jen na jednu fakturu; na jednu fakturu jich naopak může být navázáno víc. Pokus navázat už navázaný dobropis na jinou fakturu skončí chybou, stejně jako odkaz na neexistující doklad.
ℹ️ Služba vytvor-vazbu-dobropis propojuje jen hlavičky dokladů, ne položky. U skladových položek proto hlídejte nákupní cenu — pokud ji neuvedete, použije se aktuální skladová cena, a není-li zboží skladem, cena z ceníku. Nesprávná cena se projeví na stavu skladu.