Přeskočit na hlavní obsah

Korekce cen v tuzemské měně - API

Jak nastavit korekci ceny dokladu přes API?

Autor: Petr Pech

Služba koriguj umožňuje korigovat ceny přijaté faktury nebo pokladního dokladu v tuzemské měně. Je dostupná v evidencích faktura-prijata a pokladni-pohyb a volá se metodou POST nebo PUT na endpoint dané evidence.

ℹ️ V desktopové aplikaci najdete tutéž funkci na detailu dokladu pod tlačítkem Služby jako Korekce cen v tuzemské měně. Na uhrazených dokladech není dostupná — takový požadavek REST API sice přijme a vrátí 201, ale žádnou korekční položku nevytvoří.

Korekce zapíše rozdíl proti požadovaným cenám jako novou položku typu typPolozky.korekceTuz s názvem Zaokrouhleno. Částky v měně dokladu zůstanou nezměněné — korekční položka má sumCelkemMen nulové — mění se tedy pouze tuzemské součty dokladu.


Vstupní parametry

Služba má jediný vstupní parametr pozadovaneCeny — tuzemské ceny, podle kterých bude dopočítán korekční rozdíl, zadané po jednotlivých sazbách DPH:

Elementy

Sazba

zklZakl, dphZakl, celkZakl

Základní sazba — základ, DPH a včetně DPH

zklSniz, dphSniz, celkSniz

Snížená sazba

zklSniz2, dphSniz2, celkSniz2

2. snížená sazba

osv

Částka osvobozená od daně

🚨 Trojice hodnot v jedné sazbě musí být vnitřně konzistentní — základ plus DPH se musí rovnat částce včetně DPH. Jinak služba vrací 400 s kódem dokladKorekceCastekChybaSouctu a hlášením Součet částek v sazbě 'základní' nesouhlasí.


Příklad použití

POST https://demo.flexibee.eu/c/demo/faktura-prijata.xml
<winstrom version="1.0">
<faktura-prijata>
<id>code:PF0014/2022</id>
<koriguj>
<pozadovaneCeny>
<zklZakl>491.2</zklZakl>
<dphZakl>103.39</dphZakl>
<celkZakl>594.59</celkZakl>
</pozadovaneCeny>
</koriguj>
</faktura-prijata>
</winstrom>

Výsledek

Odpovědí je 201 Created se standardním výsledkem importu a na dokladu vznikne korekční položka:

<winstrom version="1.0">
<faktura-prijata>
<kod>PF0014/2022</kod>
<polozkyDokladu>
<faktura-prijata-polozka>
<mnozMj>1.0</mnozMj>
<typSzbDphK>typSzbDph.dphZakl</typSzbDphK>
<cenaMj>491.4</cenaMj>
<sumZkl>491.4</sumZkl>
<sumDph>103.19</sumDph>
<sumCelkem>594.59</sumCelkem>
<sumCelkemMen>0.0</sumCelkemMen>
</faktura-prijata-polozka>
<faktura-prijata-polozka>
<nazev>Zaokrouhleno</nazev>
<typPolozkyK>typPolozky.korekceTuz</typPolozkyK>
<sumZkl>-0.20</sumZkl>
<sumDph>0.20</sumDph>
</faktura-prijata-polozka>
</polozkyDokladu>
</faktura-prijata>
</winstrom>


Související

Dostali jste odpověď na svou otázku?