DataStandardsWales-Specimen

The Specimen resource contains information about a sample to be used for analysis.

The DataStandardsWales-Specimen profile is derived from the UK Core Specimen Profile and is therefore listed as experimental. It defines additional rules for use within health and care organisations in Wales.

A direct link to the Data Standards Wales asset can be accessed here - Data Standards Wales Specimen

Formal Views of Profile Content

identifierS Σ0..*Identifier
accessionIdentifierΣ0..1Identifier
statusS Σ ?!0..1codeBinding
typeS Σ1..1CodeableConceptBinding
subjectS Σ I1..1Reference(Group | Substance | DataStandardsWalesPatient | DataStandardsWalesLocation | DataStandardsWalesDevice)
receivedTimeS Σ0..1dateTime
parentI0..*Reference(DataStandardsWalesSpecimen)
requestS I0..*Reference(DataStandardsWalesServiceRequest)
conditionΣ0..*CodeableConceptBinding
note0..*Annotation
identifierS Σ0..*Identifier
typeS Σ1..1CodeableConceptBinding
subjectS Σ I1..1Reference(Group | Substance | DataStandardsWalesPatient | DataStandardsWalesLocation | DataStandardsWalesDevice)
parentI0..*Reference(DataStandardsWalesSpecimen)
requestS I0..*Reference(DataStandardsWalesServiceRequest)
identifierS Σ0..*Identifier
accessionIdentifierΣ0..1Identifier
statusS Σ ?!0..1codeBinding
typeS Σ1..1CodeableConceptBinding
subjectS Σ I1..1Reference(Group | Substance | DataStandardsWalesPatient | DataStandardsWalesLocation | DataStandardsWalesDevice)
receivedTimeS Σ0..1dateTime
parentI0..*Reference(DataStandardsWalesSpecimen)
requestS I0..*Reference(DataStandardsWalesServiceRequest)
conditionΣ0..*CodeableConceptBinding
note0..*Annotation

Mandatory and Must Support Data Elements

Refer to the Mandatory and Must Support page for guidance on how these elements should be interpreted.

Each Specimen must have:

  1. A Type coding defining what the specimen is *
  2. A patient/subject reference *

Each Specimen must support:

  1. An identifier *
  2. A container
  3. A receivedTime
  4. A request reference
  5. A collection datetime

*see Implementation Guidance for the identifier element below

Implementation Guidance

  • The Specimen.type field SHALL be populated.
  • The Specimen.subject reference field SHALL be populated.

  • The Specimen.identifier field SHOULD contain all available identifiers. Typical identifiers include:
    • Identifiers assigned to the Specimen by the Welsh Results and Reporting Service

Example Specimens

The following example resources are provided within this guide: Example Specimen - Blood, Example Specimen - Urine

Mandatory Search Parameters

The following search parameters and search parameter combinations SHALL be supported:

  1. SHALL support fetching a Specimen using the _id search parameter:

    GET [base]/Specimen[id]
    

    Example:

    • GET \[base\]/Specimen/500011819107
    • GET \[base\]/Specimen?\_id=500011819107

    Implementation Notes: (how to search by the logical id of the resource)

  2. SHALL support searching using the combination of the patient and type search parameters:

    • including optional support for OR search on type (e.g.type={system|}[type],{system|}[type],...)
    GET [base]/Specimen?patient={Type/}[id]&type={system|[type]{,{system|}[type],...}
    

    Example:

    • GET \[base\]/Specimen?patient=Patient/NN046351-149&type=https://fhir.nhs.wales/Id/wrrs-specimen-type-code|blood

    Implementation Notes: Fetches a bundle of all Specimen resources for the specified patient and specimen type(s). SHOULD support search by multiple specimen types. (how to search by reference and how to search by token)

Optional Search Parameters

The following search parameters and search parameter combinations SHOULD be supported:

  1. SHOULD support searching using the combination of the patient and type and collected search parameters:

    • including optional support for OR search on type (e.g.type={system|}[type],{system|}[type],...)
    • including support for these collected comparators: gt,lt,ge,le
    • including optional support for AND search on collected (e.g.collected=[date]&collected=[date]]&...)
    GET [base]/Specimen?patient={Type/}[id]&type={system|[type]{,{system|}[type],...}&collected={gt|lt|ge|le}[date]{&collected={gt|lt|ge|le}[date]&...}
    

    Example:

    • GET \[base\]/Specimen?patient=Patient/NN046351-149&type=https://fhir.nhs.wales/Id/wrrs-specimen-type-code|blood&collected=ge2019-01-14T00:00:00Z

    Implementation Notes: Fetches a bundle of all Specimen resources for the specified patient and date and specimen type(s). SHOULD support search by multiple specimen types. (how to search by reference and how to search by token and how to search by date)