Skip to content

Shopify Setup

The Shopify channel has one setup page: the hub card Marketplace Setup of the marketplace Shopify. It holds everything about the channel — activation, licence, the hub's settings, the list of shops and, below it, the settings of the shop selected in that list. There is no separate Shopify setup card or shop card any more, and Microsoft's shop card no longer carries merchantCENTRAL fields.

merchantCENTRAL for Shopify builds on the Microsoft Shopify Connector. What concerns only the connector — credentials, API version, synchronisation, locations, Shopify's sales channels — stays on Microsoft's Shopify Shop Card; Open Shopify Shop leads there.

Open the page

  • From the hub's marketplace list: the Shopify row
  • From assisted setup: Set up merchantCENTRAL Channel Shopify — the page opens on its own at the end
  • From an error message: Open Shopify Setup — with the shop selected when the message is about a shop
  • From the item list and the channel row of an item: Shopify Shop — with the row's shop selected

Layout of the page

Section Content
General The channel's Enabled switch. It runs through the licence check: without licence or demo, the demo registration opens and the switch falls back to off.
Shopify Connector Where a shop comes from, and the Job Queue Status: whether the scheduled runs for stock and prices exist and are ready. Click to open them.
Sales Channels The list of Shopify shops — all of them, including those merchantCENTRAL is still off for. This is where a shop is switched on and off and where its price list sits.
Sales Channel Settings The hub settings of the selected shop (price check, handling time, languages, synchronisation) and below them the parts Shopify Shop and Document Layouts — see below. Everything applies to the row selected above.
Channel defaults Customer mails, price check, handling time, cancellations, order import, order automation — they apply to every shop that does not set them differently.
Synchronisation, License As for every marketplace; the licence is that of the module SHOPIFY.

The page hides settlements and the automation for marketplace-fulfilled orders for Shopify: the app imports no Shopify payouts, and Shopify ships nothing from a warehouse of its own here.

Activation and licence apply everywhere

If the channel is not enabled or unlicensed, merchantCENTRAL contributes nothing — neither in the hub's runs nor in Microsoft's own synchronisation. Microsoft's connector keeps running on its own; stock comes from Microsoft's standard calculation. Only the order rows in the cockpit and the allocation continue, because they protect the other channels from overselling.

One switch per shop

Whether merchantCENTRAL contributes to a shop is decided by one switch: Enabled in the list of sales channels. The shop follows it. Off, the shop behaves exactly as without this app. The first time it goes on, the shop's feature switches go on with it; a switch you turn off on purpose stays off, even if the shop is later switched off and on again.

If Microsoft's connector has switched the shop off, its sales channel cannot be switched on — it would look active and send nothing. The message leads to Microsoft's shop card.

A shop's price list is also set in the list of sales channels, usually the Price Engine's. How price and compare-at price come about is described under Prices and Compare-at Price.

Add a shop

A new shop is connected in Microsoft's connector. The action Add Shop opens its shop list; after you close it, the new shop is in the list of sales channels. If it is exactly one, the page opens with it selected. Shops connected elsewhere are added to the list when the page opens.


The selected shop

Shopify Shop

The part Shopify Shop shows what merchantCENTRAL contributes to the shop selected in the list, in three groups:

Group Content
Readiness Settings on Microsoft's shop card with which a run succeeds and still nothing arrives — coloured only for a shop that is switched on. See below.
Contributions What merchantCENTRAL contributes, see The switches.
Customer Documents Documents in the shop's design, see Customer documents.
Readiness What is missing when it is not met
Connector Enabled Microsoft's connector does not use the shop at all. Yellow if merchantCENTRAL is switched on anyway.
Stock Location Set No location carries the merchantCENTRAL stock calculation — the shop sends no supplier availability. See Stock and Allocation.
Publishes to a Sales Channel No Shopify sales channel for new products — every new product stays invisible to customers. See When the sales channels stay empty.
Shopify Tracks Stock Shopify ignores every quantity sent.
Stops Selling at Zero Stock Shopify keeps selling below zero.
Product Runs Send Updates Content and prices never reach existing products.
SKU Is Own Item No. The SKU is not your item number.
Listings Without Stock Listed items without inventory (Non-Inventory, Service) for which Microsoft sends no quantity. Click to open them.

These gaps report themselves nowhere else: without a location the shop sends no stock at all, without a sales channel every new product stays invisible to customers.

The switches

Group Contributions of the part Shopify Shop:

Switch Effect Default
Central Descriptions Product description from the central content cascade instead of the item description — in the shop's language only on
Central SEO Fields SEO title and SEO description from the central content. Microsoft's connector leaves both empty. on
Central Titles Product title from the title of the listing in merchantCENTRAL on
Central Prices Price and compare-at price from merchantCENTRAL instead of the shop's customer price group: a price fixed on the listing, otherwise the price from the sales channel's price list on
Compare-at Price Source of the compare-at price lowest price of the last 30 days
Central Metafields Brand, manufacturer and manufacturer part number as Shopify metafields off
Metafield Namespace The metafield namespace merchantcentral
Central Tracking Links Tracking link from the merchantCENTRAL shipment modules instead of the carrier's generic link on
No Shopify Shipping E-mail Suppresses Shopify's own shipping confirmation when you send one yourself off

The Shopify vendor shows the brand

Microsoft's connector fills the Shopify vendor with the item's purchase vendor. Shopify shows that field to customers, filters on it and builds collections from it — the shop would publish where you buy.

While merchantCENTRAL is on, the field carries the brand of the channel row, or the manufacturer. Where both are empty the field goes out empty. There is deliberately no switch: its off position would publish your purchasing.

Read-only users

With the permission set ALN MCSH User you see the switches but cannot change them. The shop's actions are disabled as well.

Customer documents

In the group Customer Documents you decide whether invoices, credit memos and shipments of this shop's orders appear in the shop's design: Branded Customer Documents, Brand Name, Sender Email Account and Order Confirmation by Shopify. Below it the part Document Layouts holds the report layouts the shop's documents are printed with; a new row belongs to the selected shop automatically. Everything about it is under Customer Documents.

Actions of the shop

In the menu of the part Shopify Shop:

Action Effect
Use merchantCENTRAL Stock Sets the stock calculation of one location to the merchantCENTRAL channel allocation. Without it the shop sends no stock at all. See Stock and Allocation.
Repair Sales Channels See When the sales channels stay empty.
Take Over SEO Texts / Take Over SEO Texts from File Takes the shop's SEO titles, SEO descriptions and handles from Shopify or from a product export (CSV) into merchantCENTRAL.
Open Shopify Shop Opens the shop in Microsoft's connector.
Shopify Enrichment Log Shows what could not be contributed for this shop, see Enrichment Log.
Clear Sender Account Removes the sender e-mail account of the documents.

Actions of the page

Action Effect
Setup Wizard Opens the Setup Wizard.
Add Shop See Add a shop.
Check Setup Checks in turn: shop connected, merchantCENTRAL switched on, scheduled runs present and released, the shops ready, channel enabled and licensed. Each miss names the next step.
Create Job Queue Entries Creates the scheduled runs for stock (every 15 minutes) and prices (hourly) in this company — on hold, so nothing starts sending on its own.
Job Queue Entries Shows those runs.
Shopify Enrichment Log Opens the Enrichment Log across all shops.

The card's other actions — dashboard, orders, sync prices and so on — are the hub's, see Marketplace Setup.

The scheduled runs

Run What it does
Shopify - Sync Inventory Starts Microsoft's stock run for every served shop.
Shopify - Sync Prices First queues listings whose promotional price starts today or ended yesterday, then sends every queued price. With nothing queued it does nothing.

Orders are fetched by Microsoft's connector on its own schedule. There is no third run for them; to fetch orders through the hub, create an entry with the parameter GETORDERS.


When the sales channels stay empty

Microsoft publishes a new product only to the channels marked Use for publication or as default in Shopify Sales Channels. With an empty list nothing happens on creation — and nothing says so. The product is Active in Shopify, but no customer can see it. The dashboard reports this as Shops publishing to no sales channel, the part Shopify Shop under Publishes to a Sales Channel.

A common cause: the primary key of Shpfy Sales Channel is the publication id alone. A row once written under a blank or long-deleted shop code blocks the right shop for good — Microsoft's fetch finds it and changes nothing.

Repair Sales Channels in the menu of the part Shopify Shop removes exactly those rows: without a shop, or of a shop that no longer exists. The question names the code they are filed under. Afterwards the shop's channel list opens; choose Get Sales Channels there once and tick the channel you want.

Rows of other existing shops are left alone, including those of a switched-off shop. They are the channels of their own store, together with that store's choice of where to publish.

List empty although nothing blocks it

Then the Shopify app registration most likely lacks the scope read_publications. Re-authorise the shop in Shopify.

Microsoft does not publish existing products afterwards. Assign them to a channel once by hand in the Shopify admin.

Why there is no connection test

This app never calls Shopify. Credentials, OAuth and the entire transport belong to the Microsoft Shopify Connector; the connection is tested there, on its Shopify Shop Card. Check Setup checks exactly what this add-on can answer for.