Fulfillment Endpoint Removals 2022-07+

[joecampo]

Hi there,

I'm currently working through updating some older apps to 2023-01 and I noticed within the release notes for 2022-07, that the following endpoints are being removed from the REST API; however, looking at the documentation for even update 2023-01 /orders/{order_id}/fulfillments.json endpoint appears to be a valid, working endpoint that is still in the documentation: https://shopify.dev/api/admin-rest/2023-01/resources/fulfillment#get-orders-order-id-fulfillments – I'm inquiring to see if the release notes are correct.

https://shopify.dev/api/release-notes/2022-07#fulfillment-endpoints-removed-from-the-rest-admin-api

• /orders/{order_id}/fulfillments.json
• /orders/{order_id}/fulfillments/{fulfillment_id}.json
• /orders/{order_id}/fulfillments/{fulfillment_id}/complete.json
• /orders/{order_id}/fulfillments/{fulfillment_id}/open.json
• /orders/{order_id}/fulfillments/{fulfillment_id}/cancel.json

[ShopifyDevSup · Accepted solution]

Hi @joecampo 👋

Thanks for flagging the ambiguous release note! Further down here in the list of changes to REST Admin API, it specifies that the deprecation applies to `POST /orders/{order_id}/fulfillments.json` requests. The `GET /orders/{order_id}/fulfillments.json` endpoint remains supported to fetch actual fulfillments on the order. Keep in mind, we'll want to use `GET /orders/{order_id}/fulfillment_orders.json` for fulfillment orders on an order and `GET  /fulfillment_orders/{fulfillment_order_id}/fulfillments.json` for fulfillments on each FufillmentOrder.

Hope that helps!

[API_Chat]

Hi @joecampo @ShopifyDevSup 

What would the new endpoint POST /orders/{order_id}/fulfillments.json look like after depraction?

[ShopifyDevSup]

Hi @API_Chat 👋

This legacy workflow is deprecated in favour of the new fulfillment order workflow, and I'd recommend reviewing this migration guide. To create a fulfillment, you'd make a post request `/admin/api/2023-01/fulfillments.json` in the new fulfillment flow.

Hope that helps!