Skip to main content

setFulfillmentSupplier

Assigns, changes, or removes the supplier on a V2 fulfillment.

Business Rules​

  • Passing supplierId assigns or changes the supplier.
  • Passing supplierId: null removes the supplier.
  • supplierId must be present so removal is always explicit.
  • Passing updateItemCosts: true replaces item costs from the selected supplier's dropship tiers, falling back to each product's default dropship cost.
  • The supplier must belong to the fulfillment's company and be active.

Error Scenarios​

  • **NOT_FOUND**: the fulfillment or supplier does not exist.
  • **UNAUTHORIZED**: missing required permissions or invalid company access.

Permissions Required​

  • orders:set_fulfillment_supplier permission
setFulfillmentSupplier(
  input: SetFulfillmentSupplierInput!
): OrderFulfillment!

Arguments​

setFulfillmentSupplier.input ● SetFulfillmentSupplierInput! non-null input common​

Parameters for SetFulfillmentSupplier

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.