Stock Discrepancies and Resolution

When WooCommerce reports a different stock quantity than Fulfiro has on record, a discrepancy is flagged instead of silently overwriting your data. This keeps you in control.

How discrepancies are detected

During sync and webhook processing, Fulfiro compares the WooCommerce stock quantity with its own InventoryLevel sum. If they differ, an alert is created. See Stock Consistency for the technical details.

Why Fulfiro does not auto-overwrite

Fulfiro is the source of truth. If someone manually changes stock in WooCommerce admin, that should be reviewed. The discrepancy might be intentional (you just did a count in Fulfiro) or accidental (someone edited the wrong product in WooCommerce). See Two-Way Stock Sync for the philosophy.

Resolving discrepancies

Go to the Alerts page and click the Sync Issues tab. Each discrepancy shows:

• Product name and SKU
• Fulfiro quantity
• WooCommerce quantity
• The difference

Click Resolve to choose:

• Keep Fulfiro's value -- Pushes Fulfiro's stock back to WooCommerce
• Accept WooCommerce's value -- Adjusts Fulfiro's stock to match

Both options create a stock movement record for the audit trail.