Mark only specific items ready for pickup with GraphQL fulfillmentOrderLineItemsPreparedForPickup

Topic summary

Question: whether the GraphQL mutation fulfillmentOrderLineItemsPreparedForPickup can mark only specific line items (or adjust quantities) as ready for pickup.

Current behavior: The API doesn’t support adjusting quantities within an existing fulfillment for pickup readiness. If quantities need to change, the initial fulfillment must be canceled and then re-requested with the correct amounts.

Proposed workflow (by the merchant’s app) to handle mismatched quantities was validated:

  • Receive the initial FulfillmentOrder.
  • Determine items/quantities can’t be fulfilled as requested.
  • Cancel the FulfillmentOrder via fulfillmentCancel.
  • Edit the order quantities using orderEditBegin → orderEditSetQuantity → orderEditCommit.
  • Receive the new FulfillmentOrder reflecting updated quantities.

Requirements: The app must have the necessary Admin API scopes for both orders and fulfillment. Following the order edit flow will generate new fulfillment orders with up-to-date details.

Outcome: The approach is feasible and endorsed. No direct method exists in the cited mutation to flag only specific line items or change quantities; adjustments should be made via order edits and new fulfillment orders. Status: Resolved with a recommended process.

Summarized with AI on January 29. AI used: gpt-5.

Hey again @jeremiahscanlon - as long as your app has the required scopes for both orders and fulfillment Admin API resources on the shop, this is definitely a feasible process. Following the edit guide you linked will create new fulfillment orders with up to date details including quantities.