Руководство к использованию стандарта FHIR в ЦИСЗ
0.2.6803 - ci-build

Профиль ресурса: Структурное подразделение

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

Профиль описывающий стрктурное подразделение организации здравоохранения или его часть. Раздел Информация об организации и медработнике

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

Профиль предназначен для записи сведений о структурном подразделении организации здравоохранения в ЦИСЗ.

Структурное подразделение организации здравоохранения – внутреннее или обособленное подразделение организации здравоохранения, созданное для управления определенным направлением (видом) деятельности организации здравоохранения, выполняющее самостоятельные задачи и функции.

Структурным подразделением, в том числе и обособленным, может являться:

  • палатное или лечебно-диагностическое отделение;
  • кабинет;
  • аптека;
  • патологоанатомическое отделение;
  • регистратура;
  • здравпункт;
  • участковая больница;
  • фельдшерско-акушерский пункт и прочие.

Структурное подразделение выделяется в штатном расписании юридического лица и может включать в свой состав другие структурные подразделения.

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

Профиль включает в себя следующие данные:

  • наименование структурного подразделения;
  • тип структурного подразделения;
  • физическое местоположение структурного подразделения;
  • сведения о головной организации структурного подразделения.

Важно!

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

Пример: кабинет приема специалиста поликлиники, отдельная палата отделения.

Профиль может отражать как часть подразделения, так и само структурное подразделение.

Профиль используется в следующих случаях:

  • регистрация информации о структурных подразделениях организации здравоохранения;
  • валидация сведений о структурных подразделениях организации здравоохранения, поступающих из МИС ОЗ.

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

You can also check for usages in the FHIR IG Statistics

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

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

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

НаименованиеФлагиКарта.ТипОписание и ограничения    Filter: Filtersdoco
.. Location 0..* Location Details and position information for a place
... id 1..1 id Уникальный идентификатор подразделения в реестре организаций
... meta 1..1 Meta Метаданные о ресурсе
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... versionId 0..1 id Идентификатор версии. Указывается версия ресурса, который подлежит редактированию, если предусмотрено правилами. Если версия не указана, то ресурс считается новым.
.... lastUpdated 0..1 instant Дата и время последнего обновления
.... source 0..0 Определяет, откуда берется ресурс
.... profile 1..1 canonical(StructureDefinition) Ссылка на профиль
Требуемый шаблон: https://fhir.by/StructureDefinition/LocationUnit
.... security 0..0 Метки безопасности, примененные к этому ресурсу
.... tag 0..0 Теги, применяемые к этому ресурсу
... implicitRules 0..0 Набор правил, в соответствии с которыми был создан этот контент
... contained 0..0 Автономные встроенные ресурсы
... Разрезы для extension 1..* Extension Extension
Разрез: Не упорядочено, Закрыто от value:$this.url
.... extension:cabinetNumber S 0..1 string Номер кабинета
URL: https://fhir.by/StructureDefinition/CabinetNumber
.... extension:registration 1..1 (Комплекс) Информация о регистрации
URL: https://fhir.by/StructureDefinition/OrganizationRegistration
.... extension:bedsFond S 0..* (Комплекс) Коечный фонд организации структурного подразделения. Подразделения, такие как консультативные кабинеты или операционный блок могут не содержать информации о койках. Для некоторых подразделений возможно указание нескольких профилей коек и отдельно количества коек по каждому профилю. Например: терапевтическое отделение центральной районной больницы содержит 20 общетерапевтических коейк, 5 неврологических и 3 койки интенсивной терапии. Для описания такого подраздления необходимо создание 3-х экземпляров расширения, в каждом из которых будет описано количество коек, их профиль и дата обновления информации о койках.
URL: https://fhir.by/StructureDefinition/BedsFond
... modifierExtension 0..0 Extension
... Разрезы для identifier 0..* Identifier Unique code or number identifying the location to its users
Разрез: Не упорядочено, Закрыто от value:type.coding.code
.... identifier:main 0..1 Identifier Unique code or number identifying the location to its users
..... id 0..0 Уникальный идентификатор для межэлементных ссылок
..... extension 0..0 Extension
..... use 0..0 usual | official | temp | secondary | old (Если известно)
..... type 0..1 CodeableConcept Описание идентификатора
Привязка: Тип идентификатора организации (required)
...... coding 1..1 Coding Код, определенный в справочнике НСИ Терминология
....... system 1..1 uri Ссылка на справочник
....... code 1..1 code Код
Требуемый шаблон: main
..... system 0..1 uri Пространство имен для значения идентификатора
Требуемый шаблон: https://egr.gov.by
..... value 1..1 string Длина ОКПО равна 12 цифровым десятичным знакам, из которых первые 7 не имеют дополнительной смысловой нагрузки; восьмой знак представляет собой расчетное контрольное число; девятый знак соответствует первому знаку кода территории, на которой зарегистрирован респондент, в соответствии с общегосударственным классификатором ОКРБ 003-2017 «Система обозначений объектов административно-территориального деления» (далее – СОАТО), а 3 последних знака служат для выделения обособленных подразделений юридического лица.
..... period 0..1 Period Дата регистрации в ЕГР
...... id 0..0 Уникальный идентификатор для межэлементных ссылок
...... extension 0..0 Extension
...... start 1..1 dateTime Начало периода действия
..... assigner 0..0 Организация, выдавшая идентификатор (может быть просто текстом)
.... identifier:mrec 0..1 Identifier Unique code or number identifying the location to its users
..... id 0..0 Уникальный идентификатор для межэлементных ссылок
..... extension 0..0 Extension
..... use 0..0 usual | official | temp | secondary | old (Если известно)
..... type 0..1 CodeableConcept Описание идентификатора
Привязка: Тип идентификатора организации (required)
...... coding 1..1 Coding Код, определенный в справочнике НСИ Терминология
....... system 1..1 uri Ссылка на справочник
....... code 1..1 code Код
Требуемый шаблон: mrec
..... system 0..0 Пространство имен для значения идентификатора
..... value 1..1 string Код МРЭК.
..... period 0..0 Период времени, в течение которого идентификатор действителен для использования
..... assigner 0..0 Организация, выдавшая идентификатор (может быть просто текстом)
... status 1..1 code Статус структурного подразделения: active - открыто | suspended - действие приостоновлено | inactive - закрыто
... operationalStatus 0..0 The operational status of the location (typically only for a bed/room)
... name 1..1 string Полное наименование структурного подразделения
... alias 0..1 string Сокращенное наименование структурного подразделения
... description 0..1 markdown Описание подразделения по желанию
... mode 0..0 instance | kind
... type 1..* CodeableConcept Тип структурного подразделения
Привязка: Тип структурного подразделения (required)
.... coding 1..1 Coding Код, определенный в справочнике НСИ Терминология
..... system 1..1 uri Ссылка на справочник
..... code 1..1 code Код
..... userSelected 0..0 Если эта кодировка была выбрана непосредственно пользователем
... contact 0..* ExtendedContactDetail Контактная информация структурного подразделения
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... purpose 0..0 Тип контакта
.... name 0..0 Name of an individual to contact
.... telecom 1..1 ContactPoint Способ связи со структурным подразделением
..... id 0..0 Уникальный идентификатор для межэлементных ссылок
..... extension 0..0 Extension
..... system 1..1 code phone | fax | email | pager | url | sms | other
..... value 1..1 string Значение номера телефона, адреса эл. почты
..... use 0..0 home | work | temp | old | mobile - назначение этой контактной точки
..... rank 0..0 Укажите предпочтительный порядок использования (1 = самый высокий)
..... period 0..0 Период времени, в течение которого контактная точка использовалась/продолжает использоваться
.... address 0..0 Адрес
.... organization 0..0 This contact detail is handled/monitored by a specific organization
.... period 0..0 Период, в течение которого этот контакт был действителен для использования
... address 1..1 Address Physical location
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... Разрезы для extension 1..* Extension Extension
Разрез: Не упорядочено, Закрыто от value:url
..... extension:address S 1..1 CodeableConcept Адрес в соответствии со справочником населенных пунктов и административно-территориальных единиц Республики Беларусь
URL: https://fhir.by/StructureDefinition/StreetGeoRegistry
Привязка: Справочник населенных пунктов,улиц и административно-территориальных единиц (required)
..... extension:apartment S 0..1 string Текстовое поле используется для уточнения адресов, полученных из справочника 'Справочник населенных пунктов и административно-территориальных единиц'
URL: https://fhir.by/StructureDefinition/ApartmentRoom
..... extension:geo-coordinates S 0..1 (Комплекс) Координаты местоположения
URL: https://fhir.by/StructureDefinition/GeographicCoordinates
.... use 0..0 home | work | temp | old | billing - назначение этого адреса
.... type 0..0 postal | physical | both
.... text 1..1 string Текстовое представление адреса: значение поля 'Полное наименование' справочника 'Справочник населенных пунктов и административно-территориальных единиц'
.... line 0..0 Название улицы, номер дома/строения, корпус, номер квартиры/помещения, номер абонентского ящика и прочее.
.... city 0..1 string Название населенного пункта
.... district 0..1 string Район
.... state 0..1 string Область
.... postalCode 0..1 string Почтовый индекс: значение поля 'Почтовый индекс' справочника 'Справочник населенных пунктов и административно-территориальных единиц'
.... country 0..0 Страна (например, это может быть двух- или трехбуквенный код ISO 3166)
.... period 0..0 Период времени, когда адрес использовался/используется
... position 0..0 The absolute geographic location
... managingOrganization 0..1 Reference(Учреждение здравоохранения) Юридическое лицо или филиал частью которого является это подразделение
.... reference 1..1 string Ссылка на ресурс в виде относительного URL
... partOf 0..1 Reference(Структурное подразделение) Структурное подразделение, частью которого является это подразделение
.... reference 1..1 string Ссылка на ресурс в виде относительного URL
... characteristic 0..0 Collection of characteristics (attributes)
... hoursOfOperation 0..0 What days/times during a week is this location usually open (including exceptions)
... virtualService 0..0 Сведения о подключении к виртуальной службе (например, конференц-связь)
... endpoint 0..1 Reference(Endpoint) Technical endpoints providing access to services operated for the location

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

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

Путь Статус Использование ValueSet Версия Источник
Location.identifier:main.​type Base required Тип идентификатора организации 📦0.2.6803 этот IG
Location.identifier:mrec.​type Base required Тип идентификатора организации 📦0.2.6803 этот IG
Location.type Base required Тип структурного подразделения 📦0.2.6803 этот IG
НаименованиеФлагиКарта.ТипОписание и ограничения    Filter: Filtersdoco
.. Location 0..* Location Details and position information for a place
... id Σ 1..1 id Уникальный идентификатор подразделения в реестре организаций
... meta Σ 1..1 Meta Метаданные о ресурсе
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... versionId Σ 0..1 id Идентификатор версии. Указывается версия ресурса, который подлежит редактированию, если предусмотрено правилами. Если версия не указана, то ресурс считается новым.
.... lastUpdated Σ 0..1 instant Дата и время последнего обновления
.... profile Σ 1..1 canonical(StructureDefinition) Ссылка на профиль

Требуемый шаблон: https://fhir.by/StructureDefinition/LocationUnit
... text 0..1 Narrative Краткое изложение текста ресурса для интерпретации человеком
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
.... extension:cabinetNumber S 0..1 string Номер кабинета
URL: https://fhir.by/StructureDefinition/CabinetNumber
.... extension:registration 1..1 (Комплекс) Информация о регистрации
URL: https://fhir.by/StructureDefinition/OrganizationRegistration
.... extension:bedsFond S 0..* (Комплекс) Коечный фонд организации структурного подразделения. Подразделения, такие как консультативные кабинеты или операционный блок могут не содержать информации о койках. Для некоторых подразделений возможно указание нескольких профилей коек и отдельно количества коек по каждому профилю. Например: терапевтическое отделение центральной районной больницы содержит 20 общетерапевтических коейк, 5 неврологических и 3 койки интенсивной терапии. Для описания такого подраздления необходимо создание 3-х экземпляров расширения, в каждом из которых будет описано количество коек, их профиль и дата обновления информации о койках.
URL: https://fhir.by/StructureDefinition/BedsFond
... Разрезы для identifier Σ 0..* Identifier Unique code or number identifying the location to its users
Разрез: Не упорядочено, Закрыто от value:type.coding.code
.... identifier:main Σ 0..1 Identifier Unique code or number identifying the location to its users
..... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
..... type Σ 0..1 CodeableConcept Описание идентификатора
Привязка: Тип идентификатора организации (required)
...... id 0..1 id Уникальный идентификатор для межэлементных ссылок
...... extension 0..* Extension Дополнительный контент, определяемый реализациями
Разрез: Не упорядочено, Открыто от value:url
...... coding Σ 1..1 Coding Код, определенный в справочнике НСИ Терминология
....... id 0..1 id Уникальный идентификатор для межэлементных ссылок
....... extension 0..* Extension Дополнительный контент, определенный реализациями
Разрез: Не упорядочено, Открыто от value:url
....... system Σ 1..1 uri Ссылка на справочник
....... version Σ 0..1 string Версия системы
....... code ΣC 1..1 code Код
Требуемый шаблон: main
....... display ΣC 0..1 string Значение кода
....... userSelected Σ 0..1 boolean Если эта кодировка была выбрана непосредственно пользователем
...... text Σ 0..1 string Простое текстовое представление концепции
..... system Σ 0..1 uri Пространство имен для значения идентификатора
Требуемый шаблон: https://egr.gov.by
..... value ΣC 1..1 string Длина ОКПО равна 12 цифровым десятичным знакам, из которых первые 7 не имеют дополнительной смысловой нагрузки; восьмой знак представляет собой расчетное контрольное число; девятый знак соответствует первому знаку кода территории, на которой зарегистрирован респондент, в соответствии с общегосударственным классификатором ОКРБ 003-2017 «Система обозначений объектов административно-территориального деления» (далее – СОАТО), а 3 последних знака служат для выделения обособленных подразделений юридического лица.
Пример General: 123456
..... period Σ 0..1 Period Дата регистрации в ЕГР
...... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
...... start ΣC 1..1 dateTime Начало периода действия
...... end ΣC 0..1 dateTime Конец периода действия
.... identifier:mrec Σ 0..1 Identifier Unique code or number identifying the location to its users
..... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
..... type Σ 0..1 CodeableConcept Описание идентификатора
Привязка: Тип идентификатора организации (required)
...... id 0..1 id Уникальный идентификатор для межэлементных ссылок
...... extension 0..* Extension Дополнительный контент, определяемый реализациями
Разрез: Не упорядочено, Открыто от value:url
...... coding Σ 1..1 Coding Код, определенный в справочнике НСИ Терминология
....... id 0..1 id Уникальный идентификатор для межэлементных ссылок
....... extension 0..* Extension Дополнительный контент, определенный реализациями
Разрез: Не упорядочено, Открыто от value:url
....... system Σ 1..1 uri Ссылка на справочник
....... version Σ 0..1 string Версия системы
....... code ΣC 1..1 code Код
Требуемый шаблон: mrec
....... display ΣC 0..1 string Значение кода
....... userSelected Σ 0..1 boolean Если эта кодировка была выбрана непосредственно пользователем
...... text Σ 0..1 string Простое текстовое представление концепции
..... value ΣC 1..1 string Код МРЭК.
Пример General: 123456
... status ?!Σ 1..1 code Статус структурного подразделения: active - открыто | suspended - действие приостоновлено | inactive - закрыто
Привязка: LocationStatus (required): Indicates whether the location is still in use.
... name Σ 1..1 string Полное наименование структурного подразделения
... alias 0..1 string Сокращенное наименование структурного подразделения
... description Σ 0..1 markdown Описание подразделения по желанию
... type Σ 1..* CodeableConcept Тип структурного подразделения
Привязка: Тип структурного подразделения (required)
.... id 0..1 id Уникальный идентификатор для межэлементных ссылок
.... extension 0..* Extension Дополнительный контент, определяемый реализациями
Разрез: Не упорядочено, Открыто от value:url
.... coding Σ 1..1 Coding Код, определенный в справочнике НСИ Терминология
..... id 0..1 id Уникальный идентификатор для межэлементных ссылок
..... extension 0..* Extension Дополнительный контент, определенный реализациями
Разрез: Не упорядочено, Открыто от value:url
..... system Σ 1..1 uri Ссылка на справочник
..... version Σ 0..1 string Версия системы
..... code ΣC 1..1 code Код
..... display ΣC 0..1 string Значение кода
.... text Σ 0..1 string Простое текстовое представление концепции
... contact 0..* ExtendedContactDetail Контактная информация структурного подразделения
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... telecom Σ 1..1 ContactPoint Способ связи со структурным подразделением
..... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
..... system ΣC 1..1 code phone | fax | email | pager | url | sms | other
Привязка: ContactPointSystem (required): Телекоммуникационная форма для контактного пункта.
..... value ΣC 1..1 string Значение номера телефона, адреса эл. почты
... address 1..1 Address Physical location
.... Разрезы для extension 1..* Extension Extension
Разрез: Не упорядочено, Закрыто от value:url
..... extension:address S 1..1 CodeableConcept Адрес в соответствии со справочником населенных пунктов и административно-территориальных единиц Республики Беларусь
URL: https://fhir.by/StructureDefinition/StreetGeoRegistry
Привязка: Справочник населенных пунктов,улиц и административно-территориальных единиц (required)
..... extension:apartment S 0..1 string Текстовое поле используется для уточнения адресов, полученных из справочника 'Справочник населенных пунктов и административно-территориальных единиц'
URL: https://fhir.by/StructureDefinition/ApartmentRoom
..... extension:geo-coordinates S 0..1 (Комплекс) Координаты местоположения
URL: https://fhir.by/StructureDefinition/GeographicCoordinates
.... text Σ 1..1 string Текстовое представление адреса: значение поля 'Полное наименование' справочника 'Справочник населенных пунктов и административно-территориальных единиц'
Пример General: 220099, Минск, пр-т Победителей, 2, корп. 3, кв. 40
.... city Σ 0..1 string Название населенного пункта
Пример General: Минск
.... district Σ 0..1 string Район
Пример General: Минский район
.... state Σ 0..1 string Область
.... postalCode Σ 0..1 string Почтовый индекс: значение поля 'Почтовый индекс' справочника 'Справочник населенных пунктов и административно-территориальных единиц'
Пример General: 220099
... form Σ 0..1 CodeableConcept Физическая форма местоположения
Привязка: LocationForm (example): Физическая форма местоположения.
... managingOrganization Σ 0..1 Reference(Учреждение здравоохранения) Юридическое лицо или филиал частью которого является это подразделение
.... id 0..1 id Уникальный идентификатор для межэлементных ссылок
.... extension 0..* Extension Дополнительный контент, определяемый реализациями
Разрез: Не упорядочено, Открыто от value:url
.... reference ΣC 1..1 string Ссылка на ресурс в виде относительного URL
.... type Σ 0..1 uri Тип ресурса
Привязка: ResourceType (extensible): Ресурс (или, для логических моделей, URI логической модели).
.... identifier ΣC 0..1 Identifier Идентификатор ресурса, если не известна ссылка на него
.... display ΣC 0..1 string Текстовая трактовка ресурса
... partOf 0..1 Reference(Структурное подразделение) Структурное подразделение, частью которого является это подразделение
.... id 0..1 id Уникальный идентификатор для межэлементных ссылок
.... extension 0..* Extension Дополнительный контент, определяемый реализациями
Разрез: Не упорядочено, Открыто от value:url
.... reference ΣC 1..1 string Ссылка на ресурс в виде относительного URL
.... type Σ 0..1 uri Тип ресурса
Привязка: ResourceType (extensible): Ресурс (или, для логических моделей, URI логической модели).
.... identifier ΣC 0..1 Identifier Идентификатор ресурса, если не известна ссылка на него
.... display ΣC 0..1 string Текстовая трактовка ресурса
... endpoint 0..1 Reference(Endpoint) Technical endpoints providing access to services operated for the location

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

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

Путь Статус Использование ValueSet Версия Источник
Location.identifier:main.​type Base required Тип идентификатора организации 📦0.2.6803 этот IG
Location.identifier:mrec.​type Base required Тип идентификатора организации 📦0.2.6803 этот IG
Location.status Base required Location Status 📍5.0.0 Стандарт FHIR
Location.type Base required Тип структурного подразделения 📦0.2.6803 этот IG
Location.contact.telecom.​system Base required ContactPointSystem 📍5.0.0 Стандарт FHIR
Location.form Base example Location Form 📍5.0.0 Стандарт FHIR
Location.managingOrganization.​type Base extensible Resource Types 📍5.0.0 Стандарт FHIR
Location.partOf.type Base extensible Resource Types 📍5.0.0 Стандарт FHIR

Ограничения

Id Градация Путь(и) Описание Выражение
dom-2 error Location If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Location 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 Location 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 Location If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 лучшая практика Location A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ВСЕ** элементы All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ВСЕ** расширения Must have either extensions or value[x], not both extension.exists() != value.exists()

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

Summary

Обязательный: 15 элементs(14 вложенные обязательны элементs)
Обязательная поддержка: 5 элементs
Запрещено: 46 элементs

Структуры

Эта структура относится к этим другим структурам:

Расширения

Эта структура ссылается на эти расширения:

Разрезы

Эта структура определяет следующие Разрезы:

  • Элемент 1 разрешен в зависимости от значения Location.identifier (Closed)

Полная Схема

НаименованиеФлагиКарта.ТипОписание и ограничения    Filter: Filtersdoco
.. Location 0..* Location Details and position information for a place
... id Σ 1..1 id Уникальный идентификатор подразделения в реестре организаций
... meta Σ 1..1 Meta Метаданные о ресурсе
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... versionId Σ 0..1 id Идентификатор версии. Указывается версия ресурса, который подлежит редактированию, если предусмотрено правилами. Если версия не указана, то ресурс считается новым.
.... lastUpdated Σ 0..1 instant Дата и время последнего обновления
.... profile Σ 1..1 canonical(StructureDefinition) Ссылка на профиль

Требуемый шаблон: https://fhir.by/StructureDefinition/LocationUnit
... text 0..1 Narrative Краткое изложение текста ресурса для интерпретации человеком
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
.... extension:cabinetNumber S 0..1 string Номер кабинета
URL: https://fhir.by/StructureDefinition/CabinetNumber
.... extension:registration 1..1 (Комплекс) Информация о регистрации
URL: https://fhir.by/StructureDefinition/OrganizationRegistration
.... extension:bedsFond S 0..* (Комплекс) Коечный фонд организации структурного подразделения. Подразделения, такие как консультативные кабинеты или операционный блок могут не содержать информации о койках. Для некоторых подразделений возможно указание нескольких профилей коек и отдельно количества коек по каждому профилю. Например: терапевтическое отделение центральной районной больницы содержит 20 общетерапевтических коейк, 5 неврологических и 3 койки интенсивной терапии. Для описания такого подраздления необходимо создание 3-х экземпляров расширения, в каждом из которых будет описано количество коек, их профиль и дата обновления информации о койках.
URL: https://fhir.by/StructureDefinition/BedsFond
... Разрезы для identifier Σ 0..* Identifier Unique code or number identifying the location to its users
Разрез: Не упорядочено, Закрыто от value:type.coding.code
.... identifier:main Σ 0..1 Identifier Unique code or number identifying the location to its users
..... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
..... type Σ 0..1 CodeableConcept Описание идентификатора
Привязка: Тип идентификатора организации (required)
...... id 0..1 id Уникальный идентификатор для межэлементных ссылок
...... extension 0..* Extension Дополнительный контент, определяемый реализациями
Разрез: Не упорядочено, Открыто от value:url
...... coding Σ 1..1 Coding Код, определенный в справочнике НСИ Терминология
....... id 0..1 id Уникальный идентификатор для межэлементных ссылок
....... extension 0..* Extension Дополнительный контент, определенный реализациями
Разрез: Не упорядочено, Открыто от value:url
....... system Σ 1..1 uri Ссылка на справочник
....... version Σ 0..1 string Версия системы
....... code ΣC 1..1 code Код
Требуемый шаблон: main
....... display ΣC 0..1 string Значение кода
....... userSelected Σ 0..1 boolean Если эта кодировка была выбрана непосредственно пользователем
...... text Σ 0..1 string Простое текстовое представление концепции
..... system Σ 0..1 uri Пространство имен для значения идентификатора
Требуемый шаблон: https://egr.gov.by
..... value ΣC 1..1 string Длина ОКПО равна 12 цифровым десятичным знакам, из которых первые 7 не имеют дополнительной смысловой нагрузки; восьмой знак представляет собой расчетное контрольное число; девятый знак соответствует первому знаку кода территории, на которой зарегистрирован респондент, в соответствии с общегосударственным классификатором ОКРБ 003-2017 «Система обозначений объектов административно-территориального деления» (далее – СОАТО), а 3 последних знака служат для выделения обособленных подразделений юридического лица.
Пример General: 123456
..... period Σ 0..1 Period Дата регистрации в ЕГР
...... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
...... start ΣC 1..1 dateTime Начало периода действия
...... end ΣC 0..1 dateTime Конец периода действия
.... identifier:mrec Σ 0..1 Identifier Unique code or number identifying the location to its users
..... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
..... type Σ 0..1 CodeableConcept Описание идентификатора
Привязка: Тип идентификатора организации (required)
...... id 0..1 id Уникальный идентификатор для межэлементных ссылок
...... extension 0..* Extension Дополнительный контент, определяемый реализациями
Разрез: Не упорядочено, Открыто от value:url
...... coding Σ 1..1 Coding Код, определенный в справочнике НСИ Терминология
....... id 0..1 id Уникальный идентификатор для межэлементных ссылок
....... extension 0..* Extension Дополнительный контент, определенный реализациями
Разрез: Не упорядочено, Открыто от value:url
....... system Σ 1..1 uri Ссылка на справочник
....... version Σ 0..1 string Версия системы
....... code ΣC 1..1 code Код
Требуемый шаблон: mrec
....... display ΣC 0..1 string Значение кода
....... userSelected Σ 0..1 boolean Если эта кодировка была выбрана непосредственно пользователем
...... text Σ 0..1 string Простое текстовое представление концепции
..... value ΣC 1..1 string Код МРЭК.
Пример General: 123456
... status ?!Σ 1..1 code Статус структурного подразделения: active - открыто | suspended - действие приостоновлено | inactive - закрыто
Привязка: LocationStatus (required): Indicates whether the location is still in use.
... name Σ 1..1 string Полное наименование структурного подразделения
... alias 0..1 string Сокращенное наименование структурного подразделения
... description Σ 0..1 markdown Описание подразделения по желанию
... type Σ 1..* CodeableConcept Тип структурного подразделения
Привязка: Тип структурного подразделения (required)
.... id 0..1 id Уникальный идентификатор для межэлементных ссылок
.... extension 0..* Extension Дополнительный контент, определяемый реализациями
Разрез: Не упорядочено, Открыто от value:url
.... coding Σ 1..1 Coding Код, определенный в справочнике НСИ Терминология
..... id 0..1 id Уникальный идентификатор для межэлементных ссылок
..... extension 0..* Extension Дополнительный контент, определенный реализациями
Разрез: Не упорядочено, Открыто от value:url
..... system Σ 1..1 uri Ссылка на справочник
..... version Σ 0..1 string Версия системы
..... code ΣC 1..1 code Код
..... display ΣC 0..1 string Значение кода
.... text Σ 0..1 string Простое текстовое представление концепции
... contact 0..* ExtendedContactDetail Контактная информация структурного подразделения
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... telecom Σ 1..1 ContactPoint Способ связи со структурным подразделением
..... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
..... system ΣC 1..1 code phone | fax | email | pager | url | sms | other
Привязка: ContactPointSystem (required): Телекоммуникационная форма для контактного пункта.
..... value ΣC 1..1 string Значение номера телефона, адреса эл. почты
... address 1..1 Address Physical location
.... Разрезы для extension 1..* Extension Extension
Разрез: Не упорядочено, Закрыто от value:url
..... extension:address S 1..1 CodeableConcept Адрес в соответствии со справочником населенных пунктов и административно-территориальных единиц Республики Беларусь
URL: https://fhir.by/StructureDefinition/StreetGeoRegistry
Привязка: Справочник населенных пунктов,улиц и административно-территориальных единиц (required)
..... extension:apartment S 0..1 string Текстовое поле используется для уточнения адресов, полученных из справочника 'Справочник населенных пунктов и административно-территориальных единиц'
URL: https://fhir.by/StructureDefinition/ApartmentRoom
..... extension:geo-coordinates S 0..1 (Комплекс) Координаты местоположения
URL: https://fhir.by/StructureDefinition/GeographicCoordinates
.... text Σ 1..1 string Текстовое представление адреса: значение поля 'Полное наименование' справочника 'Справочник населенных пунктов и административно-территориальных единиц'
Пример General: 220099, Минск, пр-т Победителей, 2, корп. 3, кв. 40
.... city Σ 0..1 string Название населенного пункта
Пример General: Минск
.... district Σ 0..1 string Район
Пример General: Минский район
.... state Σ 0..1 string Область
.... postalCode Σ 0..1 string Почтовый индекс: значение поля 'Почтовый индекс' справочника 'Справочник населенных пунктов и административно-территориальных единиц'
Пример General: 220099
... form Σ 0..1 CodeableConcept Физическая форма местоположения
Привязка: LocationForm (example): Физическая форма местоположения.
... managingOrganization Σ 0..1 Reference(Учреждение здравоохранения) Юридическое лицо или филиал частью которого является это подразделение
.... id 0..1 id Уникальный идентификатор для межэлементных ссылок
.... extension 0..* Extension Дополнительный контент, определяемый реализациями
Разрез: Не упорядочено, Открыто от value:url
.... reference ΣC 1..1 string Ссылка на ресурс в виде относительного URL
.... type Σ 0..1 uri Тип ресурса
Привязка: ResourceType (extensible): Ресурс (или, для логических моделей, URI логической модели).
.... identifier ΣC 0..1 Identifier Идентификатор ресурса, если не известна ссылка на него
.... display ΣC 0..1 string Текстовая трактовка ресурса
... partOf 0..1 Reference(Структурное подразделение) Структурное подразделение, частью которого является это подразделение
.... id 0..1 id Уникальный идентификатор для межэлементных ссылок
.... extension 0..* Extension Дополнительный контент, определяемый реализациями
Разрез: Не упорядочено, Открыто от value:url
.... reference ΣC 1..1 string Ссылка на ресурс в виде относительного URL
.... type Σ 0..1 uri Тип ресурса
Привязка: ResourceType (extensible): Ресурс (или, для логических моделей, URI логической модели).
.... identifier ΣC 0..1 Identifier Идентификатор ресурса, если не известна ссылка на него
.... display ΣC 0..1 string Текстовая трактовка ресурса
... endpoint 0..1 Reference(Endpoint) Technical endpoints providing access to services operated for the location

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

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

Путь Статус Использование ValueSet Версия Источник
Location.identifier:main.​type Base required Тип идентификатора организации 📦0.2.6803 этот IG
Location.identifier:mrec.​type Base required Тип идентификатора организации 📦0.2.6803 этот IG
Location.status Base required Location Status 📍5.0.0 Стандарт FHIR
Location.type Base required Тип структурного подразделения 📦0.2.6803 этот IG
Location.contact.telecom.​system Base required ContactPointSystem 📍5.0.0 Стандарт FHIR
Location.form Base example Location Form 📍5.0.0 Стандарт FHIR
Location.managingOrganization.​type Base extensible Resource Types 📍5.0.0 Стандарт FHIR
Location.partOf.type Base extensible Resource Types 📍5.0.0 Стандарт FHIR

Ограничения

Id Градация Путь(и) Описание Выражение
dom-2 error Location If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Location 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 Location 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 Location If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 лучшая практика Location A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ВСЕ** элементы All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ВСЕ** расширения Must have either extensions or value[x], not both extension.exists() != value.exists()

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

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

НаименованиеФлагиКарта.ТипОписание и ограничения    Filter: Filtersdoco
.. Location 0..* Location Details and position information for a place
... id 1..1 id Уникальный идентификатор подразделения в реестре организаций
... meta 1..1 Meta Метаданные о ресурсе
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... versionId 0..1 id Идентификатор версии. Указывается версия ресурса, который подлежит редактированию, если предусмотрено правилами. Если версия не указана, то ресурс считается новым.
.... lastUpdated 0..1 instant Дата и время последнего обновления
.... source 0..0 Определяет, откуда берется ресурс
.... profile 1..1 canonical(StructureDefinition) Ссылка на профиль
Требуемый шаблон: https://fhir.by/StructureDefinition/LocationUnit
.... security 0..0 Метки безопасности, примененные к этому ресурсу
.... tag 0..0 Теги, применяемые к этому ресурсу
... implicitRules 0..0 Набор правил, в соответствии с которыми был создан этот контент
... contained 0..0 Автономные встроенные ресурсы
... Разрезы для extension 1..* Extension Extension
Разрез: Не упорядочено, Закрыто от value:$this.url
.... extension:cabinetNumber S 0..1 string Номер кабинета
URL: https://fhir.by/StructureDefinition/CabinetNumber
.... extension:registration 1..1 (Комплекс) Информация о регистрации
URL: https://fhir.by/StructureDefinition/OrganizationRegistration
.... extension:bedsFond S 0..* (Комплекс) Коечный фонд организации структурного подразделения. Подразделения, такие как консультативные кабинеты или операционный блок могут не содержать информации о койках. Для некоторых подразделений возможно указание нескольких профилей коек и отдельно количества коек по каждому профилю. Например: терапевтическое отделение центральной районной больницы содержит 20 общетерапевтических коейк, 5 неврологических и 3 койки интенсивной терапии. Для описания такого подраздления необходимо создание 3-х экземпляров расширения, в каждом из которых будет описано количество коек, их профиль и дата обновления информации о койках.
URL: https://fhir.by/StructureDefinition/BedsFond
... modifierExtension 0..0 Extension
... Разрезы для identifier 0..* Identifier Unique code or number identifying the location to its users
Разрез: Не упорядочено, Закрыто от value:type.coding.code
.... identifier:main 0..1 Identifier Unique code or number identifying the location to its users
..... id 0..0 Уникальный идентификатор для межэлементных ссылок
..... extension 0..0 Extension
..... use 0..0 usual | official | temp | secondary | old (Если известно)
..... type 0..1 CodeableConcept Описание идентификатора
Привязка: Тип идентификатора организации (required)
...... coding 1..1 Coding Код, определенный в справочнике НСИ Терминология
....... system 1..1 uri Ссылка на справочник
....... code 1..1 code Код
Требуемый шаблон: main
..... system 0..1 uri Пространство имен для значения идентификатора
Требуемый шаблон: https://egr.gov.by
..... value 1..1 string Длина ОКПО равна 12 цифровым десятичным знакам, из которых первые 7 не имеют дополнительной смысловой нагрузки; восьмой знак представляет собой расчетное контрольное число; девятый знак соответствует первому знаку кода территории, на которой зарегистрирован респондент, в соответствии с общегосударственным классификатором ОКРБ 003-2017 «Система обозначений объектов административно-территориального деления» (далее – СОАТО), а 3 последних знака служат для выделения обособленных подразделений юридического лица.
..... period 0..1 Period Дата регистрации в ЕГР
...... id 0..0 Уникальный идентификатор для межэлементных ссылок
...... extension 0..0 Extension
...... start 1..1 dateTime Начало периода действия
..... assigner 0..0 Организация, выдавшая идентификатор (может быть просто текстом)
.... identifier:mrec 0..1 Identifier Unique code or number identifying the location to its users
..... id 0..0 Уникальный идентификатор для межэлементных ссылок
..... extension 0..0 Extension
..... use 0..0 usual | official | temp | secondary | old (Если известно)
..... type 0..1 CodeableConcept Описание идентификатора
Привязка: Тип идентификатора организации (required)
...... coding 1..1 Coding Код, определенный в справочнике НСИ Терминология
....... system 1..1 uri Ссылка на справочник
....... code 1..1 code Код
Требуемый шаблон: mrec
..... system 0..0 Пространство имен для значения идентификатора
..... value 1..1 string Код МРЭК.
..... period 0..0 Период времени, в течение которого идентификатор действителен для использования
..... assigner 0..0 Организация, выдавшая идентификатор (может быть просто текстом)
... status 1..1 code Статус структурного подразделения: active - открыто | suspended - действие приостоновлено | inactive - закрыто
... operationalStatus 0..0 The operational status of the location (typically only for a bed/room)
... name 1..1 string Полное наименование структурного подразделения
... alias 0..1 string Сокращенное наименование структурного подразделения
... description 0..1 markdown Описание подразделения по желанию
... mode 0..0 instance | kind
... type 1..* CodeableConcept Тип структурного подразделения
Привязка: Тип структурного подразделения (required)
.... coding 1..1 Coding Код, определенный в справочнике НСИ Терминология
..... system 1..1 uri Ссылка на справочник
..... code 1..1 code Код
..... userSelected 0..0 Если эта кодировка была выбрана непосредственно пользователем
... contact 0..* ExtendedContactDetail Контактная информация структурного подразделения
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... purpose 0..0 Тип контакта
.... name 0..0 Name of an individual to contact
.... telecom 1..1 ContactPoint Способ связи со структурным подразделением
..... id 0..0 Уникальный идентификатор для межэлементных ссылок
..... extension 0..0 Extension
..... system 1..1 code phone | fax | email | pager | url | sms | other
..... value 1..1 string Значение номера телефона, адреса эл. почты
..... use 0..0 home | work | temp | old | mobile - назначение этой контактной точки
..... rank 0..0 Укажите предпочтительный порядок использования (1 = самый высокий)
..... period 0..0 Период времени, в течение которого контактная точка использовалась/продолжает использоваться
.... address 0..0 Адрес
.... organization 0..0 This contact detail is handled/monitored by a specific organization
.... period 0..0 Период, в течение которого этот контакт был действителен для использования
... address 1..1 Address Physical location
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... Разрезы для extension 1..* Extension Extension
Разрез: Не упорядочено, Закрыто от value:url
..... extension:address S 1..1 CodeableConcept Адрес в соответствии со справочником населенных пунктов и административно-территориальных единиц Республики Беларусь
URL: https://fhir.by/StructureDefinition/StreetGeoRegistry
Привязка: Справочник населенных пунктов,улиц и административно-территориальных единиц (required)
..... extension:apartment S 0..1 string Текстовое поле используется для уточнения адресов, полученных из справочника 'Справочник населенных пунктов и административно-территориальных единиц'
URL: https://fhir.by/StructureDefinition/ApartmentRoom
..... extension:geo-coordinates S 0..1 (Комплекс) Координаты местоположения
URL: https://fhir.by/StructureDefinition/GeographicCoordinates
.... use 0..0 home | work | temp | old | billing - назначение этого адреса
.... type 0..0 postal | physical | both
.... text 1..1 string Текстовое представление адреса: значение поля 'Полное наименование' справочника 'Справочник населенных пунктов и административно-территориальных единиц'
.... line 0..0 Название улицы, номер дома/строения, корпус, номер квартиры/помещения, номер абонентского ящика и прочее.
.... city 0..1 string Название населенного пункта
.... district 0..1 string Район
.... state 0..1 string Область
.... postalCode 0..1 string Почтовый индекс: значение поля 'Почтовый индекс' справочника 'Справочник населенных пунктов и административно-территориальных единиц'
.... country 0..0 Страна (например, это может быть двух- или трехбуквенный код ISO 3166)
.... period 0..0 Период времени, когда адрес использовался/используется
... position 0..0 The absolute geographic location
... managingOrganization 0..1 Reference(Учреждение здравоохранения) Юридическое лицо или филиал частью которого является это подразделение
.... reference 1..1 string Ссылка на ресурс в виде относительного URL
... partOf 0..1 Reference(Структурное подразделение) Структурное подразделение, частью которого является это подразделение
.... reference 1..1 string Ссылка на ресурс в виде относительного URL
... characteristic 0..0 Collection of characteristics (attributes)
... hoursOfOperation 0..0 What days/times during a week is this location usually open (including exceptions)
... virtualService 0..0 Сведения о подключении к виртуальной службе (например, конференц-связь)
... endpoint 0..1 Reference(Endpoint) Technical endpoints providing access to services operated for the location

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

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

Путь Статус Использование ValueSet Версия Источник
Location.identifier:main.​type Base required Тип идентификатора организации 📦0.2.6803 этот IG
Location.identifier:mrec.​type Base required Тип идентификатора организации 📦0.2.6803 этот IG
Location.type Base required Тип структурного подразделения 📦0.2.6803 этот IG

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

Summary

Обязательный: 15 элементs(14 вложенные обязательны элементs)
Обязательная поддержка: 5 элементs
Запрещено: 46 элементs

Структуры

Эта структура относится к этим другим структурам:

Расширения

Эта структура ссылается на эти расширения:

Разрезы

Эта структура определяет следующие Разрезы:

  • Элемент 1 разрешен в зависимости от значения Location.identifier (Closed)

 


Примечания:

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

Местоположения могут варьироваться от целых зданий до кабинетов. Можно связать “меньшие” местоположения с содержащимися в них “большими” местоположениями, используя элемент Location.partOf.

Location.position определяется с использованием того же синтаксиса, данных и системы отсчета, что и в файлах Google Earth’s KML files (см. значок KML в Google/OGS).

Исключения, связанные с доступностью местоположения, такие как государственные праздники или плановое техническое обслуживание, могут быть заблокированы с помощью свойств hoursOfOperation.notAvailableTime. Исключение может быть определено как простое текстовое описание (например, государственные праздники). Предпочтительно, чтобы в исключении были указаны фактические даты начала/окончания.

Режим определения местоположения:

Элемент Location.mode может использоваться для указания того, представляет ли ресурс Location конкретное (потенциально идентифицируемое) Location (“instance”) или класс Location (“kind”).

В частности, к ресурсам в режиме “kind” могут относиться заказы на сбор данных, планирование ресурсов, планы и определения. Для этих доменов часто нет необходимости ссылаться на конкретное местоположение, а скорее на класс местоположений. Например: в разделе планирование необходимо выделить “изолятор” для пациента или вызвать “скорую помощь” в определенное время. В этих случаях нет необходимости точно определять, в каком изоляторе находится отделение скорой помощи, достаточно просто указать “kind” помещения.

“kind” следует использовать не для обозначения местоположений, в которых был задействован фактический экземпляр Location, а для определения недостающей информации. Например, когда пациент прибыл “на машине скорой помощи”, но неизвестно, на какой машине скорой помощи, это должно быть представлено с использованием Location в “instance” режим с отсутствующим идентификатором, а не с указанием местоположения “kind” машины скорой помощи.

Некоторые элементы данных Location актуальны только тогда, когда режим является “instance”, и не должны использоваться, когда режим является “kind” (однако эта информация все равно может быть включена, если она актуальна, например, когда речь идет о типовом элементе, но не универсальном в глобальном масштабе, например, о машине скорой помощи медицинского центра):

  • Location.identifier;
  • Location.telecom;
  • Location.address;
  • Location.position;
  • Location.status;
  • Location.managingOrganization.

Примеры иерархии Location:

img 
Городская больница №15 Строение Б (Organization)
    Правое крыло (instance)
        Этаж 1 (instance)
            Приемный покой (instance)
                Смотровая A (instance)
            Обсервационное отделение (instance)
                Палата 1 (instance) 
                    Койка 1a (instance)
                Палата 2 (instance)
                    Койка 2а (instance) 
                    Койка 2b (instance)
                Палата 3 (instance)
                    Койка 3а (instance)
                    Койка 3b (instance)
                    Койка 3c (instance)
                Палата 4 (instance)
                    ...
            Рентгенологическое отделение (instance)
                Рентгеновский кабинет (instance)
                Кабинет КТ (instance)
                Кабинет МРТ (instance)
        Этаж 2 (instance)
            Пост 1 (instance)
                Палата 1 (instance) 
                    Койка 1a (instance)
                Палата 2 (instance)
                    Койка 2а (instance) 
                    Койка 2b (instance)
                Перевязочная
                Палата 3 (instance)
                    Койка 3а (instance)
                    Койка 3b (instance)
                    Койка 3c (instance)...
            Пост 2 (instance)
                Палата 4 (instance) 
                    Койка 4a (instance)
                Палата 5 (instance)
                    Койка 5а (instance) 
                    Койка 5b (instance)
                Процедурный кабинет
                Палата 6 (instance)
                    Койка 6а (instance)
                    Койка 6b (instance)
                    Койка 6c (instance)...
            Комната хранения медикаментов
Мобильные сервисы (kind)
    СМП (kind)
        Реанемобиль Р1 (instance)
        Реанемобиль Р2 (instance)
        Машина СМП С1

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

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

GET [FHIR_BASE]/Location/[id]

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

GET [FHIR_BASE]/Location?type=value&...

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

Параметр поиска Тип Описание Выражение Пример
_id token По логическому идентификатору Location.id GET [FHIR_BASE]/Location?_id=123456
_lastUpdated date Дата обновления ресурса Location.meta.lastUpdated GET [FHIR_BASE]/Location?_lastUpdated=ge2025-09-01
_profile reference По профилю ресурса Location.meta.profile GET [FHIR_BASE]/Location?_profile=https://fhir.by/StructureDefinition/LocationUnit
act-in-registr date Дата актуализации Location.extension(‘https://fhir.by/StructureDefinition/OrganizationRegistration’).extension(‘https://fhir.by/StructureDefinition/OrganizationActInRegistr’).value as date GET [FHIR_BASE]/Location?act-in-registr=ge2025-09-01
address-city string По населенному пункту Location.address.city GET [FHIR_BASE]//Location?address-city=Могилев
address-district string По району Location.address.district GET [FHIR_BASE]/Location?address-district=Могилевский
address-state string По области Location.address.state GET [FHIR_BASE]//Location?address-state=Могилевская
identifier token Поиск по ОКПО Location.identifier GET [FHIR_BASE]/Location?identifier=00119292
name string Часть или полное название подразделения Location.name | Location.alias GET [FHIR_BASE]/Location?name=ООО "Анализ Мед"
alias string Часть или полное название подразделения Location.alias GET [FHIR_BASE]/Location?alias=КДЛ лаборатория
organization reference Выполняет поиск подразделений, которыми управляет указанная организация Location.managingOrganization GET [FHIR_BASE]/Location?organization=Organization/12345678901234
type token Код, обозначающий тип подразделения Location.type GET [FHIR_BASE]/Location?type=other-branch
partof reference Подразделение, частью которого является это подразделение Location.partOf GET [FHIR_BASE]/Location?partof=Location/12345678901234
status token Выполняет поиск подразделений с определенным статусом Location.status GET [FHIR_BASE]/Location?status=active

Поиск по логическому идентификатору

GET [FHIR_BASE]/Location?_id=123- возвращает структурное подразделение с логическим идентификатором 123

GET [FHIR_BASE]/Location?_id=123,321- возвращает структурное подразделение с логическими идентификаторами 123 ИЛИ 321

GET [FHIR_BASE]/Location?_id=123&_id=321- возвращает пустой список структурных подразделений - применение логического И в данном случае не имеет смысла, но поддерживается системой

Учитывая, что логический идентификатор уникален, поиск по логическому идентификатору всегда приведет к нулю или единице записей. Во многих отношениях поиск функционально эквивалентен простому методу получения ресурса. Однако есть некоторые различия в использовании поиска вместо чтения:

  • Операции поиска всегда возвращают ресурс Bundle.

  • Если логический идентификатор существует и ресурс может быть возвращен, результатом будет Bundle, содержащий ресурс, а не сам ресурс.

  • Если логический идентификатор не существует или не может быть возвращен, результатом действительного поиска все равно будет Bundle. Bundle МОЖЕТ включать дополнительную информацию в форме OperationOutcome.

  • Доступен дополнительный функционал поиска. Например, запрос ресурса «Location» по логическому идентификатору, а также установка критериев поиска identifier вернет структурное подразделение только в том случае, если идентификатор совпал.

Поиск по профилю ресурса.

​Параметр поиска _profile используется для сопоставления ресурсов на основе значений в элементе Resource.meta.profile

Параметр поиска _profile определяется как параметр ссылочного типа.

GET [FHIR_BASE]/Location?_profile=https://fhir.by/StructureDefinition/LocationUnit

НЕ допускается использование ТОЛЬКО параметра поиска _profile, ДОЛЖЕН использоваться ТОЛЬКО в комбинации с каким-либо другим параметром поиска (_id, name)

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

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