--- type: "resource" title: "InventoryItem" resource: "InventoryItem" --- # InventoryItem ## Introduction ## Scope and Usage The InventoryItem is used to define and specitfy the characteristics of a material item (Product) and the relevant characteristics when handling logistics: Inventory and Supply. This resource corresponds to (and expands) the InventoryReport resource's .item backbone element, and provides a reusable data object to express and use product characteristics in the Inventory and Supply (and Transport) aspects. This resource approximately corresponds to "product" or "material" in ERP systems (e.g. SAP's MARA table) and to TradeItem in GS1 logistics standard - a core set of attributes that can be referred to when ordering, delivering, tracking or counting items, especially in situations where their clinical categorization (Medication or Device or BDP or Nutrition) is undefined or irrelevant - which is common in supply chain systems, especially in cross-realm, cross-border supplies. The InventoryItem Resource: - is meant to be used in the logistics workflows aspects, when the specific resources cannot be used (due to indefinition, ambiguity, or need to cross-over between resources). - is NOT intended be used in clinical workflows, where the specific product resources shall be used: Medication, Device, etc. The InventoryItem resource does not intend to provide a substitute for the other resources, nor overlap those in the clinical workflows, as those resources have their specific core characteristics. This resource is meant to contain the characteristics that are relevant for the logistics. If a clinical resource wishes to add such characteristics for logistics, the InventoryItem can be a placeholder for these. For example, adding Storage and Handling to a NutritionProduct. The InventoryItem can also reference the relevant specialized product resource, if one such resource exists. In the example above, the InventoryItem resource adds add inventory capabilities to the system that already uses NutritionProduct. The InventoryItem can also be used on its own for inventory specific purposes - one example is if the system tracks packages, specialized utensils and there is no clinical need, only inventory tracking, the InventoryItem may be used. ## Boundaries and Relationships The InventoryItem resource can be referenced from the following resources: - **[InventoryReport](inventoryreport)** - when counting items in an inventory - **[SupplyRequest](supplyrequest)**\- for requesting the supply of inventory items - **[SupplyDelivery](supplydelivery)** - for reporting the delivery of inventory items Because the InventoryItem resource does not contain all the clinical characteristics of the products like Medication, Device, etc. the InventoryItem can refer to any of those product items. ## Background and Context Provides additional detail on exactly how the resource is to be used ## Notes \[%stu-note dstu2%\] TThe draft resource InventoryItem is intended to satisfy a narrow set of use cases. Implementer feedback is welcome, and needed, to assess the resource's suitability and viability. Without implementation feedback, this resource may be removed in future releases of FHIR. Feedback is welcome [here](http://hl7.org/fhir-issues). \[%end-note%\] ## StructureDefinition ### Elements (Simplified) - **[InventoryItem](/inventoryitem-definitions#InventoryItem)** [0..*]: - A functional description of an inventory item used in inventory and supply-related workflows - **[InventoryItem.identifier](/inventoryitem-definitions#InventoryItem.identifier)** [0..*]: [Identifier](/Identifier) Business identifier for the inventory item - **[InventoryItem.status](/inventoryitem-definitions#InventoryItem.status)** [1..1]: [code](/code) required:[inventoryitem-status](/valueset-inventoryitem-status) active | inactive | entered-in-error | unknown - **[InventoryItem.category](/inventoryitem-definitions#InventoryItem.category)** [0..*]: [CodeableConcept](/CodeableConcept) Category or class of the item - **[InventoryItem.code](/inventoryitem-definitions#InventoryItem.code)** [0..*]: [CodeableConcept](/CodeableConcept) Code designating the specific type of item - **[InventoryItem.name](/inventoryitem-definitions#InventoryItem.name)** [0..*]: [BackboneElement](/BackboneElement) The item name(s) - the brand name, or common name, functional name, generic name or others - **[InventoryItem.name.nameType](/inventoryitem-definitions#InventoryItem.name.nameType)** [1..1]: [Coding](/Coding) preferred:[inventoryitem-nametype](/valueset-inventoryitem-nametype) The type of name e.g. 'brand-name', 'functional-name', 'common-name' - **[InventoryItem.name.language](/inventoryitem-definitions#InventoryItem.name.language)** [1..1]: [code](/code) required:[languages](/valueset-languages) The language used to express the item name - **[InventoryItem.name.name](/inventoryitem-definitions#InventoryItem.name.name)** [1..1]: [string](/string) The name or designation of the item - **[InventoryItem.responsibleOrganization](/inventoryitem-definitions#InventoryItem.responsibleOrganization)** [0..*]: [BackboneElement](/BackboneElement) Organization(s) responsible for the product - **[InventoryItem.responsibleOrganization.role](/inventoryitem-definitions#InventoryItem.responsibleOrganization.role)** [1..1]: [CodeableConcept](/CodeableConcept) The role of the organization e.g. manufacturer, distributor, or other - **[InventoryItem.responsibleOrganization.organization](/inventoryitem-definitions#InventoryItem.responsibleOrganization.organization)** [1..1]: Reference([Organization](/Organization)) An organization that is associated with the item - **[InventoryItem.description](/inventoryitem-definitions#InventoryItem.description)** [0..1]: [BackboneElement](/BackboneElement) Descriptive characteristics of the item - **[InventoryItem.description.language](/inventoryitem-definitions#InventoryItem.description.language)** [0..1]: [code](/code) required:[languages](/valueset-languages) The language that is used in the item description - **[InventoryItem.description.description](/inventoryitem-definitions#InventoryItem.description.description)** [0..1]: [string](/string) Textual description of the item - **[InventoryItem.inventoryStatus](/inventoryitem-definitions#InventoryItem.inventoryStatus)** [0..*]: [CodeableConcept](/CodeableConcept) The usage status like recalled, in use, discarded - **[InventoryItem.baseUnit](/inventoryitem-definitions#InventoryItem.baseUnit)** [0..1]: [CodeableConcept](/CodeableConcept) The base unit of measure - the unit in which the product is used or counted - **[InventoryItem.netContent](/inventoryitem-definitions#InventoryItem.netContent)** [0..1]: [Quantity](/Quantity)([SimpleQuantity](/SimpleQuantity)) Net content or amount present in the item - **[InventoryItem.association](/inventoryitem-definitions#InventoryItem.association)** [0..*]: [BackboneElement](/BackboneElement) Association with other items or products - **[InventoryItem.association.associationType](/inventoryitem-definitions#InventoryItem.association.associationType)** [1..1]: [CodeableConcept](/CodeableConcept) The type of association between the device and the other item - **[InventoryItem.association.relatedItem](/inventoryitem-definitions#InventoryItem.association.relatedItem)** [1..1]: [Reference(InventoryItem](/Reference(InventoryItem), [Medication](/Medication), [Device](/Device), [DeviceDefinition](/DeviceDefinition), [NutritionProduct](/NutritionProduct), [BiologicallyDerivedProduct)](/BiologicallyDerivedProduct)) The related item or product - **[InventoryItem.association.quantity](/inventoryitem-definitions#InventoryItem.association.quantity)** [1..1]: [Ratio](/Ratio) The quantity of the product in this product - **[InventoryItem.characteristic](/inventoryitem-definitions#InventoryItem.characteristic)** [0..*]: [BackboneElement](/BackboneElement) Characteristic of the item - **[InventoryItem.characteristic.characteristicType](/inventoryitem-definitions#InventoryItem.characteristic.characteristicType)** [1..1]: [CodeableConcept](/CodeableConcept) The characteristic that is being defined - **[InventoryItem.characteristic.value[x]](/inventoryitem-definitions#InventoryItem.characteristic.value%5Bx%5D)** [1..1]: [string](/string), [integer](/integer), [decimal](/decimal), [boolean](/boolean), [url](/url), [dateTime](/dateTime), [Quantity](/Quantity), [Range](/Range), [Ratio](/Ratio), [Annotation](/Annotation), [Address](/Address), [Duration](/Duration), [CodeableConcept](/CodeableConcept) The value of the attribute - **[InventoryItem.instance](/inventoryitem-definitions#InventoryItem.instance)** [0..1]: [BackboneElement](/BackboneElement) Instances or occurrences of the product - **[InventoryItem.instance.identifier](/inventoryitem-definitions#InventoryItem.instance.identifier)** [0..*]: [Identifier](/Identifier) The identifier for the physical instance, typically a serial number - **[InventoryItem.instance.lotNumber](/inventoryitem-definitions#InventoryItem.instance.lotNumber)** [0..1]: [string](/string) The lot or batch number of the item - **[InventoryItem.instance.expiry](/inventoryitem-definitions#InventoryItem.instance.expiry)** [0..1]: [dateTime](/dateTime) The expiry date or date and time for the product - **[InventoryItem.instance.subject](/inventoryitem-definitions#InventoryItem.instance.subject)** [0..1]: [Reference(Patient](/Reference(Patient), [Organization](/Organization), [Group)](/Group)) The subject that the item is associated with - **[InventoryItem.instance.location](/inventoryitem-definitions#InventoryItem.instance.location)** [0..1]: Reference([Location](/Location)) The location that the item is associated with - **[InventoryItem.productReference](/inventoryitem-definitions#InventoryItem.productReference)** [0..1]: [Reference(Medication](/Reference(Medication), [Device](/Device), [NutritionProduct](/NutritionProduct), [BiologicallyDerivedProduct)](/BiologicallyDerivedProduct)) Link to a product resource used in clinical workflows ## Mappings - [InventoryItem Mappings](/inventoryitem-mappings) — 1 mapping entries ## Resource Packs ### list-InventoryItem-packs.xml ```xml ``` ## Search Parameters - [code](/inventoryitem-search#code) — **token** — Search for products that match this code — `InventoryItem.code` - [subject](/inventoryitem-search#subject) — **reference** — The identity of a patient for whom to list associations — `InventoryItem.instance.subject` - [status](/inventoryitem-search#status) — **token** — The status of the item — `InventoryItem.status` - [identifier](/inventoryitem-search#identifier) — **token** — The identifier of the item — `InventoryItem.identifier` [Full Search Parameters](/inventoryitem-search) ## Examples - [example](/inventoryitem-example-example) — inventoryitem-example — General InventoryItem Example - [inventoryitem-example](/inventoryitem-example-inventoryitem-example) — inventoryitem-example - [inventoryitem-examples-header](/inventoryitem-example-inventoryitem-examples-header) — inventoryitem-examples-header [Full Examples](/inventoryitem-examples)