WooCommerce integration

Introduction

To connect your WooCommerce webshop to ChannelEngine, you are required to install our WooCommerce extension. This guide will explain how to install and configure the plugin.

Requirements

There is only one requirement to install the WooCommerce extension:

  • Requires: WordPress 4.4 or higher

Installing the extension

Our WooCommerce extension is offered via the official WooCommerce plugin manager. Installing and updating the extension using WordPress is easy. The installation is started by logging in in the WordPress Admin, opening the plugin page and press “Add new”. Use the “search plugins” box to find ChannelEngine, a “WooCommerce ChannelEngine” plugin will appear, which can be installed directly. It is also possible to install the plugin from  the WordPress website.

If desired, the source code for the plugin can also be found on  GitHub.

Configuration

The plugin can be configured by pressing the “settings” button (Figure 1) in the WordPress plugin list.

Figure 1: The WordPress plugin list

This opens the configuration (Figure 2) where the credentials such as account name & API key should be filled in.

Figure 2: The ChannelEngine plugin settings

These credentials are located in the  ChannelEngine environment on the Settings > Settings page. From this page, the fields Account Name and API Key(Figure 3) need to be copied into the WooCommerce plugin general settings.

Figure 3: Account Information as seen in ChannelEngine
Figure 3: Account Information as seen in ChannelEngine

Please note: in earlier versions of the plugin the ‘ API Secret Key‘ was also required. This is no longer the case. However, the latest version of the plugin still has a validation for this field. You can ignore the warning "Invalid credentials"; the plugin will work fine without the API Secret Key.

Link product data to ChannelEngine

Now you have to copy the product feed URL (as seen in figure 2) you see in the WooCommerce ChannelEngine plugin settings and go to ChannelEngine: Products > Product Feeds. There you can add the URL you’ve copied.

Figure 4: Product Feeds

Afterwards, you’ll see all the product fields and attributes located in your WooCommerce shop and be able to map them to ChannelEngine and custom fields. More information on ‘feed mapping’ and how this works can be found  here.

After saving the settings the import task will automatically be scheduled. Your products will appear in your ChannelEngine account in a few minutes.

Make sure you configure / add some of the often required product attributes as well. These will be necessary for a lot of marketplaces / channels but are not default attributes WooCommerce offers.

You can find these attributes in your WordPress via WooCommerce > Products > Product data > ChannelEngine (as shown in Figure 5). Especially the GTIN (EAN) is important, but sizes, colour and shipping information is also essential for a lot of channels.

additional required product attributes
Figure 5: additional required product attributes

Getting orders from ChannelEngine

To get marketplace orders that have been retrieved by ChannelEngine in your WooCommerce environment, you have to fill in the ‘notification URL’ (Figure 3). This field can also be found on the  Settings > Settings page in ChannelEngine.

adding the order callback URL for Woocommerce
Figure 6: adding the order callback URL for Woocommerce

This notification URL always consists of http(s)://[ TheUrlOfYourShop]/ChannelEngine/callback. Replace ‘[TheUrlOfYourShop]’ with the domain name your WooCommerce shop uses. When an order comes into ChannelEngine, this URL will then be called upon to notify WooCommerce of this order and WooCommerce will retrieve it.

Activate your connection

After installing and configuring the plugin, please send an email to  support@channelengine.com. We will then verify your installation by checking if the notification URL can be used for retrieving orders and if so, you can start using ChannelEngine!