Shopify: channel guide
About this article
This is a ChannelEngine guide on Shopify as a channel. Here you can find information on how to create an account on Shopify, how to configure this channel on ChannelEngine, what the specific requirements are, and more.
Table of contents
To start selling via Shopify you need to create an account on their website. ChannelEngine supports connections with the Basic, Shopify, Advanced, and Plus plans.
The costs related to using Shopify can be found on the pricing section of their website.
|Product offers (Merchant product number matching)||Multiple fulfillment locations|
|Product variations (size/color)||Draft orders|
|Product images||Partial cancelations|
|Returns/refunds (merchant and channel)|
|Publishing of products on all sales channels|
Settings and configuration
The setup of each channel on ChannelEngine follows the same flow, once you add the channel:
- Go through the Setup.
- Create a Product selection.
- Complete the Categorization.
- Set up the Mappings (content, offers, and carriers).
- Configure the Pricing (rules and currency conversion).
- Finish the Activation.
- Check the Listed products overview.
Channel-specific requirements and exceptions
To connect your Shopify store with ChannelEngine, you must add ChannelEngine as a private app in the back-end of your Shopify account.
To add ChannelEngine to Shopify:
- On your Shopify admin, click Settings.
- In the left panel, click Apps and sales channels, click Develop app, and click Create an app.
- In the Create an app dialogue box, in the App name field, enter the app's name. The recommended name is 'ChannelEngine'.
- In the App developer field, enter an email address. We recommend you to enter firstname.lastname@example.org.
- Update the permissions of the private app, so ChannelEngine has the required access:
- Customers - read and write
- Discounts - read and write
- Fulfillment services - read and write
- Inventory - read and write
- Order editing - read and write
- Orders - read and write
- Products - read and write
- Product listings - read and write
- Shipping- read and write
- Store content - read and write
- Click Create the app.
- Click the API credentials tab. The API credentials should be generated and visible in the API key and secret field.
Once your Shopify account is active, you can set up Shopify on ChannelEngine.
To set up Shopify to ChannelEngine:
- Add Shopify as a channel in your account.
- On the Setup tab of your Shopify account, enter the following information:
API key password
The password you copied from your Shopify back-end.
API shop URL
Your Shopify store URL. E.g.: myshop.myshopify.com.
The public URL for your store. E.g.: www.myshop.com
Location identity on Shopify
On Shopify, go to Settings, Locations. Open the default location. You can find a number after /locations/ in the URL. This is your location identity. Add this number so ChannelEngine can update your stock and orders.
Enter the currency you want to use for prices and shipping costs, using the ISO standard currency code.
N.B.: make sure to align the currency setting with the Shopify settings. If these settings do not match, ChannelEngine cannot export the prices – causing the product offers export to fail.
Name for option [number]
Enter a name to replace the default.
Extra metafields to product export
Lets you specify extra product data. These meta fields can contain up to 30 characters.
Set orders to closed after import
When enabled, ChannelEngine sets order statuses to Closed and orders are not handled. Instead, orders are handled on Shopify.
Shopify prices are excluding VAT
If enabled, all product prices are exported to Shopify without the VAT. If the All prices include tax option is switched off on Shopify (go to Settings, Taxes, Tax calculations), the Shopify prices are excluding VAT option must be enabled on ChannelEngine. On B2B orders, VAT is commonly excluded.
List products on all sales channels
If enabled, ChannelEngine publishes all your products to all sales channels.
Notify customer on shipment/cancelation
If enabled, ChannelEngine sends shipping confirmation and order canceled notifications.
Include shipping costs for cancelation refunds
If enabled, the grand total of the order lines is refunded. I.e.: including the shipping costs.
Notify customer on return/refund
If enabled, ChannelEngine sends an order refund notification.
Restock items in case of refunds
If enabled, ChannelEngine automatically restocks products in the Shopify warehouse.
Delay orders with gifted order lines
If enabled, ChannelEngine delays importing orders to allow gift card transactions. This setting is added because gift card orders take longer to process on Shopify.
If enabled, invoices are sent automatically per channel.
Removes the channel. Note that deleting a channel removes the channel and its tasks, but it does not automatically remove products from the channel itself.
Cancelations are handled by Shopify
If enabled, order cancelations executed in Shopify propagate to ChannelEngine. With this setting enabled, ChannelEngine supports channel-initiated cancelations only.
On Shopify, there are only mappings under the Content mappings tab. Make sure to map the attributes required across all product categories:
- Price - the product's sale price.
- SKU - the product's Merchant product number. To link to existing products, this attribute should be the same as the SKU field on Shopify.
- Title - the product's name.
There are also optional attributes that ChannelEngine advises you to map:
- Barcode - the product's EAN.
- Body HTML - the product's description.
- Compare at price - sets the from-to pricing and works as the product's catalog price.
- Fulfillment service - the ID of the fulfillment service associated with the variant.
- Handle - this value is automatically created from the product title.
- Inventory policy - indicates whether customers are allowed to place an order for the product variant when it is out of stock. I.e.: backorder.
- Option 1 - used to create a single variation (parent-child). The only way to create product variations on Shopify is to set up a correct grandparent-parent-child structure on ChannelEngine. Once this is set up, you must fill out the fields Option 1 and Option 2. E.g.: if you have a t-shirt in various colors and sizes, Option 1 must be connected to the field Color and Option 2 to the field Size.
- Option 2 - used if Option 1 is filled out. This option generates a double variation (grandparent-parent-child).
- Product ID - specifies the product on which to create the variant.
- Product type - the product's category.
- Requires shipping - indicates whether the variant requires shipping.
- Tags - enter a comma-separated list of tags that have been added to the product.
- Vendor - the product's brand.
- Weight - the variant's weight.
- Weight unit - the weight unit used to measure the variant. E.g.: kg.
Shopify does not state if a product is published or not. The only visible aspects are the tasks and if their statuses on ChannelEngine. At first the status of a product is set to Created. After it is created on Shopify, it changes to Updated.
Note that when the creation of the product does not go well, Shopify only provides you with minor feedback. This feedback is shown under Reason, below the Last import from channel selection.
Add new products
To create new products in your Shopify back-end, ChannelEngine needs to perform three tasks: export the product content to Shopify; export the offers; and export product images. When all three tasks are completed, the products are shown correctly in your Shopify account. Check with your Customer Success Manager or Onboarding Specialist when these tasks are scheduled for the Shopify channel, so you know how long it takes to see your new products online.
Link to existing products
To link to existing products in your Shopify back-end, set up the correct SKU of each Shopify product in the mapping field SKU. Make sure to inform your Customer Success Manager or Onboarding Specialist before you do that – and do not activate the channel until you get the go-ahead. ChannelEngine must update an export product setting in the back-end for you.
Work with product variations on Shopify or ChannelEngine
The only way to create product variations on Shopify is to set up a correct grandparent-parent-child structure on ChannelEngine. Once this is set up, you must fill out fields Option 1 and Option 2 under Mappings. E.g.: if you have a t-shirt in various colors and sizes, Option 1 must be connected to the field Color and Option 2 to the field Size. If you have a grandparent-parent-child structure set up on ChannelEngine, it is not possible to set up the products on Shopify as standalones.
Return and refund handling
When using the Shopify integration, you have two options to set up return and refund handling:
- Shopify is leading - on Shopify you have the option to create a refund of an order. This refund becomes a return on ChannelEngine, which could be handled like a normal channel return on ChannelEngine.
- ChannelEngine is leading - when creating a return on ChannelEngine, it becomes a refund on Shopify and a 'paid out' is triggered.
To see the information related to each payment you receive via Shopify, follow the steps below:
- On your Shopify channel, go to the Setup page and click Advanced settings.
- Enable the Payment ID setting.
You can then access the details of your incoming orders and see information such as the payment method and payment ID. The latter allows you to match the orders from your overview on ChannelEngine with the information received from your payment provider.
How often does each task run on Shopify?
every 30 minutes (parameter: 'full')
every 15 minutes
every 15 minutes
must be manually run
every 60 minutes
every 10 minutes
every 60 minutes
every 10 minutes
every 20 minutes
every 20 minutes
must be manually run or scheduled