# Nhân viên y tế VN Core — VN Core Practitioner Profile - Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam v0.5.0

## Hồ sơ tài nguyên: Nhân viên y tế VN Core — VN Core Practitioner Profile 

 
Profile Practitioner cho Việt Nam. Bao gồm identifier slicing (CCCD, GPHN hiện hành, CCHN lịch sử), thông tin trình độ chuyên môn (qualification). Căn cứ: 
* **Luật KCB 2023** — Điều 19-27 — hành nghề KCB
* **NĐ 96/2023/NĐ-CP** — 30/12/2023 — hướng dẫn Luật KCB
* **TT 32/2023/TT-BYT** — 31/12/2023 — hướng dẫn phạm vi hành nghề và chuyên môn KCB
* **NĐ 102/2025/NĐ-CP** — 13/5/2025, hiệu lực 01/7/2025 — Điều 6 quy định **số định danh cá nhân (CCCD 12 số) là mã định danh y tế của cá nhân, áp dụng cho cả Patient và nhân lực y tế**
* **TT 13/2025/TT-BYT** — 06/6/2025 — bệnh án điện tử.
 
**Pattern identifier**: 
* `identifier[CCCD]` = mã định danh y tế của nhân lực (per NĐ 102/2025 Điều 6) — primary key
* `identifier[GPHN]` = số Giấy phép hành nghề (NĐ 96/2023 Mẫu 11 Phụ lục I) — professional license
* `identifier[CCHN]` = số Chứng chỉ hành nghề (legacy trước Luật KCB 2023) — backward compat
 

**Usages:**

* Refer to this Profile: [Dị ứng/Bất dung nạp VN Core — VN Core AllergyIntolerance Profile](StructureDefinition-vn-core-allergy-intolerance.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 17 more, [Chẩn đoán VN Core — VN Core Condition Profile](StructureDefinition-vn-core-condition.md), [Đồ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), [Nghiên cứu CĐHA VN Core — VN Core Imaging Study Profile](StructureDefinition-vn-core-imaging-study.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), [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) and [Mẫu bệnh phẩm VN Core — VN Core Specimen Profile](StructureDefinition-vn-core-specimen.md)
* Examples for this Profile: [Practitioner/ExamplePractitionerBSCKII](Practitioner-ExamplePractitionerBSCKII.md), [Practitioner/ExamplePractitionerMinimal](Practitioner-ExamplePractitionerMinimal.md) and [Practitioner/ExamplePractitionerYHCT](Practitioner-ExamplePractitionerYHCT.md)
* CapabilityStatements using this Profile: [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-practitioner)

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

#### Constraints

#### Terminology Bindings

#### Constraints

** Summary **

Mandatory: 2 elements(6 nested mandatory elements)
 Must-Support: 13 elements
 Fixed: 3 elements

**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 Practitioner.identifier

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

#### Terminology Bindings

#### Constraints

 **Dạng xem Differential** 

#### Terminology Bindings (Differential)

#### Constraints

 **Dạng xem SnapshotView** 

#### Terminology Bindings

#### Constraints

** Summary **

Mandatory: 2 elements(6 nested mandatory elements)
 Must-Support: 13 elements
 Fixed: 3 elements

**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 Practitioner.identifier

 

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



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "vn-core-practitioner",
  "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner",
  "version" : "0.5.0",
  "name" : "VNCorePractitioner",
  "title" : "Nhân viên y tế VN Core — VN Core Practitioner 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 Practitioner cho Việt Nam. Bao gồm identifier slicing (CCCD, GPHN hiện hành, CCHN lịch sử),\nthông tin trình độ chuyên môn (qualification).\nCăn cứ:\n- **Luật KCB 2023** — Điều 19-27 — hành nghề KCB\n- **NĐ 96/2023/NĐ-CP** — 30/12/2023 — hướng dẫn Luật KCB\n- **TT 32/2023/TT-BYT** — 31/12/2023 — hướng dẫn phạm vi hành nghề và chuyên môn KCB\n- **NĐ 102/2025/NĐ-CP** — 13/5/2025, hiệu lực 01/7/2025 — Điều 6 quy định **số định danh cá nhân (CCCD 12 số) là mã định danh y tế của cá nhân, áp dụng cho cả Patient và nhân lực y tế**\n- **TT 13/2025/TT-BYT** — 06/6/2025 — bệnh án điện tử.\n\n**Pattern identifier**:\n- `identifier[CCCD]` = mã định danh y tế của nhân lực (per NĐ 102/2025 Điều 6) — primary key\n- `identifier[GPHN]` = số Giấy phép hành nghề (NĐ 96/2023 Mẫu 11 Phụ lục I) — professional license\n- `identifier[CCHN]` = số Chứng chỉ hành nghề (legacy trước Luật KCB 2023) — backward compat",
  "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" : "Practitioner",
  "baseDefinition" : "http://hl7.org/fhir/StructureDefinition/Practitioner",
  "derivation" : "constraint",
  "differential" : {
    "element" : [{
      "id" : "Practitioner",
      "path" : "Practitioner"
    },
    {
      "id" : "Practitioner.identifier",
      "path" : "Practitioner.identifier",
      "slicing" : {
        "discriminator" : [{
          "type" : "value",
          "path" : "system"
        }],
        "description" : "Phân loại identifier theo hệ thống (system)",
        "rules" : "open"
      },
      "short" : "Định danh NVYT (CCCD, GPHN, CCHN legacy)",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "Practitioner.identifier:CCCD",
      "path" : "Practitioner.identifier",
      "sliceName" : "CCCD",
      "short" : "Số CCCD (Căn cước công dân)",
      "min" : 0,
      "max" : "1",
      "mustSupport" : true
    },
    {
      "id" : "Practitioner.identifier:CCCD.type",
      "path" : "Practitioner.identifier.type",
      "patternCodeableConcept" : {
        "coding" : [{
          "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs",
          "code" : "CCCD"
        }]
      }
    },
    {
      "id" : "Practitioner.identifier:CCCD.system",
      "path" : "Practitioner.identifier.system",
      "min" : 1,
      "fixedUri" : "http://fhir.hl7.org.vn/core/sid/cccd"
    },
    {
      "id" : "Practitioner.identifier:CCCD.value",
      "path" : "Practitioner.identifier.value",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "Practitioner.identifier:GPHN",
      "path" : "Practitioner.identifier",
      "sliceName" : "GPHN",
      "short" : "Số GPHN — format [STT]/[BYT|BQP|BCA|MãTỉnh]-GPHN",
      "definition" : "Số Giấy phép hành nghề khám bệnh, chữa bệnh theo Luật KCB 2023 và NĐ 96/2023/NĐ-CP (thay thuật ngữ 'Chứng chỉ hành nghề' cũ).\n\nFormat chuẩn theo NĐ 96/2023 Mẫu 11 Phụ lục I:\n- Cấu trúc: `[Số thứ tự cấp]/[Mã ký hiệu cơ quan cấp]-GPHN`\n- Mã cơ quan (NĐ 96/2023 Mẫu 07 Phụ lục II):\n  - **BYT**: do Bộ Y tế cấp\n  - **BQP**: do Bộ Quốc phòng cấp\n  - **BCA**: do Bộ Công an cấp\n  - **Mã tỉnh** (HN, HCM, DN, ...): do Sở Y tế cấp\n- Hậu tố `-GPHN` bắt buộc\n\nVí dụ:\n- `001234/BYT-GPHN` (do Bộ Y tế cấp)\n- `005678/HN-GPHN` (do Sở Y tế Hà Nội cấp)\n\nĐây là định danh hành nghề hiện hành — SHOULD được populate cho nhân viên y tế hành nghề trong dữ liệu mới.",
      "min" : 0,
      "max" : "1",
      "mustSupport" : true
    },
    {
      "id" : "Practitioner.identifier:GPHN.type",
      "path" : "Practitioner.identifier.type",
      "patternCodeableConcept" : {
        "coding" : [{
          "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs",
          "code" : "GPHN"
        }]
      }
    },
    {
      "id" : "Practitioner.identifier:GPHN.system",
      "path" : "Practitioner.identifier.system",
      "min" : 1,
      "fixedUri" : "http://fhir.hl7.org.vn/core/sid/gphn"
    },
    {
      "id" : "Practitioner.identifier:GPHN.value",
      "path" : "Practitioner.identifier.value",
      "min" : 1,
      "constraint" : [{
        "key" : "vn-gphn-format",
        "severity" : "warning",
        "human" : "Số Giấy phép hành nghề (GPHN) phải đúng format theo NĐ 96/2023/NĐ-CP Mẫu 11 Phụ lục I: [STT]/[BYT|BQP|BCA|MãTỉnh]-GPHN. Ví dụ 001234/BYT-GPHN, 005678/HN-GPHN.",
        "expression" : "$this.empty() or $this.matches('^\\\\d+/[A-Z]{2,4}-GPHN$')",
        "source" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner"
      }],
      "mustSupport" : true
    },
    {
      "id" : "Practitioner.identifier:CCHN",
      "path" : "Practitioner.identifier",
      "sliceName" : "CCHN",
      "short" : "Số CCHN lịch sử",
      "definition" : "Số Chứng chỉ hành nghề được cấp theo khung pháp lý trước Luật KCB 2023. Giữ lại để đối soát, chuyển đổi và tra cứu dữ liệu legacy.",
      "min" : 0,
      "max" : "1",
      "mustSupport" : true
    },
    {
      "id" : "Practitioner.identifier:CCHN.type",
      "path" : "Practitioner.identifier.type",
      "patternCodeableConcept" : {
        "coding" : [{
          "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs",
          "code" : "CCHN"
        }]
      }
    },
    {
      "id" : "Practitioner.identifier:CCHN.system",
      "path" : "Practitioner.identifier.system",
      "min" : 1,
      "fixedUri" : "http://fhir.hl7.org.vn/core/sid/cchn"
    },
    {
      "id" : "Practitioner.identifier:CCHN.value",
      "path" : "Practitioner.identifier.value",
      "min" : 1
    },
    {
      "id" : "Practitioner.name",
      "path" : "Practitioner.name",
      "short" : "Họ tên nhân viên y tế",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "Practitioner.name.text",
      "path" : "Practitioner.name.text",
      "short" : "Họ tên đầy đủ",
      "mustSupport" : true
    },
    {
      "id" : "Practitioner.name.family",
      "path" : "Practitioner.name.family",
      "short" : "Họ",
      "mustSupport" : true
    },
    {
      "id" : "Practitioner.name.given",
      "path" : "Practitioner.name.given",
      "short" : "Tên đệm và Tên",
      "mustSupport" : true
    },
    {
      "id" : "Practitioner.gender",
      "path" : "Practitioner.gender",
      "short" : "Giới tính",
      "mustSupport" : true
    },
    {
      "id" : "Practitioner.qualification",
      "path" : "Practitioner.qualification",
      "short" : "Trình độ chuyên môn / Học vị",
      "mustSupport" : true
    },
    {
      "id" : "Practitioner.qualification.code",
      "path" : "Practitioner.qualification.code",
      "short" : "Mã trình độ chuyên môn",
      "mustSupport" : true,
      "binding" : {
        "strength" : "extensible",
        "valueSet" : "http://fhir.hl7.org.vn/core/ValueSet/vn-qualification-vs"
      }
    },
    {
      "id" : "Practitioner.qualification.issuer",
      "path" : "Practitioner.qualification.issuer",
      "short" : "Cơ quan cấp (BYT, Sở YT, Trường ĐH)"
    }]
  }
}

```
