Dobropis možno cez API vytvoriť a zároveň prepojiť s faktúrou jedným požiadavkom. Slúži na to služba dobropisuj, ktorá zároveň založí doklad, prenesie na neho vybrané položky v zápornom množstve a vytvorí väzbu na dobropisovanú faktúru.
Dobropis jedným požiadavkom
<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 elemente polozka je id položky dobropisovanej faktúry a mnozMj množstvo, ktoré sa má dobropisovať. Vznikne doklad so zápornými položkami a väzbou typVazbyDokl.hlavaDobropis. Ak má položka evidované výrobné čísla, uvedú sa v elemente vyrobniCislaId.
Prepojenie už existujúceho dobropisu
Ak máte dobropis hotový a chcete len doplniť väzbu, použite 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>
Voliteľný vytvorZapocet rovno vytvorí vzájomný zápočet, ktorým sa faktúra aj dobropis uhradia; v tom prípade je povinný typDoklZapocet. Väzbu možno tiež zrušiť prázdnym elementom <zrus-vazbu-dobropis></zrus-vazbu-dobropis>.
⚠️ Jeden dobropis možno naviazať len na jednu faktúru; na jednu faktúru ich naopak môže byť naviazaných viac. Pokus naviazať už naviazaný dobropis na inú faktúru skončí chybou, rovnako ako odkaz na neexistujúci doklad.
ℹ️ Služba vytvor-vazbu-dobropis prepája len hlavičky dokladov, nie položky. Pri skladových položkách preto sledujte nákupnú cenu — ak ju neuvediete, použije sa aktuálna skladová cena, a ak nie je tovar skladom, cena z cenníka. Nesprávna cena sa prejaví na stave skladu.