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 днів» у вкладці «Ліцензія».