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: Loại đơn vị cấp xã (xã/phường/đặc khu) — Vietnam Ward Type Extension

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

Mở rộng phân loại đơn vị hành chính cấp xã trên Address: xã (nông thôn), phường (đô thị), hoặc đặc khu (hải đảo). FHIR Address không có khái niệm phân loại đơn vị cấp xã — extension này bổ sung để phản ánh mô hình chính quyền 2 cấp. Dùng kèm với vn-ext-ward (mã xã/phường) để biểu diễn đầy đủ cấp xã. Căn cứ: Luật 72/2025/QH15 (16/6/2025, hiệu lực 01/7/2025) — Luật Tổ chức chính quyền địa phương; NQ 202/2025/QH15.

Context of Use

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

- Element ID: `Address`

Usage info

Usages:

- This Extension is not used by any profiles in this Implementation Guide

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 | Loại đơn vị cấp xã (xã/phường/đặc khu) — Vietnam Ward Type Extension
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ward-type"
value[x] |  | 0..1 | Coding | Loại đơn vị cấp xã Binding: Loại đơn vị cấp xã — Vietnam Ward Type ValueSet (required)
Documentation for this format

#### Terminology Bindings (Differential)

Path | Status | Usage | ValueSet | Version | Source
Extension.value[x] | Base | required | Loại đơn vị cấp xã — Vietnam Ward Type ValueSet | 📦0.5.0 | This IG

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Loại đơn vị cấp xã (xã/phường/đặc khu) — Vietnam Ward Type 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-ward-type"
value[x] |  | 0..1 | Coding | Loại đơn vị cấp xã Binding: Loại đơn vị cấp xã — Vietnam Ward Type ValueSet (required)
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Extension.value[x] | Base | required | Loại đơn vị cấp xã — Vietnam Ward Type ValueSet | 📦0.5.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

Simple Extension with the type Coding: Mở rộng phân loại đơn vị hành chính cấp xã trên Address: xã (nông thôn), phường (đô thị), hoặc đặc khu (hải đảo). FHIR Address không có khái niệm phân loại đơn vị cấp xã — extension này bổ sung để phản ánh mô hình chính quyền 2 cấp. Dùng kèm với vn-ext-ward (mã xã/phường) để biểu diễn đầy đủ cấp xã. Căn cứ: Luật 72/2025/QH15 (16/6/2025, hiệu lực 01/7/2025) — Luật Tổ chức chính quyền địa phương; NQ 202/2025/QH15.

Dạng xem DifferentialDifferential View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Loại đơn vị cấp xã (xã/phường/đặc khu) — Vietnam Ward Type Extension
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ward-type"
value[x] |  | 0..1 | Coding | Loại đơn vị cấp xã Binding: Loại đơn vị cấp xã — Vietnam Ward Type ValueSet (required)
Documentation for this format

#### Terminology Bindings (Differential)

Path | Status | Usage | ValueSet | Version | Source
Extension.value[x] | Base | required | Loại đơn vị cấp xã — Vietnam Ward Type ValueSet | 📦0.5.0 | This IG

Dạng xem Snapshot

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Loại đơn vị cấp xã (xã/phường/đặc khu) — Vietnam Ward Type 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-ward-type"
value[x] |  | 0..1 | Coding | Loại đơn vị cấp xã Binding: Loại đơn vị cấp xã — Vietnam Ward Type ValueSet (required)
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Extension.value[x] | Base | required | Loại đơn vị cấp xã — Vietnam Ward Type ValueSet | 📦0.5.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

Simple Extension with the type Coding: Mở rộng phân loại đơn vị hành chính cấp xã trên Address: xã (nông thôn), phường (đô thị), hoặc đặc khu (hải đảo). FHIR Address không có khái niệm phân loại đơn vị cấp xã — extension này bổ sung để phản ánh mô hình chính quyền 2 cấp. Dùng kèm với vn-ext-ward (mã xã/phường) để biểu diễn đầy đủ cấp xã. Căn cứ: Luật 72/2025/QH15 (16/6/2025, hiệu lực 01/7/2025) — Luật Tổ chức chính quyền địa phương; NQ 202/2025/QH15.

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