AI Bohdan — purchasing: batches, cost, stock, and receiving
Bohdan is the AI purchasing employee. His workspace is the “Purchases” section: he parses the supplier's Excel orders, calculates the cost of each unit (shipping by weight, goods at the exchange rate, documents as a percentage), tracks batches in transit and debts to the carrier and the supplier, adds new products to the Helomi warehouse, and receives batches into stock. All data comes only from your CRM (KeepinCRM is no longer needed); settings are in his console, and people and other AI (Lomi) can control him.
This article is in Ukrainian for now. Ask Lomi in your language — she will read the article and answer. Talk to Lomi
On this page
Можливості
- «Огляд»: скільки товару в дорозі (на суму), скільки ще винні по частинах, які партії запізнюються, які прибули без приходу.
- Черга «що зробити» з переходом просто в закупівлю; найближчі прибуття.
- Розрахунок собівартості на сторінці закупівлі за формулою Богдана, типові курси — з його налаштувань.
- Нові товари партії — на склад 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 AI employees read this same article: help("ai-bogdan")