Stock Reserve & Reorder для OpenCart — физический остаток, резерв заказов и точка дозаказа

Stock Reserve & Reorder для OpenCart — модуль для магазинов, которые держат товар на собственном складе. OpenCart хранит для товара одно число — «Количество» — и вычитает из него заказ, как только тот переходит в статус обработки, задолго до того, как посылку забрали с полки. Поэтому после нескольких дней продаж число в админке не совпадает с тем, что лежит на складе, а инвентаризация начинается с вопроса «а куда делись 7 штук?».

Модуль читает заказы и показывает для каждого товара и каждого значения опции три числа: физический остаток (что лежит на полке), резерв (продано, но ещё не отгружено — со списком заказов) и доступный (что ещё можно продать). Приход добавляет «+N» поверх остатка, а не перезаписывает его; списание и инвентаризация пишутся в журнал и отменяются. Точка дозаказа считается по скорости продаж, сроку поставки и страховому запасу.

Для WooCommerce есть отдельная версия — Stock Reserve & Reorder для WooCommerce.

Как это выглядит для покупателя

Покупатель модуля не видит: на витрине и в оформлении заказа ничего не меняется, скриптов и запросов на страницах магазина модуль не добавляет, а OpenCart продаёт дальше из того же поля «Количество». Покупатель замечает только следствие: товар дозаказали вовремя, а не тогда, когда последнюю единицу уже продали дважды.

Что получает админ

Пункт меню Каталог → «Остатки и дозаказ» и страницы «Остатки», «Дозаказ», «Складские документы», «Настройки».

• Плитки: сколько единиц в резерве и в скольких позициях, сколько физически на полке, сколько позиций пора дозаказать и сколько перепродано.
• Таблица для каждого товара и значения опции, где OpenCart вычитает со склада: количество в OpenCart, физический, резерв, доступный, продано за период, точка дозаказа и состояние — «Норма», «Дозаказать», «Перепродано», «Ничего доступного», «Не отслеживается».
• Клик по резерву открывает заказы, которые его держат: номер, дата, статус, покупатель, количество и пометка, списал ли OpenCart товар.
• Фильтры: поиск по названию, модели, SKU или #ID, категория, «с резервом», «дозаказать + перепродано», «ничего доступного», значения опций, отключённые товары; сортировка по резерву, доступному остатку, дням запаса или срочности.
• Изменение остатка из строки: приход «+N», списание «−N» или инвентаризация — посчитанное на полке становится физическим остатком. Каждое изменение — документ в журнале со счётчиком до и после, его можно отменить.
• Строка в карточке товара: «Физически · резерв · доступно» под полем «Количество» и ссылка на страницу остатков.

Дозаказ

• Точка дозаказа = продажи в день × (срок поставки + страховой запас). Позиция попадает в «Дозаказать», когда доступный остаток на этой точке или ниже, и в «Перепродано», когда резерв больше физического остатка.
• «Хватит на» — дней продаж на доступном остатке при текущей скорости.
• Pro: срок поставки, страховой запас, минимальный остаток, кратность упаковки и поставщик для конкретного товара или значения опции; колонка «Заказать» с рекомендуемым количеством; кнопки «CSV для закупки» и «Приход из рекомендаций».

Pro: складские документы, CSV и ежедневный отчёт

• Многострочные документы — приход, списание или инвентаризация с номером, поставщиком и примечанием. Строки вставляются прямо из таблицы: SKU, модель, #product_id или #product_id/option_value_id и количество. «Проверить строки» показывает остаток до и после; неизвестный код, неоднозначная модель или нулевое количество блокируют весь документ, пока строку не исправят.
• CSV остатков, списка закупки и всех изменений остатка: UTF-8 с BOM, разделитель «;», названия, начинающиеся с «=», не выполняются в Excel как формулы.

• Ежедневный отчёт — позиции на точке дозаказа или ниже с рекомендуемым количеством и, по желанию, перепроданные. Если ничего не нужно — ничего не отправляется.
• Каналы: до 5 e-mail через почтовые настройки магазина и Telegram (токен бота и ID чата). В OpenCart 4 отчёт запускает планировщик OpenCart, в 3 и 2.3 — адрес с секретным ключом для cron хостинга.

Как это работает — шаг за шагом

1. Модуль берёт заказы в резервных статусах — по умолчанию это статусы обработки вашего магазина без статусов выполнения, то есть «продано, но не отгружено».
2. Для каждого товара и значения опции он считает, сколько из этих заказов OpenCart уже списал из «Количества» — по тому же правилу, что и ядро (OpenCart 4.1 объединяет списки статусов обработки и выполнения, вариант OpenCart 4 списывает ещё и главный товар).
3. Физический = количество в OpenCart + уже списанные товары резервных заказов. Резерв = все товары резервных заказов. Доступный = физический − резерв.
4. Продажи в день = продано за период (по умолчанию 30 дней) ÷ дни. Точка дозаказа = продажи в день × (срок поставки + страховой запас); в Pro — не меньше минимального остатка.
5. Приход, списание или инвентаризация меняют «Количество» одним атомарным запросом «количество + N», поэтому продажа, пришедшая в ту же секунду, не теряется. Каждое изменение — в журнале, отмена возвращает его назад.

Что под капотом

• Без правок ядра. Без OCMOD-патчей; пункт меню и строка в форме товара добавляются событиями OpenCart. Одна библиотека классов одинакова в трёх сборках, код совместим с PHP 7.0.
• Собственные таблицы oc_cc_stockres_doc (документы), oc_cc_stockres_move (строки изменений со счётчиком до и после), oc_cc_stockres_item (параметры товара). Таблицы ядра не меняются.
• Расчёт на лету, раз на запрос во временной таблице; без кеша, поэтому цифры всегда свежие.
• Адрес крона index.php?route=extension/cc_stockres/cron.cron&key=… (в 3.x и 2.3 — extension/module/cc_stockres_cron/cron): без ключа — «403», отчёт уходит не чаще раза в день, при сбое отправки повторяется.
• Лицензия живёт в отдельной группе настроек: «Сохранить» её не трогает.
• Деинсталляция снимает события и (OpenCart 4) задание cron, а документы и параметры товаров оставляет — повторная установка их видит. Настройки модуля OpenCart при деинсталляции удаляет, лицензия в отдельной группе остаётся. Для полного удаления удалите таблицы oc_cc_stockres_* вручную.

Как установить

1. OpenCart 4: Расширения → Установщик → загрузите cc_stockres.ocmod.zip (имя архива не меняйте) и нажмите «Установить». OpenCart 3: Расширения → Установщик → cc_stockres-oc3.ocmod.zip, затем Расширения → Модификации → «Обновить». OpenCart 2.3: залейте содержимое папки upload/ из cc_stockres-oc2.ocmod.zip в корень магазина (FTP или файловый менеджер хостинга) — Установщик 2.3 без настроенного FTP файлы не копирует.
2. Расширения → Расширения → Модули → CatCode Stock Reserve & Reorder → «Установить». Модуль сразу включён.
3. Каталог → «Остатки и дозаказ». В «Настройках» проверьте резервные статусы, период продаж, срок поставки и страховой запас.
4. Для Pro: вставьте лицензионный ключ из письма после оплаты или нажмите «Попробовать Pro 7 дней» во вкладке «Лицензия».