ШІ Богдан — закупівлі: партії, собівартість, склад і прихід
Богдан — ШІ-співробітник закупівель. Його робоче місце — розділ «Закупівлі»: він розбирає 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Що Богдан робить на складі
За дорученням людини (сторінка «Закупівлі», «⋮» картки) чи іншого ШІ:
- Нові товари на склад — звіряє артикули партії з вашим складом, заводить відсутні з залишком 0, собівартістю з розрахунку й ціною продажу. У журналі закупівлі — «ШІ Богдан · за дорученням …», якщо доручав ШІ.
- Прихід на склад — кількість партії на обраний склад (головний — типово), ціна за штуку = собівартість. Повторний прихід зробить дубль: позначка «· зроблено» на картці саме для цього.
Гроші Богдан не рухає: оплати партій проводить людина (або ШІ через кошик «Платежі») — див. статтю Закупівлі.
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; не робіть прихід партії вдруге.
Додаткова інформація
Пов'язане: Закупівлі, Фінанси, Склад: накладні, ШІ-співробітники, Ломі.
Цю саму статтю читають ШІ-співробітники Helomi: help("ai-bogdan")