Užívateľské role, tak ako sú definované v rozhraní aplikácie, sú prístupné aj v REST API.
⚠️ Upozornenie: Vo verzii 2026.1.0 je dostupné iba čítanie, nie import. Import bude povolený v niektorej z nasledujúcich verzií.
Spôsob volania
Je možné využiť HTTP metódu: GET, PUT, POST
V REST API je možné využiť endpoint /c/{firma}/role, cez ktorý je možné exportovať, meniť, importovať a vytvárať role vo firme.
GET http://demo.flexibee.eu/c/demo/role.xml
Sú podporované výstupné formáty: JSON, XML alebo CSV.
Popis evidencií
Definícia evidencie role
Definícia evidencie prístupové právo
Dostupné operácie
Export
GET /c/{firma}/roleVráti všetky role vo firme.GET /c/{firma}/role/{ID}Vráti konkrétnu rolu so všetkými prístupovými právami.
Je možné využiť obvyklé filtrovanie a úrovne detailu v API.
Import
PUT a POST /c/{firma}/roleAk dotaz obsahuje
<id>{ID}</id>, tak sa aktualizuje rola zodpovedajúca zadanému ID.Ak dotaz neobsahuje
<id>{ID}</id>, tak sa založí nová rola.
PUT a POST /c/{firma}/role/{ID}Aktualizuje sa rola zodpovedajúca zadanému ID.
Povinné parametre importu
na vytvorenie novej role je potrebné mať vyplnené vlastnosti:
kod- požadovaný Kód/Skratka.nazev- požadovaný NázovotecRole- ID alebo kód predvolenej rolePri vytváraní novej role sa použijú prístupové práva z predvolenej role, ak neboli definované v requeste
<otecRole>code:ADMIN</otecRole>
⚠️ Užívateľské role (<standard>false</standard>) sú vytvorené užívateľom a musia vychádzať z inej role (vlastnosť otecRole).
Štandardné role (<standard>true</standard>) sú vytvorené aplikáciou a sú nemenné.
POZOR! Pri prístupových právach štandardných rolí je ID vo formáte uuid:{kód role}-{klíč práva}
V prípade importu je možné využiť obvyklé identifikátory vrátane externých.
Ukážka volania
1. Čítanie všetkých dostupných rolí
GET
https://demo.flexibee.eu/c/demo/role.xml?limit=0&detail=full
Výstup:
<winstrom version="1.0">
<!-- Role uživatele -->
<role>
<!-- ID (celé číslo) - -->
<id>1</id>
<!-- Poslední změna (datum a čas) - -->
<lastUpdate>2020-02-12T15:10:00.172+01:00</lastUpdate>
<!-- Zkratka (řetězec) - max. délka: 20 -->
<kod>ADMIN</kod>
<!-- Název (řetězec) - max. délka: 255 -->
<nazev>Administrátor</nazev>
<!-- Název EN (řetězec) - max. délka: 255 -->
<nazevA>Administrator</nazevA>
<!-- Název IT (řetězec) - max. délka: 255 -->
<nazevB>Verwalter</nazevB>
<!-- Název FR (řetězec) - max. délka: 255 -->
<nazevC/>
<!-- Poznámka (řetězec) - -->
<poznam/>
<!-- Popis (řetězec) - -->
<popis/>
<!-- Zobrazovat (logická hodnota) - -->
<visible>true</visible>
<!-- Standardní role (logická hodnota) - -->
<standard>true</standard>
<!-- Přístup Administrátor - typPrav.admin Super uživatel - typPrav.superUzivatel Standardní uživatel - typPrav.uzivatel Obchodník - typPrav.obchodnik Účetní - typPrav.ucetni Mzdový účetní - typPrav.mzdovyUcetni Skladník - typPrav.skladnik Skladník s pokladnou - typPrav.skladnikSPokladnou Jen číst - typPrav.jenCist Neaktivní účet - typPrav.zablokovan -->
<pristupK showAs="Administrátor">typPrav.admin</pristupK>
<!-- Odvozeno z role (objekt) - max. délka: 20 -->
<otecRole/>
<pristupova-prava>
<!-- Přístupová práva -->
<pristupove-pravo>
<!-- ID (celé číslo) - -->
<id>uuid:ADMIN-cTypZbozi</id>
<!-- Poslední změna (datum a čas) - -->
<lastUpdate/>
<!-- Typ přístupu Plný přístup - typPristPrav.plny Nepřístupné - typPristPrav.nepripustne Pouze číst - typPristPrav.pouzeCist Upřesnění přístupu - typPristPrav.upresneni -->
<typeK showAs="Plný přístup">typPristPrav.plny</typeK>
<!-- Klíč přístupového práva (řetězec) - -->
<groupKey>cTypZbozi</groupKey>
<!-- Role uživatele (objekt) - max. délka: 20 -->
<role ref="/c/demo141020_v26/role/1.xml" showAs="ADMIN: Administrátor">code:ADMIN</role>
<!-- Upřesňující přístupová práva Přidávat nové - Pridavat Měnit existující - Menit Mazat - Mazat Export - Export Import - Import Otevírat detail - OteviratDetail Měnit sloupce - Sloupce Kusovník - Kusovnik Stornovat - Storno Povolit slevu a změnu ceny - SlevaZmenaCeny Sumace - Sumace Služby - Sluzby Vazby - Vazby Hromadné změny - HromZmeny Vidět nákupní cenu - NakupCena Měnit zaúčtování - MenitZauctovani Měnit předpis zaúčtování - MenitTuo Generovat faktury ze smluv - GenerovatZeSmluv Podepisovat faktury - PodepsatFaktury Prodávat pod minimální marží - ProdejPodMinMarzi -->
<featureK>
<feature>Pridavat</feature>
<feature>Menit</feature>
<feature>Mazat</feature>
<feature>Export</feature>
<feature>Import</feature>
<feature>OteviratDetail</feature>
<feature>Sloupce</feature>
</featureK>
</pristupove-pravo>
....
....
</role>
2. Kópia role ADMIN s rovnakými právami
POST
https://demo.flexibee.eu/c/demo/role.xml
Vstup:
<winstrom version="1.0">
<role>
<kod>ADMIN_COPY</kod>
<nazev>Kopie role ADMIN.</nazev>
<otecRole>code:ADMIN</otecRole>
</role>
</winstrom>
3. Zistenie kľúčov pre menené práva
GET
https://demo.flexibee.eu/c/demo/role.xml
Výstup:
...
<pristupove-pravo>
<id>uuid:ADMIN-dDoklFak$$FAP</id>
<groupKey evidencePath="faktura-prijata">dDoklFak$$FAP</groupKey>
</pristupove-pravo>
...
<pristupove-pravo>
<id>uuid:ADMIN-dDoklFak$$FAV</id>
<groupKey evidencePath="faktura-vydana">dDoklFak$$FAV</groupKey>
</pristupove-pravo>
...
Je potrebné nájsť zodpovedajúce kľúče práv pre krok 4. Zaujímajú nás kľúče dDoklFak$$FAV a dDoklFak$$FAP.
4. Prístup k vydaným faktúram iba na čítanie a úplné vypnutie prístupu k prijatým faktúram.
POST
https://demo.flexibee.eu/c/demo/role.xml
Vstup
<winstrom version="1.0">
<role>
<!-- identifikace měněné role -->
<id>code:ADMIN_COPY</id>
<!-- definice nastavovaných přístupových práv -->
<pristPrava>
<!-- klíč pro FAV a nastavení práva pro čtení -->
<pristupove-pravo>
<groupKey>dDoklFak$$FAV</groupKey>
<typeK>typPristPrav.pouzeCist</typeK>
</pristupove-pravo>
<!-- klíč pro FAP a nastavení bez přístupu -->
<pristupove-pravo>
<groupKey>dDoklFak$$FAP</groupKey>
<typeK>typPristPrav.nepripustne</typeK>
</pristupove-pravo>
</pristPrava>
</role>
</winstrom>
FAQ
💡 Potrebujete poradiť? V prípade otázok k aplikácii nás kontaktujte na podporaflexi@abra.eu, prípadne prostredníctvom chatového okna v pravom dolnom rohu.