> Усі статті WIKI Helomi: /wiki/llms.txt

# ПриватБанк

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

## Можливості
- Рахунки з залишками; рахунок за замовчуванням.
- Імпорт проведених операцій за період у вибраний гаманець; гаманець «ПриватБанк» створюється сам.
- Категорії за призначенням: комісія, податки, зарплата.
- Без дублів: повтор за ID банку пропускається.

## 1. Налаштування
Підключає адміністратор. Дорога: «Налаштування» → «Інтеграції» → вкладка «Оплати» → картка «ПриватБанк» → «Підключення».

1. Токен: Приват24 для бізнесу → Каталог послуг → Інтеграція (Автоклієнт) → токен. У картці — рядок `PRIVATBANK_TOKEN` → «Ввести» → «Зберегти ключ».
2. Рахунок за замовчуванням (необов'язково): рядок `PRIVATBANK_ACCOUNT` — IBAN рахунку.
3. «Перевірити» читає залишки: успіх — «рахунків: N».

Ключі зберігаються зашифрованими й назад не показуються. Одна картка — один токен; кількох токенів (кількох клієнтів банку) поки нема. У режимі кількох організацій імпорт читає токен лише зі змінних сервера.

## 2. Імпортувати виписку
1. «Фінанси» → «Операції» → «Імпорт виписки».
2. Блок «ПриватБанк»: «Рахунок» («перший у гривні» або інший після «Показати рахунки»), «Гаманець» (вибраний або «ПриватБанк» (створиться)), «Від» і «До».
3. «Імпортувати з ПриватБанку».

## Правила імпорту й «Вхідні» (16.10)
Кожен рядок виписки ПриватБанк проходить правила імпорту («Налаштування → Фінанси → Правила імпорту»): категорія, виплата каналу (переказ з транзитного гаманця майданчика), переказ у інший гаманець або «не заводити». Без правила рядок отримує підказку категорії й потрапляє у «Вхідні» («Фінанси → Звірка») на перевірку; там же «Запам'ятати правило». Імпорт Марії йде тим самим шляхом. Докладно — стаття «Фінанси», розділи 7 і 7а.

## Можливі помилки
| Що ви бачите | Чому | Що зробити |
| --- | --- | --- |
| «Не налаштовано: додайте PRIVATBANK_TOKEN …» в «Імпорті виписки» | Токен не задано | Введіть токен у картці ПриватБанку |
| «не задано (у картці чи .env): PRIVATBANK_TOKEN, PRIVATBANK_ACCOUNT» | «Перевірити» без ключів | Введіть токен і IBAN |
| Повідомлення банку після «Перевірити» | Токен недійсний | Створіть новий токен в «Автоклієнті» |

## Для ШІ-співробітників
5`). Операції з виписки ШІ бачить у «Фінансах» (коли є доступ). Статтю ШІ читає інструментом `help("int-privatbank")`.

## Додаткова інформація
- Пов'язані статті: [Фінанси](finance.md), [Monobank](int-monobank.md).