# Khoa/Phòng VN Core — VN Core Organization Department Profile - Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam v0.5.0

## Hồ sơ tài nguyên: Khoa/Phòng VN Core — VN Core Organization Department Profile 

 
Profile Organization cho khoa/phòng chuyên môn trong cơ sở khám bệnh, chữa bệnh tại Việt Nam. Profile này intentionally kế thừa trực tiếp từ FHIR Organization, không kế thừa VNCoreOrganization, để biểu diễn đơn vị trực thuộc với partOf bắt buộc và mã khoa chuyên ngành. Căn cứ pháp lý và nghiệp vụ: 
* **QĐ 2010/QĐ-BYT ngày 19/6/2025 Phụ lục 6** — Danh mục mã khoa hiện hành, 54 mã (K01-K53 + K99)
* QĐ 5937/QĐ-BYT (2021) — tiền nhiệm, bị bãi bỏ phần Phụ lục 5 bởi QĐ 2010/QĐ-BYT Điều 2
* QĐ 3176/QĐ-BYT (29/10/2024) — trường MA_KHOA trong XML đầu ra KCB
* TT 32/2023/TT-BYT Chương VIII Điều 44-45 — operational reference cho trực khoa, giao ban; không phải văn bản ban hành taxonomy khoa/phòng
* TT 13/2025/TT-BYT (06/6/2025) — bệnh án điện tử cần ghi nhận khoa điều trị. / VN Core OrganizationDepartment profile for clinical/operational departments within Vietnamese healthcare facilities. This profile inherits directly from FHIR Organization, separate from VNCoreOrganization, to keep department semantics explicit through mandatory partOf and department-code identifiers.
 

**Usages:**

* Examples for this Profile: [Khoa Nội Tim mạch](Organization-ExampleOrganizationDepartmentCardiology.md) and [Khoa Chẩn đoán hình ảnh](Organization-ExampleOrganizationDepartmentDiagnosticImaging.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-department)

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

#### Constraints

#### Terminology Bindings

#### Constraints

** Summary **

Mandatory: 7 elements(2 nested mandatory elements)
 Must-Support: 8 elements
 Fixed: 2 elements

**Structures**

This structure refers to these other structures:

* [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)

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

#### Constraints

 **Dạng xem SnapshotView** 

#### Terminology Bindings

#### Constraints

** Summary **

Mandatory: 7 elements(2 nested mandatory elements)
 Must-Support: 8 elements
 Fixed: 2 elements

**Structures**

This structure refers to these other structures:

* [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)

**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-department.csv), [Excel](../StructureDefinition-vn-core-organization-department.xlsx), [Schematron](../StructureDefinition-vn-core-organization-department.sch) 



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "vn-core-organization-department",
  "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization-department",
  "version" : "0.5.0",
  "name" : "VNCoreOrganizationDepartment",
  "title" : "Khoa/Phòng VN Core — VN Core Organization Department Profile",
  "status" : "draft",
  "date" : "2026-04-14",
  "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 khoa/phòng chuyên môn trong cơ sở khám bệnh, chữa bệnh tại Việt Nam.\nProfile này intentionally kế thừa trực tiếp từ FHIR Organization, không kế thừa VNCoreOrganization, để biểu diễn đơn vị trực thuộc với partOf bắt buộc và mã khoa chuyên ngành.\nCăn cứ pháp lý và nghiệp vụ:\n- **QĐ 2010/QĐ-BYT ngày 19/6/2025 Phụ lục 6** — Danh mục mã khoa hiện hành, 54 mã (K01-K53 + K99)\n- QĐ 5937/QĐ-BYT (2021) — tiền nhiệm, bị bãi bỏ phần Phụ lục 5 bởi QĐ 2010/QĐ-BYT Điều 2\n- QĐ 3176/QĐ-BYT (29/10/2024) — trường MA_KHOA trong XML đầu ra KCB\n- TT 32/2023/TT-BYT Chương VIII Điều 44-45 — operational reference cho trực khoa, giao ban; không phải văn bản ban hành taxonomy khoa/phòng\n- TT 13/2025/TT-BYT (06/6/2025) — bệnh án điện tử cần ghi nhận khoa điều trị.\n/\nVN Core OrganizationDepartment profile for clinical/operational departments within Vietnamese healthcare facilities.\nThis profile inherits directly from FHIR Organization, separate from VNCoreOrganization, to keep department semantics explicit through mandatory partOf and department-code identifiers.",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "urn:iso:std:iso:3166",
      "code" : "VN",
      "display" : "Viet Nam"
    }]
  }],
  "copyright" : "Căn cứ pháp lý Việt Nam: QĐ 2010/QĐ-BYT ngày 19/06/2025 Phụ lục 6; QĐ 5937/QĐ-BYT năm 2021 là tiền nhiệm và bị QĐ 2010/QĐ-BYT Điều 2 bãi bỏ phần Phụ lục 5; QĐ 3176/QĐ-BYT ngày 29/10/2024; TT 32/2023/TT-BYT Chương VIII Điều 44-45 là operational reference; TT 13/2025/TT-BYT ngày 06/06/2025.",
  "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",
      "constraint" : [{
        "key" : "vn-org-dept-partof-required",
        "severity" : "error",
        "human" : "Khoa phải có partOf tham chiếu cơ sở y tế chủ quản — per QĐ 2010/QĐ-BYT Phụ lục 6",
        "expression" : "partOf.exists()",
        "source" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization-department"
      }]
    },
    {
      "id" : "Organization.identifier",
      "path" : "Organization.identifier",
      "slicing" : {
        "discriminator" : [{
          "type" : "value",
          "path" : "system"
        }],
        "description" : "Phân loại identifier khoa/phòng theo system",
        "rules" : "open"
      },
      "short" : "Mã khoa BYT và mã khoa cục bộ",
      "definition" : "Danh sách định danh khoa/phòng. Bắt buộc có một mã khoa theo QĐ 2010/QĐ-BYT Phụ lục 6; có thể kèm mã khoa cục bộ của cơ sở.",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "Organization.identifier:departmentCode",
      "path" : "Organization.identifier",
      "sliceName" : "departmentCode",
      "short" : "Mã khoa BYT (K01-K53, K99)",
      "definition" : "Mã khoa theo QĐ 2010/QĐ-BYT ngày 19/6/2025 Phụ lục 6 — 54 mã hiện hành K01-K53 và K99.",
      "min" : 1,
      "max" : "1",
      "mustSupport" : true
    },
    {
      "id" : "Organization.identifier:departmentCode.type.text",
      "path" : "Organization.identifier.type.text",
      "patternString" : "Mã khoa theo QĐ 2010/QĐ-BYT"
    },
    {
      "id" : "Organization.identifier:departmentCode.system",
      "path" : "Organization.identifier.system",
      "min" : 1,
      "fixedUri" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-department-cs"
    },
    {
      "id" : "Organization.identifier:departmentCode.value",
      "path" : "Organization.identifier.value",
      "short" : "Giá trị mã khoa",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "Organization.identifier:localCode",
      "path" : "Organization.identifier",
      "sliceName" : "localCode",
      "short" : "Mã khoa cục bộ",
      "definition" : "Mã khoa/phòng do cơ sở y tế tự quản lý, dùng để map dữ liệu HIS/EMR nội bộ sang mã khoa BYT.",
      "min" : 0,
      "max" : "*",
      "mustSupport" : true
    },
    {
      "id" : "Organization.identifier:localCode.type.text",
      "path" : "Organization.identifier.type.text",
      "patternString" : "Mã khoa cục bộ"
    },
    {
      "id" : "Organization.identifier:localCode.system",
      "path" : "Organization.identifier.system",
      "min" : 1,
      "fixedUri" : "http://fhir.hl7.org.vn/core/sid/organization-local-id"
    },
    {
      "id" : "Organization.identifier:localCode.value",
      "path" : "Organization.identifier.value",
      "min" : 1
    },
    {
      "id" : "Organization.active",
      "path" : "Organization.active",
      "short" : "Khoa/phòng đang hoạt động",
      "mustSupport" : true
    },
    {
      "id" : "Organization.type",
      "path" : "Organization.type",
      "short" : "Loại tổ chức: khoa/phòng",
      "definition" : "FHIR Organization.type cố định là `dept` để phân biệt khoa/phòng trực thuộc với cơ sở y tế chủ quản.",
      "min" : 1,
      "max" : "1",
      "patternCodeableConcept" : {
        "coding" : [{
          "system" : "http://terminology.hl7.org/CodeSystem/organization-type",
          "code" : "dept",
          "display" : "Hospital Department"
        }]
      },
      "mustSupport" : true
    },
    {
      "id" : "Organization.name",
      "path" : "Organization.name",
      "short" : "Tên khoa/phòng",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "Organization.partOf",
      "path" : "Organization.partOf",
      "short" : "Cơ sở y tế chủ quản",
      "definition" : "Khoa/phòng phải thuộc một cơ sở y tế chủ quản. Dùng partOf để liên kết OrganizationDepartment với VNCoreOrganization.",
      "min" : 1,
      "type" : [{
        "extension" : [{
          "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-hierarchy",
          "valueBoolean" : true
        }],
        "code" : "Reference",
        "targetProfile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization"]
      }],
      "mustSupport" : true
    }]
  }
}

```
