Webhooks & APIs for Building a Fulfillment App

We are in the process of building a new fulfillment app that will register itself as a location_id in Shopify.

I have a few questions related to the order lifecycle and fulfillment process:

  1. (Important) : Webhook to detect assignment to my location
  • Which webhook should I subscribe to so that I can detect when an order (or line items within an order) is first assigned to my app’s location_id?
  1. Order lifecycle flow
  • What is the typical order lifecycle from “created” → “assigned” → “accepted/rejected” → “fulfilled”?
  • Any documentation or diagram references would be helpful.
  1. List of required webhooks
  • What are the recommended webhooks that a fulfillment service app should subscribe to in order to track the full order lifecycle?
  1. APIs for fulfillment actions
  • Which APIs should my app call to:
    • Accept or reject fulfillment requests
    • Send partial fulfillment updates for specific line items
    • Update final status of the order

I would checkout the documentation on fulfillment services, as it’s really detailed and includes the flows and information required

2 Likes

Hey @Shopify_Wal_App, @JordanFinners is on point here. The fulfillment documentation there is the best place to go for answers to most of your questions there.

Just wanted to follow up to share our webhook documentation here in case it’s helpful: Webhooks

You’d likely want to use the fulfillment_orders/order_routing_complete webhook as a trigger, since this is sent out once a fulfillment order is assigned to its fulfillment location. Hope this helps, let me know if I can help out further at all.

1 Like

@Alan_G
Thanks a lot.
I will try to deep dive and get back with further questions