Torevo • KROS Fakturácia pre Shopify

Torevo • KROS Fakturácia prepája vhodné Shopify objednávky s vlastnou firmou obchodníka v KROS Fakturácii. Pri objednávke drží kontrolu súčtov a firemných údajov, stav dokladu, podporované platby, obnovu aj autorizovaný prístup k PDF.

Praktický popis každej obrazovky, tlače z detailu objednávky a hromadných akcií nájdete v Sprievodcovi obrazovkami Torevo • KROS Fakturácia.

Torevo je nezávislý dodávateľ softvéru. Použitie názvu KROS opisuje kompatibilitu a neznamená oficiálny, certifikovaný alebo partnerský vzťah.

Predpoklady

Obchodník potrebuje:

• kompatibilný Shopify obchod a oprávnenie prenášať údaje objednávok a faktúr,
• podporovaný účet KROS, licenciu a prístup k API,
• Shopify dev alebo produkčný obchod, v ktorom je aplikácia oprávnene nainštalovaná,
• účtovníkom potvrdené číslovanie, DPH a dátumové pravidlá,
• dokončený testovací plán so syntetickými údajmi zákazníka a objednávky.

Licenčné alebo používateľské poplatky KROS sú oddelené od prípadného plánu Torevo fakturovaného cez Shopify.

Bezpečne pripojte KROS

Otvorte Torevo • KROS Fakturácia → Pripojenie KROS, vytvorte účet poskytovateľa a zadajte API token. Token je šifrovaný a iba zapisovateľný; aplikácia ukáže jeho prítomnosť, ale nikdy ho znovu nezobrazí.

Spustite kontrolu spojenia, vyberte vhodnú číselnú radu a v KROS zaregistrujte HTTPS callback adresu konkrétneho účtu. Callback sa spracuje až po úspešnom overení podpisu. Opakované udalosti sa deduplikujú.

Do správy podpore nevkladajte tokeny, callback secrets, PDF faktúry ani záznamy zákazníkov.

Nastavte pravidlá fakturácie

Pred prípravou dokladu skontrolujte:

1. číslovanie dokladov a dátumovú politiku,
2. stav platiteľa DPH a podporované daňové spracovanie,
3. zdroj identity partnera pre B2C a B2B objednávky,
4. mapovanie produktov, zliav a dopravy,
5. platobné profily známych Shopify brán,
6. pravidlá automatického vytvorenia a ich kill switches.

Neznáma brána, chýbajúca firemná identita, nepodporovaná kombinácia meny/dane alebo nesúlad súčtu bezpečne skončí manuálnou kontrolou.

Pripravte a odošlite faktúru

Otvorte objednávku v Torevo • KROS Fakturácia alebo použite akciu pri objednávke v Shopify Admin. Aplikácia znovu načíta Shopify, zostaví aktuálny náhľad a zosúladí produkty, zľavy, dopravu, dane aj konečný súčet.

Odoslanie je asynchrónne. Po prijatí požiadavky v KROS uloží Torevo identifikátor a čaká na podpísaný callback alebo bezpečné zosúladenie. Ďalšiu faktúru nevytvorí iba preto, že callback mešká.

Doklad prechádza explicitnými stavmi, napríklad pripravený, odoslaný, spracovávaný, prijatý, čaká na PDF, pripravený alebo vyžaduje kontrolu. História nezobrazuje surové odpovede KROS ani payloady zákazníka.

Platby a refundácie

Nakonfigurované Shopify transakcie možno zaregistrovať k prijatej faktúre. Každá transakcia poskytovateľa má idempotency key, preto opakovaný webhook alebo retry workera nezaregistruje tú istú platbu dvakrát.

Čiastočné a viacnásobné platby zostávajú viditeľné ako samostatné operácie. Neznáma brána alebo nejednoznačné párovanie vyžaduje manuálnu kontrolu.

Refundácie sa vyhodnocujú pre účtovnú kontrolu. Aktuálne KROS API nevie vytvoriť dobropis, preto aplikácia plný, čiastočný ani dopravný dobropis neodosiela. Obchodník ho vytvorí priamo v KROS a výsledok manuálne overí.

Prístup k PDF

Keď je nakonfigurovaný report KROS pripravený, background job stiahne PDF do súkromného tenant-scoped úložiska. Otvoriť ho môže iba prihlásený používateľ patriaci k danému Shopify obchodu.

Aplikácia nevystavuje úložisko dokladov cez verejnú URL. Chýbajúce alebo poškodené PDF zostane v obnoviteľnom stave a možno ho skúsiť znovu bez vytvorenia ďalšej faktúry.

Personál môže PDF otvoriť alebo vytlačiť z bloku pri Shopify objednávke a zo stránky Doklady. Zákazník ho môže stiahnuť z chráneného stavu objednávky po prihlásení; voliteľný odkaz v Shopify notifikácii vedie na túto stránku, nie na trvalé PDF.

Zosúladenie a obnova

Zosúladenie použite pri oneskorenom callbacku, nejasnom výsledku poskytovateľa alebo doklade v KROS, ktorý ešte nie je pripojený k lokálnemu záznamu. Jedinečnú overenú zhodu možno pripojiť; nejednoznačná zostane v stave vyžadujúcom kontrolu.

Neistý výsledok neriešte opakovaným odoslaním faktúry. Zaznamenajte bezpečné ID dokladu, ID požiadavky, čas a chybový kód a použite obrazovku operácií alebo podpory.

Aktuálny verejný rozsah

• Bez verejného install linku do schválenia Shopify review a listingu.
• Bez tvrdenia o oficiálnom, partnerskom alebo certifikovanom vzťahu s KROS.
• Bez tvrdení o POS, bločkoch, proforme, zálohovej/konečnej faktúre alebo historickom importe.
• Bez tvrdenia o automatických dobropisoch; aktuálne KROS API ich nevie vytvoriť.
• Bez vlastného SMTP alebo priameho e-mailového odosielania PDF; notifikáciu naďalej posiela Shopify a zákazník otvára chránený stav objednávky.
• Menové, daňové a účtovné kombinácie sú podporované až po explicitnom pilotnom overení.

Odpojenie, odinštalovanie a podpora

Odpojenie účtu poskytovateľa zastaví nové odoslania, ale zachová bezpečné referencie a audit potrebný na pochopenie existujúcich dokladov. Odinštalovanie spustí shop-scoped cleanup a retenčné workflow; zákonná archivácia faktúr v KROS zostáva zodpovednosťou obchodníka.

Podpore pošlite doménu obchodu, bezpečné ID dokladu alebo operácie, čas a viditeľný chybový kód. Nikdy neposielajte access tokeny, celé údaje zákazníka, prílohy faktúr ani surové Shopify/KROS payloady.