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 |
{
"resourceType" : "ConceptMap",
"id" : "vn-cm-province-legacy-to-new",
"language" : "vi",
"text" : {
"status" : "generated",
"div" : "<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>"
},
"url" : "http://fhir.hl7.org.vn/core/ConceptMap/vn-cm-province-legacy-to-new",
"version" : "0.5.0",
"name" : "VNCMProvinceLegacyToNew",
"title" : "Mapping 63 → 34 tỉnh/thành (NQ 202/2025) — VN Province Legacy-to-New ConceptMap",
"status" : "draft",
"experimental" : true,
"date" : "2026-04-27",
"publisher" : "Omi HealthTech / VN Core FHIR Community Initiative",
"contact" : [
{
"name" : "Omi HealthTech / VN Core FHIR Community Initiative",
"telecom" : [
{
"system" : "url",
"value" : "https://hl7.org.vn"
},
{
"system" : "email",
"value" : "[email protected]"
}
]
},
{
"name" : "Omi HealthTech (OmiGroup)",
"telecom" : [
{
"system" : "url",
"value" : "https://omihealthtech.vn"
},
{
"system" : "url",
"value" : "https://omigroup.vn"
},
{
"system" : "email",
"value" : "[email protected]"
}
]
}
],
"description" : "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:\n- **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\n- **QĐ 19/2025/QĐ-TTg** (Bảng danh mục và mã số ĐVHC) — Phụ lục I 34 tỉnh\n\nCác trường hợp trong mapping:\n- `equivalent`: 11 tỉnh/TP giữ nguyên (mã cũ = mã mới)\n- `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)\n- `disjoint`: trường hợp không xác định được mapping (nếu có)\n\n**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:\n- Tham chiếu data legacy khi convert sang ĐVHC mới\n- Backward compatibility cho dữ liệu BHYT trước 01/07/2025\n- 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" : "urn:iso:std:iso:3166",
"code" : "VN",
"display" : "Viet Nam"
}
]
}
],
"purpose" : "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" : "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" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-province-cs",
"target" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-province-cs",
"element" : [
{
"code" : "01",
"display" : "Thành phố Hà Nội",
"target" : [
{
"code" : "01",
"display" : "Thành phố Hà Nội",
"equivalence" : "equivalent"
}
]
},
{
"code" : "04",
"display" : "Tỉnh Cao Bằng",
"target" : [
{
"code" : "04",
"display" : "Tỉnh Cao Bằng",
"equivalence" : "equivalent"
}
]
},
{
"code" : "11",
"display" : "Tỉnh Điện Biên",
"target" : [
{
"code" : "11",
"display" : "Tỉnh Điện Biên",
"equivalence" : "equivalent"
}
]
},
{
"code" : "12",
"display" : "Tỉnh Lai Châu",
"target" : [
{
"code" : "12",
"display" : "Tỉnh Lai Châu",
"equivalence" : "equivalent"
}
]
},
{
"code" : "14",
"display" : "Tỉnh Sơn La",
"target" : [
{
"code" : "14",
"display" : "Tỉnh Sơn La",
"equivalence" : "equivalent"
}
]
},
{
"code" : "20",
"display" : "Tỉnh Lạng Sơn",
"target" : [
{
"code" : "20",
"display" : "Tỉnh Lạng Sơn",
"equivalence" : "equivalent"
}
]
},
{
"code" : "22",
"display" : "Tỉnh Quảng Ninh",
"target" : [
{
"code" : "22",
"display" : "Tỉnh Quảng Ninh",
"equivalence" : "equivalent"
}
]
},
{
"code" : "38",
"display" : "Tỉnh Thanh Hóa",
"target" : [
{
"code" : "38",
"display" : "Tỉnh Thanh Hóa",
"equivalence" : "equivalent"
}
]
},
{
"code" : "40",
"display" : "Tỉnh Nghệ An",
"target" : [
{
"code" : "40",
"display" : "Tỉnh Nghệ An",
"equivalence" : "equivalent"
}
]
},
{
"code" : "42",
"display" : "Tỉnh Hà Tĩnh",
"target" : [
{
"code" : "42",
"display" : "Tỉnh Hà Tĩnh",
"equivalence" : "equivalent"
}
]
},
{
"code" : "46",
"display" : "Thành phố Huế",
"target" : [
{
"code" : "46",
"display" : "Thành phố Huế",
"equivalence" : "equivalent"
}
]
},
{
"code" : "79",
"display" : "Thành phố Hồ Chí Minh",
"target" : [
{
"code" : "79",
"display" : "Thành phố Hồ Chí Minh",
"equivalence" : "narrower",
"comment" : "TP HCM mới = TP HCM cũ + Bà Rịa Vũng Tàu (#77) + Bình Dương (#74)"
}
]
},
{
"code" : "77",
"display" : "Tỉnh Bà Rịa - Vũng Tàu (inactive)",
"target" : [
{
"code" : "79",
"display" : "Thành phố Hồ Chí Minh",
"equivalence" : "narrower",
"comment" : "Sáp nhập vào TP HCM mới theo NQ 202/2025"
}
]
},
{
"code" : "74",
"display" : "Tỉnh Bình Dương (inactive)",
"target" : [
{
"code" : "79",
"display" : "Thành phố Hồ Chí Minh",
"equivalence" : "narrower",
"comment" : "Sáp nhập vào TP HCM mới theo NQ 202/2025"
}
]
},
{
"code" : "31",
"display" : "Thành phố Hải Phòng",
"target" : [
{
"code" : "31",
"display" : "Thành phố Hải Phòng",
"equivalence" : "narrower",
"comment" : "TP Hải Phòng mới = HP cũ + Hải Dương (#30)"
}
]
},
{
"code" : "30",
"display" : "Tỉnh Hải Dương (inactive)",
"target" : [
{
"code" : "31",
"display" : "Thành phố Hải Phòng",
"equivalence" : "narrower",
"comment" : "Sáp nhập vào Hải Phòng mới theo NQ 202/2025"
}
]
},
{
"code" : "48",
"display" : "Thành phố Đà Nẵng",
"target" : [
{
"code" : "48",
"display" : "Thành phố Đà Nẵng",
"equivalence" : "narrower",
"comment" : "TP Đà Nẵng mới = ĐN cũ + Quảng Nam (#49)"
}
]
},
{
"code" : "49",
"display" : "Tỉnh Quảng Nam (inactive)",
"target" : [
{
"code" : "48",
"display" : "Thành phố Đà Nẵng",
"equivalence" : "narrower",
"comment" : "Sáp nhập vào Đà Nẵng mới theo NQ 202/2025"
}
]
},
{
"code" : "92",
"display" : "Thành phố Cần Thơ",
"target" : [
{
"code" : "92",
"display" : "Thành phố Cần Thơ",
"equivalence" : "narrower",
"comment" : "TP Cần Thơ mới = CT cũ + Hậu Giang (#93) + Sóc Trăng (#94)"
}
]
},
{
"code" : "93",
"display" : "Tỉnh Hậu Giang (inactive)",
"target" : [
{
"code" : "92",
"display" : "Thành phố Cần Thơ",
"equivalence" : "narrower",
"comment" : "Sáp nhập vào Cần Thơ mới theo NQ 202/2025"
}
]
},
{
"code" : "94",
"display" : "Tỉnh Sóc Trăng (inactive)",
"target" : [
{
"code" : "92",
"display" : "Thành phố Cần Thơ",
"equivalence" : "narrower",
"comment" : "Sáp nhập vào Cần Thơ mới theo NQ 202/2025"
}
]
}
]
}
]
}