Extrase de cont: cum să configurați Privat24, monobank și UKRSIBBANK și să verificați conexiunea

Atunci când clienții achită facturile prin IBAN, antreprenorul trebuie să vadă aceste încasări nu doar în contul bancar, ci și în Torgsoft. Pentru aceasta este disponibilă opțiunea contra cost «Extrase bancare»: programul preia tranzacțiile din conturile conectate de la PrivatBank, monobank și UKRSIBBANK. La utilizarea acestei funcționalități pot apărea mai multe întrebări: cum se conectează o anumită bancă, ce date trebuie obținute din platforma bancară pentru afaceri, de ce extrasele nu se mai descarcă și de ce un utilizator le poate vedea, iar altul — nu. 

Cum funcționează extrasele bancare în Torgsoft

În Torgsoft, pentru fiecare cont bancar se creează o configurație de conectare separată. În interfață, aceasta se numește Merchant. În acest context, este pur și simplu un profil în care se specifică:

• ce bancă este utilizată;

• din ce cont trebuie preluate tranzacțiile;

• cu ce cont bancar din Torgsoft este asociat;

• ce date sunt necesare pentru accesarea API-ului băncii;

• care dintre utilizatorii Torgsoft au dreptul să vizualizeze aceste extrase.

După configurare, extrasele pot fi accesate prin Plată → Extrase din conturi bancare. Selectați perioada și apăsați «Obține extrasele». Torgsoft va afișa tranzacțiile returnate de bancă pentru perioada selectată. 

Ce trebuie verificat înainte de conectarea băncii

Înainte de configurare, este recomandat să verificați patru aspecte.

1. Opțiunea «Extrase bancare» este activată.

2. Contul bancar necesar a fost deja creat în Torgsoft, cu IBAN-ul și moneda corecte.

3. Aveți acces la platforma bancară pentru afaceri în care este deschis acest cont.

4. Este instalată versiunea actualizată a Torgsoft. Acest lucru este deosebit de important pentru integrările bancare: banca poate modifica cerințele API-ului, iar versiunile mai vechi ale programului pot să nu includă încă aceste modificări. 

După aceea, deschideți Setări → Configurarea extraselor din conturile bancare, creați o conexiune nouă și selectați Tip Merchant corespunzător.

PrivatBank: configurarea extraselor prin Privat24 pentru afaceri

Pentru PrivatBank, Torgsoft utilizează integrarea «AutoClient» / API-ul Privat24 pentru afaceri.

În interfața actuală PrivatBank, integrarea se află în secțiunea «Contabilitate și rapoarte» → «Integrare (AutoClient)». Acolo puteți activa API-ul și obține datele necesare pentru conectarea cu programul de gestiune.

Ce trebuie să faceți în Privat24

1. Autentificați-vă în Privat24 pentru afaceri, selectând întreprinderea corespunzătoare.

2. Deschideți integrarea «AutoClient».

3. Activați API-ul.

4. Creați o integrare pentru Torgsoft.

5. Obțineți datele de autorizare. Fiecare accesare a secțiunii de vizualizare a tokenurilor și identificatorilor din AutoClient poate genera tokenuri noi. Prin urmare, după fiecare accesare a acestor setări, tokenurile trebuie actualizate în Torgsoft.

Dacă în Privat24 sunt conectate mai multe Persoane fizice autorizate sau persoane juridice, verificați ce întreprindere este selectată în acel moment înainte de a crea integrarea. În caz contrar, este posibil să obțineți acces la alte conturi decât cele necesare.

Ce trebuie să introduceți în Torgsoft

La crearea conexiunii, selectați Tip Merchant → PrivatBank și completați:

• Număr card (cont) — IBAN-ul complet;

• Identificator client — ID-ul integrării;

• Denumirea contului — o denumire ușor de recunoscut;

• Cont bancar — contul corespunzător creat în Torgsoft;

• Token «AutoClient» — tokenul obținut în Privat24.

IBAN-ul trebuie să aparțină unui cont disponibil în cadrul întreprinderii Privat24 pentru care a fost creată integrarea. 

Dacă extrasele PrivatBank încetează brusc să se descarce

Mai întâi, verificați:

1. dacă IBAN-ul este corect;

2. dacă integrarea funcționează în Privat24;

3. dacă ID-ul sau tokenul nu au fost modificate;

4. dacă este instalată versiunea actualizată a Torgsoft.

Un caz aparte este mesajul: No mapping for the Unicode character exists in the target multi-byte code page

În septembrie 2026, această problemă a apărut după o modificare efectuată de PrivatBank: banca a schimbat modul de procesare a codificării caracterelor și a început să verifice mai strict tipul solicitării. Problema corespunzătoare din integrarea API a fost remediată în Torgsoft. Prin urmare, dacă apare acest mesaj, nu este necesar să schimbați contul sau să corectați manual datele extrasului — mai întâi actualizați Torgsoft la cea mai recentă versiune.

monobank: cont personal, Persoană fizică autorizată sau persoană juridică

În Torgsoft, pentru monobank, selectați Tip Merchant → MonoBank.

Apoi trebuie să stabiliți tipul contului:

• Personal/Persoană fizică autorizată;

• Contul unei persoane juridice.

Pentru conectare se utilizează un token MonoBankAPI. Documentația Torgsoft indică api.monobank.ua pentru obținerea acestuia: utilizatorul se autorizează printr-un cod QR și primește un token de acces. 

Pentru o Persoană fizică autorizată sau un cont personal

1. Obțineți tokenul monobank.

2. Introduceți-l în câmpul «Token MonoBankAPI».

3. Apăsați «Încarcă conturile».

4. Selectați contul necesar.

5. Asociați-l cu contul bancar corespunzător din Torgsoft.

Pentru o persoană juridică

După selectarea tipului corespunzător de cont, numărul acestuia se introduce manual. Pentru astfel de conturi, Torgsoft poate obține și informații despre expeditorul și beneficiarul plății. 

Dacă monobank nu returnează extrasul

Verificați pe rând:

• dacă tokenul a fost obținut pentru contul de utilizator corespunzător;

• dacă a fost selectat corect tipul contului;

• dacă a fost selectat contul în care există efectiv tranzacții;

• dacă acesta este asociat corect cu contul bancar din Torgsoft;

• dacă există tranzacții în monobank pentru perioada selectată.

Pentru prima verificare, este mai bine să solicitați o perioadă scurtă, de exemplu ziua curentă sau ultimele una-două zile. Astfel, este mai ușor să deosebiți o problemă de conectare de situația în care pur și simplu nu există tranzacții în perioada selectată.

UKRSIBBANK: de ce configurarea este diferită

Conectarea UKRSIBBANK este mai complexă, deoarece, pe lângă accesul la platforma bancară pentru afaceri, sunt necesare chei criptografice.

Pe scurt, aceste chei permit băncii să confirme că solicitarea de obținere a extrasului provine de la o conexiune Torgsoft autorizată.

Pasul 1. Instalați OpenSSL

Pentru integrarea cu UKRSIBBANK, documentația Torgsoft solicită versiunea pe 32 de biți a OpenSSL. Aceasta este utilizată la generarea cheilor pentru schimbul securizat de date cu banca. 

După selectarea Tip Merchant → UKRSIBBANK în Torgsoft, devine disponibilă funcția «Generează chei».

Pasul 2. Generați cheia privată și cheia publică

Torgsoft creează două fișiere:

• cheia privată rămâne la antreprenor și este utilizată pentru funcționarea integrării;

• cheia publică este transmisă către UKRSIBBANK.

Puteți seta o parolă pentru cheia privată. După generarea cheilor, rețineți neapărat unde sunt salvate fișierele. 

Pasul 3. Obțineți parametrii de la bancă

Cheia publică este transmisă către UKRSIBBANK pentru activarea conexiunii API. După înregistrare, banca furnizează parametrii Client_ID și Client_secret.

Aceștia trebuie introduși în câmpurile corespunzătoare ale conexiunii Torgsoft, împreună cu IBAN-ul contului.

Nu publicați Client_secret, cheia privată sau parola acesteia în capturi de ecran ori în corespondență.

Pasul 4. Autentificați-vă în UKRSIB business

La obținerea extrasului, Torgsoft deschide pagina de autorizare UKRSIB business. După autentificarea reușită, programul primește un token pentru comunicarea cu banca.

Dacă a trecut o zi de la ultima autorizare, trebuie să vă autentificați din nou. Aceasta este o parte normală a funcționării integrării, nu un semn de defecțiune. 

De ce nu se descarcă extrasele: ordinea verificărilor

Este important să verificați cauzele pe rând. Dacă PrivatBank funcționează, dar UKRSIBBANK nu, trebuie să verificați mai întâi configurarea UKRSIBBANK.

Cum să acordați acces unui contabil sau manager

Accesul la extrase poate fi configurat separat pentru fiecare utilizator.

Pentru un cont bancar sunt disponibile trei niveluri:

• Încasări — utilizatorul poate vedea tranzacțiile de intrare;

• Plăți efectuate — poate vedea tranzacțiile de ieșire;

• Acces complet — poate vedea toate tranzacțiile contului. 

Prin urmare, dacă proprietarul poate vedea extrasele, dar managerul vede o listă goală sau nu are accesul necesar, aceasta nu înseamnă neapărat că există o problemă cu banca. Verificați mai întâi drepturile utilizatorului.

Cum să verificați conexiunea după configurare

După finalizarea configurării, nu începeți imediat prin solicitarea extraselor pentru mai multe luni.

1. Deschideți platforma bancară și găsiți o zi în care știți sigur că au existat tranzacții.

2. În Torgsoft, deschideți Plată → Extrase din conturi bancare.

3. Selectați același cont.

4. Setați o perioadă scurtă — una sau două zile.

5. Apăsați «Obține extrasele».

6. Comparați câteva tranzacții cu cele din platforma bancară: data, suma și detaliile plății.

Dacă tranzacțiile corespund, conexiunea cu banca funcționează. În continuare, puteți configura modul de gestionare a plăților primite în Torgsoft.

Când trebuie să contactați asistența tehnică

Este necesar să contactați asistența dacă ați verificat deja corectitudinea contului, drepturile de acces și datele de autorizare, dar banca tot nu returnează extrasele sau programul afișează un mesaj de eroare tehnică.

Pentru a evita pierderea timpului cu reverificarea unor aspecte evidente, transmiteți specialistului:

• denumirea băncii;

• versiunea Torgsoft;

• tipul contului utilizat;

• perioada pentru care încercați să obțineți extrasul;

• textul exact al mesajului de eroare;

• pasul la care apare eroarea.

Nu trimiteți tokenuri, Client_secret, parole sau fișiere cu cheia privată prin mesaje obișnuite ori în capturi de ecran.