# Lượt khám/nhập viện VN Core — VN Core Encounter Profile - Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam v0.5.0

## Hồ sơ tài nguyên: Lượt khám/nhập viện VN Core — VN Core Encounter Profile 

 
Profile Encounter cho Việt Nam. Bao gồm extension loại KCB BHYT (trường MALYDO), thông tin chẩn đoán, cơ sở y tế, và kết quả điều trị/tình trạng ra viện. Căn cứ: 
* **NĐ 102/2025/NĐ-CP** — 13/5/2025 — quản lý dữ liệu y tế số và CSDL quốc gia về y tế
* **TT 13/2025/TT-BYT** — 06/6/2025 — bệnh án điện tử
* **TT 30/2023/TT-BYT** — 30/12/2023 — khám bệnh, chữa bệnh từ xa khi Encounter.class = VR/virtual
* **Luật 51/2024/QH15** — 27/11/2024 — sửa đổi Luật BHYT, hiệu lực 01/7/2025
* **QĐ 130/QĐ-BYT** — 18/01/2023; **QĐ 4750/QĐ-BYT** — 29/12/2023; **QĐ 3176/QĐ-BYT** — 29/10/2024 — chuẩn dữ liệu KCB phục vụ BHXH.
 

**Usages:**

* Refer to this Profile: [Dị ứng/Bất dung nạp VN Core — VN Core AllergyIntolerance Profile](StructureDefinition-vn-core-allergy-intolerance.md), [Bệnh án điện tử VN Core — VN Core Composition Profile](StructureDefinition-vn-core-composition.md), [Chẩn đoán VN Core — VN Core Condition Profile](StructureDefinition-vn-core-condition.md), [Báo cáo cận lâm sàng VN Core — VN Core DiagnosticReport Profile](StructureDefinition-vn-core-diagnostic-report.md)... Show 8 more, [Tài liệu y tế VN Core — VN Core DocumentReference Profile](StructureDefinition-vn-core-document-reference.md), [Tiêm chủng — VN Core Immunization](StructureDefinition-vn-core-immunization.md), [Cấp phát thuốc VN Core — VN Core Medication Dispense Profile](StructureDefinition-vn-core-medication-dispense.md), [Đơn thuốc VN Core — VN Core MedicationRequest Profile](StructureDefinition-vn-core-medication-request.md), [Xét nghiệm VN Core — VN Core Observation Laboratory Profile](StructureDefinition-vn-core-observation-lab.md), [Đánh giá YHCT VN Core — VN Core Observation Traditional Medicine Profile](StructureDefinition-vn-core-observation-yhct.md), [Thủ thuật/DVKT VN Core — VN Core Procedure Profile](StructureDefinition-vn-core-procedure.md) and [Yêu cầu DVKT/Cận lâm sàng VN Core — VN Core ServiceRequest Profile](StructureDefinition-vn-core-service-request.md)
* Examples for this Profile: [Encounter/ExampleEncounterEmergency](Encounter-ExampleEncounterEmergency.md), [Encounter/ExampleEncounterEnteredInError](Encounter-ExampleEncounterEnteredInError.md), [Encounter/ExampleEncounterInpatient](Encounter-ExampleEncounterInpatient.md), [Encounter/ExampleEncounterOutpatient](Encounter-ExampleEncounterOutpatient.md)... Show 2 more, [Encounter/ExampleEncounterTelehealth](Encounter-ExampleEncounterTelehealth.md) and [Encounter/ExampleEncounterYHCT](Encounter-ExampleEncounterYHCT.md)
* CapabilityStatements using this Profile: [VN Core EMR Server CapabilityStatement](CapabilityStatement-vn-core-emr-server.md) and [VN Core Server CapabilityStatement](CapabilityStatement-vn-core-server.md)

You can also check for [usages in the FHIR IG Statistics](https://packages2.fhir.org/xig/hl7.fhir.vn.core|current/StructureDefinition/vn-core-encounter)

### Các dạng xem hình thức của nội dung hồ sơ

 [Mô tả profile, differential, snapshot và các biểu diễn liên quan](http://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#structure-definitions). 

*  [Bảng phần tử chính](#tabs-key) 
*  [Bảng Differential](#tabs-diff) 
*  [Bảng Snapshot](#tabs-snap) 
*  [Thống kê/Tham chiếu](#tabs-summ) 
*  [Tất cả](#tabs-all) 

#### Terminology Bindings

#### Constraints

#### Terminology Bindings (Differential)

#### Terminology Bindings

#### Constraints

** Summary **

Mandatory: 1 element
 Must-Support: 14 elements

**Structures**

This structure refers to these other structures:

* [Bệnh nhân VN Core — VN Core Patient Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient)](StructureDefinition-vn-core-patient.md)
* [Nhân viên y tế VN Core — VN Core Practitioner Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner)](StructureDefinition-vn-core-practitioner.md)
* [Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner-role)](StructureDefinition-vn-core-practitioner-role.md)
* [Chẩn đoán VN Core — VN Core Condition Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-condition)](StructureDefinition-vn-core-condition.md)
* [Cơ sở y tế VN Core — VN Core Organization Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization)](StructureDefinition-vn-core-organization.md)

**Extensions**

This structure refers to these extensions:

* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-visit-type](StructureDefinition-vn-ext-insurance-visit-type.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-referral-mode](StructureDefinition-vn-ext-referral-mode.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-encounter-code](StructureDefinition-vn-ext-encounter-code.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-treatment-outcome](StructureDefinition-vn-ext-treatment-outcome.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-method](StructureDefinition-vn-ext-payment-method.md)

 **Dạng xem phần tử chính** 

#### Terminology Bindings

#### Constraints

 **Dạng xem Differential** 

#### Terminology Bindings (Differential)

 **Dạng xem SnapshotView** 

#### Terminology Bindings

#### Constraints

** Summary **

Mandatory: 1 element
 Must-Support: 14 elements

**Structures**

This structure refers to these other structures:

* [Bệnh nhân VN Core — VN Core Patient Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient)](StructureDefinition-vn-core-patient.md)
* [Nhân viên y tế VN Core — VN Core Practitioner Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner)](StructureDefinition-vn-core-practitioner.md)
* [Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner-role)](StructureDefinition-vn-core-practitioner-role.md)
* [Chẩn đoán VN Core — VN Core Condition Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-condition)](StructureDefinition-vn-core-condition.md)
* [Cơ sở y tế VN Core — VN Core Organization Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization)](StructureDefinition-vn-core-organization.md)

**Extensions**

This structure refers to these extensions:

* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-visit-type](StructureDefinition-vn-ext-insurance-visit-type.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-referral-mode](StructureDefinition-vn-ext-referral-mode.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-encounter-code](StructureDefinition-vn-ext-encounter-code.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-treatment-outcome](StructureDefinition-vn-ext-treatment-outcome.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-method](StructureDefinition-vn-ext-payment-method.md)

 

Biểu diễn khác của hồ sơ: [CSV](../StructureDefinition-vn-core-encounter.csv), [Excel](../StructureDefinition-vn-core-encounter.xlsx), [Schematron](../StructureDefinition-vn-core-encounter.sch) 



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "vn-core-encounter",
  "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-encounter",
  "version" : "0.5.0",
  "name" : "VNCoreEncounter",
  "title" : "Lượt khám/nhập viện VN Core — VN Core Encounter Profile",
  "status" : "draft",
  "date" : "2026-03-21",
  "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" : "info@hl7.org.vn"
    }]
  },
  {
    "name" : "Omi HealthTech (OmiGroup)",
    "telecom" : [{
      "system" : "url",
      "value" : "https://omihealthtech.vn"
    },
    {
      "system" : "url",
      "value" : "https://omigroup.vn"
    },
    {
      "system" : "email",
      "value" : "healthtech@omigroup.vn"
    }]
  }],
  "description" : "Profile Encounter cho Việt Nam. Bao gồm extension loại KCB BHYT (trường MALYDO),\nthông tin chẩn đoán, cơ sở y tế, và kết quả điều trị/tình trạng ra viện.\nCăn cứ:\n- **NĐ 102/2025/NĐ-CP** — 13/5/2025 — quản lý dữ liệu y tế số và CSDL quốc gia về y tế\n- **TT 13/2025/TT-BYT** — 06/6/2025 — bệnh án điện tử\n- **TT 30/2023/TT-BYT** — 30/12/2023 — khám bệnh, chữa bệnh từ xa khi Encounter.class = VR/virtual\n- **Luật 51/2024/QH15** — 27/11/2024 — sửa đổi Luật BHYT, hiệu lực 01/7/2025\n- **QĐ 130/QĐ-BYT** — 18/01/2023; **QĐ 4750/QĐ-BYT** — 29/12/2023; **QĐ 3176/QĐ-BYT** — 29/10/2024 — chuẩn dữ liệu KCB phục vụ BHXH.",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "urn:iso:std:iso:3166",
      "code" : "VN",
      "display" : "Viet Nam"
    }]
  }],
  "fhirVersion" : "4.0.1",
  "mapping" : [{
    "identity" : "workflow",
    "uri" : "http://hl7.org/fhir/workflow",
    "name" : "Workflow Pattern"
  },
  {
    "identity" : "rim",
    "uri" : "http://hl7.org/v3",
    "name" : "RIM Mapping"
  },
  {
    "identity" : "w5",
    "uri" : "http://hl7.org/fhir/fivews",
    "name" : "FiveWs Pattern Mapping"
  },
  {
    "identity" : "v2",
    "uri" : "http://hl7.org/v2",
    "name" : "HL7 v2 Mapping"
  }],
  "kind" : "resource",
  "abstract" : false,
  "type" : "Encounter",
  "baseDefinition" : "http://hl7.org/fhir/StructureDefinition/Encounter",
  "derivation" : "constraint",
  "differential" : {
    "element" : [{
      "id" : "Encounter",
      "path" : "Encounter"
    },
    {
      "id" : "Encounter.extension",
      "path" : "Encounter.extension",
      "slicing" : {
        "discriminator" : [{
          "type" : "value",
          "path" : "url"
        }],
        "ordered" : false,
        "rules" : "open"
      }
    },
    {
      "id" : "Encounter.extension:insuranceVisitType",
      "path" : "Encounter.extension",
      "sliceName" : "insuranceVisitType",
      "short" : "Loại KCB BHYT — trường MALYDO (đúng tuyến, trái tuyến, thông tuyến, cấp cứu, KCB ban đầu)",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-visit-type"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Encounter.extension:referralMode",
      "path" : "Encounter.extension",
      "sliceName" : "referralMode",
      "short" : "Hình thức chuyển tuyến — trường HTCHUYEN (tự đến, chuyển lên, chuyển xuống, cùng tuyến, cấp cứu)",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-referral-mode"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Encounter.extension:encounterCode",
      "path" : "Encounter.extension",
      "sliceName" : "encounterCode",
      "short" : "Mã lượt khám — trường MA_LUOT_KCB dưới dạng Identifier có system riêng",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-encounter-code"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Encounter.extension:treatmentOutcome",
      "path" : "Encounter.extension",
      "sliceName" : "treatmentOutcome",
      "short" : "Kết quả điều trị — trường KETQUA (khỏi, đỡ, không thay đổi, nặng hơn, tử vong)",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-treatment-outcome"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Encounter.extension:paymentMethod",
      "path" : "Encounter.extension",
      "sliceName" : "paymentMethod",
      "short" : "Phương thức thanh toán BHYT (FFS/Capitation/DRG) — trường MA_PTTT_QT",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-method"]
      }]
    },
    {
      "id" : "Encounter.status",
      "path" : "Encounter.status",
      "short" : "Trạng thái lượt khám",
      "mustSupport" : true
    },
    {
      "id" : "Encounter.class",
      "path" : "Encounter.class",
      "short" : "Loại hình KCB: AMB (ngoại trú), IMP (nội trú), EMER (cấp cứu), VR (khám từ xa)",
      "definition" : "Loại hình encounter theo v3-ActCode. Khi dùng VR/virtual cho khám từ xa, tham chiếu TT 30/2023/TT-BYT; thanh toán BHYT cần theo hướng dẫn riêng hiện hành.",
      "mustSupport" : true
    },
    {
      "id" : "Encounter.type",
      "path" : "Encounter.type",
      "short" : "Loại KCB (MA_LOAI_KCB): 01=khám, 02=ngoại trú, 03=nội trú, 04=nội trú ban ngày...",
      "definition" : "Loại khám chữa bệnh theo trường MA_LOAI_KCB. Đây là nơi biểu diễn mã 01-10 trong dữ liệu đầu ra KCB/BHYT; không dùng Claim.type để chứa MA_LOAI_KCB.",
      "mustSupport" : true,
      "binding" : {
        "strength" : "extensible",
        "valueSet" : "http://fhir.hl7.org.vn/core/ValueSet/vn-encounter-type-vs"
      }
    },
    {
      "id" : "Encounter.subject",
      "path" : "Encounter.subject",
      "short" : "Bệnh nhân",
      "min" : 1,
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Encounter.participant",
      "path" : "Encounter.participant",
      "short" : "Bác sĩ/NVYT tham gia"
    },
    {
      "id" : "Encounter.participant.individual",
      "path" : "Encounter.participant.individual",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner",
        "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner-role"]
      }]
    },
    {
      "id" : "Encounter.period",
      "path" : "Encounter.period",
      "short" : "Thời gian khám/nhập viện",
      "mustSupport" : true
    },
    {
      "id" : "Encounter.reasonCode",
      "path" : "Encounter.reasonCode",
      "short" : "Lý do đến khám/chief complaint",
      "definition" : "Lý do người bệnh đến khám, nhập viện hoặc yêu cầu dịch vụ. Nên mã hóa khi có thể; cho phép ghi text mô tả chief complaint tại thời điểm tiếp nhận.",
      "mustSupport" : true,
      "binding" : {
        "strength" : "extensible",
        "valueSet" : "http://fhir.hl7.org.vn/core/ValueSet/vn-condition-code-vs"
      }
    },
    {
      "id" : "Encounter.reasonCode.text",
      "path" : "Encounter.reasonCode.text",
      "short" : "Diễn giải tự do của lý do đến khám",
      "mustSupport" : true
    },
    {
      "id" : "Encounter.diagnosis",
      "path" : "Encounter.diagnosis",
      "short" : "Chẩn đoán",
      "mustSupport" : true
    },
    {
      "id" : "Encounter.diagnosis.condition",
      "path" : "Encounter.diagnosis.condition",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-condition"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Encounter.diagnosis.use",
      "path" : "Encounter.diagnosis.use",
      "short" : "Loại chẩn đoán (chính, phụ, nhập viện, ra viện)"
    },
    {
      "id" : "Encounter.hospitalization",
      "path" : "Encounter.hospitalization",
      "short" : "Thông tin nhập viện/ra viện"
    },
    {
      "id" : "Encounter.hospitalization.dischargeDisposition",
      "path" : "Encounter.hospitalization.dischargeDisposition",
      "short" : "Tình trạng ra viện",
      "binding" : {
        "strength" : "extensible",
        "valueSet" : "http://fhir.hl7.org.vn/core/ValueSet/vn-discharge-disposition-vs"
      }
    },
    {
      "id" : "Encounter.serviceProvider",
      "path" : "Encounter.serviceProvider",
      "short" : "Cơ sở KCB",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization"]
      }],
      "mustSupport" : true
    }]
  }
}

```
