Kitgenix Stock Sync for WooCommerce

Running multiple WooCommerce stores often creates the same operational problem: stock drift. You update stock on one site, but another site still shows the old quantity. That can lead to oversells, customer frustration, and messy fulfilment. Kitgenix Stock Sync for WooCommerce solves this with a secure, practical model:

• One Master store holds the authoritative stock state.
• One or more Child stores receive updates from the Master.
• Stores communicate over signed REST requests (HMAC SHA-256) with timestamp + nonce replay protection.

This plugin is designed to be lightweight:

• No third-party SaaS.
• No custom database tables.
• Uses WooCommerce + WordPress primitives (REST API, options, product meta, transients, WooCommerce logging, Action Scheduler).

What this plugin syncs Stock state is synced per SKU, including:

• stock quantity
• stock status
• backorders
• low stock amount Note: this plugin is focused on inventory syncing. It does not sync pricing, product content, images, or orders.

How it works (high level)

1. Stock changes are captured on each store using WooCommerce stock hooks.
2. Children send events to the Master; the Master applies incoming events locally and then pushes authoritative stock state out to all enabled children.
3. The Master can also run a Reconcile operation to push stock state for all products in batches.

SKU rename sync (important) This plugin supports SKU renames by maintaining an internal, stable identifier (a “GID”) stored as product meta:

• _kitgenix_stock_sync_for_woocommerce_gid When SKUs change on the Master, the plugin emits a sku_rename event using the GID so child stores can map the update safely.

Tip: Run Reconcile on the Master after initial setup. Reconcile establishes stable GIDs for products that don’t already have one, which makes SKU rename sync reliable. Strict checkout validation (Child) Child stores can optionally enable Strict checkout validation:

• During checkout, the child queries the Master’s stock for SKUs in the cart.
• If the Master reports the SKU is out of stock or insufficient (with backorders disabled), checkout is blocked.
• If the Master can’t be reached, validation is fail-open to avoid breaking checkout.

Exclusions You can exclude SKUs (comma or new line separated). Excluded SKUs are ignored for:

• outbound stock events
• reconcile batches
• strict checkout validation
• audit checks

Tools & diagnostics included From the plugin admin screen:

• Test Connection (ping the configured store)
• Reconcile (Master): push authoritative stock state to all children in batches
• Manual SKU Sync (Master): push a specific set of SKUs to all children
• Audit Children (Master): query each child’s local stock fields and compare against the Master
• Event Log + Backlog: see recent events and failed pushes, and clear logs when needed
• Status: last inbound/outbound health timestamps and last error message

1.0.2 (19 March 2026) Update: Improved the Kitgenix admin header layout for better alignment and less clutter. Update: Social links in admin headers now render as compact icon buttons (with accessible labels). Update: Added responsive header helpers so titles/description and actions/links lay out consistently. Fix: Added defensive notice normalization to keep WordPress admin notices above the Kitgenix header. Update: Admin tables inside Kitgenix pages now use Kitgenix styling for a more consistent branded look. Fix: Added spacing between adjacent action links/buttons (e.g., Edit/Delete). Fix: Escaped shared Kitgenix hub card media output for WordPress coding standards compliance. Maintenance: Updated the plugin Author URI to the public Kitgenix WordPress.org profile and replaced the old custom admin-menu icon CSS with the native Dashicons icon. 1.0.1 (18 February 2026)

• Tweak: Clarified uninstall behaviour (plugin settings + transients are removed; WooCommerce product meta and Action Scheduler data are retained).
• Dev: Updated translation template metadata.

1.0.0 (14 February 2026)

• New: Initial release.
• New: Master + child stock sync via signed REST events.
• New: Strict checkout validation on children (optional).
• New: Master tools: reconcile, manual SKU sync, and audit.
• New: Event log and backlog with retries via Action Scheduler when available.