Troubleshooting the WooCommerce integration

Troubleshooting the WooCommerce integration


Find and fix common errors in the WooCommerce integration quickly and effectively.



TABLE OF CONTENTS





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

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article