Загальна панель

При відкритті модуля в бекофісі PrestaShop зверху відображаються три основні лічильники:

• Brain Categories — кількість категорій, завантажених з API постачальника
• Selected Categories — скільки з них обрані для синхронізації
• Synced Products — загальна кількість товарів, які вже синхронізовані у ваш магазин

1. API Settings — підключення до Brain

Вводите логін і пароль від свого акаунту на api.brain.com.ua, обираєте мову API (українська або російська). Кнопка Test Connection перевіряє з'єднання одразу — без потреби зберігати і чекати на першу синхронізацію.

2. Categories — вибір категорій для синхронізації

Модуль завантажує повне дерево категорій з Brain API — понад 400 категорій у кількох рівнях вкладеності. Ви позначаєте галочками тільки ті, які хочете продавати. Є кнопки «Вибрати все» / «Зняти все». Категорії, які ви не обрали, повністю ігноруються при синхронізації — ваш PrestaShop залишається чистим від непотрібних позицій.

3. Sync Settings — налаштування синхронізації

• Price Markup (%) — відсоток націнки, який автоматично додається до роздрібної ціни Brain при імпорті. Наприклад, RRP 5000 грн + 5% = ваша ціна 5250 грн.
• Debug Mode — розширене логування для діагностики. У нормальному режимі тримайте вимкненим.
• Cron URL — готове посилання для автоматизації через системний cron (детальніше у закладці 8).

4. Delivery — адреси доставки

Brain має декілька складів і точок відвантаження по Україні. Ця закладка завантажує перелік доступних адрес з API і дозволяє обрати, з якого складу відвантажувати замовлення.

5. Manual Sync — ручна синхронізація

П'ять кнопок для запуску різних типів синхронізації:

• Sync Categories — оновити структуру категорій з API
• Sync Products — імпортувати нові товари і оновити існуючі (назви, описи, фото, характеристики)
• Sync Prices & Stocks — тільки ціни і залишки (швидше за повний sync)
• Sync Stocks Only — тільки залишки (найшвидший)
• Full Sync — усе разом послідовно

Під час виконання відображається прогрес-бар з поточним станом.

6. Analytics — цінова аналітика

Повноцінна аналітична панель з маржинальністю по кожному товару:

• Фільтри: за категорією, періодом (тиждень/місяць/квартал/весь час), наявністю, сортування за маржою, ціною, залишком
• Зведені картки: кількість товарів, середня/мін/макс маржа, кількість в наявності
• Графік Price History: інтерактивна візуалізація змін оптової і роздрібної ціни товару у часі
• Таблиця: артикул, оптова ціна, РРЦ, ваша ціна, маржа ₴ і %, залишок, дата синхронізації

7. Telegram Bot — сповіщення і підписки

Вбудований Telegram-бот з двома функціями:

• Для менеджера: миттєві сповіщення про замовлення, які потребують ручної обробки (артикул, кількість, адреса клієнта)
• Для клієнтів: підписки на зміну ціни конкретного товару. Коли ціна змінюється більше ніж на встановлений поріг — бот сповіщає

Панель статистики: підписники, активні підписки, відправлено сьогодні, у черзі. Кнопки «Register Webhook» і «Send Test Message».

8. Cron Jobs — автоматизація за розкладом

Готові команди для crontab сервера. Типова конфігурація:

• Щогодини — оновлення залишків (товари, що зникли з Brain, стають недоступними)
• Щодня — оновлення цін і характеристик
• Щотижня — повна синхронізація з імпортом нових товарів

Кожна задача захищена унікальним токеном, щоб ніхто ззовні не міг запустити вашу синхронізацію.

9. Log — журнал операцій

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

10. Dropshipping — дропшипінг через Brain

Найскладніша закладка модуля. Дозволяє налаштувати автоматичний дропшипінг:

• Enable/Disable: перемикач між live і dry-run режимом (у dry-run замовлення логуються, але не відправляються — зручно для тестування)
• Бізнес-суб'єкти: підтримка кількох юридичних осіб з окремими акаунтами Brain і ключами Нової Пошти. Система автоматично обирає потрібний залежно від типу клієнта
• Маршрутизація замовлень: налаштування, які групи покупців обслуговуються через дропшипінг, які через пряму відвантаження, а які категорії товарів — на ручну обробку
• B2B Auto-Detection: автоматичне визначення юрособ і маршрутизація в окремий потік з виставленням рахунку через BAS/1С
• Інтеграція з 1С/BAS: токен для обміну даними з BAS Бухгалтерією для B2B-клієнтів

Технічні вимоги

Підсумок