Začíname

Skôr než začnete písať integráciu, prečítajte si túto stránku celú: nájdete tu základnú adresu API, čo potrebujete na strane KROSu, v akom formáte si dáta vymieňate a ako vyzerá prvé overovacie volanie.

Base URL

Všetky požiadavky smerujte na https://api-economy.kros.sk. Jednotlivé endpointy nájdete pod cestou /api/{resource}.

Čo potrebujete

Na používanie API potrebujete účet v KROS Fakturácii alebo KROS Sklade a licenciu na prístup k API. Podmienky tejto licencie sa líšia podľa produktu KROS — overte si ich preto priamo vo svojom produkte KROS, alebo sa opýtajte na integracie@kros.sk.

Formáty dát

API prijíma aj vracia dáta vo formáte JSON, v kódovaní UTF-8. Dátumy a časy sú v tvare ISO 8601, napríklad 2022-12-07T08:56:08.693Z.

Pri hromadnom spracovaní platí limit 100 dokladov na jednu požiadavku, a to v oboch smeroch — pri odosielaní aj pri čítaní dát. Stránkovanie výsledkov riadia parametre top a skip.

Prvé volanie

Spojenie aj platnosť tokenu overíte volaním GET /api/auth/check.

curl https://api-economy.kros.sk/api/auth/check \
  -H "Authorization: Bearer <your-token>"

Čo toto API nepokrýva

Nepokryté produkty a agendy

Cez toto API nie sú dostupné dáta ani funkcie produktov OMEGA, ALFA plus, OLYMP, ONIX a CENKROS 4, ani oceňovanie nehnuteľností. Ak vaša integrácia potrebuje niektorú z týchto oblastí, nie je s týmto API realizovateľná — napíšte nám radšej vopred na integracie@kros.sk, než začnete plánovať prácu, ktorá sa cez toto API urobiť nedá.

Ďalší krok

Ďalej pokračujte výberom autorizačného modelu: Autorizácia — ktorý model si vybrať.