VN Core FHIR Implementation Guide — Bộ Hướng dẫn Triển khai FHIR Cốt lõi cho Việt Nam
0.1.0 - STU1 Draft
VN Core FHIR Implementation Guide — Bộ Hướng dẫn Triển khai FHIR Cốt lõi cho Việt Nam
0.1.0 - STU1 Draft
VN Core FHIR Implementation Guide — Bộ Hướng dẫn Triển khai FHIR Cốt lõi cho Việt Nam - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| Draft as of 2026-03-21 |
<CodeSystem xmlns="http://hl7.org/fhir">
<id value="vn-identifier-type-cs"/>
<text>
<status value="generated"/>
<div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: CodeSystem vn-identifier-type-cs</b></p><a name="vn-identifier-type-cs"> </a><a name="hcvn-identifier-type-cs"> </a><p>This case-sensitive code system <code>http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-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">CCCD<a name="vn-identifier-type-cs-CCCD"> </a></td><td>Căn cước công dân</td><td>Số Căn cước công dân (12 chữ số) do Bộ Công an cấp — định danh chính (primary identifier) trong hệ thống y tế VN. Từ 01/7/2025 thay thế mã số thuế cá nhân.</td><td>Citizen Identity Card</td></tr><tr><td style="white-space:nowrap">CMND<a name="vn-identifier-type-cs-CMND"> </a></td><td>Chứng minh nhân dân</td><td>Số Chứng minh nhân dân (9 hoặc 12 chữ số) — loại giấy tờ cũ, đã ngừng cấp mới. Giữ lại cho backward-compatibility với dữ liệu lịch sử.</td><td>People's Identity Card (legacy)</td></tr><tr><td style="white-space:nowrap">BHYT<a name="vn-identifier-type-cs-BHYT"> </a></td><td>Thẻ bảo hiểm y tế</td><td>Số thẻ Bảo hiểm Y tế (15 ký tự: 2 chữ + 13 số) do BHXH Việt Nam cấp. Xác định quyền lợi KCB BHYT của người bệnh.</td><td>Health Insurance Card</td></tr><tr><td style="white-space:nowrap">BHXH<a name="vn-identifier-type-cs-BHXH"> </a></td><td>Mã số bảo hiểm xã hội</td><td>Mã số Bảo hiểm Xã hội (10 chữ số) do BHXH Việt Nam cấp. Dùng cho quản lý BHXH, BHYT, BHTN.</td><td>Social Insurance Number</td></tr><tr><td style="white-space:nowrap">CCHN<a name="vn-identifier-type-cs-CCHN"> </a></td><td>Chứng chỉ hành nghề</td><td>Số Chứng chỉ hành nghề y do Bộ Y tế hoặc Sở Y tế cấp. Bắt buộc cho nhân viên y tế hành nghề KCB per Luật KCB 2023.</td><td>Medical Practice License</td></tr><tr><td style="white-space:nowrap">CSKCB<a name="vn-identifier-type-cs-CSKCB"> </a></td><td>Mã cơ sở khám chữa bệnh</td><td>Mã cơ sở khám chữa bệnh (5 chữ số) do BHXH VN cấp. Dùng trong giao dịch BHYT, gửi dữ liệu XML 3176.</td><td>Healthcare Facility Code</td></tr><tr><td style="white-space:nowrap">MRN<a name="vn-identifier-type-cs-MRN"> </a></td><td>Mã bệnh nhân nội bộ</td><td>Mã bệnh nhân (Medical Record Number) do từng cơ sở KCB tự quản lý. Không có format thống nhất toàn quốc.</td><td>Medical Record Number</td></tr><tr><td style="white-space:nowrap">HC<a name="vn-identifier-type-cs-HC"> </a></td><td>Hộ chiếu</td><td>Số Hộ chiếu do Bộ Công an cấp. Dùng cho người nước ngoài hoặc công dân VN khi chưa có CCCD.</td><td>Passport</td></tr><tr><td style="white-space:nowrap">GKS<a name="vn-identifier-type-cs-GKS"> </a></td><td>Giấy khai sinh</td><td>Số Giấy khai sinh do UBND xã/phường cấp. Dùng cho trẻ sơ sinh chưa có CCCD.</td><td>Birth Certificate</td></tr><tr><td style="white-space:nowrap">MST<a name="vn-identifier-type-cs-MST"> </a></td><td>Mã số thuế</td><td>Mã số thuế doanh nghiệp/tổ chức do Tổng cục Thuế cấp. Từ 01/7/2025 không còn dùng cho cá nhân (thay bằng CCCD).</td><td>Tax Identification Number</td></tr><tr><td style="white-space:nowrap">VNEID<a name="vn-identifier-type-cs-VNEID"> </a></td><td>Tài khoản định danh điện tử VNeID</td><td>Tài khoản định danh điện tử trên ứng dụng VNeID do BCA quản lý. Tích hợp CCCD, BHYT, sổ SKĐT (QĐ 1332/QĐ-BYT).</td><td>VNeID Electronic Identity Account</td></tr></table></div>
</text>
<url value="http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs"/>
<version value="0.1.0"/>
<name value="VNIdentifierTypeCS"/>
<title
value="Loại định danh Việt Nam — Vietnam Identifier Type CodeSystem"/>
<status value="draft"/>
<experimental value="false"/>
<date value="2026-03-21"/>
<publisher value="HL7 Vietnam"/>
<contact>
<name value="HL7 Vietnam"/>
<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="healthtech@omigroup.vn"/>
</telecom>
</contact>
<description
value="Danh mục các loại định danh sử dụng trong hệ thống y tế Việt Nam.
Bổ sung cho HL7 v2 Table 0203 (Identifier Type) với các loại định danh riêng của Việt Nam."/>
<jurisdiction>
<coding>
<system value="urn:iso:std:iso:3166"/>
<code value="VN"/>
<display value="Viet Nam"/>
</coding>
</jurisdiction>
<copyright
value="HL7 Vietnam. Bổ sung cho HL7 v2 Table 0203 với các loại định danh Việt Nam — CCCD (BCA), BHYT (BHXH VN), CCHN (BYT)."/>
<caseSensitive value="true"/>
<content value="complete"/>
<count value="11"/>
<concept>
<code value="CCCD"/>
<display value="Căn cước công dân"/>
<definition
value="Số Căn cước công dân (12 chữ số) do Bộ Công an cấp — định danh chính (primary identifier) trong hệ thống y tế VN. Từ 01/7/2025 thay thế mã số thuế cá nhân."/>
<designation>
<language value="en"/>
<value value="Citizen Identity Card"/>
</designation>
</concept>
<concept>
<code value="CMND"/>
<display value="Chứng minh nhân dân"/>
<definition
value="Số Chứng minh nhân dân (9 hoặc 12 chữ số) — loại giấy tờ cũ, đã ngừng cấp mới. Giữ lại cho backward-compatibility với dữ liệu lịch sử."/>
<designation>
<language value="en"/>
<value value="People's Identity Card (legacy)"/>
</designation>
</concept>
<concept>
<code value="BHYT"/>
<display value="Thẻ bảo hiểm y tế"/>
<definition
value="Số thẻ Bảo hiểm Y tế (15 ký tự: 2 chữ + 13 số) do BHXH Việt Nam cấp. Xác định quyền lợi KCB BHYT của người bệnh."/>
<designation>
<language value="en"/>
<value value="Health Insurance Card"/>
</designation>
</concept>
<concept>
<code value="BHXH"/>
<display value="Mã số bảo hiểm xã hội"/>
<definition
value="Mã số Bảo hiểm Xã hội (10 chữ số) do BHXH Việt Nam cấp. Dùng cho quản lý BHXH, BHYT, BHTN."/>
<designation>
<language value="en"/>
<value value="Social Insurance Number"/>
</designation>
</concept>
<concept>
<code value="CCHN"/>
<display value="Chứng chỉ hành nghề"/>
<definition
value="Số Chứng chỉ hành nghề y do Bộ Y tế hoặc Sở Y tế cấp. Bắt buộc cho nhân viên y tế hành nghề KCB per Luật KCB 2023."/>
<designation>
<language value="en"/>
<value value="Medical Practice License"/>
</designation>
</concept>
<concept>
<code value="CSKCB"/>
<display value="Mã cơ sở khám chữa bệnh"/>
<definition
value="Mã cơ sở khám chữa bệnh (5 chữ số) do BHXH VN cấp. Dùng trong giao dịch BHYT, gửi dữ liệu XML 3176."/>
<designation>
<language value="en"/>
<value value="Healthcare Facility Code"/>
</designation>
</concept>
<concept>
<code value="MRN"/>
<display value="Mã bệnh nhân nội bộ"/>
<definition
value="Mã bệnh nhân (Medical Record Number) do từng cơ sở KCB tự quản lý. Không có format thống nhất toàn quốc."/>
<designation>
<language value="en"/>
<value value="Medical Record Number"/>
</designation>
</concept>
<concept>
<code value="HC"/>
<display value="Hộ chiếu"/>
<definition
value="Số Hộ chiếu do Bộ Công an cấp. Dùng cho người nước ngoài hoặc công dân VN khi chưa có CCCD."/>
<designation>
<language value="en"/>
<value value="Passport"/>
</designation>
</concept>
<concept>
<code value="GKS"/>
<display value="Giấy khai sinh"/>
<definition
value="Số Giấy khai sinh do UBND xã/phường cấp. Dùng cho trẻ sơ sinh chưa có CCCD."/>
<designation>
<language value="en"/>
<value value="Birth Certificate"/>
</designation>
</concept>
<concept>
<code value="MST"/>
<display value="Mã số thuế"/>
<definition
value="Mã số thuế doanh nghiệp/tổ chức do Tổng cục Thuế cấp. Từ 01/7/2025 không còn dùng cho cá nhân (thay bằng CCCD)."/>
<designation>
<language value="en"/>
<value value="Tax Identification Number"/>
</designation>
</concept>
<concept>
<code value="VNEID"/>
<display value="Tài khoản định danh điện tử VNeID"/>
<definition
value="Tài khoản định danh điện tử trên ứng dụng VNeID do BCA quản lý. Tích hợp CCCD, BHYT, sổ SKĐT (QĐ 1332/QĐ-BYT)."/>
<designation>
<language value="en"/>
<value value="VNeID Electronic Identity Account"/>
</designation>
</concept>
</CodeSystem>