# Tài liệu y tế VN Core — VN Core DocumentReference Profile - Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam v0.5.0

## Hồ sơ tài nguyên: Tài liệu y tế VN Core — VN Core DocumentReference Profile 

 
Profile DocumentReference cho Việt Nam. Dùng cho tham chiếu bệnh án điện tử, phiếu kết quả xét nghiệm, phim ảnh CĐHA, đơn thuốc điện tử, giấy chuyển viện, v.v. Căn cứ: 
* TT 13/2025/TT-BYT (06/6/2025) — Bệnh án điện tử, hiệu lực 21/7/2025
* NĐ 102/2025/NĐ-CP (13/5/2025) — Quản lý dữ liệu y tế số
* NĐ 278/2025/NĐ-CP — ban hành 22/10/2025, hiệu lực từ ngày ký 22/10/2025 — Kết nối, chia sẻ dữ liệu bắt buộc; chuẩn hóa và thống nhất kết nối qua Nền tảng chia sẻ, điều phối dữ liệu chậm nhất 31/12/2026
* QĐ 11/2026/QĐ-TTg (28/3/2026) — Danh mục CSDL quốc gia, gồm CSDL quốc gia về y tế
* Luật KCB 2023 (15/2023/QH15) — Hồ sơ bệnh án
* NĐ 137/2024/NĐ-CP — Giao dịch điện tử, chữ ký số
* QĐ 1332/QĐ-BYT — Sổ sức khỏe điện tử trên VNeID
* Luật 91/2025/QH15 — BVDLCN: dữ liệu y tế = DLCN nhạy cảm
 

**Usages:**

* Refer to this Profile: [Thông báo vi phạm DLCN (Mẫu 08) — VN Core Breach Notification Composition Profile](StructureDefinition-vn-core-composition-breach-notification.md)
* Examples for this Profile: [DocumentReference/ExampleDocumentReferenceConsent](DocumentReference-ExampleDocumentReferenceConsent.md), [DocumentReference/ExampleDocumentReferenceEMR](DocumentReference-ExampleDocumentReferenceEMR.md) and [DocumentReference/ExampleDocumentReferenceScan](DocumentReference-ExampleDocumentReferenceScan.md)
* CapabilityStatements using this Profile: [VN Core Citizen App Client CapabilityStatement](CapabilityStatement-vn-core-citizen-app-client.md), [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-document-reference)

### 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: 3 elements
 Must-Support: 13 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)
* [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)
* [Lượt khám/nhập viện VN Core — VN Core Encounter Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-encounter)](StructureDefinition-vn-core-encounter.md)

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

#### Terminology Bindings

#### Constraints

 **Dạng xem Differential** 

 **Dạng xem SnapshotView** 

#### Terminology Bindings

#### Constraints

** Summary **

Mandatory: 3 elements
 Must-Support: 13 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)
* [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)
* [Lượt khám/nhập viện VN Core — VN Core Encounter Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-encounter)](StructureDefinition-vn-core-encounter.md)

 

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



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "vn-core-document-reference",
  "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-document-reference",
  "version" : "0.5.0",
  "name" : "VNCoreDocumentReference",
  "title" : "Tài liệu y tế VN Core — VN Core DocumentReference 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 DocumentReference cho Việt Nam. Dùng cho tham chiếu bệnh án điện tử,\nphiếu kết quả xét nghiệm, phim ảnh CĐHA, đơn thuốc điện tử, giấy chuyển viện, v.v.\nCăn cứ:\n- TT 13/2025/TT-BYT (06/6/2025) — Bệnh án điện tử, hiệu lực 21/7/2025\n- NĐ 102/2025/NĐ-CP (13/5/2025) — Quản lý dữ liệu y tế số\n- NĐ 278/2025/NĐ-CP — ban hành 22/10/2025, hiệu lực từ ngày ký 22/10/2025 — Kết nối, chia sẻ dữ liệu bắt buộc; chuẩn hóa và thống nhất kết nối qua Nền tảng chia sẻ, điều phối dữ liệu chậm nhất 31/12/2026\n- QĐ 11/2026/QĐ-TTg (28/3/2026) — Danh mục CSDL quốc gia, gồm CSDL quốc gia về y tế\n- Luật KCB 2023 (15/2023/QH15) — Hồ sơ bệnh án\n- NĐ 137/2024/NĐ-CP — Giao dịch điện tử, chữ ký số\n- QĐ 1332/QĐ-BYT — Sổ sức khỏe điện tử trên VNeID\n- Luật 91/2025/QH15 — BVDLCN: dữ liệu y tế = DLCN nhạy cảm",
  "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" : "fhircomposition",
    "uri" : "http://hl7.org/fhir/composition",
    "name" : "FHIR Composition"
  },
  {
    "identity" : "rim",
    "uri" : "http://hl7.org/v3",
    "name" : "RIM Mapping"
  },
  {
    "identity" : "cda",
    "uri" : "http://hl7.org/v3/cda",
    "name" : "CDA (R2)"
  },
  {
    "identity" : "w5",
    "uri" : "http://hl7.org/fhir/fivews",
    "name" : "FiveWs Pattern Mapping"
  },
  {
    "identity" : "v2",
    "uri" : "http://hl7.org/v2",
    "name" : "HL7 v2 Mapping"
  },
  {
    "identity" : "xds",
    "uri" : "http://ihe.net/xds",
    "name" : "XDS metadata equivalent"
  }],
  "kind" : "resource",
  "abstract" : false,
  "type" : "DocumentReference",
  "baseDefinition" : "http://hl7.org/fhir/StructureDefinition/DocumentReference",
  "derivation" : "constraint",
  "differential" : {
    "element" : [{
      "id" : "DocumentReference",
      "path" : "DocumentReference"
    },
    {
      "id" : "DocumentReference.status",
      "path" : "DocumentReference.status",
      "short" : "Trạng thái tài liệu (current | superseded | entered-in-error)",
      "mustSupport" : true
    },
    {
      "id" : "DocumentReference.type",
      "path" : "DocumentReference.type",
      "short" : "Loại tài liệu y tế",
      "definition" : "Loại tài liệu: bệnh án, đơn thuốc, kết quả XN, phim CĐHA, giấy chuyển viện, v.v. Dùng mã LOINC Document Ontology.",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "DocumentReference.category",
      "path" : "DocumentReference.category",
      "short" : "Phân loại tài liệu (bệnh án, XN, CĐHA, đơn thuốc...)",
      "mustSupport" : true
    },
    {
      "id" : "DocumentReference.subject",
      "path" : "DocumentReference.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" : "DocumentReference.date",
      "path" : "DocumentReference.date",
      "short" : "Thời điểm tạo tài liệu",
      "mustSupport" : true
    },
    {
      "id" : "DocumentReference.author",
      "path" : "DocumentReference.author",
      "short" : "Tác giả tài liệu (bác sĩ, NVYT, CSKCB)",
      "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",
        "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "DocumentReference.authenticator",
      "path" : "DocumentReference.authenticator",
      "short" : "Người ký xác nhận (chữ ký số per NĐ 137/2024)",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner",
        "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization"]
      }]
    },
    {
      "id" : "DocumentReference.custodian",
      "path" : "DocumentReference.custodian",
      "short" : "Cơ sở y tế lưu trữ (per TT 13/2025)",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "DocumentReference.description",
      "path" : "DocumentReference.description",
      "short" : "Mô tả nội dung tài liệu",
      "mustSupport" : true
    },
    {
      "id" : "DocumentReference.content",
      "path" : "DocumentReference.content",
      "short" : "Nội dung tài liệu (attachment hoặc URL)",
      "mustSupport" : true
    },
    {
      "id" : "DocumentReference.content.attachment",
      "path" : "DocumentReference.content.attachment",
      "short" : "File đính kèm (PDF, CDA, hình ảnh DICOM, v.v.)",
      "mustSupport" : true
    },
    {
      "id" : "DocumentReference.content.attachment.contentType",
      "path" : "DocumentReference.content.attachment.contentType",
      "short" : "MIME type (application/pdf, text/xml, image/dicom...)",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "DocumentReference.context",
      "path" : "DocumentReference.context",
      "short" : "Ngữ cảnh lâm sàng",
      "definition" : "Ngữ cảnh lâm sàng của tài liệu phục vụ quản lý, khai thác và chia sẻ dữ liệu y tế số theo NĐ 102/2025/NĐ-CP và NĐ 278/2025/NĐ-CP (hiệu lực từ ngày ký 22/10/2025; mốc chuẩn hóa/kết nối 31/12/2026).",
      "mustSupport" : true
    },
    {
      "id" : "DocumentReference.context.encounter",
      "path" : "DocumentReference.context.encounter",
      "short" : "Lượt khám liên quan",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-encounter"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "DocumentReference.context.period",
      "path" : "DocumentReference.context.period",
      "short" : "Thời gian hiệu lực tài liệu"
    }]
  }
}

```
