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 - Draft for Community Review (v0.5.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| Draft tại thời điểm 2026-04-27 |
<ConceptMap xmlns="http://hl7.org/fhir">
<id value="vn-cm-province-legacy-to-new"/>
<language value="vi"/>
<text>
<status value="generated"/>
<div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: ConceptMap vn-cm-province-legacy-to-new</b></p><a name="vn-cm-province-legacy-to-new"> </a><a name="hcvn-cm-province-legacy-to-new"> </a><p>Mapping from (not specified) to (not specified)</p><br/><p><b>Group 1 </b>Mapping from <a href="CodeSystem-vn-province-cs.html">Danh mục Tỉnh/Thành phố Việt Nam — Vietnam Province CodeSystem</a> to <a href="CodeSystem-vn-province-cs.html">Danh mục Tỉnh/Thành phố Việt Nam — Vietnam Province CodeSystem</a></p><table class="grid"><tr><td><b>Source Code</b></td><td><b>Relationship</b></td><td><b>Target Code</b></td><td><b>Comment</b></td></tr><tr><td>01 (Thành phố Hà Nội)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>01 (Thành phố Hà Nội)</td><td/></tr><tr><td>04 (Tỉnh Cao Bằng)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>04 (Tỉnh Cao Bằng)</td><td/></tr><tr><td>11 (Tỉnh Điện Biên)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>11 (Tỉnh Điện Biên)</td><td/></tr><tr><td>12 (Tỉnh Lai Châu)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>12 (Tỉnh Lai Châu)</td><td/></tr><tr><td>14 (Tỉnh Sơn La)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>14 (Tỉnh Sơn La)</td><td/></tr><tr><td>20 (Tỉnh Lạng Sơn)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>20 (Tỉnh Lạng Sơn)</td><td/></tr><tr><td>22 (Tỉnh Quảng Ninh)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>22 (Tỉnh Quảng Ninh)</td><td/></tr><tr><td>38 (Tỉnh Thanh Hóa)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>38 (Tỉnh Thanh Hóa)</td><td/></tr><tr><td>40 (Tỉnh Nghệ An)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>40 (Tỉnh Nghệ An)</td><td/></tr><tr><td>42 (Tỉnh Hà Tĩnh)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>42 (Tỉnh Hà Tĩnh)</td><td/></tr><tr><td>46 (Thành phố Huế)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>46 (Thành phố Huế)</td><td/></tr><tr><td>79 (Thành phố Hồ Chí Minh)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#narrower" title="narrower">narrower</a></td><td>79 (Thành phố Hồ Chí Minh)</td><td>TP HCM mới = TP HCM cũ + Bà Rịa Vũng Tàu (#77) + Bình Dương (#74)</td></tr><tr><td>77 (Tỉnh Bà Rịa - Vũng Tàu (inactive))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#narrower" title="narrower">narrower</a></td><td>79 (Thành phố Hồ Chí Minh)</td><td>Sáp nhập vào TP HCM mới theo NQ 202/2025</td></tr><tr><td>74 (Tỉnh Bình Dương (inactive))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#narrower" title="narrower">narrower</a></td><td>79 (Thành phố Hồ Chí Minh)</td><td>Sáp nhập vào TP HCM mới theo NQ 202/2025</td></tr><tr><td>31 (Thành phố Hải Phòng)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#narrower" title="narrower">narrower</a></td><td>31 (Thành phố Hải Phòng)</td><td>TP Hải Phòng mới = HP cũ + Hải Dương (#30)</td></tr><tr><td>30 (Tỉnh Hải Dương (inactive))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#narrower" title="narrower">narrower</a></td><td>31 (Thành phố Hải Phòng)</td><td>Sáp nhập vào Hải Phòng mới theo NQ 202/2025</td></tr><tr><td>48 (Thành phố Đà Nẵng)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#narrower" title="narrower">narrower</a></td><td>48 (Thành phố Đà Nẵng)</td><td>TP Đà Nẵng mới = ĐN cũ + Quảng Nam (#49)</td></tr><tr><td>49 (Tỉnh Quảng Nam (inactive))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#narrower" title="narrower">narrower</a></td><td>48 (Thành phố Đà Nẵng)</td><td>Sáp nhập vào Đà Nẵng mới theo NQ 202/2025</td></tr><tr><td>92 (Thành phố Cần Thơ)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#narrower" title="narrower">narrower</a></td><td>92 (Thành phố Cần Thơ)</td><td>TP Cần Thơ mới = CT cũ + Hậu Giang (#93) + Sóc Trăng (#94)</td></tr><tr><td>93 (Tỉnh Hậu Giang (inactive))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#narrower" title="narrower">narrower</a></td><td>92 (Thành phố Cần Thơ)</td><td>Sáp nhập vào Cần Thơ mới theo NQ 202/2025</td></tr><tr><td>94 (Tỉnh Sóc Trăng (inactive))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#narrower" title="narrower">narrower</a></td><td>92 (Thành phố Cần Thơ)</td><td>Sáp nhập vào Cần Thơ mới theo NQ 202/2025</td></tr></table></div>
</text>
<url
value="http://fhir.hl7.org.vn/core/ConceptMap/vn-cm-province-legacy-to-new"/>
<version value="0.5.0"/>
<name value="VNCMProvinceLegacyToNew"/>
<title
value="Mapping 63 → 34 tỉnh/thành (NQ 202/2025) — VN Province Legacy-to-New ConceptMap"/>
<status value="draft"/>
<experimental value="true"/>
<date value="2026-04-27"/>
<publisher value="Omi HealthTech / VN Core FHIR Community Initiative"/>
<contact>
<name value="Omi HealthTech / VN Core FHIR Community Initiative"/>
<telecom>
<system value="url"/>
<value value="https://hl7.org.vn"/>
</telecom>
<telecom>
<system value="email"/>
<value value="[email protected]"/>
</telecom>
</contact>
<contact>
<name value="Omi HealthTech (OmiGroup)"/>
<telecom>
<system value="url"/>
<value value="https://omihealthtech.vn"/>
</telecom>
<telecom>
<system value="url"/>
<value value="https://omigroup.vn"/>
</telecom>
<telecom>
<system value="email"/>
<value value="[email protected]"/>
</telecom>
</contact>
<description
value="ConceptMap NON-AUTHORITATIVE DRAFT chuyển đổi 63 mã tỉnh/thành cũ (trước 01/07/2025) sang 34 mã tỉnh/thành mới theo:
- **NQ 202/2025/QH15** (Sắp xếp đơn vị hành chính cấp tỉnh) — hiệu lực 01/07/2025
- **QĐ 19/2025/QĐ-TTg** (Bảng danh mục và mã số ĐVHC) — Phụ lục I 34 tỉnh
Các trường hợp trong mapping:
- `equivalent`: 11 tỉnh/TP giữ nguyên (mã cũ = mã mới)
- `narrower`: tỉnh cũ thuộc nhóm sáp nhập, mã cũ nhỏ hơn (specific) so với tỉnh mới (broader)
- `disjoint`: trường hợp không xác định được mapping (nếu có)
**Cảnh báo**: TCTK và Bộ Nội vụ chưa publish ConceptMap chính thức 63→34. Bản này là draft research-based, dùng cho:
- Tham chiếu data legacy khi convert sang ĐVHC mới
- Backward compatibility cho dữ liệu BHYT trước 01/07/2025
- KHÔNG dùng cho thanh toán BHYT chính thức trước khi BHXH/Bộ Y tế xác nhận."/>
<jurisdiction>
<coding>
<system value="urn:iso:std:iso:3166"/>
<code value="VN"/>
<display value="Viet Nam"/>
</coding>
</jurisdiction>
<purpose
value="Hỗ trợ chuyển đổi data legacy từ 63 mã tỉnh cũ (trước 01/07/2025) sang 34 mã tỉnh mới sau sắp xếp ĐVHC theo NQ 202/2025."/>
<copyright
value="Bảng mapping research-based từ QĐ 19/2025/QĐ-TTg Phụ lục I (Thủ tướng Chính phủ ban hành 25/06/2025) và xaydungchinhsach.chinhphu.vn. Status: non-authoritative draft."/>
<group>
<source value="http://fhir.hl7.org.vn/core/CodeSystem/vn-province-cs"/>
<target value="http://fhir.hl7.org.vn/core/CodeSystem/vn-province-cs"/>
<element>
<code value="01"/>
<display value="Thành phố Hà Nội"/>
<target>
<code value="01"/>
<display value="Thành phố Hà Nội"/>
<equivalence value="equivalent"/>
</target>
</element>
<element>
<code value="04"/>
<display value="Tỉnh Cao Bằng"/>
<target>
<code value="04"/>
<display value="Tỉnh Cao Bằng"/>
<equivalence value="equivalent"/>
</target>
</element>
<element>
<code value="11"/>
<display value="Tỉnh Điện Biên"/>
<target>
<code value="11"/>
<display value="Tỉnh Điện Biên"/>
<equivalence value="equivalent"/>
</target>
</element>
<element>
<code value="12"/>
<display value="Tỉnh Lai Châu"/>
<target>
<code value="12"/>
<display value="Tỉnh Lai Châu"/>
<equivalence value="equivalent"/>
</target>
</element>
<element>
<code value="14"/>
<display value="Tỉnh Sơn La"/>
<target>
<code value="14"/>
<display value="Tỉnh Sơn La"/>
<equivalence value="equivalent"/>
</target>
</element>
<element>
<code value="20"/>
<display value="Tỉnh Lạng Sơn"/>
<target>
<code value="20"/>
<display value="Tỉnh Lạng Sơn"/>
<equivalence value="equivalent"/>
</target>
</element>
<element>
<code value="22"/>
<display value="Tỉnh Quảng Ninh"/>
<target>
<code value="22"/>
<display value="Tỉnh Quảng Ninh"/>
<equivalence value="equivalent"/>
</target>
</element>
<element>
<code value="38"/>
<display value="Tỉnh Thanh Hóa"/>
<target>
<code value="38"/>
<display value="Tỉnh Thanh Hóa"/>
<equivalence value="equivalent"/>
</target>
</element>
<element>
<code value="40"/>
<display value="Tỉnh Nghệ An"/>
<target>
<code value="40"/>
<display value="Tỉnh Nghệ An"/>
<equivalence value="equivalent"/>
</target>
</element>
<element>
<code value="42"/>
<display value="Tỉnh Hà Tĩnh"/>
<target>
<code value="42"/>
<display value="Tỉnh Hà Tĩnh"/>
<equivalence value="equivalent"/>
</target>
</element>
<element>
<code value="46"/>
<display value="Thành phố Huế"/>
<target>
<code value="46"/>
<display value="Thành phố Huế"/>
<equivalence value="equivalent"/>
</target>
</element>
<element>
<code value="79"/>
<display value="Thành phố Hồ Chí Minh"/>
<target>
<code value="79"/>
<display value="Thành phố Hồ Chí Minh"/>
<equivalence value="narrower"/>
<comment
value="TP HCM mới = TP HCM cũ + Bà Rịa Vũng Tàu (#77) + Bình Dương (#74)"/>
</target>
</element>
<element>
<code value="77"/>
<display value="Tỉnh Bà Rịa - Vũng Tàu (inactive)"/>
<target>
<code value="79"/>
<display value="Thành phố Hồ Chí Minh"/>
<equivalence value="narrower"/>
<comment value="Sáp nhập vào TP HCM mới theo NQ 202/2025"/>
</target>
</element>
<element>
<code value="74"/>
<display value="Tỉnh Bình Dương (inactive)"/>
<target>
<code value="79"/>
<display value="Thành phố Hồ Chí Minh"/>
<equivalence value="narrower"/>
<comment value="Sáp nhập vào TP HCM mới theo NQ 202/2025"/>
</target>
</element>
<element>
<code value="31"/>
<display value="Thành phố Hải Phòng"/>
<target>
<code value="31"/>
<display value="Thành phố Hải Phòng"/>
<equivalence value="narrower"/>
<comment value="TP Hải Phòng mới = HP cũ + Hải Dương (#30)"/>
</target>
</element>
<element>
<code value="30"/>
<display value="Tỉnh Hải Dương (inactive)"/>
<target>
<code value="31"/>
<display value="Thành phố Hải Phòng"/>
<equivalence value="narrower"/>
<comment value="Sáp nhập vào Hải Phòng mới theo NQ 202/2025"/>
</target>
</element>
<element>
<code value="48"/>
<display value="Thành phố Đà Nẵng"/>
<target>
<code value="48"/>
<display value="Thành phố Đà Nẵng"/>
<equivalence value="narrower"/>
<comment value="TP Đà Nẵng mới = ĐN cũ + Quảng Nam (#49)"/>
</target>
</element>
<element>
<code value="49"/>
<display value="Tỉnh Quảng Nam (inactive)"/>
<target>
<code value="48"/>
<display value="Thành phố Đà Nẵng"/>
<equivalence value="narrower"/>
<comment value="Sáp nhập vào Đà Nẵng mới theo NQ 202/2025"/>
</target>
</element>
<element>
<code value="92"/>
<display value="Thành phố Cần Thơ"/>
<target>
<code value="92"/>
<display value="Thành phố Cần Thơ"/>
<equivalence value="narrower"/>
<comment
value="TP Cần Thơ mới = CT cũ + Hậu Giang (#93) + Sóc Trăng (#94)"/>
</target>
</element>
<element>
<code value="93"/>
<display value="Tỉnh Hậu Giang (inactive)"/>
<target>
<code value="92"/>
<display value="Thành phố Cần Thơ"/>
<equivalence value="narrower"/>
<comment value="Sáp nhập vào Cần Thơ mới theo NQ 202/2025"/>
</target>
</element>
<element>
<code value="94"/>
<display value="Tỉnh Sóc Trăng (inactive)"/>
<target>
<code value="92"/>
<display value="Thành phố Cần Thơ"/>
<equivalence value="narrower"/>
<comment value="Sáp nhập vào Cần Thơ mới theo NQ 202/2025"/>
</target>
</element>
</group>
</ConceptMap>