Модуль ms_fractional_stock позволяет продавать определённое количество товара или товар с плавающей величиной. Подходит для продажи продуктов питания (в граммах, килограммах), продуктов в упаковках (ящики, коробки) и других товаров с плавающим количеством.
Основные возможности
- Дробные количества: продажа товаров с дробными количествами (1.5 кг, 2.3 л)
- Единицы измерения: настройка единиц измерения (шт., кг, л, м и т.д.)
- Шаг изменения количества: настройка шага (0.1, 0.5, 1)
- Минимальное и максимальное количество: ограничения для заказа
- Глобальные настройки: общие настройки для всех товаров или индивидуальные для каждого
- Интеграция с модулем складов: учёт дробных остатков на складах
- Импорт/экспорт: поддержка CommerceML и стандартного импорта/экспорта CS-Cart
Как работает модуль
При установке модуль выполняет миграции и добавляет поля в таблицы products и product_descriptions: allow_fractional_amount, ms_fractional_stock_use_global_settings, ms_unit_measure, ms_step_qty, ms_min_qty, ms_max_qty.
Хуки корзины нормализуют количество при добавлении и обновлении: округляют до шага, проверяют минимальное и максимальное значение. Хуки товаров обрабатывают дробные количества при операциях с товарами и интегрируются с модулем складов.
Схемы импорта/экспорта расширены для работы с дробными количествами. JavaScript на витрине обрабатывает ввод и валидацию дробных количеств.
Где находится функциональность
Админка: настройки модуля, карточка товара (раздел «MS: Дробный остаток»), массовое обновление товаров.
Витрина: страница товара с полем ввода дробного количества, корзина и оформление заказа.
Настройки
Глобальные: «Использовать дробный остаток», «Единица измерения количества» (по умолчанию «шт.»).
Для товара: использование дробного остатка, глобальные настройки, единица измерения, шаг изменения, минимальное и максимальное количество.
Технические требования
Модуль для MULTIVENDOR и ULTIMATE. Конфликтует с csc_fractional_stock. Интегрируется с модулем warehouses.
- Store Builder
- Store Builder Ultimate
- Multi-Vendor
- Multi-Vendor Plus
- Multi-Vendor Ultimate
- Вендорам
- Владельцам
- Покупателям
- English
- Русский
- 4.18.X
- 4.17.X
Установка
- Убедитесь, что модуль активирован в Администрирование → Модули → Управление модулями
- Модуль автоматически устанавливается в MULTIVENDOR и ULTIMATE
- Важно: Модуль конфликтует с
csc_fractional_stock— нельзя использовать оба одновременно - При установке выполняются миграции для создания полей в таблицах
Настройка
- Перейдите в Администрирование → Модули → Управление модулями → MS: Дробный остаток
- Глобальные настройки: включите «Использовать дробный остаток», укажите единицу измерения по умолчанию (шт., кг, л)
- Сохраните изменения
Использование для администратора
Настройка товара: откройте карточку товара, найдите раздел «MS: Дробный остаток». Настройте: использование дробного остатка, глобальные настройки, единицу измерения, шаг изменения, минимальное и максимальное количество.
Массовое обновление: Администрирование → Товары → Массовое обновление — выберите товары и настройте параметры дробного остатка.
Использование для покупателя
На странице товара с включённым дробным остатком можно ввести дробное количество (1.5, 2.3). Количество округляется до шага. В корзине отображается дробное количество с единицей измерения.
Примеры
- Продукты питания: единица «кг», шаг 0.1 — заказ 1.5 кг, 2.3 кг
- Жидкости: единица «л», шаг 0.1 — заказ 0.5 л, 1.2 л
- Упаковки: единица «уп.», шаг 0.5 — заказ 1.5 упаковки
Проверка работы
Настройте товар с дробным остатком, откройте страницу на витрине, проверьте ввод дробного количества и округление до шага. Проверьте ограничения min/max.
Устранение неполадок
- Дробные количества не работают — проверьте активацию модуля и настройки товара
- Количество не округляется — проверьте шаг изменения
- Ограничения не работают — проверьте min/max
v1.2.0
от 23.02.2026
- [!] Исправлена ошибка при добавлении общего товара из карточки товара в избранное добавлялось два товара
- [+] В встроенный api фронтенда корзины добавлены поля "ms_unit_measure", "ms_step_qty"
- [\*] Обновлен шаблон модуля
v1.1.0
от 08.09.2025
- [\*] Изменен алгоритм определения минимального количество товара для заказа
- [!] Исправлена ошибка удаления товаров из корзины
- [\*] Стандартизация модуля
- [+] Добавлена миграция для изменения типа поля amount в таблице хранения товаров корзины с mediumint на float, для мобильного приложения
v1.0.0
от 25.04.2025
- [+] Первое издание
Обозначения:
[+] Добавлено | [-] Удалено | [\*] Изменено | [!] Исправлена ошибка
Здесь можно поделиться своим мнением и оценить нашу работу.
Ваши отзывы помогают нам стать лучше и предлагать вам еще более качественный сервис.