API reference
Táto stránka je mapa, nie referencia. Tento web dokumentuje autorizačné a integračné scenáre — konkrétny, vždy aktuálny zoznam endpointov, ich parametrov a návratových tvarov nájdete v Swaggeri, ktorý sa generuje priamo z bežiaceho API.
Swagger
Interaktívna dokumentácia beží na https://api-economy.kros.sk/swagger/index.html. Tlačidlo Authorize vpravo hore umožňuje vložiť váš token a endpointy si priamo v prehliadači vyskúšať naživo. V rozbaľovacom zozname špecifikácií v hornej časti stránky si vyberiete aj špecifikáciu webhookov.
OpenAPI špecifikácie
Obe špecifikácie máme aj ako lokálnu kópiu priloženú k tomuto webu (pozri Pre AI agentov) — pre priame strojové spracovanie použite tie, pre vždy aktuálny stav použite live URL.
| Špecifikácia | Live URL | Lokálna kópia |
|---|---|---|
| KROS OpenAPI (endpointy) | https://api-economy.kros.sk/swagger/Api%20endpoints/swagger.json |
ai/kros-openapi.json |
| KROS Webhooks | https://api-economy.kros.sk/app-webhooks-swagger.json |
ai/kros-webhooks-openapi.json |
Skupiny endpointov
Endpointy KROS OpenAPI sú rozdelené do desiatich skupín:
| Skupina | Popis |
|---|---|
| Auth | autentifikácia a získanie tokenu pre volania ostatných skupín |
| Invoices | vydané faktúry — nahrávanie, čítanie, stav spracovania |
| Proforma Invoices | zálohové (proforma) faktúry |
| Received Orders | prijaté objednávky, typicky z e-shopu |
| Delivery Notes | dodacie listy k vydaným dokladom |
| Expenses | prijaté náklady a výdavkové doklady |
| Payments | úhrady k dokladom a ich spárovanie |
| Warehouses | skladové karty, zostatky a pohyby na sklade |
| Attachments | prílohy pripojené k dokladom |
| Settings | nastavenia firmy a číselníky relevantné pre integráciu |
Vygenerovanie klienta
Ak potrebujete typovaného klienta vo vašom jazyku, vložte ktorúkoľvek z vyššie uvedených špecifikácií do https://editor.swagger.io/ a použite Generate Client pre zvolený jazyk.
Pre AI agentov
Ak namiesto ručného prehľadávania Swaggeru chcete, aby si integráciu napísal AI agent, pozrite si stránku Naučiť AI agenta — obsahuje hotový prompt aj odkazy na strojovo spracovateľný balík tohto webu vrátane oboch špecifikácií vyššie.