OBJECT

ProductEntity

Product or service in the catalog that can be added as a line item to opportunities and quotes.

link GraphQL Schema definition

  • type ProductEntity {
  • # Values of the record's custom fields as a JSON object keyed by custom field
  • # apiName (camelCase).
  • #
  • # Arguments
  • # apiNames: Api names of custom fields to retrieve. All are
  • # returned if not set.
  • customFields(apiNames: [String!]): JSONString!
  • # True when the record is protected against deletion because it must always exist
  • # in the space. Deleting a record that is not protected can still fail on other
  • # checks. Read-only.
  • isDeleteProtected: Boolean!
  • # Unique identifier of entity.
  • id: ID!
  • # Specifies if the entity is considered deleted.
  • isDeleted: Boolean
  • # Last modification time.
  • modified: DateTime
  • # Creation time.
  • created: DateTime
  • # Currency exchange rate list used to convert monetary fields linked to this
  • # product. Empty to inherit the team space default.
  • currencyExchangeRatesList: CurrencyExchangeRatesListEntity
  • # Product picture.
  • picture: CloudObjectEntity
  • # Product category this product belongs to. Categories form a hierarchy used in
  • # the catalog browser.
  • productCategory: ProductCategoryEntity
  • # Product type that classifies this product. Product types are configurable per
  • # team space and drive which form, fields and product-line behavior apply.
  • productType: ProductTypeEntity
  • # Whether this product can be added to all pipelines or only the explicitly linked
  • # subset (see productPipelineRelations).
  • allowedPipelines: AccessPipelinesEnum
  • # Id of the currency exchange rate list applied to this product.
  • currencyExchangeRatesListId: ID
  • # Free-form description of the product.
  • description: String
  • # Name of the product, shown in catalogues and pickers.
  • name: String!
  • # Id of the product picture document.
  • pictureId: ID
  • # Id of the product category this product belongs to, or empty when it is not
  • # categorized.
  • productCategoryId: ID
  • # Id of the product type that classifies this product.
  • productTypeId: ID
  • # Stock-keeping unit (SKU) identifier of the product. Must be unique across
  • # products.
  • sku: String
  • # Unit of measure shown next to product quantities (e.g. pcs, kg, hours).
  • unitSymbol: String
  • # Revision when entity was lastly changed.
  • revision: Int
  • # Deprecated pipeline connection.
  • #
  • # Arguments
  • # filter: Filter Pipeline relations by target Pipeline
  • # attributes.
  • # filterEdge: Filter ProductPipelineRelation relations by edge
  • # (relation) ProductPipelineRelation attributes.
  • # orderBy: Order Pipeline relations by target Pipeline
  • # attributes.
  • # includeDeleted: Returns deleted target records as well. Default
  • # is true.
  • # before: Cursor until which to take entities to result set.
  • # after: Cursor after which to start taking entities to result
  • # set.
  • # first: Number of entities to return from beginning of the
  • # result set.
  • # last: Return only the "last" number of entities from result
  • # set.
  • productPipelineRelations(
  • filter: PipelineFilterInput,
  • filterEdge: ProductPipelineRelationFilterInput,
  • orderBy: [PipelineOrderByInput!],
  • includeDeleted: Boolean,
  • before: String,
  • after: String,
  • first: Int,
  • last: Int
  • ): ProductPipelineRelationEntityConnection
  • # Configuration of Pipelines where the Product can be used.
  • productPipelines: ProductPipelinesObject
  • # Display version of the product name, used in lists and references.
  • formattedName: String!
  • # Id of the product line-item type derived from productType. Used as a filter when
  • # listing relations on opportunities and quotes. Read-only.
  • opptyProductRelationTypeId: UUID!
  • # Active price lists this product is priced in, ordered by name. Read-only;
  • # computed by Coevera.
  • priceLists: [ProductPriceListReference!]
  • # Active price schedules this product is priced in, ordered by name. Read-only;
  • # computed by Coevera.
  • priceSchedules: [ProductPriceListReference!]
  • # Permissions the current user has on this record, out of the requested ones.
  • #
  • # Arguments
  • # permissions: Permissions to check; the result lists those the
  • # current user has.
  • instancePermissions(permissions: [EntityPermsEnum!]!): [EntityPermsEnum!]!
  • # Price of the product in the given price list and currency. Returns 0 when either
  • # is not given or the product has no price for that combination.
  • #
  • # Arguments
  • # priceListId: Price list to read the price from.
  • # currencyId: Currency of the price.
  • priceListPrice(priceListId: ID, currencyId: ID): Float
  • }