# Cơ sở y tế VN Core — VN Core Organization Profile - Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam v0.5.0

## Hồ sơ tài nguyên: Cơ sở y tế VN Core — VN Core Organization Profile 

 
Profile Organization cho cơ sở y tế Việt Nam. Bao gồm identifier mã CSKCB, extensions loại hình/cấp quản lý/phân hạng/cấp KCB hiện hành, và địa chỉ theo VNCoreAddress. Căn cứ: 
* **Luật KCB 2023** — Điều 47-48 — hình thức tổ chức cơ sở KCB
* **NĐ 96/2023/NĐ-CP** — 30/12/2023 — hướng dẫn Luật KCB
* **NĐ 102/2025/NĐ-CP** — 13/5/2025 — CSDL quốc gia về y tế, dữ liệu cơ sở y tế
* **QĐ 11/2026/QĐ-TTg** — 28/3/2026 — danh mục CSDL quốc gia, bao gồm CSDL quốc gia về y tế
* **TT 06/2024/TT-BYT** — 16/5/2024 — phân hạng cơ sở KCB
* **TT 35/2024/TT-BYT** — 16/11/2024 — tiêu chuẩn chất lượng cơ bản đối với bệnh viện.
 

**Usages:**

* Refer to this Profile: [Kết quả giải quyết BHYT VN Core — VN Core ClaimResponse Profile](StructureDefinition-vn-core-claim-response.md), [Yêu cầu thanh toán KCB VN Core — VN Core Claim Profile](StructureDefinition-vn-core-claim.md), [Thông báo vi phạm DLCN (Mẫu 08) — VN Core Breach Notification Composition Profile](StructureDefinition-vn-core-composition-breach-notification.md), [Bệnh án điện tử VN Core — VN Core Composition Profile](StructureDefinition-vn-core-composition.md)... Show 20 more, [Đồng ý xử lý dữ liệu VN Core — VN Core Consent Profile](StructureDefinition-vn-core-consent.md), [Báo cáo Chẩn đoán hình ảnh VN Core — VN Core Imaging DiagnosticReport](StructureDefinition-vn-core-diagnostic-report-imaging.md), [Báo cáo cận lâm sàng VN Core — VN Core DiagnosticReport Profile](StructureDefinition-vn-core-diagnostic-report.md), [Tài liệu y tế VN Core — VN Core DocumentReference Profile](StructureDefinition-vn-core-document-reference.md), [Lượt khám/nhập viện VN Core — VN Core Encounter Profile](StructureDefinition-vn-core-encounter.md), [Giải trình quyền lợi BHYT VN Core — VN Core ExplanationOfBenefit Profile](StructureDefinition-vn-core-explanation-of-benefit.md), [Dịch vụ y tế VN Core — VN Core HealthcareService Profile](StructureDefinition-vn-core-healthcare-service.md), [Tiêm chủng — VN Core Immunization](StructureDefinition-vn-core-immunization.md), [Địa điểm cung cấp dịch vụ VN Core — VN Core Location Profile](StructureDefinition-vn-core-location.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), [Khoa/Phòng VN Core — VN Core Organization Department Profile](StructureDefinition-vn-core-organization-department.md), [Quyết toán BHYT VN Core — VN Core Payment Reconciliation Profile](StructureDefinition-vn-core-payment-reconciliation.md), [Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile](StructureDefinition-vn-core-practitioner-role.md), [Thủ thuật/DVKT VN Core — VN Core Procedure Profile](StructureDefinition-vn-core-procedure.md), [Yêu cầu DVKT/Cận lâm sàng VN Core — VN Core ServiceRequest Profile](StructureDefinition-vn-core-service-request.md), [Nơi đăng ký KCB ban đầu — Vietnam Primary Care Facility Extension](StructureDefinition-vn-ext-primary-care-facility.md) and [Cơ quan hướng dẫn chuyên môn — Supervising Clinical Authority Extension](StructureDefinition-vn-ext-supervising-authority.md)
* Examples for this Profile: [Bảo hiểm xã hội Việt Nam](Organization-ExampleOrganizationBHXH.md), [Bệnh viện Chợ Rẫy](Organization-ExampleOrganizationChoRay.md), [Bệnh viện Đa khoa Gia Lâm](Organization-ExampleOrganizationLegacyTechnicalLine.md), [Trung tâm Kiểm soát bệnh tật tỉnh Quảng Ninh](Organization-ExampleOrganizationPreventiveCenter.md)... Show 4 more, [Phòng khám đa khoa Hoàng Long](Organization-ExampleOrganizationPrivateClinic.md), [Trung tâm Y tế khu vực An Phú](Organization-ExampleOrganizationTTYTHangIV.md), [Trạm Y tế phường Ngọc Hà](Organization-ExampleOrganizationTramYTe.md) and [Bệnh viện Bạch Mai](Organization-example-organization-bach-mai.md)
* CapabilityStatements using this Profile: [VN Core BHYT Gateway Client CapabilityStatement](CapabilityStatement-vn-core-bhyt-gateway-client.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-organization)

### 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

#### Constraints

** Summary **

Mandatory: 2 elements(4 nested mandatory elements)
 Must-Support: 11 elements
 Fixed: 2 elements

**Structures**

This structure refers to these other structures:

* [Địa chỉ VN Core — VN Core Address Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-address)](StructureDefinition-vn-core-address.md)

**Extensions**

This structure refers to these extensions:

* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-type](StructureDefinition-vn-ext-org-type.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-level](StructureDefinition-vn-ext-org-level.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-rank](StructureDefinition-vn-ext-org-rank.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-health-unit-rank](StructureDefinition-vn-ext-health-unit-rank.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-rank-status](StructureDefinition-vn-ext-org-rank-status.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-facility-care-level](StructureDefinition-vn-ext-facility-care-level.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legacy-technical-line](StructureDefinition-vn-ext-legacy-technical-line.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-quality-score-band](StructureDefinition-vn-ext-quality-score-band.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-supervising-authority](StructureDefinition-vn-ext-supervising-authority.md)

**Slices**

This structure defines the following [Slices](http://hl7.org/fhir/R4/profiling.html#slices):

* The element 1 is sliced based on the values of Organization.identifier

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

#### Terminology Bindings

#### Constraints

 **Dạng xem Differential** 

 **Dạng xem SnapshotView** 

#### Terminology Bindings

#### Constraints

** Summary **

Mandatory: 2 elements(4 nested mandatory elements)
 Must-Support: 11 elements
 Fixed: 2 elements

**Structures**

This structure refers to these other structures:

* [Địa chỉ VN Core — VN Core Address Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-address)](StructureDefinition-vn-core-address.md)

**Extensions**

This structure refers to these extensions:

* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-type](StructureDefinition-vn-ext-org-type.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-level](StructureDefinition-vn-ext-org-level.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-rank](StructureDefinition-vn-ext-org-rank.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-health-unit-rank](StructureDefinition-vn-ext-health-unit-rank.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-rank-status](StructureDefinition-vn-ext-org-rank-status.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-facility-care-level](StructureDefinition-vn-ext-facility-care-level.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legacy-technical-line](StructureDefinition-vn-ext-legacy-technical-line.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-quality-score-band](StructureDefinition-vn-ext-quality-score-band.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-supervising-authority](StructureDefinition-vn-ext-supervising-authority.md)

**Slices**

This structure defines the following [Slices](http://hl7.org/fhir/R4/profiling.html#slices):

* The element 1 is sliced based on the values of Organization.identifier

 

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



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "vn-core-organization",
  "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization",
  "version" : "0.5.0",
  "name" : "VNCoreOrganization",
  "title" : "Cơ sở y tế VN Core — VN Core Organization Profile",
  "status" : "draft",
  "date" : "2026-03-24",
  "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 Organization cho cơ sở y tế Việt Nam. Bao gồm identifier mã CSKCB,\nextensions loại hình/cấp quản lý/phân hạng/cấp KCB hiện hành, và địa chỉ theo VNCoreAddress.\nCăn cứ:\n- **Luật KCB 2023** — Điều 47-48 — hình thức tổ chức cơ sở KCB\n- **NĐ 96/2023/NĐ-CP** — 30/12/2023 — hướng dẫn Luật KCB\n- **NĐ 102/2025/NĐ-CP** — 13/5/2025 — CSDL quốc gia về y tế, dữ liệu cơ sở y tế\n- **QĐ 11/2026/QĐ-TTg** — 28/3/2026 — danh mục CSDL quốc gia, bao gồm CSDL quốc gia về y tế\n- **TT 06/2024/TT-BYT** — 16/5/2024 — phân hạng cơ sở KCB\n- **TT 35/2024/TT-BYT** — 16/11/2024 — tiêu chuẩn chất lượng cơ bản đối với bệnh viện.",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "urn:iso:std:iso:3166",
      "code" : "VN",
      "display" : "Viet Nam"
    }]
  }],
  "fhirVersion" : "4.0.1",
  "mapping" : [{
    "identity" : "v2",
    "uri" : "http://hl7.org/v2",
    "name" : "HL7 v2 Mapping"
  },
  {
    "identity" : "rim",
    "uri" : "http://hl7.org/v3",
    "name" : "RIM Mapping"
  },
  {
    "identity" : "servd",
    "uri" : "http://www.omg.org/spec/ServD/1.0/",
    "name" : "ServD"
  },
  {
    "identity" : "w5",
    "uri" : "http://hl7.org/fhir/fivews",
    "name" : "FiveWs Pattern Mapping"
  }],
  "kind" : "resource",
  "abstract" : false,
  "type" : "Organization",
  "baseDefinition" : "http://hl7.org/fhir/StructureDefinition/Organization",
  "derivation" : "constraint",
  "differential" : {
    "element" : [{
      "id" : "Organization",
      "path" : "Organization"
    },
    {
      "id" : "Organization.extension",
      "path" : "Organization.extension",
      "slicing" : {
        "discriminator" : [{
          "type" : "value",
          "path" : "url"
        }],
        "ordered" : false,
        "rules" : "open"
      }
    },
    {
      "id" : "Organization.extension:organizationType",
      "path" : "Organization.extension",
      "sliceName" : "organizationType",
      "short" : "Loại hình CSYT (BV, PK, TYT...)",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-type"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Organization.extension:organizationLevel",
      "path" : "Organization.extension",
      "sliceName" : "organizationLevel",
      "short" : "Cấp quản lý hành chính (TW, Tỉnh, Xã)",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-level"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Organization.extension:organizationRank",
      "path" : "Organization.extension",
      "sliceName" : "organizationRank",
      "short" : "Hạng pháp lý của cơ sở KCB (Đặc biệt, I, II, III)",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-rank"]
      }]
    },
    {
      "id" : "Organization.extension:healthUnitRank",
      "path" : "Organization.extension",
      "sliceName" : "healthUnitRank",
      "short" : "Hạng pháp lý của đơn vị y tế không phải cơ sở KCB (I-IV)",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-health-unit-rank"]
      }]
    },
    {
      "id" : "Organization.extension:organizationRankStatus",
      "path" : "Organization.extension",
      "sliceName" : "organizationRankStatus",
      "short" : "Tình trạng xếp hạng (đã xếp, chưa xếp, không áp dụng)",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-rank-status"]
      }]
    },
    {
      "id" : "Organization.extension:facilityCareLevel",
      "path" : "Organization.extension",
      "sliceName" : "facilityCareLevel",
      "short" : "Cấp KCB hiện hành (ban đầu, cơ bản, chuyên sâu)",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-facility-care-level"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Organization.extension:legacyTechnicalLine",
      "path" : "Organization.extension",
      "sliceName" : "legacyTechnicalLine",
      "short" : "Tuyến chuyên môn kỹ thuật lịch sử theo TT 43/2013 (legacy)",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legacy-technical-line"]
      }]
    },
    {
      "id" : "Organization.extension:qualityScoreBand",
      "path" : "Organization.extension",
      "sliceName" : "qualityScoreBand",
      "short" : "Dải điểm chất lượng phục vụ xác định quyền lợi BHYT",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-quality-score-band"]
      }]
    },
    {
      "id" : "Organization.extension:supervisingAuthority",
      "path" : "Organization.extension",
      "sliceName" : "supervisingAuthority",
      "short" : "Cơ quan hướng dẫn chuyên môn (vd: Sở Y tế đối với TYT cấp xã)",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-supervising-authority"]
      }]
    },
    {
      "id" : "Organization.identifier",
      "path" : "Organization.identifier",
      "slicing" : {
        "discriminator" : [{
          "type" : "value",
          "path" : "system"
        }],
        "rules" : "open"
      },
      "short" : "Định danh CSYT (mã CSKCB hoặc mã quản lý hợp lệ khác)",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "Organization.identifier:CSKCB",
      "path" : "Organization.identifier",
      "sliceName" : "CSKCB",
      "short" : "Mã CSKCB (5 chữ số)",
      "definition" : "Mã cơ sở khám chữa bệnh do BHXH Việt Nam cấp — 5 chữ số. Slice này chỉ áp dụng khi cơ sở có mã CSKCB.",
      "min" : 0,
      "max" : "1",
      "mustSupport" : true
    },
    {
      "id" : "Organization.identifier:CSKCB.type",
      "path" : "Organization.identifier.type",
      "patternCodeableConcept" : {
        "coding" : [{
          "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs",
          "code" : "CSKCB"
        }]
      }
    },
    {
      "id" : "Organization.identifier:CSKCB.system",
      "path" : "Organization.identifier.system",
      "min" : 1,
      "fixedUri" : "http://fhir.hl7.org.vn/core/sid/ma-cskcb"
    },
    {
      "id" : "Organization.identifier:CSKCB.value",
      "path" : "Organization.identifier.value",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "Organization.identifier:Local",
      "path" : "Organization.identifier",
      "sliceName" : "Local",
      "short" : "Mã quản lý cục bộ của đơn vị",
      "definition" : "Mã quản lý cục bộ do đơn vị tự cấp, dùng cho cơ sở hoặc đơn vị y tế chưa có hoặc không dùng mã CSKCB trong ngữ cảnh đang trao đổi.",
      "min" : 0,
      "max" : "*",
      "mustSupport" : true
    },
    {
      "id" : "Organization.identifier:Local.system",
      "path" : "Organization.identifier.system",
      "min" : 1,
      "fixedUri" : "http://fhir.hl7.org.vn/core/sid/organization-local-id"
    },
    {
      "id" : "Organization.identifier:Local.value",
      "path" : "Organization.identifier.value",
      "min" : 1
    },
    {
      "id" : "Organization.active",
      "path" : "Organization.active",
      "short" : "Đang hoạt động",
      "mustSupport" : true
    },
    {
      "id" : "Organization.type",
      "path" : "Organization.type",
      "short" : "Loại tổ chức (FHIR base)"
    },
    {
      "id" : "Organization.name",
      "path" : "Organization.name",
      "short" : "Tên cơ sở y tế",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "Organization.telecom",
      "path" : "Organization.telecom",
      "short" : "SĐT, email, website"
    },
    {
      "id" : "Organization.address",
      "path" : "Organization.address",
      "short" : "Địa chỉ CSYT",
      "type" : [{
        "code" : "Address",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-address"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Organization.endpoint",
      "path" : "Organization.endpoint",
      "short" : "Endpoint điện tử (vd: gdbhyt portal cho CSKCB ký hợp đồng BHXH)",
      "comment" : "Tham chiếu đến Endpoint resource biểu diễn cổng điện tử của tổ chức. Đối với CSKCB ký hợp đồng BHXH, có thể tham chiếu đến VNCoreEndpointBHYT (cổng https://gdbhyt.baohiemxahoi.gov.vn). Per TT 12/2026/TT-BTC Điều 2 + NĐ 164/2025/NĐ-CP.",
      "mustSupport" : true
    }]
  }
}

```
