В оптовом интернет-магазине каждая позиция продаётся только партиями — от 6, 10 или 100 штук. Если покупатель добавляет в корзину 5 вместо 6, корзина либо округляет количество до минимума, либо выдаёт ошибку. На первый взгляд — простая настройка через админку. Но на практике, когда в каталоге 10 000 товаров, а партия зависит от упаковки поставщика, ручное редактирование превращается в ад. Один наш клиент с каталогом из 12 000 позиций потратил неделю на простановку значений вручную — и всё равно ошибся в 15% случаев. Мы автоматизировали процесс через импорт CSV и скрипт синхронизации с 1С, сократив время до двух часов.
В Битрикс минимальная партия задаётся полем MIN_QUANTITY в таблице b_catalog_product. Дополнительно используется STEP_QUANTITY — шаг изменения количества (кратность). При добавлении товара в корзину модуль catalog считывает MIN_QUANTITY и автоматически поднимает количество, если покупатель указал меньше. Важно: поле не влияет на цены со скидкой и не зависит от остатков — только сам товар.
Где хранится и как работает MIN_QUANTITY
Каждый товар имеет запись в b_catalog_product со следующими полями:
-
MIN_QUANTITY— минимальное количество для заказа (десятичное, по умолчанию 1) -
STEP_QUANTITY— шаг увеличения количества (кратность, по умолчанию 1)
Если MIN_QUANTITY = 0 или 1, ограничение не действует. При добавлении в корзину система считывает MIN_QUANTITY и, если введённое количество меньше, автоматически поднимает его до минимума (зависит от настройки компонента корзины).
Настройка через административный интерфейс
Каталог → [выбрать товар] → Торговые предложения/Количество
Поле «Минимальное количество для заказа» — вводится число. Значение 0 или 1 означает отсутствие ограничения. Для массового задания используется импорт через CSV или XML (Каталог → Импорт), где в колонке MIN_QUANTITY указывается нужное значение.
Как настроить минимальную партию для 10 000 товаров?
Если товаров много, ручное редактирование каждого — неделя работы. Оптимальный путь: импорт через CSV с генерацией файла в Excel или на стороне 1С. Колонка MIN_QUANTITY в выгрузке каталога присутствует. Для оптовых позиций можно установить значение 6, для розничных — 1. После импорта обязательно проверить согласованность с STEP_QUANTITY (ошибка здесь — частая причина сбоя корзины). Импорт CSV в 50 раз быстрее ручного редактирования для 10 000 товаров.
Настройка через API: пошаговая инструкция
- Получите ID товара или торгового предложения (например, через
CIBlockElement::GetList). - Вызовите
\Bitrix\Catalog\Model\Product::update($elementId, ['MIN_QUANTITY' => 10]). - Убедитесь, что кэш каталога сброшен (используйте метод
ClearByTag). - Проверьте в корзине, что новое значение применяется.
- Для массовой установки выполните цикл в агенте или скрипте.
\Bitrix\Catalog\Model\Product::update($elementId, [ 'MIN_QUANTITY' => 10, ]); Этот метод предпочтительнее CIBlockElement::SetPropertyValues, потому что работает напрямую с таблицей b_catalog_product и триггерит кэширование. Мы используем его в пользовательских агентах для синхронизации с ERP.
Почему MIN_QUANTITY не работает в headless-фронтенде?
Стандартный компонент bitrix:sale.basket.basket читает MIN_QUANTITY и автоматически корректирует количество. Но если фронтенд headless (React, Vue), то MIN_QUANTITY нужно получать через REST API (метод catalog.product.get) и реализовывать валидацию на клиенте. Иначе покупатель отправит 5, а сервер примет заказ без проверки — ошибка корзины.
Как согласовать MIN_QUANTITY и STEP_QUANTITY?
Если задана и минимальная партия, и кратность (STEP_QUANTITY), то минимальное количество должно быть кратно шагу. Пример: MIN_QUANTITY = 6, STEP_QUANTITY = 3 — корректно (6/3=2). А MIN_QUANTITY = 5, STEP_QUANTITY = 3 — приводит к тому, что корзина поднимает количество до 6 (следующее кратное), но покупатель видит неожиданное изменение. Мы проверяем эту согласованность автоматически скриптом.
Подробнее о проверке остатков
Для быстрой проверки всех товаров выполните SQL-запрос: ```sql SELECT ID, MIN_QUANTITY, STEP_QUANTITY FROM b_catalog_product WHERE MIN_QUANTITY > 0 AND STEP_QUANTITY > 0 AND MIN_QUANTITY % STEP_QUANTITY != 0; ``` Это выявит несогласованные записи. Такие товары нужно исправить или принудительно выровнять шаг.Способы настройки: сравнение
| Способ | Время на 1 товар | Подходит для масс | Ошибки |
|---|---|---|---|
| Админка (ручное поле) | 1–2 мин | до 50 товаров | возможны опечатки |
| Импорт CSV | 1–2 часа на каталог | от 100 товаров | требуется подготовка данных |
| API (скрипт) | 10–15 мин на разработку | от 1000 товаров | минимальные при тестировании |
Типичные ошибки и их решения
| Ошибка | Причина | Решение |
|---|---|---|
| Корзина не поднимает количество | Компонент не читает MIN_QUANTITY |
Обновить шаблон корзины или реализовать валидацию |
| Количество меняется непредсказуемо | MIN_QUANTITY не кратно STEP_QUANTITY |
Выровнять кратность |
| После импорта значения сбросились | Неправильный формат CSV (пропущена колонка) | Проверить маппинг полей |
| Headless-фронтенд не применяет минимум | Отсутствует клиентская валидация | Добавить проверку на основе REST API |
Сроки выполнения
Базовая настройка минимальной партии для одного товара или на группу через импорт — от 2 до 4 часов. Включает: анализ текущих данных, подготовку файла, импорт, проверку в корзине, исправление ошибок согласованности. Если требуется разработка скрипта для автоматической синхронизации с 1С — срок увеличивается до 1 дня.
Что входит в настройку под ключ
- Аудит существующих значений
MIN_QUANTITYиSTEP_QUANTITYпо всему каталогу - Подготовка и проведение массового импорта (CSV/XML)
- Написание скрипта для API (если нужна автоматизация)
- Проверка работы корзины в стандартных и кастомных компонентах
- Краткая документация по поддержке
- Консультация по headless-фронтенду (если актуально)
Мы — сертифицированные специалисты по Битрикс с опытом внедрения более 50 проектов настройки каталога для оптовой и розничной торговли. Гарантируем стабильную работу корзины после изменений. Снижение затрат на обслуживание каталога и экономия времени до 80% — ожидаемые результаты.
Официальная документация 1С-Битрикс — MIN_QUANTITY поможет разобраться в нюансах.
Для массовой настройки или сложных сценариев (интеграция с 1С, кастомный шаг, проверка остатков) — пишите. Оценим ваш проект за 1 рабочий день и предложим оптимальное решение. Свяжитесь с нами для аудита вашего каталога. Обращайтесь за детальным разбором — получите консультацию.