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.
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.
The plugin can be configured by pressing the “settings” button (Figure 1) in the WordPress plugin list.
This opens the configuration (Figure 2) where the credentials such as account name & API key should be filled in.
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.
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.
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.
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.
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 firstname.lastname@example.org. 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!