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-19 |
<CodeSystem xmlns="http://hl7.org/fhir">
<id value="vn-insurance-visit-type-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-insurance-visit-type-cs</b></p><a name="vn-insurance-visit-type-cs"> </a><a name="hcvn-insurance-visit-type-cs"> </a><p><b>Properties</b></p><p><b>This code system defines the following properties for its concepts</b></p><table class="grid"><tr><td><b>Name</b></td><td><b>Code</b></td><td><b>URI</b></td><td><b>Type</b></td><td><b>Description</b></td></tr><tr><td>codeSource</td><td>codeSource</td><td>http://fhir.hl7.org.vn/core/CodeSystem/vn-insurance-visit-type-cs#codeSource</td><td>code</td><td>Nguồn của mã: statutory (trích nguyên văn danh mục trong văn bản) | project-assigned (VN Core tự đặt, chờ nguồn chính thức).</td></tr><tr><td>status</td><td>status</td><td>http://hl7.org/fhir/concept-properties#status</td><td>code</td><td>Trạng thái mã (active | deprecated).</td></tr></table><p><b>Concepts</b></p><p>This case-sensitive code system <code>http://fhir.hl7.org.vn/core/CodeSystem/vn-insurance-visit-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>codeSource</b></td><td><b>status</b></td><td><b>English (English, en)</b></td></tr><tr><td style="white-space:nowrap">1<a name="vn-insurance-visit-type-cs-1"> </a></td><td>Đúng tuyến</td><td>KCB đúng tuyến — mã legacy MA_LYDO_VVIEN = 1 theo QĐ 4210/QĐ-BYT (2017).</td><td>statutory</td><td/><td>In-network referral</td></tr><tr><td style="white-space:nowrap">2<a name="vn-insurance-visit-type-cs-2"> </a></td><td>Cấp cứu</td><td>KCB cấp cứu — mã legacy MA_LYDO_VVIEN = 2 theo QĐ 4210/QĐ-BYT (2017).</td><td>statutory</td><td/><td>Emergency</td></tr><tr><td style="white-space:nowrap">3<a name="vn-insurance-visit-type-cs-3"> </a></td><td>Trái tuyến</td><td>KCB trái tuyến — mã legacy MA_LYDO_VVIEN = 3 theo QĐ 4210/QĐ-BYT (2017).</td><td>statutory</td><td/><td>Out-of-network</td></tr><tr><td style="white-space:nowrap">4<a name="vn-insurance-visit-type-cs-4"> </a></td><td>Thông tuyến</td><td>KCB thông tuyến — mã legacy MA_LYDO_VVIEN = 4 theo QĐ 4210/QĐ-BYT (2017).</td><td>statutory</td><td/><td>Cross-network</td></tr><tr style="background-color: #ffeeee"><td style="white-space:nowrap">5<a name="vn-insurance-visit-type-cs-5"> </a></td><td>Khám chữa bệnh ban đầu</td><td>KCB ban đầu — người bệnh đến cơ sở nơi đăng ký KCB BHYT ban đầu ghi trên thẻ. MÃ DO DỰ ÁN TỰ ĐẶT: không có trong QĐ 4210/QĐ-BYT, không được dùng khi trao đổi dữ liệu với cơ quan BHXH. Dữ liệu mới dùng mã #1 (đúng tuyến) của bộ legacy này, hoặc chuyển sang VNPatientVisitTypeCS mã 1.1 theo QĐ 3276/QĐ-BYT.</td><td>project-assigned</td><td>deprecated</td><td>Primary care visit (project-assigned)</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-4210-BYT"/>
</valueCoding>
</extension>
<url
value="http://fhir.hl7.org.vn/core/CodeSystem/vn-insurance-visit-type-cs"/>
<identifier>
<system value="urn:ietf:rfc:3986"/>
<value
value="urn:oid:2.25.161089673617632664299011809196868855799.16.50"/>
</identifier>
<version value="0.9.0"/>
<name value="VNInsuranceVisitTypeCS"/>
<title
value="Loại khám chữa bệnh BHYT — Vietnam Insurance Visit Type CodeSystem"/>
<status value="active"/>
<experimental value="false"/>
<date value="2026-07-19"/>
<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 legacy theo trường MA_LYDO_VVIEN — QĐ 4210/QĐ-BYT (2017), gồm bốn mã nguồn 1–4 (codeSource = statutory); mã 5 do dự án tự đặt (codeSource = project-assigned) và đã deprecated — không dùng cho dữ liệu mới.
Chuẩn hiện hành QĐ 3176/QĐ-BYT dùng MA_DOI_TUONG_KCB với danh mục 27 mã theo QĐ 3276/QĐ-BYT (xem VNPatientVisitTypeCS)."/>
<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Đ 4210/QĐ-BYT (2017), trường MA_LYDO_VVIEN, mã 1–4. Mã 5 KHÔNG thuộc QĐ 4210/QĐ-BYT — do dự án tự đặt (property codeSource = project-assigned), đã deprecated."/>
<caseSensitive value="true"/>
<content value="complete"/>
<count value="5"/>
<property>
<code value="codeSource"/>
<uri
value="http://fhir.hl7.org.vn/core/CodeSystem/vn-insurance-visit-type-cs#codeSource"/>
<description
value="Nguồn của mã: statutory (trích nguyên văn danh mục trong văn bản) | project-assigned (VN Core tự đặt, chờ nguồn chính thức)."/>
<type value="code"/>
</property>
<property>
<code value="status"/>
<uri value="http://hl7.org/fhir/concept-properties#status"/>
<description value="Trạng thái mã (active | deprecated)."/>
<type value="code"/>
</property>
<concept>
<code value="1"/>
<display value="Đúng tuyến"/>
<definition
value="KCB đúng tuyến — mã legacy MA_LYDO_VVIEN = 1 theo QĐ 4210/QĐ-BYT (2017)."/>
<designation>
<language value="en"/>
<value value="In-network referral"/>
</designation>
<property>
<code value="codeSource"/>
<valueCode value="statutory"/>
</property>
</concept>
<concept>
<code value="2"/>
<display value="Cấp cứu"/>
<definition
value="KCB cấp cứu — mã legacy MA_LYDO_VVIEN = 2 theo QĐ 4210/QĐ-BYT (2017)."/>
<designation>
<language value="en"/>
<value value="Emergency"/>
</designation>
<property>
<code value="codeSource"/>
<valueCode value="statutory"/>
</property>
</concept>
<concept>
<code value="3"/>
<display value="Trái tuyến"/>
<definition
value="KCB trái tuyến — mã legacy MA_LYDO_VVIEN = 3 theo QĐ 4210/QĐ-BYT (2017)."/>
<designation>
<language value="en"/>
<value value="Out-of-network"/>
</designation>
<property>
<code value="codeSource"/>
<valueCode value="statutory"/>
</property>
</concept>
<concept>
<code value="4"/>
<display value="Thông tuyến"/>
<definition
value="KCB thông tuyến — mã legacy MA_LYDO_VVIEN = 4 theo QĐ 4210/QĐ-BYT (2017)."/>
<designation>
<language value="en"/>
<value value="Cross-network"/>
</designation>
<property>
<code value="codeSource"/>
<valueCode value="statutory"/>
</property>
</concept>
<concept>
<code value="5"/>
<display value="Khám chữa bệnh ban đầu"/>
<definition
value="KCB ban đầu — người bệnh đến cơ sở nơi đăng ký KCB BHYT ban đầu ghi trên thẻ. MÃ DO DỰ ÁN TỰ ĐẶT: không có trong QĐ 4210/QĐ-BYT, không được dùng khi trao đổi dữ liệu với cơ quan BHXH. Dữ liệu mới dùng mã #1 (đúng tuyến) của bộ legacy này, hoặc chuyển sang VNPatientVisitTypeCS mã 1.1 theo QĐ 3276/QĐ-BYT."/>
<designation>
<language value="en"/>
<value value="Primary care visit (project-assigned)"/>
</designation>
<property>
<code value="codeSource"/>
<valueCode value="project-assigned"/>
</property>
<property>
<code value="status"/>
<valueCode value="deprecated"/>
</property>
</concept>
</CodeSystem>