Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide
0.9.0 - Draft for Community Review
Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide - Draft for Community Review (v0.9.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| Active tại thời điểm 2026-07-16 |
<ConceptMap xmlns="http://hl7.org/fhir">
<id value="vn-cm-health-checkup-subject-legacy-to-current"/>
<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-health-checkup-subject-legacy-to-current</b></p><a name="vn-cm-health-checkup-subject-legacy-to-current"> </a><a name="hcvn-cm-health-checkup-subject-legacy-to-current"> </a><p>Mapping from <a href="ValueSet-vn-health-checkup-subject-legacy-vs.html">Đối tượng khám sức khỏe định kỳ (giai đoạn hiệu lực QĐ 1551/QĐ-BYT — legacy) — Vietnam Health Checkup Subject Legacy ValueSet</a> to <a href="ValueSet-vn-health-checkup-subject-vs.html">Đối tượng khám sức khỏe định kỳ — Vietnam Health Checkup Subject ValueSet</a></p><br/><p>Mapping from <a href="CodeSystem-vn-health-checkup-subject-legacy-cs.html">Đối tượng khám sức khỏe định kỳ (giai đoạn hiệu lực QĐ 1551/QĐ-BYT — legacy) — Vietnam Health Checkup Subject Legacy CodeSystem</a> to <a href="CodeSystem-vn-health-checkup-subject-cs.html">Đối tượng khám sức khỏe định kỳ — Vietnam Health Checkup Subject CodeSystem</a></p><table class="grid"><tr><td colspan="2"><b>Source Concept Details</b></td><td><b>Relationship</b></td><td colspan="2"><b>Target Concept Details</b></td><td><b>Comment</b></td></tr><tr><td colspan="2"><b>Codes</b> from <a href="CodeSystem-vn-health-checkup-subject-legacy-cs.html" title="http://fhir.hl7.org.vn/core/CodeSystem/vn-health-checkup-subject-legacy-cs">Đối tượng khám sức khỏe định kỳ (giai đoạn hiệu lực QĐ 1551/QĐ-BYT — legacy) — Vietnam Health Checkup Subject Legacy CodeSystem</a></td><td/><td colspan="2"><b>Codes</b> from <a href="CodeSystem-vn-health-checkup-subject-cs.html" title="http://fhir.hl7.org.vn/core/CodeSystem/vn-health-checkup-subject-cs">Đối tượng khám sức khỏe định kỳ — Vietnam Health Checkup Subject CodeSystem</a></td><td/></tr><tr><td style="border-right-width: 0px">1</td><td style="border-left-width: 0px">Người cao tuổi</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">1</td><td style="border-left-width: 0px">Người cao tuổi</td><td/></tr><tr><td style="border-right-width: 0px">2</td><td style="border-left-width: 0px">Người khuyết tật</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">2</td><td style="border-left-width: 0px">Người khuyết tật</td><td/></tr><tr><td style="border-right-width: 0px">3</td><td style="border-left-width: 0px">Người thuộc hộ nghèo, cận nghèo</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">3</td><td style="border-left-width: 0px">Người thuộc hộ nghèo, cận nghèo</td><td/></tr><tr><td style="border-right-width: 0px">4</td><td style="border-left-width: 0px">Người có công</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">4</td><td style="border-left-width: 0px">Người có công</td><td/></tr><tr><td style="border-right-width: 0px">5</td><td style="border-left-width: 0px">Người mắc bệnh mạn 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 style="border-right-width: 0px">5</td><td style="border-left-width: 0px">Người mắc bệnh mạn tính</td><td/></tr><tr><td style="border-right-width: 0px">6</td><td style="border-left-width: 0px">Người sống tại vùng đồng bào dân tộc thiểu số và miền 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 style="border-right-width: 0px">6</td><td style="border-left-width: 0px">Người sống tại vùng đồng bào dân tộc thiểu số và miền núi</td><td/></tr><tr><td style="border-right-width: 0px">7</td><td style="border-left-width: 0px">Người sống tại vùng có điều kiện kinh tế - xã hội khó khăn, đặc biệt khó khăn</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">7</td><td style="border-left-width: 0px">Người sống tại vùng có điều kiện kinh tế - xã hội khó khăn, đặc biệt khó khăn</td><td/></tr><tr><td style="border-right-width: 0px">8</td><td style="border-left-width: 0px">Người sống tại xã đảo</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">8</td><td style="border-left-width: 0px">Người sống tại xã đảo</td><td/></tr><tr><td style="border-right-width: 0px">9</td><td style="border-left-width: 0px">Người sống tại đặc khu</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">9</td><td style="border-left-width: 0px">Người sống tại đặc khu</td><td/></tr><tr><td style="border-right-width: 0px">10</td><td style="border-left-width: 0px">Trẻ em trong cơ sở giáo dục mầm non</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">10</td><td style="border-left-width: 0px">Trẻ em trong cơ sở giáo dục mầm non</td><td/></tr><tr><td style="border-right-width: 0px">11</td><td style="border-left-width: 0px">Học sinh trong các cơ sở giáo dục phổ thông</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">11</td><td style="border-left-width: 0px">Học sinh trong các cơ sở giáo dục phổ thông</td><td/></tr><tr><td style="border-right-width: 0px">12</td><td style="border-left-width: 0px">Sinh viên</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">12</td><td style="border-left-width: 0px">Sinh viên</td><td/></tr><tr><td style="border-right-width: 0px">13</td><td style="border-left-width: 0px">Người lao động</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">13</td><td style="border-left-width: 0px">Người lao động</td><td/></tr><tr><td style="border-right-width: 0px; border-bottom-style: none">14</td><td style="border-left-width: 0px; border-bottom-style: none">Các đối tượng khác</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#narrower" title="narrower">narrower</a></td><td style="border-right-width: 0px">14</td><td style="border-left-width: 0px">Người lao động không chính thức</td><td>Mã 14 cũ 'Các đối tượng khác' phủ rộng hơn: chỉ ánh xạ sang 14 mới khi xác minh đối tượng là người lao động không có quan hệ lao động chính thức.</td></tr><tr><td style="border-right-width: 0px; border-top-style: none; border-bottom-style: none"/><td style="border-left-width: 0px; border-top-style: none; border-bottom-style: none"/><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#narrower" title="narrower">narrower</a></td><td style="border-right-width: 0px">15</td><td style="border-left-width: 0px">Người chưa có Bảo hiểm y tế</td><td>Mã 14 cũ phủ rộng hơn: chỉ ánh xạ sang 15 khi xác minh đối tượng chưa tham gia BHYT.</td></tr><tr><td style="border-right-width: 0px; border-top-style: none"/><td style="border-top-style: none; border-left-width: 0px"/><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#narrower" title="narrower">narrower</a></td><td style="border-right-width: 0px">16</td><td style="border-left-width: 0px">Các đối tượng khác</td><td>Đích fallback mặc định cho dữ liệu cũ mang mã 14 khi không xác minh lại được; nghĩa 'khác' của giai đoạn hiệu lực mới hẹp hơn vì đã tách riêng 14 (lao động phi chính thức) và 15 (chưa có BHYT). Phải giữ Coding nguồn trong dữ liệu di trú để bảo toàn provenance và cho phép rà soát lại.</td></tr></table></div>
</text>
<extension
url="http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis">
<valueCoding>
<system
value="http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs"/>
<code value="QD-1551-2026"/>
</valueCoding>
</extension>
<extension
url="http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis">
<valueCoding>
<system
value="http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs"/>
<code value="QD-2062-2026"/>
</valueCoding>
</extension>
<url
value="http://fhir.hl7.org.vn/core/ConceptMap/vn-cm-health-checkup-subject-legacy-to-current"/>
<identifier>
<system value="urn:ietf:rfc:3986"/>
<value value="urn:oid:2.25.161089673617632664299011809196868855799.18.7"/>
</identifier>
<version value="0.9.0"/>
<name value="CMVNHealthCheckupSubjectLegacyToCurrent"/>
<title
value="Ánh xạ đối tượng KSK: giai đoạn hiệu lực QĐ 1551/QĐ-BYT → QĐ 2062/QĐ-BYT"/>
<status value="active"/>
<experimental value="false"/>
<date value="2026-07-16"/>
<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="Ánh xạ 14 mã DOI_TUONG giai đoạn hiệu lực QĐ 1551/QĐ-BYT (31/5/2026, legacy) sang 16 mã
giai đoạn hiệu lực QĐ 2062/QĐ-BYT (07/7/2026, hiện hành). Mã 1–13 giữ nguyên nghĩa (equivalent).
Mã 14 cũ 'Các đối tượng khác' KHÔNG tương đương mã 14 mới: nghĩa cũ phủ rộng — tách thành
3 đích hẹp hơn (#narrower): 14 'Người lao động không chính thức', 15 'Người chưa có BHYT',
16 'Các đối tượng khác'. Dữ liệu cũ mang mã 14 mặc định ánh xạ sang 16; chỉ chuyển sang 14/15 mới
khi xác minh lại được đối tượng thực tế."/>
<jurisdiction>
<coding>
<system value="urn:iso:std:iso:3166"/>
<code value="VN"/>
<display value="Viet Nam"/>
</coding>
</jurisdiction>
<copyright
value="Bộ Y tế Việt Nam — QĐ 1551/QĐ-BYT Phụ lục 01 (legacy) và QĐ 2062/QĐ-BYT Phụ lục 01 (hiện hành)."/>
<sourceCanonical
value="http://fhir.hl7.org.vn/core/ValueSet/vn-health-checkup-subject-legacy-vs"/>
<targetCanonical
value="http://fhir.hl7.org.vn/core/ValueSet/vn-health-checkup-subject-vs"/>
<group>
<source
value="http://fhir.hl7.org.vn/core/CodeSystem/vn-health-checkup-subject-legacy-cs"/>
<target
value="http://fhir.hl7.org.vn/core/CodeSystem/vn-health-checkup-subject-cs"/>
<element>
<code value="1"/>
<display value="Người cao tuổi"/>
<target>
<code value="1"/>
<display value="Người cao tuổi"/>
<equivalence value="equivalent"/>
</target>
</element>
<element>
<code value="2"/>
<display value="Người khuyết tật"/>
<target>
<code value="2"/>
<display value="Người khuyết tật"/>
<equivalence value="equivalent"/>
</target>
</element>
<element>
<code value="3"/>
<display value="Người thuộc hộ nghèo, cận nghèo"/>
<target>
<code value="3"/>
<display value="Người thuộc hộ nghèo, cận nghèo"/>
<equivalence value="equivalent"/>
</target>
</element>
<element>
<code value="4"/>
<display value="Người có công"/>
<target>
<code value="4"/>
<display value="Người có công"/>
<equivalence value="equivalent"/>
</target>
</element>
<element>
<code value="5"/>
<display value="Người mắc bệnh mạn tính"/>
<target>
<code value="5"/>
<display value="Người mắc bệnh mạn tính"/>
<equivalence value="equivalent"/>
</target>
</element>
<element>
<code value="6"/>
<display
value="Người sống tại vùng đồng bào dân tộc thiểu số và miền núi"/>
<target>
<code value="6"/>
<display
value="Người sống tại vùng đồng bào dân tộc thiểu số và miền núi"/>
<equivalence value="equivalent"/>
</target>
</element>
<element>
<code value="7"/>
<display
value="Người sống tại vùng có điều kiện kinh tế - xã hội khó khăn, đặc biệt khó khăn"/>
<target>
<code value="7"/>
<display
value="Người sống tại vùng có điều kiện kinh tế - xã hội khó khăn, đặc biệt khó khăn"/>
<equivalence value="equivalent"/>
</target>
</element>
<element>
<code value="8"/>
<display value="Người sống tại xã đảo"/>
<target>
<code value="8"/>
<display value="Người sống tại xã đảo"/>
<equivalence value="equivalent"/>
</target>
</element>
<element>
<code value="9"/>
<display value="Người sống tại đặc khu"/>
<target>
<code value="9"/>
<display value="Người sống tại đặc khu"/>
<equivalence value="equivalent"/>
</target>
</element>
<element>
<code value="10"/>
<display value="Trẻ em trong cơ sở giáo dục mầm non"/>
<target>
<code value="10"/>
<display value="Trẻ em trong cơ sở giáo dục mầm non"/>
<equivalence value="equivalent"/>
</target>
</element>
<element>
<code value="11"/>
<display value="Học sinh trong các cơ sở giáo dục phổ thông"/>
<target>
<code value="11"/>
<display value="Học sinh trong các cơ sở giáo dục phổ thông"/>
<equivalence value="equivalent"/>
</target>
</element>
<element>
<code value="12"/>
<display value="Sinh viên"/>
<target>
<code value="12"/>
<display value="Sinh viên"/>
<equivalence value="equivalent"/>
</target>
</element>
<element>
<code value="13"/>
<display value="Người lao động"/>
<target>
<code value="13"/>
<display value="Người lao động"/>
<equivalence value="equivalent"/>
</target>
</element>
<element>
<code value="14"/>
<display value="Các đối tượng khác"/>
<target>
<code value="14"/>
<display value="Người lao động không chính thức"/>
<equivalence value="narrower"/>
<comment
value="Mã 14 cũ 'Các đối tượng khác' phủ rộng hơn: chỉ ánh xạ sang 14 mới khi xác minh đối tượng là người lao động không có quan hệ lao động chính thức."/>
</target>
<target>
<code value="15"/>
<display value="Người chưa có Bảo hiểm y tế"/>
<equivalence value="narrower"/>
<comment
value="Mã 14 cũ phủ rộng hơn: chỉ ánh xạ sang 15 khi xác minh đối tượng chưa tham gia BHYT."/>
</target>
<target>
<code value="16"/>
<display value="Các đối tượng khác"/>
<equivalence value="narrower"/>
<comment
value="Đích fallback mặc định cho dữ liệu cũ mang mã 14 khi không xác minh lại được; nghĩa 'khác' của giai đoạn hiệu lực mới hẹp hơn vì đã tách riêng 14 (lao động phi chính thức) và 15 (chưa có BHYT). Phải giữ Coding nguồn trong dữ liệu di trú để bảo toàn provenance và cho phép rà soát lại."/>
</target>
</element>
</group>
</ConceptMap>