In this article, learn about common issues that occur when connecting to WooCommerce from Shippo, and different troubleshooting methods to solve your issue.
|
Note: If your orders are not syncing between your WooCommerce store and Shippo, please first disable any new plugins you may have enabled. We have seen several cases where an improperly-configured plugin caused syncing issues with Shippo. Unfortunately, there is nothing we can do in these cases other than recommend disabling that plugin. |
Troubleshooting Checklist
- Verify that the store URL is the base URL of the store. It should not have added paths like /admin, be misspelled, etc. Confirm you are entering the appropriate http vs. https for your site.
- Your site must be live to properly connect.
- Latest version of the WooCommerce plugin is required. It must be version 2.6 or higher to work with Shippo.
- Verify your credentials. Occasionally wrong credentials will be accepted by the setup screen, but the order sync will not work. No error will be shown.
- Check that the role of the account used to connect with Shippo has the role "Administrator"
- 5b. Check that the permissions for the account used to connect with Shippo have the "Read/Write" permission
- If you are getting 404 or 403 errors, these errors typically mean there is a problem with permissions or routing. If you're getting 404 errors, please check your .htaccess file to make sure you can access your WooCommerce installation at the URL you provided to Shippo. If you're getting 403 errors, please check the permissions of the files on your server to make sure they can be accessed via the web.
- Enable REST API in your WooCommerce plugin.
For the WooCommerce plugin version 3.6.4, the REST API is located under Advanced Settings
-
- From your WordPress Admin page, click on WooCommerce and then Settings in the left navigation panel
- Click on the Advanced tab and then click on Legacy API
- The box for Enable the legacy REST API should be checked
For older versions of the WooCommerce plugin, the REST API is located under the API tab
- From your WordPress Admin page, click on WooCommerce and then Settings in the left navigation panel
- Click on the API tab
- The box for Enable the REST API should be checked
Rest API
Check your REST API settings by visiting the version end-point by adding /wp-json/wc/v1 to your store URL (this path depends on your store configuration). In the page header of your response, you need to check HTTP response and Content-Type. You should receive a HTTP response 200 and Content-Type application/json.
Below is an example using “curl” to get the page header of the version end-point.
"$> curl -I http://mystore/wp-json/wc/v1
HTTP/1.1 200 OK
Date: Tue, 04 Apr 2017 16:52:17 GMT
Server: Apache
..
..
Allow: GET
Vary: Accept-Encoding
Content-Type: application/json; charset=UTF-8"
Permalinks
Verify your "permalinks" in Wordpress are set up correctly. Go to your Wordpress settings, click Permalinks, and make sure it's set to "Post Name." You can only use Shippo if your permalinks are set to "Post Name."
WooCommerce High-Performance Order Storage System
Please note that Shippo is not yet compatible with WooCommerce's new High-Performance Order Storage System. Please ensure that this feature is disabled so that Shippo is able to access your order data to import orders and send tracking data back after label creation.