HL7 Vietnam VN Core FHIR Implementation Guide

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.6.0 - Draft for Community Review Viet Nam cờ

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Draft for Community Review (v0.6.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Phần mở rộng: Thẩm quyền đại diện truy cập dữ liệu — Representation Authority Extension

URL chính thức: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-representation-authority Phiên bản: 0.6.0
Computable Name: VNCoreExtRepresentationAuthority

Extension ghi nhận THẨM QUYỀN PHÁP LÝ để một người đại diện/giám hộ/được uỷ quyền truy cập dữ liệu y tế thay người khác (vd cha/mẹ xem Sổ SKĐT của con qua VNeID). Mô hình hoá 'token đại diện' phục vụ Policy Decision Point (PDP): loại thẩm quyền, nguồn xác minh, thời điểm xác minh, thời hạn, và lớp dữ liệu BỊ HẠN CHẾ (deny). PDP deny-by-default khi quan hệ mâu thuẫn/hết hạn. Căn cứ: Bộ luật Dân sự 2015 (đại diện/giám hộ/uỷ quyền); Luật Căn cước 2023 (quan hệ nhân thân CSDLQGDC); Luật 91/2025 + Luật Trẻ em 2016 (dữ liệu trẻ em, lớp nhạy cảm).

Context of Use

Usage info

Usages:

You can also check for usages in the FHIR IG Statistics

Các dạng xem hình thức của nội dung phần mở rộng

Mô tả profile, differential, snapshot và các biểu diễn liên quan.

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension Thẩm quyền đại diện truy cập dữ liệu — Representation Authority Extension
... extension 2..* Extension Extension
... Slices for extension Content/Rules for all slices
.... extension:type S 1..1 Extension Loại thẩm quyền (đại diện pháp luật/giám hộ/uỷ quyền/đại diện KCB)
..... extension 0..0 Extension
..... url 1..1 uri "type"
..... value[x] 0..1 Coding Value of extension
Binding: Loại thẩm quyền đại diện — Vietnam Representation Authority Type ValueSet (required)
.... extension:source S 1..1 Extension Nguồn xác minh (CSDLQGDC/Toà án/công chứng/CSYT khai báo)
..... extension 0..0 Extension
..... url 1..1 uri "source"
..... value[x] 0..1 Coding Value of extension
Binding: Nguồn xác minh thẩm quyền đại diện — Vietnam Representation Verification Source ValueSet (required)
.... extension:verifiedDate S 0..1 Extension Thời điểm xác minh quan hệ gần nhất
..... extension 0..0 Extension
..... url 1..1 uri "verifiedDate"
..... value[x] 0..1 dateTime Value of extension
.... extension:period S 0..1 Extension Thời hạn hiệu lực của thẩm quyền (PDP hết hạn → deny)
..... extension 0..0 Extension
..... url 1..1 uri "period"
..... value[x] 0..1 Period Value of extension
.... extension:restrictedSensitivity S 0..* Extension Lớp dữ liệu BỊ HẠN CHẾ với người đại diện (deny) — vd special-protection với vị thành niên
..... extension 0..0 Extension
..... url 1..1 uri "restrictedSensitivity"
..... value[x] 0..1 Coding Value of extension
Binding: Lớp nhạy cảm dữ liệu y tế — Vietnam Health Data Sensitivity Class ValueSet (required)
... url 1..1 uri "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-representation-authority"

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
Extension.extension:type.​value[x] Base required Loại thẩm quyền đại diện — Vietnam Representation Authority Type ValueSet 📦0.6.0 This IG
Extension.extension:source.​value[x] Base required Nguồn xác minh thẩm quyền đại diện — Vietnam Representation Verification Source ValueSet 📦0.6.0 This IG
Extension.extension:restrictedSensitivity.​value[x] Base required Lớp nhạy cảm dữ liệu y tế — Vietnam Health Data Sensitivity Class ValueSet 📦0.6.0 This IG
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension Thẩm quyền đại diện truy cập dữ liệu — Representation Authority Extension
... id 0..1 string Unique id for inter-element referencing
... Slices for extension 2..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:type S 1..1 Extension Loại thẩm quyền (đại diện pháp luật/giám hộ/uỷ quyền/đại diện KCB)
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "type"
..... value[x] 0..1 Coding Value of extension
Binding: Loại thẩm quyền đại diện — Vietnam Representation Authority Type ValueSet (required)
.... extension:source S 1..1 Extension Nguồn xác minh (CSDLQGDC/Toà án/công chứng/CSYT khai báo)
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "source"
..... value[x] 0..1 Coding Value of extension
Binding: Nguồn xác minh thẩm quyền đại diện — Vietnam Representation Verification Source ValueSet (required)
.... extension:verifiedDate S 0..1 Extension Thời điểm xác minh quan hệ gần nhất
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "verifiedDate"
..... value[x] 0..1 dateTime Value of extension
.... extension:period S 0..1 Extension Thời hạn hiệu lực của thẩm quyền (PDP hết hạn → deny)
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "period"
..... value[x] 0..1 Period Value of extension
.... extension:restrictedSensitivity S 0..* Extension Lớp dữ liệu BỊ HẠN CHẾ với người đại diện (deny) — vd special-protection với vị thành niên
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "restrictedSensitivity"
..... value[x] 0..1 Coding Value of extension
Binding: Lớp nhạy cảm dữ liệu y tế — Vietnam Health Data Sensitivity Class ValueSet (required)
... url 1..1 uri "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-representation-authority"

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Extension.extension:type.​value[x] Base required Loại thẩm quyền đại diện — Vietnam Representation Authority Type ValueSet 📦0.6.0 This IG
Extension.extension:source.​value[x] Base required Nguồn xác minh thẩm quyền đại diện — Vietnam Representation Verification Source ValueSet 📦0.6.0 This IG
Extension.extension:restrictedSensitivity.​value[x] Base required Lớp nhạy cảm dữ liệu y tế — Vietnam Health Data Sensitivity Class ValueSet 📦0.6.0 This IG

Constraints

Id Grade Path(s) Description Expression
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()

Summary

Complex Extension: Extension ghi nhận THẨM QUYỀN PHÁP LÝ để một người đại diện/giám hộ/được uỷ quyền truy cập dữ liệu y tế thay người khác (vd cha/mẹ xem Sổ SKĐT của con qua VNeID). Mô hình hoá 'token đại diện' phục vụ Policy Decision Point (PDP): loại thẩm quyền, nguồn xác minh, thời điểm xác minh, thời hạn, và lớp dữ liệu BỊ HẠN CHẾ (deny). PDP deny-by-default khi quan hệ mâu thuẫn/hết hạn. Căn cứ: Bộ luật Dân sự 2015 (đại diện/giám hộ/uỷ quyền); Luật Căn cước 2023 (quan hệ nhân thân CSDLQGDC); Luật 91/2025 + Luật Trẻ em 2016 (dữ liệu trẻ em, lớp nhạy cảm).

  • type: Coding: An Extension
  • source: Coding: An Extension
  • verifiedDate: dateTime: An Extension
  • period: Period: An Extension
  • restrictedSensitivity: Coding: An Extension

Dạng xem DifferentialDifferential View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension Thẩm quyền đại diện truy cập dữ liệu — Representation Authority Extension
... extension 2..* Extension Extension
... Slices for extension Content/Rules for all slices
.... extension:type S 1..1 Extension Loại thẩm quyền (đại diện pháp luật/giám hộ/uỷ quyền/đại diện KCB)
..... extension 0..0 Extension
..... url 1..1 uri "type"
..... value[x] 0..1 Coding Value of extension
Binding: Loại thẩm quyền đại diện — Vietnam Representation Authority Type ValueSet (required)
.... extension:source S 1..1 Extension Nguồn xác minh (CSDLQGDC/Toà án/công chứng/CSYT khai báo)
..... extension 0..0 Extension
..... url 1..1 uri "source"
..... value[x] 0..1 Coding Value of extension
Binding: Nguồn xác minh thẩm quyền đại diện — Vietnam Representation Verification Source ValueSet (required)
.... extension:verifiedDate S 0..1 Extension Thời điểm xác minh quan hệ gần nhất
..... extension 0..0 Extension
..... url 1..1 uri "verifiedDate"
..... value[x] 0..1 dateTime Value of extension
.... extension:period S 0..1 Extension Thời hạn hiệu lực của thẩm quyền (PDP hết hạn → deny)
..... extension 0..0 Extension
..... url 1..1 uri "period"
..... value[x] 0..1 Period Value of extension
.... extension:restrictedSensitivity S 0..* Extension Lớp dữ liệu BỊ HẠN CHẾ với người đại diện (deny) — vd special-protection với vị thành niên
..... extension 0..0 Extension
..... url 1..1 uri "restrictedSensitivity"
..... value[x] 0..1 Coding Value of extension
Binding: Lớp nhạy cảm dữ liệu y tế — Vietnam Health Data Sensitivity Class ValueSet (required)
... url 1..1 uri "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-representation-authority"

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
Extension.extension:type.​value[x] Base required Loại thẩm quyền đại diện — Vietnam Representation Authority Type ValueSet 📦0.6.0 This IG
Extension.extension:source.​value[x] Base required Nguồn xác minh thẩm quyền đại diện — Vietnam Representation Verification Source ValueSet 📦0.6.0 This IG
Extension.extension:restrictedSensitivity.​value[x] Base required Lớp nhạy cảm dữ liệu y tế — Vietnam Health Data Sensitivity Class ValueSet 📦0.6.0 This IG

Dạng xem Snapshot

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension Thẩm quyền đại diện truy cập dữ liệu — Representation Authority Extension
... id 0..1 string Unique id for inter-element referencing
... Slices for extension 2..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:type S 1..1 Extension Loại thẩm quyền (đại diện pháp luật/giám hộ/uỷ quyền/đại diện KCB)
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "type"
..... value[x] 0..1 Coding Value of extension
Binding: Loại thẩm quyền đại diện — Vietnam Representation Authority Type ValueSet (required)
.... extension:source S 1..1 Extension Nguồn xác minh (CSDLQGDC/Toà án/công chứng/CSYT khai báo)
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "source"
..... value[x] 0..1 Coding Value of extension
Binding: Nguồn xác minh thẩm quyền đại diện — Vietnam Representation Verification Source ValueSet (required)
.... extension:verifiedDate S 0..1 Extension Thời điểm xác minh quan hệ gần nhất
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "verifiedDate"
..... value[x] 0..1 dateTime Value of extension
.... extension:period S 0..1 Extension Thời hạn hiệu lực của thẩm quyền (PDP hết hạn → deny)
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "period"
..... value[x] 0..1 Period Value of extension
.... extension:restrictedSensitivity S 0..* Extension Lớp dữ liệu BỊ HẠN CHẾ với người đại diện (deny) — vd special-protection với vị thành niên
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "restrictedSensitivity"
..... value[x] 0..1 Coding Value of extension
Binding: Lớp nhạy cảm dữ liệu y tế — Vietnam Health Data Sensitivity Class ValueSet (required)
... url 1..1 uri "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-representation-authority"

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Extension.extension:type.​value[x] Base required Loại thẩm quyền đại diện — Vietnam Representation Authority Type ValueSet 📦0.6.0 This IG
Extension.extension:source.​value[x] Base required Nguồn xác minh thẩm quyền đại diện — Vietnam Representation Verification Source ValueSet 📦0.6.0 This IG
Extension.extension:restrictedSensitivity.​value[x] Base required Lớp nhạy cảm dữ liệu y tế — Vietnam Health Data Sensitivity Class ValueSet 📦0.6.0 This IG

Constraints

Id Grade Path(s) Description Expression
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()

Summary

Complex Extension: Extension ghi nhận THẨM QUYỀN PHÁP LÝ để một người đại diện/giám hộ/được uỷ quyền truy cập dữ liệu y tế thay người khác (vd cha/mẹ xem Sổ SKĐT của con qua VNeID). Mô hình hoá 'token đại diện' phục vụ Policy Decision Point (PDP): loại thẩm quyền, nguồn xác minh, thời điểm xác minh, thời hạn, và lớp dữ liệu BỊ HẠN CHẾ (deny). PDP deny-by-default khi quan hệ mâu thuẫn/hết hạn. Căn cứ: Bộ luật Dân sự 2015 (đại diện/giám hộ/uỷ quyền); Luật Căn cước 2023 (quan hệ nhân thân CSDLQGDC); Luật 91/2025 + Luật Trẻ em 2016 (dữ liệu trẻ em, lớp nhạy cảm).

  • type: Coding: An Extension
  • source: Coding: An Extension
  • verifiedDate: dateTime: An Extension
  • period: Period: An Extension
  • restrictedSensitivity: Coding: An Extension

 

Biểu diễn khác của hồ sơ: CSV, Excel, Schematron