Preskoči na glavno vsebino

Dobropisy

Ako stornovať faktúry pomocou REST API?

Avtor: Petr Pech

Previazanie dobropisu s faktúrou

<?xml version="1.0"?>
<winstrom version="1.0">
<faktura-vydana>
<!-- dobropis; může být i "faktura-prijata" -->
<id>code:DOBROPIS1</id>
<!-- lze normálně uvést další vlastnosti dokladu jako při běžném importu -->
<vytvor-vazbu-dobropis>
<dobropisovanyDokl>code:FAKTURA1</dobropisovanyDokl>
<!-- identifikátor dobropisovaného dokladu-->
</vytvor-vazbu-dobropis>
</faktura-vydana>
</winstrom>

Možno uviesť ID dobropisovanej faktúry (tag <dobropisovanyDokl> ) podľa obvyklých pravidiel. Ak táto faktúra nie je nájdená, import skončí chybou.

Jeden dobropis je možné naviazať len na jednu faktúru. Na jednu faktúru však môže byť naviazaných viac dobropisov. V prípade, že je dobropis už naviazaný na nejakú faktúru a malo by dôjsť k naviazaniu na inú, import skončí chybou.

Dôležité upozornenia k postupu vyššie

  • Služba vytvára iba väzbu, dobropisujúci doklad musí mať správne vytvorené položky.

  • Vytvorená väzba pridáva iba prepojenie hlavičiek dokladov, nerieši prepojenie položiek.

  • Nákupná cena uvedená na položkách by mala zodpovedať skladovej cene tovaru z dobropisovaného dokladu, inak nebude sedieť stav skladu.

  • Ak nie je uvedená nákupná cena, použije sa aktuálna skladová cena!

  • Ak tovar nie je skladom, použije sa nákupná cena z cenníka!

Ďalšou možnosťou je nechať REST-API vytvoriť dobropis vrátane väzieb

Okrem ID dobropisovanej faktúry (tag <dobropisovanyDokl>) je potrebné uviesť aj to, ktoré položky chceme dobropisovať (tag <polozkyDokladu>). Pri každej položke je nutné uviesť jej <id> podľa obvyklých pravidiel a množstvo, ktoré chceme dobropisovať (tag <mnozMj>).

Ide teda o plnohodnotný dobropis s väzbou medzi položkami.

<winstrom version="1.0">
<faktura-vydana>
<typDokl>code:DOBROPIS</typDokl>
<!-- Lze uvést další vlastnosti dokladu, jako při běžném importu. -->
<dobropisuj>
<dobropisovanyDokl>code:VF1-0001/2021</dobropisovanyDokl>
<polozkyDokladu>
<polozka>
<id>123</id>
<mnozMj>1</mnozMj>
</polozka>
</polozkyDokladu>
</dobropisuj>
</faktura-vydana>
</winstrom>

Ak má položka evidované výrobné čísla, je potrebné zadať zodpovedajúci počet výrobných čísel (tag <vyrobniCislaId>).

<winstrom version="1.0">
<faktura-vydana>
<typDokl>code:DOBROPIS</typDokl>
<!-- Lze uvést další vlastnosti dokladu, jako při běžném importu. -->
<dobropisuj>
<dobropisovanyDokl>code:VF1-0001/2021</dobropisovanyDokl>
<polozkyDokladu>
<polozka>
<id>123</id>
<mnozMj>1</mnozMj>
<vyrobniCislaId>
<vyrobniCisloId>456</vyrobniCisloId>
</vyrobniCislaId>
</polozka>
</polozkyDokladu>
</dobropisuj>
</faktura-vydana>
</winstrom>

Je možné zadať aj výrobné čísla sád (tag <vyrobniCislaSad>).

<winstrom version="1.0">
<faktura-vydana>
<typDokl>code:DOBROPIS</typDokl>
<!-- Lze uvést další vlastnosti dokladu, jako při běžném importu. -->
<dobropisuj>
<dobropisovanyDokl>code:VF1-0001/2021</dobropisovanyDokl>
<polozkyDokladu>
<polozka>
<id>123</id>
<mnozMj>1</mnozMj>
<vyrobniCislaSad>
<vyrobniCislaSady>
<sadaId>789</sadaId>
<vyrobniCislaId>
<vyrobniCisloId>456</vyrobniCisloId>
</vyrobniCislaId>
</vyrobniCislaSady>
</vyrobniCislaSad>
</polozka>
</polozkyDokladu>
</dobropisuj>
</faktura-vydana>
</winstrom>

Vytvoriť zároveň aj vzájomný zápočet

Ak sa uvedie element <vytvorZapocet>true</vytvorZapocet>, bude automaticky vytvorený aj vzájomný zápočet, ktorým sa uhradí faktúra a dobropis.

Na vytvorenie vzájomného zápočtu je nutné uviesť typ dokladu zápočtov v elemente <typDoklZapocet>.

Ako dátum zápočtu sa použije dátum z novšieho dokladu. Ako súhrnné číslo sa použije variabilný symbol z faktúry.

V prípade párovania dokladov v cudzej mene sa použije stiahnutý kurz k dátumu zápočtu.

<winstrom version="1.0">
<faktura-vydana>
<!-- dobropis; může být i "faktura-prijata" -->
<id>code:DOBROPIS1</id>
<!-- Lze uvést další vlastnosti dokladu, jako při běžném importu. -->
<vytvor-vazbu-dobropis>
<dobropisovanyDokl>code:FAKTURA1</dobropisovanyDokl>
<!-- identifikátor dobropisovaného dokladu-->
<vytvorZapocet>true</vytvorZapocet>
<!-- pokud je uvedeno a je true, vytvoří se zároveň i vzájemný zápočet-->
<typDoklZapocet>code:ZAPOCET</typDoklZapocet>
<!-- povinný, pokud je uvedeno <vytvorZapocet>true</vytvorZapocet> -->
</vytvor-vazbu-dobropis>
</faktura-vydana>
</winstrom>

Dôležité upozornenia

  • Služba vytvára iba väzbu, dobropisujúci doklad musí mať správne vytvorené položky.

  • Vytvorená väzba pridáva iba prepojenie hlavičiek dokladov, nerieši prepojenie položiek.

  • Nákupná cena uvedená na položkách by mala zodpovedať skladovej cene tovaru z dobropisovaného dokladu, inak nebude sedieť stav skladu.

  • Ak nie je uvedená nákupná cena, použije sa aktuálna skladová cena!

  • Ak tovar nie je skladom, použije sa nákupná cena z cenníka!

Zrušenie väzby dobropisu

<?xml version="1.0"?>
<winstrom version="1.0">
<faktura-vydana>
<!-- dobropis; může být i "faktura-prijata" -->
<id>code:DOBROPIS1</id>
<zrus-vazbu-dobropis/>
</faktura-vydana>
</winstrom>
Ste s tem dobili odgovor na svoje vprašanje?