Skip to main content

productCosts

One supplier's cost list across the catalog, paginated. Each row is a quantity tier: the unit cost the supplier quotes from an order quantity, with its lead time and the date it takes effect.

Business Rules​

  • supplierId is required, so the list is always bounded by one supplier.
  • The supplier must belong to the authenticated company.
  • productFilters are the product list filters, applied before pagination.
  • Archived costs are left out.

Ordering​

sortField defaults to the SKU, ascending. Whatever the sort, ties are broken by the MOQ, ascending, so each product's tiers read from its base tier up.

Error Scenarios​

  • **NOT_FOUND**: the supplier does not belong to the active company.
  • **UNAUTHORIZED**: missing required permissions or invalid company access.

Permissions Required​

  • products:read_costs permission
productCosts(
  after: String
  before: String
  costType: CostTypeEnum
  first: Int
  last: Int
  productFilters: ProductFilterInput
  sortField: ProductCostSortFieldEnum = SKU
  sortType: SortTypeEnum = ASC
  supplierId: ID!
): ProductCostConnection!

Arguments​

productCosts.after ● String scalar common​

Returns the elements in the list that come after the specified cursor.

productCosts.before ● String scalar common​

Returns the elements in the list that come before the specified cursor.

productCosts.costType ● CostTypeEnum enum products​

Limits the list to standard or dropship costs. Omit it for both.

productCosts.first ● Int scalar common​

Returns the first _n_ elements from the list.

productCosts.last ● Int scalar common​

Returns the last _n_ elements from the list.

productCosts.productFilters ● ProductFilterInput input products​

The main product list filters, applied before pagination.

productCosts.sortField ● ProductCostSortFieldEnum enum products​

Column to sort by. Ties sort by MOQ, ascending.

productCosts.sortType ● SortTypeEnum enum common​

Sort direction.

productCosts.supplierId ● ID! non-null scalar common​

The supplier whose cost list is read.

Type​

ProductCostConnection object common​

The connection type for ProductCost.