0.2.0 - ci-build

RuCoreIG, published by HL7 FHIR Россия. This guide is not an authorized publication; it is the continuous build for version 0.2.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/fhir-ru/RuCoreIG/ and changes regularly. See the Directory of published versions

Data Type Profile: Core Address (Адрес)

Official URL: https://fhir.ru/ig/core/StructureDefinition/core-address Version: 0.2.0
Active as of 2025-08-19 Computable Name: Core_Address

Базовый профиль адреса для российских FHIR-реализаций

Core_Address — Профиль адреса

Принятые решения по профилированию

Бизнес-требование Атрибут Решение по профилированию
При кодировании адреса необходимо использовать адресную систему ФИАС fias Определено расширение для указания кода адресного объекта и кода дома по адресной системе ФИАС (описание).
В адресе должен быть указан код региона по справочнику regionRF Определено расширение для указания кода региона по справочнику регионов РФ (ValueSet, CodeSystem).
Требуется указание использования адреса для прописки или проживания address-type Атрибут use не точно соответствует требованиям, поэтому определено расширение для указания типа использования адреса, заполняется по справочнику (ValueSet, CodeSystem).
В принципе, можно описать соответствие Address.use и данного справочника НСИ. billing = 1 — адрес постоянной регистрации, temp = 2 — адрес временной регистрации, home = 3 — домашний адрес, work = 4 — адрес работы/учёбы, old — не используется. Вопрос не решался на встречах сообщества.

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

Профиль Core_Address расширяет стандартный ресурс Address для поддержки российских требований:

  • Использование идентификаторов ФИАС для адресных объектов (расширение fias)
  • Указание кода региона РФ по справочнику (расширение regionRF)
  • Указание типа адреса по справочнику НСИ (расширение address-type)

Используемые справочники и системы идентификации


FSH-код профиля

Profile: Core_Address
Parent: Address
Id: core-address
Title: "Core Address (Адрес)"
Description: "Базовый профиль адреса для российских FHIR-реализаций"

* extension contains
    https://fhir.ru/ig/core/StructureDefinition/fias named fias 0..1 and
    https://fhir.ru/ig/core/StructureDefinition/regionRF named regionRF 0..1 and
    https://fhir.ru/ig/core/StructureDefinition/address-type named addressType 0..1

* extension[fias] ^short = "ФИАС"

* extension[regionRF] ^short = "Код региона РФ"

* extension[addressType] ^short = "Тип адреса"

* text ^short = "Текстовое представление адреса"

* postalCode ^short = "Почтовый индекс"

* state ^short = "Регион"

Usages:

You can also check for usages in the FHIR IG Statistics

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Address 0..* Address An address expressed using postal conventions (as opposed to GPS or other location definition formats)
... Slices for extension Content/Rules for all slices
.... extension:fias 0..1 (Complex) ФИАС
URL: https://fhir.ru/ig/core/StructureDefinition/fias
.... extension:regionRF 0..1 CodeableConcept Код региона РФ
URL: https://fhir.ru/ig/core/StructureDefinition/regionRF
Binding: Core ValueSet Регионы РФ (required)
.... extension:addressType 0..1 CodeableConcept Тип адреса
URL: https://fhir.ru/ig/core/StructureDefinition/address-type
Binding: Core ValueSet Типы адресов (required)
... use ?!Σ 0..1 code home | work | temp | old | billing - purpose of this address
Binding: AddressUse (required): The use of an address (home / work / etc.).
Example General: home
... text Σ 0..1 string Текстовое представление адреса
Example General: 137 Nowhere Street, Erewhon 9132
... postalCode Σ 0..1 string Почтовый индекс
Example General: 9132

doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
Address.userequiredAddressUse
http://hl7.org/fhir/ValueSet/address-use|5.0.0
From the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()

This structure is derived from Address

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Address 0..* Address An address expressed using postal conventions (as opposed to GPS or other location definition formats)
... Slices for extension Content/Rules for all slices
.... extension:fias 0..1 (Complex) ФИАС
URL: https://fhir.ru/ig/core/StructureDefinition/fias
.... extension:regionRF 0..1 CodeableConcept Код региона РФ
URL: https://fhir.ru/ig/core/StructureDefinition/regionRF
Binding: Core ValueSet Регионы РФ (required)
.... extension:addressType 0..1 CodeableConcept Тип адреса
URL: https://fhir.ru/ig/core/StructureDefinition/address-type
Binding: Core ValueSet Типы адресов (required)
... text 0..1 string Текстовое представление адреса
... state 0..1 string Регион

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Address 0..* Address An address expressed using postal conventions (as opposed to GPS or other location definition formats)
... id 0..1 id Unique id for inter-element referencing
... Slices for extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... extension:fias 0..1 (Complex) ФИАС
URL: https://fhir.ru/ig/core/StructureDefinition/fias
.... extension:regionRF 0..1 CodeableConcept Код региона РФ
URL: https://fhir.ru/ig/core/StructureDefinition/regionRF
Binding: Core ValueSet Регионы РФ (required)
.... extension:addressType 0..1 CodeableConcept Тип адреса
URL: https://fhir.ru/ig/core/StructureDefinition/address-type
Binding: Core ValueSet Типы адресов (required)
... use ?!Σ 0..1 code home | work | temp | old | billing - purpose of this address
Binding: AddressUse (required): The use of an address (home / work / etc.).
Example General: home
... text Σ 0..1 string Текстовое представление адреса
Example General: 137 Nowhere Street, Erewhon 9132
... line Σ 0..* string Street name, number, direction & P.O. Box etc.
This repeating element order: The order in which lines should appear in an address label
Example General: 137 Nowhere Street
... city Σ 0..1 string Name of city, town etc.
Example General: Erewhon
... district Σ 0..1 string District name (aka county)
Example General: Madison
... state Σ 0..1 string Регион
... postalCode Σ 0..1 string Почтовый индекс
Example General: 9132
... country Σ 0..1 string Country (e.g. may be ISO 3166 2 or 3 letter code)
... period Σ 0..1 Period Time period when address was/is in use
Example General: {"start":"2010-03-23","end":"2010-07-01"}

doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
Address.userequiredAddressUse
http://hl7.org/fhir/ValueSet/address-use|5.0.0
From the FHIR Standard
Address.typerequiredAddressType
http://hl7.org/fhir/ValueSet/address-type|5.0.0
From the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Address 0..* Address An address expressed using postal conventions (as opposed to GPS or other location definition formats)
... Slices for extension Content/Rules for all slices
.... extension:fias 0..1 (Complex) ФИАС
URL: https://fhir.ru/ig/core/StructureDefinition/fias
.... extension:regionRF 0..1 CodeableConcept Код региона РФ
URL: https://fhir.ru/ig/core/StructureDefinition/regionRF
Binding: Core ValueSet Регионы РФ (required)
.... extension:addressType 0..1 CodeableConcept Тип адреса
URL: https://fhir.ru/ig/core/StructureDefinition/address-type
Binding: Core ValueSet Типы адресов (required)
... use ?!Σ 0..1 code home | work | temp | old | billing - purpose of this address
Binding: AddressUse (required): The use of an address (home / work / etc.).
Example General: home
... text Σ 0..1 string Текстовое представление адреса
Example General: 137 Nowhere Street, Erewhon 9132
... postalCode Σ 0..1 string Почтовый индекс
Example General: 9132

doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
Address.userequiredAddressUse
http://hl7.org/fhir/ValueSet/address-use|5.0.0
From the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()

Differential View

This structure is derived from Address

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Address 0..* Address An address expressed using postal conventions (as opposed to GPS or other location definition formats)
... Slices for extension Content/Rules for all slices
.... extension:fias 0..1 (Complex) ФИАС
URL: https://fhir.ru/ig/core/StructureDefinition/fias
.... extension:regionRF 0..1 CodeableConcept Код региона РФ
URL: https://fhir.ru/ig/core/StructureDefinition/regionRF
Binding: Core ValueSet Регионы РФ (required)
.... extension:addressType 0..1 CodeableConcept Тип адреса
URL: https://fhir.ru/ig/core/StructureDefinition/address-type
Binding: Core ValueSet Типы адресов (required)
... text 0..1 string Текстовое представление адреса
... state 0..1 string Регион

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Address 0..* Address An address expressed using postal conventions (as opposed to GPS or other location definition formats)
... id 0..1 id Unique id for inter-element referencing
... Slices for extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... extension:fias 0..1 (Complex) ФИАС
URL: https://fhir.ru/ig/core/StructureDefinition/fias
.... extension:regionRF 0..1 CodeableConcept Код региона РФ
URL: https://fhir.ru/ig/core/StructureDefinition/regionRF
Binding: Core ValueSet Регионы РФ (required)
.... extension:addressType 0..1 CodeableConcept Тип адреса
URL: https://fhir.ru/ig/core/StructureDefinition/address-type
Binding: Core ValueSet Типы адресов (required)
... use ?!Σ 0..1 code home | work | temp | old | billing - purpose of this address
Binding: AddressUse (required): The use of an address (home / work / etc.).
Example General: home
... text Σ 0..1 string Текстовое представление адреса
Example General: 137 Nowhere Street, Erewhon 9132
... line Σ 0..* string Street name, number, direction & P.O. Box etc.
This repeating element order: The order in which lines should appear in an address label
Example General: 137 Nowhere Street
... city Σ 0..1 string Name of city, town etc.
Example General: Erewhon
... district Σ 0..1 string District name (aka county)
Example General: Madison
... state Σ 0..1 string Регион
... postalCode Σ 0..1 string Почтовый индекс
Example General: 9132
... country Σ 0..1 string Country (e.g. may be ISO 3166 2 or 3 letter code)
... period Σ 0..1 Period Time period when address was/is in use
Example General: {"start":"2010-03-23","end":"2010-07-01"}

doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
Address.userequiredAddressUse
http://hl7.org/fhir/ValueSet/address-use|5.0.0
From the FHIR Standard
Address.typerequiredAddressType
http://hl7.org/fhir/ValueSet/address-type|5.0.0
From the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()

 

Other representations of profile: CSV, Excel, Schematron