HL7 Vietnam VN Core FHIR Implementation Guide

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

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

## Phần mở rộng: Cơ quan hướng dẫn chuyên môn — Supervising Clinical Authority Extension

URL chính thức: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-supervising-authority | Phiên bản: 0.5.0 | Làm nổi bật phần thay đổi?
| Computable Name: VNCoreExtSupervisingAuthority

Mở rộng tham chiếu Cơ quan hướng dẫn chuyên môn kỹ thuật của một cơ sở y tế khi cơ quan này khác với đơn vị quản lý hành chính (Organization.partOf). Trường hợp điển hình: Trạm Y tế (TYT) cấp xã — về quản lý hành chính trực thuộc UBND cấp xã (đặt tại Organization.partOf), nhưng về chuyên môn kỹ thuật chịu sự hướng dẫn, kiểm tra của Sở Y tế cấp tỉnh (đặt tại extension này). Tách biệt 2 chiều quản lý này phản ánh đúng mô hình chính quyền 2 cấp sau Luật 72/2025/QH15 và VBHN 06/2026/VBHN-BYT (hợp nhất TT 43/2025 + TT 53/2025 về Trạm Y tế xã/phường). Căn cứ:

- Luật 72/2025/QH15 — 16/6/2025 — Luật Tổ chức chính quyền địa phương (hiệu lực 01/7/2025)
- VBHN 06/2026/VBHN-BYT — 01/2026 — hợp nhất TT 43/2025 + TT 53/2025 về tổ chức và hoạt động của Trạm Y tế xã/phường/đặc khu.

Context of Use

This extension may be used on the following element(s)

- Element ID: `Organization`

Usage info

Usages:

- Use this Extension: Cơ sở y tế VN Core — VN Core Organization Profile

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.

- Bảng Differential
- Bảng Snapshot
- Thống kê/Tham chiếu
- Tất cả

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Cơ quan hướng dẫn chuyên môn — Supervising Clinical Authority Extension
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-supervising-authority"
value[x] |  | 0..1 | Reference(Cơ sở y tế VN Core — VN Core Organization Profile | Organization) | Cơ quan hướng dẫn chuyên môn
Documentation for this format

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Cơ quan hướng dẫn chuyên môn — Supervising Clinical Authority Extension
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  | Extension Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-supervising-authority"
value[x] |  | 0..1 | Reference(Cơ sở y tế VN Core — VN Core Organization Profile | Organization) | Cơ quan hướng dẫn chuyên môn
Documentation for this format

#### 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

Simple Extension with the type Reference: Mở rộng tham chiếu Cơ quan hướng dẫn chuyên môn kỹ thuật của một cơ sở y tế khi cơ quan này khác với đơn vị quản lý hành chính (Organization.partOf). Trường hợp điển hình: Trạm Y tế (TYT) cấp xã — về quản lý hành chính trực thuộc UBND cấp xã (đặt tại Organization.partOf), nhưng về chuyên môn kỹ thuật chịu sự hướng dẫn, kiểm tra của Sở Y tế cấp tỉnh (đặt tại extension này). Tách biệt 2 chiều quản lý này phản ánh đúng mô hình chính quyền 2 cấp sau Luật 72/2025/QH15 và VBHN 06/2026/VBHN-BYT (hợp nhất TT 43/2025 + TT 53/2025 về Trạm Y tế xã/phường). Căn cứ:

- Luật 72/2025/QH15 — 16/6/2025 — Luật Tổ chức chính quyền địa phương (hiệu lực 01/7/2025)
- VBHN 06/2026/VBHN-BYT — 01/2026 — hợp nhất TT 43/2025 + TT 53/2025 về tổ chức và hoạt động của Trạm Y tế xã/phường/đặc khu.

Dạng xem DifferentialDifferential View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Cơ quan hướng dẫn chuyên môn — Supervising Clinical Authority Extension
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-supervising-authority"
value[x] |  | 0..1 | Reference(Cơ sở y tế VN Core — VN Core Organization Profile | Organization) | Cơ quan hướng dẫn chuyên môn
Documentation for this format

Dạng xem Snapshot

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Cơ quan hướng dẫn chuyên môn — Supervising Clinical Authority Extension
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  | Extension Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-supervising-authority"
value[x] |  | 0..1 | Reference(Cơ sở y tế VN Core — VN Core Organization Profile | Organization) | Cơ quan hướng dẫn chuyên môn
Documentation for this format

#### 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

Simple Extension with the type Reference: Mở rộng tham chiếu Cơ quan hướng dẫn chuyên môn kỹ thuật của một cơ sở y tế khi cơ quan này khác với đơn vị quản lý hành chính (Organization.partOf). Trường hợp điển hình: Trạm Y tế (TYT) cấp xã — về quản lý hành chính trực thuộc UBND cấp xã (đặt tại Organization.partOf), nhưng về chuyên môn kỹ thuật chịu sự hướng dẫn, kiểm tra của Sở Y tế cấp tỉnh (đặt tại extension này). Tách biệt 2 chiều quản lý này phản ánh đúng mô hình chính quyền 2 cấp sau Luật 72/2025/QH15 và VBHN 06/2026/VBHN-BYT (hợp nhất TT 43/2025 + TT 53/2025 về Trạm Y tế xã/phường). Căn cứ:

- Luật 72/2025/QH15 — 16/6/2025 — Luật Tổ chức chính quyền địa phương (hiệu lực 01/7/2025)
- VBHN 06/2026/VBHN-BYT — 01/2026 — hợp nhất TT 43/2025 + TT 53/2025 về tổ chức và hoạt động của Trạm Y tế xã/phường/đặc khu.

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