Migrate your custom app to the Fulfillment Orders API

[MB17]

Hi

I'm a store owner rather than an app developer and I am struggling to understand the migration guide they have sent in relation to the Fulfillment orders API.

We use Mintsoft for fulfillment and we created a custom app in order to generate some API credentials which they then added to Mintsoft and linked the two systems. Everything has worked smoothly since then

I'm familiar with the Shopify Admin / Apps and sales channels / Configuration / Admin API integration as a place where I can change how this app works with Mintsoft (essentially what it can see and read/write access) but there is no mention of this in the migration guide.

Can I do what I need to do from the Admin API integration and if so what do I need to do?

If I can't, what are my options? 

Thanks

Matt

[Michael_AG]

Hi,

As a store owner, you don't need to do anything. However, please let the app developers know you received this email and ask them if they migrated to the new fulfillment flow by creating fulfillments for fulfillment orders rather than for orders. From your user perspective, nothing changes if they migrated. But if they use deprecated APIs, the app will stop functioning properly once these API are removed.

Deprecated endpoints:

REST

• POST /admin/api/2021-01/orders/{order_id}/fulfillments.json
• PUT /admin/api/2021-01/orders/{order_id}/fulfillments/{fulfillment_id}.json
• POST /admin/api/2021-01/orders/{order_id}/fulfillments/{fulfillment_id}/complete.json
• POST /admin/api/2021-01/orders/{order_id}/fulfillments/{fulfillment_id}/open.json
• POST /admin/api/2021-01/orders/{order_id}/fulfillments/{fulfillment_id}/cancel.json

GraphQL

• fulfillmentCreate
• fulfillmentTrackingInfoUpdate
• draftFulfillment

[MB17]

Hi,

Appreciate the reply. We created the app based on the Mintsoft user guide, but it wasn't something we "developed"  we just created it then configured it through the Shopify Admin.

Can I confirm whatever I need to confirm from the Shopify admin and if so, what/where do I see what I need to see?

Thank you

Matt

[VoxSteve]

I am in the same situation as Matt. I'm the store owner and can manage some tasks such as the initial Mintsoft setup (the guide was provided by Mintsoft), but this email request is bewildering to me, and I have no one to ask for help. There doesn't appear to be any update about this on Mintsoft support either. 

I'll be watching replies closely with my fingers crossed!

Steve.

[VoxSteve]

I asked my fulfilment warehouse about this, they responded with this:
"You don’t need to do anything, Mintsoft are aware of the depreciation of the Shopify API version 2022-01 and are working on a change to update to the newer call. This will be released before the support of the old version is stopped."

Hope this helps!

[MB17]

I'm not sure about that. Any change that is required will be required in the Shopify app as I understand it. Mintsoft will, I think, also have to make a change just to reflect the fact that the Shopify app has changed.

Our fulfillment team also checked with Mintsoft;

"Would assume the message you got relates to them needing to move to custom app method instead of api keys. This is something you will have to confirm with Shopify."

I'm none the wiser based on their response.

[VoxSteve]

It's a typical Shopify vs Mintsoft argument! My guess is that Mintsoft will update the integration instructions and we will remove the current app in Shopify and start the integration again... well, that's my hope and nothing more complicated. 

[MB17]

Hi

In case you hadn't heard, Mintsoft have now issued some updated guidance and instructions. I got this via our fulfillment company having gone back to them and asked them to check again with Mintsoft.

Mintsoft are migrating to Shopify API 2023-01 on 27th so if you are using webhooks, you need to have updated your app by then. 

[VoxSteve]

Thank you - I'll follow this up.

[VoxSteve]

I hope I resolved this by going into the App on Shopify and changing the webhook subscription dropdown to this:

The full setup guide is on Mintsoft: https://accessgroup.my.site.com/Support/s/article/Mintsoft-Shopify-Integration

[MB17]

I did the same but have received a further email from Shopify yesterday saying that we are still "leveraging deprecated Fulfillment API endpoints". It would be great if Shopify could describe what that means in terms of what I can see in the configuration page of the app i.e. what needs changing that I can actually do something about.

I heard via my fulfillment company that Mintsoft were releasing their update on 27th.

So really I'm still none the wiser as to what to do.

[VoxSteve]

Same email too. Considering Shopify is meant  (as I see it) to be accessible for non-programmers, e.g. store owners, there should be an idiot's guide to fixing these issues. I'm reasonably technical but yesterday's email meant nothing to me.

[dungletan]

Hi Michael_AG,

I also received the email: "Migrate your custom app to the Fulfillment Orders API by March 31, 2023".

Currently, we are using fulfillmentCreateV2  to fulfill orders:

• https://shopify.dev/docs/api/admin-graphql/2022-10/mutations/fulfillmentCreateV2

May I ask if this API is Deprecated or not? If yes, when will the migration deadline be?

Thanks,

Dung

[Michael_AG]

Hi!

fulfillmentCreateV2 is not deprecated. It's the intended way to create fulfillments. If an endpoint persists in an API version docs (2022-10 in your link), it does persist in the API as well. It's guaranteed.

You probably received this email because your app used any of the deprecated endpoints mentioned here recently before the email was sent. It you are sure that it does not, you can DM me with your app details and I check our logs.

Be informed that 2023-04 API version will be served 3 months more to give more time on migration from it.

[w_mansour]

Hi Michael. I kindly would like to get in touch with you as I have been following this thread and neither 3pl nor Mintsoft is assisting with this matter. I am not a developer, and trying to explain this to developers on Shopify Experts have been a nightmare and so far no one was able to assist with this matter. I am really panicking as we are coming near the deadline. 

[Michael_AG]

Let's break down the concept of a custom Shopify app.
1. When you create a custom app in Shopify admin, you create new authorization credentials: you set access scopes, and you get API key and API access token. There's no logic of a custom app configured in the Shopify admin.
2. Then, you provide these auth details to the app backend to perform business logic. It could be your own developed solution, but in this case, as I understand, it's the mintsoft hosted solution.

So, as a shop owner, you cannot modify how mintsoft's code work. They have to update their logic if they had not yet. They will need to receive extra access scopes (fulfillment orders), but they can receive them automatically with an API noted in the migration guide.

[Michael_AG]

It seems to me that Mintsoft have migrated, see their post.

Have you received a new warning email from Shopify recently?

If yes, you can direct message me with your shop name and the name or id of the custom app you use for integration with Mintsoft? I'll check if this app uses deprecated endpoints.