How the engine works

Two background jobs do the work, both run by WooCommerce’s Action Scheduler: the sync job (supplier, stock, prices, new products) and the content job (text and image checks for new products). They run separately, so a slow AI call never delays stock updates.

The sync job

  • When: every hour (if automation is on), when you click Sync supplier now, and as automatic follow-up runs.
  • Follow-ups: each run works for about 20 seconds; if the catalog is not finished it continues 5 seconds later until every page is done.
  • Retries: if the supplier fails, it retries after 5, 15 and 45 minutes, resuming at the failed page; then the next hourly run takes over.
  • One at a time: a lock prevents two syncs from overlapping.

For each supplier product

  1. Data check: ID, SKU, name, category, a positive cost, whole-number stock and the shop’s currency. Otherwise the product is Blocked with the reason.
  2. Price: (cost + additional cost) ÷ (1 − margin ÷ 100), rounded up to the cent. Example: cost 20 at 30% margin = 28.58.
  3. New products wait under Needs review. They are blocked instead if the SKU belongs to one of your own products, or if the category is missing and category creation is off.
  4. Live products get stock, stock status, visibility and price updates. A price change above your limit goes to Price check and keeps the old price until you approve it.
  5. Live products whose data turns invalid are blocked and hidden until the data passes again.
  6. Changed text, category or images send a new product back to content checking.

After a complete scan

Products the supplier no longer lists become Delisted: hidden and set out of stock, and restored automatically if the supplier lists them again. Delisting happens only after a scan that started at the first page. If more than half of the catalog disappears at once (a likely supplier outage), nothing is hidden and a warning is logged.

The content job

Checks new products in batches (default 10 per run, about 25 seconds), continuing automatically. See AI and content checks.

Product statuses

Needs review New product with valid data. Nothing exists in WooCommerce until it is approved.
Live Published. Every sync updates stock, visibility and price.
Price check Live, but the new price is beyond your limit. Stock keeps syncing; the price waits for approval.
Blocked Failed a data check (bad data, SKU clash with your own product, missing category).
Delisted No longer offered by the supplier; hidden and out of stock until it returns.
Rejected You rejected it. It stays rejected on later syncs; you can still approve it.

Was this article helpful to you?

Nieuwsbrief

Blijf op de hoogte

Ontvang meldingen over nieuwe plugins, updates en exclusieve tutorials.

Geen spam ooit. U kunt zich op elk moment uitschrijven.