This page is part of the FHIR Specification (v4.4.0: R5 Preview #2). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3 R2
Orders and Observations Work Group | Maturity Level: 2 | Trial Use | Security Category: Business | Compartments: Not linked to any defined compartments |
A type of a manufactured item that is used in the provision of healthcare without being substantially changed through that activity. The device may be a medical or non-medical device.
This is a base resource that tracks individual instances of a device and their location. It is referenced by other resources for recording which device performed an action such as a procedure or an observation, which device was implanted in or explanted from a patient, dispensing a device to a patient for their use, managing inventory, or when requesting a specific device for a patient’s use. The resource may be used to document the Unique Device Identifier (UDI) information about a device where appropriate or necessary, such as a patient's implant.
Medical devices include durable (reusable) medical equipment, implantable devices, as well as disposable equipment used for diagnostic, treatment, and research for healthcare and public health. Non-medical devices may include items such as a machine, cellphone, computer, application, etc.
These are the device related resources
In FHIR, the Device represents either the device in total, or a component of a larger device when there is a need for individual tracking of a component. A Device as a component then points to the parent device it is part of. The Device captures the actual data about the instance of the device that either provides identifying characteristics of the Device (including applicable UDI – unique device identification) and data that can vary by device, e.g., specific settings at a particular point in time. The DeviceDefinition represents the data that is applicable to all devices that reference that DeviceDefinition.
The DeviceMetric model the dynamic aspects of the Device, including operation status of those aspects and is consequently much more volatile.
Devices differ from medications because they are not "used up" - they remain active in or for a patient for a longer duration. They also may be re-used, particularly non-implanted devices and those used for diagnostics and procedures. Frequently, when a device is packaged with a medication, the ordering, dispense, and administration processes typically focus on the medication aspects and reference the device, rather than that the Device is the focus of the ordering, dispense, and administration process. In the case of an infusion pump, while some actions are focused on the device (e.g., ordering to a room or maintaining the pump), the focus is as well on the medication while the device is used for administration. However, that separation is not always as clear and may be impacted by specific implementations. Regardless, the Medication resource should not be used to represent (implanted) devices, rather reference the relationship where an actual device needs to be tracked in addition to the medication.
This resource is referenced by Signature, Account, AdverseEvent, Appointment, AppointmentResponse, AuditEvent, CarePlan, CatalogEntry, ChargeItem, ChargeItemDefinition, Claim, ClinicalUseIssue, Communication, CommunicationRequest, Composition, Condition, Consent, Contract, DetectedIssue, itself, DeviceMetric, DeviceRequest, DiagnosticReport, DocumentManifest, DocumentReference, EvidenceVariable, ExplanationOfBenefit, Flag, Group, GuidanceResponse, ImagingStudy, Invoice, List, MeasureReport, MedicationAdministration, MedicationDispense, MedicationKnowledge, MedicationRequest, MessageHeader, MolecularSequence, NutritionIntake, Observation, ObservationDefinition, Procedure, Provenance, QuestionnaireResponse, RequestGroup, RiskAssessment, Schedule, ServiceRequest, Specimen, SupplyDelivery, SupplyRequest and Task.
This resource implements the Participant pattern.
Structure
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Device | TU | DomainResource | Item used in healthcare Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension | |
identifier | 0..* | Identifier | Instance identifier | |
displayName | 0..1 | string | The name used to display by default when the device is referenced | |
definition | 0..1 | Reference(DeviceDefinition) | The reference to the definition for the device | |
udiCarrier | Σ | 0..* | BackboneElement | Unique Device Identifier (UDI) Barcode string |
deviceIdentifier | Σ | 0..1 | string | Mandatory fixed portion of UDI |
issuer | 0..1 | uri | UDI Issuing Organization | |
jurisdiction | 0..1 | uri | Regional UDI authority | |
carrierAIDC | Σ | 0..1 | base64Binary | UDI Machine Readable Barcode String |
carrierHRF | Σ | 0..1 | string | UDI Human Readable Barcode String |
entryType | 0..1 | code | barcode | rfid | manual | card | self-reported | electronic-transmission | unknown UDIEntryType (Required) | |
status | ?!Σ | 0..1 | code | active | inactive | entered-in-error | unknown FHIRDeviceStatus (Required) |
statusReason | 0..* | CodeableConcept | online | paused | standby | offline | not-ready | transduc-discon | hw-discon | off FHIRDeviceStatusReason (Extensible) | |
distinctIdentifier | 0..1 | string | The distinct identification string | |
manufacturer | 0..1 | string | Name of device manufacturer | |
manufactureDate | 0..1 | dateTime | Date when the device was made | |
expirationDate | 0..1 | dateTime | Date and time of expiry of this device (if applicable) | |
lotNumber | 0..1 | string | Lot number of manufacture | |
serialNumber | 0..1 | string | Serial number assigned by the manufacturer | |
deviceName | 0..* | BackboneElement | The name or names of the device as known to the manufacturer and/or patient | |
name | 1..1 | string | The name that identifies the device | |
type | 1..1 | code | udi-label-name | user-friendly-name | patient-reported-name | manufacturer-name | model-name | other DeviceNameType (Required) | |
modelNumber | 0..1 | string | The manufacturer's model number for the device | |
partNumber | 0..1 | string | The part number or catalog number of the device | |
type | 0..* | CodeableConcept | The kind or type of device Device Type (Example) | |
specialization | 0..* | BackboneElement | The capabilities supported on a device, the standards to which the device conforms for a particular purpose, and used for the communication | |
systemType | 1..1 | CodeableConcept | The standard that is used to operate and communicate | |
version | 0..1 | string | The version of the standard that is used to operate and communicate | |
version | 0..* | BackboneElement | The actual design of the device or software version running on the device | |
type | 0..1 | CodeableConcept | The type of the device version, e.g. manufacturer, approved, internal | |
component | 0..1 | Identifier | The hardware or software module of the device to which the version applies | |
value | 1..1 | string | The version text | |
property | 0..* | BackboneElement | The actual configuration settings of a device as it actually operates, e.g., regulation status, time properties | |
type | 1..1 | CodeableConcept | Code that specifies the property being represented | |
valueQuantity | 0..* | Quantity | Property value as a quantity | |
valueCode | 0..* | CodeableConcept | Property value as a code, e.g., NTP4 (synced to NTP) | |
patient | 0..1 | Reference(Patient) | Patient to whom Device is affixed | |
operationalStatus | 0..1 | BackboneElement | The status of the device itself - whether it is switched on, or activated, etc | |
value | 0..1 | CodeableConcept | on |off | standby | |
reason | 0..* | CodeableConcept | The reasons given for the current operational status | |
associationStatus | 0..1 | BackboneElement | The state of the usage or application of the device | |
value | 0..1 | CodeableConcept | implanted|explanted|attached | |
reason | 0..* | CodeableConcept | The reasons given for the current association status | |
owner | 0..1 | Reference(Organization) | Organization responsible for device | |
contact | 0..* | ContactPoint | Details for human/organization for support | |
location | 0..1 | Reference(Location) | Where the device is found | |
url | 0..1 | uri | Network address to contact device | |
note | 0..* | Annotation | Device notes and comments | |
safety | Σ | 0..* | CodeableConcept | Safety Characteristics of Device |
parent | 0..1 | Reference(Device) | The device that this device is attached to or is part of | |
Documentation for this format |
UML Diagram (Legend)
XML Template
<Device xmlns="http://hl7.org/fhir"> <!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <identifier><!-- 0..* Identifier Instance identifier --></identifier> <displayName value="[string]"/><!-- 0..1 The name used to display by default when the device is referenced --> <definition><!-- 0..1 Reference(DeviceDefinition) The reference to the definition for the device --></definition> <udiCarrier> <!-- 0..* Unique Device Identifier (UDI) Barcode string --> <deviceIdentifier value="[string]"/><!-- 0..1 Mandatory fixed portion of UDI --> <issuer value="[uri]"/><!-- 0..1 UDI Issuing Organization --> <jurisdiction value="[uri]"/><!-- 0..1 Regional UDI authority --> <carrierAIDC value="[base64Binary]"/><!-- 0..1 UDI Machine Readable Barcode String --> <carrierHRF value="[string]"/><!-- 0..1 UDI Human Readable Barcode String --> <entryType value="[code]"/><!-- 0..1 barcode | rfid | manual | card | self-reported | electronic-transmission | unknown --> </udiCarrier> <status value="[code]"/><!-- 0..1 active | inactive | entered-in-error | unknown --> <statusReason><!-- 0..* CodeableConcept online | paused | standby | offline | not-ready | transduc-discon | hw-discon | off --></statusReason> <distinctIdentifier value="[string]"/><!-- 0..1 The distinct identification string --> <manufacturer value="[string]"/><!-- 0..1 Name of device manufacturer --> <manufactureDate value="[dateTime]"/><!-- 0..1 Date when the device was made --> <expirationDate value="[dateTime]"/><!-- 0..1 Date and time of expiry of this device (if applicable) --> <lotNumber value="[string]"/><!-- 0..1 Lot number of manufacture --> <serialNumber value="[string]"/><!-- 0..1 Serial number assigned by the manufacturer --> <deviceName> <!-- 0..* The name or names of the device as known to the manufacturer and/or patient --> <name value="[string]"/><!-- 1..1 The name that identifies the device --> <type value="[code]"/><!-- 1..1 udi-label-name | user-friendly-name | patient-reported-name | manufacturer-name | model-name | other --> </deviceName> <modelNumber value="[string]"/><!-- 0..1 The manufacturer's model number for the device --> <partNumber value="[string]"/><!-- 0..1 The part number or catalog number of the device --> <type><!-- 0..* CodeableConcept The kind or type of device --></type> <specialization> <!-- 0..* The capabilities supported on a device, the standards to which the device conforms for a particular purpose, and used for the communication --> <systemType><!-- 1..1 CodeableConcept The standard that is used to operate and communicate --></systemType> <version value="[string]"/><!-- 0..1 The version of the standard that is used to operate and communicate --> </specialization> <version> <!-- 0..* The actual design of the device or software version running on the device --> <type><!-- 0..1 CodeableConcept The type of the device version, e.g. manufacturer, approved, internal --></type> <component><!-- 0..1 Identifier The hardware or software module of the device to which the version applies --></component> <value value="[string]"/><!-- 1..1 The version text --> </version> <property> <!-- 0..* The actual configuration settings of a device as it actually operates, e.g., regulation status, time properties --> <type><!-- 1..1 CodeableConcept Code that specifies the property being represented --></type> <valueQuantity><!-- 0..* Quantity Property value as a quantity --></valueQuantity> <valueCode><!-- 0..* CodeableConcept Property value as a code, e.g., NTP4 (synced to NTP) --></valueCode> </property> <patient><!-- 0..1 Reference(Patient) Patient to whom Device is affixed --></patient> <operationalStatus> <!-- 0..1 The status of the device itself - whether it is switched on, or activated, etc --> <value><!-- 0..1 CodeableConcept on |off | standby --></value> <reason><!-- 0..* CodeableConcept The reasons given for the current operational status --></reason> </operationalStatus> <associationStatus> <!-- 0..1 The state of the usage or application of the device --> <value><!-- 0..1 CodeableConcept implanted|explanted|attached --></value> <reason><!-- 0..* CodeableConcept The reasons given for the current association status --></reason> </associationStatus> <owner><!-- 0..1 Reference(Organization) Organization responsible for device --></owner> <contact><!-- 0..* ContactPoint Details for human/organization for support --></contact> <location><!-- 0..1 Reference(Location) Where the device is found --></location> <url value="[uri]"/><!-- 0..1 Network address to contact device --> <note><!-- 0..* Annotation Device notes and comments --></note> <safety><!-- 0..* CodeableConcept Safety Characteristics of Device --></safety> <parent><!-- 0..1 Reference(Device) The device that this device is attached to or is part of --></parent> </Device>
JSON Template
{ "resourceType" : "Device", // from Resource: id, meta, implicitRules, and language // from DomainResource: text, contained, extension, and modifierExtension "identifier" : [{ Identifier }], // Instance identifier "displayName" : "<string>", // The name used to display by default when the device is referenced "definition" : { Reference(DeviceDefinition) }, // The reference to the definition for the device "udiCarrier" : [{ // Unique Device Identifier (UDI) Barcode string "deviceIdentifier" : "<string>", // Mandatory fixed portion of UDI "issuer" : "<uri>", // UDI Issuing Organization "jurisdiction" : "<uri>", // Regional UDI authority "carrierAIDC" : "<base64Binary>", // UDI Machine Readable Barcode String "carrierHRF" : "<string>", // UDI Human Readable Barcode String "entryType" : "<code>" // barcode | rfid | manual | card | self-reported | electronic-transmission | unknown }], "status" : "<code>", // active | inactive | entered-in-error | unknown "statusReason" : [{ CodeableConcept }], // online | paused | standby | offline | not-ready | transduc-discon | hw-discon | off "distinctIdentifier" : "<string>", // The distinct identification string "manufacturer" : "<string>", // Name of device manufacturer "manufactureDate" : "<dateTime>", // Date when the device was made "expirationDate" : "<dateTime>", // Date and time of expiry of this device (if applicable) "lotNumber" : "<string>", // Lot number of manufacture "serialNumber" : "<string>", // Serial number assigned by the manufacturer "deviceName" : [{ // The name or names of the device as known to the manufacturer and/or patient "name" : "<string>", // R! The name that identifies the device "type" : "<code>" // R! udi-label-name | user-friendly-name | patient-reported-name | manufacturer-name | model-name | other }], "modelNumber" : "<string>", // The manufacturer's model number for the device "partNumber" : "<string>", // The part number or catalog number of the device "type" : [{ CodeableConcept }], // The kind or type of device "specialization" : [{ // The capabilities supported on a device, the standards to which the device conforms for a particular purpose, and used for the communication "systemType" : { CodeableConcept }, // R! The standard that is used to operate and communicate "version" : "<string>" // The version of the standard that is used to operate and communicate }], "version" : [{ // The actual design of the device or software version running on the device "type" : { CodeableConcept }, // The type of the device version, e.g. manufacturer, approved, internal "component" : { Identifier }, // The hardware or software module of the device to which the version applies "value" : "<string>" // R! The version text }], "property" : [{ // The actual configuration settings of a device as it actually operates, e.g., regulation status, time properties "type" : { CodeableConcept }, // R! Code that specifies the property being represented "valueQuantity" : [{ Quantity }], // Property value as a quantity "valueCode" : [{ CodeableConcept }] // Property value as a code, e.g., NTP4 (synced to NTP) }], "patient" : { Reference(Patient) }, // Patient to whom Device is affixed "operationalStatus" : { // The status of the device itself - whether it is switched on, or activated, etc "value" : { CodeableConcept }, // on |off | standby "reason" : [{ CodeableConcept }] // The reasons given for the current operational status }, "associationStatus" : { // The state of the usage or application of the device "value" : { CodeableConcept }, // implanted|explanted|attached "reason" : [{ CodeableConcept }] // The reasons given for the current association status }, "owner" : { Reference(Organization) }, // Organization responsible for device "contact" : [{ ContactPoint }], // Details for human/organization for support "location" : { Reference(Location) }, // Where the device is found "url" : "<uri>", // Network address to contact device "note" : [{ Annotation }], // Device notes and comments "safety" : [{ CodeableConcept }], // Safety Characteristics of Device "parent" : { Reference(Device) } // The device that this device is attached to or is part of }
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> . [ a fhir:Device; fhir:nodeRole fhir:treeRoot; # if this is the parser root # from Resource: .id, .meta, .implicitRules, and .language # from DomainResource: .text, .contained, .extension, and .modifierExtension fhir:Device.identifier [ Identifier ], ... ; # 0..* Instance identifier fhir:Device.displayName [ string ]; # 0..1 The name used to display by default when the device is referenced fhir:Device.definition [ Reference(DeviceDefinition) ]; # 0..1 The reference to the definition for the device fhir:Device.udiCarrier [ # 0..* Unique Device Identifier (UDI) Barcode string fhir:Device.udiCarrier.deviceIdentifier [ string ]; # 0..1 Mandatory fixed portion of UDI fhir:Device.udiCarrier.issuer [ uri ]; # 0..1 UDI Issuing Organization fhir:Device.udiCarrier.jurisdiction [ uri ]; # 0..1 Regional UDI authority fhir:Device.udiCarrier.carrierAIDC [ base64Binary ]; # 0..1 UDI Machine Readable Barcode String fhir:Device.udiCarrier.carrierHRF [ string ]; # 0..1 UDI Human Readable Barcode String fhir:Device.udiCarrier.entryType [ code ]; # 0..1 barcode | rfid | manual | card | self-reported | electronic-transmission | unknown ], ...; fhir:Device.status [ code ]; # 0..1 active | inactive | entered-in-error | unknown fhir:Device.statusReason [ CodeableConcept ], ... ; # 0..* online | paused | standby | offline | not-ready | transduc-discon | hw-discon | off fhir:Device.distinctIdentifier [ string ]; # 0..1 The distinct identification string fhir:Device.manufacturer [ string ]; # 0..1 Name of device manufacturer fhir:Device.manufactureDate [ dateTime ]; # 0..1 Date when the device was made fhir:Device.expirationDate [ dateTime ]; # 0..1 Date and time of expiry of this device (if applicable) fhir:Device.lotNumber [ string ]; # 0..1 Lot number of manufacture fhir:Device.serialNumber [ string ]; # 0..1 Serial number assigned by the manufacturer fhir:Device.deviceName [ # 0..* The name or names of the device as known to the manufacturer and/or patient fhir:Device.deviceName.name [ string ]; # 1..1 The name that identifies the device fhir:Device.deviceName.type [ code ]; # 1..1 udi-label-name | user-friendly-name | patient-reported-name | manufacturer-name | model-name | other ], ...; fhir:Device.modelNumber [ string ]; # 0..1 The manufacturer's model number for the device fhir:Device.partNumber [ string ]; # 0..1 The part number or catalog number of the device fhir:Device.type [ CodeableConcept ], ... ; # 0..* The kind or type of device fhir:Device.specialization [ # 0..* The capabilities supported on a device, the standards to which the device conforms for a particular purpose, and used for the communication fhir:Device.specialization.systemType [ CodeableConcept ]; # 1..1 The standard that is used to operate and communicate fhir:Device.specialization.version [ string ]; # 0..1 The version of the standard that is used to operate and communicate ], ...; fhir:Device.version [ # 0..* The actual design of the device or software version running on the device fhir:Device.version.type [ CodeableConcept ]; # 0..1 The type of the device version, e.g. manufacturer, approved, internal fhir:Device.version.component [ Identifier ]; # 0..1 The hardware or software module of the device to which the version applies fhir:Device.version.value [ string ]; # 1..1 The version text ], ...; fhir:Device.property [ # 0..* The actual configuration settings of a device as it actually operates, e.g., regulation status, time properties fhir:Device.property.type [ CodeableConcept ]; # 1..1 Code that specifies the property being represented fhir:Device.property.valueQuantity [ Quantity ], ... ; # 0..* Property value as a quantity fhir:Device.property.valueCode [ CodeableConcept ], ... ; # 0..* Property value as a code, e.g., NTP4 (synced to NTP) ], ...; fhir:Device.patient [ Reference(Patient) ]; # 0..1 Patient to whom Device is affixed fhir:Device.operationalStatus [ # 0..1 The status of the device itself - whether it is switched on, or activated, etc fhir:Device.operationalStatus.value [ CodeableConcept ]; # 0..1 on |off | standby fhir:Device.operationalStatus.reason [ CodeableConcept ], ... ; # 0..* The reasons given for the current operational status ]; fhir:Device.associationStatus [ # 0..1 The state of the usage or application of the device fhir:Device.associationStatus.value [ CodeableConcept ]; # 0..1 implanted|explanted|attached fhir:Device.associationStatus.reason [ CodeableConcept ], ... ; # 0..* The reasons given for the current association status ]; fhir:Device.owner [ Reference(Organization) ]; # 0..1 Organization responsible for device fhir:Device.contact [ ContactPoint ], ... ; # 0..* Details for human/organization for support fhir:Device.location [ Reference(Location) ]; # 0..1 Where the device is found fhir:Device.url [ uri ]; # 0..1 Network address to contact device fhir:Device.note [ Annotation ], ... ; # 0..* Device notes and comments fhir:Device.safety [ CodeableConcept ], ... ; # 0..* Safety Characteristics of Device fhir:Device.parent [ Reference(Device) ]; # 0..1 The device that this device is attached to or is part of ]
Changes since R3
Device | |
Device.displayName |
|
Device.udiCarrier.entryType |
|
Device.status |
|
Device.deviceName.type |
|
Device.type |
|
Device.operationalStatus |
|
Device.operationalStatus.value |
|
Device.operationalStatus.reason |
|
Device.associationStatus |
|
Device.associationStatus.value |
|
Device.associationStatus.reason |
|
See the Full Difference for further information
This analysis is available as XML or JSON.
See R3 <--> R4 Conversion Maps (status = 9 tests that all execute ok. All tests pass round-trip testing and 1 r3 resources are invalid (0 errors).)
Structure
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Device | TU | DomainResource | Item used in healthcare Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension | |
identifier | 0..* | Identifier | Instance identifier | |
displayName | 0..1 | string | The name used to display by default when the device is referenced | |
definition | 0..1 | Reference(DeviceDefinition) | The reference to the definition for the device | |
udiCarrier | Σ | 0..* | BackboneElement | Unique Device Identifier (UDI) Barcode string |
deviceIdentifier | Σ | 0..1 | string | Mandatory fixed portion of UDI |
issuer | 0..1 | uri | UDI Issuing Organization | |
jurisdiction | 0..1 | uri | Regional UDI authority | |
carrierAIDC | Σ | 0..1 | base64Binary | UDI Machine Readable Barcode String |
carrierHRF | Σ | 0..1 | string | UDI Human Readable Barcode String |
entryType | 0..1 | code | barcode | rfid | manual | card | self-reported | electronic-transmission | unknown UDIEntryType (Required) | |
status | ?!Σ | 0..1 | code | active | inactive | entered-in-error | unknown FHIRDeviceStatus (Required) |
statusReason | 0..* | CodeableConcept | online | paused | standby | offline | not-ready | transduc-discon | hw-discon | off FHIRDeviceStatusReason (Extensible) | |
distinctIdentifier | 0..1 | string | The distinct identification string | |
manufacturer | 0..1 | string | Name of device manufacturer | |
manufactureDate | 0..1 | dateTime | Date when the device was made | |
expirationDate | 0..1 | dateTime | Date and time of expiry of this device (if applicable) | |
lotNumber | 0..1 | string | Lot number of manufacture | |
serialNumber | 0..1 | string | Serial number assigned by the manufacturer | |
deviceName | 0..* | BackboneElement | The name or names of the device as known to the manufacturer and/or patient | |
name | 1..1 | string | The name that identifies the device | |
type | 1..1 | code | udi-label-name | user-friendly-name | patient-reported-name | manufacturer-name | model-name | other DeviceNameType (Required) | |
modelNumber | 0..1 | string | The manufacturer's model number for the device | |
partNumber | 0..1 | string | The part number or catalog number of the device | |
type | 0..* | CodeableConcept | The kind or type of device Device Type (Example) | |
specialization | 0..* | BackboneElement | The capabilities supported on a device, the standards to which the device conforms for a particular purpose, and used for the communication | |
systemType | 1..1 | CodeableConcept | The standard that is used to operate and communicate | |
version | 0..1 | string | The version of the standard that is used to operate and communicate | |
version | 0..* | BackboneElement | The actual design of the device or software version running on the device | |
type | 0..1 | CodeableConcept | The type of the device version, e.g. manufacturer, approved, internal | |
component | 0..1 | Identifier | The hardware or software module of the device to which the version applies | |
value | 1..1 | string | The version text | |
property | 0..* | BackboneElement | The actual configuration settings of a device as it actually operates, e.g., regulation status, time properties | |
type | 1..1 | CodeableConcept | Code that specifies the property being represented | |
valueQuantity | 0..* | Quantity | Property value as a quantity | |
valueCode | 0..* | CodeableConcept | Property value as a code, e.g., NTP4 (synced to NTP) | |
patient | 0..1 | Reference(Patient) | Patient to whom Device is affixed | |
operationalStatus | 0..1 | BackboneElement | The status of the device itself - whether it is switched on, or activated, etc | |
value | 0..1 | CodeableConcept | on |off | standby | |
reason | 0..* | CodeableConcept | The reasons given for the current operational status | |
associationStatus | 0..1 | BackboneElement | The state of the usage or application of the device | |
value | 0..1 | CodeableConcept | implanted|explanted|attached | |
reason | 0..* | CodeableConcept | The reasons given for the current association status | |
owner | 0..1 | Reference(Organization) | Organization responsible for device | |
contact | 0..* | ContactPoint | Details for human/organization for support | |
location | 0..1 | Reference(Location) | Where the device is found | |
url | 0..1 | uri | Network address to contact device | |
note | 0..* | Annotation | Device notes and comments | |
safety | Σ | 0..* | CodeableConcept | Safety Characteristics of Device |
parent | 0..1 | Reference(Device) | The device that this device is attached to or is part of | |
Documentation for this format |
XML Template
<Device xmlns="http://hl7.org/fhir"> <!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <identifier><!-- 0..* Identifier Instance identifier --></identifier> <displayName value="[string]"/><!-- 0..1 The name used to display by default when the device is referenced --> <definition><!-- 0..1 Reference(DeviceDefinition) The reference to the definition for the device --></definition> <udiCarrier> <!-- 0..* Unique Device Identifier (UDI) Barcode string --> <deviceIdentifier value="[string]"/><!-- 0..1 Mandatory fixed portion of UDI --> <issuer value="[uri]"/><!-- 0..1 UDI Issuing Organization --> <jurisdiction value="[uri]"/><!-- 0..1 Regional UDI authority --> <carrierAIDC value="[base64Binary]"/><!-- 0..1 UDI Machine Readable Barcode String --> <carrierHRF value="[string]"/><!-- 0..1 UDI Human Readable Barcode String --> <entryType value="[code]"/><!-- 0..1 barcode | rfid | manual | card | self-reported | electronic-transmission | unknown --> </udiCarrier> <status value="[code]"/><!-- 0..1 active | inactive | entered-in-error | unknown --> <statusReason><!-- 0..* CodeableConcept online | paused | standby | offline | not-ready | transduc-discon | hw-discon | off --></statusReason> <distinctIdentifier value="[string]"/><!-- 0..1 The distinct identification string --> <manufacturer value="[string]"/><!-- 0..1 Name of device manufacturer --> <manufactureDate value="[dateTime]"/><!-- 0..1 Date when the device was made --> <expirationDate value="[dateTime]"/><!-- 0..1 Date and time of expiry of this device (if applicable) --> <lotNumber value="[string]"/><!-- 0..1 Lot number of manufacture --> <serialNumber value="[string]"/><!-- 0..1 Serial number assigned by the manufacturer --> <deviceName> <!-- 0..* The name or names of the device as known to the manufacturer and/or patient --> <name value="[string]"/><!-- 1..1 The name that identifies the device --> <type value="[code]"/><!-- 1..1 udi-label-name | user-friendly-name | patient-reported-name | manufacturer-name | model-name | other --> </deviceName> <modelNumber value="[string]"/><!-- 0..1 The manufacturer's model number for the device --> <partNumber value="[string]"/><!-- 0..1 The part number or catalog number of the device --> <type><!-- 0..* CodeableConcept The kind or type of device --></type> <specialization> <!-- 0..* The capabilities supported on a device, the standards to which the device conforms for a particular purpose, and used for the communication --> <systemType><!-- 1..1 CodeableConcept The standard that is used to operate and communicate --></systemType> <version value="[string]"/><!-- 0..1 The version of the standard that is used to operate and communicate --> </specialization> <version> <!-- 0..* The actual design of the device or software version running on the device --> <type><!-- 0..1 CodeableConcept The type of the device version, e.g. manufacturer, approved, internal --></type> <component><!-- 0..1 Identifier The hardware or software module of the device to which the version applies --></component> <value value="[string]"/><!-- 1..1 The version text --> </version> <property> <!-- 0..* The actual configuration settings of a device as it actually operates, e.g., regulation status, time properties --> <type><!-- 1..1 CodeableConcept Code that specifies the property being represented --></type> <valueQuantity><!-- 0..* Quantity Property value as a quantity --></valueQuantity> <valueCode><!-- 0..* CodeableConcept Property value as a code, e.g., NTP4 (synced to NTP) --></valueCode> </property> <patient><!-- 0..1 Reference(Patient) Patient to whom Device is affixed --></patient> <operationalStatus> <!-- 0..1 The status of the device itself - whether it is switched on, or activated, etc --> <value><!-- 0..1 CodeableConcept on |off | standby --></value> <reason><!-- 0..* CodeableConcept The reasons given for the current operational status --></reason> </operationalStatus> <associationStatus> <!-- 0..1 The state of the usage or application of the device --> <value><!-- 0..1 CodeableConcept implanted|explanted|attached --></value> <reason><!-- 0..* CodeableConcept The reasons given for the current association status --></reason> </associationStatus> <owner><!-- 0..1 Reference(Organization) Organization responsible for device --></owner> <contact><!-- 0..* ContactPoint Details for human/organization for support --></contact> <location><!-- 0..1 Reference(Location) Where the device is found --></location> <url value="[uri]"/><!-- 0..1 Network address to contact device --> <note><!-- 0..* Annotation Device notes and comments --></note> <safety><!-- 0..* CodeableConcept Safety Characteristics of Device --></safety> <parent><!-- 0..1 Reference(Device) The device that this device is attached to or is part of --></parent> </Device>
JSON Template
{ "resourceType" : "Device", // from Resource: id, meta, implicitRules, and language // from DomainResource: text, contained, extension, and modifierExtension "identifier" : [{ Identifier }], // Instance identifier "displayName" : "<string>", // The name used to display by default when the device is referenced "definition" : { Reference(DeviceDefinition) }, // The reference to the definition for the device "udiCarrier" : [{ // Unique Device Identifier (UDI) Barcode string "deviceIdentifier" : "<string>", // Mandatory fixed portion of UDI "issuer" : "<uri>", // UDI Issuing Organization "jurisdiction" : "<uri>", // Regional UDI authority "carrierAIDC" : "<base64Binary>", // UDI Machine Readable Barcode String "carrierHRF" : "<string>", // UDI Human Readable Barcode String "entryType" : "<code>" // barcode | rfid | manual | card | self-reported | electronic-transmission | unknown }], "status" : "<code>", // active | inactive | entered-in-error | unknown "statusReason" : [{ CodeableConcept }], // online | paused | standby | offline | not-ready | transduc-discon | hw-discon | off "distinctIdentifier" : "<string>", // The distinct identification string "manufacturer" : "<string>", // Name of device manufacturer "manufactureDate" : "<dateTime>", // Date when the device was made "expirationDate" : "<dateTime>", // Date and time of expiry of this device (if applicable) "lotNumber" : "<string>", // Lot number of manufacture "serialNumber" : "<string>", // Serial number assigned by the manufacturer "deviceName" : [{ // The name or names of the device as known to the manufacturer and/or patient "name" : "<string>", // R! The name that identifies the device "type" : "<code>" // R! udi-label-name | user-friendly-name | patient-reported-name | manufacturer-name | model-name | other }], "modelNumber" : "<string>", // The manufacturer's model number for the device "partNumber" : "<string>", // The part number or catalog number of the device "type" : [{ CodeableConcept }], // The kind or type of device "specialization" : [{ // The capabilities supported on a device, the standards to which the device conforms for a particular purpose, and used for the communication "systemType" : { CodeableConcept }, // R! The standard that is used to operate and communicate "version" : "<string>" // The version of the standard that is used to operate and communicate }], "version" : [{ // The actual design of the device or software version running on the device "type" : { CodeableConcept }, // The type of the device version, e.g. manufacturer, approved, internal "component" : { Identifier }, // The hardware or software module of the device to which the version applies "value" : "<string>" // R! The version text }], "property" : [{ // The actual configuration settings of a device as it actually operates, e.g., regulation status, time properties "type" : { CodeableConcept }, // R! Code that specifies the property being represented "valueQuantity" : [{ Quantity }], // Property value as a quantity "valueCode" : [{ CodeableConcept }] // Property value as a code, e.g., NTP4 (synced to NTP) }], "patient" : { Reference(Patient) }, // Patient to whom Device is affixed "operationalStatus" : { // The status of the device itself - whether it is switched on, or activated, etc "value" : { CodeableConcept }, // on |off | standby "reason" : [{ CodeableConcept }] // The reasons given for the current operational status }, "associationStatus" : { // The state of the usage or application of the device "value" : { CodeableConcept }, // implanted|explanted|attached "reason" : [{ CodeableConcept }] // The reasons given for the current association status }, "owner" : { Reference(Organization) }, // Organization responsible for device "contact" : [{ ContactPoint }], // Details for human/organization for support "location" : { Reference(Location) }, // Where the device is found "url" : "<uri>", // Network address to contact device "note" : [{ Annotation }], // Device notes and comments "safety" : [{ CodeableConcept }], // Safety Characteristics of Device "parent" : { Reference(Device) } // The device that this device is attached to or is part of }
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> . [ a fhir:Device; fhir:nodeRole fhir:treeRoot; # if this is the parser root # from Resource: .id, .meta, .implicitRules, and .language # from DomainResource: .text, .contained, .extension, and .modifierExtension fhir:Device.identifier [ Identifier ], ... ; # 0..* Instance identifier fhir:Device.displayName [ string ]; # 0..1 The name used to display by default when the device is referenced fhir:Device.definition [ Reference(DeviceDefinition) ]; # 0..1 The reference to the definition for the device fhir:Device.udiCarrier [ # 0..* Unique Device Identifier (UDI) Barcode string fhir:Device.udiCarrier.deviceIdentifier [ string ]; # 0..1 Mandatory fixed portion of UDI fhir:Device.udiCarrier.issuer [ uri ]; # 0..1 UDI Issuing Organization fhir:Device.udiCarrier.jurisdiction [ uri ]; # 0..1 Regional UDI authority fhir:Device.udiCarrier.carrierAIDC [ base64Binary ]; # 0..1 UDI Machine Readable Barcode String fhir:Device.udiCarrier.carrierHRF [ string ]; # 0..1 UDI Human Readable Barcode String fhir:Device.udiCarrier.entryType [ code ]; # 0..1 barcode | rfid | manual | card | self-reported | electronic-transmission | unknown ], ...; fhir:Device.status [ code ]; # 0..1 active | inactive | entered-in-error | unknown fhir:Device.statusReason [ CodeableConcept ], ... ; # 0..* online | paused | standby | offline | not-ready | transduc-discon | hw-discon | off fhir:Device.distinctIdentifier [ string ]; # 0..1 The distinct identification string fhir:Device.manufacturer [ string ]; # 0..1 Name of device manufacturer fhir:Device.manufactureDate [ dateTime ]; # 0..1 Date when the device was made fhir:Device.expirationDate [ dateTime ]; # 0..1 Date and time of expiry of this device (if applicable) fhir:Device.lotNumber [ string ]; # 0..1 Lot number of manufacture fhir:Device.serialNumber [ string ]; # 0..1 Serial number assigned by the manufacturer fhir:Device.deviceName [ # 0..* The name or names of the device as known to the manufacturer and/or patient fhir:Device.deviceName.name [ string ]; # 1..1 The name that identifies the device fhir:Device.deviceName.type [ code ]; # 1..1 udi-label-name | user-friendly-name | patient-reported-name | manufacturer-name | model-name | other ], ...; fhir:Device.modelNumber [ string ]; # 0..1 The manufacturer's model number for the device fhir:Device.partNumber [ string ]; # 0..1 The part number or catalog number of the device fhir:Device.type [ CodeableConcept ], ... ; # 0..* The kind or type of device fhir:Device.specialization [ # 0..* The capabilities supported on a device, the standards to which the device conforms for a particular purpose, and used for the communication fhir:Device.specialization.systemType [ CodeableConcept ]; # 1..1 The standard that is used to operate and communicate fhir:Device.specialization.version [ string ]; # 0..1 The version of the standard that is used to operate and communicate ], ...; fhir:Device.version [ # 0..* The actual design of the device or software version running on the device fhir:Device.version.type [ CodeableConcept ]; # 0..1 The type of the device version, e.g. manufacturer, approved, internal fhir:Device.version.component [ Identifier ]; # 0..1 The hardware or software module of the device to which the version applies fhir:Device.version.value [ string ]; # 1..1 The version text ], ...; fhir:Device.property [ # 0..* The actual configuration settings of a device as it actually operates, e.g., regulation status, time properties fhir:Device.property.type [ CodeableConcept ]; # 1..1 Code that specifies the property being represented fhir:Device.property.valueQuantity [ Quantity ], ... ; # 0..* Property value as a quantity fhir:Device.property.valueCode [ CodeableConcept ], ... ; # 0..* Property value as a code, e.g., NTP4 (synced to NTP) ], ...; fhir:Device.patient [ Reference(Patient) ]; # 0..1 Patient to whom Device is affixed fhir:Device.operationalStatus [ # 0..1 The status of the device itself - whether it is switched on, or activated, etc fhir:Device.operationalStatus.value [ CodeableConcept ]; # 0..1 on |off | standby fhir:Device.operationalStatus.reason [ CodeableConcept ], ... ; # 0..* The reasons given for the current operational status ]; fhir:Device.associationStatus [ # 0..1 The state of the usage or application of the device fhir:Device.associationStatus.value [ CodeableConcept ]; # 0..1 implanted|explanted|attached fhir:Device.associationStatus.reason [ CodeableConcept ], ... ; # 0..* The reasons given for the current association status ]; fhir:Device.owner [ Reference(Organization) ]; # 0..1 Organization responsible for device fhir:Device.contact [ ContactPoint ], ... ; # 0..* Details for human/organization for support fhir:Device.location [ Reference(Location) ]; # 0..1 Where the device is found fhir:Device.url [ uri ]; # 0..1 Network address to contact device fhir:Device.note [ Annotation ], ... ; # 0..* Device notes and comments fhir:Device.safety [ CodeableConcept ], ... ; # 0..* Safety Characteristics of Device fhir:Device.parent [ Reference(Device) ]; # 0..1 The device that this device is attached to or is part of ]
Changes since Release 3
Device | |
Device.displayName |
|
Device.udiCarrier.entryType |
|
Device.status |
|
Device.deviceName.type |
|
Device.type |
|
Device.operationalStatus |
|
Device.operationalStatus.value |
|
Device.operationalStatus.reason |
|
Device.associationStatus |
|
Device.associationStatus.value |
|
Device.associationStatus.reason |
|
See the Full Difference for further information
This analysis is available as XML or JSON.
See R3 <--> R4 Conversion Maps (status = 9 tests that all execute ok. All tests pass round-trip testing and 1 r3 resources are invalid (0 errors).)
See the Profiles & Extensions and the alternate definitions: Master Definition XML + JSON, XML Schema/Schematron + JSON Schema, ShEx (for Turtle) + see the extensions, the spreadsheet version & the dependency analysis a
Path | Definition | Type | Reference |
---|---|---|---|
Device.udiCarrier.entryType | Codes to identify how UDI data was entered. | Required | UDIEntryType |
Device.status | The availability status of the device. | Required | FHIRDeviceStatus |
Device.statusReason | The availability status reason of the device. | Extensible | FHIRDeviceStatusReason |
Device.deviceName.type | The type of name the device is referred by. | Required | DeviceNameType |
Device.type | Codes to identify medical devices. | Example | DeviceType |
Nearly all devices are assigned a string of characters to represent one or more identifiers or codes, which are usually printed or affixed to the device using either barcodes or RFIDs. The identifier or code can come from the manufacturer (for example, a 'serial number', 'reference number', or 'catalog number'), various institution and registries. Any of these identifiers or codes assigned to the device can and should be recorded in the device resource. However, there can there can be confusion where to represent them in the resource because codes and identifiers are represented in FHIR as semantically distinct elements and because organizations may conflate the term 'code' for an identifier or 'identifier' for a code in their names.
The identifier
element is only intended for use when it's an actual identifier for a specific instance of a device. That would mean that each device would have a separate serial number and would be represented using this element - devices without serial numbers (for example, a box of syringes) would not. Concepts such as a reference number or catalog number or GTIN describe a code which represents a kind of device and are conveyed using the type
element. Some sources of standard codes for devices and translations within type
are listed below:
The International Medical Device Regulators Forum IMDRF UDI Working Group published UDI System for Medical Devices (Version 2.0) , the base specification for Unique Device Identifiers (UDI). The United States Food and Drug Administration has produced an implementation guide for Unique Device Identifiers (UDI) which implements the IMDRF specification and other jurisdictions may produce similar IMDRF implementation guides as well. The full UDI string that represents the barcode as printed on the packaging of the device or Automatic Identification and Data Capture (AIDC) representation is called the "UDI carrier". The UDI has 2 components*:
*non-UDI elements may also appear within the UDI carrier. **a "GTIN" (sometimes also called an EAN number) is a code developed by GS1 for the kind of device not an identifier for the device. A GTIN may appear on its own or it may appear in a UDI string as the DI component.
The DI of the UDI may be stored in a jurisdictional repository and used as the primary key to access other device information. For example, in the United States, the DI of the UDI is submitted in a device record to the Global Unique Device Identification Database (GUDID) . The UDI may identify an instance of a device uniquely (when the PI includes a serial number), or it may just identify the type of the device. The UDI is parsed into its constituent parts (DI, PI and other elements) by parsing rules developed by each Issuing Agency standard. Where the device has an assigned UDI, the other details carried in the resource (e.g., lot, expiration date, etc.) SHALL be consistent with the information encoded in the UDI string or registered in the local repository.
Best practice guidelines for transmitting UDI data using the Device resource dictate transmitting both the UDI Carrier and all components found within the UDI as described in Device UDI Mapping. Several examples are provided for further guidance.
Search parameters for this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.
Name | Type | Description | Expression | In Common |
definition | reference | The definition / type of the device | Device.definition (DeviceDefinition) | |
device-name | string | A server defined search that may match any of the string fields in Device.deviceName or Device.type. | Device.deviceName.name | Device.type.coding.display | Device.type.text | |
expiration-date N | date | The expiration date of the device | Device.expirationDate | |
identifier | token | Instance id from manufacturer, owner, and others | Device.identifier | |
location | reference | A location, where the resource is found | Device.location (Location) | |
lot-number N | string | The lot number of the device | Device.lotNumber | |
manufacture-date N | date | The manufacture date of the device | Device.manufactureDate | |
manufacturer N | string | The manufacturer of the device | Device.manufacturer | |
model N | string | The model of the device | Device.modelNumber | |
organization | reference | The organization responsible for the device | Device.owner (Organization) | |
parent | reference | The parent device | Device.parent (Device) | |
patient | reference | Patient information, if the resource is affixed to a person | Device.patient (Patient) | |
serial-number N | string | The serial number of the device | Device.serialNumber | |
status N | token | active | inactive | entered-in-error | unknown | Device.status | |
type | token | The type of the device | Device.type | |
udi-carrier | string | UDI Barcode (RFID or other technology) string in *HRF* format. | Device.udiCarrier.carrierHRF | |
udi-di | string | The udi Device Identifier (DI) | Device.udiCarrier.deviceIdentifier | |
url N | uri | Network address to contact device | Device.url | |
version N | string | The specific version of the device | Device.version.value |