HL7 Vietnam VN Core FHIR Implementation Guide

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 Viet Nam cờ

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

: Loại khám chữa bệnh BHYT — Vietnam Insurance Visit Type CodeSystem

Active tại thời điểm 2026-07-19

Bản thô ttl | Tải xuống


@prefix fhir: <http://hl7.org/fhir/> .
@prefix owl: <http://www.w3.org/2002/07/owl#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

# - resource -------------------------------------------------------------------

<http://hl7.org/fhir/CodeSystem/vn-insurance-visit-type-cs> a fhir:CodeSystem ;
  fhir:nodeRole fhir:treeRoot ;
  fhir:Resource.id [ fhir:value "vn-insurance-visit-type-cs"] ;
  fhir:Resource.language [ fhir:value "vi"] ;
  fhir:DomainResource.text [
     fhir:Narrative.status [ fhir:value "generated" ] ;
     fhir:Narrative.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>"
  ] ;
  fhir:DomainResource.extension [
     fhir:index -1 ;
     fhir:Extension.url [ fhir:value "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis" ] ;
     fhir:Extension.valueCoding [
       fhir:Coding.system [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs" ] ;
       fhir:Coding.code [ fhir:value "QD-4210-BYT" ]
     ]
  ] ;
  fhir:CodeSystem.url [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-insurance-visit-type-cs"] ;
  fhir:CodeSystem.identifier [
     fhir:index -1 ;
     fhir:Identifier.system [ fhir:value "urn:ietf:rfc:3986" ] ;
     fhir:Identifier.value [ fhir:value "urn:oid:2.25.161089673617632664299011809196868855799.16.50" ]
  ] ;
  fhir:CodeSystem.version [ fhir:value "0.9.0"] ;
  fhir:CodeSystem.name [ fhir:value "VNInsuranceVisitTypeCS"] ;
  fhir:CodeSystem.title [ fhir:value "Loại khám chữa bệnh BHYT — Vietnam Insurance Visit Type CodeSystem"] ;
  fhir:CodeSystem.status [ fhir:value "active"] ;
  fhir:CodeSystem.experimental [ fhir:value "false"^^xsd:boolean] ;
  fhir:CodeSystem.date [ fhir:value "2026-07-19"^^xsd:date] ;
  fhir:CodeSystem.publisher [ fhir:value "Omi HealthTech / VN Core FHIR Community Initiative"] ;
  fhir:CodeSystem.contact [
     fhir:index -1 ;
     fhir:ContactDetail.name [ fhir:value "Omi HealthTech / VN Core FHIR Community Initiative" ] ;
     fhir:ContactDetail.telecom [
       fhir:index -1 ;
       fhir:ContactPoint.system [ fhir:value "url" ] ;
       fhir:ContactPoint.value [ fhir:value "https://hl7.org.vn" ]
     ], [
       fhir:index -1 ;
       fhir:ContactPoint.system [ fhir:value "email" ] ;
       fhir:ContactPoint.value [ fhir:value "[email protected]" ]
     ]
  ], [
     fhir:index -1 ;
     fhir:ContactDetail.name [ fhir:value "Omi HealthTech (OmiGroup)" ] ;
     fhir:ContactDetail.telecom [
       fhir:index -1 ;
       fhir:ContactPoint.system [ fhir:value "url" ] ;
       fhir:ContactPoint.value [ fhir:value "https://omihealthtech.vn" ]
     ], [
       fhir:index -1 ;
       fhir:ContactPoint.system [ fhir:value "url" ] ;
       fhir:ContactPoint.value [ fhir:value "https://omigroup.vn" ]
     ], [
       fhir:index -1 ;
       fhir:ContactPoint.system [ fhir:value "email" ] ;
       fhir:ContactPoint.value [ fhir:value "[email protected]" ]
     ]
  ] ;
  fhir:CodeSystem.description [ fhir: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.\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)."] ;
  fhir:CodeSystem.jurisdiction [
     fhir:index -1 ;
     fhir:CodeableConcept.coding [
       fhir:index -1 ;
       fhir:Coding.system [ fhir:value "urn:iso:std:iso:3166" ] ;
       fhir:Coding.code [ fhir:value "VN" ] ;
       fhir:Coding.display [ fhir:value "Viet Nam" ]
     ]
  ] ;
  fhir:CodeSystem.copyright [ fhir: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."] ;
  fhir:CodeSystem.caseSensitive [ fhir:value "true"^^xsd:boolean] ;
  fhir:CodeSystem.content [ fhir:value "complete"] ;
  fhir:CodeSystem.count [ fhir:value "5"^^xsd:nonNegativeInteger] ;
  fhir:CodeSystem.property [
     fhir:index -1 ;
     fhir:CodeSystem.property.code [ fhir:value "codeSource" ] ;
     fhir:CodeSystem.property.uri [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-insurance-visit-type-cs#codeSource" ] ;
     fhir:CodeSystem.property.description [ fhir: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)." ] ;
     fhir:CodeSystem.property.type [ fhir:value "code" ]
  ], [
     fhir:index -1 ;
     fhir:CodeSystem.property.code [ fhir:value "status" ] ;
     fhir:CodeSystem.property.uri [ fhir:value "http://hl7.org/fhir/concept-properties#status" ] ;
     fhir:CodeSystem.property.description [ fhir:value "Trạng thái mã (active | deprecated)." ] ;
     fhir:CodeSystem.property.type [ fhir:value "code" ]
  ] ;
  fhir:CodeSystem.concept [
     fhir:index -1 ;
     fhir:CodeSystem.concept.code [ fhir:value "1" ] ;
     fhir:CodeSystem.concept.display [ fhir:value "Đúng tuyến" ] ;
     fhir:CodeSystem.concept.definition [ fhir:value "KCB đúng tuyến — mã legacy MA_LYDO_VVIEN = 1 theo QĐ 4210/QĐ-BYT (2017)." ] ;
     fhir:CodeSystem.concept.designation [
       fhir:index -1 ;
       fhir:CodeSystem.concept.designation.language [ fhir:value "en" ] ;
       fhir:CodeSystem.concept.designation.value [ fhir:value "In-network referral" ]
     ] ;
     fhir:CodeSystem.concept.property [
       fhir:index -1 ;
       fhir:CodeSystem.concept.property.code [ fhir:value "codeSource" ] ;
       fhir:CodeSystem.concept.property.valueCode [ fhir:value "statutory" ]
     ]
  ], [
     fhir:index -1 ;
     fhir:CodeSystem.concept.code [ fhir:value "2" ] ;
     fhir:CodeSystem.concept.display [ fhir:value "Cấp cứu" ] ;
     fhir:CodeSystem.concept.definition [ fhir:value "KCB cấp cứu — mã legacy MA_LYDO_VVIEN = 2 theo QĐ 4210/QĐ-BYT (2017)." ] ;
     fhir:CodeSystem.concept.designation [
       fhir:index -1 ;
       fhir:CodeSystem.concept.designation.language [ fhir:value "en" ] ;
       fhir:CodeSystem.concept.designation.value [ fhir:value "Emergency" ]
     ] ;
     fhir:CodeSystem.concept.property [
       fhir:index -1 ;
       fhir:CodeSystem.concept.property.code [ fhir:value "codeSource" ] ;
       fhir:CodeSystem.concept.property.valueCode [ fhir:value "statutory" ]
     ]
  ], [
     fhir:index -1 ;
     fhir:CodeSystem.concept.code [ fhir:value "3" ] ;
     fhir:CodeSystem.concept.display [ fhir:value "Trái tuyến" ] ;
     fhir:CodeSystem.concept.definition [ fhir:value "KCB trái tuyến — mã legacy MA_LYDO_VVIEN = 3 theo QĐ 4210/QĐ-BYT (2017)." ] ;
     fhir:CodeSystem.concept.designation [
       fhir:index -1 ;
       fhir:CodeSystem.concept.designation.language [ fhir:value "en" ] ;
       fhir:CodeSystem.concept.designation.value [ fhir:value "Out-of-network" ]
     ] ;
     fhir:CodeSystem.concept.property [
       fhir:index -1 ;
       fhir:CodeSystem.concept.property.code [ fhir:value "codeSource" ] ;
       fhir:CodeSystem.concept.property.valueCode [ fhir:value "statutory" ]
     ]
  ], [
     fhir:index -1 ;
     fhir:CodeSystem.concept.code [ fhir:value "4" ] ;
     fhir:CodeSystem.concept.display [ fhir:value "Thông tuyến" ] ;
     fhir:CodeSystem.concept.definition [ fhir:value "KCB thông tuyến — mã legacy MA_LYDO_VVIEN = 4 theo QĐ 4210/QĐ-BYT (2017)." ] ;
     fhir:CodeSystem.concept.designation [
       fhir:index -1 ;
       fhir:CodeSystem.concept.designation.language [ fhir:value "en" ] ;
       fhir:CodeSystem.concept.designation.value [ fhir:value "Cross-network" ]
     ] ;
     fhir:CodeSystem.concept.property [
       fhir:index -1 ;
       fhir:CodeSystem.concept.property.code [ fhir:value "codeSource" ] ;
       fhir:CodeSystem.concept.property.valueCode [ fhir:value "statutory" ]
     ]
  ], [
     fhir:index -1 ;
     fhir:CodeSystem.concept.code [ fhir:value "5" ] ;
     fhir:CodeSystem.concept.display [ fhir:value "Khám chữa bệnh ban đầu" ] ;
     fhir:CodeSystem.concept.definition [ fhir: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." ] ;
     fhir:CodeSystem.concept.designation [
       fhir:index -1 ;
       fhir:CodeSystem.concept.designation.language [ fhir:value "en" ] ;
       fhir:CodeSystem.concept.designation.value [ fhir:value "Primary care visit (project-assigned)" ]
     ] ;
     fhir:CodeSystem.concept.property [
       fhir:index -1 ;
       fhir:CodeSystem.concept.property.code [ fhir:value "codeSource" ] ;
       fhir:CodeSystem.concept.property.valueCode [ fhir:value "project-assigned" ]
     ], [
       fhir:index -1 ;
       fhir:CodeSystem.concept.property.code [ fhir:value "status" ] ;
       fhir:CodeSystem.concept.property.valueCode [ fhir:value "deprecated" ]
     ]
  ] .

# - ontology header ------------------------------------------------------------

<http://hl7.org/fhir/CodeSystem/vn-insurance-visit-type-cs.ttl> a owl:Ontology ;
  owl:imports fhir:fhir.ttl ;
  owl:versionIRI <http://build.fhir.org/CodeSystem/vn-insurance-visit-type-cs.ttl> .