Přeskočit na hlavní obsah
Všechny sbírkyDokumentace REST APIPokročilé příkazy
Rozúčtování dokladu pomocí REST API
Rozúčtování dokladu pomocí REST API

Jak rozúčtovat doklad pomocí služby v API Flexi?

Ota Rádl avatar
Autor: Ota Rádl
Aktualizováno před více než rokem

Stejně jako v deskopové nebo webové aplikaci je možné využít funkci Rozúčtování dokladu. Funkci rozúčtování dokladu lze použít jen u dokladu, který neobsahuje položky. Pomocí této funkce je možné rozúčtovat doklad na dílčí položky dokladu.

Tato funkce je využitelná pro vybrané evidence ABRA Flexi:

  • faktura-prijata

  • faktura-vydana

  • banka

  • pokladni-pohyb

  • pohledavka

  • zavazek

Způsob volání

Lze využít HTTP metodu: PUT.

Endpoint pro zaslání rozúčtování si řídí evidencí, dále uvádíte identifikátor dokladu, tedy například:

https://localhost:5434/c/firma/prijata-faktura/123.xml (.json).

https://localhost:5434/c/firma/pohledavka.xml (.json).

URL parametry

Vstupními daty v API Flexi jsou jednotlivé řádky rozúčtování s účetními náležitostmi ke správnému zaúčtování. Každý řádek má tyto parametry. Všechny parametry jsou case-sensitive:

  • typUcOp - Předpis zaúčtování (identifikátor záznamu z evidence predpis-zauctovani)

  • sazbaDph - Sazba DPH (identifikátor záznamu z evidence sazba-dph)

  • sumZkl - částka Základ (desetinné číslo)

  • zklMdUcet - Má Dáti základu (identifikátor záznamu z evidence ucet)

  • zklDalUcet - Dal základu (identifikátor záznamu z evidence ucet)

  • sumDph - částka DPH (desetinné číslo)

  • dphMdUcet - Má dáti DPH (identifikátor záznamu z evidence ucet)

  • dphDalUcet - Dal DPH (identifikátor záznamu z evidence ucet)

  • clenDph - Řádek DPH (identifikátor záznamu z evidence cleneni-dph)

  • clenKonVykDph - Řádek kontrolního hlášení DPH (identifikátor záznamu z evidence cleneni-kontrolni-hlaseni)

  • stredisko - Středisko (identifikátor záznamu z evidence stredisko)

  • cinnost - Činnost (identifikátor záznamu z evidence cinnost)

  • zakazka - Zakázka (identifikátor záznamu z evidence zakazka)

Popis jednotlivých evidencí naleznete zde.

Příklady použití

  1. rozúčtování faktury přijaté na dva řádky

<winstrom version="1.0"> 
<faktura-prijata>
<rozuctujDoklad>
<radkyRozuctovani>
<radek>
<typUcOp>code:NÁKUP ZBOŽÍ A</typUcOp>
<sumZkl>75.0</sumZkl>
<sazbaDph>1</sazbaDph>
<zklMdUcet>code:131001</zklMdUcet>
<zklDalUcet>code:321001</zklDalUcet>
<clenDph>code:000P</clenDph>
</radek>
<radek>
<typUcOp>code:NÁKUP ZBOŽÍ B</typUcOp>
<sumZkl>25.0</sumZkl>
<sazbaDph>1</sazbaDph>
<zklMdUcet>code:131001</zklMdUcet>
<zklDalUcet>code:321001</zklDalUcet>
<clenDph>code:000P</clenDph>
</radek>
</radkyRozuctovani>
</rozuctujDoklad>
</faktura-prijata>
</winstrom>

2. rozúčtování závazku na dva řádky v JSON:

{
"winstrom": {
"zavazek": {
"rozuctujDoklad": {
"radkyRozuctovani": [
{
"typUcOp": "code:CESTOVNÉ",
"sumZkl": "750.0",
"sazbaDph": "1",
"zklMdUcet": "code:512001",
"zklDalUcet": "code:314001",
"clenDph": "code:40-41"
},
{
"typUcOp": "code:CESTOVNÉ",
"sumZkl": "250.0",
"sazbaDph": "1",
"zklMdUcet": "code:512001",
"zklDalUcet": "code:314001",
"clenDph": "code:40-41"
}
]
}
}}}

Neúspěšné requesty

  1. Částky řádků v součtu neodpovídají celkové částce dokladu, API Flexi informuje následovně:

    "message": "Suma položek nesouhlasí se sumou dokladu."

  2. Zadání parametru, jehož hodnota neexistuje v datech

    "message": "Záznam pro parametr (zklMdUcet) nebyl v datovém zdroji nalezen: cz.winstrom.vo.ucto.Ucet#code:521002 [ZAV0005/2223]",

    "code": "NOT-FOUND(cz.winstrom.vo.ucto.Ucet)(code:521002)"

  3. Chyba v zápisu, syntakticky špatný zápis např:

    "winstrom": {
    "zavazek": {
    "rozuctujDoklad": {
    "radkyRoyuctovani": [

    Výseldek Chyba 500: "message": "Interní chyba aplikace."

Potřebujete poradit?

V případě dotazů k aplikaci nás kontaktujte na podporaflexi@abra.eu případně prostřednictvím chat okna v pravém dolním rohu.

Dostali jste odpověď na svou otázku?