Při vytváření dokladů (např. faktur) je potřeba umožnit odpočet jiným dokladem (např. zálohovou platbou). Slouží k tomu kolekce <odpocty-zaloh> s jednotlivými elementy <odpocet>.
Mimo odpočtu záloh a ZDD lze rovnou vytvořit fakturu z uhrazených záloh. Podívejte se, jak na to.
Odpočet zálohy (vystavení daňového dokladu k platbě)
<?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>
Příklad v JSON (neobsahuje elementy faktura-vydana-polozka a odpocet, protože se v JSON zapisují jako prvky pole):
{
"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
U zálohového daňového dokladu se místo jedné částky uvádějí částky po sazbách 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>
Způsob odpočtu
Při odpočtu zálohového daňového dokladu se nejprve vytvoří odpočtové položky podle částek dostupných na faktuře (sazby DPH se přebírají z faktury). Následně se pro případný zbytek částky k odpočtu vytvoří odpočtové položky přeplatků (sazby DPH ze ZDD).
Částky bez DPH vs. včetně DPH
Element castkyBezDph určuje, jestli jsou uvedené částky včetně DPH, nebo bez DPH. Pro zpětnou kompatibilitu je výchozí hodnota false, ale protože odpočty ZDD interně počítají s částkami bez DPH, doporučujeme posílat částky bez DPH.
⚠️ U neúčetních záloh nelze castkyBezDph použít — volání skončí chybou 400 s kódem zalohyXmlZalohaCastkyBezDph: „U neúčetních záloh nelze použít částky bez DPH."
Skupina plnění
Pokud je uveden element skupPlneni, odpočet započítává pouze částky z položek faktury s touto skupinou plnění. Při prázdné hodnotě se započítávají pouze položky bez skupiny plnění. Skupina plnění není zohledňována, pokud element není přítomen nebo má hodnotu ALL.
Hodnota OTHER (v aplikaci „Jiná skupina") je určena pro případy, kdy mají položky konečné faktury jinou sazbu DPH než ZDD — např. faktura v nulové sazbě a ZDD ve 21 %. V tomto režimu se odpočet nepáruje na sazby DPH položek faktury, ale vytvoří se přímo odpočtové položky se sazbami DPH převzatými ze ZDD.
Automatická úprava faktury
Při odpočtu ZDD od faktury je často cílem získat uhrazenou fakturu. Kvůli rozdílům v zaokrouhlování nebo korekci DPH se může stát, že faktura není plně uhrazena. Správné nastavení faktury může tento problém odstranit a systém dokáže úpravy nastavení navrhnout.
Pokud je uvedeno <prijmoutDoporuceni>true</prijmoutDoporuceni>, bude se automaticky aplikovat doporučení úpravy faktury. Seznam doporučení lze získat na adrese:
GET /c/{firma}/faktura-vydana/{ID}/zalohy-k-odpoctu.xml?relations=doporuceni
Odpočet všech dostupných částek
Místo vyplnění částek v polích castka*Men je možné použít element castkyVseDostupne s hodnotou true. Tím se odpočítá ze zálohy vše, co ještě není odpočteno.
Automatický odpočet
Při vytváření dokladů je možné využít i automatický odpočet zálohových dokladů a zálohových daňových dokladů:
<?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é faktury a ZDD musí mít v typu dokladu zaškrtnuto Povolit automatické odpočtení při vytvoření nového dokladu. Pokud v jednom XML importujete více faktur s automatickým odpočtem, použijte mód atomic="false".
V případě, že importujete fakturu s nastaveným zaokrouhlováním, vytvořte nejdříve fakturu a až následně odpočítávejte 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>