Shopify Fulfillment Order API update

What’s updating

Celigo is updating the Microsoft Dynamics 365 Business Central posted sales shipment to Shopify fulfillment (add) flow in the Shopify - Microsoft Dynamics 365 Business Central integration app to utilize the new Shopify Fulfillment Order API. The existing flow must be updated to look up open Shopify fulfillment orders and update them to create the corresponding fulfillments.

Flow before the update

Flow after the update

Reason for update

Shopify removed support for the fulfillment API we currently use to create fulfillments as part of the 2022-07 version. The last API version that supported the fulfillment API is 2022-04. Shopify will deprecate API version 2022-04 on June 30th, 2023, so all the merchants must migrate to the newer API version. You can find more information about this at https://shopify.dev/apps/fulfillment/migrate.

How this fulfillment API is different from the existing API

In the existing process, we can create a new fulfillment directly from the Shopify order by supplying the order id, and a list of line items and quantities. With the new process, Shopify automatically creates the fulfillment orders against the order that are fulfilled instead of the order directly. These fulfillment orders break down how Shopify expects the order to be fulfilled which may not match the actual shipments coming from the ERP. To know more about the existing process, see Sync posted sales shipment from Microsoft Dynamics 365 Business Central to Shopify.

Impacted users 

Customers who are using the flow that imports fulfillments into Shopify.

Understand the process of update

Celigo is doing this update in two steps.

• Step 1: Update the Shopify connections to include the additional permissions that are needed for the fulfillment order API. This update happened in the 2023-1-0 update that happened in January 2023.  This update requires that customers save and authorize their Shopify connection to get the new permissions. This was done prior to the fulfillment order migration to allow users to have time to make the update without impacting the integration update that happens in step 2.
• Step 2: Planned for March 2023.  This will update the Shopify fulfillment import to use the new API and consists of the following changes:
  • Add a Shopify fulfillment order lookup
    • This consists of getting a list of open fulfillment orders from Shopify for the Shopify order id on the fulfillment
  • Replace the Shopify fulfillment import
    • The new import calls the updated fulfillment API which creates the fulfillment against one or more fulfillment orders.
    • A script will match the shipment data against the fulfillment orders based on the Shopify id at the line level of the shipment. The script will provide an updated list of fulfillment orders and lines that need to be fulfilled.
      • If any locations of the fulfillment orders don’t match the location on the fulfillment an update call will be made to Shopify to change the location of the fulfillment order.
    • Mappings are updated to use the list of fulfillment orders and lines to be fulfilled based on the matching process in the script.