Preskoči na glavno vsebino

Vytvorenie preplatku pomocou REST API

Ako vytvárať preplatky v REST API ABRA Flexi?

Avtor: Petr Pech

Služba umožňuje vytvoriť preplatok z banky, pokladne alebo vzájomného zápočtu. Preplatok sa vytvorí tak, že sa nespárovaná časť platby presunie do pohľadávok alebo záväzkov — podľa toho, či ide o príjem, alebo výdaj.

Funkcia na vytvorenie preplatku je dostupná nad evidenciami banka, pokladni-pohyb a vzajemny-zapocet. Prehľad všetkých evidencií nájdete v tzv. evidence liste.

Pomocou REST API je možné aj uhradiť faktúry z preplatkov v banke — môže sa samozrejme jednať aj o preplatky takto vytvorené. Ak by vás postup zaujímal, nahliadnite do nášho návodu.


Vstupné parametre

Parameter

Povinnosť

Význam

typDokl

povinný

Typ dokladu na vytvorenie preplatku. Ide o identifikátor niektorého záznamu z evidencie typ-pohledavky alebo typ-zavazku.

rada

nepovinná

Dokladová rada na vytvorenie preplatku. Ak nie je uvedená, odvodí sa z typu dokladu. Ide o identifikátor niektorého záznamu z evidencie rada-pohledavky alebo rada-zavazku.

⚠️ Na inej ako uvedenej evidencii sa element <preplatek> ticho ignoruje — volanie vráti 200, ale nič sa nevytvorí. Nepovažujte teda úspešnú návratovú hodnotu automaticky za vytvorený preplatok.


Preplatok z príjmového dokladu (ostatný záväzok)

<winstrom version="1.0">
<banka>
<!-- Bankovní doklad, z něhož má být přeplatek vytvořen. -->
<id>code:B+0001/2021</id>
<!-- Lze uvést další vlastnosti dokladu, jako při běžném importu. -->
<preplatek>
<typDokl>code:OST. ZÁVAZKY</typDokl>
</preplatek>
</banka>
</winstrom>

Keďže išlo o príjmový bankový doklad, výsledkom bude nový záznam v evidencii zavazek s nastavením podľa uvedeného typu záväzku v tele požiadavky vyššie:

<winstrom version="1.0">
<zavazek>
<id>code:ZAV0001/2021</id>
<popis>Přeplatek (B+0001/2021)</popis>
<typDokl>code:OST. ZÁVAZKY</typDokl>
<rada>code:OSTATNÍ ZÁVAZKY</rada>
<vazby>
<vazba>
<a>code:B+0001/2021</a>
<b>code:ZAV0001/2021</b>
</vazba>
</vazby>
</zavazek>
</winstrom>


Preplatok z výdajového dokladu (ostatná pohľadávka)

Rovnako je možné pri vytváraní preplatku nad výdajovým dokladom vytvoriť ostatnú pohľadávku:

<winstrom version="1.0">
<banka>
<!-- Bankovní doklad, z něhož má být přeplatek vytvořen. -->
<id>code:B-0001/2022</id>
<!-- Lze uvést další vlastnosti dokladu, jako při běžném importu. -->
<preplatek>
<typDokl>code:OST. POHLEDÁVKY</typDokl>
</preplatek>
</banka>
</winstrom>

Výsledok by v prípade požiadavky vyššie vyzeral takto:

<winstrom version="1.0">
<pohledavka>
<id>code:POH0001/2022</id>
<popis>Přeplatek (B-0001/2022)</popis>
<typDokl>code:OST. POHLEDÁVKY</typDokl>
<rada>code:OSTATNÍ POHLEDÁVKY</rada>
<vazby>
<vazba>
<a>code:B-0001/2022</a>
<b>code:POH0001/2022</b>
</vazba>
</vazby>
</pohledavka>
</winstrom>

💡 Nový záväzok aj pohľadávka sú s príslušnou platbou rovno spárované, takže výdajová ani príjmová platba nebude figurovať v nespárovaných uhrádzajúcich dokladoch.


Súvisiace

Ste s tem dobili odgovor na svoje vprašanje?