Банківські виписки: як налаштувати Приват24, monobank та UKRSIBBANK і перевірити підключення

Коли покупці оплачують рахунки за IBAN, підприємцю потрібно бачити ці надходження не лише в банку, а й у Торгсофт. Для цього призначена платна опція «Банківські виписки»: програма отримує операції за підключеними рахунками ПриватБанку, monobank та UKRSIBBANK. При роботі з функціоналом можуть виникнути низка питань: як підключити конкретний банк, які дані взяти в банківському кабінеті, чому виписки перестали завантажуватися та чому один користувач їх бачить, а інший — ні. 

Як працюють банківські виписки в Торгсофт

У Торгсофт для кожного банківського рахунку створюється окреме налаштування підключення. В інтерфейсі воно називається Merchant. У цьому випадку це просто профіль, у якому зазначено:

• який банк використовується;

• з якого рахунку отримувати операції;

• який розрахунковий рахунок Торгсофт із ним пов'язаний;

• які дані потрібні для доступу до банківського API;

• хто з користувачів Торгсофт має право бачити ці виписки.

Після налаштування виписки відкриваються через Оплата → Виписки з банківських рахунків. Потрібно вибрати період і натиснути «Отримати виписки». Торгсофт покаже операції, які банк повернув за цей період. 

Що перевірити до підключення банку

Перед налаштуванням краще одразу перевірити чотири речі.

1. Опція «Банківські виписки» активована.

2. У Торгсофт уже створений потрібний розрахунковий рахунок із правильним IBAN та валютою.

3. Є доступ до бізнес-кабінету банку, у якому відкрито саме цей рахунок.

4. Встановлена актуальна версія Торгсофт. Це особливо важливо для банківських інтеграцій: банк може змінити вимоги до API, а в старих версіях програми ці зміни ще не враховані. 

Після цього відкрийте Налаштування → Налаштування виписок по банківських рахунках, створіть нове підключення та оберіть потрібний Тип Merchant.

ПриватБанк: налаштування виписок через Приват24 для бізнесу

Для ПриватБанку Торгсофт працює через інтеграцію «Автоклієнт» / API Приват24 для бізнесу.

У чинному інтерфейсі ПриватБанку інтеграція знаходиться в «Облік та звіти» → «Інтеграція (Автоклієнт)». Там можна підключити API та отримати дані для зв'язку з обліковою програмою.

Що зробити в Приват24

1. Увійдіть у Приват24 для бізнесу під потрібним підприємством.

2. Відкрийте інтеграцію «Автоклієнт».

3. Підключіть API.

4. Створіть інтеграцію для Торгсофт.

5. Отримайте авторизаційні дані. Кожен вхід до пункту перегляду токенів та ідентифікаторів на стороні автоклієнта може генерувати нові токени, таким чином після кожного входу в ці налаштування, потрібно оновлювати токени в Торгсофт.

Якщо в Приват24 підключено кілька ФОП або юридичних осіб, перед створенням інтеграції перевірте, яке підприємство зараз обране. Інакше можна отримати доступ не до тих рахунків.

Що вказати в Торгсофт

При створенні підключення виберіть Тип Merchant → ПриватБанк і заповніть:

• Номер карти (рахунок) — повний IBAN;

• Ідентифікатор клієнта — ID інтеграції;

• Назва рахунку — зрозуміла назва для себе;

• Розрахунковий рахунок — відповідний рахунок, створений у Торгсофт;

• Токен «Автоклієнт» — token, отриманий у Приват24.

IBAN має належати до рахунків, доступних у тому підприємстві Приват24, для якого створено інтеграцію. 

Якщо виписки ПриватБанку раптом перестали завантажуватися

Спочатку перевірте:

1. чи правильний IBAN;

2. чи працює інтеграція в Приват24;

3. чи не змінювалися ID або token;

4. чи встановлена актуальна версія Торгсофт.

Окремий випадок — повідомлення: No mapping for the Unicode character exists in the target multi-byte code page

У вересні 2026 року така ситуація виникла після зміни з боку ПриватБанку: банк змінив обробку кодування та став суворіше перевіряти тип запиту. У Торгсофт відповідну роботу з API виправили. Тому при такому повідомленні не потрібно змінювати рахунок або вручну виправляти дані виписки — спочатку оновіть Торгсофт до актуальної версії.

monobank: персональний рахунок, ФОП або юридична особа

У Торгсофт для monobank оберіть Тип Merchant → MonoBank.

Далі потрібно визначити тип рахунку:

• Персональний/ФОП;

• Рахунок юридичної особи.

Для підключення використовується токен MonoBankAPI. У довідці Торгсофт для його отримання вказано api.monobank.ua: користувач авторизується через QR-код і отримує токен доступу. 

Для ФОП або персонального рахунку

1. Отримайте токен monobank.

2. Вставте його в поле «Токен MonoBankAPI».

3. Натисніть «Завантажити рахунки».

4. Оберіть потрібний рахунок.

5. Зв'яжіть його з відповідним розрахунковим рахунком Торгсофт.

Для юридичної особи

Після вибору відповідного типу рахунку його номер вводиться вручну. Для таких рахунків Торгсофт також може отримувати інформацію про відправника та одержувача платежу. 

Якщо monobank не повертає виписку

Перевіряйте послідовно:

• чи токен отримано для потрібного облікового запису;

• чи правильно обрано тип рахунку;

• чи вибрано саме той рахунок, за яким є операції;

• чи правильно він пов'язаний із розрахунковим рахунком Торгсофт;

• чи є операції в самому monobank за вибраний період.

Для першої перевірки краще запросити невеликий період, наприклад сьогодні або останні один-два дні. Так легше відрізнити проблему підключення від ситуації, коли за вибраний період просто немає операцій.

UKRSIBBANK: чому налаштування відрізняється

Підключення UKRSIBBANK складніше, тому що крім доступу до банківського кабінету потрібні криптографічні ключі.

Простими словами, ключі потрібні банку, щоб підтвердити: запит на отримання виписки надходить саме від дозволеного підключення Торгсофт.

Крок 1. Встановіть OpenSSL

Для інтеграції з UKRSIBBANK довідка Торгсофт вимагає 32-бітну версію OpenSSL. Вона використовується під час створення ключів для захищеного обміну з банком. 

Після вибору Тип Merchant → УКРСИББАНК у Торгсофт стане доступною дія «Згенерувати ключі».

Крок 2. Створіть приватний і публічний ключі

Торгсофт створює два файли:

• приватний ключ залишається у підприємця та використовується для роботи інтеграції;

• публічний ключ передається UKRSIBBANK.

Для приватного ключа можна встановити пароль. Після генерації обов'язково запам'ятайте, де збережені файли. 

Крок 3. Отримайте параметри від банку

Публічний ключ передається до UKRSIBBANK для підключення API. Після реєстрації банк надає параметри Client_ID та Client_secret.

Їх потрібно внести у відповідні поля підключення Торгсофт разом із рахунком IBAN.

Не публікуйте Client_secret, приватний ключ або пароль до нього у скриншотах і листуванні.

Крок 4. Авторизуйтеся в UKRSIB business

Під час отримання виписки Торгсофт відкриває авторизацію UKRSIB business. Після успішного входу програма отримує токен для роботи з банком.

Якщо з останньої авторизації минула доба, потрібно авторизуватися повторно. Це штатна частина роботи інтеграції, а не ознака несправності. 

Чому виписки не завантажуються: порядок перевірки

Важливо перевіряти причини по черзі. Якщо ПриватБанк працює, а UKRSIBBANK — ні, спочатку потрібно перевірити саме налаштування UKRSIBBANK.

Як надати доступ бухгалтеру або менеджеру

Доступ до виписок можна налаштовувати окремо для кожного користувача.

Для банківського рахунку передбачено три рівні:

• Надходження — користувач бачить вхідні операції;

• Відрахування — бачить вихідні операції;

• Повний доступ — бачить усі операції рахунку. 

Тому ситуація, коли власник бачить виписки, а менеджер — порожній список або не має потрібного доступу, не обов'язково означає проблему з банком. Спочатку перевірте права користувача.

Як перевірити підключення після налаштування

Після завершення налаштування не починайте одразу з виписки за кілька місяців.

1. Відкрийте банківський кабінет і знайдіть день, у якому точно були операції.

2. У Торгсофт відкрийте Оплата → Виписки з банківських рахунків.

3. Оберіть той самий рахунок.

4. Встановіть короткий період — один або два дні.

5. Натисніть «Отримати виписки».

6. Порівняйте кілька операцій із банківським кабінетом: дату, суму та призначення платежу.

Якщо операції збігаються, саме підключення до банку працює. Далі вже можна налаштовувати роботу з отриманими платежами в Торгсофт.

Коли варто звернутися до технічної підтримки

Звернення потрібне, якщо правильність рахунку, доступів і авторизаційних даних уже перевірена, але банк усе одно не повертає виписки або програма показує технічне повідомлення.

Щоб не витрачати час на повторну перевірку очевидних речей, передайте фахівцю:

• назву банку;

• версію Торгсофт;

• який тип рахунку використовується;

• за який період отримуєте виписку;

• точний текст повідомлення;

• на якому кроці воно виникає.

Токени, Client_secret, пароль або файл приватного ключа надсилати у звичайному повідомленні чи на скриншоті не потрібно.