Skip to main content

markFulfillmentReady

Marks a fulfillment as ready in the V2 fulfillments state machine.

Used to explicitly approve and release a fulfillment for handoff. The fulfillment transitions from "allocated" to "ready". This mutation is the manual entry point; tenants that configure auto_transition for this transition advance automatically through the process manager.

Requirements​

  • User must have mark_fulfillment_ready permission
  • Company context must be provided (via X-Company-Id header)
  • Order must exist
  • Fulfillment must exist and be in "allocated" state
  • Order must satisfy the schema for this transition (shipping address and carrier service present, no active holds)

Arguments​

  • fulfillment_id (required): The ID of the fulfillment to mark ready
  • order_id (required): The ID of the order the fulfillment belongs to

Behavior​

  • Marks fulfillment with "ready" status
  • Returns the ready fulfillment
markFulfillmentReady(
  input: MarkFulfillmentReadyInput!
): OrderFulfillment!

Arguments​

markFulfillmentReady.input ● MarkFulfillmentReadyInput! non-null input common​

Parameters for MarkFulfillmentReady

Type​

OrderFulfillment object orders​

This type represents an order fulfillment. An order can have multiple fulfillments, each one associated with a warehouse and a party that fulfilled the order.