V REST API je možné vytvoriť zálohový daňový doklad (ZDD) zo zálohy a dokladu, ktorý ju uhrádza.

Služba je dostupná v evidenciách banka, pokladni-pohyb a vzajemny-zapocet. Požiadavku je možné zasielať vo formáte XML alebo JSON.

⚠️ Na inej evidencii, kde použitie tvorby ZDD nedáva zmysel, sa element <vytvorZDD> potichu ignoruje — volanie vráti 200, ale žiadne ZDD nevznikne.

Základné volanie

Volanie vykonáme metódou POST alebo PUT, napríklad nad bankou:

POST https://demo.flexibee.eu/c/demo/banka.xml

Telo požiadavky:

<winstrom version="1.0">
  <banka>
    <!-- Bankovní doklad, který uhrazuje přijatou zálohu. -->
    <id>code:B-0001/2021</id>
    <!-- Lze uvést vlastnosti dokladu, jako při běžném importu. -->
    <vytvorZDD>
      <typDokl>code:ZDD</typDokl>
      <prenasetCisDosle>true</prenasetCisDosle>
    </vytvorZDD>
  </banka>
</winstrom>

V príklade sa odkazujeme na bankový doklad pomocou interného čísla bankového pohybu. Bankový doklad musí byť spárovaný so zálohovou faktúrou.

V prípade, že nie je bankový pohyb plne napárovaný na zálohovú faktúru, API Flexi vypíše chybu:

<errors>
  <error>
    Doklad není kompletně spárován. Nelze vygenerovat ZDD.
  </error>
</errors>

Vstupné parametre požiadavky

💡 Žiadny z parametrov nie je povinný — ak máte v nastavení firmy nastavený predvolený typ dokladu, stačí prázdny element <vytvorZDD/>.

Parameter	Význam
`typDokl`	Typ dokladu pre vytvorenie ZDD. Ak nie je uvedený, použije sa predvolený typ dokladu z nastavení firmy. Ide o identifikátor niektorého záznamu z evidencie `typ-faktury-prijate` alebo `typ-faktury-vydane`.
`rada`	Dokladová rada vytváraného ZDD. Ak nie je uvedená, je odvodená z typu dokladu. Ide o identifikátor niektorého záznamu z evidencie `rada-faktury-prijate` alebo `rada-faktury-vydane`.
`clenDph`	Členenie DPH vytváraného ZDD. Ak nie je uvedené, je odvodené zo zálohy. Ide o identifikátor niektorého záznamu z evidencie `cleneni-dph`.
`castkyDph`	Sumy jednotlivých riadkov DPH zálohy: `zklZakl`, `dphZakl`, `celkZakl` (Základ, DPH a Vrátane DPH) — pre základnú sadzbu `zklSniz`, `dphSniz`, `celkSniz` — pre zníženú sadzbu `zklSniz2`, `dphSniz2`, `celkSniz2` — pre 2. zníženú sadzbu `osv` — pre sumu oslobodenú od dane
`prenasetCisDosle`	Príznak, že sa má číslo došlé preniesť zo zálohy do vytváraného ZDD. Možné hodnoty sú `true` alebo `false`. Ak nie je uvedený, číslo došlé sa neprenáša.

Výsledok

Výsledkom bude nový záznam v evidencii faktura-prijata:

<winstrom version="1.0">
  <faktura-prijata>
    <id>code:PF0001/2021</id>
    <typDokl>code:ZDD</typDokl>
    <vazby>
      <vazba>
        <a>code:B-0001/2021</a>
        <b>code:PF0001/2021</b>
      </vazba>
    </vazby>
  </faktura-prijata>
</winstrom>

API Flexi vráti výsledok služby ako štandardné návratové hodnoty.

Kompletná štruktúra v XML

<winstrom version="1.0">
  <banka>
    <!-- Bankovní doklad, který uhrazuje přijatou zálohu. -->
    <id>code:B-0001/2021</id>
    <!-- Lze uvést vlastnosti dokladu, jako při běžném importu. -->
    <vytvorZDD>
      <typDokl>code:ZDD</typDokl>                <!-- Typ dokladu pro vytvoření ZDD. -->
      <rada>code:FAKTURY</rada>                 <!-- Dokladová řada vytvářeného ZDD. -->
      <clenDph>code:40-41</clenDph>             <!-- Členění DPH vytvářeného ZDD. -->
      <prenasetCisDosle>true</prenasetCisDosle>  <!-- Příznak, že se má číslo došlé přenést ze zálohy. -->
      <castkyDph>                                <!-- Částky jednotlivých řádků DPH zálohy -->
        <zklZakl>100</zklZakl>                   <!-- Základ částky pro základní sazbu. -->
        <dphZakl>21</dphZakl>                    <!-- DPH částky pro základní sazbu. -->
        <celkZakl>121</celkZakl>                 <!-- Částka pro základní sazbu včetně DPH. -->
      </castkyDph>
    </vytvorZDD>
  </banka>
</winstrom>

Volanie v JSON

Štandardné volanie bez parametrov vo formáte JSON vykonáme nasledovne (analogicky metódou POST):

PUT https://demo.flexibee.eu/c/demo/banka.json

{
  "winstrom": {
    "banka": {
      "id": "code:BF072302605",
      "vytvorZDD": {}
    }
  }
}

Volanie obsahuje službu vytvorZDD bez obsahu (analogicky možno namiesto {} uviesť ""). Výsledkom je vytvorené ZDD:

{
  "winstrom": {
    "@version": "1.0",
    "success": "true",
    "stats": {
      "created": "0",
      "updated": "1",
      "deleted": "0",
      "skipped": "0",
      "failed": "0"
    },
    "results": [
      {
        "id": "123",
        "request-id": "code:BF072302605",
        "ref": "/c/demo/banka/123.json"
      }
    ]
  }
}

Kompletná štruktúra v JSON:

{
  "winstrom": {
    "banka": {
      "id": "code:B-0001/2021",
      "vytvorZDD": {
        "typDokl": "code:ZDD",
        "rada": "code:FAKTURY",
        "clenDph": "code:40-41",
        "prenasetCisDosle": "true",
        "castkyDph": {
          "zklZakl": "100",
          "dphZakl": "21",
          "celkZakl": "121"
        }
      }
    }
  }
}

Súvisiace

Sorodni članki

Tvorba ZDD cez REST API