• Contents

Connecting Cin7 to WooCommerce

Last updated 21/09/2020

This article outlines the steps required to connect your 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. For more information please see this article about SSL and HTTPS.

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. Whilst logged in as an Administrator, from the left navigation,  click Integrations then App Store.
  2. From the App Store, select Ecommerce then click WooCommerce.
  3. Click Request App Installation.

Cin7 account managers will receive the request and will get in touch with you.

Connecting the two accounts


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

  1. Log in to Cin7 using your Administrator account.
  2. Click on 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. Click Finish at the bottom of the page to save the module settings.

On your WooCommerce dashboard in Cin7, click the refresh button next to the Connected label 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 to switch to the latest version.

FAQs

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 tick 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.