Skip to main content

ordersUpdateFulfillmentItem

Updates an existing item in a draft fulfillment. Currently supports location assignment.

Business Rules​

  • A selected location must be active, pickable, and in the fulfillment building.
  • Allocation is restricted to the selected location for the selected fulfillment item.
  • Omitted fields remain unchanged. Other fulfillment items remain unchanged.
  • Pass locationId: null to allow allocation across eligible locations in the building.
  • Revert an allocated fulfillment to draft before changing its location.

Error Scenarios​

  • The fulfillment is not editable or is not a draft.
  • The location is inactive, not pickable, or belongs to another building.
  • The item does not belong to the fulfillment.

Permissions Required​

  • orders:fulfill_order and authority to manage the fulfillment.
ordersUpdateFulfillmentItem(
  input: OrdersUpdateFulfillmentItemInput!
): OrderFulfillment!

Arguments​

ordersUpdateFulfillmentItem.input ● OrdersUpdateFulfillmentItemInput! non-null input common​

Parameters for OrdersUpdateFulfillmentItem

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.