--- schema_version: "1" id: 6d52ceff5bed59cfafdef8e1cb1cb43e27f1724ad0be05f20830cb0372c65631 title: ProductConsumed collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_productconsumed.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_productconsumed.htm source_site: developer.salesforce.com content_type: documentation content_hash: 9f64af9f8d0e6fc70f83833ae875eff01075d572cb6bafa8b0f2347d0c48f256 description: Represents an item from your inventory that was used to complete a work order or work order line item in field service. --- # ProductConsumed Represents an item from your inventory that was used to complete a work order or work order line item in field service. ## Supported Calls create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert() ## Special Access Rules Field Service must be enabled. ![Note](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/images/icon_note.png) #### Note To create products consumed, you need Read permission on product items. ![Note](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/images/icon_note.png) #### Note To delete or undelete product consumed for non-serialized products, you need Edit, Create, and Read permission on product consumed. For product consumed records that lookup to serialized products, you need Modify All Data or Modify All Records permission on product consumed. ## Fields | Field Name | Details | | --- | --- | | Description | Type textarea Properties Create, Nillable, Update Description Notes and context about the product consumed. | | IsConsumed | Type boolean Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Indicates that a product consumed has been processed if the Product2 it refers to has IsSerialized=true selected. The default is false. | | IsLocked | Type boolean Properties Defaulted on create, Filter, Group, Sort Description Indicates whether the product consumed record is locked or not. The default value is false. | | IsProduct2Serialized | Type boolean Properties Create, Filter, Nillable, Sort, Update Description Indicates if a product is a serialized product. The default is false. | | LastReferencedDate | Type dateTime Properties Filter, Nillable, Sort Description The date when the product consumed was last modified. Its label in the user interface is Last Modified Date. | | LastViewedDate | Type dateTime Properties Filter, Nillable, Sort Description The date when the product consumed was last viewed. | | MayEdit | Type boolean Properties Defaulted on create, Filter, Group, Sort Description Indicates whether the product consumed record can be edited or not. The default value is false. | | PricebookEntryId | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description Price book associated with the product consumed. If the work order and the product item’s associated product are related to the same price book, the Price Book Entry auto-populates based on the product item. | | Product2Id | Type reference Properties Filter, Group, Nillable, Sort Description Product associated with the product consumed. | | ProductConsumedNumber | Type string Properties Autonumber, Defaulted on create, Filter, Sort Description (Read Only) Auto-generated number identifying the product consumed. | | ProductItemId | Type reference Properties Create, Filter, Group, Nillable, Sort Description Product item associated with the product consumed. Creating a product consumed record subtracts the quantity consumed from the linked product item’s quantity. | | ProductName | Type string Properties Filter, Group, Nillable, Sort Description Name for the product consumed. | | QuantityConsumed | Type double Properties Create, Filter, Sort, Update Description The quantity of products consumed. | | QuantityUnitOfMeasure | Type picklist Properties Filter, Group, Nillable, Sort Description Units of the consumed item; for example, kilograms or liters. Quantity Unit of Measure picklist values are inherited from the Quantity Unit of Measure field on products. | | TotalPrice | Type currency Properties Filter, Nillable, Sort Description The total price paid for the product items. | | UnitPrice | Type currency Properties Create, Filter, Nillable, Sort, Update Description The price per unit of the product consumed. | | WorkOrderId | Type reference Properties Create, Filter, Group, Sort Description Work order that the product was consumed for. | | WorkOrderLineItemId | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description Work order line item that the product was consumed for. | ## Usage When a product is consumed during the completion of a work order, create a product consumed record to track its consumption. You can add products consumed to work orders or work order line items. Track product consumption at the line item level if you want to know which products were used for each line item’s tasks. The way you use products consumed depends on how closely you want to track the state of your inventory in Salesforce. If you want to track the entire lifecycle of items in your inventory, including their storage, transfer, and consumption, link your products consumed records to product items. This approach ensures that your inventory numbers auto-update to reflect the consumption of products from your inventory. If you want to track product consumption only, however, specify a Price Book Entry on each product consumed record and leave the Product Item field blank. ## Associated Objects This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version and later. [ProductConsumedChangeEvent](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_change_event.htm "A ChangeEvent object is available for each object that supports Change Data Capture. You can subscribe to a stream of change events using Change Data Capture to receive data tied to record changes in Salesforce. Changes include record creation, updates to an existing record, deletion of a record, and undeletion of a record. A change event isn’t a Salesforce object—it doesn’t support CRUD operations or queries. It’s included in the object reference so you can discover which Salesforce objects support change events.") (API version 48.0) Change events are available for the object. [ProductConsumedFeed](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_feed.htm "StandardObjectNameFeed is the model for all feed objects associated with standard objects. These objects represent the posts and feed-tracked changes of a standard object.") Feed tracking is available for the object. [ProductConsumedHistory](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_history.htm "StandardObjectNameHistory is the model for all history objects associated with standard objects. These objects represent the history of changes to the values in the fields of a standard object.") History is available for tracked fields of the object.