Shared Stock для WooCommerce — один залишок для кількох карток товару без перепродажу

Shared Stock для WooCommerce — плагін для магазину, який продає одну фізичну річ кількома картками. Та сама сорочка окремо й у подарунковій коробці, рулон тканини під кількома назвами кольору, товар у двох каталогах, річ окремо й у наборі. WooCommerce рахує залишок кожної картки окремо, тож власник магазину виправляє цифри вручну — і все одно продає останню одиницю двічі.

Shared Stock об’єднує такі картки в пул — одну цифру залишку, з якої продають усі вони. Продаж будь-якої картки знімає з пулу, а кожна картка показує, скільки пул ще може покрити. Два покупці, які в ту саму секунду оформлюють різні картки одного пулу, не заберуть «останню одиницю» обидва. Товар лежить на кількох складах? Парний модуль Multi Warehouse розкладає залишок по складах — вони працюють разом.

Як це виглядає для покупця

Кожна картка пулу показує той самий залишок — скільки пул ще може покрити. Покупець кладе в кошик сорочку, потім сорочку в коробці: якщо разом це більше, ніж є, він дізнається про це одразу — при додаванні в кошик, на сторінці кошика або в блоковому чекауті, а не після оплати.

Коли пул закінчується, усі його картки разом стають «Немає в наявності», а після поставки — знову «Є в наявності».

Що отримує адмін

Розділ WooCommerce → Shared Stock → Stock pools: список пулів із залишком, скільки утримують неоплачені замовлення і скільки доступно. Новий пул із нулем бере залишок першого доданого товару.

На екрані пулу — «Set to» (встановити залишок) і «Add or take» (додати або зняти відносно поточного: поставка на 10 одиниць, оформлена поки йдуть замовлення, не загубиться), перейменування, ресинк карток, список карток і додавання товарів пошуком. У Pro там же — одиниці на продаж, поріг листа «мало на складі», масове додавання всіх варіацій або списку SKU й історія кожної зміни з джерелом (замовлення, скасування, повернення, редактор товару, REST API, WP-CLI), номером замовлення й користувачем, з експортом у CSV.

Додати товар у пул можна й з картки товару чи варіації: на вкладці Inventory з’являється поле «Shared stock pool». Цифра, введена в будь-яку картку пулу — у редакторі, швидкому чи масовому редагуванні, через REST API чи імпорт, — стає залишком усього пулу. У списку товарів картки пулу мають позначку «Shared: …».

Pro: упаковки, вага, журнал пулу

Одиниці на продаж. Упаковка з 6 пляшок знімає з пулу 6, поодинока пляшка — 1; продаж по пів кілограма знімає 0,5 кг. Кожна картка показує, скільки цілих продажів пул ще може покрити: при 13 пляшках — 13 поодиноких або 2 упаковки. Історія записує кожну зміну пулу із джерелом, замовленням, користувачем і залишком після неї, з експортом у CSV. Листи: «мало на складі» з порогом на кожен пул і «закінчився». Масове додавання: усі варіації варіативного товару або список SKU за раз.

Разом із Multi Warehouse

Якщо товар лежить на кількох складах, Multi Warehouse для WooCommerce розкладає залишок кожної картки по складах, а Shared Stock тримає однаковою цифру всіх карток пулу. Ми перевірили їх разом: 42 перевірки сумісності на кожному прогоні (HPOS увімкнено й вимкнено, PHP 7.4 і 8.3), одночасні чекаути вісьмох покупців, повернення й скасування — склади, картки й пул після кожного кроку збігалися.

Одне обмеження: Multi Warehouse не знає, що картки пулу — одна річ, і розклад по складах у кожної картки свій. Розклад по складах ведіть на одній картці пулу; решта карток фактично тримають залишок на основному складі — коли продається одна картка, у інших цифра знімається з основного складу, далі зі складів за пріоритетом, без мінусів. Самовивіз Multi Warehouse для інших карток пропонує склади за їхнім власним розкладом.

Як це працює — крок за кроком

1. Ви створюєте пул і додаєте в нього картки. Кожна картка починає показувати залишок пулу.
2. Покупець оформлює замовлення. Під замком бази модуль перевіряє, що пул покриває замовлення з урахуванням того, що вже утримують неоплачені замовлення всіх карток пулу, і утримує одиниці. Паралельні чекаути того самого пулу йдуть по черзі; довше 10 секунд черги (налаштовується) — покупець бачить «спробуйте ще раз».
3. Коли WooCommerce списує залишок (оплата, «В обробці», «На утриманні»), модуль замінює списання картки одним відносним записом у пул, і всі картки отримують нову цифру.
4. Скасування, невдала оплата, повернення з рестоком чи правка замовлення менеджером повертають одиниці в пул.
5. Раз на добу модуль вирівнює картки за цифрою пулу — на випадок плагіна, що пише залишок прямо в базу.

Що перевірено, а що ні

Модуль протестовано наскрізно в локальному стенді: nginx + PHP-FPM з п’ятьма воркерами (справжня паралельність), PHP 8.3 і 7.4, MariaDB 10.11, HPOS увімкнено й вимкнено — 71 перевірка на прогоні плюс гонка вісьмох покупців на пул із трьох одиниць: у кожному з 10 раундів оформлено рівно 3 замовлення, жодного продажу понад пул. Не перевіряли: MySQL 8, Redis чи Memcached як об’єктний кеш, CSV-імпорт WooCommerce, REST API і швидке редагування через справжні форми (форму товару в браузері — так). Справжній ліцензійний сервер і тріал у тесті не брали участі. Німецькі переклади носій мови не вичитував.

Що під капотом

• Пул — у власній таблиці. Реальна цифра живе в пулі й завжди читається з бази, не з кешу; картки оновлюються штатними функціями залишку WooCommerce, які самі чистять кеші товарів.
• Відносні записи. Продаж, скасування й поставка змінюють пул одним відносним UPDATE, тож одночасні зміни не перетирають одна одну. У тесті 12 одночасних оплат на пул із 20 лишили рівно 8.
• Резерв на рівні пулу. WooCommerce резервує залишок окремо для кожного товару, тож дві різні картки одного пулу могли б в ту саму секунду взяти «останню одиницю». У тесті без модуля WooCommerce на пулі з 1 одиниці дав 2 резерви з 6 спроб, з модулем — рівно 1.
• Утримання до списання. Утримання оплаченого замовлення рахується, доки WooCommerce фактично не списав залишок, — це закриває вікно, коли замовлення вже оплачене, а залишок ще не знято.
• Картки завжди керують запасами. Якщо зняти «Керування запасами» з картки пулу, ресинк увімкне його знову.
• Видалення прибирає таблиці, налаштування й крон; картки лишають собі цифру, яку показували.

Як встановити

1. Завантажте безкоштовну версію catcode-shared-stock-for-woocommerce-free-1.0.0.zip кнопкою вгорі сторінки (або Pro-архів з кабінету після оплати): Плагіни → Додати новий → Завантажити плагін → Встановити → Активувати.
2. Перевірте, що в WooCommerce → Налаштування → Товари → Наявність «Утримання запасу (хв.)» більше 0.
3. WooCommerce → Shared Stock: створіть пул і додайте в нього картки однієї речі — на екрані пулу або полем «Shared stock pool» у картці товару чи варіації.
4. Встановіть залишок пулу або залиште 0 — тоді пул візьме залишок першої доданої картки.
5. Для Pro: вставте ліцензійний ключ із листа після оплати або натисніть «Try Pro for 7 days» у розділі «Pro licence».