Troubleshooting the WooCommerce integration
Find and fix common errors in the WooCommerce integration quickly and effectively.
TABLE OF CONTENTS
- Troubleshooting the WooCommerce integration
- Introduction to troubleshooting
- Overview of common errors
- General troubleshooting tips
Introduction to troubleshooting
The WooCommerce integration consists of several parts that work together: API, product sync, webhook and order import.
If something does not work, it is usually caused by an error in the setup or missing configuration.
This guide helps you identify and resolve the most common problems.
Tip: Always start by checking the API connection and whether the modules are enabled.
Overview of common errors
Below you will find the most common errors and how to resolve them.
Missing categoryid
This error occurs when the top category is not set.
Solution:
- Go to the integration settings
- SetTop Category

Too many requests (429)
WooCommerce has a limit on API calls.
Solution:
- Wait and try again
- Reduce synchronisation
- Contact your hosting provider
NOTE: The system automatically retries several times before it fails.
Webhook errors
The webhook does not work or returns an error.
Possible causes:
- Wrong URL
- Wrong webhook key
- Webhook not active
Solution:
- Check the URL and secret
- Check the webhook status in WooCommerce

NOTE: The error "The authenticity of this request was not verified" means the key is wrong.
Products are not exported
Products do not appear in WooCommerce.
Check:
- Product sync enabled
- Top category set
- Product is in the correct category

Orders are not imported
Orders do not arrive in Telaris.
Check:
- Webhook works
- Order status is Processing or On-hold
- The API connection works
General troubleshooting tips
If you cannot find the error:
- Test the API connection
- Run a manual export
- Check the log in WooCommerce
- Confirm that all modules are enabled
NOTE: Many errors are caused by missing setup

Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article