Brain Sync для PrestaShop: синхронізація каталогу, дропшипінг і аналітика — огляд модуля
Загальна панель
При відкритті модуля в бекофісі PrestaShop зверху відображаються три основні лічильники:
- Brain Categories — кількість категорій, завантажених з API постачальника
- Selected Categories — скільки з них обрані для синхронізації
- Synced Products — загальна кількість товарів, які вже синхронізовані у ваш магазин
1. API Settings — підключення до Brain
Вводите логін і пароль від свого акаунту на api.brain.com.ua, обираєте мову API (українська або російська). Кнопка Test Connection перевіряє з'єднання одразу — без потреби зберігати і чекати на першу синхронізацію.
Пароль зберігається як MD5-хеш (вимога Brain API). Якщо ви зміните пароль на сайті Brain — достатньо оновити його тут.
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 — усе разом послідовно
Під час виконання відображається прогрес-бар з поточним станом.
Ручну синхронізацію використовують при першому запуску або після зміни набору категорій. Для рутинного оновлення краще налаштувати Cron Jobs (закладка 8).
6. Analytics — цінова аналітика
Повноцінна аналітична панель з маржинальністю по кожному товару:
- Фільтри: за категорією, періодом (тиждень/місяць/квартал/весь час), наявністю, сортування за маржою, ціною, залишком
- Зведені картки: кількість товарів, середня/мін/макс маржа, кількість в наявності
- Графік Price History: інтерактивна візуалізація змін оптової і роздрібної ціни товару у часі
- Таблиця: артикул, оптова ціна, РРЦ, ваша ціна, маржа ₴ і %, залишок, дата синхронізації
Сортування за «Margin % ↑» одразу покаже товари з аномально низькою маржою — зазвичай це означає, що Brain змінив оптову ціну, а ви ще не підняли свою. Без аналітики ви помітите проблему тільки коли продасте товар у мінус.
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-клієнтів
Узгодження з менеджером Brain, поповнений баланс Brain, API-ключ Нової Пошти від вашого суб'єкта. Dry-run режим дозволяє перевірити весь flow без списання коштів.
Технічні вимоги
- PrestaShop 8.0 — 8.x
- PHP 8.0+
- MySQL/MariaDB (utf8mb4)
- Акаунт на api.brain.com.ua
- Для дропшипінгу: API-ключ Нової Пошти
- Для Telegram: Bot Token від @BotFather
- Сервер з підтримкою cron
Підсумок
- Імпорт каталогу Brain з деревом категорій і характеристиками
- Щоденне автоматичне оновлення цін і залишків
- Автоматична націнка на роздрібну ціну
- Цінова аналітика з маржою по кожному товару і графіками
- Дропшипінг: замовлення → Brain → ТТН Нової Пошти → клієнт
- Підтримка кількох юридичних осіб
- Telegram-сповіщення і підписки клієнтів на ціни
- B2B-маршрутизація з інтеграцією до BAS/1С
- Dry-run режим для безпечного тестування
Модуль розроблений під потреби українського e-commerce з Brain. Якщо у вас схожий сценарій — пишіть на admin@it-format.com.ua, обговоримо адаптацію під ваш магазин.
