US Core Implementation Guide, published by HL7 International / Cross-Group Projects. This guide is not an authorized publication; it is the continuous build for version 8.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/US-Core/ and changes regularly. See the Directory of published versions
Official URL: http://hl7.org/fhir/us/core/StructureDefinition/us-core-specimen | Version: 8.0.0 | |||
Standards status: Trial-use | Computable Name: USCoreSpecimenProfile | |||
Other Identifiers: OID:2.16.840.1.113883.4.642.40.2.42.63 | ||||
Copyright/Legal: Used by permission of HL7 International, all rights reserved Creative Commons License |
The US Core Specimen Profile inherits from the FHIR Specimen resource; refer to it for scope and usage definitions. This profile sets minimum expectations for the Specimen resource to record, search, and fetch information about substances associated with a patient being sampled or tested (such as nasopharyngeal swab, whole blood, or serum). It specifies which core elements, extensions, vocabularies, and value sets SHALL be present and constrains how the elements are used. Providing the floor for standards development for specific use cases promotes interoperability and adoption.
Example Usage Scenarios:
The following are example usage scenarios for the US Core Specimen profile:
The following data elements must always be present (Mandatory definition) or must be supported if the data is present in the sending system (Must Support definition). They are presented below in a simple human-readable explanation. Profile specific guidance and examples are provided as well. The Formal Views below provides the formal summary, definitions, and terminology requirements.
Each Specimen Must Have:
Each Specimen Must Support:
Additional USCDI Requirements:
These Additional USCDI Requirements elements are not Mandatory or Must Support but are required for ONC Health IT certification testing and are included in the formal definition of the profile and the Specimen examples.
* see guidance below
Profile Specific Implementation Guidance:
Specimen.identifier
and Specimen.accessionIdentifier
are marked as Must Support, the Server system is not required to support both, but SHALL support at least one of these elements.
Usage:
Changes since version 7.0.0:
Description of Profiles, Differentials, Snapshots and how the different presentations work.
Other representations of profile: CSV, Excel, Schematron
Below is an overview of the required Server RESTful FHIR interactions for this profile - for example, search and read operations - when supporting the US Core interactions to access this profile's information (Profile Support + Interaction Support). Note that systems that support only US Core Profiles (Profile Only Support) are not required to support these interactions. See the US Core Server CapabilityStatement for a complete list of supported RESTful interactions for this IG.
Servers providing access to specimen data SHALL support these US Core SMART Scopes:
<patient|user|system>/Specimen.rs
The following search parameters and search parameter combinations SHALL be supported:
SHALL support both read Specimen by id
AND Specimen search using the _id
search parameter:
GET [base]/Specimen/[id]
or GET [base]/Specimen?_id=[id]
Example:
Implementation Notes: (how to search by the logical id of the resource)
The following search parameter combinations SHOULD be supported:
SHOULD support searching for all specimens for a patient using the patient
search parameter:
GET [base]/Specimen?patient={Type/}[id]
Example:
Implementation Notes: Fetches a bundle of all Specimen resources for the specified patient (how to search by reference)
Servers MAY support the _include
parameter to request that additional resources be included in the response of a search query. For example, when searching for an Observation or DiagnosticReport that references Specimen, the Client can use the _include
parameter to retrieve information about a specimen associated with the search results. The syntax for querying an Observation and the associated Specimen is:
GET [base]/[Resource-type]?[parameter1]=[value1]{&...}&_include=Observation:specimen
Example:
GET [base]/Observation?_id=9163726&_include=Observation:specimen