What the ChannelEngine Merchant API is and what the connector covers
The connector integrates with the ChannelEngine Merchant API for marketplaces such as Amazon, bol.com, Zalando, Kaufland, Cdiscount, Conrad and eBay. It uses it for products, price and stock, orders with acknowledgement and status refresh, shipments, cancellations, returns, webhooks and notifications.
Price and free stock go out to ChannelEngine, with free stock net of every outgoing delivery and waiting order. They are sent in batches and reconciled daily. Orders come into Odoo in the currency they were paid in. They are confirmed automatically after stock and margin checks, or held for you to review.
Everything runs unattended through scheduled actions, active from installation. Some of them:
ChannelEngine: import new orders, every 15 minutes.ChannelEngine: push shipments and tracking updates, every 15 minutes.ChannelEngine: refresh order statusesandChannelEngine: import returns, every 2 hours.
Connecting to the ChannelEngine API: tenant URL and key
The ChannelEngine account in Odoo needs two things. The first is the API Endpoint: according to its help text, your own ChannelEngine tenant URL. The module's code contains addresses such as https://yourcompany.channelengine.net and https://yourcompany-dev.channelengine.net. If the URL does not start with https://, the module stops with API Endpoint must be an https:// URL.
The second is the Merchant API key. The key and the calls to ChannelEngine go through FlexigoTech Cloud, and an administrator has to accept this before the key is saved. If nobody has accepted it, you get Before saving the Merchant API key, an administrator has to accept that the key and the calls to ChannelEngine go through FlexigoTech Cloud. Nothing was sent.
If the key is not stored in the cloud, you will see The Merchant API key of … is not saved in FlexigoTech Cloud: type it again. The fix is what the message says: type it again. Deleting the key from FlexigoTech Cloud is also an administrator's job. Any other user gets Only an administrator can delete the Merchant API key from FlexigoTech Cloud.

What happens if I move the account to another ChannelEngine tenant?
If the account already has its key stored in FlexigoTech Cloud, you have to type the key again in that same save. If you do not type it again, you get To move … to another ChannelEngine tenant, type its Merchant API key again in the same save: the one saved in FlexigoTech Cloud belongs to ….
ChannelEngine webhooks: your Odoo has to be reachable from the internet
The account has a Webhook URL field. If that address is empty or not public, the module stops with this message:
This Odoo's base URL is not reachable from the internet (…), so ChannelEngine could never deliver a webhook to it. Set a public 'web.base.url' first.
The brackets hold the address the module checked. What you need to do is what the message asks: give your Odoo a public base URL. While your Odoo can only be seen inside your network, ChannelEngine cannot deliver webhooks to it.
Separately, the ChannelEngine: import notifications scheduled action runs every 4 hours.
ChannelEngine API rate limits, errors and the log of every call
The connector applies per-endpoint rate limits on API calls. In the screenshot of the log, with demo data, you can see a rate-limited call being retried.
Every call to the Merchant API is logged with ChannelEngine's request id.

Do the call logs pile up for ever?
The ChannelEngine: clean up old sync logs scheduled action runs every week and is active from installation.
Questions about the ChannelEngine API with Odoo
Can I connect several ChannelEngine accounts or several Odoo companies?
Yes. The connector works with every account and company, and it comes with a live dashboard.
What about shipments and cancellations created directly in ChannelEngine?
They are brought into Odoo by ChannelEngine: import shipments created in ChannelEngine and ChannelEngine: import cancellations created in ChannelEngine, every 30 minutes.
How often do price and stock changes travel?
ChannelEngine: queue changed prices and stock runs every hour and ChannelEngine: push pending price/stock every 30 minutes. On top of that, ChannelEngine: compare stock with ChannelEngine runs every day.
Do I need the FlexigoTech Cloud subscription?
Yes. The connector works with the FlexigoTech Cloud subscription, Connector plan: the Merchant API key is stored there and the calls to ChannelEngine go through the cloud. You can find the module on Odoo Apps and the full details on the connector page at flexigotech.com.
Keep reading
Checked in the connector's source code (version 20.0)
Sources
- Module source code: flexigobe_channelengine_connector 20.0 (af29566e): __manifest__.py
- Module source code: flexigobe_channelengine_connector 20.0 (af29566e): models/channelengine_account.py
- Module source code: flexigobe_channelengine_connector 20.0 (af29566e): models/fgt_cloud.py
- Module source code: flexigobe_channelengine_connector 20.0 (af29566e): data/channelengine_cron.xml
