Мультисклад и правила наличия

ПЕРЕД УСТАНОВКОЙ

1. Проверьте требования: PHP 8.2+, главный модуль 20.0.0+, установленный «Торговый каталог». Для PostgreSQL нужен главный модуль 23.900.900+. Поддерживаются MySQL 5.7+ и MariaDB 10.3+.
2. Сделайте резервную копию сайта и базы данных. Устанавливайте решение под администратором.
3. Проверьте актуальность остатков каталога. Создание складов, приход, резервирование и обмен с 1С настраиваются средствами «Торгового каталога».

УСТАНОВКА

1. Загрузите решение через Marketplace и установите его в разделе установленных решений. При ручной установке разместите каталог ozhogov.stock в /bitrix/modules/ и запустите установку через административный раздел.
2. Откройте Настройки → Настройки продукта → Настройки модулей → Мультисклад и правила наличия. Начальные значения: «много» от 10, «мало» от 1, срок под заказ 14 дней, пропуск выходных включён, точный остаток выключен, разбивка по складам включена.
3. Укажите код свойства бренда (по умолчанию BRAND) и при необходимости код числового свойства со сроком поставщика в днях. Проверьте настройку учёта резерва и часовой пояс главного модуля.

СКЛАДЫ

1. Откройте Магазин → Мультисклад → Склады: список берётся из каталога.
2. Задайте приоритет (больше — раньше), срок доставки, название для покупателя и участие в общем остатке.
3. Исключите из расчёта брак и транзит, если они не доступны к продаже. Включите показ покупателю только для нужных складов: новый склад по умолчанию скрыт.
4. Отметьте склады поставщиков отдельно. Их остатки дают наличие под заказ, а адреса покупателю не показываются.

РЕГИОНЫ

1. Откройте Магазин → Мультисклад → Регионы и добавьте действующие регионы с кодами латиницей, например msk и spb.
2. Выберите регион по умолчанию для посетителей, которые ещё не выбрали город. Без регионов используются общие настройки складов.
3. В форме региона отметьте обслуживающие склады, задайте региональные приоритеты и сроки. «Только свои склады» ограничивает расчёт привязанными складами.

ПРАВИЛА НАЛИЧИЯ

1. Откройте Магазин → Мультисклад → Правила наличия и создайте правила для каталога, раздела, бренда или товара.
2. Задайте пороги и показ точного остатка. Пустой срок под заказ наследуется, ноль не обещает срок; положительное число задаёт срок в днях.
3. Сначала учитывается приоритет, при равном — точность: товар, бренд, раздел, весь каталог. Правило предложения точнее правила карточки, вложенного раздела — родительского.
4. Проверьте пример в форме правила и результат на витрине.

ПОДКЛЮЧЕНИЕ ВИТРИНЫ

1. Добавьте ozhogov:stock.availability в карточку товара. Передайте PRODUCT_ID из текущего товара; для блока выбранного размера используйте номер предложения.
2. В списке товаров передайте также PRODUCT_IDS — номера всех товаров страницы: это включает пакетный расчёт. Добавьте ozhogov:stock.region в шапку для общего выбора региона.
3. Вызывайте блок наличия вне внешнего кеша шаблона каталога, например в component_epilog.php. Собственный CACHE_TIME компонента по умолчанию — 60 секунд.
4. QUANTITY задаёт проверяемое количество от 0,001 до 1000. Передавайте его из настроек страницы, а не из запроса посетителя. Компонент сохраняет это количество при AJAX-пересчёте с помощью подписи сайта.
5. Стандартный catalog.element сообщает выбранное предложение событием onCatalogStoreProductChange. В своём шаблоне передавайте номер предложения этим событием либо выводите компонент непосредственно для выбранного предложения.
6. Примеры PHP-подключения находятся в README решения. Компоненты поставляются отдельно и требуют добавления в шаблон сайта.

ПРОВЕРКА ПОСЛЕ УСТАНОВКИ

1. Откройте доступный покупателю товар с остатком и товар без остатка. Проверьте текст, дату, единицу измерения и разрешённые к показу склады.
2. Смените регион, затем перезагрузите страницу: выбор должен сохраниться, наличие — соответствовать складам региона.
3. У товара с предложениями выберите несколько размеров и проверьте изменение наличия.
4. Откройте товар «нет» или «под заказ» с работающим JavaScript и проверьте отчёт Магазин → Мультисклад → Где теряем заказы. Повторный просмотр не обязан создавать новую строку: действует защита от повторов и частоты запросов.
5. Проверьте права сотрудников: нужны права на решение и просмотр складов каталога, а при установленном «Интернет-магазине» — также его права. Настройки общие для всех сайтов; их изменение требует доступа ко всем сайтам магазина и права изменения складов каталога.

ОБНОВЛЕНИЕ И УДАЛЕНИЕ

Обновляйте через Marketplace: updater.php обновляет компоненты, скрипты и административные обёртки. При ручной замене файлов модуля отдельно обновите его компоненты и скрипты в общих каталогах сайта, затем очистите кеш витрины. Если используются собственные копии шаблонов компонентов, перенесите в них изменения разметки и параметров из новой версии.

При удалении можно сохранить таблицы модуля для повторной установки. Остатки «Торгового каталога» решение не удаляет.

ОГРАНИЧЕНИЯ

Решение показывает наличие и рассчитывает сроки; оно не резервирует товар и не создаёт отгрузки или перемещения. Резерв на уровне товара при выключенном складском учёте не вычитается из складских строк. Журнал промахов по умолчанию хранится 180 дней и очищается агентом; гости учитываются с объединением повторов по товару и региону.

Техническая поддержка решения оказывается разработчиком в течение срока действия лицензии.

— Электронная почта: nm.ozhogov@ya.ru
— Время ответа: в рабочие дни, в течение 48 часов с момента обращения.
— Часовой пояс: UTC+3 (Москва).

Чтобы вопрос решился с первого письма, приложите: название и версию решения, редакцию 1С-Битрикс и версию главного модуля, версии PHP и базы данных, адрес страницы, на которой воспроизводится проблема, последовательность действий для её повторения и снимок экрана с сообщением об ошибке. Если ошибка попала в журнал событий сайта, приложите запись из него.

В поддержку можно обращаться с вопросами по установке, настройке и обновлению решения, по совместимости с другими решениями и по ошибкам в его работе. Доработка решения под требования конкретного проекта в поддержку не входит и обсуждается отдельно.