Pripojenie účtu KROS Fakturácia

Torevo Invoices nepoužíva spoločný účet Torevo v KROS. Každý obchodník pripája vlastnú firmu vo webovej aplikácii KROS Fakturácia a zostáva zodpovedný za jej licenciu, účtovné nastavenia a správnosť dokladov.

Ktorý balík KROS potrebujete

Stav overený 19. júla 2026 podľa cenníka KROS Fakturácie a návodu KROS na prepojenie e-shopu:

Balík KROS	Verejná mesačná cena	API prepojenie	Vhodný pre Torevo
Zadarmo	0 €	nie je uvedené	nie
Základ	5,90 €	voliteľný doplnok 4,90 €	áno, po aktivovaní doplnku
Štandard	11,00 €	voliteľný doplnok 4,90 €	áno, po aktivovaní doplnku
KROS Firma	14,90 €	zahrnuté	áno

KROS uvádza mesačné ceny pri platbe na 12 mesiacov bez DPH. Pre základnú fakturáciu cez Torevo je podľa aktuálneho cenníka technicky postačujúci Základ + API prepojenie. KROS Firma ani KROS Sklad nie sú pre prvú verziu Torevo povinné; vyberte ich iba vtedy, keď potrebujete ich ďalšie funkcie. Ceny a podmienky sa môžu zmeniť, preto ich pred nákupom znovu overte priamo s KROS.

Čo si pripravte

Pripravte si:

• firmu vytvorenú vo webovej aplikácii KROS Fakturácia,
• zakúpený balík s aktívnou funkciou API prepojenie,
• dokončené firemné, fakturačné a DPH údaje,
• číselný rad určený pre doklady zo Shopify,
• používateľa oprávneného vytvoriť API token a webhook,
• rozhodnutie účtovníka o dátumoch, daniach, zaokrúhľovaní a platbách.

Vytvorenie API tokenu

1. Prihláste sa do správnej firmy v KROS Fakturácia.
2. Otvorte Nastavenia firmy → API prepojenia.
3. Vytvorte nové API prepojenie s jednoznačným názvom, napríklad Torevo – obchod.myshopify.com.
4. Zatiaľ nevytvárajte druhé prepojenie pre ten istý obchod; každé prostredie a právnická osoba musia byť pomenované jednoznačne.
5. Token vygenerujte až vtedy, keď ho môžete bezpečne uložiť. Skopírujte ho do správcu hesiel a následne do Torevo.
6. Token neposielajte e-mailom ani do podpory.

KROS podľa OpenAPI návodu zobrazí token iba pri vytvorení. Reset tokenu zneplatní predchádzajúci token; po rotácii ho preto okamžite vymeňte aj v Torevo a spustite kontrolu spojenia.

Vytvorenie účtu poskytovateľa v Torevo

V Torevo Invoices → Providers → KROS pridajte účet a pomenujte ho tak, aby bolo jasné, ktorej právnickej osobe a prostrediu patrí. Zadajte API token. Torevo token šifruje a po uložení ho už nezobrazuje.

Spustite Test connection. Pokračujte až vtedy, keď kontrola potvrdí správnu firmu a dostupné konfiguračné údaje. Ak spravujete viac firiem, vytvorte pre každú samostatný provider účet a nikdy medzi nimi nekopírujte tokeny bez kontroly identity firmy.

Callback a webhook secret

Torevo zobrazí HTTPS callback URL konkrétneho provider účtu. Túto adresu vložte do API prepojenia v KROS a nastavte autorizačný kľúč webhooku. Rovnaký secret uložte do Torevo.

KROS označuje callback URL a autorizačný kľúč ako voliteľné nastavenia svojho API, ale pre bezpečný asynchrónny tok Torevo sú obe hodnoty povinné. Ak chcete prijímať aj zmeny úhrad z KROS, v rovnakom prepojení zapnite Notifikácie o úhradách do API. Táto voľba nie je náhradou za callback URL.

Pred prvým dokladom overte:

• že URL patrí správnemu Shopify obchodu a provider účtu,
• že používa HTTPS a neobsahuje lokálnu alebo dočasnú adresu,
• že autorizačný kľúč je zhodný na oboch stranách,
• že prvá syntetická udalosť nehlási chybu podpisu,
• že staré callback adresy po zmene už nie sú aktívne.

Webhook udalosti sa môžu opakovať alebo prísť neskôr. Torevo ich overuje a deduplikuje; vypnuté overenie podpisu nie je podporované riešenie.

Čo nastavuje KROS a čo Torevo

Oblasť	Zdroj pravdy
Firemné údaje dodávateľa, DPH režim a dostupné číselné rady	KROS Fakturácia
Objednávka, riadky, zľavy, doprava, mena a Shopify transakcie	Shopify
Výber provider účtu, trigger, podmienky, dátumová a platobná politika	Torevo Invoices
Číslo a výsledný obsah prijatého dokladu	KROS Fakturácia
Stav odoslania, callbacku, PDF, zosúladenia a audit rozhodnutia	Torevo Invoices

Zmena v jednom systéme automaticky neznamená, že sa má spätne prepísať účtovný doklad v druhom. Už vystavené doklady opravujte účtovne schváleným postupom.

Číselný rad a dátum dokladu

Vyberte samostatný alebo účtovníkom schválený číselný rad. Skontrolujte jeho formát, nasledujúce číslo, obdobie a správanie na prelome roka. Číselný rad nemeníte uprostred spracovania čakajúcich dokladov bez kontrolovaného prechodu.

Nastavte podporovanú dátumovú politiku a overte dátum vystavenia, dodania a splatnosti na testovacej objednávke. Účtovné rozhodnutie nevykonáva aplikácia za obchodníka.

PDF report a platobný účet

Vyberte report dostupný v pripojenej firme. Aktuálne rozhranie konektora podporuje reporty KROS identifikované ako 17, 19 a 101; predvolený je 19. Dostupnosť a vzhľad vždy overte v konkrétnej firme.

Voliteľne nastavte ID platobného účtu, ak ho vyžaduje váš účtovný tok. Neodhadujte ho podľa názvu. Po prvej faktúre skontrolujte v PDF dodávateľa, odberateľa, riadky, dane, súčty, menu, splatnosť, číslovanie a platobné údaje.

Účtovné a automatizačné rozhodnutia

Pred aktiváciou vytvárania dokladov potvrďte s účtovníkom:

• B2C a B2B identitu odberateľa,
• stav platiteľa DPH a podporované sadzby,
• spracovanie zliav, dopravy a zaokrúhlenia,
• podporované meny a krajiny,
• mapovanie Shopify platobných brán,
• podmienky pre faktúru, platbu, refundáciu a dobropis,
• povinnú archiváciu a prístup k dokladom.

Automatické dobropisy nechajte vypnuté, kým nie je každý reálny scenár samostatne certifikovaný. Neznáma kombinácia má skončiť manuálnou kontrolou.

Povinný test pred automatizáciou

Použite syntetickú testovaciu objednávku bez reálnych osobných údajov. Manuálne vytvorte faktúru, prijmite callback, otvorte PDF, zaregistrujte podporovanú platbu a overte bezpečné zosúladenie. Potom zopakujte test pre B2B, zľavu, dopravu, daň a každú používanú menu.

Automatizáciu zapnite až po podpise interného kontrolného zoznamu obchodníka a účtovníka. Začnite obmedzenou podmienkou a sledujte prvé živé doklady.

Rotácia alebo odpojenie

Pri podozrení na únik token resetujte v KROS, aktualizujte Torevo a overte spojenie. Pri rotácii webhook secretu koordinujte obe strany, aby nevzniklo obdobie s neoveriteľnými callbackmi.

Odpojenie zastaví nové operácie. Nevymazáva zákonné doklady z KROS a nemení povinnosť obchodníka archivovať ich. Pred odinštalovaním exportujte potrebný audit a potvrďte stav čakajúcich operácií.