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 - when counting items in an inventory
• SupplyRequest- for requesting the supply of inventory items
• 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. [%end-note%]

StructureDefinition

Elements (Simplified)

• InventoryItem [0..*]: - A functional description of an inventory item used in inventory and supply-related workflows
• InventoryItem.identifier [0..*]: Identifier Business identifier for the inventory item
• InventoryItem.status [1..1]: code required:inventoryitem-status active | inactive | entered-in-error | unknown
• InventoryItem.category [0..*]: CodeableConcept Category or class of the item
• InventoryItem.code [0..*]: CodeableConcept Code designating the specific type of item
• InventoryItem.name [0..*]: BackboneElement The item name(s) - the brand name, or common name, functional name, generic name or others
• InventoryItem.name.nameType [1..1]: Coding preferred:inventoryitem-nametype The type of name e.g. 'brand-name', 'functional-name', 'common-name'
• InventoryItem.name.language [1..1]: code required:languages The language used to express the item name
• InventoryItem.name.name [1..1]: string The name or designation of the item
• InventoryItem.responsibleOrganization [0..*]: BackboneElement Organization(s) responsible for the product
• InventoryItem.responsibleOrganization.role [1..1]: CodeableConcept The role of the organization e.g. manufacturer, distributor, or other
• InventoryItem.responsibleOrganization.organization [1..1]: Reference(Organization) An organization that is associated with the item
• InventoryItem.description [0..1]: BackboneElement Descriptive characteristics of the item
• InventoryItem.description.language [0..1]: code required:languages The language that is used in the item description
• InventoryItem.description.description [0..1]: string Textual description of the item
• InventoryItem.inventoryStatus [0..*]: CodeableConcept The usage status like recalled, in use, discarded
• InventoryItem.baseUnit [0..1]: CodeableConcept The base unit of measure - the unit in which the product is used or counted
• InventoryItem.netContent [0..1]: Quantity(SimpleQuantity) Net content or amount present in the item
• InventoryItem.association [0..*]: BackboneElement Association with other items or products
• InventoryItem.association.associationType [1..1]: CodeableConcept The type of association between the device and the other item
• InventoryItem.association.relatedItem [1..1]: [Reference(InventoryItem](/Reference(InventoryItem), Medication, Device, DeviceDefinition, NutritionProduct, BiologicallyDerivedProduct)) The related item or product
• InventoryItem.association.quantity [1..1]: Ratio The quantity of the product in this product
• InventoryItem.characteristic [0..*]: BackboneElement Characteristic of the item
• InventoryItem.characteristic.characteristicType [1..1]: CodeableConcept The characteristic that is being defined
• InventoryItem.characteristic.value[x] [1..1]: string, integer, decimal, boolean, url, dateTime, Quantity, Range, Ratio, Annotation, Address, Duration, CodeableConcept The value of the attribute
• InventoryItem.instance [0..1]: BackboneElement Instances or occurrences of the product
• InventoryItem.instance.identifier [0..*]: Identifier The identifier for the physical instance, typically a serial number
• InventoryItem.instance.lotNumber [0..1]: string The lot or batch number of the item
• InventoryItem.instance.expiry [0..1]: dateTime The expiry date or date and time for the product
• InventoryItem.instance.subject [0..1]: [Reference(Patient](/Reference(Patient), Organization, Group)) The subject that the item is associated with
• InventoryItem.instance.location [0..1]: Reference(Location) The location that the item is associated with
• InventoryItem.productReference [0..1]: [Reference(Medication](/Reference(Medication), Device, NutritionProduct, BiologicallyDerivedProduct)) Link to a product resource used in clinical workflows

Mappings

• InventoryItem Mappings — 1 mapping entries

Resource Packs

list-InventoryItem-packs.xml

<?xml version="1.0" encoding="UTF-8"?>

<List xmlns="http://hl7.org/fhir">
  <id value="InventoryItem-packs"/>
  <status value="current"/>
  <mode value="working"/>
</List>

Search Parameters

• code — token — Search for products that match this code — InventoryItem.code
• subject — reference — The identity of a patient for whom to list associations — InventoryItem.instance.subject
• status — token — The status of the item — InventoryItem.status
• identifier — token — The identifier of the item — InventoryItem.identifier

Full Search Parameters

Examples

• example — inventoryitem-example — General InventoryItem Example
• inventoryitem-example — inventoryitem-example
• inventoryitem-examples-header — inventoryitem-examples-header

Full Examples