Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.8.0 - Draft for Community Review
Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Draft for Community Review (v0.8.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-ext-province | Phiên bản: 0.8.0 | ||||
| Computable Name: VNCoreExtProvince | |||||
| Định danh khác: OID:2.25.161089673617632664299011809196868855799.42.130 | |||||
Mở rộng ghi nhận mã tỉnh/thành phố theo QĐ 19/2025/QĐ-TTg trên Address. FHIR Address.state chỉ là text — extension này bổ sung mã hóa (Coding) để tra cứu chính xác. Kỷ nguyên: bản ghi MỚI dùng vn-province-cs (34 mã, business version 20250701); địa chỉ tồn đọng ghi trước 01/07/2025 dùng vn-province-legacy-cs (63 mã) — binding extensible nên cả hai hợp lệ, hệ thống phân biệt kỷ nguyên qua Coding.system (hai canonical khác nhau, ADR-0017 Điều 6). Chuyển đổi: ConceptMap vn-cm-province-legacy-to-new. 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)
Address
Usage info
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:   |
|---|---|---|---|---|
  Extension |
0..* | Extension | Tỉnh/Thành phố (mã hóa) — Vietnam Province Extension | |
  extension |
0..0 | Extension | ||
| url |
1..1 | uri | "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-province" | |
  value[x] |
1..1 | Coding | Mã tỉnh/thành phố Binding: Danh mục Tỉnh/Thành phố Việt Nam (active) — Vietnam Province ValueSet (extensible) | |
| Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| Extension.value[x] | Base | extensible | Danh mục Tỉnh/Thành phố Việt Nam (active) — Vietnam Province ValueSet | 📦0.8.0 | This IG |
| Name | Flags | Card. | Type | Description & Constraints Filter: |
|---|---|---|---|---|
 Extension |
0..* | Extension | Tỉnh/Thành phố (mã hóa) — Vietnam Province 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-province" | |
| value[x] |
1..1 | Coding | Mã tỉnh/thành phố Binding: Danh mục Tỉnh/Thành phố Việt Nam (active) — Vietnam Province ValueSet (extensible) | |
| Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| Extension.value[x] | Base | extensible | Danh mục Tỉnh/Thành phố Việt Nam (active) — Vietnam Province ValueSet | 📦0.8.0 | This IG |
| 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ã tỉnh/thành phố theo QĐ 19/2025/QĐ-TTg trên Address. FHIR Address.state chỉ là text — extension này bổ sung mã hóa (Coding) để tra cứu chính xác. Kỷ nguyên: bản ghi MỚI dùng vn-province-cs (34 mã, business version 20250701); địa chỉ tồn đọng ghi trước 01/07/2025 dùng vn-province-legacy-cs (63 mã) — binding extensible nên cả hai hợp lệ, hệ thống phân biệt kỷ nguyên qua Coding.system (hai canonical khác nhau, ADR-0017 Điều 6). Chuyển đổi: ConceptMap vn-cm-province-legacy-to-new. Căn cứ: NQ 202/2025/QH15, QĐ 19/2025/QĐ-TTg.
Dạng xem DifferentialDifferential View
| Name | Flags | Card. | Type | Description & Constraints Filter: |
|---|---|---|---|---|
| Extension |
0..* | Extension | Tỉnh/Thành phố (mã hóa) — Vietnam Province Extension | |
| extension |
0..0 | Extension | ||
| url |
1..1 | uri | "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-province" | |
| value[x] |
1..1 | Coding | Mã tỉnh/thành phố Binding: Danh mục Tỉnh/Thành phố Việt Nam (active) — Vietnam Province ValueSet (extensible) | |
| Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| Extension.value[x] | Base | extensible | Danh mục Tỉnh/Thành phố Việt Nam (active) — Vietnam Province ValueSet | 📦0.8.0 | This IG |
Dạng xem Snapshot
| Name | Flags | Card. | Type | Description & Constraints Filter: |
|---|---|---|---|---|
| Extension |
0..* | Extension | Tỉnh/Thành phố (mã hóa) — Vietnam Province 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-province" | |
| value[x] |
1..1 | Coding | Mã tỉnh/thành phố Binding: Danh mục Tỉnh/Thành phố Việt Nam (active) — Vietnam Province ValueSet (extensible) | |
| Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| Extension.value[x] | Base | extensible | Danh mục Tỉnh/Thành phố Việt Nam (active) — Vietnam Province ValueSet | 📦0.8.0 | This IG |
| 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ã tỉnh/thành phố theo QĐ 19/2025/QĐ-TTg trên Address. FHIR Address.state chỉ là text — extension này bổ sung mã hóa (Coding) để tra cứu chính xác. Kỷ nguyên: bản ghi MỚI dùng vn-province-cs (34 mã, business version 20250701); địa chỉ tồn đọng ghi trước 01/07/2025 dùng vn-province-legacy-cs (63 mã) — binding extensible nên cả hai hợp lệ, hệ thống phân biệt kỷ nguyên qua Coding.system (hai canonical khác nhau, ADR-0017 Điều 6). Chuyển đổi: ConceptMap vn-cm-province-legacy-to-new. 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