--- type: "resource" title: "SpecimenDefinition" resource: "SpecimenDefinition" --- # SpecimenDefinition ## Introduction ## Scope and Usage SpecimenDefinition will define a kind of specimen, which can be associated with in vitro diagnostic procedures described in a catalog of orderable services. SpecimenDefinition describes the kind of specimen to be collected from the subject of these procedures as well as the requirements applying to the collection activity, the preparation of the subject for this collection. This resource also describes the associated type(s) of specimen conditioned for testing, which are the output of the specimen collection activity. A specimen conditioned for testing is described with the type(s) of container and possible additive to be used, the minimal and normal volumes of collection, the conditions of storage, transportation and handling for the specimen once collected and conditioned. This resource is a necessary building block of a sharable catalog of orderable in vitro diagnostic services. The subjects of these orderable services may be human patients, non-human living subjects or non-living materials such as water, surfaces, medical devices, etc. All sub-specialties of clinical and anatomic pathology laboratories are concerned, as well as all care services prone to order in vitro diagnostic services to those laboratories. A catalog of orderable services generally belongs to a specific laboratory or facility. Nonetheless, the data items used to build this catalog are of universal meaning and interest. ## Boundaries and Relationships This resource relates to these other resources: - The SpecimenDefinition resource is referenced by the Catalog resource, which represents a whole catalog, to enable the creation and maintenance of kinds of specimens within a catalog of orderable diagnostic services. - The SpecimenDefinition resource references the SubstanceDefinition resource, in order to describe the type of substance (body fluid, other material) concerned by a kind of specimen. It also references the SubstanceDefinition resource to describe additives to be used in the production of specimens of some kind. ## Background and Context Provides additional detail on exactly how the resource is to be used ## StructureDefinition ### Elements (Simplified) - **[SpecimenDefinition](/specimendefinition-definitions#SpecimenDefinition)** [0..*]: - Kind of specimen - **[SpecimenDefinition.url](/specimendefinition-definitions#SpecimenDefinition.url)** [0..1]: [uri](/uri) Logical canonical URL to reference this SpecimenDefinition (globally unique) - **[SpecimenDefinition.identifier](/specimendefinition-definitions#SpecimenDefinition.identifier)** [0..1]: [Identifier](/Identifier) Business identifier - **[SpecimenDefinition.version](/specimendefinition-definitions#SpecimenDefinition.version)** [0..1]: [string](/string) Business version of the SpecimenDefinition - **[SpecimenDefinition.versionAlgorithm[x]](/specimendefinition-definitions#SpecimenDefinition.versionAlgorithm%5Bx%5D)** [0..1]: [string](/string), [Coding](/Coding) extensible:[version-algorithm](/valueset-version-algorithm) How to compare versions - **[SpecimenDefinition.name](/specimendefinition-definitions#SpecimenDefinition.name)** [0..1]: [string](/string) Name for this {{title}} (computer friendly) - **[SpecimenDefinition.title](/specimendefinition-definitions#SpecimenDefinition.title)** [0..1]: [string](/string) Name for this SpecimenDefinition (Human friendly) - **[SpecimenDefinition.derivedFromCanonical](/specimendefinition-definitions#SpecimenDefinition.derivedFromCanonical)** [0..*]: [canonical](/canonical) Based on FHIR definition of another SpecimenDefinition - **[SpecimenDefinition.derivedFromUri](/specimendefinition-definitions#SpecimenDefinition.derivedFromUri)** [0..*]: [uri](/uri) Based on external definition - **[SpecimenDefinition.status](/specimendefinition-definitions#SpecimenDefinition.status)** [1..1]: [code](/code) required:[publication-status](/valueset-publication-status) draft | active | retired | unknown - **[SpecimenDefinition.experimental](/specimendefinition-definitions#SpecimenDefinition.experimental)** [0..1]: [boolean](/boolean) If this SpecimenDefinition is not for real usage - **[SpecimenDefinition.subject[x]](/specimendefinition-definitions#SpecimenDefinition.subject%5Bx%5D)** [0..1]: [CodeableConcept](/CodeableConcept), Reference([Group](/Group)) Type of subject for specimen collection - **[SpecimenDefinition.date](/specimendefinition-definitions#SpecimenDefinition.date)** [0..1]: [dateTime](/dateTime) Date status first applied - **[SpecimenDefinition.publisher](/specimendefinition-definitions#SpecimenDefinition.publisher)** [0..1]: [string](/string) The name of the individual or organization that published the SpecimenDefinition - **[SpecimenDefinition.contact](/specimendefinition-definitions#SpecimenDefinition.contact)** [0..*]: [ContactDetail](/ContactDetail) Contact details for the publisher - **[SpecimenDefinition.description](/specimendefinition-definitions#SpecimenDefinition.description)** [0..1]: [markdown](/markdown) Natural language description of the SpecimenDefinition - **[SpecimenDefinition.useContext](/specimendefinition-definitions#SpecimenDefinition.useContext)** [0..*]: [UsageContext](/UsageContext) Content intends to support these contexts - **[SpecimenDefinition.jurisdiction](/specimendefinition-definitions#SpecimenDefinition.jurisdiction)** [0..*]: [CodeableConcept](/CodeableConcept) extensible:[jurisdiction](/valueset-jurisdiction) Jurisdiction of the authority that maintains the this SpecimenDefinition (if applicable) - **[SpecimenDefinition.purpose](/specimendefinition-definitions#SpecimenDefinition.purpose)** [0..1]: [markdown](/markdown) Why this SpecimenDefinition is defined - **[SpecimenDefinition.copyright](/specimendefinition-definitions#SpecimenDefinition.copyright)** [0..1]: [markdown](/markdown) Notice about intellectual property ownership, can include restrictions on use - **[SpecimenDefinition.copyrightLabel](/specimendefinition-definitions#SpecimenDefinition.copyrightLabel)** [0..1]: [string](/string) Copyright holder and year(s) - **[SpecimenDefinition.approvalDate](/specimendefinition-definitions#SpecimenDefinition.approvalDate)** [0..1]: [date](/date) When SpecimenDefinition was approved by publisher - **[SpecimenDefinition.lastReviewDate](/specimendefinition-definitions#SpecimenDefinition.lastReviewDate)** [0..1]: [date](/date) The date on which the asset content was last reviewed by the publisher - **[SpecimenDefinition.effectivePeriod](/specimendefinition-definitions#SpecimenDefinition.effectivePeriod)** [0..1]: [Period](/Period) The effective date range for the SpecimenDefinition - **[SpecimenDefinition.typeCollected](/specimendefinition-definitions#SpecimenDefinition.typeCollected)** [0..1]: [CodeableConcept](/CodeableConcept) example:[v2-0487](/valueset-v2-0487) Kind of material to collect - **[SpecimenDefinition.patientPreparation](/specimendefinition-definitions#SpecimenDefinition.patientPreparation)** [0..*]: [CodeableConcept](/CodeableConcept) example:[prepare-patient-prior-specimen-collection](/valueset-prepare-patient-prior-specimen-collection) Patient preparation for collection - **[SpecimenDefinition.timeAspect](/specimendefinition-definitions#SpecimenDefinition.timeAspect)** [0..1]: [string](/string) Time aspect for collection - **[SpecimenDefinition.collection](/specimendefinition-definitions#SpecimenDefinition.collection)** [0..*]: [CodeableConcept](/CodeableConcept) example:[specimen-collection](/valueset-specimen-collection) Specimen collection procedure - **[SpecimenDefinition.typeTested](/specimendefinition-definitions#SpecimenDefinition.typeTested)** [0..*]: [BackboneElement](/BackboneElement) Specimen in container intended for testing by lab - **[SpecimenDefinition.typeTested.isDerived](/specimendefinition-definitions#SpecimenDefinition.typeTested.isDerived)** [0..1]: [boolean](/boolean) Primary or secondary specimen - **[SpecimenDefinition.typeTested.type](/specimendefinition-definitions#SpecimenDefinition.typeTested.type)** [0..1]: [CodeableConcept](/CodeableConcept) example:[v2-0487](/valueset-v2-0487) Type of intended specimen - **[SpecimenDefinition.typeTested.preference](/specimendefinition-definitions#SpecimenDefinition.typeTested.preference)** [1..1]: [code](/code) required:[specimen-contained-preference](/valueset-specimen-contained-preference) preferred | alternate - **[SpecimenDefinition.typeTested.container](/specimendefinition-definitions#SpecimenDefinition.typeTested.container)** [0..1]: [BackboneElement](/BackboneElement) The specimen's container - **[SpecimenDefinition.typeTested.container.material](/specimendefinition-definitions#SpecimenDefinition.typeTested.container.material)** [0..1]: [CodeableConcept](/CodeableConcept) example:[container-material](/valueset-container-material) The material type used for the container - **[SpecimenDefinition.typeTested.container.type](/specimendefinition-definitions#SpecimenDefinition.typeTested.container.type)** [0..1]: [CodeableConcept](/CodeableConcept) example:[specimen-container-type](/valueset-specimen-container-type) Kind of container associated with the kind of specimen - **[SpecimenDefinition.typeTested.container.cap](/specimendefinition-definitions#SpecimenDefinition.typeTested.container.cap)** [0..1]: [CodeableConcept](/CodeableConcept) example:[container-cap](/valueset-container-cap) Color of container cap - **[SpecimenDefinition.typeTested.container.description](/specimendefinition-definitions#SpecimenDefinition.typeTested.container.description)** [0..1]: [markdown](/markdown) The description of the kind of container - **[SpecimenDefinition.typeTested.container.capacity](/specimendefinition-definitions#SpecimenDefinition.typeTested.container.capacity)** [0..1]: [Quantity](/Quantity)([SimpleQuantity](/SimpleQuantity)) The capacity of this kind of container - **[SpecimenDefinition.typeTested.container.minimumVolume[x]](/specimendefinition-definitions#SpecimenDefinition.typeTested.container.minimumVolume%5Bx%5D)** [0..1]: [Quantity](/Quantity)([SimpleQuantity](/SimpleQuantity)), [string](/string) Minimum volume - **[SpecimenDefinition.typeTested.container.additive](/specimendefinition-definitions#SpecimenDefinition.typeTested.container.additive)** [0..*]: [BackboneElement](/BackboneElement) Additive associated with container - **[SpecimenDefinition.typeTested.container.additive.additive[x]](/specimendefinition-definitions#SpecimenDefinition.typeTested.container.additive.additive%5Bx%5D)** [1..1]: [CodeableConcept](/CodeableConcept), Reference([SubstanceDefinition](/SubstanceDefinition)) example:[v2-0371](/valueset-v2-0371) Additive associated with container - **[SpecimenDefinition.typeTested.container.preparation](/specimendefinition-definitions#SpecimenDefinition.typeTested.container.preparation)** [0..1]: [markdown](/markdown) Special processing applied to the container for this specimen type - **[SpecimenDefinition.typeTested.requirement](/specimendefinition-definitions#SpecimenDefinition.typeTested.requirement)** [0..1]: [markdown](/markdown) Requirements for specimen delivery and special handling - **[SpecimenDefinition.typeTested.retentionTime](/specimendefinition-definitions#SpecimenDefinition.typeTested.retentionTime)** [0..1]: [Duration](/Duration) The usual time for retaining this kind of specimen - **[SpecimenDefinition.typeTested.singleUse](/specimendefinition-definitions#SpecimenDefinition.typeTested.singleUse)** [0..1]: [boolean](/boolean) Specimen for single use only - **[SpecimenDefinition.typeTested.rejectionCriterion](/specimendefinition-definitions#SpecimenDefinition.typeTested.rejectionCriterion)** [0..*]: [CodeableConcept](/CodeableConcept) example:[rejection-criteria](/valueset-rejection-criteria) Criterion specified for specimen rejection - **[SpecimenDefinition.typeTested.handling](/specimendefinition-definitions#SpecimenDefinition.typeTested.handling)** [0..*]: [BackboneElement](/BackboneElement) Specimen handling before testing - **[SpecimenDefinition.typeTested.handling.temperatureQualifier](/specimendefinition-definitions#SpecimenDefinition.typeTested.handling.temperatureQualifier)** [0..1]: [CodeableConcept](/CodeableConcept) example:[handling-condition](/valueset-handling-condition) Qualifies the interval of temperature - **[SpecimenDefinition.typeTested.handling.temperatureRange](/specimendefinition-definitions#SpecimenDefinition.typeTested.handling.temperatureRange)** [0..1]: [Range](/Range) Temperature range for these handling instructions - **[SpecimenDefinition.typeTested.handling.maxDuration](/specimendefinition-definitions#SpecimenDefinition.typeTested.handling.maxDuration)** [0..1]: [Duration](/Duration) Maximum preservation time - **[SpecimenDefinition.typeTested.handling.instruction](/specimendefinition-definitions#SpecimenDefinition.typeTested.handling.instruction)** [0..1]: [markdown](/markdown) Preservation instruction - **[SpecimenDefinition.typeTested.testingDestination](/specimendefinition-definitions#SpecimenDefinition.typeTested.testingDestination)** [0..*]: [CodeableConcept](/CodeableConcept) example:[diagnostic-service-sections](/valueset-diagnostic-service-sections) Where the specimen will be tested ## Mappings - [SpecimenDefinition Mappings](/specimendefinition-mappings) — 19 mapping entries ## Operations - [apply](/specimendefinition-operation-apply) — Apply — The apply operation applies a SpecimenDefinition in a given context to create a Specimen resource instance [Full Operations](/specimendefinition-operations) ## Resource Packs ### list-SpecimenDefinition-packs.xml ```xml ``` ## Search Parameters - [container](/specimendefinition-search#container) — **token** — The type of specimen conditioned in container expected by the lab — `SpecimenDefinition.typeTested.container.type` - [experimental](/specimendefinition-search#experimental) — **token** — Not for genuine usage (true) — `SpecimenDefinition.experimental` - [identifier](/specimendefinition-search#identifier) — **token** — The unique identifier associated with the SpecimenDefinition — `SpecimenDefinition.identifier` - [is-derived](/specimendefinition-search#is-derived) — **token** — Primary specimen (false) or derived specimen (true) — `SpecimenDefinition.typeTested.isDerived` - [status](/specimendefinition-search#status) — **token** — Publication status of the SpecimenDefinition: draft, active, retired, unknown — `SpecimenDefinition.status` - [title](/specimendefinition-search#title) — **string** — Human-friendly name of the SpecimenDefinition — `SpecimenDefinition.title` - [type](/specimendefinition-search#type) — **token** — The type of collected specimen — `SpecimenDefinition.typeCollected` - [type-tested](/specimendefinition-search#type-tested) — **token** — The type of specimen conditioned for testing — `SpecimenDefinition.typeTested.type` - [url](/specimendefinition-search#url) — **uri** — The uri that identifies the specimen definition — `SpecimenDefinition.url` [Full Search Parameters](/specimendefinition-search) ## Examples - [2364](/specimendefinition-example-2364) — specimendefinition-example-serum-plasma — Example definition of serum or plasma specimen. - [7](/specimendefinition-example-7) — specimendefinition-example — Example definition of venous blood specimen. - [specimendefinition-example](/specimendefinition-example-specimendefinition-example) — specimendefinition-example - [specimendefinition-example-serum-plasma](/specimendefinition-example-specimendefinition-example-serum-plasma) — specimendefinition-example-serum-plasma - [specimendefinition-examples-header](/specimendefinition-example-specimendefinition-examples-header) — specimendefinition-examples-header [Full Examples](/specimendefinition-examples) ## Mapping Exceptions ### specimendefinition-fivews-mapping-exceptions.xml ### Unmapped Elements - **FiveWs.recorded** — Unknown - **FiveWs.author** — Unknown - **FiveWs.actor** — Unknown - **FiveWs.cause** — Unknown - **FiveWs.version** — Unknown - **FiveWs.witness** — Unknown - **FiveWs.class** — Unknown - **FiveWs.where** — Unknown - **FiveWs.context** — Unknown - **FiveWs.init** — Unknown - **FiveWs.why** — Unknown - **FiveWs.identifier** — Unknown - **FiveWs.source** — Unknown - **FiveWs.who** — Unknown - **FiveWs.grade** — Unknown - **FiveWs.status** — Unknown - **FiveWs.planned** — Unknown - **FiveWs.done** — Unknown - **FiveWs.subject** — Unknown