| Left: | Tài liệu y tế VN Core — VN Core DocumentReference Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-document-reference) |
| Right: | Tài liệu y tế VN Core — VN Core DocumentReference Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-document-reference) |
| Error | StructureDefinition.version | Values for version differ: '0.5.0' vs '0.5.1' |
| Information | StructureDefinition.date | Values for date differ: '2026-03-21' vs '2026-05-10' |
| Name | Value | Comments | |
|---|---|---|---|
abstract | false | ||
baseDefinition | http://hl7.org/fhir/StructureDefinition/DocumentReference | ||
copyright | |||
date | 2026-03-21 | 2026-05-10 |
|
description | 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 | ||
experimental | |||
fhirVersion | 4.0.1 | ||
jurisdiction | |||
![]() jurisdiction[0] | urn:iso:std:iso:3166#VN | ||
kind | resource | ||
name | VNCoreDocumentReference | ||
publisher | Omi HealthTech / VN Core FHIR Community Initiative | ||
purpose | |||
status | draft | ||
title | Tài liệu y tế VN Core — VN Core DocumentReference Profile | ||
type | DocumentReference | ||
url | http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-document-reference | ||
version | 0.5.0 | 0.5.1 |
|
| Name | L Flags | L Card. | L Type | L Description & Constraints | R Flags | R Card. | R Type | R Description & Constraints | Comments![]() | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
![]() | 0..* | DocumentReference | A reference to a document | 0..* | DocumentReference | A reference to a document | |||||||||||
![]() ![]() | Σ | 0..1 | id | Logical id of this artifact | Σ | 0..1 | id | Logical id of this artifact | |||||||||
![]() ![]() | Σ | 0..1 | Meta | Metadata about the resource | Σ | 0..1 | Meta | Metadata about the resource | |||||||||
![]() ![]() | ?!Σ | 0..1 | uri | A set of rules under which this content was created | ?!Σ | 0..1 | uri | A set of rules under which this content was created | |||||||||
![]() ![]() | 0..1 | code | Language of the resource content Binding: ?? (preferred): A human language.
| 0..1 | code | Language of the resource content Binding: ?? (preferred): A human language.
| |||||||||||
![]() ![]() | 0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements | 0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements | |||||||||||
![]() ![]() | 0..* | Resource | Contained, inline Resources | 0..* | Resource | Contained, inline Resources | |||||||||||
![]() ![]() | 0..* | Extension | Additional content defined by implementations | 0..* | Extension | Additional content defined by implementations | |||||||||||
![]() ![]() | ?! | 0..* | Extension | Extensions that cannot be ignored | ?! | 0..* | Extension | Extensions that cannot be ignored | |||||||||
![]() ![]() | Σ | 0..1 | Identifier | Master Version Specific Identifier | Σ | 0..1 | Identifier | Master Version Specific Identifier | |||||||||
![]() ![]() | Σ | 0..* | Identifier | Other identifiers for the document | Σ | 0..* | Identifier | Other identifiers for the document | |||||||||
![]() ![]() | ?!SΣ | 1..1 | code | Trạng thái tài liệu (current | superseded | entered-in-error) Binding: ?? (required): The status of the document reference. | ?!SΣ | 1..1 | code | Trạng thái tài liệu (current | superseded | entered-in-error) Binding: ?? (required): The status of the document reference. | |||||||||
![]() ![]() | Σ | 0..1 | code | preliminary | final | amended | entered-in-error Binding: ?? (required): Status of the underlying document. | Σ | 0..1 | code | preliminary | final | amended | entered-in-error Binding: ?? (required): Status of the underlying document. | |||||||||
![]() ![]() | SΣ | 1..1 | CodeableConcept | Loại tài liệu y tế Binding: ?? (preferred): Precise type of clinical document. | SΣ | 1..1 | CodeableConcept | Loại tài liệu y tế Binding: ?? (preferred): Precise type of clinical document. | |||||||||
![]() ![]() | SΣ | 0..* | CodeableConcept | Phân loại tài liệu (bệnh án, XN, CĐHA, đơn thuốc...) Binding: ?? (example): High-level kind of a clinical document at a macro level. | SΣ | 0..* | CodeableConcept | Phân loại tài liệu (bệnh án, XN, CĐHA, đơn thuốc...) Binding: ?? (example): High-level kind of a clinical document at a macro level. | |||||||||
![]() ![]() | SΣ | 1..1 | Reference(Bệnh nhân VN Core — VN Core Patient Profile) | Bệnh nhân | SΣ | 1..1 | Reference(Bệnh nhân VN Core — VN Core Patient Profile) | Bệnh nhân | |||||||||
![]() ![]() | SΣ | 0..1 | instant | Thời điểm tạo tài liệu | SΣ | 0..1 | instant | Thời điểm tạo tài liệu | |||||||||
![]() ![]() | SΣ | 0..* | Reference(Nhân viên y tế VN Core — VN Core Practitioner Profile | Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile | Cơ sở y tế VN Core — VN Core Organization Profile) | Tác giả tài liệu (bác sĩ, NVYT, CSKCB) | SΣ | 0..* | Reference(Nhân viên y tế VN Core — VN Core Practitioner Profile | Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile | Cơ sở y tế VN Core — VN Core Organization Profile) | Tác giả tài liệu (bác sĩ, NVYT, CSKCB) | |||||||||
![]() ![]() | 0..1 | Reference(Nhân viên y tế VN Core — VN Core Practitioner Profile | Cơ sở y tế VN Core — VN Core Organization Profile) | Người ký xác nhận (chữ ký số per NĐ 137/2024) | 0..1 | Reference(Nhân viên y tế VN Core — VN Core Practitioner Profile | Cơ sở y tế VN Core — VN Core Organization Profile) | Người ký xác nhận (chữ ký số per NĐ 137/2024) | |||||||||||
![]() ![]() | S | 0..1 | Reference(Cơ sở y tế VN Core — VN Core Organization Profile) | Cơ sở y tế lưu trữ (per TT 13/2025) | S | 0..1 | Reference(Cơ sở y tế VN Core — VN Core Organization Profile) | Cơ sở y tế lưu trữ (per TT 13/2025) | |||||||||
![]() ![]() | Σ | 0..* | BackboneElement | Relationships to other documents | Σ | 0..* | BackboneElement | Relationships to other documents | |||||||||
![]() ![]() ![]() | 0..1 | string | Unique id for inter-element referencing | 0..1 | string | Unique id for inter-element referencing | |||||||||||
![]() ![]() ![]() | 0..* | Extension | Additional content defined by implementations | 0..* | Extension | Additional content defined by implementations | |||||||||||
![]() ![]() ![]() | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | |||||||||
![]() ![]() ![]() | Σ | 1..1 | code | replaces | transforms | signs | appends Binding: ?? (required): The type of relationship between documents. | Σ | 1..1 | code | replaces | transforms | signs | appends Binding: ?? (required): The type of relationship between documents. | |||||||||
![]() ![]() ![]() | Σ | 1..1 | Reference(DocumentReference) | Target of the relationship | Σ | 1..1 | Reference(DocumentReference) | Target of the relationship | |||||||||
![]() ![]() | SΣ | 0..1 | string | Mô tả nội dung tài liệu | SΣ | 0..1 | string | Mô tả nội dung tài liệu | |||||||||
![]() ![]() | Σ | 0..* | CodeableConcept | Document security-tags Binding: ?? (extensible): Security Labels from the Healthcare Privacy and Security Classification System. | Σ | 0..* | CodeableConcept | Document security-tags Binding: ?? (extensible): Security Labels from the Healthcare Privacy and Security Classification System. | |||||||||
![]() ![]() | SΣ | 1..* | BackboneElement | Nội dung tài liệu (attachment hoặc URL) | SΣ | 1..* | BackboneElement | Nội dung tài liệu (attachment hoặc URL) | |||||||||
![]() ![]() ![]() | 0..1 | string | Unique id for inter-element referencing | 0..1 | string | Unique id for inter-element referencing | |||||||||||
![]() ![]() ![]() | 0..* | Extension | Additional content defined by implementations | 0..* | Extension | Additional content defined by implementations | |||||||||||
![]() ![]() ![]() | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | |||||||||
![]() ![]() ![]() | SΣ | 1..1 | Attachment | File đính kèm (PDF, CDA, hình ảnh DICOM, v.v.) | SΣ | 1..1 | Attachment | File đính kèm (PDF, CDA, hình ảnh DICOM, v.v.) | |||||||||
![]() ![]() ![]() ![]() | 0..1 | string | Unique id for inter-element referencing | 0..1 | string | Unique id for inter-element referencing | |||||||||||
![]() ![]() ![]() ![]() | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||||||||
![]() ![]() ![]() ![]() | SΣ | 1..1 | code | MIME type (application/pdf, text/xml, image/dicom...) Binding: ?? (required): The mime type of an attachment. Any valid mime type is allowed. Example General: text/plain; charset=UTF-8, image/png | SΣ | 1..1 | code | MIME type (application/pdf, text/xml, image/dicom...) Binding: ?? (required): The mime type of an attachment. Any valid mime type is allowed. Example General: text/plain; charset=UTF-8, image/png | |||||||||
![]() ![]() ![]() ![]() | Σ | 0..1 | code | Human language of the content (BCP-47) Binding: ?? (preferred): A human language.
Example General: en-AU | Σ | 0..1 | code | Human language of the content (BCP-47) Binding: ?? (preferred): A human language.
Example General: en-AU | |||||||||
![]() ![]() ![]() ![]() | 0..1 | base64Binary | Data inline, base64ed | 0..1 | base64Binary | Data inline, base64ed | |||||||||||
![]() ![]() ![]() ![]() | Σ | 0..1 | url | Uri where the data can be found Example General: http://www.acme.com/logo-small.png | Σ | 0..1 | url | Uri where the data can be found Example General: http://www.acme.com/logo-small.png | |||||||||
![]() ![]() ![]() ![]() | Σ | 0..1 | unsignedInt | Number of bytes of content (if url provided) | Σ | 0..1 | unsignedInt | Number of bytes of content (if url provided) | |||||||||
![]() ![]() ![]() ![]() | Σ | 0..1 | base64Binary | Hash of the data (sha-1, base64ed) | Σ | 0..1 | base64Binary | Hash of the data (sha-1, base64ed) | |||||||||
![]() ![]() ![]() ![]() | Σ | 0..1 | string | Label to display in place of the data Example General: Official Corporate Logo | Σ | 0..1 | string | Label to display in place of the data Example General: Official Corporate Logo | |||||||||
![]() ![]() ![]() ![]() | Σ | 0..1 | dateTime | Date attachment was first created | Σ | 0..1 | dateTime | Date attachment was first created | |||||||||
![]() ![]() ![]() | Σ | 0..1 | Coding | Format/content rules for the document Binding: ?? (preferred): Document Format Codes. | Σ | 0..1 | Coding | Format/content rules for the document Binding: ?? (preferred): Document Format Codes. | |||||||||
![]() ![]() | SΣ | 0..1 | BackboneElement | Ngữ cảnh lâm sàng | SΣ | 0..1 | BackboneElement | Ngữ cảnh lâm sàng | |||||||||
![]() ![]() ![]() | 0..1 | string | Unique id for inter-element referencing | 0..1 | string | Unique id for inter-element referencing | |||||||||||
![]() ![]() ![]() | 0..* | Extension | Additional content defined by implementations | 0..* | Extension | Additional content defined by implementations | |||||||||||
![]() ![]() ![]() | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | |||||||||
![]() ![]() ![]() | S | 0..* | Reference(Lượt khám/nhập viện VN Core — VN Core Encounter Profile) | Lượt khám liên quan | S | 0..* | Reference(Lượt khám/nhập viện VN Core — VN Core Encounter Profile) | Lượt khám liên quan | |||||||||
![]() ![]() ![]() | 0..* | CodeableConcept | Main clinical acts documented Binding: ?? (example): This list of codes represents the main clinical acts being documented. | 0..* | CodeableConcept | Main clinical acts documented Binding: ?? (example): This list of codes represents the main clinical acts being documented. | |||||||||||
![]() ![]() ![]() | Σ | 0..1 | Period | Thời gian hiệu lực tài liệu | Σ | 0..1 | Period | Thời gian hiệu lực tài liệu | |||||||||
![]() ![]() ![]() | 0..1 | CodeableConcept | Kind of facility where patient was seen Binding: ?? (example): XDS Facility Type. | 0..1 | CodeableConcept | Kind of facility where patient was seen Binding: ?? (example): XDS Facility Type. | |||||||||||
![]() ![]() ![]() | 0..1 | CodeableConcept | Additional details about where the content was created (e.g. clinical specialty) Binding: ?? (example): Additional details about where the content was created (e.g. clinical specialty). | 0..1 | CodeableConcept | Additional details about where the content was created (e.g. clinical specialty) Binding: ?? (example): Additional details about where the content was created (e.g. clinical specialty). | |||||||||||
![]() ![]() ![]() | 0..1 | Reference(Patient) | Patient demographics from source | 0..1 | Reference(Patient) | Patient demographics from source | |||||||||||
![]() ![]() ![]() | 0..* | Reference(Resource) | Related identifiers or resources | 0..* | Reference(Resource) | Related identifiers or resources | |||||||||||
Documentation for this format | |||||||||||||||||