Shopify Item Sync for Business Central
Setup and help
How to set up the app, run a read-only check, and apply fixes in small, previewed batches.
This app is pre-release. Menu names and screens may differ from this guide, which describes them generically and will be updated at launch. Steps marked Available at launch depend on parts that are not live yet.
Requirements
- A Business Central online environment. Use a sandbox environment first.
- Permission in Business Central to install extensions and to assign permission sets.
- A Shopify store, and permission to create an app in the Shopify Dev Dashboard.
- Microsoft’s Shopify Connector may be required for some features. If you use those features, set up the connector first. The extension only reads the connector’s item-to-product links.
1. Install into a sandbox first
Available at launch The Microsoft AppSource listing is in progress. When it is live, install the app into a sandbox environment first, and assign the app’s permission set to the people who will use it. If you have questions about access before then, contact support.
2. Create the Shopify app and grant scopes
The app connects through a Shopify app that you create and own. In your Shopify Dev Dashboard, create an app, give it the scopes below, and install it on your store. Keep its client ID and client secret safe: you will enter them in Business Central in the next step.
read_products: lets the app read your products and variants so it can compare them with Business Central items.write_products: lets the app fill blank fields on products, such as barcode, product type, price and description.read_inventory: lets the app read inventory levels and your Shopify locations.write_inventory: lets the app push Business Central inventory to the location you choose.write_files: lets the app upload Business Central item pictures so they can be added to products that have no images.
If you only want to compare and check, the read scopes (read_products and read_inventory) are enough. Add the write scopes only when you want the app to make changes.
3. Enter your details in Business Central
In Business Central, search for Shopify Item Sync Setup and open it. Enter your shop domain, the client ID and the client secret from your Shopify app, and choose the Shopify location to use for inventory. The secret is stored in Business Central’s isolated storage in your environment. It is not sent to the publisher.
4. Run the health check
The health check only reads data. It looks at your items and your Shopify products and reports what is missing or different. It changes nothing, so it is a safe first run.
5. Preview, then apply fixes in small batches
Every action has a preview (a dry run) that shows what would change, and batch limits. Start with a small batch, read the preview, then apply it. The app fills blank fields and does not overwrite existing Shopify data. Check a few products in Shopify after your first batch before running larger ones.
6. Troubleshooting
Token or authorisation errors
Check the shop domain, client ID and client secret for typos, confirm the Shopify app is installed on your store, and enter the secret again.
Scope denied, or Shopify says an action is not permitted
The Shopify app is missing a scope the action needs. After a version of your Shopify app that includes the scopes is released, reinstall the app on your store so the new scopes take effect.
Business Central asks you to allow HTTP requests
The extension calls Shopify directly from your Business Central environment, so Business Central asks you to allow the extension to make HTTP requests. Allow it in the extension’s settings in Extension Management.
7. Uninstalling, and getting support
To remove the app, uninstall it in Business Central’s Extension Management. Changes already made to Shopify products stay as they are. To cut off access completely, you can also uninstall your Shopify app from your store or change its client secret.
If you are stuck, see support for what to send and where to send it.