Shared Stock для OpenCart — один остаток для нескольких товаров и значений опций без перепродаж

Shared Stock для OpenCart — модуль от студии CatCode для магазина, который продаёт одну физическую вещь в нескольких местах каталога. Батончик «Ваниль» отдельно — и тот же вкус в подарочном наборе, где покупатель выбирает вкус в пяти списках «Вкус 1…5». Тот же товар в другом наборе. OpenCart считает остаток каждого товара и каждого значения опции отдельно, поэтому владелец магазина переписывает цифры вручную — и всё равно продаёт последнюю единицу дважды.

Shared Stock объединяет такие места в пул — одну цифру остатка, из которой продают все они. Участником пула может быть товар целиком или отдельное значение опции. Корзина проверяется по пулу целиком: набор с пятью «Ваниль» в количестве 2 берёт из пула 10. Продажа любого участника снимает с пула, а каждый участник показывает, сколько пул ещё может покрыть. Два покупателя, которые в одну и ту же секунду подтверждают последние единицы, не получат их оба.

Это не дубль Option Combinations. Option Combinations ведёт остаток комбинаций опций внутри одного товара (размер × цвет). Shared Stock решает другой сценарий: один остаток для разных товаров и значений опций — тот же вкус отдельным товаром, в пяти списках набора и в другом наборе. Первый модуль не делит остаток между товарами, второй не ведёт комбинаций внутри товара.

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

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

Если пул уменьшился, пока товар лежал в корзине (другой покупатель успел купить), корзина помечает строку *** и не пускает к оформлению — это штатное поведение OpenCart для остатка, только считается оно по пулу.

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

• Каталог → Общий остаток: пулы с остатком, удержанным неподтверждёнными заказами, и доступным; создание пула. Пустой новый пул берёт остаток первого добавленного участника.
• Страница пула: «Добавить / списать (±N)» относительно текущего — поставка, оформленная во время заказов, не потеряется; «Установить» для инвентаризации; порог письма (Pro); участники с их количеством в OpenCart; поиск товара и добавление целого товара или одного значения опции; список удержаний неподтверждённых заказов.
• Форма товара: строка под полем «Количество» с названием пула. Новая цифра в этом поле или в количестве значения опции устанавливает пул, а старая цифра из давно открытой формы — нет.
• «Синхронизировать количества» — после CSV-импорта или другого модуля, который пишет количества напрямую: зеркала снова показывают пул, участники удалённых товаров убираются.

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

1. Вы создаёте пул (например, «Ваниль»), задаёте остаток и добавляете участников: батончик целиком и значение «Ваниль» из каждого списка набора. Количество каждого участника в OpenCart становится зеркалом пула.
2. Покупатель добавляет товар в корзину. Модуль считает, сколько единиц каждого пула просит вся корзина, с учётом того, что удерживают неподтверждённые заказы других покупателей, и отказывает с объяснением, если не хватает.
3. На шаге подтверждения — отдельным запросом или внутри страницы оформления OpenCart 4 и One Page — модуль берёт блокировку базы, ещё раз проверяет корзину по пулу и удерживает единицы заказа. Другой покупатель, который подтверждает в ту же секунду, ждёт своей очереди и видит уже меньшую цифру. Очередь дольше 10 секунд (настраивается) — покупатель получает отказ, а не риск продать дважды.
4. Когда заказ переходит в статус обработки или выполнения, модуль снимает единицы с пула — ровно один раз на строку заказа — и обновляет количество всех участников. Отмена возвращает единицы.
5. Удержание неподтверждённого заказа живёт 60 минут (настраивается), потом единицы снова доступны другим покупателям.

Что проверено, а что нет

Проверено локально на четырёх версиях OpenCart: 79 проверок на OpenCart 4.1.0.3 и 4.0.2.3 и по 77 на 3.0.5.0 и 2.3.0.2 по основному сценарию, плюс отдельные прогоны в браузере, с One Page Checkout, правки заказов, импорта и писем Pro. Версию 1.0.1 — тем же набором, плюс пять прогонов подряд одновременных загрузок страницы оформления (штатной и One Page) на OpenCart 4.1 и 4.0.2.3 — каждый раз ровно 2 заказа из 8, пул не ниже нуля — и 24 комбинации языка магазина и языка покупателя для сообщения «в корзину». Лицензионный сервер и почту подменяли тестовые серверы.

Границы, о которых стоит знать. Защита от одновременных покупателей стоит на шаге подтверждения заказа — и тогда, когда он идёт отдельным запросом, и когда OpenCart 4 или наш One Page открывает его внутри страницы оформления. Сторонний one-page чекаут, который записывает заказ в обход этого шага, проверяет корзину без блокировки; удержание модуль и тогда пишет, только если пул его покрывает. Заказ, оплаченный уже после того, как его удержание истекло (60 минут по умолчанию), списывает пул даже в минус — так же, как OpenCart без модуля; это видно в истории пула. Не проверяли: платёжные шлюзы с обратным вызовом банка, сторонние one-page чекауты (кроме нашего), совместную работу с Option Combinations, варианты товаров OpenCart 4 (master / variant), MySQL 8 и кластеры Galera.

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

• Пул — в собственной таблице. Количества участников в OpenCart лишь показывают, сколько пул ещё может покрыть; чекаут считает по пулу.
• Одно списание на строку. Строка заказа снимает с пула один раз (условное обновление в базе), так что повторная смена статуса или повторная отмена ничего не удваивает.
• Удержание на подтверждении. Заказ, дошедший до шага подтверждения, удерживает свои единицы; повторное открытие шага тем же покупателем заменяет удержание, а не добавляет второе.
• Без правок ядра и без OCMOD-патчей — только события OpenCart; одна библиотека на три сборки, код совместим с PHP 7.0, работает и с драйвером базы pdo в OpenCart 4.1.
• Лицензия — отдельной группой настроек, так что сохранение настроек её не затрагивает.
• Удаление снимает события и таблицы модуля (можно оставить данные для повторной установки).

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

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