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 - Local Development build (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-20 |
<CodeSystem xmlns="http://hl7.org/fhir">
<id value="vn-health-checkup-subject-cs"/>
<language value="vi"/>
<text>
<status value="generated"/>
<div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: CodeSystem vn-health-checkup-subject-cs</b></p><a name="vn-health-checkup-subject-cs"> </a><a name="hcvn-health-checkup-subject-cs"> </a><p>This case-sensitive code system <code>http://fhir.hl7.org.vn/core/CodeSystem/vn-health-checkup-subject-cs</code> defines the following codes:</p><table class="codes"><tr><td style="white-space:nowrap"><b>Code</b></td><td><b>Display</b></td><td><b>Definition</b></td><td><b>English (English, en)</b></td></tr><tr><td style="white-space:nowrap">1<a name="vn-health-checkup-subject-cs-1"> </a></td><td>Người cao tuổi</td><td>Theo QĐ 2062/QĐ-BYT, DOI_TUONG = 1.</td><td>Elderly</td></tr><tr><td style="white-space:nowrap">2<a name="vn-health-checkup-subject-cs-2"> </a></td><td>Người khuyết tật</td><td>Theo QĐ 2062/QĐ-BYT, DOI_TUONG = 2.</td><td>Person with disability</td></tr><tr><td style="white-space:nowrap">3<a name="vn-health-checkup-subject-cs-3"> </a></td><td>Người thuộc hộ nghèo, cận nghèo</td><td>Theo QĐ 2062/QĐ-BYT, DOI_TUONG = 3.</td><td>Poor / near-poor household member</td></tr><tr><td style="white-space:nowrap">4<a name="vn-health-checkup-subject-cs-4"> </a></td><td>Người có công</td><td>Người có công với cách mạng. Theo QĐ 2062/QĐ-BYT, DOI_TUONG = 4.</td><td>Person with meritorious service</td></tr><tr><td style="white-space:nowrap">5<a name="vn-health-checkup-subject-cs-5"> </a></td><td>Người mắc bệnh mạn tính</td><td>Theo QĐ 2062/QĐ-BYT, DOI_TUONG = 5.</td><td>Person with chronic disease</td></tr><tr><td style="white-space:nowrap">6<a name="vn-health-checkup-subject-cs-6"> </a></td><td>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>Theo QĐ 2062/QĐ-BYT, DOI_TUONG = 6.</td><td>Resident of ethnic minority / mountainous area</td></tr><tr><td style="white-space:nowrap">7<a name="vn-health-checkup-subject-cs-7"> </a></td><td>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>Theo QĐ 2062/QĐ-BYT, DOI_TUONG = 7.</td><td>Resident of (extremely) disadvantaged area</td></tr><tr><td style="white-space:nowrap">8<a name="vn-health-checkup-subject-cs-8"> </a></td><td>Người sống tại xã đảo</td><td>Theo QĐ 2062/QĐ-BYT, DOI_TUONG = 8.</td><td>Resident of island commune</td></tr><tr><td style="white-space:nowrap">9<a name="vn-health-checkup-subject-cs-9"> </a></td><td>Người sống tại đặc khu</td><td>Theo QĐ 2062/QĐ-BYT, DOI_TUONG = 9.</td><td>Resident of special administrative-economic zone</td></tr><tr><td style="white-space:nowrap">10<a name="vn-health-checkup-subject-cs-10"> </a></td><td>Trẻ em trong cơ sở giáo dục mầm non</td><td>Theo QĐ 2062/QĐ-BYT, DOI_TUONG = 10.</td><td>Preschool / kindergarten child</td></tr><tr><td style="white-space:nowrap">11<a name="vn-health-checkup-subject-cs-11"> </a></td><td>Học sinh trong các cơ sở giáo dục phổ thông</td><td>Theo QĐ 2062/QĐ-BYT, DOI_TUONG = 11.</td><td>General education student</td></tr><tr><td style="white-space:nowrap">12<a name="vn-health-checkup-subject-cs-12"> </a></td><td>Sinh viên</td><td>Theo QĐ 2062/QĐ-BYT, DOI_TUONG = 12.</td><td>University / college student</td></tr><tr><td style="white-space:nowrap">13<a name="vn-health-checkup-subject-cs-13"> </a></td><td>Người lao động</td><td>Theo QĐ 2062/QĐ-BYT, DOI_TUONG = 13.</td><td>Worker / employee</td></tr><tr><td style="white-space:nowrap">14<a name="vn-health-checkup-subject-cs-14"> </a></td><td>Người lao động không chính thức</td><td>Người lao động không có quan hệ lao động chính thức. Theo QĐ 2062/QĐ-BYT, DOI_TUONG = 14 (khác nghĩa mã 14 cũ của QĐ 1551/QĐ-BYT).</td><td>Informal / non-contract worker</td></tr><tr><td style="white-space:nowrap">15<a name="vn-health-checkup-subject-cs-15"> </a></td><td>Người chưa có Bảo hiểm y tế</td><td>Theo QĐ 2062/QĐ-BYT, DOI_TUONG = 15.</td><td>Person without health insurance</td></tr><tr><td style="white-space:nowrap">16<a name="vn-health-checkup-subject-cs-16"> </a></td><td>Các đối tượng khác</td><td>Theo QĐ 2062/QĐ-BYT, DOI_TUONG = 16.</td><td>Other subjects</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-2062-2026"/>
</valueCoding>
</extension>
<url
value="http://fhir.hl7.org.vn/core/CodeSystem/vn-health-checkup-subject-cs"/>
<identifier>
<system value="urn:ietf:rfc:3986"/>
<value
value="urn:oid:2.25.161089673617632664299011809196868855799.16.39"/>
</identifier>
<version value="0.9.0"/>
<name value="VNHealthCheckupSubjectCS"/>
<title
value="Đối tượng khám sức khỏe định kỳ — Vietnam Health Checkup Subject CodeSystem"/>
<status value="active"/>
<experimental value="false"/>
<date value="2026-07-20"/>
<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="info@hl7.org.vn"/>
</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="info@hl7.org.vn"/>
</telecom>
</contact>
<description
value="Danh mục đối tượng khám sức khỏe định kỳ / khám sàng lọc (trường DOI_TUONG) —
giai đoạn hiệu lực HIỆN HÀNH theo QĐ 2062/QĐ-BYT (07/7/2026) Phụ lục 01 (THAY Phụ lục 01 QĐ 1551/QĐ-BYT 31/5/2026; đọc hợp nhất).
Business version = 20260707 (ngày hiệu lực QĐ 2062/QĐ-BYT — ADR-0017 Điều 4). Phân biệt ngữ nghĩa
giữa hai giai đoạn hiệu lực bằng CANONICAL TÁCH (cặp vn-health-checkup-subject-cs /
vn-health-checkup-subject-legacy-cs), không dựa vào Coding.version. Coding.version là tùy chọn;
nếu có, giá trị phải khớp business version của canonical đã chọn. Mã #14 đã TÁI SỬ DỤNG với nghĩa
khác giữa hai giai đoạn hiệu lực (QĐ 1551/QĐ-BYT: 'Các đối tượng khác' → QĐ 2062/QĐ-BYT:
'Người lao động không chính thức').
Giai đoạn hiệu lực cũ: vn-health-checkup-subject-legacy-cs (immutable); ánh xạ: ConceptMap
vn-cm-health-checkup-subject-legacy-to-current; dữ liệu cũ mang mã 14 phải tái mã hóa (mặc định → 16).
Lưu ý: một lần khám có thể có nhiều đối tượng — khi đó các mã được phân cách bằng dấu chấm phẩy ';'
(ví dụ '13;15') — quy ước Ở TẦNG SERIALIZATION QĐ 2062/QĐ-BYT (LogicalModel envelope), không phải cú pháp mã FHIR.
English: Current health-checkup subject catalogue under Decision 2062/QĐ-BYT. Semantic identity
across the two effective periods is distinguished solely by split canonicals, not by Coding.version.
Coding.version is optional and, when present, SHALL match the business version of the selected canonical."/>
<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Đ 2062/QĐ-BYT (07/7/2026), Phụ lục 01. Trường DOI_TUONG."/>
<caseSensitive value="true"/>
<content value="complete"/>
<count value="16"/>
<concept>
<code value="1"/>
<display value="Người cao tuổi"/>
<definition value="Theo QĐ 2062/QĐ-BYT, DOI_TUONG = 1."/>
<designation>
<language value="en"/>
<value value="Elderly"/>
</designation>
</concept>
<concept>
<code value="2"/>
<display value="Người khuyết tật"/>
<definition value="Theo QĐ 2062/QĐ-BYT, DOI_TUONG = 2."/>
<designation>
<language value="en"/>
<value value="Person with disability"/>
</designation>
</concept>
<concept>
<code value="3"/>
<display value="Người thuộc hộ nghèo, cận nghèo"/>
<definition value="Theo QĐ 2062/QĐ-BYT, DOI_TUONG = 3."/>
<designation>
<language value="en"/>
<value value="Poor / near-poor household member"/>
</designation>
</concept>
<concept>
<code value="4"/>
<display value="Người có công"/>
<definition
value="Người có công với cách mạng. Theo QĐ 2062/QĐ-BYT, DOI_TUONG = 4."/>
<designation>
<language value="en"/>
<value value="Person with meritorious service"/>
</designation>
</concept>
<concept>
<code value="5"/>
<display value="Người mắc bệnh mạn tính"/>
<definition value="Theo QĐ 2062/QĐ-BYT, DOI_TUONG = 5."/>
<designation>
<language value="en"/>
<value value="Person with chronic disease"/>
</designation>
</concept>
<concept>
<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"/>
<definition value="Theo QĐ 2062/QĐ-BYT, DOI_TUONG = 6."/>
<designation>
<language value="en"/>
<value value="Resident of ethnic minority / mountainous area"/>
</designation>
</concept>
<concept>
<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"/>
<definition value="Theo QĐ 2062/QĐ-BYT, DOI_TUONG = 7."/>
<designation>
<language value="en"/>
<value value="Resident of (extremely) disadvantaged area"/>
</designation>
</concept>
<concept>
<code value="8"/>
<display value="Người sống tại xã đảo"/>
<definition value="Theo QĐ 2062/QĐ-BYT, DOI_TUONG = 8."/>
<designation>
<language value="en"/>
<value value="Resident of island commune"/>
</designation>
</concept>
<concept>
<code value="9"/>
<display value="Người sống tại đặc khu"/>
<definition value="Theo QĐ 2062/QĐ-BYT, DOI_TUONG = 9."/>
<designation>
<language value="en"/>
<value value="Resident of special administrative-economic zone"/>
</designation>
</concept>
<concept>
<code value="10"/>
<display value="Trẻ em trong cơ sở giáo dục mầm non"/>
<definition value="Theo QĐ 2062/QĐ-BYT, DOI_TUONG = 10."/>
<designation>
<language value="en"/>
<value value="Preschool / kindergarten child"/>
</designation>
</concept>
<concept>
<code value="11"/>
<display value="Học sinh trong các cơ sở giáo dục phổ thông"/>
<definition value="Theo QĐ 2062/QĐ-BYT, DOI_TUONG = 11."/>
<designation>
<language value="en"/>
<value value="General education student"/>
</designation>
</concept>
<concept>
<code value="12"/>
<display value="Sinh viên"/>
<definition value="Theo QĐ 2062/QĐ-BYT, DOI_TUONG = 12."/>
<designation>
<language value="en"/>
<value value="University / college student"/>
</designation>
</concept>
<concept>
<code value="13"/>
<display value="Người lao động"/>
<definition value="Theo QĐ 2062/QĐ-BYT, DOI_TUONG = 13."/>
<designation>
<language value="en"/>
<value value="Worker / employee"/>
</designation>
</concept>
<concept>
<code value="14"/>
<display value="Người lao động không chính thức"/>
<definition
value="Người lao động không có quan hệ lao động chính thức. Theo QĐ 2062/QĐ-BYT, DOI_TUONG = 14 (khác nghĩa mã 14 cũ của QĐ 1551/QĐ-BYT)."/>
<designation>
<language value="en"/>
<value value="Informal / non-contract worker"/>
</designation>
</concept>
<concept>
<code value="15"/>
<display value="Người chưa có Bảo hiểm y tế"/>
<definition value="Theo QĐ 2062/QĐ-BYT, DOI_TUONG = 15."/>
<designation>
<language value="en"/>
<value value="Person without health insurance"/>
</designation>
</concept>
<concept>
<code value="16"/>
<display value="Các đối tượng khác"/>
<definition value="Theo QĐ 2062/QĐ-BYT, DOI_TUONG = 16."/>
<designation>
<language value="en"/>
<value value="Other subjects"/>
</designation>
</concept>
</CodeSystem>