Vydanú alebo prijatú faktúru možno cez XML hotovostne uhradiť nasledujúcim spôsobom:
<?xml version="1.0"?>
<winstrom version="1.0">
<faktura-vydana>
<!-- uhrazovaný doklad; může být i "faktura-prijata" -->
<id>code:FAKTURA1</id>
<!-- lze normálně uvést další vlastnosti dokladu jako při běžném importu -->
<hotovostni-uhrada>
<uhrazujiciDokl>code:UHRADA1</uhrazujiciDokl>
<!-- nepovinné -->
<pokladna>code:POKLADNA KČ</pokladna>
<!-- nepovinné, pokud je vyplněné a je true, použije se kurz platný k datu úhrady, jinak se použije kurz převzatý z uhrazované faktury -->
<kurzKDatuUhrady>true/false</kurzKDatuUhrady>
<typDokl>code:STANDARD</typDokl>
<!-- typ vytvářeného pokladního dokladu -->
<castka>1000</castka>
<datumUhrady>2011-01-01</datumUhrady>
</hotovostni-uhrada>
</faktura-vydana>
</winstrom>
Hotovostnej úhrade možno tiež priamo vynútiť kurz a kurzové množstvo. Ak by ste kurz vyplnili, je nutné vyplniť aj kurzové množstvo (bez neho to nie je možné).
Výsledný request môže potom vyzerať nasledovne:
<?xml version="1.0"?>
<winstrom version="1.0">
<faktura-vydana>
<id>code:FAKTURA_1</id>
<hotovostni-uhrada>
<pokladna>code:POKLADNA EUR</pokladna>
<!-- není povinný, pokud by nebyl vyplněn, použije se kurz převzatý z uhrazované faktury -->
<kurz>25</kurz>
<kurzMnozstvi>1</kurzMnozstvi>
<typDokl>code:STANDARD</typDokl>
<castka>1000</castka>
<datumUhrady>2021-12-03</datumUhrady>
</hotovostni-uhrada>
</faktura-vydana>
</winstrom>
Možno uviesť ID uhrádzajúceho pokladničného dokladu (tag <uhrazujiciDokl> ) podľa obvyklých pravidiel a funguje nasledovne:
Nová úhrada: Pokiaľ nie je uvedené, vždy sa vytvorí nový pokladničný doklad, takže ak importujete XML dvakrát, vytvoria sa dve úhrady. Pokiaľ je uvedené a doklad s daným ID neexistuje, založí sa.
Aktualizácia: Pokiaľ existuje, musí uhrádzať danú faktúru (inak ide o chybu) a znamená to, že sa má úhrada iba aktualizovať dostupnou sumou na uhrádzajúcom doklade. Ostatné parametre úhrady sa ignorujú.
Pokiaľ nejde o úplnú úhradu, možno do tela requestu doplniť parameter zbytek. Ten môže nadobúdať niekoľko hodnôt.
|
|
|
|
parameter | zbytek = 0 | zbytek > 0 | zbytek < 0 |
| Faktúry budú úplne uhradené, alebo čiastočne uhradené, pokiaľ došlo k obmedzeniu úhrady atribútom
Uhrádzajúci doklad bude spárovaný. | CHYBA:
400 – Sumy na uhrádzanom a uhrádzajúcom doklade sa nezhodujú |
|
| Faktúry budú úplne uhradené, alebo čiastočne uhradené, pokiaľ došlo k obmedzeniu úhrady atribútom
Uhrádzajúci doklad bude spárovaný.
Pre zostatok vznikne interný doklad. |
|
|
| Faktúry budú úplne uhradené, alebo čiastočne uhradené, pokiaľ došlo k obmedzeniu úhrady atribútom
Uhrádzajúci doklad nebude spárovaný. |
|
|
| CHYBA:
400 – Čiastočná úhrada nemá zmysel, suma na uhrádzajúcom doklade je väčšia ako na uhrádzanom | Suma uhrádzajúceho dokladu sa postupne „spotrebúva" na úhradu faktúr alebo súm, ktoré sa z nich majú uhradiť, v poradí ich uvedenia v elemente
Faktúra, na ktorú z úhrady už nezostáva dostatočná suma na úplnú úhradu alebo úhradu celej uvedenej sumy, sa uhradí čiastočne do výšky zostávajúcich prostriedkov z uhrádzajúcej sumy.
Faktúry, na ktoré z uhrádzajúcej sumy nezostávajú žiadne prostriedky, sú z párovania vyradené a zostanú neuhradené. |
|
| Faktúry budú úplne uhradené, alebo čiastočne uhradené, pokiaľ došlo k obmedzeniu úhrady atribútom
Uhrádzajúci doklad bude spárovaný.
Pre zostatok vznikne interný doklad. |
|
|
| Faktúry budú úplne uhradené, alebo čiastočne uhradené, pokiaľ došlo k obmedzeniu úhrady atribútom
Uhrádzajúci doklad nebude spárovaný. |
|
|
V tagu <hotovostni-uhrada> možno uviesť aj dokladovú sériu pre vytváraný pokladničný doklad. Nie je to povinné a štandardne sa preberá z vybraného typu dokladu, prípadne z vybranej pokladnice.
<rada>code:POKLADNA+</rada>