Connect Your WooCommerce Store

WooCommerce is an open-source eCommerce plugin for WordPress. It is designed for small to large-sized online merchants using WordPress. This article will go over how to connect your WooCommerce store with Easyship.

About the Connection

With WooCommerce connected to Easyship, you will be able to:

  • Utilize the rates at checkout feature, and customize how shipping services are displayed by altering store settings, as well as configure which options to show customers by creating shipping rules.
  • Sync orders directly from your store to be fulfilled. 
  • Download products directly.
  • Automatically marks store orders as fulfilled when a label is generated. The tracking number will sync to the order profile. 

Video Guide


Download/Update Easyship plugin

Download the Easyship Plugin on the WooCommerce Plugin Page (Plugins > Add New).

Always make sure that you are running the latest version. You can enable auto-updates by going to Plugins > Installed Plugins > Enable Auto-Updates. 


Make sure that the Permalink Settings are not Plain, if plain is enabled it will cause errors when syncing to Easyship. Feel free to choose any of the other options.

This is found under Settings > Permalinks as can be seen below. 


Enable Easyship on WooCommerce

Go to the Settings > Easyship tab Click on Enable and go through the process.


NOTE: Please do NOT create an API integration from the Easyship Dashboard. API Integration keys are not designed for direct API connections such as WooCommerce. Doing so will lead to a failed connection.  Screenshot below:


Orders Syncing to Easyship

Easyship won't sync existing orders when you create your store.
Easyship won't sync orders that are from excluded countries in your Easyship settings.
Easyship will only sync orders that are in the status Processing on Woocommerce.

Tracking Information

When an order is fulfilled, the tracking number will be added as a note in Woocommerce.

There is a plugin that can be installed; which will update your orders with the information as per below.

Setup Shipping Zones

Ensure Easyship is added as a Shipping method in your Shipping zones. 

Base Location 

Ensure the Base Location in WooCommerce is that of the origin country associated with your Easyship account. If you are shipping from Hong Kong, it needs to be set to Hong Kong, as shown below.


Not Showing Couriers in Checkout 

If experiencing trouble syncing your orders, we recommend that you try to remove the added store inside Easyship and re-installing the plugin. 

If this does not work, kindly try to disable any other 3rd party plugins before reinstalling Easyship.
In some cases, other plugins may interfere with Easyship's settings, causing no shipping solutions to be shown during Checkout. 

One example is Whole Sale Suite, this plugin requires you to change the setting in; 

WooCommerce > Settings > Wholesale Prices > Shipping > Wholesale Only Shipping 

Under Methods;
The setting Hide the mapped shipping methods from non-wholesale customers must be deactivated, otherwise, you may hide shipping solutions provided from Easyship during checkout. 
WooCommerce is Open-Source and has several hundreds of plugins, please ensure compatibility by enabling them one after one after having installed Easyship as your first plugin. 
This will make it easier for you to find out if any of them are causing issues with Easyship's Plugin. 

Company Phone Number Appearing as Receiver Phone Number Upon Syncing 

If the order doesn't have the receiver's phone number, then it will fall back to the company's phone number.


Error Messages On/From WooCommerce Checkout or Easyship Dashboard 

Case 1: The message indicates that products on Easyship aren't saved with dimensions and weight, make sure that the product settings on Easyship are accompanied by actual numbers. 



Case 2:  If you are met with the below error message when configuring your store's default settings on Easyship, please contact your tech team to install an SSL Certificate for your site. 

Enable Button Not Working 

Step 1: Paste ANY string (E.G: '12345678') in the Easyship Access Token field, click Save changes.


Step 2: Clean up Easyship Access Token (delete it) and click Save Changes again.


Step 3: Click Enable, and you should be redirected to the Easyship connection page for setup. 


Deactivate Easyship Plugin Not Working 

Step 1: Go to Plugins > Easyship settings. 


Step 2: Make sure the Easyship Access Token field is blank (delete it), then click Save changes.


You should now be able to reconnect Easyship by clicking Enable. Note: You may need to refresh the page (CTRL + R) to see an empty token field)

The Plugin Is Installed Successfully, but the Request Timed Out

Your wp-config.php may have WP_HTTP_BLOCK_EXTERNAL set as true. You will need to add https://* url to your WP_ACCESSIBLE_HOSTS settings in order to allow requests to go to the Easyship API server.

Was this article helpful?
5 out of 18 found this helpful
Popular Topics