Pripojenie účtu KROS Fakturácia

Torevo • KROS Fakturácia 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 nastaviť 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 • KROS Fakturácia → Pripojenie 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 Overiť spojenie. Pokračujte až vtedy, keď kontrola potvrdí správnu firmu a dostupné konfiguračné údaje. Ak spravujete viac firiem, vytvorte pre každú samostatný účet poskytovateľa a nikdy medzi nimi nekopírujte tokeny bez kontroly identity firmy.

Adresa spätného volania a autorizačný kľúč

Torevo zobrazí HTTPS adresu spätného volania konkrétneho účtu poskytovateľa. Túto adresu vložte do API prepojenia v KROS a nastavte autorizačný kľúč webhooku. Rovnaký kľúč uložte v Torevo.

KROS označuje adresu spätného volania 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 nenahrádza adresu spätného volania.

Pred prvým dokladom overte:

• že URL patrí správnemu Shopify obchodu a účtu poskytovateľa,
• ž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é adresy spätného volania 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 účtu KROS, trigger, podmienky, dátumová a platobná politika	Torevo • KROS Fakturácia
Číslo a výsledný obsah prijatého dokladu	KROS Fakturácia
Stav odoslania, callbacku, PDF, zosúladenia a audit rozhodnutia	Torevo • KROS Fakturácia

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 zostava a platobný účet

Vyberte PDF zostavu dostupnú v pripojenej firme. Aktuálne rozhranie konektora podporuje zostavy 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 a refundáciu vrátane manuálneho dobropisu v KROS,
• povinnú archiváciu a prístup k dokladom.

Aktuálne KROS API vytvorenie dobropisu nepodporuje. Torevo preto refundáciu ponechá na kontrolu a dobropis vytvoríte manuálne priamo v KROS. Neznáma kombinácia má vždy 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 spätné volanie, 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 obnovte v KROS, aktualizujte Torevo a overte spojenie. Pri zmene autorizačného kľúča webhooku koordinujte obe strany, aby nevzniklo obdobie s neoveriteľnými spätnými volaniami.

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í.