WooCommerce's flexibility and extensive plugin ecosystem make it an excellent e-commerce platform, but these same features can create integration challenges. This guide covers the most common issues you may encounter when connecting your WooCommerce store with Unleashed and provides step-by-step solutions.
Important: Before attempting any integration, please review the WooCommerce Integration Setup guide to ensure proper configuration.
Store URL Connection Issues
Problem: Unable to connect to your WooCommerce Store.
Cause: Incorrect URL format in the Store URL field.
Solution:
Go to eCommerce Hub > WooCommerce.
Remove
https://from the beginning of your store's URL.Remove any trailing slashes
/or/storepaths.Enter only the domain name.
Examples:
Incorrect:
https://woo1.unleashed.kiwi/Correct:
woo1.unleashed.kiwiCorrect:
www.awesomeurl.com
Additional Requirements:
For a secure connection, your store site must use HTTPS.
Non-HTTPS sites are not supported.
404 Errors
Problem: Receiving 404 errors when connecting to a WooCommerce store.
Cause: WordPress permalink structure is set to "Plain".
Solution:
Log in to your WordPress admin dashboard.
Navigate to Settings > Permalinks.
Select any permalink structure except "Plain".
Click Save Changes.
Important: Consult with your store administrator before making permalink changes, as this may affect existing URLs and SEO.
Problem: 404 errors during bulk product export from Unleashed to WooCommerce.
Cause: A large number of "sellable" products overwhelm the server during initial sync with WooCommerce.
Solutions:
Option 1 - Temporary Server Upgrade (Recommended):
Contact Unleashed support.
Support will work with your hosting provider to temporarily increase server capacity.
Complete the full integration once capacity is increased
Option 2 - Manual Product Addition:
Manually add products to your WooCommerce store.
The integration will automatically attempt to sync to the added products.
Sales Orders will import and establish missing product mappings.
Stock levels will sync in real-time once mapping is established.
Stock Level Export Issues
Problem: Stock quantities are not updating in WooCommerce.
Cause: The "Manage Stock Level" setting is disabled in the affected WooCommerce products.
Solution:
Log in to your WordPress admin dashboard.
Go to WooCommerce > Products
Open the affected product.
Scroll to the Product Data section.
Click the Inventory tab.
Check the "Manage stock level" checkbox.
Click Update to save changes.
The Stock Quantity field will update on the next stock export from Unleashed.
Order Import Issues
Problem: Orders failing to import due to Wordfence security.
Cause: Wordfence firewall is blocking Unleashed's IP addresses.
Solution:
Access your WooCommerce admin dashboard.
Navigate to Wordfence > Firewall > All Firewall Options.
Scroll to Whitelisted IP addresses.
Add the following Unleashed IP addresses:
13.236.30.203.105.186.323.104.150.228
Save the changes.
📌 Note: These IP addresses may change over time. Review and update your whitelist periodically. For detailed Wordfence configuration, see the Security for WooCommerce documentation.
Guest Customer Order Failures
Problem: Guest customer orders are failing to import from WooCommerce.
Cause: The "Guest Customer" entered in the WooCommernce configuration does not match an existing Customer Code.
Solution:
In Unleashed, go to eCommerce Hub > WooCommerce.
In the Configuration tab, go to the "Guest Account Mapping" field.
Re-enter the selected guest customer, using an existing Customer Code.
Save changes.
Order Status and Stock Issues
Problem: Orders are importing as "Parked" instead of "Completed".
Cause: Insufficient stock in Unleashed to fulfil the order, when the "Order Import status" is set to "Completed".
Solution:
Increase stock levels in Unleashed for the required products.
Manually complete the parked Sales Order in Unleashed.
Subsequent Sales Order orders will import as expected when sufficient stock is available.
Tax Exclusive Pricing Error
Error Message: "Reject the order import because the order is not price include tax"
Cause: WooCommerce store configured for Tax Exclusive pricing
Solution:
Access your WooCommerce admin dashboard.
Go to WooCommerce > Settings > Tax.
Ensure "Prices entered with tax" is set to "Yes, I will enter prices inclusive of tax".
Update tax settings for all product categories if needed.
Save changes.
Tax Code Error
Error Message: "Unable to Import order. Tax with Code XXX and Rate XXX % not found in Unleashed".
Cause: Tax codes and rates don't match between WooCommerce and Unleashed
Solution:
Note the specific tax code and rate from the error message.
In Unleashed, navigate to Settings > Taxes.
If you are not integrated with an accounting provider, create a new tax code matching the WooCommerce settings.
If you are integrated with an accounting provider, create a new tax in your accounting provider and sync it with Unleashed.
Ensure tax rates are identical between both Unleashed and WooCommerce.
Reattempt importing the WooCommerce Order.
For detailed tax management in Unleashed, see Taxes.
Best Practices
Regularly review your integration settings after WooCommerce updates.
Test integrations in a staging environment before applying to production.
Keep tax codes synchronized between both systems.
Monitor the Connection Log for early warning of issues.