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

# Картки, кредитки й особисте

Кожна картка, з якої йдуть гроші, — окремий гаманець у Helomi: тоді переказ на неї стає переміщенням, а не витратою, а покупки з неї видно там, де вони були. Кредитна картка без API (ПУМБ, картка NovaPay) живе як гаманець з кредитною лінією «за гаманцем»: винні банку = ліміт мінус залишок. Особисті витрати власника (продукти, кафе, аптека) мають свою категорію й розносяться самі за кодами торгових точок, тож не псують прибуток бізнесу.

## Можливості
- Майстер «Кредитна картка»: гаманець і кредитна лінія одним екраном; борг і «погасити до» рахуються з балансу гаманця.
- Виписка файлом XLSX або CSV для будь-якого банку без API: карта колонок вгадується й запам'ятовується на гаманець, дублів нема.
- «Внести залишок з банку» для картки, якою користуються зрідка: різниця з журналом стає одним рядком у «Нерознесених».
- «Особисті витрати власника»: клас «Зарплата» або «Виведення власнику» одним перемикачем, типові правила побуту, ліміт на місяць, «Усе → особисте» в «Аналізі».
- Блок «Картки» у «Налаштування → Фінанси → Бізнеси й рахунки»: по кожній — чия, звідки виписка, борг, нерознесене, що робити далі.

## 1. Чому прибуток показує мінус
Якщо «P&L по бізнесах» іде в мінус, а бізнес прибутковий, зазвичай у журналі не вистачає гаманців для частини карток і адреси для особистого.

1. Особисті покупки з картки бізнесу лягли в «Інші витрати» — зменшують прибуток. Рішення — розділ 4.
2. Переказ на картку, якої нема в CRM (погашення кредитки), записався витратою, бо другого гаманця не існує. Рішення — розділ 2.
3. Погашення кредитки стало витратою, а не поверненням боргу. Рішення — розділ 2 і 3.
4. «Грошовий потік» і P&L читають як одне: переказ собі справді зменшує гроші на рахунку, але прибутку не чіпає.

> [!TIP]
> Пройдіть розділи 2–4 один раз. Далі виписки й правила працюють самі, а «Нерознесені → Аналіз» підказує, що ще лишилось.

## 2. Завести кредитну картку без API
Картка ПУМБ чи NovaPay, яку банк не віддає через API, стає гаманцем з кредитною лінією «за гаманцем».

1. Відкрийте «Фінанси → Гаманці» або «Налаштування → Фінанси → Бізнеси й рахунки».
2. Натисніть «+ Рахунок або картку» і оберіть «Кредитна картка (ПУМБ, NovaPay, чорна Моно)».
3. Впишіть назву, банк, кредитний ліміт і «Залишок зараз» — так, як показує застосунок банку, разом із кредитними коштами.
4. Оберіть, чия картка: «фізособа» (не гроші бізнесу) або «юрособа».
5. Натисніть «Додати». Гаманець з'явиться в «Картках фізосіб», лінія — у «Кредитах» з пігулкою «за гаманцем».

Після цього покупки карткою — витрати гаманця картки, а переказ з рахунку на картку — переміщення. Борг у «Кредитах» перераховується після кожної операції: винні = ліміт − баланс, «можна взяти» = баланс, «погасити до» — кінець пільгового періоду від дня, коли борг зріс.

> [!NOTE]
> Картка Monobank під'єднується інакше: «Інтеграції → Monobank → Картки цього токена → Підключити як акаунт» — ліміт і борг тягнуться з банку самі (стаття [Monobank](int-monobank.md)).

### Переказ на картку — переміщення, а не витрата
1. Відкрийте «Фінанси → Нерознесені → ⋮ → Правила рознесення».
2. Додайте правило: банк «Monobank», напрямок «списання», слова опису — як банк пише назву вашої картки (наприклад «ПУМБ»), дія «Переказ у інший гаманець», гаманець — «ПУМБ кредитка», «проводити без перевірки».
3. Збережіть. Нові рядки виписки стануть переміщеннями, уже проведені — після «Застосувати правила зараз».

Коли обидві виписки заходять самі (дві картки Monobank), пари знаходяться без правила — «Налаштування рознесення → Переміщення між своїми».

## 3. Завантажити виписку файлом
Для банку без API виписку вивантажують із застосунку як XLSX чи CSV і кладуть у CRM. Рядки проходять ті самі правила рознесення, звірку з внесеними вручну і «Вхідні», що й виписки Monobank.

1. Відкрийте «Фінанси → Операції → ⋮ → Імпорт виписки банку», блок «З файлу».
2. Оберіть гаманець картки й файл (до 5 МБ, до 5 000 рядків за раз).
3. Натисніть «Переглянути»: Helomi покаже заголовки, вгадану карту колонок (дата, сума або окремі «списання» і «надходження», опис, контрагент, MCC, залишок) і перші рядки так, як вони прочитаються.
4. Поправте колонки чи знак суми, якщо щось прочиталося не так; рядки без дати чи суми видно окремо.
5. Увімкніть «Звірити залишок за останнім рядком», якщо у файлі є колонка залишку: різниця з журналом стане рядком у «Нерознесених».
6. Натисніть «Імпортувати». У тості — скільки нових, за правилами, у «Вхідних»; карта колонок запам'ятована на гаманець.

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

> [!WARNING]
> PDF поки не читається — вивантажте XLSX або CSV. Старий формат .xls теж ні: збережіть у банку як XLSX.

## 4. Відокремити особисте від бізнесу
Особисті витрати власника мають свою категорію і клас, який обирає людина; правила побуту розносять їх самі.

1. Відкрийте «Фінанси → Нерознесені → ⋮ → Налаштування рознесення», група «Особисті витрати».
2. Перемикач «Рахувати як»: «Зарплата» — особисте зменшує прибуток як оплата праці власника; «Виведення власнику» — у прибуток не входить, у P&L окремим довідковим рядком. Зміна переставляє клас категорії «Особисті витрати власника».
3. У «Картки, де типово особисте» позначте особисті картки: їхні витрати перевіряються в «Нерознесених», а без іншої підказки отримують «особисте».
4. Натисніть «Увімкнути типові правила побуту»: правила за MCC продуктів, кафе, аптек, одягу, краси, таксі, розваг і універмагів → «Особисті витрати власника», без перевірки. Кожне правило можна вимкнути чи змінити в «Правилах рознесення»; повторне натискання не дублює.
5. За бажанням впишіть «Ліміт на місяць»: перевищення — порада в «Аналізі» й рядок у ранковому підсумку Марії.

У «Нерознесені → Аналіз» (витрати) є картка «Схоже на особисте» — скільки рядків з MCC побуту чи з особистих карток ще без категорії — з кнопкою «Усе → особисте». Бізнесові покупки з особистої картки (картон, скотч) лишаються витратою на бізнес і водночас внеском власника.

## 5. Вести картку без виписки
Картка, якою користуються зрідка, не потребує виписки: раз на місяць вносять залишок із застосунку банку.

1. Відкрийте «Фінанси → Гаманці» і знайдіть картку без банку — на ній рядок «Залишок рукою».
2. Натисніть «Внести залишок з банку», впишіть суму з застосунку (для кредитки — разом із кредитними коштами) і, якщо треба, момент.
3. Натисніть «Внести». Баланс журналу стане рівним банку, лінія «за гаманцем» перерахує борг.
4. Якщо журнал не сходився, у «Нерознесених» з'явиться рядок «Різниця зі звірки …» — рознесіть його (особисте, бізнес, переміщення) або внесіть забуті операції й видаліть рядок.

Повторне внесення того самого моменту замінює рядок різниці, а не додає другий.

## 6. Подивитися всі картки разом
«Налаштування → Фінанси → Бізнеси й рахунки», блок «Картки» — по кожній особистій картці й картці з кредитною лінією: чия, баланс, винні з ліміту і «до» якого дня, звідки виписка (API банку · файл · рукою · ще ніяк) і коли була остання, скільки нерознесеного, і рядок «Далі» з одною дією.

## Можливі помилки
| Що бачите | Чому | Що зробити |
| --- | --- | --- |
| «вкажіть кредитний ліміт картки (більше нуля)» | у майстрі не вписано ліміт | впишіть ліміт із застосунку банку |
| «борг цієї лінії рахується з гаманця картки…» | «Взяли» чи «Погасили» для лінії «за гаманцем» | покупки й погашення — операції самого гаманця: виписка, «+ Новий платіж», переміщення |
| «вкажіть колонку з датою» або «вкажіть колонку із сумою» | карта колонок неповна | у перегляді оберіть колонки дати й суми (або «списання» / «надходження» зі знаком «окремі колонки») |
| «Спершу перевірте карту колонок (попередній перегляд)» | для гаманця ще нема шаблону | натисніть «Переглянути», перевірте й імпортуйте — шаблон запам'ятається |
| «файл більший за 5 МБ» | завеликий файл | вивантажте коротший період |
| «PDF поки не читається» | банк дав PDF | вивантажте XLSX або CSV |
| «дата залишку не може бути в майбутньому» | момент у «Внести залишок» пізніший за зараз | лишіть порожнім (зараз) або впишіть минулий момент |
| прибуток у мінусі після всього | особисте ще в «Інших витратах» | «Нерознесені → Аналіз → Усе → особисте» і «Застосувати правила зараз» |

## Для ШІ-співробітників
Ті самі маршрути й перевірки, що в людини (розділ «Фінанси», для записів — «проводити й змінювати платежі»).
- `finance_personal_summary` (`month`) — особисте за місяць: категорія і як рахується, сума, ліміт і перевищення, по картках, `unallocated_like` — нерознесені, схожі на особисте (`ids` для `fin_unallocated_bulk` з `action=category`).
- `fin_personal_household_rules` — увімкнути типові правила побуту; лише через «Підтвердити» адміністратора.
- `fin_allocation_settings_set` з `personal_as`, `personal_purses`, `personal_limit` — перемикач і картки; через «Підтвердити».
- `finance_file_import_preview` (`purse_id`, `filename`, `data_base64`, `mapping`) — як прочитається файл; `finance_file_import` — імпорт, через «Підтвердити», дублів не робить.
- Лінія «за гаманцем» — звичайні інструменти «Кредитів» (`finance_credits`), поле `mode=purse`; «Взяли» / «Погасили» для неї не застосовуються.
- `finance_bank_check` для картки без банку не працює: ручний залишок вносить людина кнопкою на картці гаманця.

## Додаткова інформація
- [Фінанси](finance.md) — журнал, нерознесені, правила рознесення, звірка з банком, кредити.
- [Monobank](int-monobank.md) — картки Monobank як акаунти, лінія «за банком».