{"openapi":"3.0.3","info":{"title":"ABRA Flexi REST API – Základ","version":"2026.5.5","description":"Server, firmy, prihlásenie, metadáta, čítanie cez POST, súčty, zmeny, webhooky a prílohy – spoločné pre všetky evidencie.\n\n**Neoficiálna dokumentácia** pripravená spoločnosťou NextVision Analytics. Štruktúra evidencií a polí je vygenerovaná z metadát ABRA Flexi 2026.5.5 (demo server, 2026-09-30); príklady vychádzajú z reálnych integrácií.\n\n- [Príručka: základy API, filtre, zápis, chyby](https://nva.sk/abra-flexi-api/)\n- [Katalóg evidencií a polí](https://nva.sk/abra-flexi-api/evidencie/)\n- [Oficiálna dokumentácia ABRA Flexi](https://www.flexibee.eu/api/dokumentace/)\n\nVšetky hodnoty v JSON odpovediach sú **reťazce** (`\"123\"`, `\"12.5\"`, `\"true\"`). Typ poľa podľa Flexi nájdete v popise poľa a v rozšírení `x-flexi-type`. Pri zápise Flexi prijíma aj čísla a `true`/`false`.\n\nTlačidlo **Try it out** posiela požiadavky priamo z vášho prehliadača na zvolený server. Zápisové operácie majú predvolene zapnutý `dry-run` – nič sa neuloží.","x-author":"NextVision Analytics, https://nva.sk/, tomas@nva.sk"},"servers":[{"url":"https://demo.flexibee.eu/c/demo","description":"Verejný demo server ABRA Flexi – bez prihlásenia, vhodný na vyskúšanie"},{"url":"https://{server}/c/{firma}","description":"Váš server ABRA Flexi","variables":{"server":{"default":"vasa-firma.flexibee.eu:5434","description":"Adresa servera vrátane portu"},"firma":{"default":"vasa_firma","description":"Kód firmy – časť URL za /c/"}}}],"security":[{},{"basicAuth":[]},{"authSessionId":[]}],"tags":[{"name":"Server a firmy","description":"Stav servera, zoznam firiem a prihlásenie. Tieto adresy sú na úrovni servera (bez `/c/{firma}`)."},{"name":"Metadáta","description":"Popis evidencií priamo z Flexi: polia, väzby, akcie a tlačové zostavy. Za cestu evidencie stačí pridať `/properties`, `/relations`, `/actions` alebo `/reports`."},{"name":"Čítanie cez POST","description":"Čítanie s dlhým filtrom v tele požiadavky."},{"name":"Súčty","description":"Súčty za evidenciu alebo filtrované záznamy."},{"name":"Zmeny a webhooky","description":"Synchronizácia len zmenených záznamov – changes API a notifikácie na vašu URL."},{"name":"Prílohy","description":"Nahrávanie a sťahovanie súborov priložených k záznamom."}],"paths":{"/status.json":{"get":{"tags":["Server a firmy"],"operationId":"status","summary":"Stav a verzia servera","servers":[{"url":"https://demo.flexibee.eu","description":"Verejný demo server ABRA Flexi"},{"url":"https://{server}","description":"Váš server ABRA Flexi","variables":{"server":{"default":"vasa-firma.flexibee.eu:5434"}}}],"security":[{}],"description":"Verzia ABRA Flexi, licencia a stav servera. Nevyžaduje prihlásenie.","responses":{"200":{"description":"Stav servera.","content":{"application/json":{"schema":{"type":"object"},"example":{"status":{"version":"2026.5.5","appServerRunning":"true"}}}}}}}},"/c.json":{"get":{"tags":["Server a firmy"],"operationId":"zoznam-firiem","summary":"Zoznam firiem na serveri","servers":[{"url":"https://demo.flexibee.eu","description":"Verejný demo server ABRA Flexi"},{"url":"https://{server}","description":"Váš server ABRA Flexi","variables":{"server":{"default":"vasa-firma.flexibee.eu:5434"}}}],"description":"Firmy (databázy), ku ktorým má používateľ prístup. Hodnota `dbNazev` je kód firmy v URL `/c/{firma}/`.","responses":{"200":{"description":"Zoznam firiem.","content":{"application/json":{"schema":{"type":"object"},"example":{"companies":{"company":[{"dbNazev":"demo","nazev":"Demo firma","stavEnum":"ESTABLISHED"}]}}}}},"400":{"$ref":"#/components/responses/Chyba400"},"401":{"$ref":"#/components/responses/Chyba401"},"403":{"$ref":"#/components/responses/Chyba403"}}}},"/login-logout/login.json":{"post":{"tags":["Server a firmy"],"operationId":"prihlasenie","summary":"Prihlásenie (session)","servers":[{"url":"https://demo.flexibee.eu","description":"Verejný demo server ABRA Flexi"},{"url":"https://{server}","description":"Váš server ABRA Flexi","variables":{"server":{"default":"vasa-firma.flexibee.eu:5434"}}}],"security":[{}],"description":"Alternatíva k Basic autentifikácii pri mnohých požiadavkach za sebou. Vráti `authSessionId`, ktoré posielajte v hlavičke `X-authSessionId`. Session po čase nečinnosti vyprší.","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","required":["username","password"],"properties":{"username":{"type":"string"},"password":{"type":"string","format":"password"}}}}}},"responses":{"200":{"description":"Prihlásenie úspešné.","content":{"application/json":{"schema":{"type":"object"},"example":{"success":true,"authSessionId":"0123456789abcdef…"}}}},"400":{"$ref":"#/components/responses/Chyba400"},"401":{"$ref":"#/components/responses/Chyba401"},"403":{"$ref":"#/components/responses/Chyba403"}}}},"/evidence-list.json":{"get":{"tags":["Metadáta"],"operationId":"zoznam-evidencii","summary":"Zoznam evidencií","description":"Všetky evidencie firmy vrátane cesty v URL (`evidencePath`), podpory importu (`importStatus`) a podpory externých ID.","responses":{"200":{"description":"Zoznam evidencií.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Chyba400"},"401":{"$ref":"#/components/responses/Chyba401"},"403":{"$ref":"#/components/responses/Chyba403"}}}},"/{evidencia}/properties.json":{"get":{"tags":["Metadáta"],"operationId":"polia-evidencie","summary":"Polia evidencie","description":"Zoznam polí evidencie: názov, typ, povinnosť, maximálna dĺžka, povolené hodnoty, väzby. Z tohto zdroja je vygenerovaná aj táto dokumentácia.","parameters":[{"name":"evidencia","in":"path","required":true,"schema":{"type":"string","enum":["adresar","adresar-bankovni-ucet","analyza-zakazky","atribut","autotisk","banka","banka-polozka","bankovni-ucet","bankovni-ucet-pokladna","bankovni-ucet-sklad-pokladna","castky-k-odpoctu","cenik","cenik-obal","cenik-typ-sazby-dph","cenikova-skupina","cenikovy-pohyb-nakup","cenikovy-pohyb-prodej","cenova-uroven","certifikacni-autorita","certifikat","certifikat-finbricks","cinnost","cislo-baliku","cleneni-dph","cleneni-kontrolni-hlaseni","custom-button","danovy-naklad","danovy-odpis","dashboard-panel","dashboard-sharing","def-store","dodavatel","dodavatelska-smlouva","dodavatelsky-typ-smlouvy","doklad","doklad-k-uhrade","doplnek","doporuceni","faktura-prijata","faktura-prijata-polozka","faktura-vydana","faktura-vydana-polozka","filtr","forma-dopravy","forma-uhrady","forma-uhrady-zauctovani","format-elektronickeho-bankovnictvi","format-elektronickeho-prikazu","global-store","hlavni-kniha","hodnoceni-zakazky","individualni-cenik","insight","integrace","interni-doklad","interni-doklad-polozka","intrastat-dodaci-podminky","intrastat-druh-dopravy","intrastat-kod-nomenklatury","intrastat-kraj-urceni","intrastat-kurz","intrastat-merna-jednotka","intrastat-obchodni-transakce","intrastat-zvlastni-pohyb","inventura","inventura-polozka","konst-symbol","kontakt","kontrolni-hlaseni-dph","kurz","kurz-pro-cenotvorbu","kurz-pro-preceneni","kusovnik","leasing","majetek","majetek-udalost","mapovani-skladu","mena","merna-jednotka","misto-urceni","nabidka-prijata","nabidka-prijata-polozka","nabidka-vydana","nabidka-vydana-polozka","naklad","neuhrazene-po-splatnosti","neuhrazene-po-splatnosti-2","objednavka-prijata","objednavka-prijata-polozka","objednavka-vydana","objednavka-vydana-polozka","objekt-doplnku","obrat","obratova-predvaha","odberatel","odpisova-skupina","parametr","penezni-ustav","po-splatnosti","podklady-dph","podobne-zbozi","pohledavka","pohledavka-polozka","pohyb-na-uctech","pokladna","pokladni-pohyb","pokladni-pohyb-polozka","poplatek","poptavka-prijata","poptavka-prijata-polozka","poptavka-vydana","poptavka-vydana-polozka","pravo-viditelnosti","predpis-zauctovani","preneseni-dph","pricteni-rozdilu","prikaz-k-inkasu","prikaz-k-inkasu-polozka","prikaz-k-uhrade","prikaz-k-uhrade-polozka","priloha","prislustenstvi","pristupove-pravo","prodejka","prodejka-platba","psc","rada","rada-banka","rada-faktury-prijate","rada-faktury-vydane","rada-interniho-dokladu","rada-nabidky-prijate","rada-nabidky-vydane","rada-objednavky-prijate","rada-objednavky-vydane","rada-pohledavky","rada-pokladni-pohyb","rada-poptavky-prijate","rada-poptavky-vydane","rada-skladovy-pohyb","rada-uplatneni-dane-zavazku","rada-zavazku","radek-priznani-dph","radek-sestavy","region","rezervace","rocni-rada","rozpad-radku","rozvaha-po-uctech","sablona-mail","sablona-upominky","sady-a-komplety","saldo","saldo-k-datu","sarze-expirace","sazba-dph","sestava","setting-store","sklad","skladova-karta","skladovy-pohyb","skladovy-pohyb-polozka","skupina-atributu","skupina-firem","skupina-plneni","skupina-stitku","skupina-zbozi","smlouva","smlouva-polozka","smlouva-zurnal","souhrnne-hlaseni-dph","splatkovy-kalendar","standardni-predpis","stat","stat-dph","stav-ceniku","stav-obchodniho-dokladu","stav-skladu-k-datu","stav-smlouvy","stav-uctu","stav-zakazky","stitek","stredisko","strom","strom-cenik","strom-koren","subjekt","sumace-sestavy","text","typ-aktivity","typ-atributu","typ-banka","typ-dokladu","typ-faktury-prijate","typ-faktury-vydane","typ-interniho-dokladu","typ-leasingu","typ-majetku","typ-nabidky-prijate","typ-nabidky-vydane","typ-nakladu","typ-objednavky-prijate","typ-objednavky-vydane","typ-organizace","typ-pohledavky","typ-pokladni-pohyb","typ-poptavky-prijate","typ-poptavky-vydane","typ-prodejky","typ-skladovy-pohyb","typ-smlouvy","typ-stavu-ceniku","typ-uplatneni-dane-zavazku","typ-uzivatelske-vazby","typ-vzajemnych-zapoctu","typ-zakazky","typ-zavazku","ucet","ucetni-denik","ucetni-obdobi","ucetni-odpis","ucetni-osnova","udalost","ulozene-priznani-dph","ulozene-priznani-kon-vyk-dph","umisteni","umisteni-uctu","umisteni-ve-skladu","umisteni-ve-skladu-mistnost","umisteni-ve-skladu-police","umisteni-ve-skladu-regal","uplatneni-dane-zavazku","uplatneni-dane-zavazku-polozka","uziv-predpis","uzivatelska-vazba","uzivatelsky-dotaz","uzivatelsky-dotaz-parametr","uzivatelsky-dotaz-vlastnost","vazba","vazebni-doklad","vykaz-hospodareni","vyrobni-cislo","vysledovka-po-uctech","vzajemny-zapocet","xslt","zakazka","zaloha-k-odpoctu","zapujcka","zavazek","zavazek-polozka","zurnal"]},"example":"faktura-vydana","description":"Názov evidencie v URL, napr. `faktura-vydana`, `adresar`, `cenik`."}],"responses":{"200":{"description":"Polia evidencie.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Chyba400"},"401":{"$ref":"#/components/responses/Chyba401"},"403":{"$ref":"#/components/responses/Chyba403"}}}},"/{evidencia}/relations.json":{"get":{"tags":["Metadáta"],"operationId":"vazby-evidencie","summary":"Väzby evidencie","parameters":[{"name":"evidencia","in":"path","required":true,"schema":{"type":"string","enum":["adresar","adresar-bankovni-ucet","analyza-zakazky","atribut","autotisk","banka","banka-polozka","bankovni-ucet","bankovni-ucet-pokladna","bankovni-ucet-sklad-pokladna","castky-k-odpoctu","cenik","cenik-obal","cenik-typ-sazby-dph","cenikova-skupina","cenikovy-pohyb-nakup","cenikovy-pohyb-prodej","cenova-uroven","certifikacni-autorita","certifikat","certifikat-finbricks","cinnost","cislo-baliku","cleneni-dph","cleneni-kontrolni-hlaseni","custom-button","danovy-naklad","danovy-odpis","dashboard-panel","dashboard-sharing","def-store","dodavatel","dodavatelska-smlouva","dodavatelsky-typ-smlouvy","doklad","doklad-k-uhrade","doplnek","doporuceni","faktura-prijata","faktura-prijata-polozka","faktura-vydana","faktura-vydana-polozka","filtr","forma-dopravy","forma-uhrady","forma-uhrady-zauctovani","format-elektronickeho-bankovnictvi","format-elektronickeho-prikazu","global-store","hlavni-kniha","hodnoceni-zakazky","individualni-cenik","insight","integrace","interni-doklad","interni-doklad-polozka","intrastat-dodaci-podminky","intrastat-druh-dopravy","intrastat-kod-nomenklatury","intrastat-kraj-urceni","intrastat-kurz","intrastat-merna-jednotka","intrastat-obchodni-transakce","intrastat-zvlastni-pohyb","inventura","inventura-polozka","konst-symbol","kontakt","kontrolni-hlaseni-dph","kurz","kurz-pro-cenotvorbu","kurz-pro-preceneni","kusovnik","leasing","majetek","majetek-udalost","mapovani-skladu","mena","merna-jednotka","misto-urceni","nabidka-prijata","nabidka-prijata-polozka","nabidka-vydana","nabidka-vydana-polozka","naklad","neuhrazene-po-splatnosti","neuhrazene-po-splatnosti-2","objednavka-prijata","objednavka-prijata-polozka","objednavka-vydana","objednavka-vydana-polozka","objekt-doplnku","obrat","obratova-predvaha","odberatel","odpisova-skupina","parametr","penezni-ustav","po-splatnosti","podklady-dph","podobne-zbozi","pohledavka","pohledavka-polozka","pohyb-na-uctech","pokladna","pokladni-pohyb","pokladni-pohyb-polozka","poplatek","poptavka-prijata","poptavka-prijata-polozka","poptavka-vydana","poptavka-vydana-polozka","pravo-viditelnosti","predpis-zauctovani","preneseni-dph","pricteni-rozdilu","prikaz-k-inkasu","prikaz-k-inkasu-polozka","prikaz-k-uhrade","prikaz-k-uhrade-polozka","priloha","prislustenstvi","pristupove-pravo","prodejka","prodejka-platba","psc","rada","rada-banka","rada-faktury-prijate","rada-faktury-vydane","rada-interniho-dokladu","rada-nabidky-prijate","rada-nabidky-vydane","rada-objednavky-prijate","rada-objednavky-vydane","rada-pohledavky","rada-pokladni-pohyb","rada-poptavky-prijate","rada-poptavky-vydane","rada-skladovy-pohyb","rada-uplatneni-dane-zavazku","rada-zavazku","radek-priznani-dph","radek-sestavy","region","rezervace","rocni-rada","rozpad-radku","rozvaha-po-uctech","sablona-mail","sablona-upominky","sady-a-komplety","saldo","saldo-k-datu","sarze-expirace","sazba-dph","sestava","setting-store","sklad","skladova-karta","skladovy-pohyb","skladovy-pohyb-polozka","skupina-atributu","skupina-firem","skupina-plneni","skupina-stitku","skupina-zbozi","smlouva","smlouva-polozka","smlouva-zurnal","souhrnne-hlaseni-dph","splatkovy-kalendar","standardni-predpis","stat","stat-dph","stav-ceniku","stav-obchodniho-dokladu","stav-skladu-k-datu","stav-smlouvy","stav-uctu","stav-zakazky","stitek","stredisko","strom","strom-cenik","strom-koren","subjekt","sumace-sestavy","text","typ-aktivity","typ-atributu","typ-banka","typ-dokladu","typ-faktury-prijate","typ-faktury-vydane","typ-interniho-dokladu","typ-leasingu","typ-majetku","typ-nabidky-prijate","typ-nabidky-vydane","typ-nakladu","typ-objednavky-prijate","typ-objednavky-vydane","typ-organizace","typ-pohledavky","typ-pokladni-pohyb","typ-poptavky-prijate","typ-poptavky-vydane","typ-prodejky","typ-skladovy-pohyb","typ-smlouvy","typ-stavu-ceniku","typ-uplatneni-dane-zavazku","typ-uzivatelske-vazby","typ-vzajemnych-zapoctu","typ-zakazky","typ-zavazku","ucet","ucetni-denik","ucetni-obdobi","ucetni-odpis","ucetni-osnova","udalost","ulozene-priznani-dph","ulozene-priznani-kon-vyk-dph","umisteni","umisteni-uctu","umisteni-ve-skladu","umisteni-ve-skladu-mistnost","umisteni-ve-skladu-police","umisteni-ve-skladu-regal","uplatneni-dane-zavazku","uplatneni-dane-zavazku-polozka","uziv-predpis","uzivatelska-vazba","uzivatelsky-dotaz","uzivatelsky-dotaz-parametr","uzivatelsky-dotaz-vlastnost","vazba","vazebni-doklad","vykaz-hospodareni","vyrobni-cislo","vysledovka-po-uctech","vzajemny-zapocet","xslt","zakazka","zaloha-k-odpoctu","zapujcka","zavazek","zavazek-polozka","zurnal"]},"example":"faktura-vydana","description":"Názov evidencie v URL, napr. `faktura-vydana`, `adresar`, `cenik`."}],"responses":{"200":{"description":"Väzby evidencie.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Chyba400"},"401":{"$ref":"#/components/responses/Chyba401"},"403":{"$ref":"#/components/responses/Chyba403"}}}},"/{evidencia}/actions.json":{"get":{"tags":["Metadáta"],"operationId":"akcie-evidencie","summary":"Akcie evidencie","parameters":[{"name":"evidencia","in":"path","required":true,"schema":{"type":"string","enum":["adresar","adresar-bankovni-ucet","analyza-zakazky","atribut","autotisk","banka","banka-polozka","bankovni-ucet","bankovni-ucet-pokladna","bankovni-ucet-sklad-pokladna","castky-k-odpoctu","cenik","cenik-obal","cenik-typ-sazby-dph","cenikova-skupina","cenikovy-pohyb-nakup","cenikovy-pohyb-prodej","cenova-uroven","certifikacni-autorita","certifikat","certifikat-finbricks","cinnost","cislo-baliku","cleneni-dph","cleneni-kontrolni-hlaseni","custom-button","danovy-naklad","danovy-odpis","dashboard-panel","dashboard-sharing","def-store","dodavatel","dodavatelska-smlouva","dodavatelsky-typ-smlouvy","doklad","doklad-k-uhrade","doplnek","doporuceni","faktura-prijata","faktura-prijata-polozka","faktura-vydana","faktura-vydana-polozka","filtr","forma-dopravy","forma-uhrady","forma-uhrady-zauctovani","format-elektronickeho-bankovnictvi","format-elektronickeho-prikazu","global-store","hlavni-kniha","hodnoceni-zakazky","individualni-cenik","insight","integrace","interni-doklad","interni-doklad-polozka","intrastat-dodaci-podminky","intrastat-druh-dopravy","intrastat-kod-nomenklatury","intrastat-kraj-urceni","intrastat-kurz","intrastat-merna-jednotka","intrastat-obchodni-transakce","intrastat-zvlastni-pohyb","inventura","inventura-polozka","konst-symbol","kontakt","kontrolni-hlaseni-dph","kurz","kurz-pro-cenotvorbu","kurz-pro-preceneni","kusovnik","leasing","majetek","majetek-udalost","mapovani-skladu","mena","merna-jednotka","misto-urceni","nabidka-prijata","nabidka-prijata-polozka","nabidka-vydana","nabidka-vydana-polozka","naklad","neuhrazene-po-splatnosti","neuhrazene-po-splatnosti-2","objednavka-prijata","objednavka-prijata-polozka","objednavka-vydana","objednavka-vydana-polozka","objekt-doplnku","obrat","obratova-predvaha","odberatel","odpisova-skupina","parametr","penezni-ustav","po-splatnosti","podklady-dph","podobne-zbozi","pohledavka","pohledavka-polozka","pohyb-na-uctech","pokladna","pokladni-pohyb","pokladni-pohyb-polozka","poplatek","poptavka-prijata","poptavka-prijata-polozka","poptavka-vydana","poptavka-vydana-polozka","pravo-viditelnosti","predpis-zauctovani","preneseni-dph","pricteni-rozdilu","prikaz-k-inkasu","prikaz-k-inkasu-polozka","prikaz-k-uhrade","prikaz-k-uhrade-polozka","priloha","prislustenstvi","pristupove-pravo","prodejka","prodejka-platba","psc","rada","rada-banka","rada-faktury-prijate","rada-faktury-vydane","rada-interniho-dokladu","rada-nabidky-prijate","rada-nabidky-vydane","rada-objednavky-prijate","rada-objednavky-vydane","rada-pohledavky","rada-pokladni-pohyb","rada-poptavky-prijate","rada-poptavky-vydane","rada-skladovy-pohyb","rada-uplatneni-dane-zavazku","rada-zavazku","radek-priznani-dph","radek-sestavy","region","rezervace","rocni-rada","rozpad-radku","rozvaha-po-uctech","sablona-mail","sablona-upominky","sady-a-komplety","saldo","saldo-k-datu","sarze-expirace","sazba-dph","sestava","setting-store","sklad","skladova-karta","skladovy-pohyb","skladovy-pohyb-polozka","skupina-atributu","skupina-firem","skupina-plneni","skupina-stitku","skupina-zbozi","smlouva","smlouva-polozka","smlouva-zurnal","souhrnne-hlaseni-dph","splatkovy-kalendar","standardni-predpis","stat","stat-dph","stav-ceniku","stav-obchodniho-dokladu","stav-skladu-k-datu","stav-smlouvy","stav-uctu","stav-zakazky","stitek","stredisko","strom","strom-cenik","strom-koren","subjekt","sumace-sestavy","text","typ-aktivity","typ-atributu","typ-banka","typ-dokladu","typ-faktury-prijate","typ-faktury-vydane","typ-interniho-dokladu","typ-leasingu","typ-majetku","typ-nabidky-prijate","typ-nabidky-vydane","typ-nakladu","typ-objednavky-prijate","typ-objednavky-vydane","typ-organizace","typ-pohledavky","typ-pokladni-pohyb","typ-poptavky-prijate","typ-poptavky-vydane","typ-prodejky","typ-skladovy-pohyb","typ-smlouvy","typ-stavu-ceniku","typ-uplatneni-dane-zavazku","typ-uzivatelske-vazby","typ-vzajemnych-zapoctu","typ-zakazky","typ-zavazku","ucet","ucetni-denik","ucetni-obdobi","ucetni-odpis","ucetni-osnova","udalost","ulozene-priznani-dph","ulozene-priznani-kon-vyk-dph","umisteni","umisteni-uctu","umisteni-ve-skladu","umisteni-ve-skladu-mistnost","umisteni-ve-skladu-police","umisteni-ve-skladu-regal","uplatneni-dane-zavazku","uplatneni-dane-zavazku-polozka","uziv-predpis","uzivatelska-vazba","uzivatelsky-dotaz","uzivatelsky-dotaz-parametr","uzivatelsky-dotaz-vlastnost","vazba","vazebni-doklad","vykaz-hospodareni","vyrobni-cislo","vysledovka-po-uctech","vzajemny-zapocet","xslt","zakazka","zaloha-k-odpoctu","zapujcka","zavazek","zavazek-polozka","zurnal"]},"example":"faktura-vydana","description":"Názov evidencie v URL, napr. `faktura-vydana`, `adresar`, `cenik`."}],"responses":{"200":{"description":"Akcie, ktoré možno vykonať cez `@action`.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Chyba400"},"401":{"$ref":"#/components/responses/Chyba401"},"403":{"$ref":"#/components/responses/Chyba403"}}}},"/{evidencia}/reports.json":{"get":{"tags":["Metadáta"],"operationId":"zostavy-evidencie","summary":"Tlačové zostavy evidencie","parameters":[{"name":"evidencia","in":"path","required":true,"schema":{"type":"string","enum":["adresar","adresar-bankovni-ucet","analyza-zakazky","atribut","autotisk","banka","banka-polozka","bankovni-ucet","bankovni-ucet-pokladna","bankovni-ucet-sklad-pokladna","castky-k-odpoctu","cenik","cenik-obal","cenik-typ-sazby-dph","cenikova-skupina","cenikovy-pohyb-nakup","cenikovy-pohyb-prodej","cenova-uroven","certifikacni-autorita","certifikat","certifikat-finbricks","cinnost","cislo-baliku","cleneni-dph","cleneni-kontrolni-hlaseni","custom-button","danovy-naklad","danovy-odpis","dashboard-panel","dashboard-sharing","def-store","dodavatel","dodavatelska-smlouva","dodavatelsky-typ-smlouvy","doklad","doklad-k-uhrade","doplnek","doporuceni","faktura-prijata","faktura-prijata-polozka","faktura-vydana","faktura-vydana-polozka","filtr","forma-dopravy","forma-uhrady","forma-uhrady-zauctovani","format-elektronickeho-bankovnictvi","format-elektronickeho-prikazu","global-store","hlavni-kniha","hodnoceni-zakazky","individualni-cenik","insight","integrace","interni-doklad","interni-doklad-polozka","intrastat-dodaci-podminky","intrastat-druh-dopravy","intrastat-kod-nomenklatury","intrastat-kraj-urceni","intrastat-kurz","intrastat-merna-jednotka","intrastat-obchodni-transakce","intrastat-zvlastni-pohyb","inventura","inventura-polozka","konst-symbol","kontakt","kontrolni-hlaseni-dph","kurz","kurz-pro-cenotvorbu","kurz-pro-preceneni","kusovnik","leasing","majetek","majetek-udalost","mapovani-skladu","mena","merna-jednotka","misto-urceni","nabidka-prijata","nabidka-prijata-polozka","nabidka-vydana","nabidka-vydana-polozka","naklad","neuhrazene-po-splatnosti","neuhrazene-po-splatnosti-2","objednavka-prijata","objednavka-prijata-polozka","objednavka-vydana","objednavka-vydana-polozka","objekt-doplnku","obrat","obratova-predvaha","odberatel","odpisova-skupina","parametr","penezni-ustav","po-splatnosti","podklady-dph","podobne-zbozi","pohledavka","pohledavka-polozka","pohyb-na-uctech","pokladna","pokladni-pohyb","pokladni-pohyb-polozka","poplatek","poptavka-prijata","poptavka-prijata-polozka","poptavka-vydana","poptavka-vydana-polozka","pravo-viditelnosti","predpis-zauctovani","preneseni-dph","pricteni-rozdilu","prikaz-k-inkasu","prikaz-k-inkasu-polozka","prikaz-k-uhrade","prikaz-k-uhrade-polozka","priloha","prislustenstvi","pristupove-pravo","prodejka","prodejka-platba","psc","rada","rada-banka","rada-faktury-prijate","rada-faktury-vydane","rada-interniho-dokladu","rada-nabidky-prijate","rada-nabidky-vydane","rada-objednavky-prijate","rada-objednavky-vydane","rada-pohledavky","rada-pokladni-pohyb","rada-poptavky-prijate","rada-poptavky-vydane","rada-skladovy-pohyb","rada-uplatneni-dane-zavazku","rada-zavazku","radek-priznani-dph","radek-sestavy","region","rezervace","rocni-rada","rozpad-radku","rozvaha-po-uctech","sablona-mail","sablona-upominky","sady-a-komplety","saldo","saldo-k-datu","sarze-expirace","sazba-dph","sestava","setting-store","sklad","skladova-karta","skladovy-pohyb","skladovy-pohyb-polozka","skupina-atributu","skupina-firem","skupina-plneni","skupina-stitku","skupina-zbozi","smlouva","smlouva-polozka","smlouva-zurnal","souhrnne-hlaseni-dph","splatkovy-kalendar","standardni-predpis","stat","stat-dph","stav-ceniku","stav-obchodniho-dokladu","stav-skladu-k-datu","stav-smlouvy","stav-uctu","stav-zakazky","stitek","stredisko","strom","strom-cenik","strom-koren","subjekt","sumace-sestavy","text","typ-aktivity","typ-atributu","typ-banka","typ-dokladu","typ-faktury-prijate","typ-faktury-vydane","typ-interniho-dokladu","typ-leasingu","typ-majetku","typ-nabidky-prijate","typ-nabidky-vydane","typ-nakladu","typ-objednavky-prijate","typ-objednavky-vydane","typ-organizace","typ-pohledavky","typ-pokladni-pohyb","typ-poptavky-prijate","typ-poptavky-vydane","typ-prodejky","typ-skladovy-pohyb","typ-smlouvy","typ-stavu-ceniku","typ-uplatneni-dane-zavazku","typ-uzivatelske-vazby","typ-vzajemnych-zapoctu","typ-zakazky","typ-zavazku","ucet","ucetni-denik","ucetni-obdobi","ucetni-odpis","ucetni-osnova","udalost","ulozene-priznani-dph","ulozene-priznani-kon-vyk-dph","umisteni","umisteni-uctu","umisteni-ve-skladu","umisteni-ve-skladu-mistnost","umisteni-ve-skladu-police","umisteni-ve-skladu-regal","uplatneni-dane-zavazku","uplatneni-dane-zavazku-polozka","uziv-predpis","uzivatelska-vazba","uzivatelsky-dotaz","uzivatelsky-dotaz-parametr","uzivatelsky-dotaz-vlastnost","vazba","vazebni-doklad","vykaz-hospodareni","vyrobni-cislo","vysledovka-po-uctech","vzajemny-zapocet","xslt","zakazka","zaloha-k-odpoctu","zapujcka","zavazek","zavazek-polozka","zurnal"]},"example":"faktura-vydana","description":"Názov evidencie v URL, napr. `faktura-vydana`, `adresar`, `cenik`."}],"responses":{"200":{"description":"Tlačové zostavy pre PDF.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Chyba400"},"401":{"$ref":"#/components/responses/Chyba401"},"403":{"$ref":"#/components/responses/Chyba403"}}}},"/{evidencia}/query.json":{"post":{"tags":["Čítanie cez POST"],"operationId":"query","summary":"Čítanie s parametrami v tele požiadavky","description":"Rovnaké čítanie ako GET, ale filter a parametre idú v tele požiadavky. Hodí sa pri dlhých filtroch (napr. `kod in (…)` so stovkami hodnôt), ktoré by sa do URL nezmestili.","parameters":[{"name":"evidencia","in":"path","required":true,"schema":{"type":"string","enum":["adresar","adresar-bankovni-ucet","analyza-zakazky","atribut","autotisk","banka","banka-polozka","bankovni-ucet","bankovni-ucet-pokladna","bankovni-ucet-sklad-pokladna","castky-k-odpoctu","cenik","cenik-obal","cenik-typ-sazby-dph","cenikova-skupina","cenikovy-pohyb-nakup","cenikovy-pohyb-prodej","cenova-uroven","certifikacni-autorita","certifikat","certifikat-finbricks","cinnost","cislo-baliku","cleneni-dph","cleneni-kontrolni-hlaseni","custom-button","danovy-naklad","danovy-odpis","dashboard-panel","dashboard-sharing","def-store","dodavatel","dodavatelska-smlouva","dodavatelsky-typ-smlouvy","doklad","doklad-k-uhrade","doplnek","doporuceni","faktura-prijata","faktura-prijata-polozka","faktura-vydana","faktura-vydana-polozka","filtr","forma-dopravy","forma-uhrady","forma-uhrady-zauctovani","format-elektronickeho-bankovnictvi","format-elektronickeho-prikazu","global-store","hlavni-kniha","hodnoceni-zakazky","individualni-cenik","insight","integrace","interni-doklad","interni-doklad-polozka","intrastat-dodaci-podminky","intrastat-druh-dopravy","intrastat-kod-nomenklatury","intrastat-kraj-urceni","intrastat-kurz","intrastat-merna-jednotka","intrastat-obchodni-transakce","intrastat-zvlastni-pohyb","inventura","inventura-polozka","konst-symbol","kontakt","kontrolni-hlaseni-dph","kurz","kurz-pro-cenotvorbu","kurz-pro-preceneni","kusovnik","leasing","majetek","majetek-udalost","mapovani-skladu","mena","merna-jednotka","misto-urceni","nabidka-prijata","nabidka-prijata-polozka","nabidka-vydana","nabidka-vydana-polozka","naklad","neuhrazene-po-splatnosti","neuhrazene-po-splatnosti-2","objednavka-prijata","objednavka-prijata-polozka","objednavka-vydana","objednavka-vydana-polozka","objekt-doplnku","obrat","obratova-predvaha","odberatel","odpisova-skupina","parametr","penezni-ustav","po-splatnosti","podklady-dph","podobne-zbozi","pohledavka","pohledavka-polozka","pohyb-na-uctech","pokladna","pokladni-pohyb","pokladni-pohyb-polozka","poplatek","poptavka-prijata","poptavka-prijata-polozka","poptavka-vydana","poptavka-vydana-polozka","pravo-viditelnosti","predpis-zauctovani","preneseni-dph","pricteni-rozdilu","prikaz-k-inkasu","prikaz-k-inkasu-polozka","prikaz-k-uhrade","prikaz-k-uhrade-polozka","priloha","prislustenstvi","pristupove-pravo","prodejka","prodejka-platba","psc","rada","rada-banka","rada-faktury-prijate","rada-faktury-vydane","rada-interniho-dokladu","rada-nabidky-prijate","rada-nabidky-vydane","rada-objednavky-prijate","rada-objednavky-vydane","rada-pohledavky","rada-pokladni-pohyb","rada-poptavky-prijate","rada-poptavky-vydane","rada-skladovy-pohyb","rada-uplatneni-dane-zavazku","rada-zavazku","radek-priznani-dph","radek-sestavy","region","rezervace","rocni-rada","rozpad-radku","rozvaha-po-uctech","sablona-mail","sablona-upominky","sady-a-komplety","saldo","saldo-k-datu","sarze-expirace","sazba-dph","sestava","setting-store","sklad","skladova-karta","skladovy-pohyb","skladovy-pohyb-polozka","skupina-atributu","skupina-firem","skupina-plneni","skupina-stitku","skupina-zbozi","smlouva","smlouva-polozka","smlouva-zurnal","souhrnne-hlaseni-dph","splatkovy-kalendar","standardni-predpis","stat","stat-dph","stav-ceniku","stav-obchodniho-dokladu","stav-skladu-k-datu","stav-smlouvy","stav-uctu","stav-zakazky","stitek","stredisko","strom","strom-cenik","strom-koren","subjekt","sumace-sestavy","text","typ-aktivity","typ-atributu","typ-banka","typ-dokladu","typ-faktury-prijate","typ-faktury-vydane","typ-interniho-dokladu","typ-leasingu","typ-majetku","typ-nabidky-prijate","typ-nabidky-vydane","typ-nakladu","typ-objednavky-prijate","typ-objednavky-vydane","typ-organizace","typ-pohledavky","typ-pokladni-pohyb","typ-poptavky-prijate","typ-poptavky-vydane","typ-prodejky","typ-skladovy-pohyb","typ-smlouvy","typ-stavu-ceniku","typ-uplatneni-dane-zavazku","typ-uzivatelske-vazby","typ-vzajemnych-zapoctu","typ-zakazky","typ-zavazku","ucet","ucetni-denik","ucetni-obdobi","ucetni-odpis","ucetni-osnova","udalost","ulozene-priznani-dph","ulozene-priznani-kon-vyk-dph","umisteni","umisteni-uctu","umisteni-ve-skladu","umisteni-ve-skladu-mistnost","umisteni-ve-skladu-police","umisteni-ve-skladu-regal","uplatneni-dane-zavazku","uplatneni-dane-zavazku-polozka","uziv-predpis","uzivatelska-vazba","uzivatelsky-dotaz","uzivatelsky-dotaz-parametr","uzivatelsky-dotaz-vlastnost","vazba","vazebni-doklad","vykaz-hospodareni","vyrobni-cislo","vysledovka-po-uctech","vzajemny-zapocet","xslt","zakazka","zaloha-k-odpoctu","zapujcka","zavazek","zavazek-polozka","zurnal"]},"example":"faktura-vydana","description":"Názov evidencie v URL, napr. `faktura-vydana`, `adresar`, `cenik`."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"winstrom":{"type":"object","properties":{"@version":{"type":"string"},"filter":{"type":"string"},"detail":{"type":"string"},"relations":{"type":"string"},"includes":{"type":"string"},"order":{"type":"string"},"limit":{"type":"integer"},"start":{"type":"integer"},"add-row-count":{"type":"boolean"},"no-ext-ids":{"type":"boolean"}}}}},"example":{"winstrom":{"@version":"1.0","detail":"custom:kod,nazev,ic,email","filter":"lastUpdate >= '2026-09-01T00:00:00' and ic is not empty","order":"nazev@A","limit":100,"add-row-count":true,"no-ext-ids":true}}}}},"responses":{"200":{"description":"Záznamy evidencie.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Chyba400"},"401":{"$ref":"#/components/responses/Chyba401"},"403":{"$ref":"#/components/responses/Chyba403"}}}},"/{evidencia}/$sum.json":{"get":{"tags":["Súčty"],"operationId":"sucty","summary":"Súčty evidencie","description":"Súčty za evidenciu (napr. celkom, uhradené, zostáva uhradiť). S filtrom: `/{evidencia}/(filter)/$sum.json`.","parameters":[{"name":"evidencia","in":"path","required":true,"schema":{"type":"string","enum":["adresar","adresar-bankovni-ucet","analyza-zakazky","atribut","autotisk","banka","banka-polozka","bankovni-ucet","bankovni-ucet-pokladna","bankovni-ucet-sklad-pokladna","castky-k-odpoctu","cenik","cenik-obal","cenik-typ-sazby-dph","cenikova-skupina","cenikovy-pohyb-nakup","cenikovy-pohyb-prodej","cenova-uroven","certifikacni-autorita","certifikat","certifikat-finbricks","cinnost","cislo-baliku","cleneni-dph","cleneni-kontrolni-hlaseni","custom-button","danovy-naklad","danovy-odpis","dashboard-panel","dashboard-sharing","def-store","dodavatel","dodavatelska-smlouva","dodavatelsky-typ-smlouvy","doklad","doklad-k-uhrade","doplnek","doporuceni","faktura-prijata","faktura-prijata-polozka","faktura-vydana","faktura-vydana-polozka","filtr","forma-dopravy","forma-uhrady","forma-uhrady-zauctovani","format-elektronickeho-bankovnictvi","format-elektronickeho-prikazu","global-store","hlavni-kniha","hodnoceni-zakazky","individualni-cenik","insight","integrace","interni-doklad","interni-doklad-polozka","intrastat-dodaci-podminky","intrastat-druh-dopravy","intrastat-kod-nomenklatury","intrastat-kraj-urceni","intrastat-kurz","intrastat-merna-jednotka","intrastat-obchodni-transakce","intrastat-zvlastni-pohyb","inventura","inventura-polozka","konst-symbol","kontakt","kontrolni-hlaseni-dph","kurz","kurz-pro-cenotvorbu","kurz-pro-preceneni","kusovnik","leasing","majetek","majetek-udalost","mapovani-skladu","mena","merna-jednotka","misto-urceni","nabidka-prijata","nabidka-prijata-polozka","nabidka-vydana","nabidka-vydana-polozka","naklad","neuhrazene-po-splatnosti","neuhrazene-po-splatnosti-2","objednavka-prijata","objednavka-prijata-polozka","objednavka-vydana","objednavka-vydana-polozka","objekt-doplnku","obrat","obratova-predvaha","odberatel","odpisova-skupina","parametr","penezni-ustav","po-splatnosti","podklady-dph","podobne-zbozi","pohledavka","pohledavka-polozka","pohyb-na-uctech","pokladna","pokladni-pohyb","pokladni-pohyb-polozka","poplatek","poptavka-prijata","poptavka-prijata-polozka","poptavka-vydana","poptavka-vydana-polozka","pravo-viditelnosti","predpis-zauctovani","preneseni-dph","pricteni-rozdilu","prikaz-k-inkasu","prikaz-k-inkasu-polozka","prikaz-k-uhrade","prikaz-k-uhrade-polozka","priloha","prislustenstvi","pristupove-pravo","prodejka","prodejka-platba","psc","rada","rada-banka","rada-faktury-prijate","rada-faktury-vydane","rada-interniho-dokladu","rada-nabidky-prijate","rada-nabidky-vydane","rada-objednavky-prijate","rada-objednavky-vydane","rada-pohledavky","rada-pokladni-pohyb","rada-poptavky-prijate","rada-poptavky-vydane","rada-skladovy-pohyb","rada-uplatneni-dane-zavazku","rada-zavazku","radek-priznani-dph","radek-sestavy","region","rezervace","rocni-rada","rozpad-radku","rozvaha-po-uctech","sablona-mail","sablona-upominky","sady-a-komplety","saldo","saldo-k-datu","sarze-expirace","sazba-dph","sestava","setting-store","sklad","skladova-karta","skladovy-pohyb","skladovy-pohyb-polozka","skupina-atributu","skupina-firem","skupina-plneni","skupina-stitku","skupina-zbozi","smlouva","smlouva-polozka","smlouva-zurnal","souhrnne-hlaseni-dph","splatkovy-kalendar","standardni-predpis","stat","stat-dph","stav-ceniku","stav-obchodniho-dokladu","stav-skladu-k-datu","stav-smlouvy","stav-uctu","stav-zakazky","stitek","stredisko","strom","strom-cenik","strom-koren","subjekt","sumace-sestavy","text","typ-aktivity","typ-atributu","typ-banka","typ-dokladu","typ-faktury-prijate","typ-faktury-vydane","typ-interniho-dokladu","typ-leasingu","typ-majetku","typ-nabidky-prijate","typ-nabidky-vydane","typ-nakladu","typ-objednavky-prijate","typ-objednavky-vydane","typ-organizace","typ-pohledavky","typ-pokladni-pohyb","typ-poptavky-prijate","typ-poptavky-vydane","typ-prodejky","typ-skladovy-pohyb","typ-smlouvy","typ-stavu-ceniku","typ-uplatneni-dane-zavazku","typ-uzivatelske-vazby","typ-vzajemnych-zapoctu","typ-zakazky","typ-zavazku","ucet","ucetni-denik","ucetni-obdobi","ucetni-odpis","ucetni-osnova","udalost","ulozene-priznani-dph","ulozene-priznani-kon-vyk-dph","umisteni","umisteni-uctu","umisteni-ve-skladu","umisteni-ve-skladu-mistnost","umisteni-ve-skladu-police","umisteni-ve-skladu-regal","uplatneni-dane-zavazku","uplatneni-dane-zavazku-polozka","uziv-predpis","uzivatelska-vazba","uzivatelsky-dotaz","uzivatelsky-dotaz-parametr","uzivatelsky-dotaz-vlastnost","vazba","vazebni-doklad","vykaz-hospodareni","vyrobni-cislo","vysledovka-po-uctech","vzajemny-zapocet","xslt","zakazka","zaloha-k-odpoctu","zapujcka","zavazek","zavazek-polozka","zurnal"]},"example":"faktura-vydana","description":"Názov evidencie v URL, napr. `faktura-vydana`, `adresar`, `cenik`."}],"responses":{"200":{"description":"Súčty.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Chyba400"},"401":{"$ref":"#/components/responses/Chyba401"},"403":{"$ref":"#/components/responses/Chyba403"}}}},"/changes/status.json":{"get":{"tags":["Zmeny a webhooky"],"operationId":"zmeny-stav","summary":"Je zapnuté sledovanie zmien?","responses":{"200":{"description":"Stav sledovania zmien.","content":{"application/json":{"schema":{"type":"object"},"example":{"winstrom":{"success":"true","message":"Changelog is enabled."}}}}},"400":{"$ref":"#/components/responses/Chyba400"},"401":{"$ref":"#/components/responses/Chyba401"},"403":{"$ref":"#/components/responses/Chyba403"}}}},"/changes/enable.json":{"put":{"tags":["Zmeny a webhooky"],"operationId":"zmeny-zapnut","summary":"Zapnúť sledovanie zmien","description":"Zapne zaznamenávanie zmien vo firme. Vyžaduje administrátorské oprávnenie. Bez neho nefunguje `/changes.json` ani webhooky.","responses":{"200":{"description":"Sledovanie zmien zapnuté.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Chyba400"},"401":{"$ref":"#/components/responses/Chyba401"},"403":{"$ref":"#/components/responses/Chyba403"}}}},"/changes.json":{"get":{"tags":["Zmeny a webhooky"],"operationId":"zmeny","summary":"Zoznam zmien od verzie","description":"Vráti vytvorené, zmenené a zmazané záznamy od zadanej verzie. Uložte si hodnotu `next` a pri ďalšom volaní ju pošlite ako `start` – tak synchronizujete len rozdiely.","parameters":[{"name":"start","in":"query","schema":{"type":"integer"},"description":"Verzia, od ktorej chcete zmeny (hodnota `next` z predchádzajúceho volania)."},{"name":"limit","in":"query","schema":{"type":"integer"},"description":"Maximálny počet zmien v odpovedi."},{"name":"evidence","in":"query","schema":{"type":"string"},"description":"Len zmeny jednej evidencie, napr. `faktura-vydana`."}],"responses":{"200":{"description":"Zmeny.","content":{"application/json":{"schema":{"type":"object"},"example":{"winstrom":{"@globalVersion":"967025","next":"3","changes":[{"@evidence":"adresar","@in-version":"1","@operation":"create","@timestamp":"2026-09-30 17:43:33.189","id":"789","external-ids":["code:EVA"]},{"@evidence":"adresar","@in-version":"2","@operation":"delete","@timestamp":"2026-09-30 17:43:35.800","id":"789","external-ids":["code:EVA"]}]}}}}},"400":{"$ref":"#/components/responses/Chyba400"},"401":{"$ref":"#/components/responses/Chyba401"},"403":{"$ref":"#/components/responses/Chyba403"}}}},"/hooks.json":{"get":{"tags":["Zmeny a webhooky"],"operationId":"webhooky","summary":"Zoznam webhookov","responses":{"200":{"description":"Registrované webhooky.","content":{"application/json":{"schema":{"type":"object"},"example":{"winstrom":{"hooks":[{"id":"54","url":"https://vas-system.example.com/webhook/flexi","dataFormat":"JSON","lastVersion":"212850"}]}}}}},"400":{"$ref":"#/components/responses/Chyba400"},"401":{"$ref":"#/components/responses/Chyba401"},"403":{"$ref":"#/components/responses/Chyba403"}}},"put":{"tags":["Zmeny a webhooky"],"operationId":"webhook-registracia","summary":"Registrovať webhook","description":"Flexi bude pri zmenách posielať na zadanú URL zoznam zmien (rovnaký formát ako `/changes.json`). Vyžaduje zapnuté sledovanie zmien. Pri registrácii Flexi štandardne overí, že URL odpovedá.","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","format":"uri"},"example":"https://vas-system.example.com/webhook/flexi"},{"name":"format","in":"query","schema":{"type":"string","enum":["JSON","XML"]},"example":"JSON"},{"name":"secKey","in":"query","schema":{"type":"string"},"description":"Tajný kľúč, ktorý Flexi pošle s notifikáciou – overíte ním, že požiadavka prišla z Flexi."},{"name":"skipUrlTest","in":"query","schema":{"type":"boolean"},"description":"Vypne overenie dostupnosti URL pri registrácii."}],"responses":{"200":{"description":"Webhook zaregistrovaný.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Chyba400"},"401":{"$ref":"#/components/responses/Chyba401"},"403":{"$ref":"#/components/responses/Chyba403"}}}},"/hooks/{id}.json":{"delete":{"tags":["Zmeny a webhooky"],"operationId":"webhook-zrusenie","summary":"Zrušiť webhook","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Webhook zrušený.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Chyba400"},"401":{"$ref":"#/components/responses/Chyba401"},"403":{"$ref":"#/components/responses/Chyba403"}}}},"/{evidencia}/{id}/prilohy/new/{nazovSuboru}":{"put":{"tags":["Prílohy"],"operationId":"priloha-nahratie","summary":"Nahrať prílohu k záznamu","description":"Telo požiadavky je samotný súbor (nie JSON). Typ súboru uveďte v hlavičke `Content-Type`, napr. `application/pdf`.","parameters":[{"name":"evidencia","in":"path","required":true,"schema":{"type":"string","enum":["adresar","adresar-bankovni-ucet","analyza-zakazky","atribut","autotisk","banka","banka-polozka","bankovni-ucet","bankovni-ucet-pokladna","bankovni-ucet-sklad-pokladna","castky-k-odpoctu","cenik","cenik-obal","cenik-typ-sazby-dph","cenikova-skupina","cenikovy-pohyb-nakup","cenikovy-pohyb-prodej","cenova-uroven","certifikacni-autorita","certifikat","certifikat-finbricks","cinnost","cislo-baliku","cleneni-dph","cleneni-kontrolni-hlaseni","custom-button","danovy-naklad","danovy-odpis","dashboard-panel","dashboard-sharing","def-store","dodavatel","dodavatelska-smlouva","dodavatelsky-typ-smlouvy","doklad","doklad-k-uhrade","doplnek","doporuceni","faktura-prijata","faktura-prijata-polozka","faktura-vydana","faktura-vydana-polozka","filtr","forma-dopravy","forma-uhrady","forma-uhrady-zauctovani","format-elektronickeho-bankovnictvi","format-elektronickeho-prikazu","global-store","hlavni-kniha","hodnoceni-zakazky","individualni-cenik","insight","integrace","interni-doklad","interni-doklad-polozka","intrastat-dodaci-podminky","intrastat-druh-dopravy","intrastat-kod-nomenklatury","intrastat-kraj-urceni","intrastat-kurz","intrastat-merna-jednotka","intrastat-obchodni-transakce","intrastat-zvlastni-pohyb","inventura","inventura-polozka","konst-symbol","kontakt","kontrolni-hlaseni-dph","kurz","kurz-pro-cenotvorbu","kurz-pro-preceneni","kusovnik","leasing","majetek","majetek-udalost","mapovani-skladu","mena","merna-jednotka","misto-urceni","nabidka-prijata","nabidka-prijata-polozka","nabidka-vydana","nabidka-vydana-polozka","naklad","neuhrazene-po-splatnosti","neuhrazene-po-splatnosti-2","objednavka-prijata","objednavka-prijata-polozka","objednavka-vydana","objednavka-vydana-polozka","objekt-doplnku","obrat","obratova-predvaha","odberatel","odpisova-skupina","parametr","penezni-ustav","po-splatnosti","podklady-dph","podobne-zbozi","pohledavka","pohledavka-polozka","pohyb-na-uctech","pokladna","pokladni-pohyb","pokladni-pohyb-polozka","poplatek","poptavka-prijata","poptavka-prijata-polozka","poptavka-vydana","poptavka-vydana-polozka","pravo-viditelnosti","predpis-zauctovani","preneseni-dph","pricteni-rozdilu","prikaz-k-inkasu","prikaz-k-inkasu-polozka","prikaz-k-uhrade","prikaz-k-uhrade-polozka","priloha","prislustenstvi","pristupove-pravo","prodejka","prodejka-platba","psc","rada","rada-banka","rada-faktury-prijate","rada-faktury-vydane","rada-interniho-dokladu","rada-nabidky-prijate","rada-nabidky-vydane","rada-objednavky-prijate","rada-objednavky-vydane","rada-pohledavky","rada-pokladni-pohyb","rada-poptavky-prijate","rada-poptavky-vydane","rada-skladovy-pohyb","rada-uplatneni-dane-zavazku","rada-zavazku","radek-priznani-dph","radek-sestavy","region","rezervace","rocni-rada","rozpad-radku","rozvaha-po-uctech","sablona-mail","sablona-upominky","sady-a-komplety","saldo","saldo-k-datu","sarze-expirace","sazba-dph","sestava","setting-store","sklad","skladova-karta","skladovy-pohyb","skladovy-pohyb-polozka","skupina-atributu","skupina-firem","skupina-plneni","skupina-stitku","skupina-zbozi","smlouva","smlouva-polozka","smlouva-zurnal","souhrnne-hlaseni-dph","splatkovy-kalendar","standardni-predpis","stat","stat-dph","stav-ceniku","stav-obchodniho-dokladu","stav-skladu-k-datu","stav-smlouvy","stav-uctu","stav-zakazky","stitek","stredisko","strom","strom-cenik","strom-koren","subjekt","sumace-sestavy","text","typ-aktivity","typ-atributu","typ-banka","typ-dokladu","typ-faktury-prijate","typ-faktury-vydane","typ-interniho-dokladu","typ-leasingu","typ-majetku","typ-nabidky-prijate","typ-nabidky-vydane","typ-nakladu","typ-objednavky-prijate","typ-objednavky-vydane","typ-organizace","typ-pohledavky","typ-pokladni-pohyb","typ-poptavky-prijate","typ-poptavky-vydane","typ-prodejky","typ-skladovy-pohyb","typ-smlouvy","typ-stavu-ceniku","typ-uplatneni-dane-zavazku","typ-uzivatelske-vazby","typ-vzajemnych-zapoctu","typ-zakazky","typ-zavazku","ucet","ucetni-denik","ucetni-obdobi","ucetni-odpis","ucetni-osnova","udalost","ulozene-priznani-dph","ulozene-priznani-kon-vyk-dph","umisteni","umisteni-uctu","umisteni-ve-skladu","umisteni-ve-skladu-mistnost","umisteni-ve-skladu-police","umisteni-ve-skladu-regal","uplatneni-dane-zavazku","uplatneni-dane-zavazku-polozka","uziv-predpis","uzivatelska-vazba","uzivatelsky-dotaz","uzivatelsky-dotaz-parametr","uzivatelsky-dotaz-vlastnost","vazba","vazebni-doklad","vykaz-hospodareni","vyrobni-cislo","vysledovka-po-uctech","vzajemny-zapocet","xslt","zakazka","zaloha-k-odpoctu","zapujcka","zavazek","zavazek-polozka","zurnal"]},"example":"faktura-vydana","description":"Názov evidencie v URL, napr. `faktura-vydana`, `adresar`, `cenik`."},{"name":"id","in":"path","required":true,"schema":{"type":"string"},"example":"123"},{"name":"nazovSuboru","in":"path","required":true,"schema":{"type":"string"},"example":"zmluva.pdf"}],"requestBody":{"required":true,"content":{"application/pdf":{"schema":{"type":"string","format":"binary"}},"image/jpeg":{"schema":{"type":"string","format":"binary"}},"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"responses":{"201":{"description":"Príloha uložená."},"400":{"$ref":"#/components/responses/Chyba400"},"401":{"$ref":"#/components/responses/Chyba401"},"403":{"$ref":"#/components/responses/Chyba403"}}}},"/priloha/{id}/content":{"get":{"tags":["Prílohy"],"operationId":"priloha-obsah","summary":"Stiahnuť obsah prílohy","description":"Vráti súbor prílohy. Zoznam príloh záznamu získate cez `/{evidencia}/{id}/prilohy.json`.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"example":"1"}],"responses":{"200":{"description":"Obsah súboru.","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"400":{"$ref":"#/components/responses/Chyba400"},"401":{"$ref":"#/components/responses/Chyba401"},"403":{"$ref":"#/components/responses/Chyba403"}}}}},"components":{"securitySchemes":{"basicAuth":{"type":"http","scheme":"basic","description":"Meno a heslo používateľa ABRA Flexi s povoleným prístupom cez REST API."},"authSessionId":{"type":"apiKey","in":"header","name":"X-authSessionId","description":"Session ID z prihlásenia `POST /login-logout/login.json`."}},"parameters":{"detail":{"name":"detail","in":"query","schema":{"type":"string"},"description":"Rozsah vrátených polí: `summary` (predvolené v zozname), `full` (všetky polia), `id` (len identifikátory) alebo `custom:pole1,pole2,vazba(pole)` – napr. `custom:kod,nazev,firma(nazev,ic)`.","examples":{"summary":{"value":"summary"},"full":{"value":"full"},"custom":{"value":"custom:id,kod,nazev,lastUpdate"}}},"limit":{"name":"limit","in":"query","schema":{"type":"integer","default":20,"minimum":0},"description":"Počet vrátených záznamov. Predvolene 20, `0` = všetky (pri veľkých evidenciách radšej stránkujte)."},"start":{"name":"start","in":"query","schema":{"type":"integer","default":0,"minimum":0},"description":"Posun pri stránkovaní – od ktorého záznamu (0 = prvý)."},"order":{"name":"order","in":"query","schema":{"type":"string"},"example":"lastUpdate@D","description":"Zoradenie: `pole@A` vzostupne, `pole@D` zostupne."},"addRowCount":{"name":"add-row-count","in":"query","schema":{"type":"boolean"},"description":"Pridá do odpovede `@rowCount` – celkový počet záznamov (vhodné pri stránkovaní)."},"relations":{"name":"relations","in":"query","schema":{"type":"string"},"description":"Vnorené kolekcie, ktoré sa majú vrátiť spolu so záznamom, napr. `polozkyFaktury,prilohy`. Obsah vyberiete cez `detail=custom:…,polozkyFaktury(nazev,mnozMj)`."},"includes":{"name":"includes","in":"query","schema":{"type":"string"},"description":"Vloží celé odkazované záznamy namiesto odkazu, napr. `/faktura-vydana/firma`. Polia vyberiete cez `detail=custom:kod,firma(nazev,ic)`."},"noExtIds":{"name":"no-ext-ids","in":"query","schema":{"type":"boolean"},"description":"Nevracať externé identifikátory (`external-ids`) – menšia a rýchlejšia odpoveď."},"dryRun":{"name":"dry-run","in":"query","schema":{"type":"boolean","default":true},"description":"Skúšobný zápis: Flexi požiadavku spracuje a vráti výsledok vrátane vypočítaných hodnôt, ale nič neuloží. V tejto dokumentácii je predvolene zapnutý."},"id":{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Identifikátor záznamu: `123` (interné ID), `code:KÓD`, `ext:SYSTÉM:ID`. Pri `code:` a `ext:` Flexi presmeruje (301) na adresu s interným ID.","example":"1"},"reportLang":{"name":"report-lang","in":"query","schema":{"type":"string","enum":["sk","cs","en","de"]},"description":"Jazyk tlačovej zostavy."}},"schemas":{"Chyba":{"type":"object","description":"Chyba pri zápise konkrétneho záznamu.","properties":{"message":{"type":"string","description":"Text chyby (česky)."},"for":{"type":"string","description":"Pole, ktorého sa chyba týka."},"path":{"type":"string","description":"Cesta k poľu v požiadavke."},"value":{"type":"string","description":"Odoslaná hodnota."},"code":{"type":"string","description":"Kategória chyby, napr. `PROP`, `INVALID`."},"messageCode":{"type":"string","description":"Kód chyby vhodný na spracovanie v programe, napr. `notObjectIdentifier`."}}},"VysledokZapisu":{"type":"object","properties":{"winstrom":{"type":"object","properties":{"@version":{"type":"string","example":"1.0"},"success":{"type":"string","enum":["true","false"],"description":"`false`, ak aspoň jeden záznam zlyhal."},"stats":{"type":"object","properties":{"created":{"type":"string","example":"0"},"updated":{"type":"string","example":"0"},"deleted":{"type":"string","example":"0"},"skipped":{"type":"string","example":"0"},"failed":{"type":"string","example":"0"}}},"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Interné ID vytvoreného alebo upraveného záznamu."},"request-id":{"type":"string","description":"Identifikátor z požiadavky (napr. `ext:…`)."},"ref":{"type":"string","description":"Relatívna adresa záznamu."},"errors":{"type":"array","items":{"$ref":"#/components/schemas/Chyba"}}}}}}}},"example":{"winstrom":{"@version":"1.0","success":"true","stats":{"created":"1","updated":"0","deleted":"0","skipped":"0","failed":"0"},"results":[{"id":"40125","request-id":"ext:ESHOP:FV-2026-001234","ref":"/c/firma/faktura-vydana/40125.json"}]}}},"ChybaPoziadavky":{"type":"object","properties":{"winstrom":{"type":"object","properties":{"@version":{"type":"string"},"success":{"type":"string","example":"false"},"message":{"type":"string"},"message@messageCode":{"type":"string"}}}},"example":{"winstrom":{"@version":"1.0","success":"false","message@messageCode":"adresaNeplatnaUrl","message":"Adresa … není platná."}}}},"responses":{"Chyba400":{"description":"Chybná požiadavka – neplatný filter, pole alebo hodnota. Pri zápise obsahuje `results[].errors`.","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/VysledokZapisu"},{"$ref":"#/components/schemas/ChybaPoziadavky"}]}}}},"Chyba401":{"description":"Neprihlásený používateľ alebo nesprávne meno a heslo."},"Chyba403":{"description":"Používateľ nemá oprávnenie na evidenciu alebo operáciu. (Chýbajúcu licenciu modulu Flexi hlási kódom 402.)"},"Chyba404":{"description":"Záznam alebo evidencia neexistuje.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChybaPoziadavky"}}}},"VysledokZapisu":{"description":"Výsledok zápisu. Skontrolujte `success` a pri chybe `results[].errors`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VysledokZapisu"}}}}}}}