Troubleshooting

"API token not configured"

No token is saved. Go to JDS Sync → Settings, paste your token, and select Test Connection before saving.

Test Connection fails

• Confirm the token is copied whole, with no leading or trailing spaces
• Confirm the token is still valid in your JDS account
• Confirm your server can reach api.jdsapp.com — a firewall or security plugin blocking outbound HTTPS will fail here

"WooCommerce is not active" / "FluentCart is not active"

The platform selected in Settings isn't the one running. Check the Platform Status panel at the bottom of the Settings screen — it shows what the plugin actually detects — and either activate that platform or change the selection to match.

Products not importing

1. Verify the token with Test Connection
2. Confirm the SKUs are valid — a typo returns nothing for that line
3. Confirm your store platform is active and matches your setting
4. Check the Sync Log for errors

If some SKUs import and others don't, the failing ones are almost always invalid or discontinued rather than a plugin fault.

A large import stalls partway

Imports run in batches over AJAX. Two things stop them:

• Navigating away. Leave the tab open until it reports completion. Products processed so far are kept; the rest simply never ran.
• Server limits. Tight max_execution_time or memory limits on shared hosting can end a batch early. Import in smaller groups.

Re-running an import is safe — products match on SKU, so re-importing updates rather than duplicating.

Stock not updating

1. Confirm Enable Auto Sync is on
2. Confirm the cron event is registered — wp cron event list should show jds_sync_stock_update
3. Check the Sync Log for errors
4. Run Manual Stock Sync to test the path independently of the schedule

If the manual sync works but the schedule doesn't, the problem is cron, not the plugin.

A quiet site runs cron late

WordPress cron fires on page visits, not a real clock. A site with little traffic can run its sync hours late. For reliable timing, disable WP_CRON and trigger wp-cron.php from a server cron job.

Sync log is empty

The log records scheduled runs only. Manual stock syncs report on screen and aren't logged. An empty log means no scheduled run has completed yet — either auto sync is off, the interval hasn't elapsed, or cron isn't firing.

The log also keeps only the last 50 runs, so at short intervals older history rolls off quickly.

Images not loading

WooCommerce downloads images into your media library. If they're missing:

• Check permissions on wp-content/uploads
• Check available disk space
• Confirm your server can reach res.cloudinary.com

FluentCart stores external Cloudinary URLs rather than copying files. If they're missing:

• Confirm your site can load external images — some security plugins and CSP rules block third-party image hosts
• Check allow_url_fopen on your server

Prices are wrong after changing markup

Changing the markup or tier does not reprice existing products on its own. Save the settings, then select Update All Product Pricing on the Settings screen.

If prices still look wrong, confirm you saved before selecting the button — it reads stored values, not what's on screen.

Margins look wrong on FluentCart

FluentCart's cost field is populated with the tier price before markup. If your reported margin looks off, the usual cause is a Wholesale Price Tier that doesn't match what you actually pay — selecting a 40-case tier while buying single units makes cost look lower than reality.

"Permission denied"

Every screen requires the manage_options capability. You need to be an Administrator.

Still stuck

Enable Error Notifications in Settings so failures reach you by email, then check the Sync Log for the specific error. See Support for what to include when you get in touch.