Shopify releases a new API version every three months at the beginning of the quarter. Shopify supports each version for 12 months. Updated versions might contain important changes. To take advantage of these changes, update Shopify API versions in major releases of Business Central. Typically, new versions of APIs increase stability and security. They also enable additional capabilities. Starting with this release, the Shopify connector uses the Shopify API that was released in January 2025.

Important

The Shopify connector released in 2024 release wave 2 (October 2024) relies on API 2024-07. Shopify supports this API until July 1, 2025. To continue to use your integration, upgrade to the latest version of Business Central before this date.

Bulk updates of product variants

Shopify deprecated singular product variants in favor of bulk versions. Now, the Shopify connector creates or updates variants in bulk. This change improves the overall performance of the connector because a single call handles hundreds of updates. This change affects the initial creation of products with variants and scheduled updates of Shopify products and variants.

Handle the Price Including Tax setting

Starting with this release, the Price Including VAT toggle in the Shopify Shop Card page no longer affects the creation of sales documents. The app gets the information about whether prices include tax directly from Shopify. This information is helpful when you sell to different markets and use the Include or exclude tax based on your customer's country setting in Shopify Admin.

Important

For merchants using the US or Canadian localizations, select Include sales tax in product price and shipping rate in Shopify Admin. If you select this setting, you can't convert imported orders into sales documents because Business Central doesn't support backward sales tax calculation.

If you select this field and don't charge taxes, you can turn off the VAT (Tax) Included field in the Shopify Order page and proceed.

To simplify troubleshooting, you can inspect tax lines from the Shopify Order page.

Shopify Order Tax Lines page

More capabilities for filtering orders

Order synchronization now supports the Ship-to, Bill-to, and Sell-to Countries filters, and the Tax Amount filter. These filters are useful for merchants in the European Union who sell to B2B customers in other EU member states. Because of reverse charges, the order doesn't include VAT.

For more information about rules like this, see Different processing rules for orders.

Sorting in the Shopify Orders to Import page

The Shopify Orders to Import page now shows the newest orders first.

Shopify Orders to Import page

Use this page to troubleshoot issues with order imports. You can review the available orders and take the next steps:

Check whether an error blocks the import of a specific order. Select the Has Error field to view error details.
Process only specific orders. Enter a value in the Shop Code field, select one or more orders, and choose the Import Selected Orders action.
Delete orders from the Shopify Orders to Import page to exclude them from the sync.

Deprecation of REST resources

Shopify is moving from REST to GraphQL. In this release, Shopify deprecates endpoints for the Country and Province resources. The Shopify connector uses that information to fill the Shopify Customer Templates page with a list of countries where shipping is allowed. This feature still works because the Shopify connector gets this information from the shop properties.

Shopify can't get the list of associated provinces. The Shopify connector includes the list of provinces as setup data. Several countries require a province code to validate address information. Because Business Central doesn't enforce the use of the Country field or validate the content, the Shopify connector uses the County Code field in the Shopify Shop Card with the Shopify Tax Area page to get a province code when you create a customer or company in Shopify.

Shopify requires a state or province for the following countries:

United Arab Emirates
Argentina
Australia
Brazil
Canada
Chile
China
Colombia
Costa Rica
Egypt
Spain
United Kingdom
Guatemala
Hong Kong SAR
Indonesia
Ireland
India
Italy
Japan
South Korea
Kuwait
Mexico
Malaysia
Nigeria
Panama
Peru
Philippines
Portugal
Romania
Russia
El Salvador
Thailand
United States
Uruguay
Venezuela
South Africa

Note

Great Britain has provinces, but you don't need to include a province in addresses.

Other improvements

We implemented improvements that enhance the general usability of the connector.

After you import a Shopify order to Business Central, you can create a sales document automatically or manually. You can create a sales invoice if you fulfill the Shopify order, or a sales order if you handle fulfillment in Business Central. When you create a sales document, the document number synchronizes to Shopify as an order attribute.

People who work with Shopify Admin find it useful to see whether orders synchronize to Business Central. In some cases, such as high-load environments, turn off synchronization. Use the new Add Business Central Doc. No. as Attribute toggle to control synchronization.

Document No. as Order attribute

The previous release gives you a new way to handle risk assessments. Shopify now supports two levels and external providers. The connector still imports both risk and sentiments. However, the connector didn't have a single value that represents the risk associated with an order. To fill that gap, the release adds a High Risk field to the Shopify Order and Sync Orders from Shopify request pages. The field is Boolean. Enable it when an order is high risk.

The Request Data and Response Data on the Shopify Log Entry page, and Json Data in the Shopify Data Capture List now use a rich text control that shows more information. This change makes troubleshooting simpler.

The Create Shopify Fulfilment Service action is now on the Shopify Locations page. With this action, you can create fulfillment service locations when you map locations.

Changes that are mandatory

The Enable using bulk operations for Shopify connector feature is now mandatory. You can't disable this feature. The feature affects price synchronization. With this feature, the connector synchronizes prices in bulk.

You can check the status of the synchronization on the Shopify Bulk Operations page.

Shopify Bulk Operations