Warehouse and products

1Налаштування

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

• Поля товару — Налаштування›Типи даних›Товари«Налаштування → Типи даних → Товари» (зі складу — ⋮›Налаштувати поля«⋮ → Налаштувати поля»). Позначки: «Обов'язкове поле», «Вивести в списку», «Вивести при створенні», «Вивести в угоді» (колонка у вікні «Додати товар зі складу»), «Вивести в накладних», «Додати у фільтр», блок. Типи: рядок, цифри, дата, список, текст, так/ні, посилання.
• Склад і товари у меню «Налаштування»: «Загальні налаштування» (з якого розділу брати товари в угоду — «Склад» чи «Прайс-лист»; «Заблокувати списання товару, якщо наявність 0»; «Заборонити ручне списання товарів»; «Бронювання товару»; правила собівартості; «Автоматична генерація артикулів»), «Одиниці виміру», «Категорії складу», «YML генератор», «Синхронізація товарів через XML».
• Як діє кожна галочка «Загальних налаштувань товарів» (перевірено 16.10, тест test_product_settings_hold_on_every_path):
  • «Товари в замовленні: Склад / Прайс-лист» — позиції угоди лише з обраного розділу: у картці угоди, через API й ШІ (інший розділ → помилка); позицію без товару (назвою: доставка, послуга) можна додати завжди.
  • «Заборонити додавати товар, якого немає в наявності» — вільного залишку нема: товар не додати в угоду й не збільшити кількість позиції (вручну, ШІ, API). Замовлення з маркетплейсів і сайту приходять як є — це реальні замовлення.
  • «Заборонити ставити „Виграно“, якщо товар не списаний» — етап ролі «Виграно», «Виграно» в меню угоди (і коли такого етапу у воронці нема), масові дії, тригери, ШІ, API; автодія етапу «в архів — виграно» не архівує, а пише в журнал угоди, чому. Не діє для імпорту історії, тихого закриття угод з минулого й замовлень, що приходять уже виконаними.
  • «Заблокувати списання товару, якщо наявність 0» — списати більше, ніж є, не можна: позиція угоди, «Списання» в картці товару, етап угоди. Людина бачить повідомлення, і етап не змінюється; автоматичний етап (трекінг, приймання, автодії) змінюється, але позицію без залишку пропускає — запис у журналі угоди й сповіщення «Не списано: нема в наявності» у дзвіночку «Сповіщення складу» праворуч від вкладок складу (червона крапка на дзвіночку — є непрочитані) (21.10).
  • «Заборонити ручне списання товарів» — не-адміністратор не зменшить залишок у картці товару (пункту «Списання (−)» немає), «Обнуленням» чи імпортом з файлу (рядок іде у файл помилок); збільшити можна. Інвентаризація Віктора й синхронізація з Prom/XML працюють — це звірка з реальністю, не списання.
  • «Бронювання товару» — контролі дивляться на «Вільно» = в наявності − резерв; вимкнено — на «В наявності».
  • «К-сть місць» — вкладка «К-сть місць» у картці товару (місця й габарити кожного місця).
  • Вага й габарити (власник 19.10): «Вага, кг», «Об'єм, м³», «Довжина, см», «Ширина, см», «Висота, см» — системні поля кожного товару (є в усіх компаніях, не обов'язкові; обов'язковими й «при створенні» їх можна зробити в Типи даних›Товари«Типи даних → Товари»). Їх беруть позиції прайс-листа, пов'язані з товаром, і ТТН (галочка «з товарів угоди» в картці служби — Доставки і ТТН, 3а). Старі додаткові поля «Довжина (см)», «Ширина( см )», «Висота(См)» з KeepinCRM перенесено в системні 19.10 — їх можна сховати в «Типи даних». Товари, у яких ваги не було, 19.10 отримали оцінку ШІ (модель Opus — за назвою, описом і схожими виміряними товарами): у «Журналі» товару такий запис підписано «оцінка ШІ (Opus) … перевірити при зважуванні»; зважили справжнє — впишіть у картку, оцінка перезапишеться й потягнеться в прайс-лист.
• Склади — це філії з Налаштування›Команда й доступи›Філії та структура«Налаштування → Команда й доступи → Філії та структура»: нова філія сама отримує склад з тією ж назвою, а назву, вид, головний офіс і зв'язки з брендами й юрособами змінюють там (Філії та структура).
• Бренд і філія папок — Налаштування›Склад і товари›Категорії складу«Налаштування → Склад і товари → Категорії складу»: дерево папок з колонками «Бренд» і «Філія»; що задано папці, отримують її підпапки й товари, а від товарів — угоди (2а. Бренд і філія папки).
• Сторінки «Склади», «Типи цін», «Правила цін», «Етикетки», «ПДВ», «Prom» є, але пунктів у меню «Налаштування» для них нема.
• Доступ — галочка «Склад» у Налаштування›Розділи меню«Налаштування → Розділи меню»; окремі галочки для документів складу й «Прайс-листа» — у статтях про них.

2Знайти товар, папки

Папки (категорії складу) групують товари, щоб їх було легко знайти й відфільтрувати; створюють і переставляють їх у розділі «Склад».

1. Відкрийте «Склад» → вкладка «Товари».
2. Угорі таблиці — папки поточного рівня: клік відкриває папку; «⋮» папки — «Відкрити», «Нова підпапка», «Перейменувати», «Бренд і філія папки…», «Видалити» (лише порожню).
3. Пишіть у «Пошук»: артикул, назва, Marketplace uid або значення власного поля. З пошуком видно товари всієї гілки.
4. «Фільтри»: наявність, актуальність, «Бренд», «Філія», власні поля і «Колонки» (колонки «Бренд» і «Філія» типово сховані).
5. Унизу панелі «Фільтри» — ваші збережені фільтри і «+ Зберегти фільтр»: задайте пошук чи фільтри, натисніть «+ Зберегти фільтр» і впишіть назву. Клік по збереженому підставляє пошук і фільтри; «Збережені» — перейменувати, переставити, видалити. Праворуч — «Скинути»: прибирає всі фільтри списку.
6. Унизу — кількість товарів і категорій, суми, сторінки.
7. Позначте товари галочками → «Перенести в папку…»: угорі вікна — пошук папки за назвою чи батьківською папкою (видно шлях «Компанія / Папка»), ↑↓ і Enter.

2аБренд і філія папки

Папку товарів можна покласти в бренд і у філію: бренд показує, під чим продається товар, а філія — з якого складу він їде. Підпапки й товари успадковують бренд і філію своєї папки, тож задати їх досить один раз, а угода, фінанси й фільтри складу далі беруть їх самі.

1. Відкрийте Налаштування›Склад і товари›Категорії складу«Налаштування → Склад і товари → Категорії складу».
2. Знайдіть папку в дереві: підпапки стоять з відступом під своєю папкою, гілку можна згорнути й розгорнути; колонка «Товарів» показує, скільки в папці товарів.
3. Виберіть бренд у колонці «Бренд» рядка папки.
4. Виберіть філію в колонці «Філія» того ж рядка — зміна зберігається одразу, з'являється повідомлення про збереження.

Задати бренд і філію з дерева складу

1. Відкрийте Склад›Товари«Склад → Товари».
2. Натисніть «⋮» папки й виберіть «Бренд і філія папки…».
3. Виберіть «Бренд» і «Філія» у шторці.
4. Натисніть «Зберегти».

Як успадковуються бренд і філія

• Папка без свого бренду бере бренд найближчої папки над нею — на сторінці «Категорії складу» такий вибір підписано «як у батьківській: …».
• Верхня папка без свого бренду належить бренду, для якого її вибрано «папкою складу бренду» в Налаштування›Компанія й система›Компанії та реквізити«Налаштування → Компанія й система → Компанії та реквізити», або бренду з такою самою назвою.
• Філія успадковується так само. Якщо ні товар, ні жодна папка над ним філії не мають, товар отримує філію за старим текстом «Філія», коли той збігається з назвою філії.
• Після оновлення Helomi сам проставив бренд верхнім папкам, вибраним «папкою складу бренду», і філію товарам, у яких текст «Філія» збігається з назвою філії. Нічого не стерто, а повторне перенесення нічого не змінює.

Свій бренд чи філія на товарі

Товар може належати іншому бренду чи філії, ніж його папка: значення на товарі важливіше за папку.

1. Відкрийте картку товару.
2. Клацніть рядок «Бренд» або «Філія» — успадковане значення підписано «як у папці: …».
3. Виберіть інший бренд чи філію; щоб повернути значення папки, виберіть «як у папці: …».

Зміна записується в «Журнал» товару. Старий текст «Філія» з KeepinCRM не стирається: його видно підписом «запис: …» під рядком «Філія». У Налаштування›Типи даних›Товари«Налаштування → Типи даних → Товари» ці рядки — системні поля «Бренд» і «Філія (довідник)»: їх можна вивести в списку й картці, а поле «Філія» поруч — той самий старий текст.

Знайти товари бренду чи філії

У Склад›Товари«Склад → Товари» → «Фільтри» є «Бренд» і «Філія»: вони показують товари з таким брендом чи філією — і заданими на самому товарі, і взятими з папки. Колонки «Бренд» і «Філія» вмикаються в «Колонках» (типово сховані).

Що це дає угоді й фінансам

• Угода бере бренд і філію з папок своїх товарів — у «Даних угоди» поруч підпис «з папок товарів». Бренд з картки каналу важливіший за товари, а філію раніше за товари дають запис «Філія» угоди й картка каналу. Додали, прибрали чи змінили позицію — бренд і філія перераховуються, якщо їх не вибрано рукою і не взято з картки каналу, а в журналі угоди з'являється запис про зміну; зафіксованої юрособи це не змінює. Уся черга — Філії та структура.
• Змішана угода (товари двох брендів чи з двох філій) показує бренд і філію товарів на більшу суму, а «Фінанси» ділять її виручку між брендами пропорційно сумам позицій — так P&L бізнесів і виплати партнерам рахуються за брендом папки.
• Юрособа: умова «Папка складу товару» в правилах вибору юрособи збігається з будь-якою папкою над товаром — досить вибрати верхню папку (Бренди і юрособи).
• Склад позиції: за типу складу №2 «Один товар = декілька складів» позиція, якій склад не вибрано, береться зі складу філії товару, далі — зі складу філії угоди, далі — з головного складу.
• Фіди (YML) не змінюються: вони збираються за верхньою папкою компанії, як раніше.

3Додати товар або категорію

1. Натисніть круглу «+» праворуч унизу.
2. «Новий товар» відкриває шторку: артикул (необов'язковий, якщо його не генерує налаштування), «Назва *», «Од. виміру» (поле пропонує список Налаштування›Склад і товари›Одиниці виміру«Налаштування → Склад і товари → Одиниці виміру» і вже має типову; можна вписати свою), собівартість, ціна, папка, «В наявності», вага, об'єм, «Неактуальний» і поля з позначкою «Вивести при створенні». «Зберегти».
3. «Нова категорія» створює папку в поточній папці.

4Картка товару і рухи залишку

Угорі «Картки» — блок «Головне»: артикул, назва, од. виміру, папка, бренд, ціна й собівартість (залишок — праворуч). Решта полів — у згорнутих групах «Ціна» (валюта, ПДВ), «Вага й габарити», «Бренд і філія», «Постачальник, посилання» і групах власних полів; у заголовку групи видно, скільки полів заповнено («Вага й габарити · 1 з 5»), натиск розгортає, порожні поля — за «Показати порожні». Розгорнута група лишається розгорнутою. Які поля в «Головному» — Налаштування›Типи даних›Товари«Налаштування → Типи даних → Товари» (Типи даних і поля). У шапці — «Оновити на площадках» і «⋮» («Позначити неактуальним», «Блоки картки товару», «Налаштувати поля товару», «Інструкція (WIKI)», «Вхід для ШІ», «Видалити»); «Неактуальний» і «Видалити» є ще й унизу картки.

1. Клік по назві відкриває картку з вкладками «Картка» · «Угоди · N» · «Журнал». «Картка»: фото, групи полів «Основне», «Ціна», «Вага й габарити» (вага, об'єм, довжина, ширина, висота), «Постачальник, посилання» і власні блоки (значення змінюється кліком; порожні власні поля сховані під «Порожні поля · N»; «Папка» — вибір із пошуком), праворуч «Залишок» (на складі, резерв, вільно, дія із залишком, рухи).
   • «Угоди» — окремий розділ: усі угоди, де є цей товар або позиція прайс-листа, пов'язана з ним (набір рахується в штуках товару, біля угоди — «прайс-лист <артикул>»). Угорі підсумки: угод, продано шт, сума; пошук за номером чи назвою угоди; «Усі / В роботі / Архів»; таблиця: угода, клієнт, етап, дата, к-сть, ціна, сума, «списано» / «резерв»; «Показати ще». Угоди лише за збігом артикула не показуються: різні товари бувають з однаковим артикулом латиницею й кирилицею (A000142-1 і А000142-1) — такий артикул краще змінити одному з товарів.
   • Фото — натисніть фото, і воно відкриється на весь екран. Гортайте стрілками «‹ ›», клавішами ← → або мініатюрами внизу (на телефоні — свайпом убік); закрити — «×», Esc або натиск поруч із фото. Хрестик у кутку мініатюри прибирає фото з картки.
   • «Журнал» — хто й коли змінював товар.
   • «Бренд» і «Філія» у «Картці» — до якого бренду й філії належить товар; значення, взяте з папки, підписано «як у папці: …», а старий текст «Філія» з KeepinCRM — «запис: …». Клацніть рядок, щоб вибрати інше значення.
2. Щоб змінити залишок, виберіть «Дія із залишком»: «Прихід (+)», «Списання (−)», «Повернення (+)», «Перерахунок (=)» (новий точний залишок), кількість і коментар → «Записати».
3. «Оновити на площадках» відправляє ціну й наявність цього товару на підключені маркетплейси.
4. Товар, що вже є в угодах, видалити не можна — позначте його неактуальним (⋮›Позначити неактуальним«⋮ → Позначити неактуальним»).
5. Те саме — просто з таблиці, через «⋮» рядка товару (як у KeepinCRM): «Редагувати» (картка), «Додавання в наявний матеріал» (кількість, собівартість одиниці — необов'язково, коментар → «Додати»: прихід +), «Відняти матеріал зі складу» (кількість, коментар → «Відняти»: списання −), «Журнал» (усі рухи цього товару: дата, +/−, тип, коментар, угода, хто). У вікні видно, скільки є зараз і скільки стане. Заборона ручного списання і списання в мінус (Налаштування›Товари«Налаштування → Товари») діють і тут. Після «Додати» чи «Відняти» внизу екрана коротко з'являється чорна пігулка: «артикул: списано 1 шт, залишилось 42 шт» (чи «додано …, тепер …»). Вона зникає сама за кілька секунд або від натиску; на телефоні стоїть ліворуч від «+». Для комплекту («Комплектація» без свого залишку) додавання й віднімання вимкнені.

5Резерв і списання через угоди

• Товар з галочкою «резерв» в угоді резервується: «вільно» зменшується, «на складі» — ні.
• Списання і повернення роблять етапи угоди за налаштуванням «Склад» у «Воронках й етапах» або «⋮» позиції в картці угоди. Докладно — стаття «Угоди», розділ «Товари і склад».

6Журнал операцій

1. «Склад» → «Журнал операцій».
2. Кожен рядок: напрямок (надійшло або списано), дата, хто створив, товар з артикулом, кількість, собівартість, ціна, філія, тип руху словами, джерело угоди, коментар.
3. Фільтри: напрямок, тип, дати; пошук за товаром, номером угоди, коментарем. Унизу — «надійшло» і «списано» разом.
4. Видалення операції повертає залишок назад. Резерв тут не видаляється — його знімають в угоді.
5. Два типи рядків лише пояснюють, звідки взялося число, і залишку не змінюють (23.10). «Початковий залишок» — з чим товар прийшов з KeepinCRM при перенесенні. «Зміна без руху складу» — залишок змінили повз журнал: до 14.10 його перезаписувало дзеркало KeepinCRM, до 21.10 — імпорт KeepinCRM під час оновлення програми. У коментарі — проміжок, коли це сталося. Такі рядки не видаляються. Разом з ними сума журналу дорівнює залишку в картці товару.

7Масова зміна ціни, обнулення наявності

• ⋮›Масова зміна ціни«⋮ → Масова зміна ціни»: ціна або собівартість ± відсоток для вибраних товарів, поточної папки або всього складу.
• ⋮›Обнулити наявність«⋮ → Обнулити наявність» після підтвердження ставить нуль; кожна зміна записується в журнал як перерахунок.
• У «⋮» рядка товару: «Відкрити картку», «Позначити неактуальним» / «Позначити актуальним», «Оновити на площадках», «Видалити».

8YML-фід і публікації на площадки

YML-фід — постійна адреса з вашими товарами, цінами й наявністю для сайтів, Google Merchant, Hotline і партнерів; назви тегів налаштовуються під кожного одержувача.

• «Фід (YML)» показує адресу фіду, коли його згенеровано і скільки в ньому товарів; «Оновити». Фід усього складу — /feed/all.xml, окремої компанії — /feed/<назва>.xml; відкривається без входу, оновлюється раз на 5 хвилин. Склад полів фіду налаштовується в Налаштування›YML генератор«Налаштування → YML генератор».
• Там само — фіди каналів із прайс-листа /feed/channel/<канал>.xml (Prom, Rozetka, Kasta, Епіцентр, кожен сайт): оголошення саме цього каналу з його id і ціною з прайс-листа, а кількість і наявність — вільний залишок пов'язаних товарів складу. Саме ці адреси читають ШІ-агенти (Аліна, Єлизавета, Аня), Rozetka й сайти замість фіду KeepinCRM; позиція без зв'язку зі складом віддається з кількістю, яку востаннє бачили в каналі (див. статтю «Прайс-лист»).
• «Публікації на площадки» — журнал відправлень залишків і цін на Prom, Rozetka та інші канали; «Оновити зараз» спершу показує «Було / Стане» і нічого не відправляє, поки ви не підтвердите.
• Rozetka — з прайс-листа, за розкладом. Rozetka читає не фід, а API: картка Rozetka в «Публікаціях» має позначку «з прайс-листа» і розклад «автоматично кожні N хв» (типово 60; період і перемикач ставить людина, не .env). Кожне оголошення Rozetka з прайс-листа отримує залишок пов'язаних товарів складу і ціну з прайс-листа через PUT /items/mass-update; у «Публікаціях» видно «авто востаннє …».

8аYML генератор: свій фід

Свій фід — постійна адреса з вашими товарами, яку сайт, Hotline, Google Merchant чи партнер забирає сам, з тими назвами тегів, яких чекає саме він. Фідів може бути скільки завгодно: окремий для кожного сайту й партнера, кожен зі своїми умовами відбору.

Створити фід

1. Відкрийте Налаштування›Склад і товари›YML генератор«Налаштування → Склад і товари → YML генератор».
2. Натисніть «+ Фід» — відкриється вікно фіду на весь екран: ліворуч пронумеровані розділи налаштувань, праворуч — адреса фіду і зразок «Як товар виглядатиме у фіді».
3. Впишіть «Назву фіду», щоб відрізняти його у списку: «Hotline», «Сайт», «Партнер Київ». У сам фід назва не йде.
4. У розділі «Які товари потрапляють у фід» залиште або змініть галочки: «Лише товари в наявності», «Не вивантажувати товари з ціною 0», «Не вивантажувати неактуальні» та інші; за потреби оберіть «Філію». Під кожною галочкою написано, що вона змінює.
5. Натисніть «Зберегти» вгорі праворуч. Фід з'явиться у списку з позначкою «Працює», а в повідомленні — кнопка «Скопіювати адресу».

Віддати адресу сайту чи партнеру

1. У рядку фіду натисніть «Скопіювати адресу» (та сама кнопка є у вікні фіду, у картці «Адреса фіду»).
2. Вставте адресу в налаштуваннях сайту чи в кабінеті партнера там, де просять посилання на YML або XML-фід.

Адреса постійна: змінюєте налаштування — сайт побачить нові товари й ціни за 5 хвилин, вставляти адресу заново не треба.

Перевірити, що потрапляє у фід

1. У рядку фіду натисніть «Перевірити».
2. Подивіться, скільки товарів у фіді, і перші товари так, як їх прочитає сайт.
3. Щоб побачити весь файл, натисніть «Відкрити весь фід».

Якщо у фіді 0 товарів, натисніть «Змінити налаштування» і зніміть зайву умову — найчастіше «Лише товари в наявності» або філію.

Змінити теги, характеристики й решту

Натисніть назву фіду — відкриється вікно фіду на весь екран. Розділи пронумеровані; «змінено N» біля назви розділу означає, що там є значення, не такі, як типові:

1. «Основне» — «Назва фіду» і «Увімкнено».
2. «Які товари потрапляють у фід» — «Лише товари в наявності», «Не вивантажувати товари з ціною 0», «Не вивантажувати неактуальні», «Не вивантажувати товари без фото», «Не вивантажувати головний товар (лише модифікації)», «Філія» (типово «Усі філії»).
3. «Теги й поля товару» — ліворуч назва тегу, як її чекає одержувач, праворуч — що з товару в нього писати (стандартні й власні поля товару); «Додати тег», кошик прибирає рядок. Тут же «Тег списку товарів», «Тег одного товару» і «id товару у фіді» (артикул чи ID товару).
4. «Характеристики <param>» — кожен рядок стає тегом param з назвою характеристики; «Додати всі поля товару» дописує власні поля товару, яких ще нема у списку.
5. «Фото» — «Додати фото», тег головного і додаткових фото.
6. «Магазин у шапці фіду» — назва магазину, компанія й сайт у шапці файлу.
7. «Формат чисел» — «Ціну писати з комою (12,50)», «Наявність цілим числом».

Праворуч у вікні — «Адреса фіду» («Скопіювати адресу», «Відкрити»), «Зараз у фіді» (скільки товарів дають збережені налаштування, «Показати перші товари») і «Як товар виглядатиме у фіді» — зразок одного товару, що змінюється разом із налаштуваннями, ще до «Зберегти». Закрити вікно — кружечок «←» зліва вгорі або Esc; якщо є незбережені зміни, Helomi перепитає.

Вимкнути або видалити фід

• ⋮›Вимкнути фід«⋮ → Вимкнути фід» — адреса перестає відкриватись, налаштування лишаються; у повідомленні є «Скасувати». Увімкнути — ⋮›Увімкнути фід«⋮ → Увімкнути фід».
• ⋮›Видалити фід«⋮ → Видалити фід» або «Видалити фід» унизу вікна фіду — після підтвердження фід зникає назавжди. Сайти, що читали адресу, перестануть оновлювати товари; новий фід матиме нову адресу.

9Імпорт і експорт

⋮›Імпорт«⋮ → Імпорт» і ⋮›Експорт«⋮ → Експорт». Збіг з наявними — «ID, а якщо нема — артикулом», «ID», «Rozetka Offer ID», «Артикулом», «Назвою». Покроково — стаття «Імпорт і експорт».

Синхронізація товарів через XML

Товари з XML-файлу постачальника чи сайту створюються й оновлюються самі кожні 12 годин; вручну — один раз одразу після створення синхронізації (Налаштування›Склад і товари›Синхронізація товарів через XML«Налаштування → Склад і товари → Синхронізація товарів через XML»).

Замовлення з площадок і сайтів беруть позиції звідти ж (14.10)

Якщо в Налаштування›Товари›Товари в замовленні«Налаштування → Товари → Товари в замовленні» стоїть «Прайс-лист», приймання замовлень з Prom, Rozetka, Kasta, Епіцентру, OLX, сайтів і Telegram підбирає кожну позицію з прайс-листа: спершу оголошення цього каналу з тим самим id товару на площадці, потім Rozetka Offer ID, потім артикул, потім назва. Склад списується матеріалами позиції. Якщо стоїть «Склад» — позиція шукається серед товарів складу, як раніше (артикул або режим «Зв'язок позицій» у картці каналу).

Партнери на товарі (16.10)

Коли в бізнесу товару є партнери (Налаштування›Бренди та юрособи›бренд›Партнери бізнесу«Налаштування → Бренди та юрособи → бренд → Партнери бізнесу»), у картці товару з'являється блок «Партнери»: частка партнера на цьому товарі (порожньо — частка з бренду), «повертати собівартість», «у виплату». За ними рахуються виплати партнерам (Фінанси›Партнери«Фінанси → Партнери»). Зміни зберігаються одразу.