# Mã lượt khám — Encounter Code Extension - Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam v0.5.0

## Phần mở rộng: Mã lượt khám — Encounter Code Extension 

Mã lượt khám chữa bệnh (trường MA_LUOT_KCB per QĐ 3176/QĐ-BYT). Được mô hình hóa như Identifier để giữ nhất quán `system` / `value` / `type` khi đối soát BHXH. Khác với Encounter.identifier — MA_LUOT_KCB là mã nội bộ cho từng lượt khám và dùng NamingSystem khuyến nghị riêng.

**Context of Use**

**Usage info**

**Usages:**

* Use this Extension: [Lượt khám/nhập viện VN Core — VN Core Encounter Profile](StructureDefinition-vn-core-encounter.md)
* Examples for this Extension: [Bundle/ExampleBundleEPrescription](Bundle-ExampleBundleEPrescription.md), [Bundle/ExampleBundleInpatientDischarge](Bundle-ExampleBundleInpatientDischarge.md), [Bundle/ExampleBundleLabOrderResult](Bundle-ExampleBundleLabOrderResult.md), [Bundle/ExampleBundleOutpatientBHYT](Bundle-ExampleBundleOutpatientBHYT.md)... Show 6 more, [Bundle/ExampleBundleReferralUpward](Bundle-ExampleBundleReferralUpward.md), [Bundle/ExampleBundleYHCTFullVisit](Bundle-ExampleBundleYHCTFullVisit.md), [Encounter/ExampleEncounterEmergency](Encounter-ExampleEncounterEmergency.md), [Encounter/ExampleEncounterEnteredInError](Encounter-ExampleEncounterEnteredInError.md), [Encounter/ExampleEncounterTelehealth](Encounter-ExampleEncounterTelehealth.md) and [Encounter/ExampleEncounterYHCT](Encounter-ExampleEncounterYHCT.md)

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

### Các dạng xem hình thức của nội dung phần mở rộng

 [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 Differential](#tabs-diff) 
*  [Bảng Snapshot](#tabs-snap) 
*  [Thống kê/Tham chiếu](#tabs-summ) 
*  [Tất cả](#tabs-all) 

#### Terminology Bindings

#### Constraints

** Summary **

Simple Extension with the type Identifier: Mã lượt khám chữa bệnh (trường MA_LUOT_KCB per QĐ 3176/QĐ-BYT). Được mô hình hóa như Identifier để giữ nhất quán `system` / `value` / `type` khi đối soát BHXH. Khác với Encounter.identifier — MA_LUOT_KCB là mã nội bộ cho từng lượt khám và dùng NamingSystem khuyến nghị riêng.

 **Dạng xem DifferentialDifferential View** 

 **Dạng xem Snapshot** 

#### Terminology Bindings

#### Constraints

** Summary **

Simple Extension with the type Identifier: Mã lượt khám chữa bệnh (trường MA_LUOT_KCB per QĐ 3176/QĐ-BYT). Được mô hình hóa như Identifier để giữ nhất quán `system` / `value` / `type` khi đối soát BHXH. Khác với Encounter.identifier — MA_LUOT_KCB là mã nội bộ cho từng lượt khám và dùng NamingSystem khuyến nghị riêng.

 

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



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "vn-ext-encounter-code",
  "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-encounter-code",
  "version" : "0.5.0",
  "name" : "VNCoreExtEncounterCode",
  "title" : "Mã lượt khám — Encounter Code Extension",
  "status" : "draft",
  "date" : "2026-03-22",
  "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" : "Mã lượt khám chữa bệnh (trường MA_LUOT_KCB per QĐ 3176/QĐ-BYT).\nĐược mô hình hóa như Identifier để giữ nhất quán `system` / `value` / `type` khi đối soát BHXH.\nKhác với Encounter.identifier — MA_LUOT_KCB là mã nội bộ cho từng lượt khám và dùng NamingSystem khuyến nghị riêng.",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "urn:iso:std:iso:3166",
      "code" : "VN",
      "display" : "Viet Nam"
    }]
  }],
  "fhirVersion" : "4.0.1",
  "mapping" : [{
    "identity" : "rim",
    "uri" : "http://hl7.org/v3",
    "name" : "RIM Mapping"
  }],
  "kind" : "complex-type",
  "abstract" : false,
  "context" : [{
    "type" : "element",
    "expression" : "Encounter"
  }],
  "type" : "Extension",
  "baseDefinition" : "http://hl7.org/fhir/StructureDefinition/Extension",
  "derivation" : "constraint",
  "differential" : {
    "element" : [{
      "id" : "Extension",
      "path" : "Extension",
      "short" : "Mã lượt khám — Encounter Code Extension",
      "definition" : "Mã lượt khám chữa bệnh (trường MA_LUOT_KCB per QĐ 3176/QĐ-BYT).\nĐược mô hình hóa như Identifier để giữ nhất quán `system` / `value` / `type` khi đối soát BHXH.\nKhác với Encounter.identifier — MA_LUOT_KCB là mã nội bộ cho từng lượt khám và dùng NamingSystem khuyến nghị riêng."
    },
    {
      "id" : "Extension.extension",
      "path" : "Extension.extension",
      "max" : "0"
    },
    {
      "id" : "Extension.url",
      "path" : "Extension.url",
      "fixedUri" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-encounter-code"
    },
    {
      "id" : "Extension.value[x]",
      "path" : "Extension.value[x]",
      "short" : "Mã lượt khám MA_LUOT_KCB dưới dạng Identifier",
      "definition" : "Mã định danh lượt khám tại CSKCB — dùng cho liên thông dữ liệu BHXH. Nên dùng `system = http://fhir.hl7.org.vn/core/sid/ma-luot-kcb` và `type = MA_LUOT_KCB`.",
      "type" : [{
        "code" : "Identifier"
      }]
    },
    {
      "id" : "Extension.value[x].type",
      "path" : "Extension.value[x].type",
      "short" : "Loại định danh cố định cho MA_LUOT_KCB",
      "min" : 1,
      "patternCodeableConcept" : {
        "coding" : [{
          "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs",
          "code" : "MA_LUOT_KCB",
          "display" : "Mã lượt khám chữa bệnh"
        }]
      }
    },
    {
      "id" : "Extension.value[x].system",
      "path" : "Extension.value[x].system",
      "short" : "NamingSystem khuyến nghị cho MA_LUOT_KCB",
      "min" : 1,
      "fixedUri" : "http://fhir.hl7.org.vn/core/sid/ma-luot-kcb"
    },
    {
      "id" : "Extension.value[x].value",
      "path" : "Extension.value[x].value",
      "short" : "Giá trị MA_LUOT_KCB do cơ sở KCB phát sinh",
      "min" : 1
    }]
  }
}

```
