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

# ШІ Богдан — закупівлі: партії, собівартість, склад і прихід

Богдан — ШІ-співробітник закупівель. Його робоче місце — розділ «Закупівлі»: він розбирає Excel-замовлення постачальника, рахує собівартість кожної штуки (доставка за вагою, товар за курсом, документи відсотком), стежить за партіями в дорозі й боргами перевізнику та постачальнику, заводить нові товари на склад Helomi і робить прихід партії. Усі дані — лише з вашої CRM (KeepinCRM більше не потрібна); налаштування — у його пульті, керувати ним можуть люди й інші ШІ (Ломі).

## Можливості
- «Огляд»: скільки товару в дорозі (на суму), скільки ще винні по частинах, які партії запізнюються, які прибули без приходу.
- Черга «що зробити» з переходом просто в закупівлю; найближчі прибуття.
- Розрахунок собівартості на сторінці закупівлі за формулою Богдана, типові курси — з його налаштувань.
- Нові товари партії — на склад Helomi (назва й одиниця — за налаштуваннями), прихід — на обраний склад.
- Спільна таблиця Колі: нові товари, кількості й ціни з Excel-файлу чи партії.
- Ним керують інші ШІ інструментами `ai_bogdan_*`; запис на склад за дорученням — через кошик підтверджень.

## 1. Налаштування
Богдан з'являється в «Інтеграції → ШІ» як картка «Богдан» (вид «Програма») і в «Налаштування → Команда → ШІ-співробітники». «Відкрити» веде в його вікно — «Закупівлі»; кружечок «Налаштування» праворуч угорі вікна — його налаштування, вкладка «Налаштування»:
| поле | що означає | типово |
| --- | --- | --- |
| Заводити товари й прихід на склад за дорученням інших ШІ | без галочки Богдан лише показує стан; товари й прихід робить людина на сторінці «Закупівлі» | так |
| Типовий курс доставки, грн/$ | підставляється в нову закупівлю (у закупівлі можна змінити) | 44 |
| Типовий курс закупки, грн/$ | те саме для ціни товару | 44 |
| Типовий курс юаня, грн/¥ | якщо більше 0 — у таблиці собівартості ще й ціна в юанях | 0 (не показувати) |
| Не вважати боргом залишок до, грн | хвіст від курсу чи комісії банку: частина з таким залишком вважається сплаченою | 10 |
| Позначати партію «запізнюється» через скільки днів після дати прибуття | 0 — одразу наступного дня після приблизної дати | 0 |
| Одиниця нового товару на складі | одиниця товарів, які Богдан заводить з партії | шт. |
| Назва нового товару | шаблон: `{title}` — назва з файлу, `{sku}` — артикул | `{title} ({sku})` |
| Адреса спільної таблиці товарів | catalog-service таблиці Колі; порожньо — сервер організації №1 | — |
Змінене діє одразу, без перезапуску.

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

## 3. Пульт: огляд і «Перевірити партії»
Пульт відкривається з плитки, з картки «Богдан» у «Структурі» («Відкрити») або на сторінці «Закупівлі» (посилання «ШІ Богдан» у шапці, «⋮» → «Пульт ШІ Богдана»). Вкладка «Огляд»:
- **KPI**: «У дорозі» (сума партій «замовлено» й «в дорозі»), «Ще винні» (перевізнику · постачальнику · за документи),
  «Запізнюються», «Прибули без приходу».
- **Що зробити** — партії, що запізнюються (дата прибуття минула), прибули без приходу на склад, і з боргом. «Відкрити» —
  закупівля на сторінці «Закупівлі».
- **Найближчі прибуття** — партії в дорозі з датою прибуття попереду.
- **«Перевірити партії»** — крок Богдана: перераховує чергу й пише підсумок у «Журнал» пульта («Перевірено партій: N ·
  запізнюються … · без приходу … · з боргом …»). Окремого фонового циклу нема: огляд і так рахується наживо.
Вікно Богдана — сторінка «Закупівлі» (`/crm/procurement`, «Відкрити» на картці); ці KPI й черги — у вікні `/crm/ai/bogdan` («Огляд» налаштувань → «Черги й KPI агента»). Налаштування — кружечок «Налаштування»: вкладки «Налаштування» (з «Доступами й лімітами» внизу), «API», «Огляд», «Журнал».

## 4. Що Богдан робить на складі
За дорученням людини (сторінка «Закупівлі», «⋮» картки) чи іншого ШІ:
1. **Нові товари на склад** — звіряє артикули партії з вашим складом, заводить відсутні з залишком 0, собівартістю з розрахунку
   й ціною продажу. У журналі закупівлі — «ШІ Богдан · за дорученням …», якщо доручав ШІ.
2. **Прихід на склад** — кількість партії на обраний склад (головний — типово), ціна за штуку = собівартість. Повторний прихід
   зробить дубль: позначка «· зроблено» на картці саме для цього.
Гроші Богдан не рухає: оплати партій проводить людина (або ШІ через кошик «Платежі») — див. статтю [Закупівлі](procurement.md).

## 5. Що змінилось після перенесення
- Сторінка «Закупівлі» переїхала на `/crm/procurement` у стилі Helomi; стара адреса веде туди ж. Функції ті самі.
- Склад, прихід, назви товарів — лише ваша CRM; звернень до KeepinCRM нема. Кнопку «Прайс CRM: шт + Checkbox» прибрано.
- Те, що було константами (курси нової закупівлі, допуск хвоста оплати, одиниця й назва нового товару, адреса спільної таблиці),
  — у налаштуваннях вище.
- У кожної закупівлі — «Журнал змін»: хто що змінив (люди й ШІ), склад, прихід, таблиця Колі.
- Файли закупівель кожної організації — у її теці. Стара програма `/apps/bogdan/` більше ніде не відкривається.

## Можливі помилки
| Як показується | Чому | Що зробити |
| --- | --- | --- |
| «Богдана як ШІ-співробітника ще нема…» (404) | Богдана не додано з каталогу | «Інтеграції → ШІ → Додати → Богдан» |
| «Немає доступу до пульта Богдана…» (403) | Нема доступу «Закупівлі» чи «ШІ Богдан» | Попросіть адміністратора («Доступи») |
| «Богдана вимкнено — увімкніть в «Інтеграції → ШІ»» (409) | Доручення чи крок у вимкненого Богдана | Увімкнути перемикачем |
| «У Богдана вимкнено «Заводити товари й прихід…»» (409) | ШІ доручає склад, а галочку знято | Увімкнути в «Налаштуваннях» або зробити на сторінці «Закупівлі» |
| «Змінювати налаштування Богдана може адміністратор…» (403) | Налаштування міняє не той, хто його підключив | Попросіть адміністратора |
| «Адресу спільної таблиці не налаштовано…» (409) | Порожня адреса таблиці Колі на сервері не організації №1 | «Налаштування» → «Спільна таблиця Колі» |
| «kind — overdue, supply або debt» (400) | Невідомий вид черги | Один із трьох |

## Для ШІ-співробітників
Ключ розділу в каталозі — `ai-bogdan` (`GET /api/ai/sections/ai-bogdan`); доступ — галочка «ШІ Богдан (закупівлі: партії, склад, прихід)» у «Доступах» (Ломі має її типово). Самі закупівлі — розділ `procurement` (`purchases_*`, `purchase_*`).
- `ai_bogdan_status` — стан, налаштування, чи задана спільна таблиця.
- `ai_bogdan_summary` — огляд: партії за станами, у дорозі на суму, борги по частинах, черга, найближчі прибуття.
- `ai_bogdan_queue` (kind: overdue | supply | debt) — черга «що зробити».
- `ai_bogdan_run_step` — крок зараз (підсумок — у журнал пульта).
- `ai_bogdan_warehouse_check` (purchase_id, friends) — кого з партії немає на складі.
- `ai_bogdan_warehouse_add` (purchase_id, values: items?, friends) і `ai_bogdan_supply` (purchase_id, values: warehouse_id?,
  friends) — доручення складу через кошик «Масові дії»; Богдан має бути увімкнений і з галочкою «Заводити товари й прихід…».
- `ai_bogdan_settings_save`, `ai_bogdan_enabled` — через кошик «Керування іншими ШІ».
Не вигадуйте id закупівель і складів — беріть з `ai_bogdan_queue`, `purchases_list`, `purchase_supply_refs`; не робіть прихід партії вдруге.

## Додаткова інформація
Пов'язане: [Закупівлі](procurement.md), [Фінанси](finance.md), [Склад: накладні](warehouse-docs.md), [ШІ-співробітники](ai-employees.md), [Ломі](kamila.md).