# KROS API — dokumentácia pre integrátorov

> KROS OpenAPI umožňuje externej aplikácii čítať a zapisovať faktúry, zálohové faktúry,
> prijaté objednávky, dodacie listy, výdavky, platby a skladové dáta v KROS Fakturácii
> a KROS Sklade. Dokumentácia popisuje tri modely autorizácie a typické scenáre napojenia.

## Dokumentácia

- [KROS API pre integrátorov](https://api.krosdoplnky.sk/md/index.md): Rozcestník: tri modely napojenia na KROS API a ako si vybrať ten správny.
- [Čo API umožňuje](https://api.krosdoplnky.sk/md/co-umoznuje.md): Rozsah dát, ktoré si vaša aplikácia a KROS cez API vymieňajú: čo sa dá do KROSu zapísať, čo z neho čítať a čo API nepokrýva.
- [Naučiť AI agenta](https://api.krosdoplnky.sk/md/ai.md): Hotový prompt, ktorý AI agentovi povie, čo si má stiahnuť, aby vedel napísať integráciu.
- [Začíname](https://api.krosdoplnky.sk/md/zaciname.md): Base URL, predpoklady, formáty dát, limity a čo toto API nepokrýva.
- [Autorizácia — ktorý model si vybrať](https://api.krosdoplnky.sk/md/autorizacia-index.md): Porovnanie manuálneho tokenu, Integration Consent a Token Brokera.
- [Manuálny token](https://api.krosdoplnky.sk/md/autorizacia-manualny-token.md): Používateľ si vygeneruje API token v KROS Fakturácii alebo Sklade a vloží ho do vašej aplikácie.
- [Integration Consent](https://api.krosdoplnky.sk/md/autorizacia-integration-consent.md): Self-service autorizácia bez registrácie — post mode a poll mode.
- [Token Broker — automatické prihlásenie](https://api.krosdoplnky.sk/md/autorizacia-token-broker.md): Auto-login doplnku bežiaceho vnútri KROS platformy: RS256 JWT, JWKS, launch code.
- [Najčastejšie integrácie](https://api.krosdoplnky.sk/md/integracie-index.md): Overené scenáre napojenia a endpointy, ktoré v nich odporúčame použiť.
- [E-shop → KROS](https://api.krosdoplnky.sk/md/integracie-eshop.md): Objednávky a faktúry z e-shopu do KROSu, skladové karty a zostatky späť.
- [POS → KROS](https://api.krosdoplnky.sk/md/integracie-pos.md): Skladové karty do pokladne, predaje a tržby späť do KROSu.
- [eFaktúra](https://api.krosdoplnky.sk/md/integracie-efaktura.md): Napojenie na eFaktúru pripravujeme — dokumentáciu doplníme, keď KROS API rozšírime o potrebnú funkčnosť.
- [Webhooky](https://api.krosdoplnky.sk/md/webhooky.md): Tri eventy, ktoré KROS posiela na váš endpoint, a verifikácia podpisu.
- [Chyby a limity](https://api.krosdoplnky.sk/md/chyby-a-limity.md): HTTP kódy, štruktúra chybových odpovedí, rate limity a retry stratégia.
- [Obchod doplnkov](https://api.krosdoplnky.sk/md/doplnky-store.md): Ako dostať doplnok do obchodu v KROS aplikácii a čo obsahuje manifest.json.
- [API reference](https://api.krosdoplnky.sk/md/api-reference.md): Skupiny endpointov, odkazy na Swagger a lokálne kópie OpenAPI špecifikácií.

## Špecifikácie

- [KROS OpenAPI](https://api.krosdoplnky.sk/ai/kros-openapi.json): OpenAPI 3.0 špecifikácia endpointov.
- [KROS Webhooks](https://api.krosdoplnky.sk/ai/kros-webhooks-openapi.json): OpenAPI 3.0 špecifikácia webhookov.
- [Celá dokumentácia v jednom súbore](https://api.krosdoplnky.sk/ai/llms-full.txt)