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 can be managed from the ChannelEngine webinterface on the Settings > Merchant API keys page.
From this page, you can create new API keys or copy an existing one for use in WooCommerce. We recommend creating a separate key for WooCommerce. The fields Account Name (always the subdomain of your account, so only 'demo' or 'woocommerce-test') and API Key(Figure 4) need to be copied into the WooCommerce plugin general settings.
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, color, and shipping information are 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 email@example.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!