Multi-Store Stock Sync для WooCommerce — спільні залишки кількох магазинів

Multi-Store Stock Sync для WooCommerce — плагін для тих, хто продає ті самі товари на двох і більше сайтах WooCommerce: роздрібний і оптовий домен, магазини різними мовами, другий бренд, окремий сайт під маркетплейс. Склад один, отже й залишок має бути один. Без синхронізації менеджер вручну переписує цифри між адмінками, а покупець оплачує товар, якого вже немає.

Плагін робить один сайт майстром: його залишки — правда. Решта сайтів — сателіти, вони йдуть за майстром за артикулом (SKU). Продаж, скасування, повернення на склад чи ручна правка на будь-якому сайті за кілька секунд з’являються на всіх інших.

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

Покупець бачить правильну наявність на будь-якому сайті мережі — і більше нічого. Купили останні дві пари на оптовому сайті — через кілька секунд роздрібний сайт показує «Немає в наявності». Замовлення скасували — одиниці повернулись на всі сайти.

• Оформлення не гальмує. Під час чекауту плагін нічого не відправляє: зміна лягає в чергу, а доставка йде у фоні одразу після запиту.
• Варіації теж. Розмір і колір синхронізуються окремо, як і товари, у яких склад ведеться на батьківському товарі.
• Товари без обліку запасів отримують статус наявності: «Немає в наявності» на майстрі — те саме на сателітах.

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

Сторінка WooCommerce → Multi-Store Sync з чотирма вкладками: підключення, журнал синхронізації, звіт за артикулами, налаштування.

• Підключення за хвилину. На майстрі — «Додати сателіт», скопіювати ключ; на сателіті — вставити ключ і «Підключитися». Одразу після підключення сателіт звіряє каталог і бере залишки майстра для кожного збіглого артикула.
• Стан кожного сайту: остання успішна відповідь, остання помилка, скільки змін чекає в черзі. Кнопки «Перевірити з’єднання», «Надіслати всі залишки», «Призупинити», «Видалити».
• Журнал пише, що, куди й з яким результатом пішло: продаж −2 із замовлення №1078, залишок тепер 19. Фільтр за рівнем, сайтом і артикулом; строк зберігання задаєте ви (30 днів за замовчуванням).
• Звіт за артикулами показує товари, які є лише з одного боку, — зазвичай це помилка в артикулі, яку інакше шукали б тижнями.

Pro: ціни, відгуки, автозвірка, сповіщення

• Ціни за роллю сайту. Для кожного сателіта — джерело ціни (звичайна ціна майстра або окремий прайс, наприклад «Опт»), коефіцієнт (1.2 = +20%, 0.9 = −10% або курс валюти), кількість знаків після коми. Прайс — це поле в картці товару й варіації на майстрі.
• Акції. Або сателіт отримує акційні ціни майстра з датами, або лишає власні акції — на ваш вибір для кожного сайту. Якщо нова ціна від майстра не вища за власну акцію сателіта, її не застосовано, а обидва журнали пишуть чому — акція мовчки не зникне.
• Межі: ціни лише для обраних категорій, а окремий товар можна виключити галочкою «Не надсилати ціну» в його картці.
• Відгуки про товар ходять між усіма сайтами за артикулом: з оцінкою й позначкою «перевірений покупець», без e-mail та IP автора, без дублів і без відлуння. Середній рейтинг перераховується.
• Щогодинна автозвірка сама виправляє розбіжності, які могли виникнути через збої, — без кнопки.
• Лист на пошту, коли сайт мережі перестав відповідати, і ще один — коли знову працює.

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

1. На сателіті сталася зміна: продаж, скасування, повернення на склад або ручна правка. Плагін записує її як точну різницю (−2, +1) з унікальним номером події.
2. Одразу після запиту фоновий обробник відправляє зміну майстру підписаним повідомленням.
3. Майстер застосовує різницю атомарним оновленням залишку WooCommerce. Повторна доставка тієї самої події нічого не змінить — вона списується рівно один раз.
4. Майстер розсилає всім сателітам нове число з версією. Старіша версія ніколи не перезапише новішу.
5. Значення, що прийшли з мережі, не відправляються назад — два сайти не можуть «перекидатися» тією самою зміною.
6. Якщо майстер недоступний, зміни чекають у черзі й повторюються з паузою від 30 секунд до години. Сателіт тим часом показує «залишок майстра плюс свої ще не відправлені зміни».

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

• Зміни, а не числа. Сателіт шле майстру різницю з унікальним номером події, а не «тепер тут 17». Так два одночасні продажі на різних сайтах не перетирають один одного.
• Рівно один раз. Номер події зберігається на майстрі; повтор тієї самої події через збій мережі повертає «вже враховано», а не списує товар удруге.
• Версії значень. Кожне число від майстра має мітку часу читання; сателіт відкидає застаріле значення, навіть якщо воно прийшло пізніше.
• Безпека. Кожне повідомлення підписане HMAC-SHA256, має мітку часу й одноразовий nonce; чужий підпис, старе повідомлення чи повтор відхиляються. Секрети в базі зашифровані. Ключ підключення видно лише в адмінці тим, хто керує WooCommerce.
• Нічого зайвого назовні. Між сайтами ходять лише артикули, залишки, статуси наявності (у Pro — ціни й відгуки без e-mail). Дані покупців нікуди не передаються, CatCode нічого не отримує.
• Серія продажів — одна відправка. Майстер позначає артикул «брудним» і читає залишок у момент відправки, тож десять продажів поспіль дають одне оновлення, пакетами до 100 артикулів.
• Прибирає за собою. Видалення плагіна прибирає його таблиці, опції й крон; залишки товарів лишаються як є.

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

1. На кожному сайті мережі: Плагіни → Додати новий → Завантажити плагін, оберіть catcode-multistore-sync-for-woocommerce-1.0.1.zip (Pro) або безкоштовну збірку й активуйте.
2. На сайті, де залишки сьогодні правильні, відкрийте WooCommerce → Multi-Store Sync → Налаштування і оберіть роль «Майстер (склад)».
3. На вкладці «Підключення» введіть назву сателіта, натисніть «Додати сателіт» і скопіюйте його ключ підключення.
4. На іншому сайті оберіть роль «Сателіт», вставте ключ і натисніть «Підключитися». Сателіт звірить каталог і візьме залишки майстра.
5. Перевірте «Звіт за артикулами» — там будуть товари, у яких не збігся артикул.
6. Для Pro: на майстрі вставте ліцензійний ключ з листа після оплати або запустіть 7-денний тріал. Сателіти отримають Pro від майстра автоматично.