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-19 |
{
"resourceType" : "CodeSystem",
"id" : "vn-insurance-visit-type-cs",
"language" : "vi",
"text" : {
"status" : "generated",
"div" : "<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>"
},
"extension" : [
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis",
"valueCoding" : {
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs",
"code" : "QD-4210-BYT"
}
}
],
"url" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-insurance-visit-type-cs",
"identifier" : [
{
"system" : "urn:ietf:rfc:3986",
"value" : "urn:oid:2.25.161089673617632664299011809196868855799.16.50"
}
],
"version" : "0.9.0",
"name" : "VNInsuranceVisitTypeCS",
"title" : "Loại khám chữa bệnh BHYT — Vietnam Insurance Visit Type CodeSystem",
"status" : "active",
"experimental" : false,
"date" : "2026-07-19",
"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" : "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.\nChuẩ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" : "urn:iso:std:iso:3166",
"code" : "VN",
"display" : "Viet Nam"
}
]
}
],
"copyright" : "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" : true,
"content" : "complete",
"count" : 5,
"property" : [
{
"code" : "codeSource",
"uri" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-insurance-visit-type-cs#codeSource",
"description" : "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" : "code"
},
{
"code" : "status",
"uri" : "http://hl7.org/fhir/concept-properties#status",
"description" : "Trạng thái mã (active | deprecated).",
"type" : "code"
}
],
"concept" : [
{
"code" : "1",
"display" : "Đúng tuyến",
"definition" : "KCB đúng tuyến — mã legacy MA_LYDO_VVIEN = 1 theo QĐ 4210/QĐ-BYT (2017).",
"designation" : [
{
"language" : "en",
"value" : "In-network referral"
}
],
"property" : [
{
"code" : "codeSource",
"valueCode" : "statutory"
}
]
},
{
"code" : "2",
"display" : "Cấp cứu",
"definition" : "KCB cấp cứu — mã legacy MA_LYDO_VVIEN = 2 theo QĐ 4210/QĐ-BYT (2017).",
"designation" : [
{
"language" : "en",
"value" : "Emergency"
}
],
"property" : [
{
"code" : "codeSource",
"valueCode" : "statutory"
}
]
},
{
"code" : "3",
"display" : "Trái tuyến",
"definition" : "KCB trái tuyến — mã legacy MA_LYDO_VVIEN = 3 theo QĐ 4210/QĐ-BYT (2017).",
"designation" : [
{
"language" : "en",
"value" : "Out-of-network"
}
],
"property" : [
{
"code" : "codeSource",
"valueCode" : "statutory"
}
]
},
{
"code" : "4",
"display" : "Thông tuyến",
"definition" : "KCB thông tuyến — mã legacy MA_LYDO_VVIEN = 4 theo QĐ 4210/QĐ-BYT (2017).",
"designation" : [
{
"language" : "en",
"value" : "Cross-network"
}
],
"property" : [
{
"code" : "codeSource",
"valueCode" : "statutory"
}
]
},
{
"code" : "5",
"display" : "Khám chữa bệnh ban đầu",
"definition" : "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" : "en",
"value" : "Primary care visit (project-assigned)"
}
],
"property" : [
{
"code" : "codeSource",
"valueCode" : "project-assigned"
},
{
"code" : "status",
"valueCode" : "deprecated"
}
]
}
]
}