Overview
- This article outlines some of the common errors you could experience while using the DHL Express Commerce/WooCommerce integration and how to resolve them.
Error: Unsuccessful - The remote server returned an error: (400) Bad Request.
If you test the connection and get this error, you may need to enable permalinks. To do this:
- In your WooCommerce account, select Settings, then select Permalinks.
- Under Common Settings, select Post name.
- Click Save changes.
- In your DHL Express Commerce account, go to Settings, then select Integrations.
- Select Settings next to WooCommerce.
- Scroll down and click Test to ensure it works.
You should get a successful result. If you continue to receive an error, please contact our support team.
Error when importing WooCommerce orders
If you get an Unsuccessful 404 error when trying to import orders, you may need to check your store URL.
- Check your domain URL with http://.
- If your browser gets redirected to https://, test your integration with your consumer key and secret, e.g. https://www.YOURSTORE.com/wc-api/v2/orders?consumer_key=XXXXXXX&consumer_secret=XXXXXXX
- If you can see a list of orders, go to your DHL Express Commerce account > Settings > Integrations > WooCommerce.
- In the URL field, change your URL to start with https://.
- Test to ensure the connection works. You should get a successful result. If you continue to receive an error, please contact our support team.
- If you get a successful result with the above test but the connection in DHL Express Commerce is stating unsuccessful, please disable Bot Fight Mode with your CloudFlare in WooCommerce.
Error: Unsuccessful - The underlying connection was closed: The connection was closed unexpectedly
If you test the connection and get this error, add the following content into the Custom Request Headers field:
user-agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/72.0.3626.119 Safari/537.36
Error: Writeback failing with 401 error
This means that we do not have the proper authentication to update your orders. Try ticking the Use consumer key and secret as query string parameters option. This usually bypasses many of the security/firewall issues a server may be having with processing the authorisation
Error: Writeback failing with 403 error
This means we do not have the proper permissions to update your orders in your store. Make sure the API key has both read and write permissions.
Also ensure that the user you have assigned is a stand alone user with admin permissions.
Error: Unsuccessful - Unexpected character encountered while parsing value
This can occur if your store domain name is incorrect.
- In DHL Express Commerce, navigate to Settings > Integrations > WooCommerce Settings.
- Under the URL field, make sure that your store domain starts with http or https.
i.e. https://yourstore.com - Remove any trailing paths e.g. https://yourstore.com/shop/