Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide
0.10.0 - Draft for Community Review
Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide - Draft for Community Review (v0.10.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| URL chính thức: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-relatedperson | Phiên bản: 0.10.0 | ||||
| Computable Name: VNCoreRelatedPerson | |||||
| Định danh khác: OID:2.25.161089673617632664299011809196868855799.42.109 | |||||
Bản quyền/Pháp lý: Căn cứ pháp lý Việt Nam: Luật 15/2023/QH15 (Luật KCB 2023); NĐ 96/2023/NĐ-CP; TT 32/2023/TT-BYT; Bộ luật Dân sự 2015; Luật Trẻ em 2016; Luật 91/2025/QH15; NĐ 356/2025/NĐ-CP. |
|||||
Profile RelatedPerson cho Việt Nam. Dùng cho cha, mẹ, người giám hộ, người đại diện hợp pháp hoặc người liên hệ của bệnh nhân. Áp dụng cho ca trẻ em, sơ sinh, consent qua cha/mẹ, và liên thông BHYT/EMR. Thiết kế theo hướng chuẩn hoá của US Core, JP Core, CH Core: dùng base RelatedPerson thay vì extension tuỳ biến.
Căn cứ pháp lý:
Usages:
You can also check for usages in the FHIR IG Statistics
Mô tả profile, differential, snapshot và các biểu diễn liên quan.
| Name | Flags | Card. | Type | Description & Constraints Filter:   | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
  RelatedPerson |
0..* | RelatedPerson | A person that is related to a patient, but who is not a direct target of care | |||||||||
  implicitRules |
?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||||||
  Slices for extension |
0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||||||
   extension:representationAuthority |
SOC | 0..* | (Complex) | Thẩm quyền đại diện/giám hộ/uỷ quyền truy cập dữ liệu (type/source/period/restriction) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-representation-authority Constraints: vn-representation-domain-basis, vn-representation-type-selection-basis, vn-representation-proxy-evidence, vn-representation-proxy-bounded
| ||||||||
 extension:ethnicity |
SO | 0..1 | CodeableConcept | Dân tộc URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ethnicity Binding: Danh mục Dân tộc Việt Nam — Vietnam Ethnicity ValueSet (required)
| ||||||||
 modifierExtension |
?! | 0..* | Extension | Extensions that cannot be ignored | ||||||||
 Slices for identifier |
SOΣ | 0..* | Identifier | Định danh người liên quan Slice: Unordered, Open by pattern:type
| ||||||||
 identifier:CCCD |
SOΣC | 0..1 | Identifier | A human identifier for this person Constraints: vn-cccd-format
| ||||||||
  use |
?!Σ | 0..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known . | ||||||||
  type |
Σ | 1..1 | CodeableConcept | Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. Required Pattern: At least the following | ||||||||
 id |
0..1 | string | Unique id for inter-element referencing | |||||||||
| extension |
0..* | Extension | Additional content defined by implementations | |||||||||
 coding |
1..* | Coding | Code defined by a terminology system Fixed Value: (Complex) | |||||||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||||||
| extension |
0..* | Extension | Additional content defined by implementations | |||||||||
| system |
1..1 | uri | Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs | |||||||||
| version |
0..1 | string | Version of the system - if relevant | |||||||||
| code |
1..1 | code | Symbol in syntax defined by the system Fixed Value: CCCD | |||||||||
| display |
0..1 | string | Representation defined by the system | |||||||||
 userSelected |
0..1 | boolean | If this coding was chosen directly by the user | |||||||||
| text |
0..1 | string | Plain text representation of the concept | |||||||||
| system |
Σ | 1..1 | uri | The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/cccd | ||||||||
 value |
SΣ | 1..1 | string | The value that is unique Example General: 123456 | ||||||||
 identifier:HC |
SOΣ | 0..1 | Identifier | A human identifier for this person
| ||||||||
 use |
?!Σ | 0..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known . | ||||||||
| type |
Σ | 1..1 | CodeableConcept | Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. Required Pattern: At least the following | ||||||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||||||
| extension |
0..* | Extension | Additional content defined by implementations | |||||||||
| coding |
1..* | Coding | Code defined by a terminology system Fixed Value: (Complex) | |||||||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||||||
| extension |
0..* | Extension | Additional content defined by implementations | |||||||||
| system |
1..1 | uri | Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs | |||||||||
| version |
0..1 | string | Version of the system - if relevant | |||||||||
| code |
1..1 | code | Symbol in syntax defined by the system Fixed Value: HC | |||||||||
| display |
0..1 | string | Representation defined by the system | |||||||||
| userSelected |
0..1 | boolean | If this coding was chosen directly by the user | |||||||||
| text |
0..1 | string | Plain text representation of the concept | |||||||||
| system |
Σ | 1..1 | uri | The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient | ||||||||
| value |
Σ | 1..1 | string | The value that is unique Example General: 123456 | ||||||||
| active |
?!SOΣ | 1..1 | boolean | Bản ghi đang hoạt động
| ||||||||
 patient |
SOΣ | 1..1 | Reference(Bệnh nhân VN Core — VN Core Patient Profile) | Bệnh nhân liên quan
| ||||||||
| relationship |
SOΣ | 1..* | CodeableConcept | Quan hệ GIA ĐÌNH với bệnh nhân (mother/father...) — KHÁC trục thẩm quyền pháp lý ở extension[representationAuthority] Binding: PatientRelationshipType (extensible)
| ||||||||
| name |
SOΣ | 0..* | HumanName | Họ tên người liên quan
| ||||||||
| telecom |
SOΣ | 0..* | ContactPoint | Thông tin liên lạc
| ||||||||
| address |
SOΣ | 0..* | VNCoreAddress | Địa chỉ
| ||||||||
| period |
0..1 | Period | Thời gian quan hệ có hiệu lực | |||||||||
| Documentation for this format | ||||||||||||
| Path | Status | Usage | ValueSet | Version | Source |
| RelatedPerson.identifier:CCCD.use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std. |
| RelatedPerson.identifier:CCCD.type | Base | extensible | IdentifierType | 📍4.0.1 | FHIR Std. |
| RelatedPerson.identifier:HC.use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std. |
| RelatedPerson.identifier:HC.type | Base | extensible | IdentifierType | 📍4.0.1 | FHIR Std. |
| RelatedPerson.relationship | Base | extensible | Patient relationship type | 📦4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| dom-2 | error | RelatedPerson | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | RelatedPerson | 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().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | RelatedPerson | 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 | RelatedPerson | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | RelatedPerson | A resource should have narrative for robust management |
text.`div`.exists()
|
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
hasValue() or (children().count() > id.count())
|
| ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both |
extension.exists() != value.exists()
|
| vn-cccd-format | error | RelatedPerson.identifier:CCCD | Số định danh cá nhân/CCCD, khi có giá trị, phải đúng 12 chữ số (Luật Căn cước 2023, Điều 12) |
value.empty() or value.extension.where(url='http://hl7.org/fhir/StructureDefinition/data-absent-reason').exists() or value.matches('^[0-9]{12}$')
|
| vn-representation-domain-basis | error | RelatedPerson.extension:representationAuthority | Miền quyết định khám chữa bệnh bắt buộc có căn cứ lựa chọn theo Luật KCB Điều 8 khoản 2; miền quyền chủ thể dữ liệu không dùng trục căn cứ đó. The healthcare-decision domain SHALL carry a selectionBasis; the data-subject-rights domain SHALL NOT. |
(extension.where(url='domain').value.ofType(Coding).code = 'healthcare-decision' implies extension.where(url='selectionBasis').exists()) and (extension.where(url='domain').value.ofType(Coding).code = 'data-subject-rights' implies extension.where(url='selectionBasis').empty())
|
| vn-representation-proxy-bounded | error | RelatedPerson.extension:representationAuthority | Thẩm quyền theo uỷ quyền phải có GIỚI HẠN máy-đọc: NGÀY KẾT THÚC (period.end của token hoặc validity.end trong bằng chứng — chỉ có ngày bắt đầu là uỷ quyền vô thời hạn) VÀ phạm vi (scope trong ít nhất một bằng chứng) — Bộ luật Dân sự Điều 138/140/141. A delegated-proxy authority SHALL carry a machine-readable validity bound AND scope. |
extension.where(url='type').value.ofType(Coding).code != 'delegated-proxy' or ((extension.where(url='period').value.ofType(Period).end.exists() or extension.where(url='evidence').extension.where(url='validity').value.ofType(Period).end.exists()) and extension.where(url='evidence').extension.where(url='scope').exists())
|
| vn-representation-proxy-evidence | error | RelatedPerson.extension:representationAuthority | Thẩm quyền theo uỷ quyền phải kèm ít nhất một bằng chứng (văn bản uỷ quyền). A delegated-proxy authority SHALL carry at least one evidence entry. |
extension.where(url='type').value.ofType(Coding).code = 'delegated-proxy' implies extension.where(url='evidence').exists()
|
| vn-representation-type-selection-basis | error | RelatedPerson.extension:representationAuthority | Loại thẩm quyền phải tương thích với nhóm căn cứ lựa chọn tại Luật KCB Điều 8 khoản 2. The authority type SHALL be consistent with the statutory selection basis. |
extension.where(url='selectionBasis').empty() or ((extension.where(url='selectionBasis').value.ofType(Coding).code = 'civil-code-representative') and (extension.where(url='type').value.ofType(Coding).code = 'legal-representative' or extension.where(url='type').value.ofType(Coding).code = 'guardian' or extension.where(url='type').value.ofType(Coding).code = 'delegated-proxy')) or ((extension.where(url='selectionBasis').value.ofType(Coding).code = 'responsible-legal-entity-appointed') and (extension.where(url='type').value.ofType(Coding).code = 'legal-representative' or extension.where(url='type').value.ofType(Coding).code = 'healthcare-agent')) or ((extension.where(url='selectionBasis').value.ofType(Coding).code = 'adult-patient-selected' or extension.where(url='selectionBasis').value.ofType(Coding).code = 'family-selected' or extension.where(url='selectionBasis').value.ofType(Coding).code = 'voluntary-obligation-performer') and extension.where(url='type').value.ofType(Coding).code = 'healthcare-agent')
|
| Name | Kho hồ sơ EMR (Repository) | Ứng dụng người dân (Citizen App) | Nguồn tạo hồ sơ lâm sàng (Document Source) |
|---|---|---|---|
| RelatedPerson |
|||
| Slices for extension |
|||
| extension:representationAuthority |
| ||
| extension:ethnicity |
| ||
| Slices for identifier |
| ||
| identifier:CCCD |
| ||
| identifier:HC |
| ||
 active |
| ||
| patient |
| ||
| relationship |
| ||
| name |
| ||
| telecom |
| ||
| address |
| ||
| Documentation for this format | |||
| Path | Status | Usage | ValueSet | Version | Source |
| RelatedPerson.relationship | Base | extensible | Patient relationship type | 📦4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| vn-cccd-format | error | RelatedPerson.identifier:CCCD | Số định danh cá nhân/CCCD, khi có giá trị, phải đúng 12 chữ số (Luật Căn cước 2023, Điều 12) |
value.empty() or value.extension.where(url='http://hl7.org/fhir/StructureDefinition/data-absent-reason').exists() or value.matches('^[0-9]{12}$')
|
| Name | Flags | Card. | Type | Description & Constraints Filter: | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| RelatedPerson |
0..* | RelatedPerson | A person that is related to a patient, but who is not a direct target of care | |||||||||
| id |
Σ | 0..1 | id | Logical id of this artifact | ||||||||
| meta |
Σ | 0..1 | Meta | Metadata about the resource | ||||||||
| implicitRules |
?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||||||
| language |
0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
| |||||||||
| text |
0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements | |||||||||
| contained |
0..* | Resource | Contained, inline Resources | |||||||||
| Slices for extension |
0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||||||
| extension:representationAuthority |
SOC | 0..* | (Complex) | Thẩm quyền đại diện/giám hộ/uỷ quyền truy cập dữ liệu (type/source/period/restriction) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-representation-authority Constraints: vn-representation-domain-basis, vn-representation-type-selection-basis, vn-representation-proxy-evidence, vn-representation-proxy-bounded
| ||||||||
| extension:ethnicity |
SO | 0..1 | CodeableConcept | Dân tộc URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ethnicity Binding: Danh mục Dân tộc Việt Nam — Vietnam Ethnicity ValueSet (required)
| ||||||||
| modifierExtension |
?! | 0..* | Extension | Extensions that cannot be ignored | ||||||||
| Slices for identifier |
SOΣ | 0..* | Identifier | Định danh người liên quan Slice: Unordered, Open by pattern:type
| ||||||||
| identifier:CCCD |
SOΣC | 0..1 | Identifier | A human identifier for this person Constraints: vn-cccd-format
| ||||||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||||||
| extension |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||||||
| use |
?!Σ | 0..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known . | ||||||||
| type |
Σ | 1..1 | CodeableConcept | Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. Required Pattern: At least the following | ||||||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||||||
| extension |
0..* | Extension | Additional content defined by implementations | |||||||||
| coding |
1..* | Coding | Code defined by a terminology system Fixed Value: (Complex) | |||||||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||||||
| extension |
0..* | Extension | Additional content defined by implementations | |||||||||
| system |
1..1 | uri | Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs | |||||||||
| version |
0..1 | string | Version of the system - if relevant | |||||||||
| code |
1..1 | code | Symbol in syntax defined by the system Fixed Value: CCCD | |||||||||
| display |
0..1 | string | Representation defined by the system | |||||||||
| userSelected |
0..1 | boolean | If this coding was chosen directly by the user | |||||||||
| text |
0..1 | string | Plain text representation of the concept | |||||||||
| system |
Σ | 1..1 | uri | The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/cccd | ||||||||
| value |
SΣ | 1..1 | string | The value that is unique Example General: 123456 | ||||||||
| period |
Σ | 0..1 | Period | Time period when id is/was valid for use | ||||||||
| assigner |
Σ | 0..1 | Reference(Organization) | Organization that issued id (may be just text) | ||||||||
| identifier:HC |
SOΣ | 0..1 | Identifier | A human identifier for this person
| ||||||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||||||
| extension |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||||||
| use |
?!Σ | 0..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known . | ||||||||
| type |
Σ | 1..1 | CodeableConcept | Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. Required Pattern: At least the following | ||||||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||||||
| extension |
0..* | Extension | Additional content defined by implementations | |||||||||
| coding |
1..* | Coding | Code defined by a terminology system Fixed Value: (Complex) | |||||||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||||||
| extension |
0..* | Extension | Additional content defined by implementations | |||||||||
| system |
1..1 | uri | Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs | |||||||||
| version |
0..1 | string | Version of the system - if relevant | |||||||||
| code |
1..1 | code | Symbol in syntax defined by the system Fixed Value: HC | |||||||||
| display |
0..1 | string | Representation defined by the system | |||||||||
| userSelected |
0..1 | boolean | If this coding was chosen directly by the user | |||||||||
| text |
0..1 | string | Plain text representation of the concept | |||||||||
| system |
Σ | 1..1 | uri | The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient | ||||||||
| value |
Σ | 1..1 | string | The value that is unique Example General: 123456 | ||||||||
| period |
Σ | 0..1 | Period | Time period when id is/was valid for use | ||||||||
| assigner |
Σ | 0..1 | Reference(Organization) | Organization that issued id (may be just text) | ||||||||
| active |
?!SOΣ | 1..1 | boolean | Bản ghi đang hoạt động
| ||||||||
| patient |
SOΣ | 1..1 | Reference(Bệnh nhân VN Core — VN Core Patient Profile) | Bệnh nhân liên quan
| ||||||||
| relationship |
SOΣ | 1..* | CodeableConcept | Quan hệ GIA ĐÌNH với bệnh nhân (mother/father...) — KHÁC trục thẩm quyền pháp lý ở extension[representationAuthority] Binding: PatientRelationshipType (extensible)
| ||||||||
| name |
SOΣ | 0..* | HumanName | Họ tên người liên quan
| ||||||||
| telecom |
SOΣ | 0..* | ContactPoint | Thông tin liên lạc
| ||||||||
| gender |
Σ | 0..1 | code | male | female | other | unknown Binding: AdministrativeGender (required): The gender of a person used for administrative purposes. | ||||||||
| birthDate |
Σ | 0..1 | date | The date on which the related person was born | ||||||||
| address |
SOΣ | 0..* | VNCoreAddress | Địa chỉ
| ||||||||
| photo |
0..* | Attachment | Image of the person | |||||||||
| period |
0..1 | Period | Thời gian quan hệ có hiệu lực | |||||||||
 communication |
0..* | BackboneElement | A language which may be used to communicate with about the patient's health | |||||||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||||||
| extension |
0..* | Extension | Additional content defined by implementations | |||||||||
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||||||
| language |
1..1 | CodeableConcept | The language which can be used to communicate with the patient about his or her health Binding: CommonLanguages (preferred): A human language.
| |||||||||
| preferred |
0..1 | boolean | Language preference indicator | |||||||||
| Documentation for this format | ||||||||||||
| Name | Kho hồ sơ EMR (Repository) | Ứng dụng người dân (Citizen App) | Nguồn tạo hồ sơ lâm sàng (Document Source) |
|---|---|---|---|
| RelatedPerson |
|||
| Slices for extension |
|||
| extension:representationAuthority |
| ||
| extension:ethnicity |
| ||
| Slices for identifier |
| ||
| identifier:CCCD |
| ||
| identifier:HC |
| ||
| active |
| ||
| patient |
| ||
| relationship |
| ||
| name |
| ||
| telecom |
| ||
| address |
| ||
| Documentation for this format | |||
| Path | Status | Usage | ValueSet | Version | Source |
| RelatedPerson.language | Base | preferred | Common Languages | 📍4.0.1 | FHIR Std. |
| RelatedPerson.identifier:CCCD.use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std. |
| RelatedPerson.identifier:CCCD.type | Base | extensible | IdentifierType | 📍4.0.1 | FHIR Std. |
| RelatedPerson.identifier:HC.use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std. |
| RelatedPerson.identifier:HC.type | Base | extensible | IdentifierType | 📍4.0.1 | FHIR Std. |
| RelatedPerson.relationship | Base | extensible | Patient relationship type | 📦4.0.1 | FHIR Std. |
| RelatedPerson.gender | Base | required | AdministrativeGender | 📍4.0.1 | FHIR Std. |
| RelatedPerson.communication.language | Base | preferred | Common Languages | 📍4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| dom-2 | error | RelatedPerson | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | RelatedPerson | 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().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | RelatedPerson | 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 | RelatedPerson | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | RelatedPerson | A resource should have narrative for robust management |
text.`div`.exists()
|
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
hasValue() or (children().count() > id.count())
|
| ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both |
extension.exists() != value.exists()
|
| vn-cccd-format | error | RelatedPerson.identifier:CCCD | Số định danh cá nhân/CCCD, khi có giá trị, phải đúng 12 chữ số (Luật Căn cước 2023, Điều 12) |
value.empty() or value.extension.where(url='http://hl7.org/fhir/StructureDefinition/data-absent-reason').exists() or value.matches('^[0-9]{12}$')
|
| vn-representation-domain-basis | error | RelatedPerson.extension:representationAuthority | Miền quyết định khám chữa bệnh bắt buộc có căn cứ lựa chọn theo Luật KCB Điều 8 khoản 2; miền quyền chủ thể dữ liệu không dùng trục căn cứ đó. The healthcare-decision domain SHALL carry a selectionBasis; the data-subject-rights domain SHALL NOT. |
(extension.where(url='domain').value.ofType(Coding).code = 'healthcare-decision' implies extension.where(url='selectionBasis').exists()) and (extension.where(url='domain').value.ofType(Coding).code = 'data-subject-rights' implies extension.where(url='selectionBasis').empty())
|
| vn-representation-proxy-bounded | error | RelatedPerson.extension:representationAuthority | Thẩm quyền theo uỷ quyền phải có GIỚI HẠN máy-đọc: NGÀY KẾT THÚC (period.end của token hoặc validity.end trong bằng chứng — chỉ có ngày bắt đầu là uỷ quyền vô thời hạn) VÀ phạm vi (scope trong ít nhất một bằng chứng) — Bộ luật Dân sự Điều 138/140/141. A delegated-proxy authority SHALL carry a machine-readable validity bound AND scope. |
extension.where(url='type').value.ofType(Coding).code != 'delegated-proxy' or ((extension.where(url='period').value.ofType(Period).end.exists() or extension.where(url='evidence').extension.where(url='validity').value.ofType(Period).end.exists()) and extension.where(url='evidence').extension.where(url='scope').exists())
|
| vn-representation-proxy-evidence | error | RelatedPerson.extension:representationAuthority | Thẩm quyền theo uỷ quyền phải kèm ít nhất một bằng chứng (văn bản uỷ quyền). A delegated-proxy authority SHALL carry at least one evidence entry. |
extension.where(url='type').value.ofType(Coding).code = 'delegated-proxy' implies extension.where(url='evidence').exists()
|
| vn-representation-type-selection-basis | error | RelatedPerson.extension:representationAuthority | Loại thẩm quyền phải tương thích với nhóm căn cứ lựa chọn tại Luật KCB Điều 8 khoản 2. The authority type SHALL be consistent with the statutory selection basis. |
extension.where(url='selectionBasis').empty() or ((extension.where(url='selectionBasis').value.ofType(Coding).code = 'civil-code-representative') and (extension.where(url='type').value.ofType(Coding).code = 'legal-representative' or extension.where(url='type').value.ofType(Coding).code = 'guardian' or extension.where(url='type').value.ofType(Coding).code = 'delegated-proxy')) or ((extension.where(url='selectionBasis').value.ofType(Coding).code = 'responsible-legal-entity-appointed') and (extension.where(url='type').value.ofType(Coding).code = 'legal-representative' or extension.where(url='type').value.ofType(Coding).code = 'healthcare-agent')) or ((extension.where(url='selectionBasis').value.ofType(Coding).code = 'adult-patient-selected' or extension.where(url='selectionBasis').value.ofType(Coding).code = 'family-selected' or extension.where(url='selectionBasis').value.ofType(Coding).code = 'voluntary-obligation-performer') and extension.where(url='type').value.ofType(Coding).code = 'healthcare-agent')
|
| Name | Kho hồ sơ EMR (Repository) | Ứng dụng người dân (Citizen App) | Nguồn tạo hồ sơ lâm sàng (Document Source) |
|---|---|---|---|
| RelatedPerson |
|||
| Slices for extension |
|||
| extension:representationAuthority |
| ||
| extension:ethnicity |
| ||
| Slices for identifier |
| ||
| identifier:CCCD |
| ||
| identifier:HC |
| ||
| active |
| ||
| patient |
| ||
| relationship |
| ||
| name |
| ||
| telecom |
| ||
| address |
| ||
| Documentation for this format | |||
Summary
Mandatory: 2 elements(6 nested mandatory elements)
Must-Support: 12 elements
Fixed: 1 element
Structures
This structure refers to these other structures:
Extensions
This structure refers to these extensions:
Slices
This structure defines the following Slices:
Dạng xem phần tử chính
| Name | Flags | Card. | Type | Description & Constraints Filter: | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| RelatedPerson |
0..* | RelatedPerson | A person that is related to a patient, but who is not a direct target of care | |||||||||
| implicitRules |
?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||||||
| Slices for extension |
0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||||||
| extension:representationAuthority |
SOC | 0..* | (Complex) | Thẩm quyền đại diện/giám hộ/uỷ quyền truy cập dữ liệu (type/source/period/restriction) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-representation-authority Constraints: vn-representation-domain-basis, vn-representation-type-selection-basis, vn-representation-proxy-evidence, vn-representation-proxy-bounded
| ||||||||
| extension:ethnicity |
SO | 0..1 | CodeableConcept | Dân tộc URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ethnicity Binding: Danh mục Dân tộc Việt Nam — Vietnam Ethnicity ValueSet (required)
| ||||||||
| modifierExtension |
?! | 0..* | Extension | Extensions that cannot be ignored | ||||||||
| Slices for identifier |
SOΣ | 0..* | Identifier | Định danh người liên quan Slice: Unordered, Open by pattern:type
| ||||||||
| identifier:CCCD |
SOΣC | 0..1 | Identifier | A human identifier for this person Constraints: vn-cccd-format
| ||||||||
| use |
?!Σ | 0..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known . | ||||||||
| type |
Σ | 1..1 | CodeableConcept | Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. Required Pattern: At least the following | ||||||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||||||
| extension |
0..* | Extension | Additional content defined by implementations | |||||||||
| coding |
1..* | Coding | Code defined by a terminology system Fixed Value: (Complex) | |||||||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||||||
| extension |
0..* | Extension | Additional content defined by implementations | |||||||||
| system |
1..1 | uri | Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs | |||||||||
| version |
0..1 | string | Version of the system - if relevant | |||||||||
| code |
1..1 | code | Symbol in syntax defined by the system Fixed Value: CCCD | |||||||||
| display |
0..1 | string | Representation defined by the system | |||||||||
| userSelected |
0..1 | boolean | If this coding was chosen directly by the user | |||||||||
| text |
0..1 | string | Plain text representation of the concept | |||||||||
| system |
Σ | 1..1 | uri | The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/cccd | ||||||||
| value |
SΣ | 1..1 | string | The value that is unique Example General: 123456 | ||||||||
| identifier:HC |
SOΣ | 0..1 | Identifier | A human identifier for this person
| ||||||||
| use |
?!Σ | 0..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known . | ||||||||
| type |
Σ | 1..1 | CodeableConcept | Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. Required Pattern: At least the following | ||||||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||||||
| extension |
0..* | Extension | Additional content defined by implementations | |||||||||
| coding |
1..* | Coding | Code defined by a terminology system Fixed Value: (Complex) | |||||||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||||||
| extension |
0..* | Extension | Additional content defined by implementations | |||||||||
| system |
1..1 | uri | Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs | |||||||||
| version |
0..1 | string | Version of the system - if relevant | |||||||||
| code |
1..1 | code | Symbol in syntax defined by the system Fixed Value: HC | |||||||||
| display |
0..1 | string | Representation defined by the system | |||||||||
| userSelected |
0..1 | boolean | If this coding was chosen directly by the user | |||||||||
| text |
0..1 | string | Plain text representation of the concept | |||||||||
| system |
Σ | 1..1 | uri | The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient | ||||||||
| value |
Σ | 1..1 | string | The value that is unique Example General: 123456 | ||||||||
| active |
?!SOΣ | 1..1 | boolean | Bản ghi đang hoạt động
| ||||||||
| patient |
SOΣ | 1..1 | Reference(Bệnh nhân VN Core — VN Core Patient Profile) | Bệnh nhân liên quan
| ||||||||
| relationship |
SOΣ | 1..* | CodeableConcept | Quan hệ GIA ĐÌNH với bệnh nhân (mother/father...) — KHÁC trục thẩm quyền pháp lý ở extension[representationAuthority] Binding: PatientRelationshipType (extensible)
| ||||||||
| name |
SOΣ | 0..* | HumanName | Họ tên người liên quan
| ||||||||
| telecom |
SOΣ | 0..* | ContactPoint | Thông tin liên lạc
| ||||||||
| address |
SOΣ | 0..* | VNCoreAddress | Địa chỉ
| ||||||||
| period |
0..1 | Period | Thời gian quan hệ có hiệu lực | |||||||||
| Documentation for this format | ||||||||||||
| Name | Kho hồ sơ EMR (Repository) | Ứng dụng người dân (Citizen App) | Nguồn tạo hồ sơ lâm sàng (Document Source) |
|---|---|---|---|
| RelatedPerson |
|||
| Slices for extension |
|||
| extension:representationAuthority |
| ||
| extension:ethnicity |
| ||
| Slices for identifier |
| ||
| identifier:CCCD |
| ||
| identifier:HC |
| ||
| active |
| ||
| patient |
| ||
| relationship |
| ||
| name |
| ||
| telecom |
| ||
| address |
| ||
| Documentation for this format | |||
| Path | Status | Usage | ValueSet | Version | Source |
| RelatedPerson.identifier:CCCD.use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std. |
| RelatedPerson.identifier:CCCD.type | Base | extensible | IdentifierType | 📍4.0.1 | FHIR Std. |
| RelatedPerson.identifier:HC.use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std. |
| RelatedPerson.identifier:HC.type | Base | extensible | IdentifierType | 📍4.0.1 | FHIR Std. |
| RelatedPerson.relationship | Base | extensible | Patient relationship type | 📦4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| dom-2 | error | RelatedPerson | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | RelatedPerson | 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().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | RelatedPerson | 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 | RelatedPerson | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | RelatedPerson | A resource should have narrative for robust management |
text.`div`.exists()
|
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
hasValue() or (children().count() > id.count())
|
| ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both |
extension.exists() != value.exists()
|
| vn-cccd-format | error | RelatedPerson.identifier:CCCD | Số định danh cá nhân/CCCD, khi có giá trị, phải đúng 12 chữ số (Luật Căn cước 2023, Điều 12) |
value.empty() or value.extension.where(url='http://hl7.org/fhir/StructureDefinition/data-absent-reason').exists() or value.matches('^[0-9]{12}$')
|
| vn-representation-domain-basis | error | RelatedPerson.extension:representationAuthority | Miền quyết định khám chữa bệnh bắt buộc có căn cứ lựa chọn theo Luật KCB Điều 8 khoản 2; miền quyền chủ thể dữ liệu không dùng trục căn cứ đó. The healthcare-decision domain SHALL carry a selectionBasis; the data-subject-rights domain SHALL NOT. |
(extension.where(url='domain').value.ofType(Coding).code = 'healthcare-decision' implies extension.where(url='selectionBasis').exists()) and (extension.where(url='domain').value.ofType(Coding).code = 'data-subject-rights' implies extension.where(url='selectionBasis').empty())
|
| vn-representation-proxy-bounded | error | RelatedPerson.extension:representationAuthority | Thẩm quyền theo uỷ quyền phải có GIỚI HẠN máy-đọc: NGÀY KẾT THÚC (period.end của token hoặc validity.end trong bằng chứng — chỉ có ngày bắt đầu là uỷ quyền vô thời hạn) VÀ phạm vi (scope trong ít nhất một bằng chứng) — Bộ luật Dân sự Điều 138/140/141. A delegated-proxy authority SHALL carry a machine-readable validity bound AND scope. |
extension.where(url='type').value.ofType(Coding).code != 'delegated-proxy' or ((extension.where(url='period').value.ofType(Period).end.exists() or extension.where(url='evidence').extension.where(url='validity').value.ofType(Period).end.exists()) and extension.where(url='evidence').extension.where(url='scope').exists())
|
| vn-representation-proxy-evidence | error | RelatedPerson.extension:representationAuthority | Thẩm quyền theo uỷ quyền phải kèm ít nhất một bằng chứng (văn bản uỷ quyền). A delegated-proxy authority SHALL carry at least one evidence entry. |
extension.where(url='type').value.ofType(Coding).code = 'delegated-proxy' implies extension.where(url='evidence').exists()
|
| vn-representation-type-selection-basis | error | RelatedPerson.extension:representationAuthority | Loại thẩm quyền phải tương thích với nhóm căn cứ lựa chọn tại Luật KCB Điều 8 khoản 2. The authority type SHALL be consistent with the statutory selection basis. |
extension.where(url='selectionBasis').empty() or ((extension.where(url='selectionBasis').value.ofType(Coding).code = 'civil-code-representative') and (extension.where(url='type').value.ofType(Coding).code = 'legal-representative' or extension.where(url='type').value.ofType(Coding).code = 'guardian' or extension.where(url='type').value.ofType(Coding).code = 'delegated-proxy')) or ((extension.where(url='selectionBasis').value.ofType(Coding).code = 'responsible-legal-entity-appointed') and (extension.where(url='type').value.ofType(Coding).code = 'legal-representative' or extension.where(url='type').value.ofType(Coding).code = 'healthcare-agent')) or ((extension.where(url='selectionBasis').value.ofType(Coding).code = 'adult-patient-selected' or extension.where(url='selectionBasis').value.ofType(Coding).code = 'family-selected' or extension.where(url='selectionBasis').value.ofType(Coding).code = 'voluntary-obligation-performer') and extension.where(url='type').value.ofType(Coding).code = 'healthcare-agent')
|
Dạng xem Differential
| Name | Flags | Card. | Type | Description & Constraints Filter: | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| RelatedPerson |
RelatedPerson | |||||||||||
| Slices for extension |
0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||||||
| extension:representationAuthority |
SO | 0..* | (Complex) | Thẩm quyền đại diện/giám hộ/uỷ quyền truy cập dữ liệu (type/source/period/restriction) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-representation-authority
| ||||||||
| extension:ethnicity |
SO | 0..1 | CodeableConcept | Dân tộc URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ethnicity Binding: Danh mục Dân tộc Việt Nam — Vietnam Ethnicity ValueSet (required)
| ||||||||
| Slices for identifier |
SO | 0..* | Identifier | Định danh người liên quan Slice: Unordered, Open by pattern:type
| ||||||||
| identifier:CCCD |
SOC | 0..1 | Identifier | A human identifier for this person Constraints: vn-cccd-format
| ||||||||
| type |
1..1 | CodeableConcept | Description of identifier Required Pattern: At least the following | |||||||||
| coding |
1..* | Coding | Code defined by a terminology system Fixed Value: (Complex) | |||||||||
| system |
1..1 | uri | Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs | |||||||||
| code |
1..1 | code | Symbol in syntax defined by the system Fixed Value: CCCD | |||||||||
| system |
1..1 | uri | The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/cccd | |||||||||
| value |
S | 1..1 | string | The value that is unique | ||||||||
| identifier:HC |
SO | 0..1 | Identifier | A human identifier for this person
| ||||||||
| type |
1..1 | CodeableConcept | Description of identifier Required Pattern: At least the following | |||||||||
| coding |
1..* | Coding | Code defined by a terminology system Fixed Value: (Complex) | |||||||||
| system |
1..1 | uri | Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs | |||||||||
| code |
1..1 | code | Symbol in syntax defined by the system Fixed Value: HC | |||||||||
| system |
1..1 | uri | The namespace for the identifier value | |||||||||
| value |
1..1 | string | The value that is unique | |||||||||
| active |
SO | 1..1 | boolean | Bản ghi đang hoạt động
| ||||||||
| patient |
SO | 1..1 | Reference(Bệnh nhân VN Core — VN Core Patient Profile) | Bệnh nhân liên quan
| ||||||||
| relationship |
SO | 1..* | CodeableConcept | Quan hệ GIA ĐÌNH với bệnh nhân (mother/father...) — KHÁC trục thẩm quyền pháp lý ở extension[representationAuthority] Binding: PatientRelationshipType (extensible)
| ||||||||
| name |
SO | 0..* | HumanName | Họ tên người liên quan
| ||||||||
| telecom |
SO | 0..* | ContactPoint | Thông tin liên lạc
| ||||||||
| address |
SO | 0..* | VNCoreAddress | Địa chỉ
| ||||||||
| period |
0..1 | Period | Thời gian quan hệ có hiệu lực | |||||||||
| Documentation for this format | ||||||||||||
| Name | Kho hồ sơ EMR (Repository) | Ứng dụng người dân (Citizen App) | Nguồn tạo hồ sơ lâm sàng (Document Source) |
|---|---|---|---|
| RelatedPerson |
|||
| Slices for extension |
|||
| extension:representationAuthority |
| ||
| extension:ethnicity |
| ||
| Slices for identifier |
| ||
| identifier:CCCD |
| ||
| identifier:HC |
| ||
| active |
| ||
| patient |
| ||
| relationship |
| ||
| name |
| ||
| telecom |
| ||
| address |
| ||
| Documentation for this format | |||
| Path | Status | Usage | ValueSet | Version | Source |
| RelatedPerson.relationship | Base | extensible | Patient relationship type | 📦4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| vn-cccd-format | error | RelatedPerson.identifier:CCCD | Số định danh cá nhân/CCCD, khi có giá trị, phải đúng 12 chữ số (Luật Căn cước 2023, Điều 12) |
value.empty() or value.extension.where(url='http://hl7.org/fhir/StructureDefinition/data-absent-reason').exists() or value.matches('^[0-9]{12}$')
|
Dạng xem SnapshotView
| Name | Flags | Card. | Type | Description & Constraints Filter: | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| RelatedPerson |
0..* | RelatedPerson | A person that is related to a patient, but who is not a direct target of care | |||||||||
| id |
Σ | 0..1 | id | Logical id of this artifact | ||||||||
| meta |
Σ | 0..1 | Meta | Metadata about the resource | ||||||||
| implicitRules |
?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||||||
| language |
0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
| |||||||||
| text |
0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements | |||||||||
| contained |
0..* | Resource | Contained, inline Resources | |||||||||
| Slices for extension |
0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||||||
| extension:representationAuthority |
SOC | 0..* | (Complex) | Thẩm quyền đại diện/giám hộ/uỷ quyền truy cập dữ liệu (type/source/period/restriction) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-representation-authority Constraints: vn-representation-domain-basis, vn-representation-type-selection-basis, vn-representation-proxy-evidence, vn-representation-proxy-bounded
| ||||||||
| extension:ethnicity |
SO | 0..1 | CodeableConcept | Dân tộc URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ethnicity Binding: Danh mục Dân tộc Việt Nam — Vietnam Ethnicity ValueSet (required)
| ||||||||
| modifierExtension |
?! | 0..* | Extension | Extensions that cannot be ignored | ||||||||
| Slices for identifier |
SOΣ | 0..* | Identifier | Định danh người liên quan Slice: Unordered, Open by pattern:type
| ||||||||
| identifier:CCCD |
SOΣC | 0..1 | Identifier | A human identifier for this person Constraints: vn-cccd-format
| ||||||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||||||
| extension |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||||||
| use |
?!Σ | 0..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known . | ||||||||
| type |
Σ | 1..1 | CodeableConcept | Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. Required Pattern: At least the following | ||||||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||||||
| extension |
0..* | Extension | Additional content defined by implementations | |||||||||
| coding |
1..* | Coding | Code defined by a terminology system Fixed Value: (Complex) | |||||||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||||||
| extension |
0..* | Extension | Additional content defined by implementations | |||||||||
| system |
1..1 | uri | Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs | |||||||||
| version |
0..1 | string | Version of the system - if relevant | |||||||||
| code |
1..1 | code | Symbol in syntax defined by the system Fixed Value: CCCD | |||||||||
| display |
0..1 | string | Representation defined by the system | |||||||||
| userSelected |
0..1 | boolean | If this coding was chosen directly by the user | |||||||||
| text |
0..1 | string | Plain text representation of the concept | |||||||||
| system |
Σ | 1..1 | uri | The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/cccd | ||||||||
| value |
SΣ | 1..1 | string | The value that is unique Example General: 123456 | ||||||||
| period |
Σ | 0..1 | Period | Time period when id is/was valid for use | ||||||||
| assigner |
Σ | 0..1 | Reference(Organization) | Organization that issued id (may be just text) | ||||||||
| identifier:HC |
SOΣ | 0..1 | Identifier | A human identifier for this person
| ||||||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||||||
| extension |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||||||
| use |
?!Σ | 0..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known . | ||||||||
| type |
Σ | 1..1 | CodeableConcept | Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. Required Pattern: At least the following | ||||||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||||||
| extension |
0..* | Extension | Additional content defined by implementations | |||||||||
| coding |
1..* | Coding | Code defined by a terminology system Fixed Value: (Complex) | |||||||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||||||
| extension |
0..* | Extension | Additional content defined by implementations | |||||||||
| system |
1..1 | uri | Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs | |||||||||
| version |
0..1 | string | Version of the system - if relevant | |||||||||
| code |
1..1 | code | Symbol in syntax defined by the system Fixed Value: HC | |||||||||
| display |
0..1 | string | Representation defined by the system | |||||||||
| userSelected |
0..1 | boolean | If this coding was chosen directly by the user | |||||||||
| text |
0..1 | string | Plain text representation of the concept | |||||||||
| system |
Σ | 1..1 | uri | The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient | ||||||||
| value |
Σ | 1..1 | string | The value that is unique Example General: 123456 | ||||||||
| period |
Σ | 0..1 | Period | Time period when id is/was valid for use | ||||||||
| assigner |
Σ | 0..1 | Reference(Organization) | Organization that issued id (may be just text) | ||||||||
| active |
?!SOΣ | 1..1 | boolean | Bản ghi đang hoạt động
| ||||||||
| patient |
SOΣ | 1..1 | Reference(Bệnh nhân VN Core — VN Core Patient Profile) | Bệnh nhân liên quan
| ||||||||
| relationship |
SOΣ | 1..* | CodeableConcept | Quan hệ GIA ĐÌNH với bệnh nhân (mother/father...) — KHÁC trục thẩm quyền pháp lý ở extension[representationAuthority] Binding: PatientRelationshipType (extensible)
| ||||||||
| name |
SOΣ | 0..* | HumanName | Họ tên người liên quan
| ||||||||
| telecom |
SOΣ | 0..* | ContactPoint | Thông tin liên lạc
| ||||||||
| gender |
Σ | 0..1 | code | male | female | other | unknown Binding: AdministrativeGender (required): The gender of a person used for administrative purposes. | ||||||||
| birthDate |
Σ | 0..1 | date | The date on which the related person was born | ||||||||
| address |
SOΣ | 0..* | VNCoreAddress | Địa chỉ
| ||||||||
| photo |
0..* | Attachment | Image of the person | |||||||||
| period |
0..1 | Period | Thời gian quan hệ có hiệu lực | |||||||||
| communication |
0..* | BackboneElement | A language which may be used to communicate with about the patient's health | |||||||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||||||
| extension |
0..* | Extension | Additional content defined by implementations | |||||||||
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||||||
| language |
1..1 | CodeableConcept | The language which can be used to communicate with the patient about his or her health Binding: CommonLanguages (preferred): A human language.
| |||||||||
| preferred |
0..1 | boolean | Language preference indicator | |||||||||
| Documentation for this format | ||||||||||||
| Name | Kho hồ sơ EMR (Repository) | Ứng dụng người dân (Citizen App) | Nguồn tạo hồ sơ lâm sàng (Document Source) |
|---|---|---|---|
| RelatedPerson |
|||
| Slices for extension |
|||
| extension:representationAuthority |
| ||
| extension:ethnicity |
| ||
| Slices for identifier |
| ||
| identifier:CCCD |
| ||
| identifier:HC |
| ||
| active |
| ||
| patient |
| ||
| relationship |
| ||
| name |
| ||
| telecom |
| ||
| address |
| ||
| Documentation for this format | |||
| Path | Status | Usage | ValueSet | Version | Source |
| RelatedPerson.language | Base | preferred | Common Languages | 📍4.0.1 | FHIR Std. |
| RelatedPerson.identifier:CCCD.use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std. |
| RelatedPerson.identifier:CCCD.type | Base | extensible | IdentifierType | 📍4.0.1 | FHIR Std. |
| RelatedPerson.identifier:HC.use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std. |
| RelatedPerson.identifier:HC.type | Base | extensible | IdentifierType | 📍4.0.1 | FHIR Std. |
| RelatedPerson.relationship | Base | extensible | Patient relationship type | 📦4.0.1 | FHIR Std. |
| RelatedPerson.gender | Base | required | AdministrativeGender | 📍4.0.1 | FHIR Std. |
| RelatedPerson.communication.language | Base | preferred | Common Languages | 📍4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| dom-2 | error | RelatedPerson | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | RelatedPerson | 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().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | RelatedPerson | 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 | RelatedPerson | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | RelatedPerson | A resource should have narrative for robust management |
text.`div`.exists()
|
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
hasValue() or (children().count() > id.count())
|
| ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both |
extension.exists() != value.exists()
|
| vn-cccd-format | error | RelatedPerson.identifier:CCCD | Số định danh cá nhân/CCCD, khi có giá trị, phải đúng 12 chữ số (Luật Căn cước 2023, Điều 12) |
value.empty() or value.extension.where(url='http://hl7.org/fhir/StructureDefinition/data-absent-reason').exists() or value.matches('^[0-9]{12}$')
|
| vn-representation-domain-basis | error | RelatedPerson.extension:representationAuthority | Miền quyết định khám chữa bệnh bắt buộc có căn cứ lựa chọn theo Luật KCB Điều 8 khoản 2; miền quyền chủ thể dữ liệu không dùng trục căn cứ đó. The healthcare-decision domain SHALL carry a selectionBasis; the data-subject-rights domain SHALL NOT. |
(extension.where(url='domain').value.ofType(Coding).code = 'healthcare-decision' implies extension.where(url='selectionBasis').exists()) and (extension.where(url='domain').value.ofType(Coding).code = 'data-subject-rights' implies extension.where(url='selectionBasis').empty())
|
| vn-representation-proxy-bounded | error | RelatedPerson.extension:representationAuthority | Thẩm quyền theo uỷ quyền phải có GIỚI HẠN máy-đọc: NGÀY KẾT THÚC (period.end của token hoặc validity.end trong bằng chứng — chỉ có ngày bắt đầu là uỷ quyền vô thời hạn) VÀ phạm vi (scope trong ít nhất một bằng chứng) — Bộ luật Dân sự Điều 138/140/141. A delegated-proxy authority SHALL carry a machine-readable validity bound AND scope. |
extension.where(url='type').value.ofType(Coding).code != 'delegated-proxy' or ((extension.where(url='period').value.ofType(Period).end.exists() or extension.where(url='evidence').extension.where(url='validity').value.ofType(Period).end.exists()) and extension.where(url='evidence').extension.where(url='scope').exists())
|
| vn-representation-proxy-evidence | error | RelatedPerson.extension:representationAuthority | Thẩm quyền theo uỷ quyền phải kèm ít nhất một bằng chứng (văn bản uỷ quyền). A delegated-proxy authority SHALL carry at least one evidence entry. |
extension.where(url='type').value.ofType(Coding).code = 'delegated-proxy' implies extension.where(url='evidence').exists()
|
| vn-representation-type-selection-basis | error | RelatedPerson.extension:representationAuthority | Loại thẩm quyền phải tương thích với nhóm căn cứ lựa chọn tại Luật KCB Điều 8 khoản 2. The authority type SHALL be consistent with the statutory selection basis. |
extension.where(url='selectionBasis').empty() or ((extension.where(url='selectionBasis').value.ofType(Coding).code = 'civil-code-representative') and (extension.where(url='type').value.ofType(Coding).code = 'legal-representative' or extension.where(url='type').value.ofType(Coding).code = 'guardian' or extension.where(url='type').value.ofType(Coding).code = 'delegated-proxy')) or ((extension.where(url='selectionBasis').value.ofType(Coding).code = 'responsible-legal-entity-appointed') and (extension.where(url='type').value.ofType(Coding).code = 'legal-representative' or extension.where(url='type').value.ofType(Coding).code = 'healthcare-agent')) or ((extension.where(url='selectionBasis').value.ofType(Coding).code = 'adult-patient-selected' or extension.where(url='selectionBasis').value.ofType(Coding).code = 'family-selected' or extension.where(url='selectionBasis').value.ofType(Coding).code = 'voluntary-obligation-performer') and extension.where(url='type').value.ofType(Coding).code = 'healthcare-agent')
|
| Name | Kho hồ sơ EMR (Repository) | Ứng dụng người dân (Citizen App) | Nguồn tạo hồ sơ lâm sàng (Document Source) |
|---|---|---|---|
| RelatedPerson |
|||
| Slices for extension |
|||
| extension:representationAuthority |
| ||
| extension:ethnicity |
| ||
| Slices for identifier |
| ||
| identifier:CCCD |
| ||
| identifier:HC |
| ||
| active |
| ||
| patient |
| ||
| relationship |
| ||
| name |
| ||
| telecom |
| ||
| address |
| ||
| Documentation for this format | |||
Summary
Mandatory: 2 elements(6 nested mandatory elements)
Must-Support: 12 elements
Fixed: 1 element
Structures
This structure refers to these other structures:
Extensions
This structure refers to these extensions:
Slices
This structure defines the following Slices:
Biểu diễn khác của hồ sơ: CSV, Excel, Schematron
