• Contents

Connecting Cin7 to WooCommerce

Last updated 25/02/2021

Required steps to connect WooCommerce and Cin7 accounts.

Obtaining your WooCommerce API Key and Secret

Before you can connect WooCommerce to your Cin7 account, you must first obtain your API Key and Secret. The API credentials should be generated by an admin or a user with read and write permissions for products and orders in WooCommerce.

SSL Requirement

Connecting Cin7 to WooCommerce requires a valid SSL certificate. See the WooCommerce SSL and HTTPS documentation for additional information.

To obtain an API Key and Secret:

  1. Login to your WordPress Site.
  2. Select WooCommerce > Settings > Advanced.
  3. Select Legacy API > Enable the legacy REST API.
  4. REST API > Add key.
  5. Follow the instruction to create an API Key and Secret.

Adding WooCommerce to your Cin7 account

Once you have retrieved this information, you will need to add the WooCommerce module to your Cin7 account.

To add the module:

  1. While logged in as an Administrator, from the left navigation, select App Store.
  2. From the App Store, select Ecommerce then select WooCommerce.
  3. Select Request app installation.

Cin7 Customer Success will receive the installation request and provide an update once completed.

Connecting the two accounts

Next, connect the two accounts using the details obtained earlier.

  1. Log in to Cin7 using your Administrator account.
  2. Select your username, top right, and select Settings.
  3. Under Integrations, select WooCommerce.
  4. Insert your Shop Host Name in the field provided.

    Make sure you remove the https:// part of the URL

  5. Insert the API Key and Secret which you generated in the first step.
  6. Select the correct Auth Type. For more information see Authentication over HTTPS.
  7. Select Finish at the bottom of the page to save the module settings.

On your WooCommerce dashboard in Cin7, select the Test Connection button to test the connection. If your API credentials are invalid,it will display an error message. If your connection status says "Legacy (version 3) API", contact Cin7 Support to switch to the latest version.


Which versions are supported?

The Cin7 integration uses API Legacy version 3 (WooCommerce 2.4.x or later) and API version 2 - (WooCommerce 3.0.x or later) and API version 3 - (WooCommerce 3.5.x or later - recommended).

Go to WooCommerce > Status. There should be a green check next to "API enabled".

If you are not on the latest API version, you will need to contact your WooCommerce developer or host to find out how you can upgrade.

I have connected WooCommerce to Cin7 but none of the actions work.

Check that you have the most up to date version of the WooCommerce API; you can check this in your WordPress Admin screen.

You may also see the error "Error: Cannot access child value on Newtonsoft.Json.Linq.JValue."

This is an indication that you are not on the latest WooCommerce API version.

You will need to contact your WooCommerce developer or host to find out how you can upgrade.