Skip to main content

updateFulfillmentItemCosts

Updates costs for a single fulfillment item.

Business Rules

  • The fulfillment item must belong to the given fulfillment.
  • Passing supplierUnitCost updates the supplier unit cost.
  • Passing supplierUnitCost: null clears the supplier unit cost.
  • Omitting supplierUnitCost leaves the supplier unit cost unchanged.
  • At least one cost field must be provided.
  • supplierUnitCost must be non-negative when provided.

Error Scenarios

  • **NOT_FOUND**: the fulfillment or fulfillment item does not exist.
  • **BAD_REQUEST**: no cost fields are provided, or a cost is negative.
  • **UNAUTHORIZED**: missing required permissions or invalid company access.

Permissions Required

  • orders:update_fulfillment_costs permission
updateFulfillmentItemCosts(
input: UpdateFulfillmentItemCostsInput!
): FulfillmentItem!

Arguments

updateFulfillmentItemCosts.input ● UpdateFulfillmentItemCostsInput! non-null input common

Parameters for UpdateFulfillmentItemCosts

Type

FulfillmentItem object orders

This type represents an item in an order fulfillment. Each item is associated with a product and a quantity