Specimen

Usage

Specimen resource holds data about containers linked to specific patient and order.

It could be used by MedNAIS clients to display the following info: * order of draw; * containers used in sampling with exact scan timestamp.

See Specimen status for more info.

Coding systems

Container code

{
  "system": "https://samplify.org/docs/fhir/dstu3/Specimen/container/identifier/system#/code",
  "value": "<string>" // usually Code128 chars on tube
}

Define container was created in anonymous mode

{
  "system": "https://samplify.org/docs/fhir/dstu3/Specimen/container/identifier/system#/anonymous",
  "value": "anonymous" // only "anonymous" value at the moment (1)
}

1. value set may be extended in future

References

It does not require to reference any resources except specified by FHIR.

Status

MedNAIS recognizes th following status options: * "available" specimens has been actually scanned; * "unavailable" specimens are treated as an order of draw.

The status implementation is a subject for future discussions and change because FHIR DSTU3 does not suggest a straightforward solution to specify order of draw.

Examples

Specimen created by MedNAIS client operating in anonymous mode

{
  "resourceType": "Specimen",
  "id": "555",
  "meta": {
    "extension": [
      {
        "url": "http://hapifhir.io/fhir/StructureDefinition/resource-meta-source",
        "valueUri": "#Vf8UsutEu7XU9x5l"
      }
    ],
    "versionId": "1",
    "lastUpdated": "2021-12-16T20:57:22.664+00:00",
    // Optional security labels could be used to implement ABAC.
    "security": [
      {
        // Specific code system 
        "system": "https://samplify.org/docs/fhir/dstu3/Resource/meta/security/system#/created-by",
        // User ID (actually from "subject" JWT claim) 
        "code": "251b6f94-9efb-445d-a9c1-795350f9e248"
      }
    ]
  },
  "status": "available",
  "subject": {
    // reference to predefined patient
    "reference": "Patient/487",
    "identifier": {
      "system": "https://samplify.org/docs/fhir/dstu3/Patient/identifier/system#/code",
      // patient code
      "value": "EDNGTNX9YM"
    }
  },
  "request": [
    {
      // reference to predefined order
      "reference": "ProcedureRequest/488"
    }
  ],
  "collection": {
    // sampling time
    "collectedDateTime": "2021-12-17T04:56:54+08:00"
  },
  "container": [
    {
      "identifier": [
        {
          "system": "https://samplify.org/docs/fhir/dstu3/Specimen/container/identifier/system#/code",
          // container code scanned
          "value": "BP211A05NH"
        }
      ]
    }
  ]
}