Руководство к использованию стандарта FHIR в ЦИСЗ (ВЕТКА release-1-3-t2-08-26-11)
1.3.446 - ci-build

Профиль ресурса: Образец материала для лабораторного исследования

Официальный URL: https://fhir.by/StructureDefinition/SpecimenLab
Active as of 2026-08-13 Имя: SpecimenLab

Образец материала для лабораторного исследования. Раздел Лабораторная диагностика, Лабораторные исследования

Описание профиля:

Профиль ресурса SpecimenLab предназначен для записи, передачи и хранения информации о биоматериале, взятом для лабораторного исследования. Ресурс связан с направлением на лабораторное исследование (ServiceRequestLab).

Биоматериал Specimen создаётся со статусом available. Если в процессе работы биоматериал признаётся непригодным, его статус изменяется на unsatisfactory, и для повторного забора создаётся новый объект Specimen со статусом available, прикреплённый к тому же ServiceRequest. Когда связанный ServiceRequest завершается и переходит в статус completed, статус соответствующего Specimen изменяется на unavailable, так как биоматериал был использован. В случае разделения пробирки создаётся новый Specimen со статусом available, при этом в его поле parent указывается исходный биоматериал, от которого он был получен.

Профиль поддерживает взаимодействие с:

  • организациями здравоохранения (OrganizationBy);
  • направлениями (ServiceRequestLab);
  • пациентами (PatientWithIdentificationNumber или PatientWithoutIdentificationNumber или AnonymousPatientBy);
  • ролями медицинских работников (PractitionerRoleBy).

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

You can also check for usages in the FHIR IG Statistics

Контент профиля

Описание профилей и принципов работы различных представлений..

Профиль ресурса: Specimen

НаименованиеФлагиКарта.ТипОписание и ограничения    Filter: Filtersdoco
.. Specimen C 0..* Specimen Sample for analysis
Constraints: SpecimenLabStatusRule
... meta 1..1 Meta Метаданные о ресурсе
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... versionId 0..0 Идентификатор конкретной версии
.... lastUpdated 0..1 instant Дата и время последнего обновления
.... source 0..0 Определяет, откуда берется ресурс
.... profile 1..1 canonical(StructureDefinition) Ссылка на профиль
Требуемый шаблон: https://fhir.by/StructureDefinition/SpecimenLab
.... security 0..0 Метки безопасности, примененные к этому ресурсу
.... tag 0..0 Теги, применяемые к этому ресурсу
... implicitRules 0..0 Набор правил, в соответствии с которыми был создан этот контент
... language 0..0 Language of the resource content
... contained 0..0 Автономные встроенные ресурсы
... Разрезы для extension 1..1 Extension Extension
Разрез: Не упорядочено, Закрыто от value:$this.url
.... extension:barcode S 1..1 string Штрихкод
URL: https://fhir.by/StructureDefinition/Barcode
... modifierExtension 0..0 Extension
... identifier 1..1 Identifier Идентификатор УЗ создавшего биоматериал
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... use 0..0 usual | official | temp | secondary | old (Если известно)
.... type 0..0 Описание идентификатора
.... system 0..0 Пространство имен для значения идентификатора
.... value 1..1 string Идентификатор биоматериала. Должен быть уникален для данного УЗ
.... period 0..0 Период времени, в течение которого идентификатор действителен для использования
.... assigner 1..1 Reference(Учреждение здравоохранения) Ссылка. Соотнесение с УЗ создавшим биоматериал
..... extension 1..1 Extension Extension
..... Разрезы для extension Содержимое/правила для всех разрезов
...... extension:locationReference 1..1 Reference(Структурное подразделение) Ссылка на структурное подразделение
URL: https://fhir.by/StructureDefinition/LocationReference
..... reference 1..1 string Ссылка на ресурс в виде относительного URL
..... type 0..0 Тип ресурса
..... identifier 0..0 Идентификатор ресурса, если не известна ссылка на него
... accessionIdentifier 0..0 Identifier assigned by the lab
... status 1..1 code Статус биоматериала: 'available' — биоматериал пригоден; 'unsatisfactory' — имеются проблемы, требуется повторить забор биоматериала; 'unavailable' - биоматериал был использован
... type 1..1 CodeableConcept Концепт локализации биоматериала
Привязка: Вид биологического материала (required)
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... coding 1..1 Coding Код, определенный в справочнике НСИ Терминология
..... id 0..0 Уникальный идентификатор для межэлементных ссылок
..... extension 0..0 Extension
..... system 1..1 uri Ссылка на справочник
..... version 0..0 Версия системы
..... code 1..1 code Код локализации биоматериала
..... userSelected 0..0 Если эта кодировка была выбрана непосредственно пользователем
.... text 0..0 Простое текстовое представление концепции
... subject 1..1 Reference(Пациент | Пациент без ИН | Анонимный пациент) Ссылка. Соотнесение с пациентом
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... reference 1..1 string Ссылка на ресурс в виде относительного URL
.... type 0..0 Тип ресурса
.... identifier 0..0 Идентификатор ресурса, если не известна ссылка на него
... receivedTime 0..0 The time when specimen is received by the testing laboratory
... parent 0..* Reference(Образец материала для лабораторного исследования) Создан на основе данного образца биоматериала
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... reference 1..1 string Ссылка на ресурс в виде относительного URL
.... type 0..0 Тип ресурса
.... identifier 0..0 Идентификатор ресурса, если не известна ссылка на него
... request 1..1 Reference(Направление на исследования, выполняемые в лаборатории) Ссылка. Соотнесение с направлением
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... reference 1..1 string Ссылка на ресурс в виде относительного URL
.... type 0..0 Тип ресурса
.... identifier 0..0 Идентификатор ресурса, если не известна ссылка на него
... combined 0..0 grouped | pooled
... role 0..0 The role the specimen serves
... feature 0..0 The physical feature of a specimen
... collection 1..1 BackboneElement Информация о заборе биоматериала
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... modifierExtension 0..0 Extension
.... collector 1..1 Reference(Роль медицинского работника) Ссылка. Соотнесение со получившим биоматериал сотрудником УЗ
..... extension 0..0 Extension
..... reference 1..1 string Ссылка на ресурс в виде относительного URL
..... type 0..0 Тип ресурса
..... identifier 0..0 Идентификатор ресурса, если не известна ссылка на него
.... collected[x] 1..1 dateTime Время взятия биологического материала
.... duration 0..0 How long it took to collect specimen
.... quantity 0..1 SimpleQuantity(5.0.0) Количество или объем направленного биоматериала
Привязка: Справочник единиц измерения для лабораторных исследований (required)
..... id 0..0 Уникальный идентификатор для межэлементных ссылок
..... extension 0..0 Extension
..... value 1..1 decimal Количество биоматериала
.... method 0..0 Technique used to perform collection
.... device 0..0 Device used to perform collection
.... procedure 0..0 The procedure that collects the specimen
.... bodySite 0..1 CodeableReference(BodyStructure) Анатомическая область, откуда взят биологический материал
Привязка: Анатомический классификатор (required)
..... id 0..0 Уникальный идентификатор для межэлементных ссылок
..... extension 0..0 Extension
..... concept
...... id 0..0 Уникальный идентификатор для межэлементных ссылок
...... extension 0..0 Extension
...... coding 1..1 Coding Код, определенный в справочнике НСИ Терминология
....... id 0..0 Уникальный идентификатор для межэлементных ссылок
....... extension 0..0 Extension
....... system 1..1 uri Ссылка на справочник
....... version 0..0 Версия системы
....... code 1..1 code Анатомическая область, откуда взят биологический материал, кодом
....... userSelected 0..0 Если эта кодировка была выбрана непосредственно пользователем
...... text 0..1 string Анатомическая область, откуда взят биологический материал, текстом
..... reference 0..0 Ссылка на ресурс
.... fastingStatus[x] 0..0 Whether or how long patient abstained from food and/or drink
... processing 0..0 Processing and processing step details
... container 0..0 Direct container of specimen (tube/slide, etc.)
... condition 0..0 State of the specimen
... note 0..1 Annotation Дополнительные данные
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... author[x] 0..0 Individual responsible for the annotation
.... time 0..0 Когда была сделана аннотация

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

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

Путь Статус Использование ValueSet Версия Источник
Specimen.type Base required Вид биологического материала 📦1.3.446 этот IG
Specimen.collection.​quantity Base required Справочник единиц измерения для лабораторных исследований 📦1.3.446 этот IG
Specimen.collection.​bodySite Base required Анатомический классификатор 📦1.3.446 этот IG

Ограничения

Id Градация Путь(и) Описание Выражение
SpecimenLabStatusRule error Specimen Статус ресурса может иметь значения available | unsatisfactory | unavailable status = 'available' or status = 'unsatisfactory' or status = 'unavailable'
НаименованиеФлагиКарта.ТипОписание и ограничения    Filter: Filtersdoco
.. Specimen C 0..* Specimen Sample for analysis
Constraints: SpecimenLabStatusRule
... id Σ 0..1 id Логический идентификатор этого артефакта
... meta Σ 1..1 Meta Метаданные о ресурсе
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... lastUpdated Σ 0..1 instant Дата и время последнего обновления
.... profile Σ 1..1 canonical(StructureDefinition) Ссылка на профиль

Требуемый шаблон: https://fhir.by/StructureDefinition/SpecimenLab
... Разрезы для extension 1..1 Extension Extension
Разрез: Не упорядочено, Закрыто от value:$this.url
.... extension:barcode S 1..1 string Штрихкод
URL: https://fhir.by/StructureDefinition/Barcode
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... value ΣC 1..1 string Идентификатор биоматериала. Должен быть уникален для данного УЗ
Пример General: 123456
.... assigner Σ 1..1 Reference(Учреждение здравоохранения) Ссылка. Соотнесение с УЗ создавшим биоматериал
..... id 0..1 id Уникальный идентификатор для межэлементных ссылок
..... Разрезы для extension 1..1 Extension Extension
Разрез: Не упорядочено, Открыто от value:url
...... extension:locationReference 1..1 Reference(Структурное подразделение) Ссылка на структурное подразделение
URL: https://fhir.by/StructureDefinition/LocationReference
..... reference ΣC 1..1 string Ссылка на ресурс в виде относительного URL
..... display ΣC 0..1 string Текстовая трактовка ресурса
... status ?!Σ 1..1 code Статус биоматериала: 'available' — биоматериал пригоден; 'unsatisfactory' — имеются проблемы, требуется повторить забор биоматериала; 'unavailable' - биоматериал был использован
Привязка: SpecimenStatus (required): Codes providing the status/availability of a specimen.
... type Σ 1..1 CodeableConcept Концепт локализации биоматериала
Привязка: Вид биологического материала (required)
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... coding Σ 1..1 Coding Код, определенный в справочнике НСИ Терминология
..... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
..... system Σ 1..1 uri Ссылка на справочник
..... code ΣC 1..1 code Код локализации биоматериала
..... display ΣC 0..1 string Значение кода
... subject Σ 1..1 Reference(Пациент | Пациент без ИН | Анонимный пациент) Ссылка. Соотнесение с пациентом
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... reference ΣC 1..1 string Ссылка на ресурс в виде относительного URL
.... display ΣC 0..1 string Текстовая трактовка ресурса
... parent 0..* Reference(Образец материала для лабораторного исследования) Создан на основе данного образца биоматериала
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... reference ΣC 1..1 string Ссылка на ресурс в виде относительного URL
.... display ΣC 0..1 string Текстовая трактовка ресурса
... request 1..1 Reference(Направление на исследования, выполняемые в лаборатории) Ссылка. Соотнесение с направлением
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... reference ΣC 1..1 string Ссылка на ресурс в виде относительного URL
.... display ΣC 0..1 string Текстовая трактовка ресурса
... collection 1..1 BackboneElement Информация о заборе биоматериала
.... collector Σ 1..1 Reference(Роль медицинского работника) Ссылка. Соотнесение со получившим биоматериал сотрудником УЗ
..... id 0..1 id Уникальный идентификатор для межэлементных ссылок
..... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
..... reference ΣC 1..1 string Ссылка на ресурс в виде относительного URL
..... display ΣC 0..1 string Текстовая трактовка ресурса
.... collected[x] Σ 1..1 dateTime Время взятия биологического материала
.... quantity 0..1 SimpleQuantity(5.0.0) Количество или объем направленного биоматериала
Привязка: Справочник единиц измерения для лабораторных исследований (required)
..... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
..... value Σ 1..1 decimal Количество биоматериала
..... unit Σ 0..1 string Представление единицы измерения
..... system ΣC 0..1 uri Система, определяющая форму кодированной единицы измерения
..... code ΣC 0..1 code Кодированная форма единицы измерения
.... bodySite 0..1 CodeableReference(BodyStructure) Анатомическая область, откуда взят биологический материал
Привязка: Анатомический классификатор (required)
..... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
..... concept Σ 0..1 CodeableConcept Ссылка на концепт (справочник + код + значение)
...... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
...... coding Σ 1..1 Coding Код, определенный в справочнике НСИ Терминология
....... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
....... system Σ 1..1 uri Ссылка на справочник
....... code ΣC 1..1 code Анатомическая область, откуда взят биологический материал, кодом
....... display ΣC 0..1 string Значение кода
...... text Σ 0..1 string Анатомическая область, откуда взят биологический материал, текстом
... note 0..1 Annotation Дополнительные данные
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... text Σ 1..1 markdown Текстовое содержимое аннотации

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

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

Путь Статус Использование ValueSet Версия Источник
Specimen.status Base required Specimen Status 📍5.0.0 Стандарт FHIR
Specimen.type Base required Вид биологического материала 📦1.3.446 этот IG
Specimen.feature.type Base example SNOMED CT Body Structures 📍5.0.0 Стандарт FHIR
Specimen.collection.​quantity Base required Справочник единиц измерения для лабораторных исследований 📦1.3.446 этот IG
Specimen.collection.​bodySite Base required Анатомический классификатор 📦1.3.446 этот IG
Specimen.processing.​method Base example Specimen Processing Method 📍5.0.0 Стандарт FHIR

Ограничения

Id Градация Путь(и) Описание Выражение
SpecimenLabStatusRule error Specimen Статус ресурса может иметь значения available | unsatisfactory | unavailable status = 'available' or status = 'unsatisfactory' or status = 'unavailable'

Полная Схема

НаименованиеФлагиКарта.ТипОписание и ограничения    Filter: Filtersdoco
.. Specimen C 0..* Specimen Sample for analysis
Constraints: SpecimenLabStatusRule
... id Σ 0..1 id Логический идентификатор этого артефакта
... meta Σ 1..1 Meta Метаданные о ресурсе
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... lastUpdated Σ 0..1 instant Дата и время последнего обновления
.... profile Σ 1..1 canonical(StructureDefinition) Ссылка на профиль

Требуемый шаблон: https://fhir.by/StructureDefinition/SpecimenLab
... Разрезы для extension 1..1 Extension Extension
Разрез: Не упорядочено, Закрыто от value:$this.url
.... extension:barcode S 1..1 string Штрихкод
URL: https://fhir.by/StructureDefinition/Barcode
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... value ΣC 1..1 string Идентификатор биоматериала. Должен быть уникален для данного УЗ
Пример General: 123456
.... assigner Σ 1..1 Reference(Учреждение здравоохранения) Ссылка. Соотнесение с УЗ создавшим биоматериал
..... id 0..1 id Уникальный идентификатор для межэлементных ссылок
..... Разрезы для extension 1..1 Extension Extension
Разрез: Не упорядочено, Открыто от value:url
...... extension:locationReference 1..1 Reference(Структурное подразделение) Ссылка на структурное подразделение
URL: https://fhir.by/StructureDefinition/LocationReference
..... reference ΣC 1..1 string Ссылка на ресурс в виде относительного URL
..... display ΣC 0..1 string Текстовая трактовка ресурса
... status ?!Σ 1..1 code Статус биоматериала: 'available' — биоматериал пригоден; 'unsatisfactory' — имеются проблемы, требуется повторить забор биоматериала; 'unavailable' - биоматериал был использован
Привязка: SpecimenStatus (required): Codes providing the status/availability of a specimen.
... type Σ 1..1 CodeableConcept Концепт локализации биоматериала
Привязка: Вид биологического материала (required)
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... coding Σ 1..1 Coding Код, определенный в справочнике НСИ Терминология
..... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
..... system Σ 1..1 uri Ссылка на справочник
..... code ΣC 1..1 code Код локализации биоматериала
..... display ΣC 0..1 string Значение кода
... subject Σ 1..1 Reference(Пациент | Пациент без ИН | Анонимный пациент) Ссылка. Соотнесение с пациентом
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... reference ΣC 1..1 string Ссылка на ресурс в виде относительного URL
.... display ΣC 0..1 string Текстовая трактовка ресурса
... parent 0..* Reference(Образец материала для лабораторного исследования) Создан на основе данного образца биоматериала
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... reference ΣC 1..1 string Ссылка на ресурс в виде относительного URL
.... display ΣC 0..1 string Текстовая трактовка ресурса
... request 1..1 Reference(Направление на исследования, выполняемые в лаборатории) Ссылка. Соотнесение с направлением
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... reference ΣC 1..1 string Ссылка на ресурс в виде относительного URL
.... display ΣC 0..1 string Текстовая трактовка ресурса
... collection 1..1 BackboneElement Информация о заборе биоматериала
.... collector Σ 1..1 Reference(Роль медицинского работника) Ссылка. Соотнесение со получившим биоматериал сотрудником УЗ
..... id 0..1 id Уникальный идентификатор для межэлементных ссылок
..... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
..... reference ΣC 1..1 string Ссылка на ресурс в виде относительного URL
..... display ΣC 0..1 string Текстовая трактовка ресурса
.... collected[x] Σ 1..1 dateTime Время взятия биологического материала
.... quantity 0..1 SimpleQuantity(5.0.0) Количество или объем направленного биоматериала
Привязка: Справочник единиц измерения для лабораторных исследований (required)
..... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
..... value Σ 1..1 decimal Количество биоматериала
..... unit Σ 0..1 string Представление единицы измерения
..... system ΣC 0..1 uri Система, определяющая форму кодированной единицы измерения
..... code ΣC 0..1 code Кодированная форма единицы измерения
.... bodySite 0..1 CodeableReference(BodyStructure) Анатомическая область, откуда взят биологический материал
Привязка: Анатомический классификатор (required)
..... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
..... concept Σ 0..1 CodeableConcept Ссылка на концепт (справочник + код + значение)
...... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
...... coding Σ 1..1 Coding Код, определенный в справочнике НСИ Терминология
....... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
....... system Σ 1..1 uri Ссылка на справочник
....... code ΣC 1..1 code Анатомическая область, откуда взят биологический материал, кодом
....... display ΣC 0..1 string Значение кода
...... text Σ 0..1 string Анатомическая область, откуда взят биологический материал, текстом
... note 0..1 Annotation Дополнительные данные
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... text Σ 1..1 markdown Текстовое содержимое аннотации

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

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

Путь Статус Использование ValueSet Версия Источник
Specimen.status Base required Specimen Status 📍5.0.0 Стандарт FHIR
Specimen.type Base required Вид биологического материала 📦1.3.446 этот IG
Specimen.feature.type Base example SNOMED CT Body Structures 📍5.0.0 Стандарт FHIR
Specimen.collection.​quantity Base required Справочник единиц измерения для лабораторных исследований 📦1.3.446 этот IG
Specimen.collection.​bodySite Base required Анатомический классификатор 📦1.3.446 этот IG
Specimen.processing.​method Base example Specimen Processing Method 📍5.0.0 Стандарт FHIR

Ограничения

Id Градация Путь(и) Описание Выражение
SpecimenLabStatusRule error Specimen Статус ресурса может иметь значения available | unsatisfactory | unavailable status = 'available' or status = 'unsatisfactory' or status = 'unavailable'

Схема различий

Профиль ресурса: Specimen

НаименованиеФлагиКарта.ТипОписание и ограничения    Filter: Filtersdoco
.. Specimen C 0..* Specimen Sample for analysis
Constraints: SpecimenLabStatusRule
... meta 1..1 Meta Метаданные о ресурсе
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... versionId 0..0 Идентификатор конкретной версии
.... lastUpdated 0..1 instant Дата и время последнего обновления
.... source 0..0 Определяет, откуда берется ресурс
.... profile 1..1 canonical(StructureDefinition) Ссылка на профиль
Требуемый шаблон: https://fhir.by/StructureDefinition/SpecimenLab
.... security 0..0 Метки безопасности, примененные к этому ресурсу
.... tag 0..0 Теги, применяемые к этому ресурсу
... implicitRules 0..0 Набор правил, в соответствии с которыми был создан этот контент
... language 0..0 Language of the resource content
... contained 0..0 Автономные встроенные ресурсы
... Разрезы для extension 1..1 Extension Extension
Разрез: Не упорядочено, Закрыто от value:$this.url
.... extension:barcode S 1..1 string Штрихкод
URL: https://fhir.by/StructureDefinition/Barcode
... modifierExtension 0..0 Extension
... identifier 1..1 Identifier Идентификатор УЗ создавшего биоматериал
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... use 0..0 usual | official | temp | secondary | old (Если известно)
.... type 0..0 Описание идентификатора
.... system 0..0 Пространство имен для значения идентификатора
.... value 1..1 string Идентификатор биоматериала. Должен быть уникален для данного УЗ
.... period 0..0 Период времени, в течение которого идентификатор действителен для использования
.... assigner 1..1 Reference(Учреждение здравоохранения) Ссылка. Соотнесение с УЗ создавшим биоматериал
..... extension 1..1 Extension Extension
..... Разрезы для extension Содержимое/правила для всех разрезов
...... extension:locationReference 1..1 Reference(Структурное подразделение) Ссылка на структурное подразделение
URL: https://fhir.by/StructureDefinition/LocationReference
..... reference 1..1 string Ссылка на ресурс в виде относительного URL
..... type 0..0 Тип ресурса
..... identifier 0..0 Идентификатор ресурса, если не известна ссылка на него
... accessionIdentifier 0..0 Identifier assigned by the lab
... status 1..1 code Статус биоматериала: 'available' — биоматериал пригоден; 'unsatisfactory' — имеются проблемы, требуется повторить забор биоматериала; 'unavailable' - биоматериал был использован
... type 1..1 CodeableConcept Концепт локализации биоматериала
Привязка: Вид биологического материала (required)
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... coding 1..1 Coding Код, определенный в справочнике НСИ Терминология
..... id 0..0 Уникальный идентификатор для межэлементных ссылок
..... extension 0..0 Extension
..... system 1..1 uri Ссылка на справочник
..... version 0..0 Версия системы
..... code 1..1 code Код локализации биоматериала
..... userSelected 0..0 Если эта кодировка была выбрана непосредственно пользователем
.... text 0..0 Простое текстовое представление концепции
... subject 1..1 Reference(Пациент | Пациент без ИН | Анонимный пациент) Ссылка. Соотнесение с пациентом
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... reference 1..1 string Ссылка на ресурс в виде относительного URL
.... type 0..0 Тип ресурса
.... identifier 0..0 Идентификатор ресурса, если не известна ссылка на него
... receivedTime 0..0 The time when specimen is received by the testing laboratory
... parent 0..* Reference(Образец материала для лабораторного исследования) Создан на основе данного образца биоматериала
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... reference 1..1 string Ссылка на ресурс в виде относительного URL
.... type 0..0 Тип ресурса
.... identifier 0..0 Идентификатор ресурса, если не известна ссылка на него
... request 1..1 Reference(Направление на исследования, выполняемые в лаборатории) Ссылка. Соотнесение с направлением
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... reference 1..1 string Ссылка на ресурс в виде относительного URL
.... type 0..0 Тип ресурса
.... identifier 0..0 Идентификатор ресурса, если не известна ссылка на него
... combined 0..0 grouped | pooled
... role 0..0 The role the specimen serves
... feature 0..0 The physical feature of a specimen
... collection 1..1 BackboneElement Информация о заборе биоматериала
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... modifierExtension 0..0 Extension
.... collector 1..1 Reference(Роль медицинского работника) Ссылка. Соотнесение со получившим биоматериал сотрудником УЗ
..... extension 0..0 Extension
..... reference 1..1 string Ссылка на ресурс в виде относительного URL
..... type 0..0 Тип ресурса
..... identifier 0..0 Идентификатор ресурса, если не известна ссылка на него
.... collected[x] 1..1 dateTime Время взятия биологического материала
.... duration 0..0 How long it took to collect specimen
.... quantity 0..1 SimpleQuantity(5.0.0) Количество или объем направленного биоматериала
Привязка: Справочник единиц измерения для лабораторных исследований (required)
..... id 0..0 Уникальный идентификатор для межэлементных ссылок
..... extension 0..0 Extension
..... value 1..1 decimal Количество биоматериала
.... method 0..0 Technique used to perform collection
.... device 0..0 Device used to perform collection
.... procedure 0..0 The procedure that collects the specimen
.... bodySite 0..1 CodeableReference(BodyStructure) Анатомическая область, откуда взят биологический материал
Привязка: Анатомический классификатор (required)
..... id 0..0 Уникальный идентификатор для межэлементных ссылок
..... extension 0..0 Extension
..... concept
...... id 0..0 Уникальный идентификатор для межэлементных ссылок
...... extension 0..0 Extension
...... coding 1..1 Coding Код, определенный в справочнике НСИ Терминология
....... id 0..0 Уникальный идентификатор для межэлементных ссылок
....... extension 0..0 Extension
....... system 1..1 uri Ссылка на справочник
....... version 0..0 Версия системы
....... code 1..1 code Анатомическая область, откуда взят биологический материал, кодом
....... userSelected 0..0 Если эта кодировка была выбрана непосредственно пользователем
...... text 0..1 string Анатомическая область, откуда взят биологический материал, текстом
..... reference 0..0 Ссылка на ресурс
.... fastingStatus[x] 0..0 Whether or how long patient abstained from food and/or drink
... processing 0..0 Processing and processing step details
... container 0..0 Direct container of specimen (tube/slide, etc.)
... condition 0..0 State of the specimen
... note 0..1 Annotation Дополнительные данные
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... author[x] 0..0 Individual responsible for the annotation
.... time 0..0 Когда была сделана аннотация

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

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

Путь Статус Использование ValueSet Версия Источник
Specimen.type Base required Вид биологического материала 📦1.3.446 этот IG
Specimen.collection.​quantity Base required Справочник единиц измерения для лабораторных исследований 📦1.3.446 этот IG
Specimen.collection.​bodySite Base required Анатомический классификатор 📦1.3.446 этот IG

Ограничения

Id Градация Путь(и) Описание Выражение
SpecimenLabStatusRule error Specimen Статус ресурса может иметь значения available | unsatisfactory | unavailable status = 'available' or status = 'unsatisfactory' or status = 'unavailable'

 


Примечания:

Поиск ресурса

Поиск в контексте пациента:

GET [FHIR_BASE]/Patient/[patientId]/Specimen?[parameter]=[value]

Поиск в контексте организации:

GET [FHIR_BASE]/Organization/[organizationId]/Specimen?[parameter]=[value]

  • FHIR_BASE: URL-адрес сервера

  • parameter: параметр поиска (например, _id, status, type)

  • value: значение параметра поиска

Примеры запроса:

GET [FHIR_BASE]/Patient/[patientId]/Specimen?_profile=https://fhir.by/StructureDefinition/SpecimenLab&_id=00001&status=available GET [FHIR_BASE]/Organization/[organizationId]/Specimen?_profile=https://fhir.by/StructureDefinition/SpecimenLab&type=12.1

Поисковые параметры поддерживаемые для профия SpecimenLab

Параметр поиска Тип Описание Выражение Пример
_id token По логическому идентификатору Specimen.id GET [FHIR_BASE]/Patient/[patientId]/Specimen?_profile=https://fhir.by/StructureDefinition/SpecimenLab&_id=00001
_profile reference По профилю Specimen.meta.profile GET [FHIR_BASE]/Patient/[patientId]/Specimen?_profile=https://fhir.by/StructureDefinition/SpecimenLab
_lastUpdated date По дате последнего изменения (создания) Specimen.meta.lastUpdated GET [FHIR_BASE]/Patient/[patientId]/Specimen?_profile=https://fhir.by/StructureDefinition/SpecimenLab&_lastUpdated=2025-05-05T10:30:00Z
identifier token Внутренний идентификатор в УЗ Specimen.identifier.value GET [FHIR_BASE]/Patient/[patientId]/Specimen?_profile=https://fhir.by/StructureDefinition/SpecimenLab&identifier=123
assigner reference Соотнесение с направляющим УЗ Specimen.identifier.assigner GET [FHIR_BASE]/Patient/[patientId]/Specimen?_profile=https://fhir.by/StructureDefinition/SpecimenLab&assigner=Organization/123156789021
status token По статусу Specimen.status GET [FHIR_BASE]/Patient/[patientId]/Specimen?_profile=https://fhir.by/StructureDefinition/SpecimenLab&status=active
type token По коду показателя Specimen.type GET [FHIR_BASE]/Patient/[patientId]/Specimen?_profile=https://fhir.by/StructureDefinition/SpecimenLab&type=active
patient reference По пациенту Specimen.subject GET [FHIR_BASE]/Patient/[patientId]/Specimen?_profile=https://fhir.by/StructureDefinition/SpecimenLab&patient=Patient/001
request reference По направлению Specimen.request GET [FHIR_BASE]/Patient/[patientId]/Specimen?_profile=https://fhir.by/StructureDefinition/SpecimenLab&request=ServiceRequestLab/001
collector reference По мед. работнику сделавшему забор Specimen.collection.collector GET [FHIR_BASE]/Patient/[patientId]/Specimen?_profile=https://fhir.by/StructureDefinition/SpecimenLab&collector=PractitionerRole/001
barcode token По штрихкоду Specimen.extension(‘https://fhir.by/StructureDefinition/Barcode’).value.as(string) GET [FHIR_BASE]/Patient/[patientId]/Specimen?_profile=https://fhir.by/StructureDefinition/SpecimenLab&barcode=00000001

Синтаксис метода получения ресурса

Метод получения осуществляет доступ к текущему содержимому ресурса. Взаимодействие осуществляется с помощью HTTP GET команды:

GET [FHIR_BASE]/Patient/[patientId]/Specimen/[id]

Метод возвращает один экземпляр ресурса.

Возможные значения логического идентификатора («id») описаны в типе Id

При попытке доступа к несуществующему ресурсу будет возвращен HTTP статус код - 404 Not Found

Синтаксис поиска ресурса

Во всех поисковых взаимодействиях в этом руководстве используется HTTP GET команда со следующим синтаксисом:

GET [FHIR_BASE]/Patient/[patientId]/[Resource-type]?[parameter1]{:m1|m2|...}={c1|c2|...}[value1{,value2,...}]{&[parameter2]{:m1|m2|...}={c1|c2|...}[value1{,value2,...}]&...}

  • GET — это HTTP метод, используемый для получения ресурса.

  • Переменные указанные в «[]», обязательны для предоставления клиентом и будут заменены указанным строковым литералом.

  • Переменные указанные в «{}», не являются обязательными для предоставления клиентом и будут заменены указанным строковым литералом.

  • FHIR_BASE: URL-адрес сервера

  • Resource-type: имя типа ресурса (например, “Specimen”).

  • parameter: параметры поиска, определенные для конкретного взаимодействия (например, «?status=active»).

  • value: значение параметра поиска

  • {:m1 m2 …}: модификатор параметра поиска

  • {c1 c2 …}: компаратор параметра поиска

  • {,value2,…}: логическое ИЛИ

  • {&parameter2={:m1 m2 …}={c1 c2 …}[value1{,value2,…}]&…}: логическое И

Простой пример запроса поиска в RESTful с использованием HTTP GET команды:

GET [FHIR_BASE]/Patient/[patientId]/Specimen?type=value&...

Поддерживаемые параметры поиска ресурса

Параметр поиска Тип Описание Выражение Пример
_id token По логическому идентификатору Specimen.id GET [FHIR_BASE]/Patient/[patientId]/Specimen?_id=00001
_profile reference По профилю Слота Specimen.meta.profile GET [FHIR_BASE]/Patient/[patientId]/Specimen?_profile=https://fhir.by/StructureDefinition/SpecimenBy
accession token Регистрационный номер, связанный с образцом Specimen.accessionIdentifier GET [FHIR_BASE]/Patient/[patientId]/Specimen?accession=123456
bodysite reference Ссылка на ресурс (по экземпляру) Specimen.collection.bodySite.reference GET [FHIR_BASE]/Patient/[patientId]/Specimen?bodysite=arm
collected date Дата, когда был собран образец Specimen.collection.collected.ofType(dateTime) | Specimen.collection.collected.ofType(Period) GET [FHIR_BASE]/Patient/[patientId]/Specimen?collected=2024-08-01
collector reference Кто собрал этот образец Specimen.collection.collector(Practitioner, Patient, PractitionerRole, RelatedPerson) GET [FHIR_BASE]/Patient/[patientId]/Specimen?collector=Practitioner/0009
container-device reference Уникальный идентификатор, связанный с контейнером для образцов Specimen.container.device.where(resolve() is Device)(Device) GET [FHIR_BASE]/Patient/[patientId]/Specimen?container-device=Device/00001
identifier token Уникальный идентификатор, связанный c образцом Specimen.identifier GET [FHIR_BASE]/Patient/[patientId]/Specimen?identifier=1223456789
parent reference Родитель(первоначальный образец) экземпляра Specimen.parent(Specimen) GET [FHIR_BASE]/Patient/[patientId]/Specimen?parent=Specimen/00001
patient reference Пациент, от которого получен образец Specimen.subject.where(resolve() is Patient)(Patient) GET [FHIR_BASE]/Patient/[patientId]/Specimen?patient=Patient001
procedure reference Процедура, с помощью которой был взят образец Specimen.collection.procedure(Procedure) GET [FHIR_BASE]/Patient/[patientId]/Specimen?procedure=Procedure/00001
status token available | unavailable | unsatisfactory | entered-in-error Specimen.status GET [FHIR_BASE]/Patient/[patientId]/Specimen?status=available
subject reference Предмет исследования - пациент или образец Specimen.subject(Group, BiologicallyDerivedProduct, Device, Patient, Substance, Location) GET [FHIR_BASE]/Patient/[patientId]/Specimen?subject=Patient001
type token Тип образца Specimen.type GET [FHIR_BASE]/Patient/[patientId]/Specimen?type=biopsy

Необходимо добавить описание Прав доступа!!!!!!

Для добавления описания нужно добавить файл input/rules/StructureDefinition-SpecimenLab-rules.md