Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
| Enabled for | Public preview | General availability |
|---|---|---|
| Users, automatically | - |
Apr 1, 2026 |
Business value
This capability keeps your Shopify integration up to date with a supported API version while adopting important improvements from Shopify. You benefit from more reliable inventory updates, improved handling of large product catalogs, clearer return and payout information, and updated data structures that reflect Shopify’s latest standards. By staying current, you reduce risk of integration disruptions and continue to take advantage of Shopify’s evolving capabilities. In addition, we've added multiple enhancements based on feedback from our community.
Feature details
Shopify releases a new API version every three months at the beginning of the quarter, and supports each version for 12 months. The updated versions might contain important changes, so it's important to uptake Shopify API versions in major releases of Business Central. Typically, new versions of APIs increase stability and security, and enable additional capabilities. Starting with this release, Shopify Connector uses the Shopify API that was released in January 2026.
Important
The Shopify Connector released in 2025 release wave 2 (October 2025) relies on API 2025-07, which is supported until June 30, 2026. To continue to use your integration, upgrade to the latest version of Business Central before this date.
API changes
Exporting inventory and product variants
This update aligns Business Central with the latest Shopify inventory mutation logic. When you export inventory:
- Business Central sends updated on‑hand quantities using the new inventorySetQuantities mutation.
- The connector avoids concurrency conflicts by opting out of Shopify’s compare‑and‑swap mechanism, because Business Central acts as the source of truth.
- The connector automatically retries operations when Shopify responds with concurrency‑related errors, helping you reduce missed updates. When retries still fail, the system logs the skipped records so you can review and take corrective action.
The export process for product variants is also updated. Business Central creates correct batch sizes when you export product variants. Shopify now enforces a limit of 50,000 inventory quantities per mutation. The connector automatically calculates the correct number of variants per batch depending on your number of locations. When you export items or variants, Business Central sends them in the optimal batch size, without requiring any configuration from you.
Handling updated bulk operations
Shopify removed support for older bulk operation queries. The connector now uses the new GetBulkRequest pattern, ensuring that actions like exporting products or retrieving catalogs work with the latest API expectations.
Updated return reasons
Shopify introduced new return reason definitions. Business Central now stores both the return reason name and handle on return lines. If you previously mapped return reasons using the old field, you now use the new values when you process refunds or analyze return data.
More detailed payout information
Payout records now include an external trace ID. When you import payouts, you can view this extra identifier to support reconciliation or payment inquiries.
Removing the tax code from variants
Shopify removed the legacy Tax Code field from variants. Business Central reflects this change by marking the tax code value as obsolete. If you rely on this information in your reporting or processing, migrate to other fields supported by Shopify.
Expanded metafield support
You can now work with Shopify’s new article_reference metafield type. This helps you maintain richer product information when you synchronize item data.
User feedback
Review retrieved Shopify data for fulfillment orders
You can now inspect the raw Shopify JSON captured when fulfillment orders are imported. This helps you diagnose issues with imported fulfillment data.
You can:
- Open Shopify Fulfillment Orders and choose Retrieved Shopify Data.
- Open a specific Shopify Fulfillment Order card and choose Retrieved Shopify Data.
- If you import fulfillment lines separately, you can inspect the data for each line.
Import marketing text when you create items from Shopify
When you create new items by syncing products from Shopify, Business Central now imports the product’s HTML description into the Marketing Text field, provided that you enable Sync Item Marketing Text. This extra synchronization gives you richer product information on new items without manually copying descriptions.
Set the unit of measure when you select an item on order lines
When you map Shopify order lines to items manually, Business Central now automatically fills in the Unit of Measure Code based on the value from the item’s setup.
If the item has a Sales Unit of Measure, that value is used. Otherwise, the Base Unit of Measure is applied.
The autofill reduces manual entry and helps you avoid unit‑of‑measure errors when you process Shopify orders.
Import retail location information on order headers
Shopify order headers now include the retailLocation (ID and name). Business Central imports and stores this information so that you can review it and use it in future processes. This update only imports the data, and isn't used for automated processing yet.
Update unit cost when syncing prices to Shopify
When you turn off the Sync Prices with Products toggle, Business Central previously updated the Unit Cost field on the item variant entry but didn't send the change to Shopify. With this improvement, the unit cost is included in all price synchronization operations, both individual and bulk. When you sync prices, the Price and Compare at Price fields, and now the Unit Cost field, update in Shopify and correctly revert if a bulk operation fails.
Geographic areas
Visit the Explore Feature Geography report for Microsoft Azure areas where this feature is planned or available.
Language availability
Visit the Explore Feature Language report for information on this feature's availability.
Tell us what you think
Help us improve Dynamics 365 Business Central by discussing ideas, providing suggestions, and giving feedback. Use the forum at https://aka.ms/bcideas.
Apr 1, 2026