ProductSync Free 1.0.3 candidate

Preview WooCommerce stock changes from a CSV

This walkthrough reflects the submitted Free build, which is awaiting WordPress.org review. Use dummy products on an isolated copy if you have an authorised test build.

1. Prepare a small supplier-style CSV

Use UTF-8 and distinct SKU and stock headers. Give the test store two products with the exact sample SKUs below. Use a suitable HTTPS source with a complete file and a Content-Length header. Keep supplier tokens and real inventory data out of the fixture.

2. Map the headers and protect one product

In Settings โ†’ ProductSync โ†’ Stock Feeds, set the URL, delimiter and exact header names. Leave Automatic off. Under Protected products, protect DEMO-002 before previewing. A protected stock-managing parent also covers variations sharing that quantity.

3. Run Preview before writing stock

Choose Preview stock changes. DEMO-001 should show a proposed absolute quantity of 12 if its current quantity differs. DEMO-002 should be skipped because it is protected, even though the file explicitly says zero. A Preview does not update WooCommerce stock.

4. Confirm only the batch you reviewed

Set the source to Active and generate a fresh preview. Confirm Apply for the displayed batch. Each confirmed request processes at most 100 pending items. If more remain, review and confirm the next batch within the 15-minute preview period. Keep Automatic off for the walkthrough.

5. Check the actual quantities and Logs

Compare WooCommerce stock with the run details in Logs. Verify that the protected item kept its original stock. If a run reports an uncertain write, inspect the current WooCommerce quantity before deciding what to do. Do not blindly replay it.

Example CSV

sku,stock
DEMO-001,12
DEMO-002,0