# Гроші й документи — WIKI Helomi

> Фінанси й гаманці, каса, фіскальні чеки, рахунки й накладні з шаблонів.


---

# Фінанси

Фінанси — усі гроші компанії в одному журналі: доходи, витрати й перекази між гаманцями (банківські рахунки, каси, готівка) з категоріями, сегментами, філіями й прив'язкою до угод. Кожна операція знає свій бізнес (бренд), юрособу (чиї гроші), клас категорії (як впливає на прибуток) і підставу (угода, чек каси, накладна). Оплата в картці угоди сама стає операцією тут, виписки Monobank, ПриватБанку й NovaPay підтягуються без дублів, а звіти «Грошовий потік», «Річний баланс», P&L, «За класами» і «Клієнти» показують, куди йдуть гроші — по всій компанії або по одному бізнесу.

У меню — «Бухгалтерія → Фінанси» (до 20.10 пункт звався «Фінанси CRM»). Поруч у тому ж відділі — «Дашборд фінансів» (аналітика Марії Йосипівни, колишній пункт «Фінанси») і «Дашборд директора» (колишній «Дашборд»); доступи до них **різні** (власник 20.10): галочка «Фінанси» відкриває цей розділ, «Дашборд фінансів» — сторінку аналітики Марії; хто мав старий доступ «Фінанси» до 20.10, отримав обидві, доки адміністратор не змінить їх окремо в «Налаштування → Доступи».

**Верхнє меню розділу** (з 22.10): скляна смуга з вкладками трьома групами — «Гроші» (Огляд, Операції, Нерознесені, Гаманці, Планові), «Канали й борги» (Маркетплейси, Закупівлі, Платежі, Кредити, Партнери), «Звіти й облік» (Звіти, Фіскальні чеки, Довідники); між групами — тонка риска. Вибрана вкладка — чорна пігулка з іконкою, вона переїжджає до натиснутої. Червона цифра на вкладці — що там чекає вас: на «Нерознесених» (світла) — надходження без угоди, на «Планових» (яскрава) — прострочені планові; наведіть — пігулка скаже скільки й на яку суму. Не влазить у ширину вікна — останні вкладки ховаються в «Ще» (там вони під назвами груп, червона крапка на «Ще» — у схованій вкладці щось чекає); вибрана звідти вкладка стає на місце «Ще». На телефоні смуга гортається пальцем, вибрана підкручується до середини. Клавіатура: Tab — на вибрану вкладку, ←/→ — між вкладками, Enter.

## Огляд
Перша вкладка «Фінансів» (`/crm/finance`): за 10 секунд — скільки грошей, хто кому винен, як іде місяць і що треба зробити. Своїх розрахунків вона не має: цифри ті самі, що у «Гаманцях», «Закупівлях», «Планових» і «Звітах» (там їх можна розкрити). Журнал операцій — вкладка «Операції» (`/crm/finance/ops`).
- **Гроші бізнесу** — сума балансів увімкнених гаманців типів «Банк», «Готівка чи каса» й «Платіжний рахунок» у гривні за курсом
  «Налаштування → Валюти і курс» (як «Разом у гривні» у «Гаманцях»); під сумою — «з плановими». Транзитні гаманці майданчиків і
  кишені партнерів — рядком «Довідково», у гроші бізнесу не входять. Гаманець у валюті без курсу в суму не входить і названий
  під гаманцями. Клік по гаманцю — його операції. На плитках суми без копійок (точна — у підказці).
- **Нам винні** — угоди з 1-го числа місяця дати переходу (з неї P&L рахує виручку з угод), де сума угоди більша за сплачене;
  без програних і скасованих та без угод на етапі «Повернення». Вік — від дати замовлення: 0–7, 8–30 і 31+ днів; таблиця — 10
  найбільших боргів (клік — картка угоди). Угоди до цієї дати — історія KeepinCRM, де оплат по угодах не вели, — окремим рядком,
  у борг не входять. Майданчик платить сумою за багато замовлень: поки виплата не прив'язана до угод, такі угоди теж «винні».
- **Ми винні** — несплачені частини закупівель (як «Фінанси → Закупівлі»), затверджені й ще не виплачені виплати партнерам,
  планові витрати на 30 днів уперед разом із простроченими і податки: борг за періоди, чий день сплати минув (як «Звіти →
  Податки»), плюс найближчі планові податки. Податки й планові оплати партій до планових витрат не додаються — вони вже у своїх рядках (у «з плановими» гаманця — є).
- **Місяць** — з 1-го числа до сьогодні: виручка, валовий і чистий прибуток з «P&L по бізнесах» і гроші — надійшло, витрачено,
  потік (без переказів між своїми гаманцями, як «Дохід і витрата» у звітах). Зміна — до тих самих днів минулого місяця (зелена —
  краще, червона — гірше; для витрат менше — краще), поруч — минулий місяць цілком. Якщо минулий місяць пораховано іншим
  методом (жовтень 2026 — нарахуванням, вересень — грошима), зміна прибутку сіра, з «≈» і поясненням: вона приблизна. Прибуток видно тим, кому відкриті всі
  гаманці; іншим замість нього — пояснення, гроші — по їхніх гаманцях.
- **Що потребує уваги** — тривоги, червоні першими, кожна з кнопкою переходу:
  - від'ємний баланс гаманця грошей → «Гаманці» (зазвичай не задано стартовий залишок або бракує операцій);
  - «Вхідні» — рядки виписок чекають перевірки → «Маркетплейси»;
  - операції без категорії за 30 днів → «Операції» з фільтром «Без категорії» (перекази між гаманцями категорії не потребують і
    не рахуються; рядки «Вхідних» — окремою тривогою);
  - операції без бізнесу за 30 днів у класах, де бізнес потрібен: продажі, закупівля, документи партії, повернення від
    постачальників, а з витрат — ті, яких не бере жодне ввімкнене правило розподілу спільних витрат (типово — комісії
    майданчиків і повернення клієнтам) → «Операції» з фільтрами «Спільні (без бізнесу)» і класом, окреме посилання на кожен клас.
    Без бізнесу такі операції в P&L лишаються «Спільними (не розподілено)»;
  - помилки інтеграцій за добу → картка інтеграції з журналом (банк, NovaPay, каса — червоним, маркетплейси й решта — жовтим);
  - «Monobank / NovaPay мовчить» — увімкнений акаунт з ключами й «Тягнути виписку автоматично», а останній імпорт старший за добу
    → картка інтеграції;
  - прострочені планові витрати й борг з податків → «Планові»;
  - «Фіскальні чеки: N угод потребують уваги» — отримані за 30 днів угоди без чека (крім щойно отриманих, яким тригер ще пробиває
    чек) і скасовані з неповерненим чеком → «Фіскальні чеки» одразу на «Контролі» (див. [Фіскальні чеки](#фіскальні-чеки)).
- Нема жодної тривоги — «Усе спокійно».
- Під кожною вкладкою «Фінансів» — одне речення «для чого це і що дає бізнесу» і «?»: він відкриває розділ цієї статті про
  вкладку, не йдучи зі сторінки. Коротко про те саме щоранку після 9:00 пише ШІ Марія у ваш чат з нею
  («Ранковий підсумок»: гроші по гаманцях, учорашні надходження й витрати, «Вхідні», планові на тиждень, тривоги — стаття
  [ШІ Марія](ai-maria.md)).
- Хто що бачить: гроші, «Вхідні», операції без категорії й без бізнесу, планові витрати й гроші місяця — лише ваші гаманці;
  дебіторку, закупівлі, виплати партнерам і податки — усі, кому відкрито «Фінанси».
- Телефон: плитки 2×2 (місяць — на всю ширину), гаманці пігулками, тривоги рядками з кнопкою, таблиці одна під одною.

## Можливості
- Вкладка «Огляд» (перша): гроші бізнесу, нам винні, ми винні, місяць із дельтою і тривоги з переходом у потрібну вкладку.
- Верхнє меню групами з лічильниками «що чекає»: нерознесені надходження, прострочені планові; що не влазить — у «Ще».
- Скільки завгодно гаманців у різних валютах з балансом і стартовим залишком; курс валют задається вручну.
- Категорії доходів і витрат деревом, сегменти, філії.
- Дохід, витрата, переказ між гаманцями (різні валюти — за курсом); файли-квитанції до платежу.
- Планові операції, у тому числі щомісячні; на баланс не впливають до підтвердження.
- Оплата в угоді = операція у фінансах; «Сплачено» і «Очікується» в угоді рахуються самі.
- «Нерознесені»: надходження без угоди — «До угоди …» за підказкою, «Це переміщення з …», «Інший дохід»; переміщення між
  своїми рахунками й картками система знаходить сама (пара переказу, не дохід і не витрата).
- Посилання на оплату LiqPay і MonoPay з картки угоди.
- Імпорт виписок Monobank, ПриватБанку, NovaPay без дублів; правила імпорту (умова → категорія, виплата каналу, «не заводити»),
  незрозумілі рядки — у «Вхідні» на перевірку. Monobank — скільки завгодно акаунтів, миттєві операції вебхуком, надходження з
  номером угоди в призначенні саме стає оплатою угоди; у «Вхідних» — поле «Угода (№)».
- «Платежі»: платіж з будь-якого гаманця готується в CRM (постачальнику, перевізнику, партнеру, оренда). Рахунок ТОВ чи ФОП у
  Monobank для бізнесу → підпис директора в застосунку банку → витрата в журналі сама; картка чи готівка → «До сплати» у
  «Планових» → «Оплачено» або рядок виписки закриває сам.
- «Планові» з горизонтом 3 / 6 / 12 місяців чи своїм періодом: по місяцях постійні витрати, борги партій, кредити, податки,
  платежі до сплати; «потрібно до дати» проти грошей бізнесу — з якого місяця не вистачає. «Постійні витрати» керовані:
  Марія заводить за історією, ви міняєте суму, день, гаманець або вимикаєте — вимкнена не повертається.
- «Кредити»: кредитні лінії й позики — ліміт, винні банку, можна взяти, «погасити до»; видачі й погашення в журналі,
  переоформлення («закрив і одразу взяв знову») однією дією, строки — у «Планових».
- Канали продажів (Prom, Rozetka, Kasta, Епіцентр, ОЛХ, сайти): транзитний гаманець «скільки майданчик винен», момент «гроші
  наші» (при замовленні, коли угода виграна, на етапах), комісія майданчика витратою по угоді, виплата з банку — переказом.
- Вкладка «Маркетплейси» (з 20.10 замість «Звірки»): по кожному майданчику баланс кабінету (наш і за API), скільки винен,
  комісії, поповнення, виплати, виписка, стан «зійшлось / є різниця»; виплатні системи; «Вхідні»; правила каналів.
- P&L по бізнесах: виручка, собівартість, витрати за класами, чистий прибуток кожного бізнесу; спільні витрати (оренда, зарплата на
  всіх) розподіляються між бізнесами правилами.
- Партнери бізнесу: частки прибутку (на бренді й на товарі), капітал (внески, виведено, частка прибутку), гроші бізнесу,
  розрахунок і проведення виплат партнерам.
- Оплати партій закупівель — операції журналу з підставою «Закупівля», бізнесом за товарами партії; вкладка «Закупівлі» з боргами.
- Поля операції налаштовуються як в угодах: порядок, видимість, обов'язковість, колонки журналу, власні поля всіх типів; ШІ працює
  з тими самими полями й перевірками.
- Податки кожної юрособи: вид і ставка — у шторці юрособи; планові податки на день сплати з фактичних доходів, підтвердження з
  виписки ДПС чи чату Марії, звіт «Податки» (база, нараховано, сплачено, борг).
- Рядок виписки, який збігається з уже внесеною операцією (оплата партії, витрата з чату Марії, ручний платіж), — звіряється з
  нею, а не стає дублем.
- Звіти «Грошовий потік», «Річний баланс», «Звіт P&L», «Клієнти» (із середнім чеком), «Графіки»; XLSX і PDF.
- Право бачити розділ окремо від права проводити платежі; доступ до окремих гаманців.
- Клас кожної категорії (продажі, закупівля товару, комісії, реклама, зарплата, постійні витрати, податки, внески й виведення власника…) — за ним рахують звіти, Марія й Свєта.
- Бізнес (бренд) і юрособа кожної операції; тип гаманця (банк, готівка, транзитний майданчика, особистий); фільтр «Бізнес» у журналі й звітах.
- Вкладка «Фіскальні чеки» — усі чеки Checkbox і «Контроль»: чи на кожну отриману угоду пробито чек, по каналах і з причинами,
  кнопка «Виписати» для пропущених, тривога в «Огляді» (розділ [Фіскальні чеки](#фіскальні-чеки); стаття про Checkbox).
- Під кожною вкладкою — речення «для чого це і що дає бізнесу» і «?» на розділ цієї статті; у шторці «Новий платіж» — підказки під
  полями (свої пишуться в «Типи даних → Фінанси»).

## 1. Налаштування
- **Гаманці, валюти, сегменти, категорії** — «Налаштування → Фінанси»: «Гаманці», «Валюти і курс», «Сегменти», (курси USD, EUR і валют
  гаманців з 20.10 оновлює ШІ Марія з НБУ раз на добу — вимикач у її пульті; ручний курс перезапишеться) «Категорії фінансів». Те саме для гаманців і категорій — вкладка «Довідники» у «Фінансах». Швидкий перехід — «⋮» у шапці «Фінансів» → «Налаштувати класи категорій» / «Налаштувати гаманці» (лише адміністратору). Там же «Інструкція» (ця стаття) і «Вхід для ШІ» (що й як робить ШІ-співробітник у «Фінансах»).
- **Клас, «Постійна», «Бізнес» категорії** — «Налаштування → Фінанси → Категорії фінансів»: колонки «Клас», «Постійна» (лише витрати), «Бізнес». Див. розділ 1а.
- **Тип і «Бізнес» гаманця** — «Налаштування → Фінанси → Гаманці»: колонки «Тип» (банк / готівка чи каса / транзитний / особистий / інший) і «Бізнес» (спільний або один бренд).
- **«Бізнеси й рахунки»** — «Налаштування → Фінанси → Бізнеси й рахунки» (або «⋮» у шапці «Фінансів»): одна сторінка про те, як
  влаштовано гроші. Бренд — те, що бачить покупець; юрособа (ФОП чи ТОВ) — через кого йдуть гроші; гаманець (рахунок, картка,
  каса) належить юрособі (чиї гроші) і, якщо треба, одному бренду (чиї витрати типово). Один бренд може працювати через кілька
  ФОП (одна бухгалтерія): у бренду кілька юросіб, типова йде в нові угоди, решта — за правилами вибору юрособи. Один ФОП може
  обслуговувати кілька брендів: доходи й витрати діляться за угодою, гаманцем чи категорією, спільні витрати — за «Розподілом
  спільних витрат». На сторінці: картки юросіб з брендами й рахунками (і сумою грошей бізнесу), «+ рахунок цієї юрособи»,
  **попередження** — рахунок бізнесу без юрособи («чиї гроші?» — обираєте тут же), юрособа без бренду, бренд з кількома
  юросібами без типової; групи гаманців (рахунки бізнесу / особисті картки / баланси майданчиків) з поясненням, бренди з
  юросібами; посилання на «Бренди та юрособи», правила вибору юрособи й розподілу витрат.
- **«Не рахувати у звітах» бренду** — «Налаштування → Команда → Бренди та юрособи» → бренд → прапорець «Не рахувати у звітах» (не наш бізнес: не з'являється в «Бізнесах» Марії й звітах бізнесів).
- **Бізнес каси** — «Налаштування → Каси» → каса → «Бізнес» (порожньо — за товарами угоди).
- **Доступи** — у «Налаштування → Розділи меню» (або в картці людини в «Користувачі»):
  - «Фінанси» — бачити розділ (типово вимкнено, відкриває адміністратор);
  - «Фінанси: проводити й змінювати платежі» — без цієї галочки лише перегляд: кнопок проведення нема, а зміни не приймаються.
- **Доступ до гаманця** — «Фінанси → Довідники» → гаманець → «Доступ до гаманця» (лише адміністратор). Без доступу людина не бачить гаманця у формах, звітах і журналі й не може провести через нього платіж, у тому числі з картки угоди.
- **Правила каналів продажів** — «Фінанси → Маркетплейси» → рядок каналу (див. розділ 7а). Типово вимкнено: нарахування в журнал
  вмикає людина.
- **Правила імпорту виписок** — «Налаштування → Фінанси → Правила імпорту» або «⋮» у шапці «Фінансів» → «Правила імпорту виписок».
- **Ключі банків і оплат** — картки в «Інтеграціях» (Monobank, ПриватБанк, LiqPay, MonoPay); див. статті цих інтеграцій.

- **Поля операції** — «Налаштування → Типи даних → Фінанси» або «⋮» у шапці «Фінансів» → «Налаштувати поля» (див. розділ 1б).

## 1б. Поля операції
Як в угодах: у таблиці «Типи даних → Фінанси» — вбудовані поля й ваші власні, порядок перетягуванням за «⋮⋮».
- **З замком** (не вимикаються): Дата, Сума, Дохід чи витрата, Гаманець, Категорія. Категорію можна зробити обов'язковою.
- **Налаштовуються**: Контрагент, Угода, Клієнт, Бізнес, Юрособа, Філія, Сегмент, Користувач, Коментар, Планова, Файли,
  Підстава. Прапорці: «Увімкнено» (вимкнене поле зникає з журналу й шторок), «Обов'язкове», «Вивести в списку» (колонка
  журналу й «Планових»), «Вивести при створенні» (поле в шторці «Новий платіж»). Юрособа й підстава ставляться самі — їх лише
  показують у журналі.
- **Власні поля** («+ Поле»): рядок, текст, число, так/ні, дата, час, список, мультивибір, посилання. Значення видно в шторці
  операції, у колонці журналу («Вивести в списку»), у фільтрі (`f_<ключ>`) і в «Експорті платежів» (колонка з назвою поля).
- «Обов'язкове» працює насправді: шторка не збереже операцію без значення, а сервер відповість «Заповніть обов'язкові поля
  операції: …» — і людині, і ШІ. Очистити обов'язкове поле при зміні теж не можна. Автоматичні проведення (виписки банків,
  нарахування каналів, податки, оплати з картки угоди) обов'язковість не перевіряють — їх заповнює система.
- Шторка «Новий платіж» показує поля «Вивести при створенні» в налаштованому порядку; повна шторка операції («+ Операція» у
  журналі, відкрита операція) — усі ввімкнені поля.
- **Правила передачі** («Налаштування → Правила передачі»): «Угода → її оплати й операції», «Клієнт → його операції» й навпаки —
  напр. назва клієнта в «Контрагента» операції або поле угоди у власне поле операції.

## 1а. Класи категорій, бізнес, юрособа й підстава операції
Категорії фінансів — статті доходів і витрат, у які лягає кожна операція. Клас категорії каже, як операція впливає на прибуток, тож від нього залежать P&L по бізнесах, капітал і податки; підкатегорія успадковує вид батька.

**Клас категорії** каже, як операція впливає на прибуток. Доходи: «Продажі», «Інші доходи», «Повернення від постачальників», «Відшкодування», «Внесок власника чи партнера», «Позика чи кредит отримано». Витрати: «Закупівля товару», «Документи й доставка партії», «Комісії майданчиків», «Доставка клієнтам», «Реклама», «Зарплата й премії», «Постійні витрати», «Податки», «Банк і еквайринг», «Повернення клієнтам», «Виведення власнику чи партнеру», «Повернення позики», «Інші витрати».
- Закупівля товару вже сидить у собівартості проданого — від маржі вдруге не віднімається. Внески, виведення й позики — не дохід і не витрата (окремий рядок у звіті «За класами»).
- Клас нової категорії ставиться за назвою; біля нього пігулка «перевірте клас» — оберіть свій, і пігулка зникне. Клас категорії іншого виду (дохід ↔ витрата) не приймається.
- «Постійна» — витрата, що щомісяця приблизно однакова (оренда, CRM, податки); за нею Марія будує прогноз. Порожньо — за класом.
- **Системні й користувацькі категорії.** Будь-яка витрата лягає в якусь категорію, а з системи гроші виходять лише як витрата
  або переміщення — тому в системних класах завжди є хоч одна жива категорія (нема — CRM створить її з назвою класу):
  «Продажі», «Інші доходи», «Повернення від постачальників», «Внесок власника чи партнера», «Позика чи кредит отримано»,
  «Закупівля товару», «Документи й доставка партії», «Комісії майданчиків», «Податки», «Зарплата й премії», «Повернення
  клієнтам», «Виведення власнику чи партнеру», «Повернення позики», «Інші витрати». На них тримаються автоматика (правила
  каналів, податки, закупівлі, Марія) і звіти. Остання жива категорія такого класу позначена **«системна»** (замок): її не
  можна видалити, архівувати чи перевести в інший клас — лише перейменувати чи додати підкатегорію. Щоб прибрати її, спершу
  додайте іншу категорію цього класу. Решта — користувацькі: додавайте, перейменовуйте, вкладайте, архівуйте (з операціями —
  лише в архів). У «Довідниках» категорії згруповано за класами з поясненням кожного; «⋮» → «Клас і постійна…» — змінити.

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

**Юрособа операції** — юрособа гаманця (чиї гроші), інакше юрособа угоди. **Підстава** — угода, закупівля (оплата партії, платіж друга), чек каси, товарна накладна, посилання на оплату. Клас, юрособа й підстава видно пігулками вгорі шторки операції.

Історія заповнюється сама після оновлення (класи категорій, типи гаманців, бізнес і юрособа старих операцій), людську правку не перезаписує.

## 2. Новий платіж: дохід, витрата, переказ
1. У шапці «Фінансів» натисніть «+ Новий платіж» (кнопку видно, якщо у вас є право проводити). «+ Операція» над журналом —
   та сама операція з усіма полями (контрагент, угода, бізнес, планова, файли).
2. Виберіть «Дохід», «Витрата» або «Переказ» (між своїми гаманцями).
3. Заповніть гаманець, категорію (для переказу — гаманець-отримувач), суму, дату, коментар; за потреби поставте «Заплановано», оберіть «Бізнес» (типово — автоматично) і додайте файли (квитанції). Чи обов'язкова категорія — у «Налаштування → Типи даних → Фінанси» (типово так).
4. Переказ між гаманцями різних валют показує «Сума отримувача» за курсом — її можна змінити.
5. «Додати». Баланси гаманців і підсумки оновляться одразу. Якщо операцію збережено, а файли не завантажились, — з'явиться
   повідомлення з номером операції: додайте файли в її картці (повторне «Додати» не потрібне).
6. Шторку закривають «Закрити», Esc або клік повз; якщо ви вже щось ввели — спершу спитає, чи відкинути введене.

## 3. Журнал операцій і фільтри
1. «Фінанси» → «Операції». Угорі — **лише ваші рахунки й картки** (власник 22.10): плитка «Усі», далі набір «Рахунки бізнесу»
   (банк, платіжний рахунок, готівка) і набір «Картки фізосіб», над кожним — назва й підсумок у гривні. Плитка гаманця — кружечок
   банку (N — NovaPay, M — Monobank, П — ПриватБанк, каса — готівка), назва й баланс за журналом; **червона крапка** на кружечку —
   баланс розійшовся з банком (наведіть — сума різниці; розібрати — «Гаманці» → «Розібрати»). Гаманців майданчиків («Баланс · …»,
   «Транзит · …», «NovaPay: накладені платежі») і вимкнених тут нема — вони у «Маркетплейсах» і «Гаманцях»; гаманець, відкритий
   посиланням чи обраний у фільтрі, видно завжди (майданчик — окремим набором «Майданчик»). Клік по плитці фільтрує журнал за
   гаманцем, повторний клік або «Усі» — знімає фільтр; гаманець, обраний у фільтрі, підсвічує свою плитку. Плитки завжди в один
   ряд (повна назва — у підказці при наведенні); не влазять — ряд гортається вбік, на телефоні — пальцем.
   **Сторінка без зайвого** (власник 22.10): під плитками — один рядок керування (період, напрямок, категорія, пошук, «Фільтри»,
   «Скинути», «⋮»), під ним — підсумки одним рядком, далі журнал на всю решту висоти: гортається сам, шапка колонок стоїть на
   місці. Сторінка цілком не гортається — лише журнал. Інша сторінка, фільтр чи сортування — журнал знову з першого рядка.
   «⋮» у кінці рядка — рідкісні дії: «Операція з усіма полями» (контрагент, угода, бізнес, планова, файли), «Імпорт виписки
   банку», «Експорт у XLSX»; частий платіж — чорна «Новий платіж» у шапці розділу.
2. Колонки: дата, сума (↑ витрата червоним, ↓ дохід зеленим), контрагент, користувач, філія, категорія, бізнес («спільне», якщо бізнесу нема), гаманець, угода, сегмент, коментар. Кружечок біля суми — джерело: N — NovaPay, M — Monobank, П — ПриватБанк, іконка — канал продажів, закупівля, податок, ШІ, каса (наведіть — підпис).
3. Фільтри: в ряд — **період** («Увесь час», «Сьогодні», «Цей тиждень», «Цей місяць», «Минулий місяць», «Цей рік»; «Свій
   період…» — дві дати «Від» і «До»; дати з «Грошового потоку» чи збереженого фільтра показуються як свій період), напрямок,
   «Усі категорії» (і «Без категорії» — по всіх гаманцях без переказів), пошук «Контрагент, коментар…»; решта («Усі гаманці» —
   для гаманців майданчиків і вимкнених, звичайні обирають плитками; «Усі бізнеси»
   і «Спільні (без бізнесу)», «Усі класи», «Усі користувачі», «Усі філії», «Усі сегменти», «Фактичні й планові», «Перевірка»,
   «Усі джерела» — у тому числі «Закупівля» й «Податок») — під кнопкою «Фільтри» з лічильником діючих; діючий фільтр не ховається
   (гаманець, вибраний плиткою, «Фільтри» не розгортає — його видно на плитці).
   **У журналі — лише рухи по рахунках і картках** (власник 21.10): усе, що лежить на гаманцях майданчиків («Транзит · …»,
   «Баланс · …», «NovaPay: накладені платежі» — нарахування доходів і комісій по кожному замовленню, ноги переказів на них),
   тут не показується й у підсумки «Дохід / Витрата / Сальдо» не входить; праворуч від підсумків — «Приховано рух майданчиків (N)
   · Показати тут» (наведіть — нарахування й списання; на телефоні цього рядка нема — та сама галочка в «Фільтрах»). Нога на вашому рахунку лишається і підписана
   зрозуміло замість «переказ»: «Виплата RozetkaPay (Prom, Rozetka)», «Виплата NovaPay (накладені платежі)», «Поповнення балансу
   Prom», «Оплата майданчику Епіцентр». Побачити гаманці майданчиків тут можна галочкою «Показувати гаманці майданчиків» (під
   «Фільтри», вимкнена), обравши такий гаманець у фільтрі або фільтром за угодою чи клієнтом (картка угоди бачить усі свої оплати);
   файл «Експорт платежів» — так само. Журнал кожного майданчика окремо — «Фінанси → Маркетплейси → Детальніше».
   «Скинути» — з'являється, коли щось обрано, знімає й гаманець, і період. Над журналом одним рядком — дохід, витрата, «Сальдо»,
   планові й кількість операцій за вибіркою.
4. Клік по операції відкриває її для правки; видалення — з підтвердженням (кнопку «Видалити» проведеного платежу видно лише з
   правом «видаляти проведені платежі»). Без права проводити поля лише для читання.
5. Правка зберігає те, що ви змінили: час з банку, бізнес, юрособа, підстава й категорія від правки коментаря не злітають; нова
   дата — той самий час дня. Інша угода — клієнт і контрагент беруться з неї.
6. **Переказ** у журналі — дві операції (витрата й дохід). У шторці частини переказу сума, гаманець, категорія, угода й «Планова»
   заблоковані з поясненням; дата й коментар міняються в обох частинах одразу. Змінити суму чи гаманці — видаліть переказ і
   створіть новий.
7. Телефон: пошук, «Фільтри» і «⋮» в ряд, фільтри (і період) відкриваються двома стовпцями; підсумки — коротко над журналом;
   операції — картками (контрагент і сума, категорія · бізнес · гаманець, дата й угода); гортається вся сторінка; вкладки
   розділу гортаються вбік.

## 3а. Нерознесені надходження й переміщення між своїми рахунками
Головне правило: гроші не зникають. У журналі є лише три види операцій — **надходження** (гроші прийшли ззовні; має бути прив'язане до угоди, бо саме так рахуються «Сплачено» угоди й борги клієнтів), **витрата** (гроші пішли назовні; завжди з категорією) і **переміщення** (гроші переклали між своїми рахунками й картками — це не дохід і не витрата, у звітах не рахується). Так само рахує Марія: виписка → правило → угода → «Вхідні».

**«Фінанси → Нерознесені»** — надходження на гроші бізнесу (банк, каса, платіжний рахунок) з дати переходу, у яких нема угоди: усе, що не рознесли самі Марія (за сумою, номером угоди чи клієнтом), реєстри NovaPay і звіт RozetkaPay. Угорі — скільки їх і на яку суму. У кожному рядку підказки й дії одним кліком:
- **«До угоди …»** — несплачені угоди за останні 120 днів на ту саму суму (борг чи сума угоди) і/або того ж клієнта з
  призначення платежу; підпис «сума й клієнт», «та сама сума», «клієнт з призначення». Клік — оплата цієї угоди: клієнт і
  підстава з угоди, «Сплачено» перераховується, категорія стає «Продажі», якщо її не було.
- **«Прив'язати до угоди»** з номером — те саме для будь-якої угоди (номер — у картці угоди).
- **«Це переміщення з «…»»** — підказка, коли з іншого свого гаманця ±1 день є списання тієї ж суми: з двох рядків робиться
  пара переказу (категорії знімаються, баланси не змінюються — гроші вже там). Вибрали гаманець самі, а списання в ньому
  нема — воно допишеться другою ногою.
- **«Інший дохід»** — не оплата угоди: кешбек, відсотки банку, повернення від постачальника, внесок власника; категорія —
  будь-яка дохідна не класу «Продажі» (типово «Інші доходи»).
- З картки угоди, де є «Очікується», кнопка **«Підібрати оплату з нерознесених»** відкриває цю вкладку з угодою нагорі:
  рядки, що пасують за сумою чи клієнтом, позначені «пасує угоді» і стоять першими, номер угоди вже вписано.
- У шторці операції прив'язана угода — зелена пігулка «угода …» (клік відкриває картку); у картці угоди блок «Фінанси» — її оплати.

**Переміщення між своїми рахунками (авто)** — блок нижче. Коли гроші зайшли на один свій рахунок (виписка банку чи ручний запис), система шукає списання тієї ж суми з іншого свого гаманця (у тому числі особисті картки й «Баланс · майданчик») у межах ±1 дня і робить пару переказу з приміткою «Переміщення (авто)». Сама вона робить це лише коли пара одна-єдина з обох боків і є доказ: обидва рядки з виписок банку з різницею до 30 хв, або в призначенні ім'я власника (з назв юросіб — «ФОП Семенченко» → «семенченко»; свої імена можна дописати) чи слова «між своїми рахунками». Інакше — лише підказка в «Нерознесених». Спрацьовує після кожної виписки (подія проведення) і раз на 5 хвилин за 3 дні; «Знайти зараз» проходить усе з дати переходу. Помилилась — «Це не переміщення»: пару розібрано, категорії як були, обидва рядки у «Вхідних», і ця пара більше не пропонується. Вимикач «автоматично» — адміністратору; вимкнено — лише підказки. Рядки по угоді, з підставою (закупівля, податок, чек), планові й транзитні нарахування каналів не чіпаються.

## 4. Оплата по угоді і посилання на оплату
- У картці угоди блок «Фінанси» → «+»: дохід або витрата, гаманець, категорія, сума, дата, «заплановано», коментар, файли. Платіж з'являється в журналі «Фінансів», а «Сплачено» й «Очікується» угоди перераховуються. Менеджер з доступом до «Угод» може додати квитанцію до платежу своєї угоди і без «Фінансів».
- Платежі угоди в її блоці «Фінанси» — рядками; натиск на суму відкриває ту саму операцію, що в журналі (правка, квитанції, видалення), натиск на гаманець — журнал «Операції» з фільтром цього гаманця. Таке посилання можна дати й самому: `/crm/finance/ops?purse=<номер гаманця>` (і `&category=<номер категорії>`) відкриває журнал одразу з цими фільтрами.
- «Посилання на оплату» в картці угоди (лише коли підключено LiqPay або MonoPay чи посилання вже є; без них блоку нема): сума типово дорівнює несплаченому; посилання копіюється й надсилається клієнту. Оплата фіксується сама, або натисніть «Перевірити оплату» — дохід по угоді проведеться один раз.

## 5. Планові операції
Планова — це гроші, які точно підуть (або прийдуть) у відомий день, але ще не пішли. Для чого: щоб заздалегідь бачити, скільки грошей потрібно до якої дати і чи вистачить, а не дізнаватись про це, коли платити вже треба. Вкладка «Планові» збирає всі планові в одному місці — хто б їх не ставив — і показує їх горизонтом:
- «Скільки грошей потрібно» (угорі): горизонт 3 / 6 / 12 місяців або «Період» зі своїми датами; три плитки — гроші бізнесу
  зараз (банк, готівка, платіжний рахунок — у гривні за курсом), скільки потрібно до кінця горизонту (планові витрати мінус
  планові доходи, прострочені теж) і «Вистачає / Не вистачає» (з якого місяця забракне). Таблиця по місяцях: постійні витрати,
  борги за партії, кредити, податки, платежі до сплати, інші; витрати, доходи, «потрібно до дати» наростаючим підсумком і
  «лишиться». Клік по місяцю розкриває його планові; рядок кредиту веде в «Кредити», платежу — у «Платежі».
- «Постійні витрати» — окремий керований список (див. [5а](#5а-постійні-витрати)).
- «Борги за партії» — борги перевізнику, постачальнику й за документи по датах (їх веде картка закупівлі, див.
  [7б](#7б-оплати-закупівель)); «Кредити» — планове погашення кожної лінії на «погасити до» (див. [7е](#7е-кредити-й-позики));
  «Платежі до сплати» — платежі з картки чи готівки, поставлені в «Платежах» (див. [7д](#7д-платежі-через-банк-або-до-сплати)).
- «Податки» і «Усі планові» — як і раніше: журнал найближчих першими з «Підтвердити».

З 20.10 ШІ Марія сама заводить планові постійні витрати за історією (зарплата, підписки, оренда — три й більше місяців зі стабільною сумою; «Марія: план за історією» у коментарі), а рядок виписки банку на ту саму суму (±3 %) у межах ±10 днів від строку підтверджує планову замість того, щоб заводити другу операцію — у підсумку імпорту це «звірено з внесеними». Податки підтверджуються лише правилом імпорту «Сплата податку». Вимикач — у пульті Марії, група «План постійних витрат». Борги партій закупівель (перевізнику, постачальнику, за документи) теж стоять тут плановими — їх веде сама картка закупівлі (див. [7б](#7б-оплати-закупівель)).
1. «Фінанси» → «Планові» → «+ Планова» або «Заплановано» в шторці платежу.
2. Для щомісячної виберіть «Щомісяця» і кількість місяців. Повтор «щомісяця» має лише остання згенерована — підтвердження
   попередніх не створює дублів наперед.
3. Коли гроші справді прийшли чи пішли, натисніть «Підтвердити» (у рядку або в шторці планової) — відкриється шторка: сума
   (сплатили іншу — змініть), дата (типово сьогодні), гаманець → «Провести». Операція стане фактичною і вплине на баланс; з
   повтором «щомісяця» з'явиться наступна. Галочку «Планова» в шторці не знімають — для цього «Підтвердити».
4. «Прострочено» — день сплати минув (за київським часом), а не «сьогоднішня ще не сплачена».
4. Планові податки юросіб — окремою групою «Податки» над таблицею: юрособа, податок, період, «до» якого дня, сума, «Підтвердити»
   (див. [7ґ](#7ґ-податки-юросіб)).

## 5а. Постійні витрати
Постійна витрата — те, що платиться щомісяця приблизно на ту саму суму: оренда, зарплата, підписки (CRM, СМС, телефон, Checkbox, ШІ-агенти). Для чого окремий список: щоб бачити, скільки гроші «з'їдають» самі собою щомісяця, не заводити їх руками й не забувати платити. Блок «Постійні витрати» у «Планових»: на місяць разом, і по кожній — що, сума, день місяця, наступна дата, гаманець і хто завів («Марія» — план за історією, або «вручну»).
1. Марія заводить постійну сама, коли витрата (клас «постійні» чи «зарплата») повторилась у трьох і більше місяцях зі стабільною
   сумою; нова з'являється наступного дня після того, як стане «постійною». Нічого робити не треба.
2. «+ Постійна витрата» — якщо Марія її ще не бачила: категорія, кому / за що (контрагент — як у виписці, щоб виписка
   підтвердила планову сама), сума, день місяця, гаманець → «Додати». З'явиться планова «щомісяця» на найближчий такий день.
3. «Змінити» — інша сума, день чи гаманець (з наступного платежу). «Вимкнути» — планова зникає, а серія потрапляє у «Вимкнені»
   (під таблицею): Марія її більше не заведе, навіть якщо витрата далі є в історії. «Увімкнути» — знову дозволити.
4. Коли гроші справді пішли — рядок виписки банку підтверджує планову сам (±3 %, ±10 днів), або «Підтвердити» в журналі
   планових; з повтором «щомісяця» наступна з'являється одразу.
Борги партій, податки й погашення кредитів у «Постійних» не входять — у них свої блоки.

## 6. Гаманці
Гаманець — місце, де лежать гроші: банківський рахунок, каса, готівка, транзитний рахунок перевізника чи площадки. Кожна операція змінює залишок свого гаманця, тож залишок у CRM має збігатися з банком.

- Вкладка «Гаманці» — баланси, валюта, кількість операцій; «Разом у гривні» рахує інші валюти за курсом. «Перерахувати баланси»
  оновлює й картки гаманців над «Операціями»; помилка показується червоним.
- **Два блоки з підсумком кожного** (за видом гаманця): **«Рахунки бізнесу (ФОП/ТОВ)»** — банк, платіжний рахунок (NovaPay),
  готівка; **«Картки фізосіб»** — особисті картки. **«Разом у гривні» вгорі — лише рахунки бізнесу** (гроші бізнесу); картки
  фізосіб мають свій підсумок і в нього не входять. Гаманці майданчиків — «Баланс · …» кабінетів, «Транзит · …» і «NovaPay:
  накладені платежі» — на «Гаманцях» не показуються: вони в розділі **«Маркетплейси»**. Вид гаманця змінюється в його картці
  («Вид гаманця»).
- **Особиста картка Monobank** (біла, чорна…) потрапляє в «Картки фізосіб» кнопкою «Підключити як акаунт» у
  «Інтеграції → Monobank → Налаштування → Картки цього токена»: окремий акаунт з тим самим токеном, гаманець «Особистий»,
  виписка — з дня підключення (довідка «Monobank»). Баланс одразу дорівнює залишку картки в банку: стартовий залишок вгадувати
  не треба (розділ [6а](#6а-звірка-з-банком)).
- **Велике число на картці — баланс за журналом** (підпис «баланс за журналом» там, де є залишок банку чи API, інакше «наш
  розрахунок»). Під ним — «У банку: N ₴ · станом на …» (Monobank, NovaPay) чи «За API: N ₴ · станом на …» (кабінет Rozetka; інші
  майданчики залишку через API не віддають) і **«різниця з журналом: ±N ₴»** = у банку мінус журнал.
- **«З майбутньою датою (N): −X ₴»** — фактичні операції з датою пізніше сьогодні, наприклад розтягнені оплати (річну суму
  розкладено помісячно на рік уперед). Банк ці гроші вже списав, тож вони є в балансі журналу, у різницю з банком **не входять**
  і показані окремим рядком.
- **«З плановими · 30 дн.»** на картці — баланс плюс планові доходи й мінус планові витрати, строк яких настає в найближчі
  **30 днів** (до кінця 30-го дня за Києвом), разом із простроченими. Планові, що настануть пізніше (наприклад, щомісячні
  комісії на рік уперед, борг партії через два місяці), — окремим рядком **«планові далі: +… / −…»**; наведіть на рядок — побачите
  суму з усіма плановими. «Разом у гривні» рахує так само: «з плановими на 30 днів …» і «планові далі …». «Огляд → Гроші →
  з плановими» — той самий строк. Усі планові без обмеження строку — у вкладці «Планові».
- **«У банку: N ₴ · станом на HH:MM»** — на картці гаманця рахунку Monobank чи NovaPay: останній відомий залишок рахунку в банку
  (Monobank — після кожного імпорту виписки, NovaPay — з кожним імпортом кабінету), сторінка в банк сама не ходить. Нижче —
  зелене **«збігається з журналом»** або червона **«різниця −4 496,00 ₴»** (у банку мінус баланс журналу). Різниця рахується на
  той самий момент, що й залишок банку: операції, які прийшли в журнал пізніше, її не створюють. Звідки береться різниця:
  холди (покупка карткою, яку банк ще не провів, — у журнал не заносяться), операції до дати «з дати» імпорту, неправильний
  стартовий залишок гаманця або ручна операція, якої нема в журналі (рядки «Вхідних» уже в балансі — вони не винні). Операції з
  майбутньою датою (розтягнені оплати) різниці не дають — вони окремим рядком.
  Підказка з цим списком — при наведенні на червону різницю. Залишок банку ще невідомий — «У банку · ще невідомо».
  Кнопка **«Розібрати»** поруч із різницею відкриває шторку «Звірка з банком» з цими причинами по сумах (розділ [6а](#6а-звірка-з-банком));
  різниця лише з холдів — зелене «збігається, якщо врахувати холди −N ₴».
- **«Оновити з банку»** («Оновити з API» для майданчика; кнопка на такій картці, лише адміністратору) — свіжий залишок зараз. Monobank дає один запит
  на хвилину: натиснули вдруге за хвилину — покажеться той самий залишок, банк зайнятий — «не частіше 1 запиту на хвилину».
- **«+ Рахунок або картку»** (вкладка «Гаманці», «Бізнеси й рахунки») — майстер з підказками на кожному кроці: 1) що
  додаємо — рахунок у банку (ФОП чи ТОВ), платіжний рахунок (NovaPay, еквайринг), готівка чи каса, особиста картка власника чи
  партнера, баланс майданчика (транзит) — з поясненням, куди ці гроші потраплять у звітах; 2) назва, чиї гроші (юрособа — для
  рахунків бізнесу), бізнес (витрати з гаманця типово на цей бренд; «спільний» — за правилами розподілу), валюта, стартовий
  залишок; 3) готово і «що далі»: під'єднати Monobank чи NovaPay, щоб виписка заходила сама, або правило каналу для транзиту.
  У картці гаманця в «Довідниках» ті самі поля: «Вид», «Чиї гроші (юрособа)», «Бізнес».
- Стартовий залишок можна писати як «12 345,67»; валюта гаманця — зі списку, куди входять і валюти з «Налаштування → Валюти і курс».
- **Вид гаманця** (у картці гаманця): «Банк», «Готівка чи каса» і «Платіжний рахунок (NovaPay, еквайринг)» — гроші бізнесу
  (капітал партнерів, оплати закупівель, виплати); «Транзитний (майданчик, накладені платежі)» — гроші, які майданчик чи
  перевізник ще не виплатив (картки у «Звірці», не пропонується для оплат); «Особистий (кишеня партнера)» — внески й виведення
  партнера; «Інший». Рахунок NovaPay (виписка кабінету, виплати накладених платежів) — платіжний рахунок, а транзитний —
  лише окремий «NovaPay: накладені платежі» реєстрів.
- У «Довідниках» «⋮» гаманця: «Редагувати», увімкнути або вимкнути, «Видалити». Гаманець з операціями не видаляється — вимкніть його.
- «⋮» категорії: «Підкатегорія», «Перейменувати», «В архів» (якщо є операції) або «Видалити», «Повернути з архіву».

## 6а. Звірка з банком
Звірка з банком тримає баланс гаманця рівним залишку в банку без ручних підрахунків: CRM сама бере залишок банку за звірену точку, рахує від неї лише нові операції і показує, звідки взялась різниця, якщо вона є. Для гаманців, під'єднаних до Monobank, NovaPay чи API майданчика.

**Звірена точка.** Раніше баланс рахувався як стартовий залишок плюс усі операції від початку, і стартовий треба було вгадати. Тепер у гаманця з банком є звірена точка — момент і залишок банку в цей момент. Баланс = цей залишок + операції, датовані пізніше; раніші вже сидять у залишку банку, тож не рахуються вдруге (у журналі, P&L і звітах вони лишаються як були). Звірену точку CRM ставить сама:
- **підключили картку** («Підключити як акаунт» у Monobank) — точка із залишку картки на момент підключення: баланс одразу = банку,
  витрати, внесені вручну до підключення, у баланс уже не входять;
- **особиста картка з банком без стартового залишку** — точка з першого знімка банку після імпорту виписки (подія «стартовий
  залишок узято з банку» в журналі акаунта);
- **усе збіглося з банком** — точка тихо пересувається на свіжий знімок («Налаштування → Фінанси → Звірка з банком → Пересувати
  звірену точку»): баланс не змінюється, а нова розбіжність шукатиметься лише в днях після останнього збігу;
- **кнопка «Прийняти залишок банку»** — точка на останній знімок банку вручну.

У таблиці під картками колонка «Стартовий / звірено» показує «звірено 22.10 13:26», а в картці гаманця в «Довідниках» — підказку під «Стартовим залишком». Змінили стартовий залишок вручну — звірену точку прибрано, баланс знову рахується від стартового.

**Шторка «Звірка з банком»** (кнопка «Розібрати» на картці гаманця) — без запиту в банк:
1. Зверху — «У банку · станом на …», «У журналі на той самий момент» і різниця (банк мінус журнал).
2. «Звідки різниця»: **Холди** — покупки карткою, які банк ще не провів (у залишку банку вони вже є, у журнал прийдуть, коли банк
   їх проведе; Monobank, з останніх виписок). **Внесені вручну без пари в банку** — операції людини чи ШІ, яких нема у виписці
   (дубль, помилка, інший рахунок), зі списком і кнопкою «Видалити». **Нез'ясовано** — решта.
3. Внизу — звірена точка, коли востаннє тягнули виписку (не тягнули понад добу — жовте попередження), «Операції гаманця» і
   посилання сюди.
4. **«Прийняти залишок банку»** (чорна; з правом «Фінанси: проводити й змінювати платежі» — те саме право, що змінює стартовий
   залишок) — баланс журналу на момент знімка стає рівним залишку банку, операції після знімка лягають зверху. Тост з
   **«Скасувати»** (8 с) повертає попередню точку. Подія з автором, старим і новим балансом — у журналі акаунта банку й
   «Журналі змін». Спершу розберіть операції без пари: після звірки вони в баланс уже не входять, але дубль лишиться в журналі.
5. «Оновити з банку» — свіжий залишок зараз (адміністратор; Monobank — не частіше 1 запиту на хвилину).

**Пропущені дні.** Якщо імпорт Марії якийсь час не працював, наступний імпорт сам перечитує виписку від останнього вдалого (до 31 доби — ліміт банку), щоб дірка у виписці не ставала нез'ясованою різницею.

**Налаштування → Фінанси → «Звірка з банком»** (змінює адміністратор):

| Поле | Що робить | Типово |
| --- | --- | --- |
| «Допуск, ₴» | різниця до цієї суми — «збігається з журналом» (копійки округлення) | 1 |
| «Холди пояснюють різницю» | холди окремим рядком, різниця лише з холдів — зелена | так |
| «Пересувати звірену точку, коли все збіглося» | автопересування точки при збігу | так |
| «Через скільки днів писати подію» | нез'ясована різниця тримається стільки днів — червона (від 100 ₴) подія «Звірка залишку» в журналі акаунта банку раз на добу з розкладом; 0 — одразу | 2 |

Для ШІ: `finance_bank_check purse_id=…` — той самий розклад (`diff`, `holds`, `manual_items`, `unexplained`, `anchor_at`); `finance_bank_accept purse_id=…` — «Прийняти залишок банку» лише через кошик підтверджень «payments». Налаштування звірки ШІ не змінює.

## 7. Імпорт виписки банку
1. «Операції» → «Імпорт виписки».
2. Monobank: «Акаунт» (поле є, коли акаунтів Monobank більше одного), «Рахунок» і «Гаманець» — «з налаштувань акаунта» або
   інші («Показати рахунки»), період → «Імпортувати з Monobank». Банк віддає не більше 31 доби за раз і не частіше одного
   запиту на хвилину на токен. Надходження з номером угоди в призначенні («№50000123», «sg-50000123», номер рахунку чи ТТН —
   за налаштуванням акаунта) одразу стає оплатою несплаченої угоди; підсумок пише «прив'язано до угод N». Акаунти, рахунок,
   гаманець, хто бачить і миттєві операції — стаття [Monobank](int-monobank.md).
3. ПриватБанк: рахунок, гаманець, період → «Імпортувати з ПриватБанку». Беруться лише проведені банком операції.
4. NovaPay: «Акаунт» (коли акаунтів більше одного), «Гаманець», період → «Імпортувати виписку NovaPay» — проведені платежі
   кабінету через «Автоматичні платежі» акаунта (дохід до угоди за ТТН чи номером, категорії без перевірки або «Вхідні»);
   «Завантажити реєстри» — накладені платежі за дні: дохід і комісія по угоді з ТТН (стаття [NovaPay](int-novapay.md));
   «Перекласти з реєстру Марії» — старий шлях для рядків, які синк Марії уже поклав у свій реєстр. ШІ — `novapay_import`,
   `novapay_registers`.
5. Повторний імпорт дублів не створює.
6. Кожен рядок проходить **правила імпорту** згори вниз; спрацьовує перше, що підійшло:
   - «Категорія» — операція з категорією (і бізнесом) правила; «проводити без перевірки» вимкнено — рядок ще й у «Вхідних»;
   - «Виплата каналу» — гроші з транзитного гаманця майданчика прийшли на рахунок: переказ (дві ноги), а не другий дохід;
   - «Переказ у інший гаманець» — напр. готівку зняли в касу;
   - «Не заводити» — рядок пропускається (лічильник спрацювань правила росте);
   - «Сплата податку (підтвердити плановий)» — списання в казначейство чи ДПС підтверджує плановий податок юрособи гаманця
     (та сама сума, або сума всіх податків найближчого дня сплати, або єдина планова поряд); не знайшлося — витрата категорії
     правила у «Вхідних».
7. Рядок без правила отримує підказку категорії від банку (за описом і MCC) і потрапляє у «Вхідні» («Маркетплейси»). З 20.10 ШІ Марія
   на кожному кроці розбирає «Вхідні» сама: правило імпорту, що з'явилось після імпорту; контрагент, якого вже три й більше разів
   розібрали однаково; платіж покупця на суму несплаченої угоди того ж клієнта — проводиться без людини (у коментарі
   «Марія: розібрано автоматично — …»), решта лишається з підказкою «Марія: підказка — …». Вимикач і межі — у пульті Марії. Підсумок імпорту
   пише, скільки рядків пішло за правилами, переказами й у «Вхідні».
8. **Звірка з внесеними**: якщо в тому самому гаманці вже є операція, внесена людиною чи агентом (оплата закупівлі, витрата з
   чату Марії, ручний платіж, тригер, автоплатіж етапу, податок, підтверджений у чаті, друга частина переказу, яку записало
   правило виписки іншого банку), з тією самою сумою й напрямком — рядок не створює нової операції, а позначає наявну
   «звірено з випискою»; повторний імпорт теж не дублює. За самою сумою зливається лише операція того самого чи сусіднього
   дня; далі, до ±3 днів, — лише коли збігається контрагент або є спільне слово в призначенні («ФОП Петренко» ↔ «Оренда
   Петренко»). Оплату закупівлі, розкладену по бізнесах (300 + 100), рядок банку на 400 звіряє одразу всю (те саме правило
   днів і контрагента). Серед кількох однакових сум першою береться операція з тим самим контрагентом. Правило «Виплата
   каналу», «Переказ» чи «Не заводити» спрацьовує раніше за звірку (виплату майданчика не «звіримо» з чужим ручним доходом).
   Підсумок імпорту — «звірено з внесеними N».
   Рядок на ту саму суму, який не злився сам (інший день і контрагент), іде у «Вхідні» з підказкою **«схоже на: дата ·
   категорія · хто вніс»**. У шторці рядка — «Уже внесено» → кнопка «Це та сама операція»: внесена операція отримує позначку
   «звірено з випискою», рядок зникає, дубля немає. Якщо це інший платіж на ту саму суму — оберіть «Дохід»/«Витрата», як
   завжди.
   Рядок, що не записався (напр. у правилі — видалений бізнес), не зупиняє імпорт: підсумок пише «з помилкою N» з причиною;
   рядок NovaPay з помилкою Марія пробує знову в наступному циклі.
9. NovaPay: номер ТТН в описі надходження (накладений платіж) прив'язує рядок до угоди з цією ТТН, якщо угода ще не сплачена:
   «Сплачено» угоди росте само.
10. **Правило імпорту** — «Налаштування → Фінанси → Правила імпорту»: назва, банк (будь-який, Monobank, ПриватБанк, NovaPay), умова
   (слова опису через кому — будь-яке; контрагент містить — для платежу карткою без контрагента дивиться в опис; IBAN містить;
   напрямок; сума від/до, напр. «1 000» — без регулярних виразів), дія,
   категорія чи гаманець, бізнес, «проводити без перевірки», «увімкнено». Порядок — перетягуванням за «⋮⋮».
11. **Дія «Оплата замовлення»** (з 22.10) — для надходжень, де в призначенні номер замовлення майданчика: «Оплата
   замовлення 58372062 … Загалом 130.00 грн. Комісія банку 1.69 грн.» (так Епіцентр платить через еквайринг monobank).
   Рядок шукає угоду з цим номером замовлення (поле номера замовлення каналу або назва угоди):
   - угоду вже нараховано в транзит каналу (угода виграна) — **переказ** з транзиту на рахунок з підставою «угода», а
     «Комісія банку» з призначення — витрата з транзиту; угода й далі «сплачена», другого доходу нема;
   - угоду ще не нараховано (не виграна, до дати переходу) і вона не сплачена — **дохід угоди** на суму замовлення
     («Загалом») і «Комісія банку» витратою з підставою «угода»: «Сплачено» = сума замовлення, рахунок = скільки прийшло;
   - угоди з таким номером нема чи її вже сплачено іншим платежем — рядок у «Вхідні» з поясненням.
Поле «Категорія доходу, якщо угода ще не нарахована» необов'язкове: порожнє — категорія з правила каналу угоди. Правило «Оплата замовлень (еквайринг monobank, Епіцентр)» (Monobank, контрагент «УНІВЕРСАЛ БАНК», опис «оплата замовлення») стоїть перед «Кешбек і відсотки банку» — інакше той, ширший, забрав би оплати в «Інші доходи».

### Правила імпорту
Правила імпорту вирішують, як рядки виписок Monobank, ПриватБанку й NovaPay лягають у журнал: категорія, контрагент, угода, бізнес. Спрацьовує перше правило згори, тож конкретні ставте вище за загальні.

## 7а. Маркетплейси: кабінети, транзит, канали продажів, «Вхідні»
**Навіщо.** У кожного майданчика (Prom, Rozetka, Kasta, Епіцентр, ОЛХ) є свій баланс у кабінеті: ми його поповнюємо, а майданчик списує з нього комісію по кожному замовленню. Гроші покупця майданчик (чи його виплатна система — RozetkaPay за Prom і Rozetka, ЮАПЕЙ за ОЛХ Доставку) тримає в себе і виплачує на наш рахунок пізніше. Вкладка «Фінанси → Маркетплейси» (з 20.10 замість «Звірки»; стара адреса веде сюди) показує все це на одному екрані, щоб бачити витрати по кожному майданчику і чи все приходить:
- **Плитки** зверху: «Майданчики винні» (сума транзитних гаманців), «На балансах кабінетів» (сума «Баланс · …»; мінус — ми
  винні майданчику), «Комісії за період», «Поповнили кабінети», «Прийшло на рахунок», «Потребують уваги» (картки з різницею чи
  питанням). Період — зверху (типово цей місяць); залишки кабінетів і транзитів — завжди на зараз, суми — за період.
- **Картка майданчика**: баланс кабінету за нашим журналом (поповнення − комісії угод) і **за API** поруч (Rozetka; у решти
  API залишку не віддає — «не дає»), різниця з позначкою; «винен (транзит)» — клік відкриває журнал гаманця; за період —
  продажі (нараховані доходи угод), комісії (і % від продажів; клік — журнал комісій), поповнення, виплати на рахунок,
  дата останньої виписки. Стан у кутку: **зійшлось** (кабінет за API = наш баланс), **є різниця** (кабінет за API ≠ наш
  баланс — з поясненням, звідки різниця буває), **є питання** (баланс у мінусі без поповнень, виплати давно нема, помилка
  API чи виписки, рядки виписки без угоди), **лише наш розрахунок** (API залишку нема — звіряти з кабінетом вручну або за
  випискою). Причини — під карткою й у «Детальніше».
- **Детальніше** — шторка: ті самі цифри, **комісії по днях** (у журналі «Операції» рядки комісій по кожному замовленню
  згорнуті, див. розділ 3; клік по дню відкриває їх), поповнення кабінету (витрати «Комісія …» з рахунку чи картки), інші рухи кабінету (штрафи,
  логістика, залишок на дату переходу, ручні правки), виплати на рахунок, виписка майданчика (остання: рядків, по угодах,
  виправлено, без угоди, інше) з рядками без угоди, і **журнал майданчика** (з 21.10) — усі рухи на його гаманцях за період,
  новіші першими, з позначкою що це: нарахування продажу, комісія, сторно, поповнення, виплата на рахунок, винагорода за переказ,
  на дату переходу; на спільному транзиті (RozetkaPay) — лише рядки цього каналу і спільні виплати. У журналі «Операції» цих
  рядків нема — вони живуть тут. Кнопки: **«Підтягнути з API»** — залишок кабінету (Rozetka) і виписка за 7
  днів (Rozetka, Kasta), **«Завантажити виписку»** — файл з кабінету Prom.
- **Виплатні системи** — транзит, спільний для кількох каналів (RozetkaPay платить за Prom і Rozetka одним платежем): скільки
  винна, нараховано за період, виплат на рахунок, винагорода за переказ, остання виплата.
- Нижче — **«Вхідні»** (рядки виписок без правила) і **правила каналів** (як було у «Звірці»).
- Баланси кабінетів і транзити — **не гроші бізнесу**: у «Огляді» й «Грошовому потоці» їх нема.
  **Комісії (рішення власника 21.10):** для Prom, Rozetka й Kasta витрата майданчика — це **поповнення балансу
  кабінету** (що реально заплачено з рахунку чи картки: категорія «Комісія ПРОМ / Розетка / Каста» на гаманці, з якого
  платили, як було в KeepinCRM), а нараховані по кожному замовленню комісії на «Баланс · …» — лише **звірка** (їх видно
  тут, у картках і журналі майданчика, і ніде в звітах: ні в P&L, ні в «Грошовому потоці», ні в «Своєму звіті»). Для ОЛХ
  (комісію утримує ЮАПЕЙ з виплати) і Епіцентру (поки в правилі нема балансу кабінету) комісія йде з транзиту й лишається
  витратою — поповнень у них нема, гроші справді утримано. Винагорода за переказ виплати (RozetkaPay, Kasta) і комісії
  реєстрів NovaPay — витрати завжди. Мета: «Комісії» у P&L за місяць = поповнення кабінетів за місяць + утримане з транзиту.

Щоб угода стала «сплаченою» вчасно, а комісія — витратою, у кожного каналу (і кожного акаунта каналу) є правило: «Фінанси → Маркетплейси» → рядок каналу внизу.
- **Нараховувати угоди каналу в журнал** — головний перемикач; вимкнено — у журнал нічого не пишеться.
- **Транзитний гаманець** — «скільки майданчик винен»: кнопка «Створити гаманець» робить «Транзит · <канал>» типу «транзитний».
- **Коли гроші угоди наші** — «Одразу при замовленні», «Коли угода виграна» або «На вибраних етапах» (галочки етапів воронок).
- **Лише якщо (поле угоди)** — напр. Prom: `prom_payment_type` містить «пром-оплат» (накладений платіж іде не через Prom, а через NovaPay).
- **Категорія доходу**, **Комісія майданчика** (сума з поля угоди — і **«Поле порожнє — відсоток від суми угоди»**; відсоток від
  суми угоди; фіксована + відсоток; умова «лише якщо»), **Звідки списується комісія** (транзитний гаманець каналу або баланс
  кабінету майданчика), **Категорія комісії**, **Попереджати, якщо виплати нема, днів** (типово 14).
- «Лише якщо» стосується **доходу** (гроші йдуть через майданчик). Комісію майданчик бере з продажу за будь-якої оплати, тож вона
  рахується за своєю умовою «Комісія лише якщо» — і для угоди з накладеним платежем через NovaPay (з 20.10).
- Заготовки комісій (як рахувала Марія до F2): Prom і Rozetka — сума з поля угоди; Епіцентр 17 %; Kasta 25 %; ОЛХ — 20 грн + 3 %
  лише при оплаті через ОЛХ Доставку; сайти й Telegram — без комісії.

**Що увімкнено з 20.10**:

| Канал | Транзитний гаманець (гроші угод і виплати) | Дохід угоди — коли виграна, лише якщо | Комісія | Звідки комісія |
| --- | --- | --- | --- | --- |
| Prom | «Транзит · RozetkaPay (Prom, Rozetka)» | `prom_payment_type` містить «пром-оплат» або «Тип оплати checkbox» — Rozetkapay | поле `prom_commission` (з API: `cpa_commission` замовлення); порожнє чи 0 — комісії нема | «Баланс · Prom» |
| Rozetka | той самий «Транзит · RozetkaPay (Prom, Rozetka)» | «Тип оплати checkbox» — Rozetkapay (картка, Apple/Google Pay, наложка ROZETKA Delivery) | поле `rozetka_commission` (з API: `commission_sum` позицій × кількість); порожнє чи 0 — комісії нема | «Баланс · Rozetka» |
| Kasta | «Транзит · Kasta» | усі угоди (Kasta сама доставляє й збирає гроші) | 21,6 % | «Баланс · Kasta» |
| Епіцентр | «Транзит · Епіцентр» | оплата monobank / карткою на майданчику | поле `epicentr_commission` (з API); порожнє чи 0 — комісії нема | той самий транзит |
| ОЛХ | «Транзит · ОЛХ» | оплата через ОЛХ Доставку | 20 грн + 3 % лише при ОЛХ Доставці (точну шле ШІ Едуард) | той самий транзит |

- **Чому один транзит на Prom і Rozetka**: «ТОВ РОЗЕТКА ПЕЙ» платить одним платежем на день операцій і за Пром-оплату, і за
  оплати Rozetka — суму угод, отриманих покупцем, мінус винагороду за переказ. Тому й дохід — коли угода виграна (отримана).
- **«ЮАПЕЙ» — це виплати ОЛХ Доставки** («…OLX.1» у призначенні), а не Prom: ціна мінус комісія ОЛХ. Угода ОЛХ Доставки, яку ШІ
  Едуард заводить через Telegram (джерело «ОЛХ»), у «Фінансах» — канал ОЛХ.
- **Комісія — від замовлення**: щойно угода з'являється, комісія лягає рядком по угоді в гаманець комісії (датою угоди);
  угода скасована — сторно. Дохід у транзит — коли угода виграна.
- **Баланс кабінету**: Prom, Rozetka й Kasta беруть комісію з балансу кабінету, який поповнюють окремо, а не з виплати. Тому
  комісії угод списуються з «Баланс · <канал>» — це **звірка**, а **платіж категорії комісії** (Марія: «Комісія Прому 1500»,
  рядок виписки, ручний) — звичайна **витрата** «Комісія …» на гаманці, з якого платили (власник 21.10; до 21.10 CRM робила з
  нього переказ у «Баланс · …» — 4 такі перекази повернуто у витрати). Картка «Баланс · <канал>» показує кабінет: поповнення
  від 14.10 − комісії угод; має збігатися з балансом у кабінеті майданчика; мінус — поповнення ще не внесені (напр. з картки,
  що не під'єднана) або в кабінеті був залишок на 14.10.
- **Виплата з винагородою**: якщо банк пише в призначенні винагороду (RozetkaPay — «за виключ. винагор. 150.21 грн», Kasta —
  «комiсiя 3.45 грн»), разом із переказом з транзиту проводиться витрата-винагорода з транзиту (RozetkaPay — категорія «Комісія
  RozetkaPay», Kasta — «Комісія Каста»), і транзит після виплати не тримає «боргу», якого нема.
- **Правила імпорту виплат** (без перевірки): «Виплата RozetkaPay (Prom і Rozetka)» (контрагент «РОЗЕТКА ПЕЙ»), «Виплата ОЛХ
  Доставки (ЮАПЕЙ)», «Виплата Kasta (ФК «Артуа», бонуси «Маркасон»)» (опис містить «kastaua_3pl») — новий рядок виписки стає
  переказом із транзиту сам. Виплати Monobank 15–19.10, які до цього лягли доходом «Продаж товарів», перетворено на перекази.
  **Епіцентр** платить кожне замовлення окремо через еквайринг monobank («Оплата замовлення 58372062 … Загалом 130.00 грн.
  Комісія банку 1.69 грн.», від «УНІВЕРСАЛ БАНК») — правило «Оплата замовлень (еквайринг monobank, Епіцентр)» з дією «Оплата
  замовлення» кладе платіж у саму угоду (розділ 7, п. 11); до 22.10 ці рядки помилково лягали в «Інші доходи».
- **Поповнення кабінету — витрата «Комісія …»** (власник 21.10, остаточно): правила імпорту «Поповнення кабінету Prom» (опис
  містить «prom.ua», «поповнення prom/пром») → «Комісія ПРОМ», «Поповнення кабінету Rozetka» («rozetka», «поповнення розетк») →
  «Комісія Розетка», «Передоплата Kasta (ФК «Артуа»)» («kastaua_3pl», списання) → «Комісія Каста» — без перевірки, на гаманці
  виписки. Поповнення з чату Марії («Комісія Прому 1500») так і лишається витратою. Оплата карткою на prom.ua чи rozetka як
  покупця теж стане «Комісією …» — виправте категорію в журналі чи «Правилах імпорту».
- **Межа переходу**: виплати перших днів після 14.10 — за угоди, створені ще до переходу (їх нарахування не бере). Тому в транзиті
  є рядок «Майданчик винен на 14.10» (дата 13.10): скільки майданчик винен за ці угоди. Повторно не створюється.

Що відбувається з угодою, коли момент настав (лише угоди від дати переходу 14.10.2026; угоду може закрити людина, трекінг посилки, тригер чи автодія етапу — нарахування однакове):
1. Дохід угоди в транзитний гаманець з угодою — лише несплачена частина: якщо автоплатіж етапу чи накладений платіж NovaPay за ТТН
   уже прийшли, майданчик винен менше (або нічого). «Сплачено» угоди дорівнює сумі.
2. Комісія — рядок з гаманця комісії (транзитного або «Баланс · <канал>») без угоди (підстава — угода), тож «Сплачено» не падає;
   змішана угода — кілька рядків, сума ділиться між бізнесами так само, як продажі. З 20.10 — одразу при замовленні (і для угоди,
   де момент доходу ще не настав). Запасний відсоток «Поле порожнє — відсоток» (у коментарі «N% (поле … порожнє)») — лише якщо
   його задано в правилі; у Prom, Rozetka й Епіцентру його нема: поле комісії порожнє чи 0 — комісії нема (рішення власника
   20.10: замовили з майданчика, а домовились напряму — майданчик не заробив). Поле комісії заповнює приймання з API
   замовлення (з 20.10, угоди від 14.10 дозаповнено): Prom — `cpa_commission` (є й у накладеному платежі; повернена — 0),
   Rozetka — `commission_sum` позицій × кількість, Епіцентр — комісія з рахунку замовлення; порожнє — API нічого не віддав.
3. Угода програна чи скасована — сторно обох рядків (зворотні операції з приміткою «Сторно»): «Сплачено» падає до нуля; у P&L
   комісія скасованої угоди віднімається. Угоду відновили й знову виграли — нараховується заново. Видалили угоду — її комісія
   з транзиту теж зникає.
4. Повтор нічого не дублює. Комісію з поля угоди, яку майданчик дописав пізніше (момент «одразу при замовленні»), доводить
   наступна зміна етапу. Для ОЛХ: комісію, яку надсилає ШІ Едуард, проведено одразу, а табличка ОЛХ Марії вже не просить
   «записати витратою».
5. Виплата з банку — правило імпорту «Виплата каналу» або кнопка «Виплата каналу» у «Вхідних»: баланс транзитного гаманця падає.

«Нарахувати з дати переходу» у шторці правила (з підтвердженням; незбережені зміни правила спершу зберігаються) проводить усі угоди каналу, що вже досягли моменту, і ті, що пройшли вибраний етап і пішли далі (повтор безпечний). Поле угоди в умовах і комісії підказується з назв полів.

**Як рахуються «Транзит · <канал>» і «Баланс · <канал>»** — це **наш розрахунок із журналу**, а не залишок, який віддає майданчик:
- **Транзит** = доходи угод каналу, що дійшли до моменту «гроші наші» (з 14.10; плюс рядок «Майданчик винен на 14.10»)
  − комісії, які списуються з транзиту (Епіцентр, ОЛХ, винагорода RozetkaPay/Kasta з призначення виплати) − виплати майданчика,
  що прийшли випискою банку. Плюс — майданчик ще винен; нуль — усе виплачено.
- **Баланс** = поповнення кабінету майданчика від 14.10 (витрати «Комісія ПРОМ / Розетка / Каста» з рахунку чи картки: рядок
  виписки, «Комісія Прому …» у чаті Марії, ручний) − комісії угод, які майданчик списує з балансу кабінету (від замовлення;
  скасована угода — сторно). Сам гаманець «Баланс · …» тримає лише комісії угод (мінус), поповнення картка додає з журналу.
  Почалося з нуля 14.10, тож без стартового залишку кабінету й без поповнень з картки, не під'єднаної до «Фінансів», може бути в мінусі.
- **Що звіряється з API майданчика** (перевірено 20.10): лише **Rozetka** — Seller API віддає баланс кабінету
  (`/v1/balances/current`, разом із комісіями замовлень у роботі). CRM бере його сама раз на годину; на картці гаманця
  «Баланс · Rozetka» («Гаманці») видно залишок за API поруч із нашим розрахунком і різницю. Різниця від
  1 ₴ — раз на добу подія в журналі картки Rozetka (від 100 ₴ — червона); якщо Rozetka пише, що до автоблокування магазину через
  борг лишилось ≤ 7 днів, — теж червона подія раз на добу. Prom, Kasta й Епіцентр залишку кабінету чи «до виплати» через API не
  віддають, ОЛХ — лише рекламний гаманець (не ОЛХ Доставка), тож їхні «Транзит» і «Баланс» звіряйте з кабінетом майданчика вручну.
- **Виписка майданчика** (шторка правила каналу → внизу, власник 20.10): комісія угод — за кабінетом, а не розрахункова.
  Rozetka — журнал балансу з API (комісія замовлення, її повернення при скасуванні), Kasta — звіт транзакцій з API (колонка
  «Гарантійний рахунок, роялті» — реальна комісія: напр. 26,10 на 174 ₴ замість розрахункових 21,6 % = 37,58). Обидва — щодня
  самі (після 07:00) і кнопкою «Підтягнути з API за 7 днів». Prom API балансу не має — «Завантажити виписку»: файл історії
  балансу з кабінету Prom (XLSX чи CSV; потрібні колонки опису й суми, номер замовлення — колонкою чи в описі). Що робиться з
  кожним замовленням: угоду знайдено за номером, вона від дати переходу й не скасована — комісія в журналі стає такою, як у
  кабінеті (наші рядки комісії видаляються, проводиться сума з виписки з приміткою «за випискою …»); та сама — нічого. Підсумок
  під кнопкою: рядків, по угодах, та сама, виправлено (різниця ₴), «угоду не знайдено», «інше» (поповнення гарантійного рахунку,
  штрафи, бонуси — їх проведіть самі або правилом імпорту). Перший файл Prom, якщо колонки не впізнано, покаже, які колонки знайшов.

**Транзитні гаманці** (тепер — у картках «Маркетплейсів» і «Виплатних системах»): баланс (майданчик винен), остання виплата (переказ з транзиту на рахунок; комісія чи сторно виплатою не рахуються), найстаріше невиплачене нарахування; червона крапка — виплати нема довше за налаштовані дні. Картка «Баланс · <канал>» — кабінет майданчика: «поповнення − комісії», без виплат і без червоної крапки; на спільному транзиті — рядок «Канали» (Prom, Rozetka). Що нормально бачити: транзит RozetkaPay — приблизно сума угод, отриманих учора й сьогодні (виплата — наступного робочого дня); транзит ОЛХ — ціна мінус комісія таких самих угод; великий плюс із червоною крапкою — виплата не прийшла або не впізнана (подивіться «Вхідні»). Під картками — **«Вхідні»**: рядки виписок, що чекають перевірки. Галочки й «Так для вибраних» — підтвердити як є; рядок → шторка: «Дохід»/«Витрата» (інша категорія, бізнес) або «Виплата каналу» / «Переказ у гаманець» (переказ, уже записаний правилом, лише переїжджає в обраний гаманець; друга частина розбирається разом); для доходу — поле «Угода (№)»: номер з картки угоди — рядок стає оплатою по ній (клієнт і підстава з угоди, «Сплачено» перераховується, лише несплачена угода); «без категорії» й «Спільне (без бізнесу)» справді прибирають категорію й бізнес; розібраний рядок повторно не розбирається; «Запам'ятати правило для таких рядків» створює правило імпорту (умова — контрагент рядка або ваші слова), «Далі проводити без перевірки» — наступного разу рядок у «Вхідні» не потрапить. У журналі «Операцій» фільтр «Перевірка» → «Лише «Вхідні»», пігулки «перевірити» і «нараховано». Рядок «Вхідних» прив'язали до угоди прямо у вікні операції (поле «Угода (№)» в «Операціях») — це теж розбір: «перевірити» зникає, рядок іде з «Вхідних» (з 22.10; інша правка, напр. коментар, прапорець не знімає).

## 7б. Оплати закупівель
Оплати партій закупівель стають звичайними операціями журналу з підставою «Закупівля»: у налаштуваннях обирають гаманець і категорії, куди вони лягають.

Вкладка «Закупівлі» (`/crm/finance/purchases`): партії з боргом перевізнику, постачальнику й за документи (галочка «лише з боргом»). Рядок партії → шторка: картки частин (план, сплачено, борг), оплати (архів до 16.10 — сірим, «звірено» — з випискою), «Нова оплата» (частина, сума, дата, гаманець, нотатка → «Провести оплату»), «Прив'язати операцію» (номер операції з виписки — видно в заголовку шторки операції «Операція №…»). «прибрати» питає підтвердження: оплату видалено з журналу, борг зріс; звірена з банком оплата не видаляється, а повертається у «Вхідні» на розбір. Зміна дати чи суми звіреної оплати в картці закупівлі банк не перепроводить; запис архіву правиться на місці. Видалили закупівлю — її оплати лишаються в журналі без підстави (нова закупівля їх не «успадкує»). Оплата — витрата з категорією частини, контрагентом (постачальник чи перевізник) і бізнесом за товарами партії (змішана партія — рядок на бізнес). Гаманець і категорії за замовчуванням — «Налаштування → Фінанси → Оплати закупівель». Докладно — стаття [Закупівлі](procurement.md).

**Борг партії — планова витрата** (з 20.10). Поки партія замовлена, у дорозі чи прибула, а частина (перевізник, постачальник, документи) сплачена не вся, у «Плановому» стоїть одна планова витрата на цю частину: сума — «лишилось» з картки закупівлі, дата — очікуваний прихід (якщо він уже минув чи не заданий — через 14 днів), гаманець і категорія — як в оплати, контрагент — перевізник чи постачальник. Її видно в прогнозі грошей і в залишку гаманця «з плановими». Що з нею далі:
- «Нова оплата» в картці закупівлі чи у вкладці «Закупівлі» **підтверджує** цю планову (вона стає оплатою, другої витрати нема);
  заплатили частину — на решту з'являється нова планова;
- рядок виписки банку на ту саму суму (±3 %) у межах ±10 днів від дати сам підтверджує планову (як будь-яку планову, §5);
- поставили галочку «оплачено», партію видалили чи сплатили все іншим шляхом (прив'язали операцію з «Вхідних») — планова
  зникає; змінили план, дату приходу чи прибрали оплату — планова перераховується. Чернетка планової не має.
Руками таку планову краще не правити — після наступного збереження картки вона перерахується з картки.

**Гроші за товар — один облік** (20.10). До переходу з KeepinCRM «Закупівля товарів» там записувалась на повну вартість партії датою приходу, а справжні оплати жили лише в модулі закупівель. Записи KeepinCRM без певної пари лишились як були. Стартовий залишок гаманця підбито так, щоб баланс не змінився. Видалена операція з KeepinCRM більше не повертається сама: раніше кожна викатка CRM заново проганяла імпорт старого вивантаження KeepinCRM і відновлювала видалене, тепер такі операції запам'ятовуються як видалені й імпорт їх пропускає.

## 7в. Партнери, капітал, виплати
Партнери задаються в бренді («Налаштування → Бренди та юрособи → бренд → Партнери бізнесу»: частка, «повертати собівартість», кишеня, «Початок обліку бізнесу»; стаття «Бренди та юрособи»). Вкладка «Партнери» (`/crm/finance/partners`): бізнес, «Капітал» або «Виплати».
- **Капітал**: «Гроші бізнесу» (фактичні операції бізнесу на рахунках і в касі від початку обліку), «Прибуток» (угоди бізнесу —
  сума позицій мінус собівартість і комісія майданчика — мінус витрати бізнесу, крім закупівлі товару, комісій і внесків), по
  кожному партнеру: внесено (дохід «Внесок партнера» з партнером + витрати з його кишені на бізнес), виведено («Виплата партнеру»
  й інші виведення з партнером), частка прибутку, капітал = внесено − виведено + частка, до виплати (затверджені виплати). Той самий
  вигляд — «Звіти → Капітал».
- **Виплати**: партнер, період → «Розрахувати» (угоди бізнесу періоду: продано, комісія, заробили, партнеру; без собівартості —
  список артикулів) → «Створити чернетку» → у шторці корекції («+ корекція», «Зберегти корекції») → «Затвердити» → гаманець і
  дата → «Виплатити»: операція «Виплата партнеру» (клас «Виведення власнику чи партнеру», підстава «Виплата»). «Скасувати
  проведення» видаляє операцію; чернетку чи затверджену можна видалити. «Завантажити XLSX» — розрахунок по позиціях.
- Частка партнера на позиції: частка на товарі (картка товару → «Партнери»), інакше частка партнера в бренді; «не у виплату» на
  товарі — позиція не йде в його виплату. Частки на товарі (свої й типові) разом — не більше 100 %; «повертати собівартість» —
  в одного партнера.
- Виплату не можна створити на період, що перетинається з іншою виплатою того самого партнера. Змінили затверджену (корекції,
  перерахунок) — вона знову чернетка: затвердіть ще раз. Незбережені корекції блокують «Затвердити» й «Виплатити»; «Видалити» й
  «Скасувати проведення» — з підтвердженням.
- Капітал: частка прибутку угод — як у розрахунку виплати (з частками на товарах), витрати — за типовою часткою; комісія не по
  угоді (щомісячна плата майданчику) — витрата бізнесу; переказ з рахунку бізнесу в кишеню партнера — «виведено».
- ШІ Свєта показує те саме для свого бізнесу в пульті («Налаштування → ШІ-співробітники → Свєта», стаття «ШІ Свєта») і готує
  чернетки виплат; проводить виплату людина.

## 7г. P&L по бізнесах і спільні витрати
Спільні витрати без бізнесу — оренда, зарплата, реклама на всіх — діляться між бізнесами за правилами розподілу, щоб P&L кожного бізнесу був чесним. Спрацьовує перше правило згори.

«Звіти → P&L по бізнесах»: період, «Усі бізнеси» або один, XLSX/PDF.
- **Рядки**: виручка; собівартість проданого; валовий прибуток; витрати за класами (комісії майданчиків, доставка клієнтам,
  реклама, зарплата, постійні, банк, інші, повернення клієнтам мінус від постачальників); інші доходи; операційний прибуток;
  податки; чистий прибуток. Довідково (у прибуток не входять): закупівля товару грошима, внески, виведення й виплати, позики.
- **Метод**: з 1-го числа місяця дати переходу (перехід 14.10.2026 → з 01.10.2026; межа помісячна, щоб гроші й угоди не
  змішувались в одному місяці — інакше оплачена закупівля на початку місяця «зникала» в собівартості) — нарахування: виручка й собівартість з угод (момент угоди в періоді, без програних;
  бізнес — за товарами); до неї — грошовий: виручка = надходження класу «Продажі», собівартість = оплачена закупівля. Оплата після
  дати переходу за угоду, створену до неї, — теж виручка грошима (інакше вона не потрапила б ніде). Фільтр «Юрособа» бере й угоди
  з юрособою «за правилом». Метод підписано над таблицею.
- P&L, «Податки» й «Капітал» рахують усі гаманці — відкриті тим, кому доступні всі гаманці.
- **Колонки**: бізнеси (без «Не рахувати у звітах»), «Спільні (не розподілено)» і «Разом». Зірочка біля суми — частину спільних
  витрат розподілено правилом (наведіть — побачите правило).
- **Розподіл спільних витрат** — «Налаштування → Фінанси → Розподіл спільних витрат» (або кнопка над звітом): правила згори
  вниз, спрацьовує перше; умова — класи витрат; метод — «Пропорційно продажам місяця», «Порівну між бізнесами», «Фіксовані частки»
  (разом 100 %), «Усе одному бізнесу»; «Не ділити на бізнеси» — винятки. Типове правило (створюється саме): постійні, зарплата,
  реклама, банк, інші, доставка — пропорційно продажам. «Переглянути розподіл за місяць» — як розкидалося.
- Марія показує «По бізнесах (P&L)» у фінансовому звіті, дашборд директора — P&L за 14 днів.

## 7ґ. Податки юросіб
Податки — планові операції по кожній юрособі з її доходів. Ставки й склад податків задаєте ви: у CRM немає зашитого податкового законодавства.
1. «Налаштування → Бренди та юрособи → Юрособи» → юрособа → блок «Податки» → «Вести податки».
2. «Планувати з місяця» — з якого місяця ставити планові (раніше сплачене не дублюється). «Гаманець сплати» — з якого рахунку
   платите (порожньо — перший гаманець юрособи). «Що входить у базу» — класи доходів; повернення клієнтам віднімаються, внески,
   позики й перекази не входять.
3. «+ Податок»: назва, вид — «Відсоток від бази» (ставка %) або «Фіксована сума» (грн), період — місяць чи квартал, «до … числа»,
   коли сплачувати — наступного місяця, через місяць чи через два після кінця періоду, категорія (типово — класу «Податки»),
   «діє». «Зберегти податки».
4. Одразу з'являються планові податки за минулий і поточний період (видно в таблиці під налаштуваннями й у «Фінанси → Планові»).
   Щоночі CRM перераховує суму з фактичних доходів юрособи, поки податок не підтверджено; підтверджений не змінюється.
5. Підтвердити сплату: кнопкою в «Планових» (шторка з сумою й датою); рядком виписки з правилом «Сплата податку»; або напишіть
   Марії «податки 2235» — вона підтвердить планові з такою сумою (і рядок банку потім лише звірить, не задублює). Сума виписки, що
   сильно відрізняється від планової (100 грн на податок 5 000), сама планову не закриває — підтвердіть вручну. Вимкнений чи
   прибраний податок, зміна місяця на квартал — непідтверджені планові прибираються; старі прострочені чинного податку лишаються
   боргом. Перейменували податок — нова назва і в планових. Новий податок не «успадковує» сплати видаленого.
6. «Звіти → Податки»: рік і юрособа; по періодах — база, нараховано, сплачено, борг, стан («сплачено», «сплачено частково» — борг
   різниця, «заплановано», «прострочено», «не нараховано»); під таблицею — «інші сплати податків» (витрати класу «Податки»,
   внесені не через планові). XLSX і PDF. Межі періодів — за київським часом.
7. Марія нагадує про прострочені податки щодня (у межах години нагадувань), а про найближчі — у дні з налаштувань.

Підказки (перевірте у свого бухгалтера): ФОП 3 групи — єдиний податок відсотком від доходу за квартал; ЄСВ — фіксована сума щомісяця чи щокварталу; військовий збір — відсоток або фіксована сума залежно від групи.

## 7д. Платежі: через банк або до сплати
Вкладка «Платежі» (`/crm/finance/bank-payments`) — платежі, які готує CRM, а людина лише підтверджує. Для чого: щоб оплату постачальнику, перевізнику, партнеру чи оренду не набирати руками в банку, а щоб вона сама стала витратою в журналі з правильною підставою й категорією. Платіж починається з гаманця — від нього залежить, як він піде:
- **через банк** — гаманець рахунку ТОВ чи ФОП у «Monobank для бізнесу» (або гаманець, для якого ви раз обрали такий акаунт):
  CRM готує чернетку в банку → стан «Чекає підпису» → директор підписує в застосунку monobank → «Перевірити», «Перевірити все»
  чи крок ШІ Марії бачать підпис → «Проведено» і витрата в журналі. Гроші без підпису людини не йдуть ніколи;
- **до сплати** — гаманець без платіжного API (особиста картка, готівка, рахунок іншого банку): CRM ставить планову витрату з
  реквізитами й строком у «Планові» → стан «До сплати» → ви платите з картки й натискаєте «Оплачено» (сума, дата й гаманець —
  якщо платили інакше), або рядок виписки на цю суму (±3 %, ±10 днів) підтверджує платіж сам → «Проведено».

1. «Новий платіж банку» → «Гаманець» (у списку підписано: «через банк» / «до сплати»); для рахунку ФОП без прив'язки оберіть
   «Акаунт» бізнес-API — далі CRM підставлятиме його сама.
2. Через банк: рахунок-відправник (лише гривневі), отримувач з підказок (юрособи, постачальники й перевізники з IBAN, попередні),
   IBAN, ЄДРПОУ / РНОКПП, сума, призначення → «Надіслати в банк» або «Зберегти чернетку».
3. До сплати: отримувач, сума, «Сплатити до», категорія витрати (щоб одразу лягла в P&L), призначення; IBAN і ЄДРПОУ — за
   бажанням, як підказка тому, хто платить → «Поставити до сплати».
4. Фільтр — «Усі», «Чекає підпису», «До сплати», «Проведено», «Відхилено», «Чернетки» (з лічильниками). У рядку «До сплати» —
   «Оплачено», «Перевірити» (звірити з «Плановими»), «Прибрати» (планова зникне).
Те саме з партії закупівлі («Оплати партії» → «Оплатити через Monobank») і з затвердженої виплати партнеру: платіж за партію не створює другої планової — він переймає борг партії з «Планових», а після оплати закриває його. Налаштування картки банку (ключ ТОВ чи ФОП), помилки — стаття [Monobank для бізнесу](int-monobiz.md).

## 7е. Кредити й позики
Вкладка «Кредити» (`/crm/finance/credits`) — кредитні лінії банків і позики. Для чого: бачити, скільки винні, скільки ще можна взяти і до якого дня внести гроші назад, щоб лишитись у пільговому періоді без відсотків; і щоб видачі й погашення не плутались із доходами й витратами бізнесу (у P&L вони не входять — це рух боргу). Плитки: «Винні банку» (усі лінії), «Ліміт разом» і «можна взяти ще», «Найближчий строк». У таблиці по лінії — ліміт, винні, можна взяти, «погасити до» (червоне — прострочено), гаманець, пільговий період.
1. «+ Лінія чи позика»: банк, вид (лінія з лімітом / позика), ліміт, гаманець (куди приходять гроші і звідки гасите), пільговий
   період у місяцях (2 — внести все до кінця другого місяця від видачі), «уже винні» (борг на сьогодні, якщо лінію вели до CRM),
   «можна на товар» (NovaPay: лише на комісії й витрати — зніміть галочку).
2. «Взяли» — сума й дата: дохід «кредит / позика отримано» на гаманець, «погасити до» — кінець пільгового від цієї дати; у
   «Планових» стає планова «Погасити … до …» на всю суму боргу.
3. «Погасили» — витрата «погашення кредиту / позики»; борг і планова перераховуються. Планову можна підтвердити і в «Планових»
   або рядком виписки — лінія перерахується сама.
4. «Переоформити» — «закрив і одразу взяв знову»: погашення всього боргу й нова видача (та сама чи інша сума) одним днем — новий
   пільговий період без відсотків; у журналі дві операції.
5. «⋮» → «Історія» (видачі, погашення, планова), «Змінити», «Закрити лінію» (лише без боргу).
6. Лінія на картці Monobank («за банком»): якщо гаманець лінії — картка, під'єднана як акаунт Monobank («Інтеграції → Monobank»
   → «Додати картку як акаунт», наприклад чорна …0040), CRM більше нічого не питає: ліміт = кредитний ліміт картки, винні =
   ліміт мінус залишок, «можна взяти» = залишок картки (у ньому вже є кредитні кошти). Оновлюється зі звіркою залишку (раз на
   годину після імпорту виписки) або кнопкою «оновити з банку» у рядку (не частіше разу на хвилину). День, коли борг зріс, —
   початок пільгового періоду: «погасити до» = кінець другого місяця від нього; борг зник — строк знімається. «Взяли» й
   «Погасили» для такої лінії — це операції самої картки у виписці, окремих записів у журналі CRM не робить (інакше гаманець
   подвоївся б); ручні видачі/погашення лишаються для ліній без картки.
Лінії зі старого розділу Марії «Закредитованість» уже тут: «вибрано» стало боргом «до обліку в CRM»; прогноз Марії читає ті самі цифри.

## 8. Звіти й експорт
- «Звіти»: «Грошовий потік» (таблиця за місяцями: дохід і витрата за категоріями, закупівля товару окремим блоком, прибуток, грошовий результат, наростаючий підсумок; рік, квартал, фактичні або з плановими, гаманець, бізнес), «Річний баланс» (гаманці на початок і кінець року, обороти; фільтр «Юрособа»), «Звіт P&L», «За класами» (суми за класами категорій за період: дохід, витрата, прибуток і окремо внески, виведення, позики; фільтр бізнесу й гаманця), «Клієнти» (дохід, оплати, угоди, середній чек), «Графіки».

**Що показує кожен звіт і як рахується** (одна логіка для всіх з 20.10):
- Спільні правила. *Переміщення* між своїми гаманцями (переказ, виплата майданчика з транзиту на рахунок) — не дохід і не
  витрата (поповнення кабінету майданчика з 21.10 — витрата «Комісія …», а комісії угод — лише звірка «Маркетплейсів»): у жодному звіті по всіх гаманцях їх нема; у звіті одного гаманця — є (це його обіг).
  *Закупівля товару* (категорії класів «Закупівля товару» і «Документи й доставка партії») — запас, не витрата періоду: усюди
  окремим числом, «Прибуток» — без неї, «Грошовий результат» — з нею; у журнал вона лягає датою приходу партії на повну
  вартість (як у KeepinCRM, рішення власника 20.10). *Комісії майданчиків* (з 21.10): для Prom, Rozetka, Kasta витрата —
  поповнення балансу кабінету з рахунку чи картки (категорія «Комісія …»); нараховані по угодах комісії на «Баланс · …» —
  звірка, у звітах їх нема (лише «Маркетплейси»); комісії з транзиту (ОЛХ, Епіцентр), винагорода за переказ і комісії NovaPay
  — витрати. До 21.10 було: *комісія* — витрата по кожному замовленню в день замовлення
  (з «Баланс · <канал>» або з транзиту) — у звітах грошей вони витрата класу «Комісії», у P&L — рядок «Комісії майданчиків».
  *Баланси майданчиків* («Транзит · …» — скільки винні, «Баланс · …» — кабінет) і кишені партнерів — не гроші бізнесу: у
  «Разом» їх нема, вони довідковим блоком. Межі днів і місяців — за Києвом; інші валюти — у гривні за курсом «Валюти і курс».
- **Грошовий потік** — гроші за рік по місяцях і категоріях (факт або з плановими): «Дохід» — усі надходження без переміщень
  (продажі, у т. ч. нараховані угоди майданчиків у транзит, інші доходи), «Витрата» — усі списання без закупівлі,
  «Закупівля товару (запас)» — окремо, «Прибуток» = дохід − витрата, «Грошовий результат» = прибуток − закупівля,
  «Наростаючий підсумок» — за грошовим результатом. Поточний місяць неповний (підписано «до дд.мм»). Клік по сумі — журнал.
- **Звіт P&L** (по місяцях) — ті самі числа, що «Грошовий потік», одним рядком на місяць: дохід, витрата, закупівля, прибуток,
  грошовий результат, наростаючий. Це грошовий звіт; справжня маржа з собівартістю проданого — у «P&L по бізнесах».
- **P&L по бізнесах** — нарахування: виручка й собівартість з *угод* за датою замовлення (не скасованих), з 1-го числа
  місяця дати переходу (до нього — грошима з журналу); витрати — операції журналу за класами (комісії, доставка, реклама,
  зарплата, постійні, банк, інші, повернення), спільні розподіляються правилами; податки окремо; закупівля грошима, внески,
  виведення й позики — довідково, у прибуток не входять. Тому «Виручка» тут ≠ «Дохід» «Грошового потоку» того ж місяця:
  там — коли гроші прийшли (виплати майданчиків, накладені платежі), тут — коли замовили.
- **Річний баланс** — по гаманцях: на 01.01 (стартовий залишок + операції до року), доходи й витрати року (з
  переміщеннями — це обіг гаманця), на 31.12. «Разом» — лише гроші бізнесу (банк, готівка, платіжні рахунки); транзит,
  кабінети майданчиків, кишені — нижче довідково. Фільтр «Юрособа» — гаманці юрособи.
- **За класами** — суми за період за класами категорій (продажі, інші доходи; комісії, доставка, реклама, зарплата, постійні,
  банк, податки…), без переміщень і без операцій без категорії: «Дохід», «Витрата (без закупівлі товару)», «Закупівля товару
  (запас)», «Прибуток за класами (без закупівлі)», «Грошовий результат (із закупівлею)»; внески, виведення й позики — окремо,
  не дохід і не витрата. Суми збігаються з «Грошовим потоком» за той самий період (той звіт — по категоріях, цей — по класах).
- **Клієнти** — фактичні надходження з клієнтом (з платежу, інакше з угоди) за період, без переміщень: дохід, оплат, угод,
  середній чек = дохід ÷ (угод з оплатою + оплат без угоди). Нараховані доходи угод майданчиків (транзит) сюди входять —
  вони по угоді; виплата майданчика на рахунок — ні (переміщення).
- **Графіки** — «Дохід і витрата по періодах» (стовпчики: дохід, витрата без закупівлі, закупівля блідим), плитки «Дохід»,
  «Витрата» (без закупівлі), «Закупівля товару», «Прибуток» (без закупівлі), «Грошовий результат»; кільце часток категорій
  (для витрат — без закупівлі, вона підписана під кільцем); «По гаманцях» — обороти за період і баланс зараз: гроші бізнесу й
  «Разом у гривні», транзит і кабінети майданчиків — довідково.
- **Свій звіт** (з 20.10) — конструктор: період і **крок** (місяць, тиждень, день або без розбивки), **розріз** (категорія,
  клас категорії, бізнес, гаманець, канал продажу, юрособа, контрагент, напрямок), **показники** чіпами (дохід, витрата без
  закупівлі, закупівля товару, прибуток без закупівлі, грошовий результат, кількість операцій — можна кілька), фільтри
  «Гаманець», «Бізнес», «Напрямок». Таблиця «розріз × період»: при кількох показниках під кожним періодом — колонка на
  показник, праворуч «Разом», унизу підсумок; рядки за спаданням обороту, не більше 500 (звузьте період чи розріз). Канал
  операції — канал її угоди (номер замовлення майданчика, акаунт, джерело); нарахована комісія без угоди — з її позначки
  (`prom:deal:…`); операція без угоди — «Без каналу». Суми — за спільними правилами вище (без переміщень, закупівля окремо,
  у гривні). **Збережені звіти**: налаштували → «+ Зберегти фільтр» → назва; чіпи над формою підставляють збережене
  (особисті, як збережені фільтри списків; керування — клік по «Збережені»). XLSX і PDF — та сама таблиця.
- **Гроші в товарі**, **Маржа каналів**, **Капітал**, **Податки** — нижче в цьому розділі та в розділах 7в–7ґ.
- Звірка з «Маркетплейсами» (розділ 7а): комісії за період у картках майданчиків = клас «Комісії майданчиків» у «За класами»
  і сума категорій комісій у «Грошовому потоці» за той самий період (без комісій NovaPay і RozetkaPay за переказ виплати —
  вони з транзиту й тут теж є, але в картках майданчиків показані окремо як винагорода за переказ).
- «Грошовий потік» (з 20.10): блок «Закупівля товару (запас)» — під витратами, окремо: туди йдуть категорії класів «Закупівля
  товару» і «Документи й доставка партії». Це гроші за товар на склад, а не витрата періоду, тому рядок «Прибуток» = дохід −
  витрата **без** закупівлі, а «Грошовий результат» під ним = дохід − витрата − закупівля (скільки грошей лишилось);
  «Наростаючий підсумок» — за грошовим результатом. Справжня маржа з собівартістю проданого — у «P&L по бізнесах» (посилання
  під блоком). Поточний місяць підписано «Жовт. · до 20.10» і показано сірішим — він неповний, не порівнюйте з минулими.
  Категорії з часткою менше 1 % згорнуто в рядок «Інші (N)» («показати всі» розгортає); великі — за спаданням «Всього».
  Рядок «Без категорії» підсвічено — поруч посилання «розібрати у «Вхідних»». Клік по сумі (категорія × місяць або «Всього»)
  відкриває «Операції» з фільтрами: період, категорія, напрямок, гаманець і бізнес звіту; для «Без категорії» у фільтрі
  «Категорія» є значення «Без категорії». «Звіт P&L» по місяцях має ті самі колонки закупівлі й грошового результату.
- «Гроші в товарі» (з 20.10): зверху три плитки — склад за партіями (штук і гривень за собівартістю партій), сплачено за
  товар у дорозі (закупівлі зі статусом «в дорозі»: сплачено, повна вартість і скільки ще винні — як у картці закупівлі) і
  разом «заморожено» (склад + сплачене за дорогу). Під ними — оборотність: собівартість продажів за останні 90 днів у
  середньому за місяць (угоди без скасованих, як у «P&L по бізнесах») і на скільки місяців вистачить складу, а разом із
  товаром у дорозі (за повною вартістю) — теж. Таблиця товарів: залишок за партіями, собівартість залишку, продано за 90 днів
  (шт, ₴, маржа %), днів запасу (залишок ÷ середні продажі на день; «—» — за 90 днів не продавався, «> 1 року» — запасу понад
  рік); пошук, сортування кліком по заголовку, фільтр «лише «хвіст» / лише без собівартості» (кнопки над таблицею — те саме).
  «Хвіст» — залишок є, а продано за рік менше ніж на 500 ₴; «без собівартості» — залишок є, а собівартість 0 у партіях чи в
  картці товару (запас недооцінено, маржа продажів завищена — заповніть собівартість у картці). Під таблицею — дві «правди»
  про запас: партії проти карток товарів, різниця й товари, звідки вона (здебільшого від'ємні залишки на картках); звіт рахує
  за партіями — з цією собівартістю склад списує продане. XLSX і PDF — з тим самим фільтром.
- «Маржа каналів» (з 20.10): за період (типово — минулий і цей місяць; «Цей місяць», «Минулий місяць», «З початку року» або
  свої дати) по каналах — Prom, Rozetka, ОЛХ, Епіцентр, Kasta, дропшипери, сайти, Telegram, «Інше»: угоди, скасовано
  (lost/failed, шт і %), виручка й собівартість (як у «P&L по бізнесах»: за датою замовлення, без скасованих), валова маржа %,
  комісії, доставка клієнтам і маржа після комісій (₴ і % виручки), внизу «Разом». Комісія — по кожній угоді: нарахування
  каналу в журналі (з дати переходу, коли правило каналу ввімкнено), інакше — за правилом каналу у «Звірці» (Prom і Rozetka —
  сума з поля угоди, Епіцентр 17 %, Kasta 25 %, ОЛХ 20 ₴ + 3 % за ОЛХ Доставкою; так само рахує Марія), плюс комісії журналу,
  прив'язані до угоди (наприклад комісія NovaPay); доставка — операції класу «Доставка клієнтам» по угоді. Комісії й доставка
  з журналу без угоди (поповнення балансу майданчиків з KeepinCRM) у таблицю не входять, щоб не рахувати двічі, — їх сума за
  період під таблицею. **Червоним** підсвічено канал, де скасовано більше 20 % угод або маржа після комісій менша за 40 %
  виручки. Угоди-копії Епіцентру (наші копії угод
  KeepinCRM з тією самою хвилиною й сумою) не рахуються. Звіт рахує виручку всього бізнесу, тож відкривається тим, кому відкриті
  всі гаманці. XLSX і PDF.
- Фільтр «Бізнес» у звітах: «Усі», «Спільні (без бізнесу)» або один бренд.
- Перекази між своїми гаманцями — не дохід і не витрата: у «Грошовому потоці», «Графіках» і підсумках їх нема (у звіті одного
  гаманця — є, це його обіг). Переказ — лише пара операцій без категорії; пов'язані платежі зі старої KeepinCRM (наприклад закупівля
  частинами) — звичайні доходи й витрати, у звітах вони є (виправлено 19.10). Інші валюти — у гривні за курсом «Валюти і курс»; «Разом» річного балансу — теж у гривні (валюта
  без курсу не входить і підписана). Межі днів, місяців і року — за київським часом (31.10 о 23:30 — жовтень). Дата у фільтрі
  не за зразком (РРРР-ММ-ДД) — помилка, а не «за весь час».
- Звіти «Грошовий потік», «Річний баланс», «Клієнти» вивантажуються в XLSX і PDF; «Звіт P&L» — це «Грошовий потік» за класами,
  його файл — у вкладці «Грошовий потік». У файлі «Грошового потоку» — ті самі блоки (дохід, витрата, закупівля товару) і рядки
  «Прибуток», «Грошовий результат», «Наростаючий підсумок»; усі категорії повністю; неповний місяць — у заголовку колонки й підписі.
- «Експорт платежів»: «Відфільтровані» або «Усі за весь період», з вибором колонок, у XLSX.

## 9. Автоплатіж на етапі угоди
«Налаштування → Воронки й етапи» → у рядку етапу «Автоплатіж»: гаманець і категорія. Коли угода приходить на цей етап, несплачена сума проводиться доходом; повторно не дублюється. Перенесення угод між етапами в налаштуваннях автоплатіж не запускає.

## Довідники
Гаманці й категорії — скелет обліку: кожна операція лягає в гаманець (де гроші) і категорію (стаття), а від класу категорії залежить, як вона впливає на прибуток у P&L, капіталі й податках; від доступу до гаманця — хто що бачить і через що може платити.
- Вкладка «Довідники» (`/crm/finance/dicts`) — те саме, що «Налаштування → Фінанси → Гаманці» і «Категорії фінансів», але під
  рукою в «Фінансах». «⋮» гаманця: «Редагувати» (назва, валюта, стартовий залишок, вид, бізнес, юрособа, банк), увімкнути чи
  вимкнути, «Доступ до гаманця» (лише адміністратор), «Видалити» (гаманець з операціями не видаляється — вимкніть). «⋮»
  категорії: «Підкатегорія», «Перейменувати», «В архів» (якщо є операції) або «Видалити», «Повернути з архіву».
- Що важливо зробити один раз: правильний **клас** у кожної категорії (пігулка «перевірте клас» — клас вгадано за назвою, див.
  [1а](#1а-класи-категорій-бізнес-юрособа-й-підстава-операції)); **вид** у кожного гаманця — «Транзитний» для майданчиків і
  накладених платежів, «Особистий» для кишень партнерів, інакше вони потраплять у «Гроші бізнесу»; **стартовий залишок** на дату
  переходу — без нього баланс не зійдеться з банком.
- Переказ між своїми гаманцями категорії не потребує — це не витрата й не дохід; категорія потрібна лише грошам, що прийшли ззовні
  або пішли назовні.

## Фіскальні чеки
Вкладка «Фіскальні чеки» (`/crm/finance/receipts`) — усі чеки Checkbox компанії і **контроль**: чи на кожну отриману угоду пробито чек. Продаж без фіскального чека для податкової — порушення зі штрафом, тому пропущені треба бачити одразу й виписувати звідси. Як чек створюється (вручну з картки угоди і автоматично тригером «Чек Checkbox: замовлення отримано»), каси, касири й типи оплати — стаття [Checkbox](checkbox.md).
- **Журнал чеків** — як «Фінанси → Фіскальні чеки» у KeepinCRM: пошук за фіскальним номером, угодою, касиром; фільтри дати,
  організація (каса), продаж чи повернення, стан (проведено / фіскалізується / помилка); лічильник і суми вибірки; клік по номеру
  — перегляд чека, по угоді — її картка.
- **Контроль** (перемикач угорі; з тривоги «Огляду» відкривається одразу) — період (типово з 1-го числа; «Цей місяць», «Минулий
  місяць») і канал:
  - плитки: **Потрібен чек** — отримані (виграні) угоди періоду з сумою більше нуля, крім каналів без контролю; **Чек є** —
    чинний чек нашої каси (окремо — скільки пробила ще KeepinCRM до переходу, їх суми CRM не знає); **Без чека**; **Покриття**
    — частка угод з чеком; **Чеки проти виручки** — виручка угод з нашим чеком мінус сума їхніх чеків (нуль — чеки на всю суму;
    різниця — часткові чеки, знижка чи доставка поза чеком). Період — за датою замовлення (як P&L), угода «отримана» — результат
    «виграно» або етап з роллю «виграно» («Отримано», «Отримано Покупцем»…).
  - таблиця **по каналах** (Prom, Rozetka, Kasta, Епіцентр, ОЛХ, сайти, Telegram, «Інше»): клік по каналу фільтрує список;
    адміністратор галочкою «Без контролю» виключає канал, якому чек не потрібен (типово контролюються всі — у KeepinCRM чек
    пробивали кожному каналу);
  - **чому без чека** — пігулки з причинами: «автоматичний чек вимкнено», «етап не запускає чек» (угода виграна на етапі, якого
    нема в умові тригера), «отримано до запуску тригера» (у KeepinCRM чи до 15.10), «помилка тригера» (нема типу оплати, каси,
    зміни — текст з журналу тригера), «тригер пропустив» (нема позицій), «помилка Checkbox», «чек повернено, нового нема»;
  - **список**: угоди без чека, скасовані з неповерненим чеком («поверніть чек у картці угоди»), з кількома чинними чеками, з
    сумою чеків, що відрізняється від суми угоди більше ніж на 1 ₴; фільтри «Усі проблеми / Без чека / Скасовані з чеком /
    Кілька чеків / Сума не та / З нашим чеком / Чек KeepinCRM / Ще не отримані»;
  - **«Виписати»** у рядку або «Виписати всі пропущені / вибрані» (галочки) — після підтвердження створює чек так само, як
    «+ → Фіскальний чек» у картці угоди: каса за юрособою угоди, тип оплати з поля «Тип оплати checkbox», ваш доступ до каси
    («Доступи» профілю), зміна відкривається сама; захист «один чек на угоду» діє. Що не вдалося (нема типу оплати, каси) —
    у повідомленні з причиною по кожній угоді, решта виписується. До 30 чеків за раз; щойно отримані (менше години) у тривогу не
    входять — тригер ще працює.
- **Тривога в «Огляді»** «Фіскальні чеки: N угод потребують уваги за 30 днів» — отримані без чека (сума) і скасовані з
  неповерненим чеком; кнопка «Чеки» веде на «Контроль». Інтеграцію Checkbox вимкнено — тривоги нема (чеків не буде зовсім —
  про це каже сама вкладка).
- Для ШІ: `checkbox_control` (date_from, date_to, channel, status) — ті самі цифри й список; `checkbox_control_issue`
  (deal_ids) — виписати, через підтвердження людини.

## Можливі помилки
| Що ви бачите | Чому | Що зробити |
| --- | --- | --- |
| «Немає права проводити платежі (Фінанси: проводити й змінювати платежі)» | Не відкрито право проводити | Попросіть адміністратора відкрити галочку |
| «Немає доступу до гаманця «…»» | Гаманець відкрито лише вибраним людям | Попросіть адміністратора додати вас у «Доступ до гаманця» |
| «Немає доступу до розділу «Фінанси»» | Розділ не відкрито | Попросіть адміністратора |
| «Гаманці переказу мають бути різними» | Переказ у той самий гаманець | Виберіть інший гаманець-отримувач |
| «У гаманці … операцій — вимкніть його замість видалення» | Гаманець з операціями не видаляється | Вимкніть гаманець |
| «Оновлювати залишок з банку може лише адміністратор» | Кнопка «Оновити з банку» — лише адміністратору | Попросіть адміністратора або дочекайтесь імпорту виписки |
| «Гаманець «…» не під'єднано до банку (Monobank чи NovaPay)» | У гаманця нема акаунта банку | Під'єднайте гаманець у «Інтеграції → Monobank / NovaPay → Налаштування» |
| «Monobank: не частіше 1 запиту на хвилину …» | Банк обмежує запити | Зачекайте хвилину й натисніть ще раз |
| Червона «різниця …» на картці гаманця | Залишок у банку не збігається з журналом | «Розібрати»: холди, внесені вручну без пари в банку, нез'ясоване; якщо банк правий — «Прийняти залишок банку» (див. [6а](#6а-звірка-з-банком)) |
| «Звірку вже змінено — скасувати не можна…» | Після «Прийняти залишок банку» точку вже пересунули (імпорт, інша людина) | Відкрийте «Розібрати» ще раз і перевірте різницю |
| «Залишок банку ще невідомий…» | Банк ще не віддав залишок (не було імпорту) | «Оновити з банку» або дочекайтесь імпорту виписки |
| «Операція вже фактична» | Планову вже підтвердили | Нічого не робіть або відкрийте операцію в журналі |
| «Угода вже сплачена — вкажіть суму посилання» | Несплаченого нема | Впишіть суму посилання вручну |
| «Дата «до» раніше за дату «від»» | Переплутано межі періоду | Виправте дати |
| «клас «…» — для витрат, а категорія — дохід» | Клас іншого виду | Оберіть клас зі списку саме цього виду |
| «бізнесу (бренду) … не існує» | Бренд видалили або id з помилкою | Оберіть бізнес зі списку |
| «тип гаманця має бути одним з: …» | Невідомий тип | Оберіть тип зі списку |
| «щоб увімкнути, оберіть транзитний гаманець каналу» | Правило без гаманця | «Створити гаманець» або оберіть наявний |
| «оберіть етапи, на яких гроші вважаються нашими» | Момент «на вибраних етапах» без етапів | Поставте галочки етапів |
| «… категорія «…» іншого виду» | Категорія доходу — витратна чи навпаки | Оберіть категорію потрібного виду |
| «спершу увімкніть правило каналу» | «Нарахувати з дати переходу» на вимкненому правилі | Увімкніть і збережіть правило |
| Угода каналу не стала «сплаченою» | Правило вимкнено, угода до дати переходу, момент ще не настав або не виконано умову («лише якщо») | Перевірте правило каналу у «Звірці» |
| «умова порожня: вкажіть слова опису, контрагента або IBAN» | Правило імпорту без умови | Додайте хоч одну частину умови |
| «оберіть категорію» / «оберіть транзитний гаманець каналу» | Дія правила без цілі | Оберіть категорію чи гаманець |
| «категорія «…» іншого напрямку, ніж умова» | Напрямок умови — списання, а категорія — дохід | Змініть напрямок або категорію |
| «фіксовані частки мають давати 100 %, зараз … %» | Частки правила розподілу не дають 100 | Виправте частки |
| «умова порожня: оберіть класи, категорії або гаманці» | Правило розподілу без умови | Позначте класи витрат |
| «у правилі лише класи витрат» | У правилі розподілу клас доходу | Приберіть клас доходу |
| У P&L витрата в колонці «Спільні» | Витрата без бізнесу не підпала під жодне правило | Додайте правило розподілу або задайте бізнес операції |
| «сума часток партнерів бізнесу — … %, більше 100 %» | Частки разом перевищують 100 % | Змініть частки в бренді |
| «затвердити можна лише чернетку» / «провести можна лише затверджену виплату» | Не той стан виплати | Затвердіть, потім виплатіть |
| «виплату вже проведено — спершу скасуйте проведення» | Змінюєте проведену виплату | «Скасувати проведення» |
| «партнер … не з бізнесу цього товару» | Частку задають партнеру іншого бренду | Перевірте папку товару (бренд) |
| «… відсоток має бути від 0 до 100» / «… вкажіть суму» | Податок без ставки чи суми | Заповніть ставку або суму |
| «… відсоток рахується лише від доходів (база «доходи»)» | Відсотковий податок без бази | Залиште вид «Відсоток від бази» з базою «доходи» |
| «у базу входять лише класи доходів» | У базі податку клас витрат | Позначте лише класи доходів |
| «… день сплати — від 1 до 31» | День сплати поза місяцем | Вкажіть число місяця |
| Планових податків нема, хоча податки збережено | У юрособи нема гаманця, податок вимкнено або база ще нуль | Оберіть «Гаманець сплати», увімкніть «діє», перевірте доходи юрособи |
| Виписка ДПС не підтвердила податок | Сума не збіглася ні з одним податком і з сумою найближчого дня, а поряд кілька планових | Підтвердіть потрібну планову в «Планових» |
| «оберіть гаманець оплат закупівель …» | Нема гаманця для оплати партії | «Налаштування → Фінанси → Оплати закупівель» |
| «операція … вже має підставу «…»» | Прив'язуєте до партії операцію угоди | Перевірте номер операції |
| Виписка не створила рядок, хоча гроші пішли | Рядок звірено з уже внесеною операцією (та сама сума, ±3 дні) | Знайдіть операцію з позначкою «звірено» |
| Рядки виписки знову у «Вхідних» | Правило без «проводити без перевірки» | Увімкніть галочку в правилі |
| У журналі «спільне» там, де мав бути бізнес | Угода без товарів зі складу, гаманець і категорія без бізнесу | Задайте бізнес у шторці операції або «Бізнес» гаманця чи категорії |
| «Це частина переказу між гаманцями: суму, гаманець… не змінюються по одній нозі» | Правка однієї частини переказу розвела б гаманці | Дата й коментар — можна; суму чи гаманці — видаліть переказ і створіть новий |
| «Зробити проведений платіж плановим може лише той, кому дозволено видаляти проведені платежі» (403) | Так обходили заборону видалення | Попросіть адміністратора або залиште платіж фактичним |
| «P&L рахує всі гаманці — він доступний, коли вам відкриті всі гаманці» (403) | Звіт по бізнесу показав би суми закритих вам гаманців | Доступ до гаманців — «Налаштування → Фінанси → Гаманці → Доступ» |
| ««Маржа каналів» рахує всі гаманці — він доступний, коли вам відкриті всі гаманці» (403) | Звіт по всіх продажах — як P&L | Доступ до гаманців — «Налаштування → Фінанси → Гаманці → Доступ» |
| «Рядок уже розібрано — змініть операцію в журналі» | Рядок «Вхідних» розібрали раніше (чи в іншій вкладці) | Відкрийте операцію в «Операціях» |
| «Дата «від»: … — не дата (РРРР-ММ-ДД)» | Дату у фільтрі чи запиті ШІ записано не за зразком | Напишіть 2026-10-01 |
| «період перетинається з виплатою №…» | Ті самі угоди вже у виплаті цьому партнеру | Змініть дати або відкрийте ту виплату |
| «на цьому товарі частки партнерів разом — … більше 100 %» | Своя частка одного партнера плюс типові частки інших > 100 % | Задайте на товарі частки всім партнерам (разом 100 %) |
| «„повертати собівартість“ може бути лише в одного партнера» | Собівартість повернулась би кілька разів | Залиште галочку одному; для окремого товару — у картці товару |
| Надходження Monobank не прив'язалось до угоди | Угоду вже сплачено, номера нема в призначенні або в акаунті «не прив'язувати» | «Вхідні» → рядок → «Угода (№)» |
| Імпорт: «з помилкою N: …» | Правило імпорту посилається на видалений бізнес чи гаманець | Виправте правило в «Налаштування → Фінанси → Правила імпорту» й повторіть імпорт |
| «Контроль» чеків: «Виписано 1, не вдалося 2: … Не вибрано тип оплати» | В угоді порожнє поле «Тип оплати checkbox» або значення не пов'язане з типом оплати каси | Відкрийте угоду, заповніть поле (чи мапу «Способи оплати» в профілі Checkbox) і виписуйте знову |
| «Контроль» чеків: «У вас нема доступу створювати чеки цього профілю» | Ваш користувач не в «Доступах» каси | Попросіть адміністратора додати вас у «Інтеграції → Checkbox → Доступи» |
| У «Контролі» угода «без чека», хоч чек пробито в KeepinCRM | Імпорт не приніс позначку «фіскалізовано» | Поставте в угоді «Фіскалізовано» (або виписуйте чек нашою касою, якщо його справді не було) |
| «Невідомий канал: …» (налаштування контролю) | Галочка «Без контролю» для каналу, якого CRM не знає | Канали — Prom, Rozetka, Kasta, Епіцентр, ОЛХ, сайти, Telegram |

## Для ШІ-співробітників
Інструменти розділу `finance` (доступ «Фінанси» у «Доступах» співробітника; проводити — ще й «Фінанси: проводити й змінювати платежі») — ті самі маршрути `/api/crm/finance`, що й у людини, з тими самими перевірками полів, гаманця й прав. Картка розділу — `GET /api/ai/sections/finance` (поля з «Типи даних → Фінанси» з назвами в тілі запиту `api`, дії, приклади); у «⋮» «Фінансів» — «Вхід для ШІ».
- `finance_refs` — гаманці (з типом і юрособою), категорії (з класом), бізнеси (`brands`), класи (`roles`), юрособи, типи гаманців,
  `fields` — поля операції (вбудовані з прапорцями й власні).
- `finance_transactions` — журнал: `from`/`to`, `purse_id`, `category_id`, `kind`, `deal_id`, `client_id`, `planned`, `brand_id` (0 — спільні), `legal_id`, `role` (клас: `sales`, `cogs`, `commission`, `ads`, `salary`, `fixed`, `tax`, …), `ref_type`. У рядку — `brand`, `role`, `legal`, `ref`.
- `finance_transaction_get`, `finance_purses`, `finance_summary` (з `brand_id`, `legal_id`), `finance_by_role` — суми за класами за період.
- `finance_bank_check` (`purse_id`) — звірка гаманця з банком: залишок банку й журналу на момент знімка, `diff`, `holds`,
  `manual_items` (внесені вручну без пари в банку — дубль прибрати `finance_delete_transaction`), `unexplained`, `anchor_at`;
  `finance_bank_accept` (`purse_id`) — «Прийняти залишок банку», кошик «payments» (розділ [6а](#6а-звірка-з-банком)).
- `finance_reconcile` — звірка: транзитні гаманці каналів (скільки винен майданчик, остання виплата, попередження), кількість «Вхідних»;
  `role` — `transit` (гроші угод і виплати) чи `balance` («Баланс · <канал>»: поповнення кабінету мінус комісії, `topups` —
  поповнення від 14.10), `channels` — канали гаманця. Поповнення кабінету Prom/Rozetka/Kasta з чату записуйте як завжди —
  витратою «Комісія …» з гаманця, з якого платили: це і є витрата на майданчик; комісії угод — лише звірка, у витрати не йдуть.
- `finance_channels`, `finance_import_rules` — правила каналів і імпорту (лише читання: змінює їх людина).
- `finance_transactions` з `review=1` — рядки «Вхідних»; `finance_review` (`action=ok` з `category_id`/`brand_id` або `payout` з
  `purse_id`; `remember` — правило; `deal_id` — прив'язати дохід до угоди, як поле «Угода (№)») і `finance_review_bulk` (`ids`) —
  **через підтвердження людини** (вид `payments`).
- Банк Monobank — картка `int-monobank`: `monobank_accounts` (рахунки акаунта), `monobank_import` (виписка акаунта, вид `bulk`).
- Платежі банку — картка `int-monobiz`: `bank_payments_list`, `bank_payments_refs`, `bank_payment_for_purchase`,
  `bank_payment_create` і `bank_payment_send` (вид `payments`; далі ще підпис людини в банку), `bank_payment_check`,
  `bank_payments_check_all`, `monobiz_import` (вид `bulk`). Налаштування акаунтів банку й токени ШІ не змінює.
- P&L: `finance_pnl` (from, to, brand_id, legal_id), `finance_alloc_rules` — читання; правила розподілу змінює людина.
- «Огляд» — маршрут `GET /api/crm/finance/overview` (той самий, що вкладка): `cash`, `receivables`, `payables`, `month`, `alerts`
  (у кожної тривоги `link` — вкладка з фільтром журналу або адреса). Окремого інструмента ШІ для нього поки нема — ті самі цифри
  дають `finance_purses`, `finance_pnl`, `finance_summary`, `finance_taxes`, `finance_payouts`, `purchase_payments`.
- `finance_attention` (`GET /api/crm/finance/nav`) — червоні цифри верхнього меню: `badges.unallocated` (надходження без угоди) і
  `badges.planned` (прострочені планові), у кожного `count`, `amount` (грн), `level` (`warn` | `danger`); порожньо — нічого не
  чекає. Рахує лише гаманці, відкриті співробітнику, — як у людини.
- Податки: `finance_taxes` (year, legal_id — база, нараховано, сплачено, борг), `finance_taxes_planned` (within_days, legal_id —
  непідтверджені планові податки) — читання; `finance_planned_confirm` (tx_id; at, amount, purse_id) — **через підтвердження
  людини** (вид `payments`). Ставки й склад податків змінює лише людина в шторці юрособи.
- Партнери: `finance_partners`, `finance_capital`, `finance_payout_calc`, `finance_payouts` (читання), `finance_payout_create`
  (чернетка, грошей не рухає), `finance_payout_pay` — **через підтвердження людини** (вид `payments`). Частки партнерів ШІ не змінює.
- Оплати партій — інструменти розділу `procurement`: `purchase_payments`, `purchase_pay`, `purchase_payment_link` (кошик).
- `finance_add_transaction` (з необов'язковим `brand_id`; не задано — бізнес з угоди, гаманця чи категорії; `custom` — власні поля),
  `finance_transfer`, `finance_update_transaction` (tx_id, лише передані поля) — **спочатку запитують** підтвердження людини (вид
  `payments`); `finance_delete_transaction` — підтвердження виду `delete`.
  `finance_update_transaction` змінює лише те, що справді інше; `planned: false` планової — це підтвердження (наступна щомісячна
  з'являється), `planned: true` проведеної — лише з правом видаляти проведені платежі; частину переказу — лише дата й коментар
  (обидві частини разом); `amount`/`kind`/`planned`/`at` порожніми (null) не передаються — 400.
- `finance_post_batch` — кілька операцій одним записом (`items`, до 50): одне підтвердження, усі або жодної («оренда 5000, світло
  1200, інтернет 300»).
- `finance_inbox` — «Вхідні» компактно; розібрати — `finance_review` (лише рядки «Вхідних»; `category_id: null` — без категорії,
  `brand_id: 0` — спільне; поле не передане — без змін).
- `finance_report` — будь-який звіт за `kind`: `pnl`, `cashflow`, `annual`, `by_client`, `by_role`, `capital`, `taxes`, `brand_legal`
  (період `from`/`to` чи `year`, `brand_id`, `legal_id`, `purse_id`); `finance_alloc_preview` (month) — розподіл спільних витрат.
  `pnl`, `capital`, `taxes` — лише ШІ, якому відкриті всі гаманці (інакше 403). Перекази в звітах — не дохід і не витрата; інші
  валюти — у гривні; межі періодів — за київським часом.
- Без права «проводити» запис → 403, чужий гаманець → 403, обов'язкове поле без значення → 400 з назвою поля — так само, як людині.
- `deals_add_payment` (розділ `deals`) — оплата по угоді (теж через підтвердження); бізнес — за товарами угоди.
- Фіскальні чеки: `checkbox_receipts_list` — журнал чеків; `checkbox_control` (date_from, date_to, channel, status — `missing`,
  `multi`, `mismatch`, `cancelled_receipt`) — чи на всі отримані угоди є чек: підсумок, по каналах, угоди без чека з `reason` і
  `can_issue`; `checkbox_control_issue` (deal_ids, до 30) — виписати пропущені, **через підтвердження людини** (вид `payments`).

Чого не робити:
- Не проводити оплату без прямого прохання людини і не повторювати дію з `pending_id`.
- Не вигадувати id гаманців, категорій і бізнесів — брати з `finance_refs`; ключі власних полів — з `fields` там же.
- Не змінювати налаштування полів, гаманців, правил і прав — це робить людина.
- Не міняти клас категорії «щоб звіт гарніше виглядав»: клас міняє людина в налаштуваннях.
- Не підтверджувати плановий податок, поки людина не сказала, що сплатила, і не вписувати податкові ставки «з пам'яті».
- Не проводити «Вхідні» масово без перевірки людиною і не «запам'ятовувати правило» з одного випадкового рядка.

## Додаткова інформація
- Пов'язані статті: [Угоди](deals.md), [Каса](cashbox.md), [Закупівлі](procurement.md), [Бренди і юрособи](settings-brands.md),
  [Типи даних](settings-fields.md), [Правила передачі](settings-transfer.md), [ШІ Марія Йосипівна](ai-maria.md),
  [Monobank](int-monobank.md), [Monobank для бізнесу](int-monobiz.md); інтеграції ПриватБанк, LiqPay, MonoPay, NovaPay,
  Checkbox — статті `int-*`.


---

# Каса

Каса — екран продажу для офлайн-магазину: касир відкриває зміну, сканує або шукає товар, приймає оплату готівкою, карткою чи змішано, і один натиск «Провести» створює угоду, списує товар зі складу, проводить гроші у фінанси й за потреби пробиває фіскальний чек Checkbox. Тут же — бронювання з передоплатою, повернення і звіт зміни.

## Можливості
- Кілька кас, у кожної свої касири, гаманці, категорії, джерело угоди, етап закритої угоди.
- Зміни з готівкою на початок; кілька чеків вкладками, відкладення чека.
- Пошук за артикулом, назвою, штрихкодом; сканер (штрихкод + Enter).
- Знижка на позицію і на чек (% або ₴), заокруглення до гривні вниз.
- Оплата «Готівка» (з рештою), «Безготівка», змішана; часткова — лише для броні.
- Продаж → угода + списання + операції у фінансах + чек Checkbox.
- Бронювання з резервом і передоплатою; завершення з доплатою або скасування.
- Повернення позицій з поверненням грошей з того гаманця, яким платили.
- «Звіт зміни» з «Реалізовані товари за зміну»; історія «Касові зміни».

## 1. Налаштування каси
Каса — продаж в офлайн-магазині: кожен продаж стає угодою, списує товар зі складу, лягає у фінанси й пробиває чек Checkbox.

Найшвидше: відкрийте «Каса» — якщо кас ще нема, адміністратор бачить **«Створити касу»**. Одна дія створює касу з того, що вже є: типова юрособа і її каса Checkbox (з «Інтеграції → Checkbox»), гаманці готівки й безготівки, категорії доходу й повернень, джерело «Магазин» (якщо є), воронка й етап виграшу; касиром стаєте ви з правом повернень. Змінити все можна в налаштуваннях.

Вручну:
1. «Налаштування → Фінанси → Каси» (з екрана каси — «Налаштувати вручну») → «+ Нова каса» — форма вже заповнена тими самими типовими значеннями.
2. Заповніть: «Назва *»; «Касири» (користувачі; для кожного — прапорець «Дозволити повертати фінанси з каси»); «Клієнт за замовчуванням» (не вибрано — «Роздрібний покупець»); «Тип ціни»; «Філія»; «Гаманець для готівки *» і «Гаманець для безготівки *» (різні); «Категорія доходу *»; «Категорія витрат для повернень»; «Джерело угоди»; «Воронка» і «Етап закритої угоди» або «В архів одразу»; «Бізнес» (куди лягають продажі каси у «Фінансах»; порожньо — за товарами угоди); «Юрособа» (від неї продаж і чек); «Каса Checkbox»: «За юрособою каси» (як у чеку з угоди: каса юрособи → загальна → єдина), конкретна каса з «Інтеграції → Checkbox» або «— не фіскалізувати —»; «Дозволити бронювання»; «Заокруглювати до гривні вниз».
3. «Зберегти».

Доступ: галочка «Каса» у «Налаштування → Розділи меню» типово вимкнена; касиру, доданому в касу, розділ «Каса» відкривається сам. Касир бачить лише свої каси, адміністратор — усі.

## 2. Відкрити зміну
1. Відкрийте «Каса», виберіть касу.
2. «Відкрити зміну» → «Готівка на початок» → підтвердіть.

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

## 4. Оплата і «Провести»
1. «Спосіб оплати»: «Готівка» (впишіть «Отримано готівкою» — побачите решту), «Безготівка» або змішана («Безготівкова частина, ₴»).
2. Натисніть «Провести».
3. Створюється угода на етапі закритої угоди (або в архіві) з джерелом каси, товар списується зі складу, оплата проводиться в гаманці каси з категорією доходу.
4. Якщо підключено Checkbox, пробивається фіскальний чек — тією ж касою Checkbox і тим самим механізмом, що й чек з угоди: чек з'являється в «Документах» угоди зі знаком «C», у «Фінанси → Фіскальні чеки», угода позначається фіскалізованою, другий чек на ту саму угоду не пробивається. Змішана оплата — двома оплатами в одному чеку (готівка + картка). Зміна Checkbox відкривається разом із зміною каси (і сама, якщо її не відкрито), закривається разом із нею (Z-звіт). Не вдалося — чек позначено «Не фіскалізовано», кнопка «Повторити».

У шапці каси видно, якою касою Checkbox іде чек: «Чек Checkbox: <каса> · каса юрособи».

## 5. Бронювання
1. Виберіть клієнта (не клієнта за замовчуванням), додайте товар.
2. Вкажіть передоплату («Передоплата готівкою, ₴» / «Передоплата безготівкою, ₴») — часткова оплата дозволена лише тут.
3. «Забронювати»: угода на початковому етапі, товар у резерві.
4. Вкладка «Заброньовані»: «Завершити» (доплата «Оплата залишку», списання, етап закритої угоди, фіскальний чек на всю суму) або «Скасувати бронь» (резерв знімається, передоплата повертається витратою, угода стає «Скасована» і йде в архів).

## 6. Повернення
1. При відкритій зміні — «Повернення».
2. «Пошук чека»: номер чека, угода, клієнт або телефон.
3. Позначте позиції й кількість (не більше проданого) → «Повернути».
4. Товар повертається на склад, гроші — витратою з категорією повернень з того гаманця, яким платили; створюється чек повернення, а для фіскалізованого продажу — фіскальний чек повернення лише на повернені позиції й суму (часткове повернення можна робити кілька разів; чек продажу вважається повернутим, коли повернено всю суму).

Потрібен прапорець «Дозволити повертати фінанси з каси» для касира.

## 7. Звіт і закриття зміни, «Касові зміни»
- «Звіт зміни»: «Готівка на початок», «Надходження готівкою», «Надходження безготівкою», «Повернення», «Готівка в касі», «Реалізовані товари за зміну».
- «Закрити зміну» — лише коли нема непорожніх активних чи відкладених чеків (порожні скасовуються самі).
- «Касові зміни» — історія змін з підсумками; фільтри «Усі каси», «Усі касири», період «Від» — «До».

Друку нефіскального товарного чека, службового внесення й винесення готівки і окремої кнопки X-звіту поки нема.

## Можливі помилки
| Що ви бачите | Чому | Що зробити |
| --- | --- | --- |
| «Спершу закрийте зміну каси» | Зміна вже відкрита | Закрийте поточну зміну або працюйте в ній |
| «Товар «…» не знайдено або його немає в наявності» | Нема такого штрихкоду чи вільного залишку | Перевірте товар на складі |
| «Порожній чек — додайте товар» | У чеку нема позицій | Додайте товар |
| «Часткова оплата — лише при бронюванні» | Сума оплати менша за чек | Доплатіть або «Забронювати» |
| «Для бронювання оберіть клієнта (не клієнта за замовчуванням)» | Бронь на роздрібного покупця | Виберіть або створіть клієнта |
| «Бронювання на касі «…» вимкнено в налаштуваннях» | Нема «Дозволити бронювання» | Увімкніть у налаштуваннях каси |
| «Змішана оплата: вкажіть безготівкову частину менше суми чека» | Безготівкова частина ≥ суми | Виправте суму |
| «Повернути можна лише проведений чек цієї каси» | Чек з іншої каси або непроведений | Знайдіть чек своєї каси |
| «Немає права «Дозволити повертати фінанси з каси» …» | Касиру не дано права | Зверніться до адміністратора |
| «Гаманці готівки і безготівки мають бути різні» | У налаштуваннях каси той самий гаманець | Виберіть різні гаманці |
| «Каса «…» в архіві» | Касу прибрано в архів | Виберіть іншу касу |

## Для ШІ-співробітників
5`. Продажі з каси ШІ бачить як звичайні угоди (`deals_list` з джерелом каси) і операції у фінансах.

## Додаткова інформація
- Пов'язані статті: [Угоди](deals.md), [Склад і товари](products.md), [Фінанси](finance.md), [Checkbox](int-checkbox.md).


---

# Фіскальні чеки Checkbox

Фіскальний чек створюється з угоди через інтеграцію Checkbox (ПРРО). У картці угоди чеки лежать у блоці «Документи» тими самими рядками, що й документи: знак «C», «Продаж (NovaPay)» або «Повернення (…)», фіскальний номер, стан, сума, дата, касир. Усі чеки організації — «Фінанси → Фіскальні чеки».

## Підключення каси: два кроки

Крок 1 — «Підключення каси» у профілі, усе на одній сторінці по порядку: 1) ключ ліцензії справжньої каси (кабінет Checkbox → «Каси»); 2) як входить касир — ПІН-код касира або логін і пароль касира (кабінет Checkbox → «Касири»; email і пароль від кабінету не підходять); 3) «Підключити касу» — перевіряє вхід, підтягує ПІБ з Checkbox, сам створює першого касира і вмикає інтеграцію. Після цього в «+» блоку «Документи» угоди з'являється «Фіскальний чек».

Крок 2 — касири, лише якщо їх кілька: «Додати касира» → ПІБ і спосіб входу: обліковий запис каси (нічого не вводити), ПІН-код (ключ ліцензії береться з каси) або свій логін/пароль. «Авторизація» підтягує ПІБ.

**Тестова й справжня каса.** У кабінеті Checkbox є «Тестові дані»: тестова каса зі своїм ключем ліцензії і тестовий касир, чиї чеки не йдуть до ДПС. Їх не можна змішувати: справжній касир з ключем тестової каси (або навпаки) дає відмову «Реальний касир не може працювати з тестовою касою». Для реальних чеків беріть ключ ліцензії справжньої каси («Каси») і справжнього касира («Касири»); для проби — і касу, і касира з «Тестових даних».

## Каса на кожну юрособу

У «Інтеграції → Checkbox» кожна організація (профіль) — це каса з касирами, доступами, пов'язаними полями й мапою способів оплати. У профілі є поле **«Юрособа»**: угоди цієї юрособи пробиваються саме цією касою. Юрособу угоди визначає її поле «Юрособа» або правила «звідки угода → юрособа» («Налаштування → Бренди та юрособи»): канал, джерело, бренд, воронка, папка складу. Одна юрособа — один профіль. Профіль без юрособи — «загальна каса» для угод, у яких своєї каси нема.

У картці угоди над документами показано, хто пробиває: «Чек пробиває: ФОП … · за правилом · каса …». Якщо для юрособи касу не налаштовано, система про це каже і просить обрати касу вручну.

## Створити чек

Номер угоди потрапляє в підвал чека рядком «Замовлення <номер>» (вмикається в профілі каси: «Номер угоди в підвалі чека», типово так); окремого поля для номера замовлення в Checkbox нема.

У блоці «Документи» угоди «+» → перший пункт **«Фіскальний чек: касир»** — чек створюється одразу: усі позиції угоди, каса за юрособою, тип оплати з поля угоди «Тип оплати checkbox» (значення → Готівка / Картка / своя назва безготівки за мапою профілю), email клієнта (якщо ввімкнено «Відправка Email»). Якщо зміну в Checkbox не відкрито — CRM відкриває її сама ключем ліцензії каси (налаштування профілю «Відкривати зміну автоматично, коли створюється чек», увімкнено типово; вимкнете — перед чеком спитає «Відкрити зміну?»). Якщо типу оплати в угоді нема або каси для юрособи нема — відкривається шторка, де їх можна вибрати.

**«Тип оплати checkbox» заповнюється сам**, коли замовлення приходить з площадки, і лише якщо поле порожнє (вибір людини не змінюється). Правила власника: Rozetkapay — оплата через Пром або Розетку (Пром-оплата, частинами, Google/Apple Pay, картка, накладений платіж Розетка Делівері); NovaPay — накладений платіж Новою поштою; UAPay — OLX-доставка; Карта — переказ на карту; Розрахунковий рахунок — оплата на рахунок; Готівка — готівкою; усе інше — Інтернет-еквайринг. Ручне поле «Спосіб оплати» головніше за дані площадки. Якщо про оплату ще нічого не відомо, поле лишається порожнім. Колонка «Тип оплати» у списку угод показує саме це значення (текст площадки, наприклад «Пром-оплата», — у полях маркетплейсу в картці).

Для ШІ: `checkbox_receipt_create(deal_id, values={profile_id?, payment_value?, emails?, comment?, open_shift?})`. Зміна відкривається сама; відповідь 409 з кодом `no_shift` буває лише коли в профілі вимкнено автоматичне відкриття — тоді повторити з `open_shift=true`; 409 `duplicate` — по угоді вже є чинний чек; 400 `no_payment` — вкажіть `payment_value` зі списку `payment_options` з `checkbox_deal(deal_id)`.

Архів не заважає: угода на етапі «Отримано» сама йде в архів як виграна, і саме її фіскалізують — і вручну через «+», і автоматичним чеком. Захищає лише правило «один чинний чек на угоду».

## Назва товару в чеку

Назва в чеку має бути одна на артикул, хоч би скільки оголошень із різними назвами було в прайс-листі. Тому в позиції прайс-листа є поле **«Назва Checkbox»**, яке склад передає в прайс-лист: воно само дорівнює назві пов'язаного товару складу і йде слідом, коли товар на складі перейменували. Його видно в картці позиції і колонкою в таблиці прайс-листа; за потреби можна вписати своє («= зі складу» повертає назву складу). У чек іде «Назва Checkbox» з прайс-листа. Угоди з каналів (Prom тощо) приходять з артикулом і товаром складу без посилання на позицію прайс-листа, тому CRM шукає її сама: позиція прайс-листа угоди → позиція з тим самим артикулом → позиція, пов'язана з тим самим товаром складу. Якщо «Назви Checkbox» ніде нема — назва товару складу, далі поле з налаштування профілю «Назва товару», далі назва позиції угоди.

## Фіскалізована угода

У списку угод фіскалізована угода має знак «C» біля назви, фільтр «Чек: усі / Фіскалізовані / Без чека» відбирає такі угоди. Для ШІ — параметр `fiscalized=1|0` у `deals_list`.

## Один чек на угоду

По угоді не може бути більше одного чинного чека продажу: поки попередній не повернуто, другий не створиться — ні людиною, ні ШІ, ні тригером. Позиції угоди, що в чеку, не редагуються. Щоб пробити заново — спершу «Повернути чек».

## Повернення, друк, посилання

Перегляд, PDF, PNG і текст чека CRM бере з публічних сторінок Checkbox без входу касира, тож вони працюють, навіть якщо вхід касира зламано.

«⋮» біля чека: Переглянути (вікно на весь екран: чек аркушем або текстом, кнопки «Checkbox» і «ДПС», закрити — «←» або Esc), Відкрити PDF, Скопіювати URL на чек (сторінка чека на сайті Checkbox, `https://check.checkbox.ua/<id чека>`), Друк TXT, Друк PNG, Повернути чек (чек повернення на той самий склад і суму; після нього угода знову вільна для чека), Відправити Email, Оновити стан (поки Checkbox ще не дав DONE).

Для ШІ: `checkbox_receipt_return(receipt_id)`, `checkbox_receipt_pdf(receipt_id, fmt=pdf|png)`, `checkbox_receipt_email(receipt_id, values={emails:[…]})`, `checkbox_receipt_refresh(receipt_id)`, `checkbox_receipts_list(q, kind, status, profile_id, date_from, date_to)`.

## Автоматичний чек (тригер)

«Налаштування → Тригери» має дію **«Фіскальний чек Checkbox»** поряд із Webhook: таблиця «Угоди» (або «Доставка»), умова, наприклад `stage.name == 'Отримано'`, і чек створюється сам, коли умова стала істинною — без людини. Каса — за юрособою угоди (або вказана в тригері), оплата — з поля угоди, зміна відкривається сама, якщо в профілі ввімкнено «Автоматичний чек відкриває зміну». Швидкий шлях — «Інтеграції → Checkbox → Автоматичний чек → Увімкнути чек при «Отримано»». Етап «Отримано» угода отримує від перевізника за «Пов'язаними статусами» в налаштуваннях Нової Пошти / Укрпошти / Meest.

Результат кожного спрацювання — у журналі тригера і нотаткою в угоді: «створено» (з номером чека), «пропущено» (чек уже є, угоду вже фіскалізовано в KeepinCRM, нема позицій) або «не створено» (нема типу оплати, каси, зміни, помилка Checkbox).

**Тригери «Отримано» і «Скасовано» в усіх воронках (15.10).** У «Налаштування → Тригери» стоять чотири тригери таблиці «Угоди», «Відразу». Кожен діє в усіх воронках одразу:
- «Чек Checkbox: замовлення отримано» — умова `stage.name == 'Отримано'`, «Автоматично відкривати зміну, якщо вона закрита». Діє і для угод, що прийшли з KeepinCRM та ще були в дорозі на 14.10. Якщо KeepinCRM уже пробила чек (у списку угод знак «C»), другий не створюється.
- «Завершити угоду: замовлення отримано» — «Завершити угоду» → «Виграно».
- «Завершити угоду: угоду скасовано» — умова `stage.role == 'lost'` (етап скасування будь-якої воронки) → «Програно».
- «Повернути чек: угоду скасовано» — умова `stage.role == 'lost' OR result == 'failed'` → «Повернути фіскалізований чек». Діє, лише якщо в угоді є чинний чек нашої каси; чек KeepinCRM повертають у KeepinCRM.

Тригери діють на нові переходи етапів: угоди, що вже стоять на «Отримано» чи скасовані, не чіпаються.

## Поля чека

`id`, `deal_id`, `kind` (sell / return), `status` (CREATED / DONE / ERROR / CANCELLED), `fiscal_code`, `fiscal_date`, `tax_url`, `total_amount`, `payment_type` (CASH / CASHLESS), `payment_label`, `payment_value`, `profile_name` (каса), `cashier_name`, `emails`, `item_ids`, `related_id` (у повернення — чек продажу), `returned_at` (у продажу — коли повернуто), `error`, `creator`, `created_at`.

## Контроль чеків

«Фінанси → Фіскальні чеки → Контроль» відповідає на питання власника «чи на всі угоди виписано чек»: за період і каналом — скільки отриманих угод потребують чека, у скількох він є (нашої каси чи ще KeepinCRM), скільки без чека і чому (автоматичний чек вимкнено, етап не в умові тригера, отримано до запуску тригера, помилка тригера чи Checkbox, чек повернено), скасовані з неповерненим чеком, кілька чеків на угоду, сума чеків проти виручки. «Виписати» звідти — той самий чек, що «+ → Фіскальний чек» у картці угоди. Тривога в «Фінанси → Огляд» щодня показує «N угод потребують уваги». Докладно — [Фінанси → Фіскальні чеки](finance.md#фіскальні-чеки); для ШІ — `checkbox_control`, `checkbox_control_issue`.


---

# Документи

Документи — рахунки, видаткові накладні, акти, договори та будь-які інші бланки, які створюються з угоди за шаблоном одним натиском. Шаблон підставляє дані клієнта, угоди, товарів і компанії через змінні `{{…}}`; створений документ має номер, статус (лише для зручності), PDF і друк, а в картці угоди — блок «Документи» з усіма документами угоди.

## Можливості
- Шаблони рахунку, накладної, акта або з порожнього аркуша; порядок шаблонів у меню угоди — перетягуванням.
- Три режими вмісту: «Візуальний» (як Word), «Конструктор» (блоки готового бланка), «HTML».
- Змінні кнопками: угода, клієнт, контакт угоди, компанія (реквізити, підписант, підпис і печатка), таблиця товарів, документи.
- Автоматична нумерація за шаблоном з лічильником, роком, місяцем, кодом компанії; або номер вручну.
- Шаблон доступний усім компаніям (філіям) або лише вибраним.
- Статуси з кольорами; PDF, друк, перезбирання з поточних даних угоди.
- Право редагувати створені документи окремою галочкою доступу.
- Імпорт і експорт документів XLSX; шаблон у файл і з файлу; масові дії.
- «Створити на основі», як у 1С: накладна й акт з рахунку, рахунок з договору — гілкою під підставою.
- Договори з контрагентом у картці клієнта; рядок «Договір:» у рахунках — сам договір.
- Правка документа прямо на аркуші, як у Word (без HTML): лише цей документ, шаблон не змінюється; номер можна змінити олівцем.
- Свій документ файлом (Word, Excel, PDF, фото…) — у нашому форматі: аркуш, номер, статус, PDF, правка.

## 1. Налаштування: шаблони і статуси
Шаблон — заготовка документа (рахунок, накладна, акт, договір), з якої документ збирається з даних угоди одним натиском. Статуси — ваші кроки документа, як етапи в угоді: так видно, що вже надіслано чи підписано.

Шаблони й статуси налаштовуються в «Налаштування → Документи → Шаблони і статуси» (те саме — вкладка «Шаблони і статуси» в розділі «Документи»).

1. Порядок шаблонів (так вони йдуть у меню угоди) змінюйте перетягуванням.
2. Новий шаблон — «+ Шаблон»: назва і з чого почати (порожній аркуш або готовий рахунок / накладна / акт), далі відкриється редактор.
3. «⋯» у рядку шаблону: «Копія», «Зберегти у файл», «В архів» або «Видалити», для архівного — «Повернути з архіву». Шаблон, за яким уже є документи, не видаляється, а йде в архів (документи лишаються; «⋯ над таблицею → Показати архівні»). Шаблон і статус без документів видаляються назовсім — стартові («Рахунок-фактура», «Видаткова накладна», «Акт виконаних робіт», статуси «Відправлений» тощо) теж: їх створено один раз для нової компанії, і видалені не повертаються.
4. Статуси — таблиця нижче: назва, колір, ID для API, скільки документів. Статус, який використовують документи, не видаляється, доки ви не зміните їм статус.

Доступи — у «Налаштування → Розділи меню» (або в картці людини в «Користувачі»): «Документи» (сам розділ) і «Документи: редагування створених» (хто може правити вміст створеного документа).

3`).

## 2. Редактор шаблону
- **Назва** і **Компанії** (філії), для яких шаблон доступний: порожньо — для всіх.
- **Орієнтація**: «Портрет» або «Альбом».
- **Дозволити редагувати вміст документа після його створення**: без галочки створений документ можна лише перезібрати з шаблону, а не правити вручну.
- **Вміст** у трьох режимах: «Візуальний» (абзаци, заголовки, жирний, курсив, колір, вирівнювання, списки, посилання, картинки, таблиці, «Таблиця товарів» з колонками й ПДВ), «Конструктор» (шапка, сторони, товари, підсумки, підписи) і «HTML».
- **Змінні** вставляються кнопками груп: «Системні змінні» (дата, курси валют), «Змінні по угоді» (сума, знижки, кількість товарів, ТТН…), «Змінні по клієнту» (будь-яке поле клієнта і контакт угоди: `{{contact.name}}`, `{{contact.phone}}`…), «Змінні по підряднику» (реквізити компанії, підписант, підпис і печатка), «Змінні по товарах» (таблиця товарів і її колонки), «Змінні по документах» (номер, хто створив, номер іншого документа угоди).
- **Інший документ угоди** (група «Інші документи угоди»): `{{doc_ref.<шаблон>}}` — назва, № і дата цілком («Рахунок на оплату
  № 59 від 16.10.2026»), `{{doc_number.<шаблон>}}` — лише номер, `{{doc_date.<шаблон>}}` — лише дата; береться останній документ
  цього шаблону в угоді, нема — порожньо. Так у видатковій накладній «Підстава:» — рахунок цієї угоди: у стартовій накладній
  порожня підстава заповнена `{{doc_ref.<рахунок>}}` один раз (свою підставу людини не чіпаємо). Змінити — поле «Підстава»
  блоку «Сторони» в редакторі шаблону. Накладну, створену раніше за рахунок чи до цієї зміни, — «⋮ → Перезібрати з угоди».
- Логотип шаблону — до 2 МБ, PNG, JPG або SVG.
- «Зберегти» — липка кнопка внизу.

## 3. Нумерація
- «Увімкнути автоматичну нумерацію документів»: номер складається за «Шаблон нумерації» з кнопок «Лічильник» (`{n}`, у KeepinCRM — `{{counter}}`), «Рік» (`{yyyy}`), «Місяць» (`{mm}`), «День» (`{dd}`), «Код компанії» (`{company}`, у кожної компанії свій лічильник).
- «Початок нумерації» — останній уже виданий номер: 58 → наступний 59. «Мін. довжина» 5 → 00059. Редактор показує наступний номер. «Очистити нумерацію» скидає лічильник.
- Нумерацію вимкнено — номер пишуть руками при створенні документа; дубль номера в тому самому шаблоні не пропускається.

## 4. Створити документ з угоди
1. Відкрийте угоду → блок «Документи» → «+».
2. Виберіть шаблон (у меню лише шаблони, доступні компанії угоди). Документ створюється одразу з даними угоди. Якщо в шаблоні ручна нумерація — спершу Helomi попросить номер.
3. «Більше параметрів…» відкриває шторку: компанія, статус, номер, який буде, і перегляд перед створенням.
4. Документ відкривається у вікні поверх угоди («←» або Esc — закрити).

## 4а. Створити на основі (накладна з рахунку, рахунок з договору)
Як «Ввести на основі» в 1С: новий документ бере угоду, клієнта, компанію і юрособу з документа-підстави, а в «Підставі» стоїть саме цей документ — «Рахунок на оплату № 59 від 16.10.2026» (навіть якщо в угоді вже є новіший рахунок).
1. Угода → блок «Документи» → «⋮» рахунку → «Створити на основі…» (або кнопка «Створити на основі…» у вікні документа).
2. Першими — шаблони, налаштовані для цього документа (рахунок → «Видаткова накладна», «Акт виконаних робіт»); решта — під
   «Інші шаблони». Клік — документ створено; за ручної нумерації спершу Helomi попросить номер.
3. Похідний документ стоїть у блоці угоди **гілкою** під підставою (пунктир і крапка, як дерево «Структури»). У вікні документа —
   «На основі: …» і «Створено на основі: …» з посиланнями.
4. Що з чого створюється — «Шаблони і статуси» → шаблон → **«Створюється на основі»** (кружечки шаблонів-підстав). Типово:
   накладна й акт ← рахунок, рахунок ← договір. Зняли всі — шаблон усе одно можна вибрати під «Інші шаблони».
5. Змінні підстави: `{{base.ref}}` (цілком), `{{base.title}}`, `{{base.number}}`, `{{base.date}}`; `{{doc_ref.<шаблон>}}` у
   документі на основі показує саме підставу. Перезбирання з угоди підставу не змінює; видалили підставу — похідний лишається.

## 4б. Договори з контрагентом
1. Шаблон договору — «Шаблони і статуси» → шаблон → **«Вид: Договір з контрагентом»** (пігулка «договір» у таблиці).
   Стартовий — «Договір поставки» (візуальний; змініть текст під себе).
2. Картка клієнта → блок **«Договори»** → «+» — договір з цим клієнтом (без угоди). «⋮»: переглянути, редагувати, друк, PDF.
3. **Рахунок за договором** — кружечок «+» у рядку договору (або «⋮ → Створити рахунок за договором…») → угода клієнта (товари й
   сума — з неї) → «Рахунок на оплату». Рахунок стоїть гілкою під договором, накладна на основі рахунку — гілкою під рахунком.
4. Рядок **«Договір:»** у рахунку — `{{contract.ref}}`: договір по ланцюжку підстав (рахунок за договором, накладна на основі
   рахунку), інакше останній договір клієнта, а якщо договорів нема — «Основний договір», як раніше. Змінні: `{{contract.ref}}`,
   `{{contract.title}}`, `{{contract.number}}`, `{{contract.date}}`.

## 4в. Свій документ файлом
Документ, зроблений не в Helomi (договір від клієнта, специфікація в Excel, скан акта), стає документом угоди **у нашому форматі**: аркуш A4, номер, статус, журнал, PDF і друк, правка на аркуші — як у документа з шаблону.
1. Угода → блок «Документи» → «+» → **«Завантажити свій документ…»** → виберіть файл.
2. Можна: Word (.docx), Excel (.xlsx), PDF, LibreOffice / Google Docs (.odt), HTML, текст (.txt, .csv), картинка (PNG, JPG).
   Старий .doc, .xls і .rtf не читаються — збережіть файл як .docx, .xlsx або PDF.
3. Що переноситься: абзаци, заголовки, жирний / курсив / підкреслений, розмір і колір тексту, вирівнювання, списки, таблиці
   (з об'єднаними комірками), картинки; Excel — кожен аркуш таблицею; PDF — текст сторінок (скан без тексту — сторінки
   картинками). Колонтитули Word і примітки не переносяться.
4. Назва — ім'я файлу, номер — з імені після «№» («Договір № 12 з Буковелем.docx» → «Договір з Буковелем № 12»), інакше «б/н».
   Назву й номер можна змінити олівцем у правій панелі.
5. Оригінал файлу зберігається: права панель → «Файл» або «⋯ → Оригінал файлу». «Перестворити з шаблону» в такого документа
   нема — шаблону в нього немає.

## 5. Створити документ у розділі «Документи»
1. «Документи» → «+ Документ».
2. Виберіть шаблон і угоду (або клієнта, якщо документ без угоди), компанію, статус; за ручної нумерації — номер.
3. Створіть. Документ з'явиться в списку і в блоці «Документи» угоди.

## 6. Статус, PDF, друк, правка, перезбирання
- **Статус** вибирається прямо в пігулці рядка — у списку й у блоці угоди. Зміна пишеться в журнал угоди.
- **PDF** і **Друк** — кнопки в рядку документа.
- Вікно документа: ліворуч аркуш, праворуч панель — чорна **«Редагувати»**, кружечки PDF і Друк, «⋯» (на весь екран,
  «Перестворити з шаблону», оригінал файлу, «Відкрити в «Документах»», «Видалити»), **«Створити на основі…»**; нижче — статус,
  номер (олівець — змінити), шаблон або назва, клієнт, угода, підстава, сума, компанія, хто й коли створив, журнал.
- «⋯» документа в угоді: «Переглянути», «Редагувати», «Перезібрати з угоди», «Завантажити PDF», «Відкрити в «Документах»», «Видалити».
- «Перезібрати з угоди» збирає документ заново з шаблону на поточних даних угоди; ручні правки зникають. Відредагований вручну документ позначено «відредаговано».

## 6а. Правка на аркуші і зміна номера
**Правка змінює лише цей документ** — шаблон («Рахунок на оплату» тощо) і інші документи не змінюються. Повернути як було — «⋯ → Перестворити з шаблону».
1. Вікно документа → **«Редагувати»** (або «⋯» документа в угоді → «Редагувати»).
2. Клацніть у текст на аркуші — пишіть, стирайте, вставляйте, як у Word. Над аркушем: «Скасувати» / «Повторити»
   (Ctrl+Z / Ctrl+Y), «Ж» — жирний, **«Рядки»** — рядок вище / нижче, видалити рядок, колонку (курсор має стояти в таблиці;
   те саме — правою кнопкою по комірці), «Очистити форматування». У візуальних документах і своїх файлах ще курсив,
   підкреслення, розмір, вирівнювання, списки. У бланку рахунку чи накладної ці кнопки сховано: його PDF малює лише жирний.
3. **«Зберегти»** (або Ctrl+S). Документ отримує позначку «відредаговано», PDF збирається заново з правками.
   «Скасувати» з незбереженими правками спершу перепитає.
4. **Номер** — права панель → «Номер» → олівець → новий номер → Enter. Новий номер стає в тексті документа там, де стояв
   «№ старий», і в документах, що на нього посилаються («Підстава: Рахунок на оплату № 60 від …» у накладній). Такий
   самий номер у цьому шаблоні вже є — Helomi не дасть. Наступний документ шаблону з нумерацією `{n}` отримає
   номер, більший за найбільший виданий (змінили 59 на 100 — наступний 101).
5. Хто може: потрібна галочка шаблону «Дозволити редагувати» і право «Документи: редагування створених». Без них кнопки
   «Редагувати» й олівця номера нема, а панель пише чому.

**Реквізити покупця** в рахунку (`{{client.requisites_short}}`): «Код за ЄДРПОУ/ІПН» — з поля клієнта «Код ЄДРПОУ» (число без «.0»), «Адреса» — **лише** з поля «Юридична адреса». «Адреса доставки» і коментарі для кур'єра в рахунок не потрапляють; порожня «Юридична адреса» — рядка «Адреса» нема. Уже створений документ змінюється лише після «Перестворити з шаблону» або правки на аркуші.

## 7. Список, фільтри і масові дії
Номер документа, клієнт і угода в рядку — справжні посилання: клік відкриває тут, Ctrl/⌘-клік, середня кнопка або «Відкрити в новій вкладці» з правого меню — у новій вкладці (20.10).
1. «Документи» → вкладка «Документи»: номер, назва, клієнт, угода, компанія, статус, сума, хто створив, дата.
2. Фільтри: пошук і «Знайти», «усі шаблони», «усі статуси», «усі компанії», дати «з … по …»; збережені фільтри — як в угодах.
3. Позначте документи галочками — з'явиться панель «Вибрано: N»: «Експорт», «Статус…» (статус усім вибраним або «без статусу»), «Видалити», «Зняти вибір».

На телефоні рядки стають картками з кнопками PDF, друку й видалення, а фільтри — за кнопкою «Фільтри».

## 8. Імпорт і експорт, шаблон у файл
- «⋯ → Імпорт документів»: шаблон файлу, файл, як шукати існуючі (не шукати / за ID / за шаблоном і номером), «Перевірити», «Імпортувати», файл помилок.
- «⋯ → Експорт документів»: усі, за фільтром або вибрані галочками, з вибором полів. Файл експорту (з колонкою «ID») імпортується назад; колонки «Клієнт», «Угода», «Хто створив» — лише для читання, при імпорті пропускаються.
- «Шукати за ID» потребує колонки «ID», «за шаблоном і номером» — колонок «Шаблон» і «Номер»; без них імпорт одразу скаже, чого бракує (а не створить дублі).
- Шаблон документа: «⋯» у рядку шаблону → «Зберегти у файл» (.json); в іншій компанії Helomi — «⋯» над таблицею → «Завантажити шаблон з файлу».
- «⋯ → Інструкція» відкриває цю статтю, «⋯ → Вхід для ШІ» — що бачить ШІ в розділі.

## Можливі помилки
| Що ви бачите | Чому | Що зробити |
| --- | --- | --- |
| «Шаблон «…» доступний лише для: …» | Компанія угоди не серед компаній шаблону | Виберіть інший шаблон або додайте компанію в шаблон |
| «Вкажіть номер документа: у шаблоні «…» вимкнено автоматичну нумерацію» | Ручна нумерація | Впишіть номер |
| «Документ «…» № … уже є — вкажіть інший номер» | Номер зайнятий | Змініть номер |
| «Вкажіть угоду або клієнта» | Документ ні до чого не прив'язаний | Виберіть угоду або клієнта |
| «Шаблон в архіві — оберіть інший» | Шаблон прибрано в архів | Поверніть шаблон з архіву або візьміть інший |
| «Шаблон документа видалено — перезібрати нема з чого» | Шаблон документа видалено | Створіть документ за іншим шаблоном |
| «Документ завантажено файлом — шаблону нема, перезібрати нема з чого» | Свій документ файлом | Правте на аркуші або завантажте файл ще раз |
| «… не читається — збережіть файл як .docx, .xlsx або PDF» | Старий формат Word / Excel / RTF | Збережіть у новому форматі й завантажте |
| «Формат «…» не підтримується» | Файл не документ | Word, Excel, PDF, .odt, HTML, текст, картинка |
| «Файл .docx пошкоджений або це не Word» | Файл зіпсований або перейменований | Відкрийте у Word і збережіть ще раз |
| «Номер не може бути порожнім» | Олівцем номера стерли все | Впишіть номер |
| «Номер змінено …; у тексті документа старого номера не знайшлося» | У тексті номер стоїть не після «№» | Поправте номер на аркуші вручну |
| «Статус використовують … документ(ів) — спершу змініть їх статус» | Статус зайнятий | Змініть статус документам, потім видаляйте |
| «Файл не схожий на шаблон Helomi …» | Завантажено не той файл | Візьміть .json, збережений через «Зберегти у файл» |
| Немає «Редагувати» | Шаблон забороняє правку або не відкрито «Документи: редагування створених» | Перезберіть з угоди або попросіть доступ |

## Для ШІ-співробітників
Ключ розділу — `documents` (`describe_section("documents")`: шаблон, угода, клієнт, компанія, номер, статус, сума). Потрібен доступ «Документи».

| Інструмент | Що робить |
| --- | --- |
| `documents_list` | Пошук `q` (номер, клієнт, назва угоди), фільтри `template_id`, `status_id`, `deal_id`, `client_id`, `office`, `date_from`, `date_to`; `kind=contract` — лише договори |
| `documents_get` | Документ: номер, шаблон, статус, угода, вміст (HTML), журнал |
| `documents_refs` | Шаблони з компаніями й прапорцем `auto_number`, статуси, компанії |
| `documents_create` | Створити: `values` з `template_id`, `deal_id` (або `client_id`), за потреби `company`, `status_id`; якщо `auto_number = false` — обов'язково `number`; `base_id` — «на основі» документа (угода, клієнт, компанія — з нього; рахунок за договором — ще й `deal_id`). Передавайте `idempotency_key` |
| `documents_update` | Змінити документ, як людина на аркуші (лише цей документ, шаблон не змінюється): `values.html` — весь вміст (взяти з `documents_get`, поправити текст, зберегти; скрипти й обробники вирізаються, стилі бланка лишаються); `values.number` — новий номер (підставиться в тексті замість «№ старий» і в документах, що посилаються; дубль у шаблоні — помилка); `values.title` — назва документа без шаблону; `total_amount`, `office` |
| `documents_upload` | Свій документ файлом: `values` з `filename`, `content_b64` (до 15 МБ), `deal_id` або `client_id`, за потреби `number`, `title`, `company`, `status_id`. Word .docx, Excel .xlsx, PDF, .odt, .html, .txt, .csv, картинка → аркуш у нашому форматі; оригінал зберігається (`source`) |
| `documents_set_status` | Змінити статус (`status_id` з `documents_refs`) |
| `documents_rerender` | Перезібрати з шаблону на поточних даних угоди (ручні правки зникають) |
| `documents_pdf` | PDF: адреса файлу `/uploads/…`, щоб надіслати клієнту |
| `documents_delete` | Видалити документ. **Спочатку запитати** (вид `delete`) |

**Шаблони й статуси** (те саме, що сторінка «Шаблони і статуси»; доступ той самий — «Документи»):

| Інструмент | Що робить |
| --- | --- |
| `doc_templates_list` | Шаблони: `mode` (`blocks` — конструктор, `visual` — візуальний, `html`), нумерація, компанії; `archived=true` — архів |
| `doc_templates_get` | Шаблон цілком: `blocks` або `html`, `number_format`, `number_start`, `auto_number`, `companies`, `allow_edit`, `logo_path` |
| `doc_templates_variables` | Змінні `{{…}}` з групами — ставити лише їх |
| `doc_templates_default_blocks` | `kind=invoice / waybill / act`: стартові блоки, типи блоків, колонки таблиці товарів |
| `doc_templates_preview` | Перевірити ще не збережений шаблон: `values` з `blocks` або `html`, `deal_id` (справжня угода) або без нього (зразок); `brief=true` — лише html |
| `doc_templates_preview_pdf` | PDF-зразок того самого — адреса `/uploads/…`, щоб людина подивилась до збереження |
| `doc_templates_create` | Новий шаблон: `name`, `blocks` або `html`, `number_format` (`{n}`, `{yyyy}`, `{company}`, `{n:04}`), `number_start`, `auto_number`, `companies`, `orientation` |
| `doc_templates_update` | Змінити будь-що з того самого; `archived=true` — в архів |
| `doc_templates_copy` | Копія — перед великими змінами чужого шаблону |
| `doc_templates_reorder` | Порядок: `values={ids: […]}` |
| `doc_templates_next_number` | Яким буде наступний номер (для `company`) |
| `doc_templates_reset_numbering` | «Очистити нумерацію». **Спочатку запитати** (вид `bulk`) |
| `doc_templates_export` / `doc_templates_import` | Шаблон у файл (JSON base64) і з файлу — перенести між компаніями |
| `doc_templates_image` | Картинка (png/jpeg/gif/webp до 2 МБ, base64) → `/uploads/…` для `<img src>` у візуальному шаблоні |
| `doc_templates_logo` / `doc_templates_logo_delete` | Лого шаблону для `{{company.logo}}` |
| `doc_templates_delete` | Видалити (з документами — в архів). **Спочатку запитати** (вид `delete`) |
| `doc_statuses_list` / `doc_statuses_create` / `doc_statuses_update` / `doc_statuses_reorder` | Статуси: назва, колір (з палітри), порядок |
| `doc_statuses_delete` | Видалити статус без документів. **Спочатку запитати** (вид `delete`) |

**Як зібрати шаблон за зразком людини** (фото, скан, PDF, Word або опис словами):
1. Звірити, що є: `doc_templates_list` (може, досить змінити наявний — тоді `doc_templates_copy` і правити копію).
2. Рахунок, накладна, акт — **конструктор**: `doc_templates_default_blocks kind=…` і змінити блоки під зразок. Блоки:
   `header` (`title`, `subtitle`, `logo`, `size: large`; рядок «<title> № {{number}} від {{date}}»), `text` (`html`, `size: small`,
   `align: center|right`, `variant: notice`), `parties` (`supplier_label`, `buyer_label`, `requisites`, `buyer_details: short`,
   `basis_label`, `basis_value`), `payment_order` (`title`), `table_items` (`columns` з `item_columns`, `titles` — свої назви
   колонок, `vat`), `totals` (`label`, `vat`, `words`, `count_line`), `signature` (`left_title`, `left_name`, `right_title`,
   `right_name`, `variant: inline`, `sign_image` / `stamp`: `left|right`), `divider`. Відступ над блоком — `space_before` (мм).
3. Договір, лист, довіреність — **візуальний шаблон**: `html` абзацами `<p>`, заголовками `<h1>…<h4>`, `<b>`, `<i>`, `<u>`,
   списками, таблицями `<table>`, `<img src="/uploads/…">`, вирівнювання `style="text-align: center"`. Змінні — текстом
   `{{client.company}}`, таблиця товарів — `{{deal.items.n.title.qty.price.total}}`. Скрипти, обробники `on…`, `iframe`, `style`
   прибираються самі: HTML від ШІ завжди зберігається як візуальний шаблон.
4. Дані, що змінюються (реквізити, клієнт, суми, номер, дата), — лише змінними з `doc_templates_variables`, не текстом зі зразка.
   Реквізити постачальника — `{{company.requisites}}`, `{{company.name}}`; рахунок цієї угоди — `{{doc_ref.<id рахунку>}}`.
5. Перевірити: `doc_templates_preview brief=true` на справжній угоді (`deal_id`) і `doc_templates_preview_pdf` — дати людині адресу
   PDF; лише після «так» — `doc_templates_create` (або `doc_templates_update`).
6. Нумерація — як скаже людина: `number_format` і `number_start` («Почати з» = останній номер у старій програмі).

Зразок можна дати в чаті ШІ-співробітника кнопкою-скріпкою (фото, скан, PDF) або у своєму чаті (Claude, ChatGPT…), підключеному через MCP чи «Файл сесії».

Чого не робити:
- Не вигадувати id шаблонів і статусів — брати з `documents_refs` / `doc_templates_list`.
- Не створювати документ за шаблоном, недоступним для компанії угоди (`companies` шаблону) — прийде помилка.
- Не переписувати чужий шаблон без прохання — краще копія; не видаляти документи й шаблони без прямого прохання людини.
- Не вписувати в шаблон реквізити, суми й імена зі зразка текстом — лише змінні.

## Додаткова інформація
- Пов'язані статті: [Угоди](deals.md) (блок «Документи»), [Клієнти](clients.md), [Імпорт і експорт](import-export.md); реквізити постачальника, підпис і печатка — «Налаштування → Бренди та юрособи».