Sendcloud: integration guide
About this guide
This guide describes how to set up a connection between shipping software Sendcloud and ChannelEngine.
Table of contents
- Select the integrator
- Account details
- Configure the integration
- ChannelEngine' custom fields
- Configure the 'Weight' and 'Weight unit'
- Configure the 'Shipping method name'
Sendcloud gives you access to multiple carriers worldwide. By connecting Sendcloud to ChannelEngine, you allow it to acknowledge orders and manage shipments.
|Order synchronization||Product synchronization|
|Get product content |
(weight and weight unit)
|Create full shipments||Create partial shipments|
|Create merchant returns|
|Get and confirm channel returns|
- No merchant plugin, no integration with the ChannelEngine Merchant API – in other words, no ecommerce platform, WMS, or OMS in between.
- An active account on Sendcloud.
- An active merchant account on ChannelEngine.
- Products listed on ChannelEngine must contain a weight and weight unit as additional information.
To establish a successful connection between Sendcloud and ChannelEngine, you need to set up your integration with ChannelEngine within your Sendcloud account. To do so, follow the steps below.
On Sendclound, select ChannelEngine as the preferred integrator. Go to Sendcloud and navigate to User Panel, Settings, Integrations, click ChannelEngine, and click Connect.
Set up your integration by configuring the required details.
Name should correspond to your Sendcloud' shop name, while Account name and API key can be retrieved from your ChannelEngine account.
Retrieve your Account name and API key from your ChannelEngine account.
In the field Account name, add your ChannelEngine API URL subdomain. To retrieve it, access your ChannelEngine account and go to Dashboard, Settings, Merchant API keys. Copy-paste the subdomain from the API URL:
Add your ChannelEngine Merchant API key to the field API key. To retrieve it, access your ChannelEngine account and go to Dashboard, Settings, Merchant API keys and copy-paste the API key.
Note that if you have not added an API key to your ChannelEngine account, you can do so by selecting Add.
For more information on how to retrieve the API Key from ChannelEngine, refer to the Getting API access guide.
Once your API credentials are successfully configured – though before you can proceed with your connection and start processing real time orders –, you must map three custom fields from your ChannelEngine product feed to your Sendcloud account: Weight, Weight unit, and preferred Shipping method name. You can do this by selecting Go to integrations.
You are then be redirected to the mapping page, as seen below:
Sendcloud requires information about the product's weight and weight unit to generate the correct parcel and label. Therefore, you need to provide those details as custom fields when updating your catalog on ChannelEngine.
There are three ways to add custom fields to ChannelEngine: via the interface, via a product feed, and via the API. For more information on this, check out the ChannelEngine: product custom fields/extra data fields article.
When you are done adding the Weight, Weight unit, and Shipping method name fields, go to Products, Custom fields on ChannelEngine to see an overview of your custom fields. Here you must configure the custom field with Key, Type, and IsPublic options, according to the information from your product feed.
Note that by default Key is empty, Type is set to Text, IsPublic is set to No, and you must adjust each option before saving.
Using the product feed example from above, the custom fields should be created in the following way:
- Custom field - Weight
- Key - weight
- Type - number
- IsPublic - yes
- Custom field - Weight unit
- Key - weight_unit
- Type - text
- IsPublic - yes
IsPublic must always be set to Yes for Sendcloud to have access to the custom fields created on ChannelEngine.
After saving all the newly created custom fields, you can see them listed on your ChannelEngine Custom fields page. Make sure to double check that all fields are configured correctly. Make sure to populate them with the correct information via the feed, plugin, or API.
Once your custom fields are created on ChannelEngine, you can map them on Sendcloud' mapping page. This enables Sendcloud to fetch the data for each product ChannelEngine is ingesting from your product feed. Based on the previous examples, the mapping on Sendcloud should be saved in the following way:
- Weight - weight
- Weight unit - weight_unit
Note that each of the mapping fields is configured with the title of the corresponding custom fields created on ChannelEngine. This tells Sendcloud the exact place from which the data should be ingested within your ChannelEngine product feed.
To automatically detect the shipping method selected by the buyer on each marketplace, you need to manually insert the text "SHIPPING_METHOD" to the Shipping method name field.
Once Sendcloud is connected with your ChannelEngine tenant, Sendcloud imports new orders from ChannelEngine every 10 minutes – starting at xx:00. It acknowledges them right away, and marks them as shipped on ChannelEngine as long as the products ordered contain a weight and weight unit.
Why are my orders stuck on status 'New'?
Make sure to check the following:
- Your Sendcloud account is fully operational.
- You have followed the steps under the Account details section.
Why are my orders stuck on status ‘In progress’?
Make sure to check the following:
- You have followed the steps under the Configure the integration section.
- Go to your Sendcloud dashboard and check if the order shows up under the Incoming orders panel. If so, open the order, add the missing information, and save.
- If the problem persists, please reach out to Sendcloud’s support team.
Can I connect the ChannelEngine plugin to Sendcloud if my orders are being synced with my system?
No, that would create inconsistencies and both systems would overlap – causing errors when synchronizing orders. You can avoid that by switching the order synchronization off, but this is not advisable. In those cases we suggest connecting your system directly with Sendcloud instead.