Výpisy z bankového účtu: ako nastaviť Privat24, monobank a UKRSIBBANK a skontrolovať pripojenie

Keď zákazníci platia faktúry prostredníctvom IBAN, podnikateľ potrebuje vidieť tieto prijaté platby nielen v banke, ale aj v Torgsoft. Na tento účel slúži platená funkcia «Bankové výpisy»: program získava transakcie z pripojených účtov bánk PrivatBank, monobank a UKRSIBBANK. Pri používaní tejto funkcie môžu vzniknúť viaceré otázky: ako pripojiť konkrétnu banku, aké údaje získať z internetového bankovníctva, prečo sa výpisy prestali sťahovať a prečo ich jeden používateľ vidí, zatiaľ čo druhý — nie. 

Ako fungujú bankové výpisy v Torgsoft

V Torgsoft sa pre každý bankový účet vytvára samostatná konfigurácia pripojenia. V rozhraní sa nazýva Merchant. V tomto prípade ide jednoducho o profil, v ktorom je uvedené:

• ktorá banka sa používa;

• z ktorého účtu sa majú získavať transakcie;

• s ktorým bankovým účtom v Torgsoft je prepojený;

• aké údaje sú potrebné na prístup k bankovému API;

• ktorí používatelia Torgsoft majú oprávnenie zobrazovať tieto výpisy.

Po nastavení sa výpisy otvárajú cez Platba → Výpisy z bankových účtov. Je potrebné vybrať obdobie a kliknúť na «Získať výpisy». Torgsoft zobrazí transakcie, ktoré banka poskytla za zvolené obdobie. 

Čo skontrolovať pred pripojením banky

Pred nastavením je vhodné skontrolovať štyri veci.

1. Funkcia «Bankové výpisy» je aktivovaná.

2. V Torgsoft je už vytvorený požadovaný bankový účet so správnym IBAN a menou.

3. Máte prístup do firemného internetového bankovníctva, v ktorom je tento účet vedený.

4. Je nainštalovaná aktuálna verzia Torgsoft. Je to obzvlášť dôležité pri bankových integráciách: banka môže zmeniť požiadavky na API a staršie verzie programu tieto zmeny ešte nemusia zohľadňovať. 

Potom otvorte Nastavenia → Nastavenie výpisov z bankových účtov, vytvorte nové pripojenie a vyberte požadovaný Typ Merchant.

PrivatBank: nastavenie výpisov cez Privat24 pre podnikateľov

Pri banke PrivatBank využíva Torgsoft integráciu «AutoClient» / API služby Privat24 pre podnikateľov.

V aktuálnom rozhraní PrivatBank sa integrácia nachádza v časti «Účtovníctvo a výkazy» → «Integrácia (AutoClient)». Tu možno aktivovať API a získať údaje potrebné na prepojenie s účtovným programom.

Čo urobiť v Privat24

1. Prihláste sa do Privat24 pre podnikateľov pod príslušnou firmou.

2. Otvorte integráciu «AutoClient».

3. Aktivujte API.

4. Vytvorte integráciu pre Torgsoft.

5. Získajte autorizačné údaje. Pri každom otvorení sekcie na zobrazenie tokenov a identifikátorov v službe AutoClient sa môžu vygenerovať nové tokeny. Preto je po každej návšteve týchto nastavení potrebné aktualizovať tokeny v Torgsoft.

Ak je v Privat24 pripojených viacero živnostníkov alebo právnických osôb, pred vytvorením integrácie skontrolujte, ktorý podnik je aktuálne vybraný. Inak môžete získať prístup k nesprávnym účtom.

Čo zadať v Torgsoft

Pri vytváraní pripojenia vyberte Typ Merchant → PrivatBank a vyplňte:

• Číslo karty (účet) — celý IBAN;

• Identifikátor klienta — ID integrácie;

• Názov účtu — zrozumiteľný názov na vlastnú orientáciu;

• Bankový účet — príslušný účet vytvorený v Torgsoft;

• Token «AutoClient» — token získaný v Privat24.

IBAN musí patriť medzi účty dostupné v rámci podniku v Privat24, pre ktorý bola integrácia vytvorená. 

Ak sa výpisy z PrivatBank náhle prestanú sťahovať

Najskôr skontrolujte:

1. či je IBAN správny;

2. či integrácia v Privat24 funguje;

3. či sa nezmenilo ID alebo token;

4. či je nainštalovaná aktuálna verzia Torgsoft.

Osobitným prípadom je chybové hlásenie: No mapping for the Unicode character exists in the target multi-byte code page

V septembri 2026 sa tento problém objavil po zmene na strane PrivatBank: banka zmenila spracovanie kódovania a začala prísnejšie kontrolovať typ požiadavky. V Torgsoft bola príslušná chyba pri práci s API opravená. Preto pri tomto hlásení nie je potrebné meniť účet ani ručne opravovať údaje vo výpise — najskôr aktualizujte Torgsoft na najnovšiu verziu.

monobank: osobný účet, živnostník alebo právnická osoba

V Torgsoft pre monobank vyberte Typ Merchant → MonoBank.

Následne určite typ účtu:

• Osobný účet/živnostník;

• Účet právnickej osoby.

Na pripojenie sa používa token MonoBankAPI. V dokumentácii Torgsoft je na jeho získanie uvedená stránka api.monobank.ua: používateľ sa autorizuje pomocou QR kódu a získa prístupový token. 

Pre živnostníka alebo osobný účet

1. Získajte token monobank.

2. Vložte ho do poľa «Token MonoBankAPI».

3. Kliknite na «Načítať účty».

4. Vyberte požadovaný účet.

5. Prepojte ho s príslušným bankovým účtom v Torgsoft.

Pre právnickú osobu

Po výbere príslušného typu účtu sa jeho číslo zadáva ručne. Pri takýchto účtoch môže Torgsoft získavať aj informácie o odosielateľovi a príjemcovi platby. 

Ak monobank neposkytuje výpis

Postupne skontrolujte:

• či bol token získaný pre správny používateľský účet;

• či bol správne vybraný typ účtu;

• či ste vybrali účet, na ktorom sa skutočne uskutočnili transakcie;

• či je správne prepojený s bankovým účtom v Torgsoft;

• či v samotnej službe monobank existujú transakcie za zvolené obdobie.

Pri prvej kontrole je lepšie vyžiadať si výpis za krátke obdobie, napríklad za dnešný deň alebo posledný jeden až dva dni. Takto možno jednoduchšie odlíšiť problém s pripojením od situácie, keď za zvolené obdobie jednoducho neexistujú žiadne transakcie.

UKRSIBBANK: prečo je nastavenie odlišné

Pripojenie UKRSIBBANK je zložitejšie, pretože okrem prístupu do firemného internetového bankovníctva sú potrebné aj kryptografické kľúče.

Jednoducho povedané, banka pomocou kľúčov overuje, že požiadavka na získanie výpisu pochádza zo schváleného pripojenia Torgsoft.

Krok 1. Nainštalujte OpenSSL

Pri integrácii s UKRSIBBANK dokumentácia Torgsoft vyžaduje 32-bitovú verziu OpenSSL. Používa sa pri vytváraní kľúčov na zabezpečenú komunikáciu s bankou. 

Po výbere Typ Merchant → UKRSIBBANK v Torgsoft sa sprístupní funkcia «Vygenerovať kľúče».

Krok 2. Vytvorte súkromný a verejný kľúč

Torgsoft vytvorí dva súbory:

• súkromný kľúč zostáva u podnikateľa a používa sa na fungovanie integrácie;

• verejný kľúč sa odovzdáva banke UKRSIBBANK.

Pre súkromný kľúč možno nastaviť heslo. Po vygenerovaní si nezabudnite zapamätať, kde sú súbory uložené. 

Krok 3. Získajte parametre od banky

Verejný kľúč sa odovzdáva banke UKRSIBBANK na aktiváciu prístupu k API. Po registrácii banka poskytne parametre Client_ID a Client_secret.

Tieto údaje je potrebné zadať do príslušných polí pripojenia v Torgsoft spolu s IBAN účtu.

Nezverejňujte Client_secret, súkromný kľúč ani jeho heslo na snímkach obrazovky alebo v korešpondencii.

Krok 4. Prihláste sa do UKRSIB business

Pri získavaní výpisu Torgsoft otvorí autorizačnú stránku UKRSIB business. Po úspešnom prihlásení program získa token na komunikáciu s bankou.

Ak od poslednej autorizácie uplynul jeden deň, je potrebné prihlásiť sa znova. Ide o bežnú súčasť fungovania integrácie, nie o prejav poruchy. 

Prečo sa výpisy nesťahujú: postup kontroly

Dôležité je preverovať možné príčiny postupne. Ak PrivatBank funguje, ale UKRSIBBANK nie, najskôr treba skontrolovať práve nastavenia UKRSIBBANK.

Ako udeliť prístup účtovníkovi alebo manažérovi

Prístup k výpisom možno nastaviť samostatne pre každého používateľa.

Pre bankový účet sú k dispozícii tri úrovne:

• Prijaté platby — používateľ vidí prichádzajúce transakcie;

• Odchádzajúce platby — vidí odchádzajúce transakcie;

• Úplný prístup — vidí všetky transakcie na účte. 

Situácia, keď majiteľ vidí výpisy, ale manažérovi sa zobrazuje prázdny zoznam alebo nemá potrebný prístup, preto nemusí nevyhnutne znamenať problém s bankou. Najskôr skontrolujte oprávnenia používateľa.

Ako overiť pripojenie po nastavení

Po dokončení nastavenia nezačínajte hneď výpisom za niekoľko mesiacov.

1. Otvorte internetové bankovníctvo a nájdite deň, keď sa na účte určite uskutočnili transakcie.

2. V Torgsoft otvorte Platba → Výpisy z bankových účtov.

3. Vyberte ten istý účet.

4. Nastavte krátke obdobie — jeden alebo dva dni.

5. Kliknite na «Získať výpisy».

6. Porovnajte niekoľko transakcií s internetovým bankovníctvom: dátum, sumu a účel platby.

Ak sa transakcie zhodujú, samotné pripojenie k banke funguje. Následne môžete nastaviť spracovanie prijatých platieb v Torgsoft.

Kedy kontaktovať technickú podporu

Technickú podporu treba kontaktovať, ak ste už overili správnosť účtu, prístupových práv a autorizačných údajov, ale banka stále neposkytuje výpisy alebo program zobrazuje technické chybové hlásenie.

Aby ste nestrácali čas opakovanou kontrolou základných údajov, poskytnite pracovníkovi podpory:

• názov banky;

• verziu Torgsoft;

• typ používaného účtu;

• obdobie, za ktoré sa pokúšate získať výpis;

• presné znenie chybového hlásenia;

• krok, pri ktorom sa chyba objaví.

Tokeny, Client_secret, heslo ani súbor súkromného kľúča neposielajte v bežnej správe ani na snímke obrazovky.