Единая платформа цифрового здравоохранения Узбекистана
0.5.0 - ci-build Uzbekistan флаг

Uzbekistan Digital Health Platform, опубликовано Ministry of Health of the Republic of Uzbekistan. Это руководство не является санкционированной публикацией; это непрерывная сборка для версии 0.5.0, созданной FHIR (HL7® FHIR® Standard) CI Build. Эта версия основана на нынешнем содержании https://github.com/uzinfocom-org/digital-health-ig/ и регулярно изменяется. Смотрите каталог опубликованных версий

Профиль ресурса: UZ Core Specimen ( Экспериментальный )

Официальный URL: https://dhp.uz/fhir/core/StructureDefinition/uz-core-specimen Версия: 0.5.0
Active по состоянию на 2026-06-05 Вычисляемое имя: UZCoreSpecimen

Uzbekistan Core profile for representing laboratory and other clinical specimens in Uzbekistan.

Машинный перевод, требуется проверка человеком. Эта страница автоматически переведена с английского языка с помощью искусственного интеллекта и пока не проверена редактором. При любых расхождениях приоритет имеет оригинальная англоязычная версия.

UZ Core Specimen представляет лабораторный или иной клинический образец, собранный у пациента на Цифровой платформе здравоохранения. В лабораторном потоке он находится между заказом и результатом: он ссылается на ServiceRequest, инициировавший сбор, а итоговое Observation ссылается обратно на образец, по которому было выполнено измерение.

Обязательные и поддерживаемые (Must Support) элементы данных

Перечисленные ниже элементы должны всегда присутствовать (обязательные) либо должны поддерживаться при наличии данных (Must Support) - не все они являются обязательными, но ваша система должна заполнять каждый элемент Must Support, когда у неё есть соответствующие данные, и обрабатывать его при получении. Это удобочитаемое для человека резюме; формальные представления ниже задают точные кардинальности, типы и терминологические связки.

Каждый UZ Core Specimen должен иметь (Must Have)

Данный профиль не добавляет собственной обязательной кардинальности, а базовый ресурс Specimen не имеет обязательных элементов - каждый ограничиваемый элемент является необязательным, но имеет признак Must Support.

Каждый UZ Core Specimen должен поддерживать (Must Support)

  • идентификатор, используемый исходной системой (например, ЛИС), и accessionIdentifier, присваиваемый лабораторией при получении;
  • статус (например, available, unavailable), связанный с набором значений DHP specimen-status;
  • тип (например, венозная кровь, моча, мазок; preferred-связка);
  • subject - откуда поступил образец: Patient, Location или Substance;
  • receivedTime - когда лаборатория получила образец;
  • ссылку на родительский образец (parent), когда данный образец получен/аликвотирован из другого;
  • request - ServiceRequest, по которому был заказан сбор;
  • признак combined (содержит ли контейнер объединённый (pooled) образец; required-связка) и role (preferred-связка);
  • детали сбора: collector (Practitioner), collected[x] дата/время, duration, quantity, method, bodySite и fastingStatus[x] (required-связка).

Построение JSON, шаг за шагом

Приведённые ниже примеры идут от наименьшего экземпляра, который примет сервер, до полного лабораторного образца. Скопируйте один из них и адаптируйте - каждое показанное значение проходит валидацию по этому профилю. Полный эталонный экземпляр приведён по ссылке внизу страницы (венозная кровь для ОАК).

Наименьший Specimen, который вам следует отправлять

Данный профиль не добавляет обязательной кардинальности, а базовый Specimen не имеет обязательных элементов - поэтому самая минимальная полезная нагрузка состоит лишь из meta.profile. Сам по себе он редко полезен. На практике первые три вещи, которые важны для лаборатории, - это что представляет собой образец (type), его статус жизненного цикла status и чей он (subject). subject - это простая Reference на Patient:

{
  "resourceType": "Specimen",
  "meta": { "profile": ["https://dhp.uz/fhir/core/StructureDefinition/uz-core-specimen"] },
  "status": "available",
  "type": {
    "coding": [{ "system": "http://terminology.hl7.org/CodeSystem/v2-0487", "code": "BLD", "display": "Whole blood" }]
  },
  "subject": { "reference": "Patient/example-salim" }
}

status связан с набором значений DHP specimen-status (required), а type - с набором значений specimen-types (preferred). Значение type BLD выше взято из таблицы HL7 v2 0487. subject также может ссылаться на Location (например, для пробы окружающей среды) или на Substance.

Полученный и заказанный образец

После того как лаборатория принимает образец, зафиксируйте, когда он поступил (receivedTime), заказ, инициировавший сбор (request, простая Reference на ServiceRequest), и role образца в рабочем процессе. Это типовая полезная нагрузка, создаваемая при регистрации образца:

{
  "resourceType": "Specimen",
  "meta": { "profile": ["https://dhp.uz/fhir/core/StructureDefinition/uz-core-specimen"] },
  "status": "available",
  "type": {
    "coding": [{ "system": "http://terminology.hl7.org/CodeSystem/v2-0487", "code": "BLD", "display": "Whole blood" }]
  },
  "subject": { "reference": "Patient/example-salim" },
  "receivedTime": "2025-11-04T08:30:00Z",
  "request": [
    { "reference": "ServiceRequest/example-cbc-order" }
  ],
  "role": [
    { "coding": [{ "system": "http://hl7.org/fhir/specimen-role", "code": "p", "display": "Patient" }] }
  ]
}

request - это то, что связывает образец с заказанными тестами; итоговое Observation затем ссылается обратно на этот образец через собственный элемент specimen. role - это preferred-связка; p (Patient) отмечает обычный образец пациента.

Добавление деталей сбора

Блок collection содержит сведения о том, как и когда был взят образец: collector (простая Reference на Practitioner), collectedDateTime (вариант выбора элемента collected[x]), duration и quantity в виде значений с кодами UCUM, а также свободнотекстовое note. Всегда передавайте машиночитаемые system и code для величин, а не только человекочитаемое unit:

{
  "resourceType": "Specimen",
  "meta": { "profile": ["https://dhp.uz/fhir/core/StructureDefinition/uz-core-specimen"] },
  "status": "available",
  "type": {
    "coding": [{ "system": "http://terminology.hl7.org/CodeSystem/v2-0487", "code": "BLD", "display": "Whole blood" }]
  },
  "subject": { "reference": "Patient/example-salim" },
  "receivedTime": "2025-11-04T08:30:00Z",
  "request": [
    { "reference": "ServiceRequest/example-cbc-order" }
  ],
  "role": [
    { "coding": [{ "system": "http://hl7.org/fhir/specimen-role", "code": "p", "display": "Patient" }] }
  ],
  "collection": {
    "collector": { "reference": "Practitioner/example-practitioner" },
    "collectedDateTime": "2025-11-04T08:10:00Z",
    "duration": { "value": 5, "code": "min", "system": "http://unitsofmeasure.org" },
    "quantity": { "value": 3, "unit": "mL", "code": "mL", "system": "http://unitsofmeasure.org" }
  },
  "note": [
    { "text": "Venous blood collected into EDTA tube. No visible hemolysis." }
  ]
}

​Обратите внимание, что collectedDateTime - это одна из форм выбора collected[x]; используйте вместо неё collectedPeriod для сбора по времени, охватывающего начало и конец. См. Единицы измерения и величины для правил UCUM, относящихся к duration и quantity.

Фиксация статуса натощак (fasting)

Когда статус натощак влияет на интерпретацию результата, зафиксируйте его внутри collection. Элемент fastingStatus[x] имеет required-связку; в виде кодированного значения это fastingStatusCodeableConcept. Здесь пациент подтвердил, что не соблюдал голодание:

{
  "collection": {
    "fastingStatusCodeableConcept": {
      "coding": [
        {
          "system": "http://terminology.hl7.org/CodeSystem/v2-0916",
          "code": "NF",
          "display": "The patient indicated they did not fast prior to the procedure."
        }
      ]
    }
  }
}

Этот блок collection встраивается в тот же ресурс, что и на предыдущем этапе. Используйте код, соответствующий фактическому состоянию пациента (в обязательном наборе значений перечислен каждый из них); не опускайте fastingStatus для тестов, где соблюдение голодания имеет значение.

​Примеры вызовов API и образец полезной нагрузки см. в разделе Быстрый старт внизу этой страницы.

Использование:

You can also check for usages in the FHIR IG Statistics

Формальные представления содержимого профиля

Описание профилей, дифференциалов, снимков и их представлений.

НаименованиеФлагиКарта.ТипОписание и ограничения    Filter: Filtersdoco
.. Specimen 0..* Specimen(5.0.0) Sample for analysis
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... contained 0..* Resource Contained, inline Resources
... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored
Constraints: ext-1
... accessionIdentifier SΣ 0..1 Identifier Laboratory accession identifier assigned when the specimen is accepted/registered by the laboratory. Used to link the specimen to lab workflows and results.
... status ?!SΣ 0..1 code Current lifecycle status of the specimen (e.g., available, unavailable).
Привязка: SpecimenStatusVS (0.5.0) (required)
... type SΣ 0..1 CodeableConcept Type of specimen (e.g., venous blood, urine, swab) used to interpret tests and processing requirements.
Привязка: SpecimenTypesVS (0.5.0) (preferred)
... subject SΣ 0..1 Reference(UZ Core Patient(0.5.0) | UZ Core Location(0.5.0) | Substance) Where the specimen came from. This may be from patient(s), from a location (e.g., the source of an environmental sample), or a sampling of a substance.
... receivedTime SΣ 0..1 dateTime Date/time the specimen was received by the laboratory/performing organization. Supports turnaround-time and traceability.
... parent S 0..* Reference(UZ Core Specimen(0.5.0)) Reference to the parent specimen when this specimen is derived/aliquoted from another specimen.
... request S 0..* Reference(ServiceRequest) Order/request that triggered the specimen collection. Enables linking specimen to ordered tests/services.
... combined SΣ 0..1 code Whether the container holds a pooled/combined specimen from multiple collection events or sources (if applicable).
Привязка: SpecimenCombinedVS (0.5.0) (required)
... role S 0..* CodeableConcept Role of this container in the overall specimen . Supports lab handling and result association.
Привязка: SpecimenRoleVS (0.5.0) (preferred)
... collection S 0..1 BackboneElement Collection details
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
Constraints: ext-1
.... collector SΣ 0..1 Reference(UZ Core Practitioner(0.5.0)) Practitioner who collected the specimen.
.... collected[x] SΣ 0..1 Date/time (or period) when the specimen was collected. Used for clinical interpretation and lab timing.
..... collectedDateTime dateTime
..... collectedPeriod Period
.... duration SΣ 0..1 Duration Duration of the collection process (e.g., timed urine collection). Important for correct result calculation/interpretation.
.... quantity S 0..1 SimpleQuantity(5.0.0) Amount/volume of specimen collected. Used for adequacy checks and processing requirements.
.... method S 0..1 CodeableConcept Technique used to perform collection
Привязка: SpecimenCollectionMethodVS (0.5.0) (required)
.... bodySite S 0..1 CodeableReference(BodyStructure) Anatomical site from which the specimen was collected.
Привязка: SNOMEDCTBodyStructures (required)
.... fastingStatus[x] SΣ 0..1 Patient fasting status at collection time (or relevant clinical information affecting interpretation).
Привязка: RelevantClinicalInformationVS (0.5.0) (required)
..... fastingStatusCodeableConcept CodeableConcept
..... fastingStatusDuration Duration

doco Документация для этого формата

Привязки к терминологии

Путь Статус Использование ValueSet Версия Источник
Specimen.status Base required Specimen Status 📍0.5.0 этот IG
Specimen.type Base preferred Specimen types 📍0.5.0 этот IG
Specimen.combined Base required Combined status of a specimen 📍0.5.0 этот IG
Specimen.role Base preferred Specimen role 📍0.5.0 этот IG
Specimen.collection.​method Base required Specimen collection methods (temp) 📍0.5.0 этот IG
Specimen.collection.​bodySite Base required SNOMED CT Body Structures 📍5.0.0 Стандарт FHIR
Specimen.collection.​fastingStatus[x] Base required Clinical information 📍0.5.0 этот IG

Ограничения

Id Градация Путь(и) Описание Выражение
dom-2 error Specimen If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Specimen If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().ofType(canonical) | %resource.descendants().ofType(uri) | %resource.descendants().ofType(url))) or descendants().where(reference = '#').exists() or descendants().where(ofType(canonical) = '#').exists() or descendants().where(ofType(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Specimen If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error Specimen If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 лучшая практика Specimen A resource should have narrative for robust management text.`div`.exists()
ele-1 error Specimen.implicitRules, Specimen.modifierExtension, Specimen.identifier, Specimen.accessionIdentifier, Specimen.status, Specimen.type, Specimen.subject, Specimen.receivedTime, Specimen.parent, Specimen.request, Specimen.combined, Specimen.role, Specimen.collection, Specimen.collection.modifierExtension, Specimen.collection.collector, Specimen.collection.collected[x], Specimen.collection.duration, Specimen.collection.quantity, Specimen.collection.method, Specimen.collection.bodySite, Specimen.collection.fastingStatus[x] All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error Specimen.modifierExtension, Specimen.collection.modifierExtension Must have either extensions or value[x], not both extension.exists() != value.exists()

НаименованиеФлагиКарта.ТипОписание и ограничения    Filter: Filtersdoco
.. Specimen 0..* Specimen(5.0.0) Sample for analysis
... identifier S 0..* Identifier Specimen identifier used by the source system (e.g., LIS). Enables tracking, matching, and referencing the specimen across systems.
... accessionIdentifier S 0..1 Identifier Laboratory accession identifier assigned when the specimen is accepted/registered by the laboratory. Used to link the specimen to lab workflows and results.
... status S 0..1 code Current lifecycle status of the specimen (e.g., available, unavailable).
Привязка: SpecimenStatusVS (0.5.0) (required)
... subject S 0..1 Reference(UZ Core Patient(0.5.0) | UZ Core Location(0.5.0) | Substance) Where the specimen came from. This may be from patient(s), from a location (e.g., the source of an environmental sample), or a sampling of a substance.
... receivedTime S 0..1 dateTime Date/time the specimen was received by the laboratory/performing organization. Supports turnaround-time and traceability.
... parent S 0..* Reference(UZ Core Specimen(0.5.0)) Reference to the parent specimen when this specimen is derived/aliquoted from another specimen.
... request S 0..* Reference(ServiceRequest) Order/request that triggered the specimen collection. Enables linking specimen to ordered tests/services.
... combined S 0..1 code Whether the container holds a pooled/combined specimen from multiple collection events or sources (if applicable).
Привязка: SpecimenCombinedVS (0.5.0) (required)
... role S 0..* CodeableConcept Role of this container in the overall specimen . Supports lab handling and result association.
Привязка: SpecimenRoleVS (0.5.0) (preferred)
... collection S 0..1 BackboneElement Collection details
.... collector S 0..1 Reference(UZ Core Practitioner(0.5.0)) Practitioner who collected the specimen.
.... collected[x] S 0..1 dateTime, Period Date/time (or period) when the specimen was collected. Used for clinical interpretation and lab timing.
.... duration S 0..1 Duration Duration of the collection process (e.g., timed urine collection). Important for correct result calculation/interpretation.
.... quantity S 0..1 SimpleQuantity(5.0.0) Amount/volume of specimen collected. Used for adequacy checks and processing requirements.
.... method S 0..1 CodeableConcept Technique used to perform collection
Привязка: SpecimenCollectionMethodVS (0.5.0) (required)
.... bodySite S 0..1 CodeableReference(BodyStructure) Anatomical site from which the specimen was collected.
Привязка: SNOMEDCTBodyStructures (required)
.... fastingStatus[x] S 0..1 CodeableConcept, Duration Patient fasting status at collection time (or relevant clinical information affecting interpretation).
Привязка: RelevantClinicalInformationVS (0.5.0) (required)

doco Документация для этого формата

Терминологические привязки (дифференциал)

Путь Статус Использование ValueSet Версия Источник
Specimen.status Base required Specimen Status 📍0.5.0 этот IG
Specimen.type Base preferred Specimen types 📍0.5.0 этот IG
Specimen.combined Base required Combined status of a specimen 📍0.5.0 этот IG
Specimen.role Base preferred Specimen role 📍0.5.0 этот IG
Specimen.collection.​method Base required Specimen collection methods (temp) 📍0.5.0 этот IG
Specimen.collection.​bodySite Base required SNOMED CT Body Structures 📍5.0.0 Стандарт FHIR
Specimen.collection.​fastingStatus[x] Base required Clinical information 📍0.5.0 этот IG
НаименованиеФлагиКарта.ТипОписание и ограничения    Filter: Filtersdoco
.. Specimen 0..* Specimen(5.0.0) Sample for analysis
... id Σ 0..1 id Logical id of this artifact
... meta Σ 0..1 Meta Metadata about the resource
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource Contained, inline Resources
... extension 0..* Extension Additional content defined by implementations
Constraints: ext-1
... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored
Constraints: ext-1
... identifier SΣ 0..* Identifier Specimen identifier used by the source system (e.g., LIS). Enables tracking, matching, and referencing the specimen across systems.
... accessionIdentifier SΣ 0..1 Identifier Laboratory accession identifier assigned when the specimen is accepted/registered by the laboratory. Used to link the specimen to lab workflows and results.
... status ?!SΣ 0..1 code Current lifecycle status of the specimen (e.g., available, unavailable).
Привязка: SpecimenStatusVS (0.5.0) (required)
... type SΣ 0..1 CodeableConcept Type of specimen (e.g., venous blood, urine, swab) used to interpret tests and processing requirements.
Привязка: SpecimenTypesVS (0.5.0) (preferred)
... subject SΣ 0..1 Reference(UZ Core Patient(0.5.0) | UZ Core Location(0.5.0) | Substance) Where the specimen came from. This may be from patient(s), from a location (e.g., the source of an environmental sample), or a sampling of a substance.
... receivedTime SΣ 0..1 dateTime Date/time the specimen was received by the laboratory/performing organization. Supports turnaround-time and traceability.
... parent S 0..* Reference(UZ Core Specimen(0.5.0)) Reference to the parent specimen when this specimen is derived/aliquoted from another specimen.
... request S 0..* Reference(ServiceRequest) Order/request that triggered the specimen collection. Enables linking specimen to ordered tests/services.
... combined SΣ 0..1 code Whether the container holds a pooled/combined specimen from multiple collection events or sources (if applicable).
Привязка: SpecimenCombinedVS (0.5.0) (required)
... role S 0..* CodeableConcept Role of this container in the overall specimen . Supports lab handling and result association.
Привязка: SpecimenRoleVS (0.5.0) (preferred)
... feature 0..* BackboneElement The physical feature of a specimen
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Constraints: ext-1
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
Constraints: ext-1
.... type 1..1 CodeableConcept Highlighted feature
Привязка: SNOMEDCTBodyStructures (example): SNOMED CT Body site concepts
.... description 1..1 string Information about the feature
... collection S 0..1 BackboneElement Collection details
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Constraints: ext-1
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
Constraints: ext-1
.... collector SΣ 0..1 Reference(UZ Core Practitioner(0.5.0)) Practitioner who collected the specimen.
.... collected[x] SΣ 0..1 Date/time (or period) when the specimen was collected. Used for clinical interpretation and lab timing.
..... collectedDateTime dateTime
..... collectedPeriod Period
.... duration SΣ 0..1 Duration Duration of the collection process (e.g., timed urine collection). Important for correct result calculation/interpretation.
.... quantity S 0..1 SimpleQuantity(5.0.0) Amount/volume of specimen collected. Used for adequacy checks and processing requirements.
.... method S 0..1 CodeableConcept Technique used to perform collection
Привязка: SpecimenCollectionMethodVS (0.5.0) (required)
.... device 0..1 CodeableReference(Device) Device used to perform collection
Описание привязки: (example): The device that was used to obtain the specimen (e.g. a catheter or catheter part used to draw the blood via a central line).
.... procedure 0..1 Reference(Procedure) The procedure that collects the specimen
.... bodySite S 0..1 CodeableReference(BodyStructure) Anatomical site from which the specimen was collected.
Привязка: SNOMEDCTBodyStructures (required)
.... fastingStatus[x] SΣ 0..1 Patient fasting status at collection time (or relevant clinical information affecting interpretation).
Привязка: RelevantClinicalInformationVS (0.5.0) (required)
..... fastingStatusCodeableConcept CodeableConcept
..... fastingStatusDuration Duration
... processing 0..* BackboneElement Processing and processing step details
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Constraints: ext-1
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
Constraints: ext-1
.... description 0..1 string Textual description of procedure
.... method 0..1 CodeableConcept Indicates the treatment step applied to the specimen
Привязка: SpecimenProcessingMethod (example): Type indicating the technique used to process the specimen.
.... additive 0..* Reference(Substance) Material used in the processing step
.... time[x] 0..1 Date and time of specimen processing
..... timeDateTime dateTime
..... timePeriod Period
... container 0..* BackboneElement Direct container of specimen (tube/slide, etc.)
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Constraints: ext-1
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
Constraints: ext-1
.... device 1..1 Reference(Device) Device resource for the container
.... location 0..1 Reference(Location) Where the container is
.... specimenQuantity 0..1 SimpleQuantity(5.0.0) Quantity of specimen within container
... condition Σ 0..* CodeableConcept State of the specimen
Привязка: Hl7VSSpecimenCondition (3.0.0) (extensible): Codes describing the state of the specimen.
... note 0..* Annotation Comments

doco Документация для этого формата

Привязки к терминологии

Путь Статус Использование ValueSet Версия Источник
Specimen.language Base required All Languages 📍5.0.0 Стандарт FHIR
Specimen.status Base required Specimen Status 📍0.5.0 этот IG
Specimen.type Base preferred Specimen types 📍0.5.0 этот IG
Specimen.combined Base required Combined status of a specimen 📍0.5.0 этот IG
Specimen.role Base preferred Specimen role 📍0.5.0 этот IG
Specimen.feature.type Base example SNOMED CT Body Structures 📍5.0.0 Стандарт FHIR
Specimen.collection.​method Base required Specimen collection methods (temp) 📍0.5.0 этот IG
Specimen.collection.​device Base example Not State Unknown
Specimen.collection.​bodySite Base required SNOMED CT Body Structures 📍5.0.0 Стандарт FHIR
Specimen.collection.​fastingStatus[x] Base required Clinical information 📍0.5.0 этот IG
Specimen.processing.​method Base example Specimen Processing Method 📍5.0.0 Стандарт FHIR
Specimen.condition Base extensible hl7VS-specimenCondition 📍3.0.0 THO v7.1

Ограничения

Id Градация Путь(и) Описание Выражение
dom-2 error Specimen If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Specimen If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().ofType(canonical) | %resource.descendants().ofType(uri) | %resource.descendants().ofType(url))) or descendants().where(reference = '#').exists() or descendants().where(ofType(canonical) = '#').exists() or descendants().where(ofType(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Specimen If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error Specimen If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 лучшая практика Specimen A resource should have narrative for robust management text.`div`.exists()
ele-1 error Specimen.meta, Specimen.implicitRules, Specimen.language, Specimen.text, Specimen.extension, Specimen.modifierExtension, Specimen.identifier, Specimen.accessionIdentifier, Specimen.status, Specimen.type, Specimen.subject, Specimen.receivedTime, Specimen.parent, Specimen.request, Specimen.combined, Specimen.role, Specimen.feature, Specimen.feature.extension, Specimen.feature.modifierExtension, Specimen.feature.type, Specimen.feature.description, Specimen.collection, Specimen.collection.extension, Specimen.collection.modifierExtension, Specimen.collection.collector, Specimen.collection.collected[x], Specimen.collection.duration, Specimen.collection.quantity, Specimen.collection.method, Specimen.collection.device, Specimen.collection.procedure, Specimen.collection.bodySite, Specimen.collection.fastingStatus[x], Specimen.processing, Specimen.processing.extension, Specimen.processing.modifierExtension, Specimen.processing.description, Specimen.processing.method, Specimen.processing.additive, Specimen.processing.time[x], Specimen.container, Specimen.container.extension, Specimen.container.modifierExtension, Specimen.container.device, Specimen.container.location, Specimen.container.specimenQuantity, Specimen.condition, Specimen.note All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error Specimen.extension, Specimen.modifierExtension, Specimen.feature.extension, Specimen.feature.modifierExtension, Specimen.collection.extension, Specimen.collection.modifierExtension, Specimen.processing.extension, Specimen.processing.modifierExtension, Specimen.container.extension, Specimen.container.modifierExtension Must have either extensions or value[x], not both extension.exists() != value.exists()

Просмотр ключевых элементов

НаименованиеФлагиКарта.ТипОписание и ограничения    Filter: Filtersdoco
.. Specimen 0..* Specimen(5.0.0) Sample for analysis
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... contained 0..* Resource Contained, inline Resources
... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored
Constraints: ext-1
... accessionIdentifier SΣ 0..1 Identifier Laboratory accession identifier assigned when the specimen is accepted/registered by the laboratory. Used to link the specimen to lab workflows and results.
... status ?!SΣ 0..1 code Current lifecycle status of the specimen (e.g., available, unavailable).
Привязка: SpecimenStatusVS (0.5.0) (required)
... type SΣ 0..1 CodeableConcept Type of specimen (e.g., venous blood, urine, swab) used to interpret tests and processing requirements.
Привязка: SpecimenTypesVS (0.5.0) (preferred)
... subject SΣ 0..1 Reference(UZ Core Patient(0.5.0) | UZ Core Location(0.5.0) | Substance) Where the specimen came from. This may be from patient(s), from a location (e.g., the source of an environmental sample), or a sampling of a substance.
... receivedTime SΣ 0..1 dateTime Date/time the specimen was received by the laboratory/performing organization. Supports turnaround-time and traceability.
... parent S 0..* Reference(UZ Core Specimen(0.5.0)) Reference to the parent specimen when this specimen is derived/aliquoted from another specimen.
... request S 0..* Reference(ServiceRequest) Order/request that triggered the specimen collection. Enables linking specimen to ordered tests/services.
... combined SΣ 0..1 code Whether the container holds a pooled/combined specimen from multiple collection events or sources (if applicable).
Привязка: SpecimenCombinedVS (0.5.0) (required)
... role S 0..* CodeableConcept Role of this container in the overall specimen . Supports lab handling and result association.
Привязка: SpecimenRoleVS (0.5.0) (preferred)
... collection S 0..1 BackboneElement Collection details
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
Constraints: ext-1
.... collector SΣ 0..1 Reference(UZ Core Practitioner(0.5.0)) Practitioner who collected the specimen.
.... collected[x] SΣ 0..1 Date/time (or period) when the specimen was collected. Used for clinical interpretation and lab timing.
..... collectedDateTime dateTime
..... collectedPeriod Period
.... duration SΣ 0..1 Duration Duration of the collection process (e.g., timed urine collection). Important for correct result calculation/interpretation.
.... quantity S 0..1 SimpleQuantity(5.0.0) Amount/volume of specimen collected. Used for adequacy checks and processing requirements.
.... method S 0..1 CodeableConcept Technique used to perform collection
Привязка: SpecimenCollectionMethodVS (0.5.0) (required)
.... bodySite S 0..1 CodeableReference(BodyStructure) Anatomical site from which the specimen was collected.
Привязка: SNOMEDCTBodyStructures (required)
.... fastingStatus[x] SΣ 0..1 Patient fasting status at collection time (or relevant clinical information affecting interpretation).
Привязка: RelevantClinicalInformationVS (0.5.0) (required)
..... fastingStatusCodeableConcept CodeableConcept
..... fastingStatusDuration Duration

doco Документация для этого формата

Привязки к терминологии

Путь Статус Использование ValueSet Версия Источник
Specimen.status Base required Specimen Status 📍0.5.0 этот IG
Specimen.type Base preferred Specimen types 📍0.5.0 этот IG
Specimen.combined Base required Combined status of a specimen 📍0.5.0 этот IG
Specimen.role Base preferred Specimen role 📍0.5.0 этот IG
Specimen.collection.​method Base required Specimen collection methods (temp) 📍0.5.0 этот IG
Specimen.collection.​bodySite Base required SNOMED CT Body Structures 📍5.0.0 Стандарт FHIR
Specimen.collection.​fastingStatus[x] Base required Clinical information 📍0.5.0 этот IG

Ограничения

Id Градация Путь(и) Описание Выражение
dom-2 error Specimen If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Specimen If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().ofType(canonical) | %resource.descendants().ofType(uri) | %resource.descendants().ofType(url))) or descendants().where(reference = '#').exists() or descendants().where(ofType(canonical) = '#').exists() or descendants().where(ofType(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Specimen If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error Specimen If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 лучшая практика Specimen A resource should have narrative for robust management text.`div`.exists()
ele-1 error Specimen.implicitRules, Specimen.modifierExtension, Specimen.identifier, Specimen.accessionIdentifier, Specimen.status, Specimen.type, Specimen.subject, Specimen.receivedTime, Specimen.parent, Specimen.request, Specimen.combined, Specimen.role, Specimen.collection, Specimen.collection.modifierExtension, Specimen.collection.collector, Specimen.collection.collected[x], Specimen.collection.duration, Specimen.collection.quantity, Specimen.collection.method, Specimen.collection.bodySite, Specimen.collection.fastingStatus[x] All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error Specimen.modifierExtension, Specimen.collection.modifierExtension Must have either extensions or value[x], not both extension.exists() != value.exists()

Дифференциальный вид

НаименованиеФлагиКарта.ТипОписание и ограничения    Filter: Filtersdoco
.. Specimen 0..* Specimen(5.0.0) Sample for analysis
... identifier S 0..* Identifier Specimen identifier used by the source system (e.g., LIS). Enables tracking, matching, and referencing the specimen across systems.
... accessionIdentifier S 0..1 Identifier Laboratory accession identifier assigned when the specimen is accepted/registered by the laboratory. Used to link the specimen to lab workflows and results.
... status S 0..1 code Current lifecycle status of the specimen (e.g., available, unavailable).
Привязка: SpecimenStatusVS (0.5.0) (required)
... subject S 0..1 Reference(UZ Core Patient(0.5.0) | UZ Core Location(0.5.0) | Substance) Where the specimen came from. This may be from patient(s), from a location (e.g., the source of an environmental sample), or a sampling of a substance.
... receivedTime S 0..1 dateTime Date/time the specimen was received by the laboratory/performing organization. Supports turnaround-time and traceability.
... parent S 0..* Reference(UZ Core Specimen(0.5.0)) Reference to the parent specimen when this specimen is derived/aliquoted from another specimen.
... request S 0..* Reference(ServiceRequest) Order/request that triggered the specimen collection. Enables linking specimen to ordered tests/services.
... combined S 0..1 code Whether the container holds a pooled/combined specimen from multiple collection events or sources (if applicable).
Привязка: SpecimenCombinedVS (0.5.0) (required)
... role S 0..* CodeableConcept Role of this container in the overall specimen . Supports lab handling and result association.
Привязка: SpecimenRoleVS (0.5.0) (preferred)
... collection S 0..1 BackboneElement Collection details
.... collector S 0..1 Reference(UZ Core Practitioner(0.5.0)) Practitioner who collected the specimen.
.... collected[x] S 0..1 dateTime, Period Date/time (or period) when the specimen was collected. Used for clinical interpretation and lab timing.
.... duration S 0..1 Duration Duration of the collection process (e.g., timed urine collection). Important for correct result calculation/interpretation.
.... quantity S 0..1 SimpleQuantity(5.0.0) Amount/volume of specimen collected. Used for adequacy checks and processing requirements.
.... method S 0..1 CodeableConcept Technique used to perform collection
Привязка: SpecimenCollectionMethodVS (0.5.0) (required)
.... bodySite S 0..1 CodeableReference(BodyStructure) Anatomical site from which the specimen was collected.
Привязка: SNOMEDCTBodyStructures (required)
.... fastingStatus[x] S 0..1 CodeableConcept, Duration Patient fasting status at collection time (or relevant clinical information affecting interpretation).
Привязка: RelevantClinicalInformationVS (0.5.0) (required)

doco Документация для этого формата

Терминологические привязки (дифференциал)

Путь Статус Использование ValueSet Версия Источник
Specimen.status Base required Specimen Status 📍0.5.0 этот IG
Specimen.type Base preferred Specimen types 📍0.5.0 этот IG
Specimen.combined Base required Combined status of a specimen 📍0.5.0 этот IG
Specimen.role Base preferred Specimen role 📍0.5.0 этот IG
Specimen.collection.​method Base required Specimen collection methods (temp) 📍0.5.0 этот IG
Specimen.collection.​bodySite Base required SNOMED CT Body Structures 📍5.0.0 Стандарт FHIR
Specimen.collection.​fastingStatus[x] Base required Clinical information 📍0.5.0 этот IG

Обзор моментальных снимковView

НаименованиеФлагиКарта.ТипОписание и ограничения    Filter: Filtersdoco
.. Specimen 0..* Specimen(5.0.0) Sample for analysis
... id Σ 0..1 id Logical id of this artifact
... meta Σ 0..1 Meta Metadata about the resource
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource Contained, inline Resources
... extension 0..* Extension Additional content defined by implementations
Constraints: ext-1
... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored
Constraints: ext-1
... identifier SΣ 0..* Identifier Specimen identifier used by the source system (e.g., LIS). Enables tracking, matching, and referencing the specimen across systems.
... accessionIdentifier SΣ 0..1 Identifier Laboratory accession identifier assigned when the specimen is accepted/registered by the laboratory. Used to link the specimen to lab workflows and results.
... status ?!SΣ 0..1 code Current lifecycle status of the specimen (e.g., available, unavailable).
Привязка: SpecimenStatusVS (0.5.0) (required)
... type SΣ 0..1 CodeableConcept Type of specimen (e.g., venous blood, urine, swab) used to interpret tests and processing requirements.
Привязка: SpecimenTypesVS (0.5.0) (preferred)
... subject SΣ 0..1 Reference(UZ Core Patient(0.5.0) | UZ Core Location(0.5.0) | Substance) Where the specimen came from. This may be from patient(s), from a location (e.g., the source of an environmental sample), or a sampling of a substance.
... receivedTime SΣ 0..1 dateTime Date/time the specimen was received by the laboratory/performing organization. Supports turnaround-time and traceability.
... parent S 0..* Reference(UZ Core Specimen(0.5.0)) Reference to the parent specimen when this specimen is derived/aliquoted from another specimen.
... request S 0..* Reference(ServiceRequest) Order/request that triggered the specimen collection. Enables linking specimen to ordered tests/services.
... combined SΣ 0..1 code Whether the container holds a pooled/combined specimen from multiple collection events or sources (if applicable).
Привязка: SpecimenCombinedVS (0.5.0) (required)
... role S 0..* CodeableConcept Role of this container in the overall specimen . Supports lab handling and result association.
Привязка: SpecimenRoleVS (0.5.0) (preferred)
... feature 0..* BackboneElement The physical feature of a specimen
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Constraints: ext-1
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
Constraints: ext-1
.... type 1..1 CodeableConcept Highlighted feature
Привязка: SNOMEDCTBodyStructures (example): SNOMED CT Body site concepts
.... description 1..1 string Information about the feature
... collection S 0..1 BackboneElement Collection details
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Constraints: ext-1
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
Constraints: ext-1
.... collector SΣ 0..1 Reference(UZ Core Practitioner(0.5.0)) Practitioner who collected the specimen.
.... collected[x] SΣ 0..1 Date/time (or period) when the specimen was collected. Used for clinical interpretation and lab timing.
..... collectedDateTime dateTime
..... collectedPeriod Period
.... duration SΣ 0..1 Duration Duration of the collection process (e.g., timed urine collection). Important for correct result calculation/interpretation.
.... quantity S 0..1 SimpleQuantity(5.0.0) Amount/volume of specimen collected. Used for adequacy checks and processing requirements.
.... method S 0..1 CodeableConcept Technique used to perform collection
Привязка: SpecimenCollectionMethodVS (0.5.0) (required)
.... device 0..1 CodeableReference(Device) Device used to perform collection
Описание привязки: (example): The device that was used to obtain the specimen (e.g. a catheter or catheter part used to draw the blood via a central line).
.... procedure 0..1 Reference(Procedure) The procedure that collects the specimen
.... bodySite S 0..1 CodeableReference(BodyStructure) Anatomical site from which the specimen was collected.
Привязка: SNOMEDCTBodyStructures (required)
.... fastingStatus[x] SΣ 0..1 Patient fasting status at collection time (or relevant clinical information affecting interpretation).
Привязка: RelevantClinicalInformationVS (0.5.0) (required)
..... fastingStatusCodeableConcept CodeableConcept
..... fastingStatusDuration Duration
... processing 0..* BackboneElement Processing and processing step details
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Constraints: ext-1
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
Constraints: ext-1
.... description 0..1 string Textual description of procedure
.... method 0..1 CodeableConcept Indicates the treatment step applied to the specimen
Привязка: SpecimenProcessingMethod (example): Type indicating the technique used to process the specimen.
.... additive 0..* Reference(Substance) Material used in the processing step
.... time[x] 0..1 Date and time of specimen processing
..... timeDateTime dateTime
..... timePeriod Period
... container 0..* BackboneElement Direct container of specimen (tube/slide, etc.)
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Constraints: ext-1
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
Constraints: ext-1
.... device 1..1 Reference(Device) Device resource for the container
.... location 0..1 Reference(Location) Where the container is
.... specimenQuantity 0..1 SimpleQuantity(5.0.0) Quantity of specimen within container
... condition Σ 0..* CodeableConcept State of the specimen
Привязка: Hl7VSSpecimenCondition (3.0.0) (extensible): Codes describing the state of the specimen.
... note 0..* Annotation Comments

doco Документация для этого формата

Привязки к терминологии

Путь Статус Использование ValueSet Версия Источник
Specimen.language Base required All Languages 📍5.0.0 Стандарт FHIR
Specimen.status Base required Specimen Status 📍0.5.0 этот IG
Specimen.type Base preferred Specimen types 📍0.5.0 этот IG
Specimen.combined Base required Combined status of a specimen 📍0.5.0 этот IG
Specimen.role Base preferred Specimen role 📍0.5.0 этот IG
Specimen.feature.type Base example SNOMED CT Body Structures 📍5.0.0 Стандарт FHIR
Specimen.collection.​method Base required Specimen collection methods (temp) 📍0.5.0 этот IG
Specimen.collection.​device Base example Not State Unknown
Specimen.collection.​bodySite Base required SNOMED CT Body Structures 📍5.0.0 Стандарт FHIR
Specimen.collection.​fastingStatus[x] Base required Clinical information 📍0.5.0 этот IG
Specimen.processing.​method Base example Specimen Processing Method 📍5.0.0 Стандарт FHIR
Specimen.condition Base extensible hl7VS-specimenCondition 📍3.0.0 THO v7.1

Ограничения

Id Градация Путь(и) Описание Выражение
dom-2 error Specimen If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Specimen If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().ofType(canonical) | %resource.descendants().ofType(uri) | %resource.descendants().ofType(url))) or descendants().where(reference = '#').exists() or descendants().where(ofType(canonical) = '#').exists() or descendants().where(ofType(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Specimen If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error Specimen If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 лучшая практика Specimen A resource should have narrative for robust management text.`div`.exists()
ele-1 error Specimen.meta, Specimen.implicitRules, Specimen.language, Specimen.text, Specimen.extension, Specimen.modifierExtension, Specimen.identifier, Specimen.accessionIdentifier, Specimen.status, Specimen.type, Specimen.subject, Specimen.receivedTime, Specimen.parent, Specimen.request, Specimen.combined, Specimen.role, Specimen.feature, Specimen.feature.extension, Specimen.feature.modifierExtension, Specimen.feature.type, Specimen.feature.description, Specimen.collection, Specimen.collection.extension, Specimen.collection.modifierExtension, Specimen.collection.collector, Specimen.collection.collected[x], Specimen.collection.duration, Specimen.collection.quantity, Specimen.collection.method, Specimen.collection.device, Specimen.collection.procedure, Specimen.collection.bodySite, Specimen.collection.fastingStatus[x], Specimen.processing, Specimen.processing.extension, Specimen.processing.modifierExtension, Specimen.processing.description, Specimen.processing.method, Specimen.processing.additive, Specimen.processing.time[x], Specimen.container, Specimen.container.extension, Specimen.container.modifierExtension, Specimen.container.device, Specimen.container.location, Specimen.container.specimenQuantity, Specimen.condition, Specimen.note All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error Specimen.extension, Specimen.modifierExtension, Specimen.feature.extension, Specimen.feature.modifierExtension, Specimen.collection.extension, Specimen.collection.modifierExtension, Specimen.processing.extension, Specimen.processing.modifierExtension, Specimen.container.extension, Specimen.container.modifierExtension Must have either extensions or value[x], not both extension.exists() != value.exists()

 

Другие представления профиля: CSV, Excel, Schematron

Машинный перевод, требуется проверка человеком. Эта страница автоматически переведена с английского языка с помощью искусственного интеллекта и пока не проверена редактором. При любых расхождениях приоритет имеет оригинальная англоязычная версия.

Быстрый старт

Этот профиль использует стандартные поисковые параметры FHIR R5. [base] — это базовый URL FHIR-сервера; | разделяет систему и значение и должен быть URL-закодирован как %7C.

Чтение по идентификатору сервера

GET [base]/Specimen/[id]

Поиск образцов

GET [base]/Specimen?patient=Patient/[id]
GET [base]/Specimen?patient=Patient/[id]&type=http://terminology.hl7.org/CodeSystem/v2-0487%7CBLD
GET [base]/Specimen?patient=Patient/[id]&status=available
GET [base]/Specimen?patient=Patient/[id]&collected=ge2025-01-01
GET [base]/Specimen?accession=ACC-2025-000045

Создание

POST [base]/Specimen
{
  "resourceType": "Specimen",
  "meta": { "profile": [ "https://dhp.uz/fhir/core/StructureDefinition/uz-core-specimen" ] },
  "status": "available",
  "type": { ... },
  "subject": { "reference": "Patient/[id]" },
  "request": [ { "reference": "ServiceRequest/[id]" } ],
  ...
}

Обновление (например, пометить образец как unavailable или записать его receivedTime) - выполните PUT всего ресурса заново с новым status:

PUT [base]/Specimen/[id]
If-Match: W/"3"   # the ETag from your last read; 412 if it changed since

Полный перечень поддерживаемых поисковых параметров см. в CapabilityStatement.

Связанные материалы