Od verzie 2021.9.1 je možné cez REST API zaokrúhliť ceny prijatej faktúry alebo pokladničného dokladu. Služba je dostupná v evidenciách faktura-prijata a pokladni-pohyb (výdaj).

Popis služby

Ide o totožnú službu, ktorú nájdete aj v desktopovej aplikácii

detail prijatej faktúry > Služby > Zaokrúhlenie cien dokladu
detail pokladničného dokladu (výdaj) > Služby > Zaokrúhlenie cien dokladu

Zaokrúhlenie cien dokladu možno použiť iba pri položkovom doklade. Pri využití služby zaokrouhli voláme metódou POST alebo PUT endpoint danej evidencie:

https://demo.flexibee.eu/c/demo/faktura-prijata.xml

alebo

https://demo.flexibee.eu/c/demo/pokladni-pohyb.xml

Vstupné parametre služby

Služba zaokrouhli má vstupný parameter pozadovaneCeny, ktorý obsahuje požadované ceny dokladu v jednotlivých sadzbách DPH:

pozadovaneCeny: Ceny, podľa ktorých bude dopočítaný zaokrúhľovací rozdiel:

zklZakl, dphZakl a celkZakl (Základ, DPH a Vrátane DPH): pre základnú sadzbu
zklSniz, dphSniz a celkSniz (Základ, DPH a Vrátane DPH): pre zníženú sadzbu
zklSniz2, dphSniz2 a celkSniz2 (Základ, DPH a Vrátane DPH): pre 2. zníženú sadzbu
osv: pre sumu oslobodenú od dane

Príklady použitia

1. Zaokrúhlenie prijatej faktúry, zaokrúhlenie cien v základnej sadzbe:

POST https://demo.flexibee.eu/c/demo/faktura-prijata.xml

<winstrom version="1.0"> 
  <faktura-prijata> 
    <!-- Přijatá faktura, která bude zaokrouhlena. --> 
    <id>code:PF0001/2021</id> 
    <!-- Lze uvést i další vlastnosti dokladu, jako př importu. --> 
    <zaokrouhli> 
      <pozadovaneCeny>
        <!-- Požadované ceny dokladu. --> 
        <zklZakl>110</zklZakl> 
        <!-- Základ částky pro základní sazbu. --> 
        <dphZakl>23.1</zklZakl>
        <!-- DPH částky pro základní sazbu. --> 
        <celkZakl>133.1</zklZakl> 
        <!-- Částka pro základní sazbu Včetně DPH. --> 
      </pozadovaneCeny> 
   </zaokrouhli>
 </faktura-prijata>
</winstrom>

Výsledkom bude zaokrúhľovacia položka na doklade:

<winstrom version="1.0"> 
  <faktura-prijata> 
    <id>code:PF0001/2021</id> 
    <sumCelkem>133.1</sumCelkem> 
    <polozkyFaktury> 
      <faktura-prijata-polozka> 
       <!-- Původní položka dokladu. -->
       <typPolozkyK>typPolozky.obecny</typPolozkyK> 
       <sumZkl>100.0</sumZkl> 
       <sumDph>21.0</sumDph> 
       <sumCelkem>121.0</sumCelkem>
      </faktura-prijata-polozka>
      <faktura-prijata-polozka> 
       <!-- Položka, která vznikla při zaokrouhlení. --> 
       <typPolozkyK>typPolozky.ucetni</typPolozkyK> 
       <sumZkl>10.0</sumZkl> 
       <sumDph>2.1</sumDph> 
       <sumCelkem>12.1</sumCelkem> 
     </faktura-prijata-polozka>
    </polozkyFaktury> 
  </faktura-prijata> 
</winstrom>

2. Zaokrúhlenie pokladničného dokladu, zaokrúhlenie cien v sadzbe 0 %:

PUT https://demo.flexibee.eu/c/demo/pokladni-pohyb.xml

<winstrom version="1.0"> 
  <pokladni-pohyb> 
    <!-- Pokladní pohyb, který bude zaokrouhlen. --> 
    <id>code:P-0001/2021</id> 
    <!-- Lze uvést i další vlastnosti dokladu, jako př importu. --> 
    <zaokrouhli> 
      <pozadovaneCeny>
        <!-- Požadované ceny dokladu. --> 
        <osv>140</osv>  
      </pozadovaneCeny> 
   </zaokrouhli>
 </pokladni-pohyb>
</winstrom>

Výsledkom bude zaokrúhľovacia položka na doklade:

<winstrom version="1.0"> 
  <pokladni-pohyb> 
    <id>code:P-0001/2021</id> 
    <sumCelkem>140</sumCelkem> 
    <polozkyDokladu> 
      <pokladni-pohyb-polozka> 
       <!-- Původní položka dokladu. -->
       <typPolozkyK>typPolozky.obecny</typPolozkyK> 
       <sumZkl>130.0</sumZkl> 
       <sumDph>0.0</sumDph> 
       <sumCelkem>130.0</sumCelkem>
      </pokladni-pohyb-polozka>
      <pokladni-pohyb-polozka> 
       <!-- Položka, která vznikla při zaokrouhlení. --> 
       <typPolozkyK>typPolozky.ucetni</typPolozkyK> 
       <sumZkl>10.0</sumZkl> 
       <sumDph>0.0</sumDph> 
       <sumCelkem>10.0</sumCelkem> 
     </pokladni-pohyb-polozka>
    </polozkyDokladu> 
  </pokladni-pohyb> 
</winstrom>

Sorodni članki

Prevodka - REST API

Vytvorenie zálohy z objednávky so zachovaním položiek pomocou REST API

Realizácia objednávky

Balenie v REST API

Rozúčtovanie dokladu pomocou REST API

Zaokrúhlenie cien dokladu v REST API

Popis služby

Vstupné parametre služby

Príklady použitia