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

# ШІ Свєта — бухгалтерія бізнесу з партнерами: капітал, гроші бізнесу, виплати

Свєта — ШІ-бухгалтерка одного бізнесу, у якому є партнери (у Helomi — «Перший шар» Саші й Романа). Вона показує, скільки грошей у бізнесі, який прибуток за місяць, скільки кожен партнер вклав і вивів, який у нього капітал і скільки йому до виплати; рахує виплату за період і готує чернетку, яку затверджує й проводить людина. Усі цифри — зі звітів вашої CRM («Фінанси → Партнери», P&L бізнесу), налаштування — у її пульті, керувати нею можуть люди й інші ШІ (Ломі).

## Можливості
- «До виплати партнерам», гроші бізнесу (рахунки й каса бізнесу), прибуток місяця з P&L бізнесу, капітал — на одному екрані.
- Капітал кожного партнера: внесено (у тому числі витрати з його кишені на бізнес), виведено, частка прибутку, капітал, до виплати.
- Розрахунок виплати за період з угод бізнесу (сума − собівартість − комісія, частки партнерів і товарів) і чернетка виплати.
- Дані лише з CRM: частки партнерів — у бренді («Партнери бізнесу»), частки товарів — у картці товару («Партнери»).

## 1. Налаштування
Свєта з'являється в «Інтеграції → ШІ» як картка «Свєта» (вид «Агент») і в «Налаштування → Команда → ШІ-співробітники». «Відкрити» веде в її вікно; кружечок «Налаштування» праворуч угорі вікна — її налаштування, вкладка «Налаштування»:
| поле | що означає | типово |
| --- | --- | --- |
| Готувати виплати-чернетки за дорученням інших ШІ | без галочки Свєта лише показує звіти; чернетку може створити людина | так |
| Бізнес, який веде Свєта | бренд із партнерами | бренд «Перший шар» (за назвою) |
| Рахунок бізнесу | гаманець для виплат партнерам і внесків | — |
| За який період типово рахувати виплату | поточний або минулий місяць | минулий місяць |

Партнерів і частки задаєте в «Налаштування → Бренди та юрособи → Бренди → бренд → Партнери бізнесу» (стаття «Бренди і юрособи», розділ 8).

## 2. Увімкнути або вимкнути Свєту
Перемикач на плитці «Свєта» в «Інтеграції → ШІ» або «⋯» у шапці пульта. Вимкнена Свєта не готує виплат (і для інших ШІ теж), її інструменти керування — лише через підтвердження людини; звіти в пульті лишаються видимими.

## 3. Звідки Свєта бере цифри
- **Капітал і гроші бізнесу** — звіт «Капітал» («Фінанси → Партнери» або «Звіти → Капітал»): внески («Внесок партнера»,
  витрати з особистої кишені партнера на бізнес), виведення й виплати, частка прибутку за частками партнерів.
- **Прибуток місяця** — «Звіти → P&L по бізнесах», колонка бізнесу.
- **Виплата** — розрахунок «Фінанси → Партнери → Виплати»: угоди бізнесу за період, сума − собівартість − комісія з журналу,
  частка партнера (на товарі — своя, якщо задано), «повертати собівартість».
Свєта нічого не рахує вдруге — показує ті самі звіти, що й сторінка «Фінанси».

## 4. Пульт: огляд, капітал, виплати
Вкладка «Огляд»: KPI («До виплати партнерам» — головна, «Гроші бізнесу», «Прибуток місяця», «Капітал», «Виплати»), таблиця «Капітал партнерів», блок «Виплати» (партнер, період → «Розрахувати» → «Створити чернетку»; відкрита виплата — «Затвердити», «Виплатити» з гаманцем і датою, XLSX). Це вікно `/crm/ai/sveta` («Відкрити» на картці); налаштування — кружечок «Налаштування»: вкладки «Налаштування» (з «Доступами й лімітами» внизу), «API», «Огляд», «Журнал».

## 5. Перенесення старої Свєти
Стара Свєта (сторінки «Перший шар» `/sveta`, власні таблиці внесків, витрат, ручних угод, виплат) працює, доки власник не підтвердить перенесення — це міграція даних, її вирішує власник. Перенесення:
1. партнери Саша й Роман у бренді, частки товарів з довідника собівартостей («ручки» — Роман 66 % з поверненням собівартості);
   гаманці «Особисті кошти — Роман/Саша», з яких платила стара Свєта, стають кишенями партнерів (витрати з них — внески);
2. внески й виведення → операції «Внесок партнера» / «Виплата партнеру» з рахунку бізнесу;
3. проведені витрати → операції бізнесу (з кишені партнера, якщо платив він); уже записані в журнал — доповнюються бізнесом;
4. комісії угод до дати переходу — зі старого розрахунку (формула майданчика або виправлена рукою) → комісія по угоді, лише де в
   журналі її ще нема (без подвоєння з комісією каналу); угоди після дати переходу — за правилами каналів («Фінанси → Звірка»);
5. ручні угоди — лише в звіті (створення угод — окремим рішенням);
6. виплати → «Виплати» зі знімком (правка назви чи корекцій суму не обнуляє); сплачені — проведені з датою сплати;
7. звірка зі старою Свєтою за місяць (≤ 1 грн).
Спершу — пробний прогін: звіт, нічого не зберігається. Після застосування стара Свєта стає лише для читання (запис → «перенесено в CRM»), повтор нічого не дублює. У пульті — посилання «Стара Свєта» на сторінки «Першого шару».

## Можливі помилки
| Як показується | Чому | Що зробити |
| --- | --- | --- |
| «Оберіть бізнес у налаштуваннях Свєти…» | Бренду «Перший шар» нема і бізнес не обрано | «Налаштування» пульта → «Бізнес» |
| «Свєту вимкнено — увімкніть в «Інтеграції → ШІ»» (409) | Чернетку виплати просили у вимкненої Свєти | Увімкнути перемикачем |
| «У Свєти вимкнено «Готувати виплати-чернетки…»» (409) | ШІ просить чернетку, а галочку знято | Увімкнути в «Налаштуваннях» або створити чернетку самому |
| «партнер … не з бізнесу цього товару» | Частку ставлять товару з папки іншого бізнесу | Перевірити папку товару |
| Запис на сторінці «Першого шару» → «перенесено в CRM» (409) | Перенесення вже застосовано | Вносити у «Фінанси» (бізнес «Перший шар»), капітал і виплати — «Фінанси → Партнери» |
| Пробний прогін: «рахунок бізнесу не задано» | Не обрано «Рахунок бізнесу» | «Налаштування» пульта → «Рахунок бізнесу» |

## Для ШІ-співробітників
Ключ розділу в каталозі — `ai-sveta` (`GET /api/ai/sections/ai-sveta`); доступ — галочка «ШІ Свєта (бухгалтерія бізнесу: партнери, капітал, виплати)» у «Доступах» (Ломі має її типово). Звіти й виплати бізнесу — також розділ `finance` (`finance_capital`, `finance_payout_calc`, `finance_payouts`, `finance_payout_pay`).
- `ai_sveta_status` — стан, бізнес, налаштування.
- `ai_sveta_summary` — огляд: P&L місяця бізнесу, гроші й капітал, партнери з «до виплати», виплати за станами.
- `ai_sveta_payout_calc` (from, to, partner_id) — розрахунок, нічого не пише.
- `ai_sveta_payout_create` (values: partner_id, from, to, label, adjustments) — чернетка виплати через кошик «Платежі»; гроші не рухає.
- `ai_sveta_settings_save`, `ai_sveta_enabled` — через кошик «Керування іншими ШІ».
Не вигадуйте суми й частки — беріть з відповідей інструментів; частки партнерів і бізнес змінює людина.

## Додаткова інформація
Пов'язане: [Фінанси](finance.md) (розділ 7в «Партнери, капітал, виплати»), [Бренди і юрособи](settings-brands.md), [ШІ Марія Йосипівна](ai-maria.md), [ШІ-співробітники](ai-employees.md), [Ломі](kamila.md).