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.