Přeskočit na hlavní obsah
Odpočet záloh a ZDD - API

Odpočet zálohy a ZDD (vystavení daňového dokladu k platbě)

Ota Rádl avatar
Autor: Ota Rádl
Aktualizováno před více než měsícem

Při vytváření dokladů (např. faktur) je potřeba umožnit odpočet jiným dokladem (např. zálohovou platbou).

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&#x161;&#xED; n&#xE1;le&#x17E;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:

{
    "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

Příklad

<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 posfix -ZAKL, -SNIZ, -SNIZ2, -OSV -->
<castkyBezDph>true</castkyBezDph>
<!-- zda jsou uvedené částky včetně, nebo bez DPH -->
<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.

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.

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. Systém dokáže úpravy nastavení navrhout.
Pokud je uvedeno <prijmoutDoporuceni>true</prijmoutDoporuceni>, bude se automaticky aplikovat doporučení úpravy faktury.
Seznam doporučení lze získat na adrese https://instance/c/firma/faktura-vydana/ID_FAKTURY/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 zaškrtávátko 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>
Dostali jste odpověď na svou otázku?