Súkromná beta Torevo Invoices s KROS

Torevo Invoices je provider-neutrálna Shopify aplikácia pre fakturačné workflow. Jej prvý provider v súkromnej bete prepája vhodné Shopify objednávky s KROS Fakturáciou a drží stav dokladu, spracovanie platieb, obnovu aj autorizovaný prístup k PDF pri objednávke.

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

Pilotný 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,
• schválený pilotný obchod v allowliste Torevo,
• úč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 Invoices → 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 Invoices 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 kontrolu dobropisu. Automatické plné, čiastočné a dopravné dobropisy zostávajú vypnuté, kým každý scenár nemá samostatnú živú účtovnú certifikáciu. Súkromná beta nesmie sľubovať automatické dobropisy.

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.

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álne limity súkromnej bety

• 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, kým certifikačné flags zostávajú vypnuté.
• Bez tvrdenia o odosielaní e-mailom; PDF je autorizovane dostupné v aplikácii.
• 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.