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: Xã/Phường (mã hóa) — Vietnam Ward/Commune Extension

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

Mở rộng ghi nhận mã xã/phường/thị trấn theo QĐ 19/2025/QĐ-TTg trên Address. FHIR Address không có trường cho cấp xã (ward/commune) — extension này bổ sung. Mã 5 chữ số (00001–99999) theo danh mục 3.321 đơn vị cấp xã. Căn cứ: NQ 202/2025/QH15, QĐ 19/2025/QĐ-TTg.

Context of Use

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

- Element ID: `Address`

Usage info

Usages:

- Use this Extension: Địa chỉ VN Core — VN Core Address Profile
- Examples for this Extension: Bundle/ExampleBHYTSubmissionDeathCertificate, Bundle/ExampleBHYTSubmissionEmergencyUnknownIdentity, Bundle/ExampleBHYTSubmissionHIV, Bundle/ExampleBHYTSubmissionInpatient... Show 25 more, Bundle/ExampleBHYTSubmissionMissingMaLK, Bundle/ExampleBHYTSubmissionMultiCoverage, Bundle/ExampleBHYTSubmissionNewborn, Bundle/ExampleBHYTSubmissionOutpatient, Bundle/ExampleBHYTSubmissionRecurrentWound, Bundle/ExampleBHYTSubmissionYHCT, Bundle/ExampleBundleEPrescription, Bundle/ExampleBundleInpatientDischarge, Bundle/ExampleBundleLabOrderResult, Bundle/ExampleBundleOutpatientBHYT, Bundle/ExampleBundleReferralUpward, Bundle/ExampleBundleYHCTFullVisit, Khoa Tim mạch, Khu khám ngoại trú, Bệnh viện Chợ Rẫy, Bệnh viện Đa khoa Gia Lâm, Trung tâm Kiểm soát bệnh tật tỉnh Quảng Ninh, Phòng khám đa khoa Hoàng Long, Trung tâm Y tế khu vực An Phú, Trạm Y tế phường Ngọc Hà, Patient/ExampleAddressFull, Patient/ExamplePatientChildDependent, Patient/ExamplePatientForeignPassport, Patient/ExamplePatientNguyenVanAn and RelatedPerson/ExampleRelatedPersonMother

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 | Xã/Phường (mã hóa) — Vietnam Ward/Commune Extension
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ward"
value[x] |  | 0..1 | Coding | Mã xã/phường Binding: Danh mục Xã/Phường Việt Nam — Vietnam Ward/Commune ValueSet (extensible)
Documentation for this format

#### Terminology Bindings (Differential)

Path | Status | Usage | ValueSet | Version | Source
Extension.value[x] | Base | extensible | Danh mục Xã/Phường Việt Nam — Vietnam Ward/Commune ValueSet | 📦0.5.0 | This IG

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Xã/Phường (mã hóa) — Vietnam Ward/Commune 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"
value[x] |  | 0..1 | Coding | Mã xã/phường Binding: Danh mục Xã/Phường Việt Nam — Vietnam Ward/Commune ValueSet (extensible)
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Extension.value[x] | Base | extensible | Danh mục Xã/Phường Việt Nam — Vietnam Ward/Commune 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 ghi nhận mã xã/phường/thị trấn theo QĐ 19/2025/QĐ-TTg trên Address. FHIR Address không có trường cho cấp xã (ward/commune) — extension này bổ sung. Mã 5 chữ số (00001–99999) theo danh mục 3.321 đơn vị cấp xã. Căn cứ: NQ 202/2025/QH15, QĐ 19/2025/QĐ-TTg.

Dạng xem DifferentialDifferential View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Xã/Phường (mã hóa) — Vietnam Ward/Commune Extension
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ward"
value[x] |  | 0..1 | Coding | Mã xã/phường Binding: Danh mục Xã/Phường Việt Nam — Vietnam Ward/Commune ValueSet (extensible)
Documentation for this format

#### Terminology Bindings (Differential)

Path | Status | Usage | ValueSet | Version | Source
Extension.value[x] | Base | extensible | Danh mục Xã/Phường Việt Nam — Vietnam Ward/Commune ValueSet | 📦0.5.0 | This IG

Dạng xem Snapshot

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Xã/Phường (mã hóa) — Vietnam Ward/Commune 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"
value[x] |  | 0..1 | Coding | Mã xã/phường Binding: Danh mục Xã/Phường Việt Nam — Vietnam Ward/Commune ValueSet (extensible)
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Extension.value[x] | Base | extensible | Danh mục Xã/Phường Việt Nam — Vietnam Ward/Commune 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 ghi nhận mã xã/phường/thị trấn theo QĐ 19/2025/QĐ-TTg trên Address. FHIR Address không có trường cho cấp xã (ward/commune) — extension này bổ sung. Mã 5 chữ số (00001–99999) theo danh mục 3.321 đơn vị cấp xã. Căn cứ: NQ 202/2025/QH15, QĐ 19/2025/QĐ-TTg.

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