Preskoči na glavno vsebino

Odpočet záloh a ZDD - API

Odpočet zálohy a DDP (vystavenie daňového dokladu k platbe)

Avtor: Petr Pech

Pri vytváraní dokladov (napr. faktúr) je potrebné umožniť odpočet iným dokladom (napr. zálohovou platbou). Slúži na to kolekcia <odpocty-zaloh> s jednotlivými elementmi <odpocet>.

Okrem odpočtu záloh a ZDD je možné rovno vytvoriť faktúru z uhradených záloh. Pozrite sa, ako na to.


Odpočet zálohy (vystavenie daňového dokladu k platbe)

<?xml version="1.0"?>
<winstrom version="1.0">
<faktura-vydana>
<id>code:VF-123/2021</id>
<!-- Typ faktury (objekt) - max. délka: 20 -->
<typDokl>code:FAKTURA</typDokl>
<!-- ...další náležitosti faktury -->
<polozkyFaktury>
<faktura-vydana-polozka>
<cenik>code:CANON XS1</cenik>
<typPolozkyK>typPolozky.katalog</typPolozkyK>
<mnozMj>1.0</mnozMj>
<sklad>code:SKLAD</sklad>
</faktura-vydana-polozka>
</polozkyFaktury>
<odpocty-zaloh>
<odpocet>
<!-- odpočet zálohy -->
<castkaMen>16300.0</castkaMen> <!-- částka v měně určená pro odpočet -->
<doklad>code:ZALOHA0001/2010</doklad> <!-- identifikátor dokladu pro odpočet -->
<id>ext:odpocet1</id> <!-- externí identifikátor vytvořené odpočtové položky -->
</odpocet>
</odpocty-zaloh>
</faktura-vydana>
</winstrom>

Príklad v JSON (neobsahuje elementy faktura-vydana-polozka a odpocet, pretože sa v JSON zapisujú ako prvky poľa):

{
"winstrom": {
"faktura-vydana": {
"polozkyFaktury": [
{
"cenik": "code:CANON XS1",
"sklad": "code:SKLAD",
"mnozMj": 1
}
],
"odpocty-zaloh": [
{
"castkaMen": 16300,
"doklad": "code:ZALOHA0001/2021"
}
],
"typDokl": "code:FAKTURA"
}
}
}


Odpočet ZDD

Pri zálohovom daňovom doklade sa namiesto jednej sumy uvádzajú sumy podľa sadzieb DPH:

<winstrom version="1.0">
<faktura-vydana>
<id>code:VF-12/2014</id>
<!-- Typ faktury (objekt) - max. délka: 20 -->
<typDokl>code:FAKTURA</typDokl>
<odpocty-zaloh>
<odpocet>
<!-- odpočet zdd -->
<castkaZaklMen>400.0</castkaZaklMen> <!-- částka základní sazby v měně určená pro odpočet -->
<castkaSnizMen>400.0</castkaSnizMen> <!-- částka snížené sazby v měně určená pro odpočet -->
<castkaSniz2Men>400.0</castkaSniz2Men> <!-- částka 2. snížené sazby v měně určená pro odpočet -->
<castkaOsvMen>400.0</castkaOsvMen> <!-- částka osvobozená od DPH v měně určená pro odpočet -->
<doklad>code:ZDD0001/2010</doklad> <!-- identifikátor dokladu pro odpočet -->
<id>ext:odpocet1</id> <!-- externí identifikátor vytvořených odpočtových položek -->
<!-- identifikátor jednotlivých položek je doplněn o postfix -ZAKL, -SNIZ, -SNIZ2, -OSV -->
<castkyBezDph>true</castkyBezDph> <!-- zda jsou uvedené částky včetně, nebo bez DPH -->
<skupPlneni>code:TEPLO</skupPlneni> <!-- identifikátor skupiny plnění, příp. ALL nebo OTHER, nepovinné -->
<prijmoutDoporuceni>true</prijmoutDoporuceni> <!-- zda se má automaticky aplikovat doporučení úpravy faktury, nepovinné -->
<castkyVseDostupne>true</castkyVseDostupne> <!-- pokud je true, odpočítá se ze zálohy vše, co ještě není odpočteno, nepovinné -->
</odpocet>
</odpocty-zaloh>
</faktura-vydana>
</winstrom>

Spôsob odpočtu

Pri odpočte zálohového daňového dokladu sa najprv vytvoria odpočtové položky podľa súm dostupných na faktúre (sadzby DPH sa preberajú z faktúry). Následne sa pre prípadný zvyšok sumy na odpočet vytvoria odpočtové položky preplatkov (sadzby DPH zo ZDD).

Sumy bez DPH vs. vrátane DPH

Element castkyBezDph určuje, či sú uvedené sumy vrátane DPH, alebo bez DPH. Pre spätnú kompatibilitu je predvolená hodnota false, ale keďže odpočty ZDD interne počítajú so sumami bez DPH, odporúčame posielať sumy bez DPH.

⚠️ Pri neúčtovných zálohách nie je možné castkyBezDph použiť — volanie skončí chybou 400 s kódom zalohyXmlZalohaCastkyBezDph: „Pri neúčtovných zálohách nie je možné použiť sumy bez DPH."

Skupina plnenia

Ak je uvedený element skupPlneni, odpočet započítava iba sumy z položiek faktúry s touto skupinou plnenia. Pri prázdnej hodnote sa započítavajú iba položky bez skupiny plnenia. Skupina plnenia nie je zohľadnená, ak element nie je prítomný alebo má hodnotu ALL.

Hodnota OTHER (v aplikácii „Iná skupina") je určená pre prípady, keď majú položky konečnej faktúry inú sadzbu DPH ako ZDD — napr. faktúra v nulovej sadzbe a ZDD v 21 %. V tomto režime sa odpočet nepáruje na sadzby DPH položiek faktúry, ale vytvoria sa priamo odpočtové položky so sadzbami DPH prevzatými zo ZDD.

Automatická úprava faktúry

Pri odpočte ZDD od faktúry je často cieľom získať uhradenú faktúru. Kvôli rozdielom v zaokrúhľovaní alebo korekcii DPH sa môže stať, že faktúra nie je plne uhradená. Správne nastavenie faktúry môže tento problém odstrániť a systém dokáže úpravy nastavenia navrhnúť.

Ak je uvedené <prijmoutDoporuceni>true</prijmoutDoporuceni>, bude sa automaticky aplikovať odporúčanie úpravy faktúry. Zoznam odporúčaní je možné získať na adrese:

GET /c/{firma}/faktura-vydana/{ID}/zalohy-k-odpoctu.xml?relations=doporuceni

Odpočet všetkých dostupných súm

Namiesto vyplnenia súm v poliach castka*Men je možné použiť element castkyVseDostupne s hodnotou true. Tým sa odpočíta zo zálohy všetko, čo ešte nie je odpočítané.


Automatický odpočet

Pri vytváraní dokladov je možné využiť aj automatický odpočet zálohových dokladov a zálohových daňových dokladov:

<?xml version="1.0"?>
<winstrom version="1.0">
<faktura-vydana>
<!-- Typ faktury (objekt) - max. délka: 20 -->
<typDokl>code:FAKTURA</typDokl>
<odpocty-zaloh>
<!-- automatický odpočet zálohy a zdd, které mají automatický odpočet povolen v typu dokladu -->
<automaticky-odpocet>true</automaticky-odpocet>
</odpocty-zaloh>
</faktura-vydana>
</winstrom>

ℹ️ Zálohové faktúry a ZDD musia mať v type dokladu zaškrtnuté Povoliť automatické odpočítanie pri vytvorení nového dokladu. Ak v jednom XML importujete viac faktúr s automatickým odpočtom, použite mód atomic="false".

V prípade, že importujete faktúru s nastaveným zaokrúhľovaním, vytvorte najprv faktúru a až následne odpočítavajte zálohové doklady:

<?xml version="1.0"?>
<winstrom version="1.0">
<faktura-vydana atomic="false">
<!-- Vytvoření faktury se zaokrouhlením -->
<id>ext:mojeId</id>
<typDokl>code:FAKTURA</typDokl>
</faktura-vydana>
<faktura-vydana>
<id>ext:mojeId</id>
<odpocty-zaloh>
<!-- automatický odpočet zálohy a zdd, které mají automatický odpočet povolen v typu dokladu -->
<automaticky-odpocet>true</automaticky-odpocet>
</odpocty-zaloh>
</faktura-vydana>
</winstrom>


Súvisiace

Ste s tem dobili odgovor na svoje vprašanje?