Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide
0.10.0 - Draft for Community Review
Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide - Draft for Community Review (v0.10.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| URL chính thức: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-document-reference-birth-certificate | Phiên bản: 0.10.0 | ||||
| Computable Name: VNCoreDocumentReferenceBirthCertificate | |||||
| Định danh khác: OID:2.25.161089673617632664299011809196868855799.42.61 | |||||
Bản Giấy chứng sinh dạng tệp (PDF hoặc XML) đã ký số, dùng cho cả trường hợp sinh thường và mang thai hộ.
Quan hệ với Composition. VNCoreCompositionBirthCertificate giữ dữ liệu CÓ CẤU TRÚC để hệ
thống đọc và liên thông; profile này giữ BẢN TÀI LIỆU để lưu trữ, đối chiếu và chứng minh chữ ký.
Hai thứ không thay nhau: mất bản ký thì không chứng minh được tính toàn vẹn, mất bản cấu trúc thì
không liên thông được sang Phần mềm dịch vụ công theo NĐ 63/2024/NĐ-CP.
Một profile cho cả hai trường hợp. Khác với lớp Composition, ở đây tệp đã ký là một khối nhị phân — cấu trúc bốn bên của mang thai hộ nằm bên trong nội dung tệp, không ảnh hưởng tới siêu dữ liệu tham chiếu. Tách hai profile chỉ để đổi một câu mô tả là bày vẽ không cần thiết.
Định danh dùng chung sid/gcs với Composition — cùng một giấy chứng sinh, cùng một mã.
Usages:
You can also check for usages in the FHIR IG Statistics
Mô tả profile, differential, snapshot và các biểu diễn liên quan.
| Name | Bên yêu cầu dữ liệu lõi (Data Requester) | Kho hồ sơ EMR (Repository) | Bên đáp ứng dữ liệu lõi (Data Responder) | Cổng liên thông thủ tục hành chính (e-Service Gateway) | Ứng dụng người dân (Citizen App) | Nguồn tạo hồ sơ lâm sàng (Document Source) |
|---|---|---|---|---|---|---|
  DocumentReference |
||||||
  Slices for extension |
||||||
   extension:paperConversion |
|
| ||||
| Slices for identifier |
| |||||
| identifier:gcs |
| |||||
  status |
|
| ||||
 type |
|
| ||||
| category |
|
| ||||
 subject |
|
| ||||
| date |
|
| ||||
| author |
|
| ||||
| custodian |
|
| ||||
| description |
|
| ||||
| content |
|
| ||||
 context |
|
| ||||
| Documentation for this format | ||||||
| Path | Status | Usage | ValueSet | Version | Source |
| DocumentReference.identifier:gcs.use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std. |
| DocumentReference.status | Base | required | DocumentReferenceStatus | 📍4.0.1 | FHIR Std. |
| DocumentReference.type | Base | preferred | Document Type Value Set | 📍4.0.1 | FHIR Std. |
| DocumentReference.category | Base | example | Document Class Value Set | 📍4.0.1 | FHIR Std. |
| DocumentReference.content.attachment.contentType | Base | required | MimeType | 📍4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| dom-2 | error | DocumentReference | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | DocumentReference | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | DocumentReference | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated |
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
|
| dom-5 | error | DocumentReference | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | DocumentReference | A resource should have narrative for robust management |
text.`div`.exists()
|
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
hasValue() or (children().count() > id.count())
|
| ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both |
extension.exists() != value.exists()
|
| vn-birth-certificate-content-present | error | DocumentReference | Bản giấy chứng sinh phải có dữ liệu nhúng hoặc đường dẫn. The attachment SHALL carry either inline data or a URL. |
content.all(attachment.data.exists() or attachment.url.exists())
|
| vn-birth-certificate-gcs-identifier | error | DocumentReference | Mã giấy chứng sinh phải đúng dạng XXXXX.GCS.ZZZZZ.YY. The birth certificate identifier SHALL follow the published pattern. |
identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/gcs').value.all(matches('^[0-9]{5}\\.GCS\\.[0-9]{5}\\.[0-9]{2}$'))
|
| vn-document-number-issuer-scoped | error | DocumentReference | Số văn bản nội bộ ghi dưới URI dùng tạm cấp quốc gia (http://fhir.hl7.org.vn/core/sid/document-number) phải kèm `assigner` chỉ rõ cơ sở cấp mã; khuyến nghị chính là mỗi cơ sở công bố URI riêng. A local document number recorded under the shared national placeholder URI SHALL name its assigning facility; per-facility namespace URIs are preferred. |
identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/document-number').all(assigner.exists())
|
| vn-paper-conversion-official-doc-signature | error | DocumentReference.extension:paperConversion | Khi tài liệu giấy được chuyển đổi là giấy phép, giấy chứng nhận, chứng chỉ, văn bản xác nhận hoặc văn bản chấp thuận do cơ quan, tổ chức có thẩm quyền phát hành thì bản điện tử phải có chữ ký số của bên thực hiện chuyển đổi — Luật 20/2023/QH15 Điều 12 khoản 1 điểm d. Converting an official credential SHALL carry the converter's digital signature. |
extension.where(url = 'officialDocument').value.ofType(boolean) = true implies extension.where(url = 'signatureEvidence').exists()
|
| Name | Flags | Card. | Type | Description & Constraints Filter:   | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| DocumentReference |
C | 0..* | VNCoreDocumentReference | A reference to a document Constraints: vn-birth-certificate-gcs-identifier, vn-birth-certificate-content-present
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Slices for identifier |
SO | 1..* | Identifier | Other identifiers for the document Slice: Unordered, Open by value:system
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
 identifier:gcs |
SO | 1..1 | Identifier | Mã giấy chứng sinh (MA_GCS) — cùng mã với Composition tương ứng
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
   system |
S | 1..1 | uri | The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/gcs | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
 value |
S | 1..1 | string | The value that is unique | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| type |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| text |
S | 1..1 | string | Plain text representation of the concept | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| subject |
1..1 | Reference(Bệnh nhân VN Core — VN Core Patient Profile) | Trẻ được cấp giấy chứng sinh | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| date |
1..1 | instant | Thời điểm lập bản tài liệu | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| custodian |
1..1 | Reference(Cơ sở khám bệnh, chữa bệnh VN Core — VN Core KCB Organization Profile | Cơ sở y tế VN Core — VN Core Organization Profile) | Cơ sở y tế lưu trữ (theo TT 13/2025/TT-BYT) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| content |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
 attachment |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| contentType |
1..1 | code | application/pdf hoặc application/xml | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| data |
S | 0..1 | base64Binary | Data inline, base64ed | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| url |
S | 0..1 | url | Uri where the data can be found | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| hash |
S | 0..1 | base64Binary | Băm nội dung — cơ sở đối chiếu toàn vẹn bản lưu | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| creation |
S | 1..1 | dateTime | Thời điểm tạo tệp — đối chiếu với ngày cấp NGAY_CS | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| context |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| related |
S | 0..* | Reference(Resource) | Trỏ tới Composition có cấu trúc của cùng giấy chứng sinh | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Documentation for this format | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Name | Kho hồ sơ EMR (Repository) | Cổng liên thông thủ tục hành chính (e-Service Gateway) | Nguồn tạo hồ sơ lâm sàng (Document Source) |
|---|---|---|---|
| DocumentReference |
|||
| Slices for identifier |
| ||
| identifier:gcs |
| ||
| Documentation for this format | |||
| Id | Grade | Path(s) | Description | Expression |
| vn-birth-certificate-content-present | error | DocumentReference | Bản giấy chứng sinh phải có dữ liệu nhúng hoặc đường dẫn. The attachment SHALL carry either inline data or a URL. |
content.all(attachment.data.exists() or attachment.url.exists())
|
| vn-birth-certificate-gcs-identifier | error | DocumentReference | Mã giấy chứng sinh phải đúng dạng XXXXX.GCS.ZZZZZ.YY. The birth certificate identifier SHALL follow the published pattern. |
identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/gcs').value.all(matches('^[0-9]{5}\\.GCS\\.[0-9]{5}\\.[0-9]{2}$'))
|
| Name | Flags | Card. | Type | Description & Constraints Filter: | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| DocumentReference |
C | 0..* | VNCoreDocumentReference | A reference to a document Constraints: vn-document-number-issuer-scoped, vn-birth-certificate-gcs-identifier, vn-birth-certificate-content-present
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| id |
Σ | 0..1 | id | Logical id of this artifact | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| meta |
Σ | 0..1 | Meta | Metadata about the resource | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| implicitRules |
?!Σ | 0..1 | uri | A set of rules under which this content was created | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| language |
0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| text |
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 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| contained |
0..* | Resource | Contained, inline Resources | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
 Slices for extension |
0..* | Extension | Extension Slice: Unordered, Open by value:url | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| extension:paperConversion |
SOC | 0..1 | (Complex) | Bằng chứng chuyển đổi giấy ↔ điện tử theo Luật 20/2023/QH15 Điều 12 URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-paper-conversion Constraints: vn-paper-conversion-official-doc-signature
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
 modifierExtension |
?! | 0..* | Extension | Extensions that cannot be ignored | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| masterIdentifier |
Σ | 0..1 | Identifier | Master Version Specific Identifier | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Slices for identifier |
SOΣ | 1..* | Identifier | Other identifiers for the document Slice: Unordered, Open by value:system
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| identifier:gcs |
SOΣ | 1..1 | Identifier | Mã giấy chứng sinh (MA_GCS) — cùng mã với Composition tương ứng
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| id |
0..1 | string | Unique id for inter-element referencing | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| extension |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| use |
?!Σ | 0..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known . | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| type |
Σ | 0..1 | CodeableConcept | Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| system |
SΣ | 1..1 | uri | The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/gcs | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| value |
SΣ | 1..1 | string | The value that is unique Example General: 123456 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| period |
Σ | 0..1 | Period | Time period when id is/was valid for use | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| assigner |
Σ | 0..1 | Reference(Organization) | Organization that issued id (may be just text) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| status |
?!SOΣ | 1..1 | code | Trạng thái tài liệu (current | superseded | entered-in-error) Binding: DocumentReferenceStatus (required): The status of the document reference.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| docStatus |
Σ | 0..1 | code | preliminary | final | amended | entered-in-error Binding: CompositionStatus (required): Status of the underlying document. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| type |
SOΣ | 1..1 | CodeableConcept | Loại tài liệu y tế Binding: DocumentTypeValueSet (preferred): Precise type of clinical document.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| id |
0..1 | string | Unique id for inter-element referencing | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| extension |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| coding |
Σ | 0..* | Coding | Code defined by a terminology system | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| text |
SΣ | 1..1 | string | Plain text representation of the concept | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| category |
SOΣ | 0..* | CodeableConcept | Phân loại tài liệu (bệnh án, XN, CĐHA, đơn thuốc...) Binding: DocumentClassValueSet (example): High-level kind of a clinical document at a macro level.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| subject |
SOΣ | 1..1 | Reference(Bệnh nhân VN Core — VN Core Patient Profile) | Trẻ được cấp giấy chứng sinh
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| date |
SOΣ | 1..1 | instant | Thời điểm lập bản tài liệu
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| author |
SOΣ | 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)
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| authenticator |
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 xác nhận tài liệu; bằng chứng chữ ký số nằm ngoài Reference này | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| custodian |
SO | 1..1 | Reference(Cơ sở khám bệnh, chữa bệnh VN Core — VN Core KCB Organization Profile | Cơ sở y tế VN Core — VN Core Organization Profile) | Cơ sở y tế lưu trữ (theo TT 13/2025/TT-BYT)
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| relatesTo |
Σ | 0..* | BackboneElement | Relationships to other documents | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| id |
0..1 | string | Unique id for inter-element referencing | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| extension |
0..* | Extension | Additional content defined by implementations | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| code |
Σ | 1..1 | code | replaces | transforms | signs | appends Binding: DocumentRelationshipType (required): The type of relationship between documents. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| target |
Σ | 1..1 | Reference(DocumentReference) | Target of the relationship | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| description |
SOΣ | 0..1 | string | Mô tả nội dung tài liệu
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| securityLabel |
Σ | 0..* | CodeableConcept | Document security-tags Binding: All Security Labels (extensible): Security Labels from the Healthcare Privacy and Security Classification System. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| content |
SOΣ | 1..* | BackboneElement | Nội dung tài liệu (attachment hoặc URL)
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| id |
0..1 | string | Unique id for inter-element referencing | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| extension |
0..* | Extension | Additional content defined by implementations | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| attachment |
SΣ | 1..1 | Attachment | File đính kèm (PDF, CDA, hình ảnh DICOM, v.v.) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| id |
0..1 | string | Unique id for inter-element referencing | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| extension |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| contentType |
SΣ | 1..1 | code | application/pdf hoặc application/xml Binding: Mime Types (required): The mime type of an attachment. Any valid mime type is allowed. Example General: text/plain; charset=UTF-8, image/png | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| language |
Σ | 0..1 | code | Human language of the content (BCP-47) Binding: CommonLanguages (preferred): A human language.
Example General: en-AU | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| data |
S | 0..1 | base64Binary | Data inline, base64ed | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| url |
SΣ | 0..1 | url | Uri where the data can be found Example General: http://www.acme.com/logo-small.png | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| size |
Σ | 0..1 | unsignedInt | Number of bytes of content (if url provided) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| hash |
SΣ | 0..1 | base64Binary | Băm nội dung — cơ sở đối chiếu toàn vẹn bản lưu | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| title |
Σ | 0..1 | string | Label to display in place of the data Example General: Official Corporate Logo | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| creation |
SΣ | 1..1 | dateTime | Thời điểm tạo tệp — đối chiếu với ngày cấp NGAY_CS | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| format |
Σ | 0..1 | Coding | Format/content rules for the document Binding: DocumentReferenceFormatCodeSet (preferred): Document Format Codes. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| context |
SOΣ | 0..1 | BackboneElement | Ngữ cảnh lâm sàng
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| id |
0..1 | string | Unique id for inter-element referencing | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| extension |
0..* | Extension | Additional content defined by implementations | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| encounter |
S | 0..* | Reference(Lượt khám/nhập viện VN Core — VN Core Encounter Profile) | Lượt khám liên quan | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| event |
0..* | CodeableConcept | Main clinical acts documented Binding: v3 Code System ActCode (example): This list of codes represents the main clinical acts being documented. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| period |
SΣ | 0..1 | Period | Thời gian hiệu lực tài liệu | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| facilityType |
0..1 | CodeableConcept | Kind of facility where patient was seen Binding: FacilityTypeCodeValueSet (example): XDS Facility Type. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| practiceSetting |
0..1 | CodeableConcept | Additional details about where the content was created (e.g. clinical specialty) Binding: PracticeSettingCodeValueSet (example): Additional details about where the content was created (e.g. clinical specialty). | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| sourcePatientInfo |
0..1 | Reference(Patient) | Patient demographics from source | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| related |
S | 0..* | Reference(Resource) | Trỏ tới Composition có cấu trúc của cùng giấy chứng sinh | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Documentation for this format | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Name | Bên yêu cầu dữ liệu lõi (Data Requester) | Kho hồ sơ EMR (Repository) | Bên đáp ứng dữ liệu lõi (Data Responder) | Cổng liên thông thủ tục hành chính (e-Service Gateway) | Ứng dụng người dân (Citizen App) | Nguồn tạo hồ sơ lâm sàng (Document Source) |
|---|---|---|---|---|---|---|
| DocumentReference |
||||||
| Slices for extension |
||||||
| extension:paperConversion |
|
| ||||
| Slices for identifier |
| |||||
| identifier:gcs |
| |||||
| status |
|
| ||||
| type |
|
| ||||
| category |
|
| ||||
| subject |
|
| ||||
| date |
|
| ||||
| author |
|
| ||||
| custodian |
|
| ||||
| description |
|
| ||||
| content |
|
| ||||
| context |
|
| ||||
| Documentation for this format | ||||||
| Path | Status | Usage | ValueSet | Version | Source |
| DocumentReference.language | Base | preferred | Common Languages | 📍4.0.1 | FHIR Std. |
| DocumentReference.identifier:gcs.use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std. |
| DocumentReference.identifier:gcs.type | Base | extensible | IdentifierType | 📍4.0.1 | FHIR Std. |
| DocumentReference.status | Base | required | DocumentReferenceStatus | 📍4.0.1 | FHIR Std. |
| DocumentReference.docStatus | Base | required | CompositionStatus | 📍4.0.1 | FHIR Std. |
| DocumentReference.type | Base | preferred | Document Type Value Set | 📍4.0.1 | FHIR Std. |
| DocumentReference.category | Base | example | Document Class Value Set | 📍4.0.1 | FHIR Std. |
| DocumentReference.relatesTo.code | Base | required | DocumentRelationshipType | 📍4.0.1 | FHIR Std. |
| DocumentReference.securityLabel | Base | extensible | SecurityLabels | 📍4.0.1 | FHIR Std. |
| DocumentReference.content.attachment.contentType | Base | required | MimeType | 📍4.0.1 | FHIR Std. |
| DocumentReference.content.attachment.language | Base | preferred | Common Languages | 📍4.0.1 | FHIR Std. |
| DocumentReference.content.format | Base | preferred | DocumentReference Format Code Set | 📍4.0.1 | FHIR Std. |
| DocumentReference.context.event | Base | example | v3 Code System ActCode | 📦3.0.0 | THO v7.2 |
| DocumentReference.context.facilityType | Base | example | Facility Type Code Value Set | 📍4.0.1 | FHIR Std. |
| DocumentReference.context.practiceSetting | Base | example | Practice Setting Code Value Set | 📍4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| dom-2 | error | DocumentReference | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | DocumentReference | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | DocumentReference | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated |
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
|
| dom-5 | error | DocumentReference | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | DocumentReference | A resource should have narrative for robust management |
text.`div`.exists()
|
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
hasValue() or (children().count() > id.count())
|
| ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both |
extension.exists() != value.exists()
|
| vn-birth-certificate-content-present | error | DocumentReference | Bản giấy chứng sinh phải có dữ liệu nhúng hoặc đường dẫn. The attachment SHALL carry either inline data or a URL. |
content.all(attachment.data.exists() or attachment.url.exists())
|
| vn-birth-certificate-gcs-identifier | error | DocumentReference | Mã giấy chứng sinh phải đúng dạng XXXXX.GCS.ZZZZZ.YY. The birth certificate identifier SHALL follow the published pattern. |
identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/gcs').value.all(matches('^[0-9]{5}\\.GCS\\.[0-9]{5}\\.[0-9]{2}$'))
|
| vn-document-number-issuer-scoped | error | DocumentReference | Số văn bản nội bộ ghi dưới URI dùng tạm cấp quốc gia (http://fhir.hl7.org.vn/core/sid/document-number) phải kèm `assigner` chỉ rõ cơ sở cấp mã; khuyến nghị chính là mỗi cơ sở công bố URI riêng. A local document number recorded under the shared national placeholder URI SHALL name its assigning facility; per-facility namespace URIs are preferred. |
identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/document-number').all(assigner.exists())
|
| vn-paper-conversion-official-doc-signature | error | DocumentReference.extension:paperConversion | Khi tài liệu giấy được chuyển đổi là giấy phép, giấy chứng nhận, chứng chỉ, văn bản xác nhận hoặc văn bản chấp thuận do cơ quan, tổ chức có thẩm quyền phát hành thì bản điện tử phải có chữ ký số của bên thực hiện chuyển đổi — Luật 20/2023/QH15 Điều 12 khoản 1 điểm d. Converting an official credential SHALL carry the converter's digital signature. |
extension.where(url = 'officialDocument').value.ofType(boolean) = true implies extension.where(url = 'signatureEvidence').exists()
|
| Name | Bên yêu cầu dữ liệu lõi (Data Requester) | Kho hồ sơ EMR (Repository) | Bên đáp ứng dữ liệu lõi (Data Responder) | Cổng liên thông thủ tục hành chính (e-Service Gateway) | Ứng dụng người dân (Citizen App) | Nguồn tạo hồ sơ lâm sàng (Document Source) |
|---|---|---|---|---|---|---|
| DocumentReference |
||||||
| Slices for extension |
||||||
| extension:paperConversion |
|
| ||||
| Slices for identifier |
| |||||
| identifier:gcs |
| |||||
| status |
|
| ||||
| type |
|
| ||||
| category |
|
| ||||
| subject |
|
| ||||
| date |
|
| ||||
| author |
|
| ||||
| custodian |
|
| ||||
| description |
|
| ||||
| content |
|
| ||||
| context |
|
| ||||
| Documentation for this format | ||||||
Summary
Mandatory: 8 elements
Must-Support: 10 elements
Fixed: 1 element
Structures
This structure refers to these other structures:
Slices
This structure defines the following Slices:
Dạng xem phần tử chính
| Name | Flags | Card. | Type | Description & Constraints Filter: | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| DocumentReference |
C | 0..* | VNCoreDocumentReference | A reference to a document Constraints: vn-document-number-issuer-scoped, vn-birth-certificate-gcs-identifier, vn-birth-certificate-content-present
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| implicitRules |
?!Σ | 0..1 | uri | A set of rules under which this content was created | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Slices for extension |
Content/Rules for all slices | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| extension:paperConversion |
SOC | 0..1 | (Complex) | Bằng chứng chuyển đổi giấy ↔ điện tử theo Luật 20/2023/QH15 Điều 12 URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-paper-conversion Constraints: vn-paper-conversion-official-doc-signature
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| modifierExtension |
?! | 0..* | Extension | Extensions that cannot be ignored | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Slices for identifier |
SOΣ | 1..* | Identifier | Other identifiers for the document Slice: Unordered, Open by value:system
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| identifier:gcs |
SOΣ | 1..1 | Identifier | Mã giấy chứng sinh (MA_GCS) — cùng mã với Composition tương ứng
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| use |
?!Σ | 0..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known . | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| system |
SΣ | 1..1 | uri | The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/gcs | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| value |
SΣ | 1..1 | string | The value that is unique Example General: 123456 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| status |
?!SOΣ | 1..1 | code | Trạng thái tài liệu (current | superseded | entered-in-error) Binding: DocumentReferenceStatus (required): The status of the document reference.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| type |
SOΣ | 1..1 | CodeableConcept | Loại tài liệu y tế Binding: DocumentTypeValueSet (preferred): Precise type of clinical document.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| text |
SΣ | 1..1 | string | Plain text representation of the concept | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| category |
SOΣ | 0..* | CodeableConcept | Phân loại tài liệu (bệnh án, XN, CĐHA, đơn thuốc...) Binding: DocumentClassValueSet (example): High-level kind of a clinical document at a macro level.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| subject |
SOΣ | 1..1 | Reference(Bệnh nhân VN Core — VN Core Patient Profile) | Trẻ được cấp giấy chứng sinh
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| date |
SOΣ | 1..1 | instant | Thời điểm lập bản tài liệu
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| author |
SOΣ | 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)
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| custodian |
SO | 1..1 | Reference(Cơ sở khám bệnh, chữa bệnh VN Core — VN Core KCB Organization Profile | Cơ sở y tế VN Core — VN Core Organization Profile) | Cơ sở y tế lưu trữ (theo TT 13/2025/TT-BYT)
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| description |
SOΣ | 0..1 | string | Mô tả nội dung tài liệu
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| content |
SOΣ | 1..* | BackboneElement | Nội dung tài liệu (attachment hoặc URL)
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| attachment |
SΣ | 1..1 | Attachment | File đính kèm (PDF, CDA, hình ảnh DICOM, v.v.) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| contentType |
SΣ | 1..1 | code | application/pdf hoặc application/xml Binding: Mime Types (required): The mime type of an attachment. Any valid mime type is allowed. Example General: text/plain; charset=UTF-8, image/png | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| data |
S | 0..1 | base64Binary | Data inline, base64ed | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| url |
SΣ | 0..1 | url | Uri where the data can be found Example General: http://www.acme.com/logo-small.png | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| hash |
SΣ | 0..1 | base64Binary | Băm nội dung — cơ sở đối chiếu toàn vẹn bản lưu | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| creation |
SΣ | 1..1 | dateTime | Thời điểm tạo tệp — đối chiếu với ngày cấp NGAY_CS | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| context |
SOΣ | 0..1 | BackboneElement | Ngữ cảnh lâm sàng
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| encounter |
S | 0..* | Reference(Lượt khám/nhập viện VN Core — VN Core Encounter Profile) | Lượt khám liên quan | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| period |
SΣ | 0..1 | Period | Thời gian hiệu lực tài liệu | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| related |
S | 0..* | Reference(Resource) | Trỏ tới Composition có cấu trúc của cùng giấy chứng sinh | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Documentation for this format | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Name | Bên yêu cầu dữ liệu lõi (Data Requester) | Kho hồ sơ EMR (Repository) | Bên đáp ứng dữ liệu lõi (Data Responder) | Cổng liên thông thủ tục hành chính (e-Service Gateway) | Ứng dụng người dân (Citizen App) | Nguồn tạo hồ sơ lâm sàng (Document Source) |
|---|---|---|---|---|---|---|
| DocumentReference |
||||||
| Slices for extension |
||||||
| extension:paperConversion |
|
| ||||
| Slices for identifier |
| |||||
| identifier:gcs |
| |||||
| status |
|
| ||||
| type |
|
| ||||
| category |
|
| ||||
| subject |
|
| ||||
| date |
|
| ||||
| author |
|
| ||||
| custodian |
|
| ||||
| description |
|
| ||||
| content |
|
| ||||
| context |
|
| ||||
| Documentation for this format | ||||||
| Path | Status | Usage | ValueSet | Version | Source |
| DocumentReference.identifier:gcs.use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std. |
| DocumentReference.status | Base | required | DocumentReferenceStatus | 📍4.0.1 | FHIR Std. |
| DocumentReference.type | Base | preferred | Document Type Value Set | 📍4.0.1 | FHIR Std. |
| DocumentReference.category | Base | example | Document Class Value Set | 📍4.0.1 | FHIR Std. |
| DocumentReference.content.attachment.contentType | Base | required | MimeType | 📍4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| dom-2 | error | DocumentReference | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | DocumentReference | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | DocumentReference | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated |
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
|
| dom-5 | error | DocumentReference | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | DocumentReference | A resource should have narrative for robust management |
text.`div`.exists()
|
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
hasValue() or (children().count() > id.count())
|
| ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both |
extension.exists() != value.exists()
|
| vn-birth-certificate-content-present | error | DocumentReference | Bản giấy chứng sinh phải có dữ liệu nhúng hoặc đường dẫn. The attachment SHALL carry either inline data or a URL. |
content.all(attachment.data.exists() or attachment.url.exists())
|
| vn-birth-certificate-gcs-identifier | error | DocumentReference | Mã giấy chứng sinh phải đúng dạng XXXXX.GCS.ZZZZZ.YY. The birth certificate identifier SHALL follow the published pattern. |
identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/gcs').value.all(matches('^[0-9]{5}\\.GCS\\.[0-9]{5}\\.[0-9]{2}$'))
|
| vn-document-number-issuer-scoped | error | DocumentReference | Số văn bản nội bộ ghi dưới URI dùng tạm cấp quốc gia (http://fhir.hl7.org.vn/core/sid/document-number) phải kèm `assigner` chỉ rõ cơ sở cấp mã; khuyến nghị chính là mỗi cơ sở công bố URI riêng. A local document number recorded under the shared national placeholder URI SHALL name its assigning facility; per-facility namespace URIs are preferred. |
identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/document-number').all(assigner.exists())
|
| vn-paper-conversion-official-doc-signature | error | DocumentReference.extension:paperConversion | Khi tài liệu giấy được chuyển đổi là giấy phép, giấy chứng nhận, chứng chỉ, văn bản xác nhận hoặc văn bản chấp thuận do cơ quan, tổ chức có thẩm quyền phát hành thì bản điện tử phải có chữ ký số của bên thực hiện chuyển đổi — Luật 20/2023/QH15 Điều 12 khoản 1 điểm d. Converting an official credential SHALL carry the converter's digital signature. |
extension.where(url = 'officialDocument').value.ofType(boolean) = true implies extension.where(url = 'signatureEvidence').exists()
|
Dạng xem Differential
| Name | Flags | Card. | Type | Description & Constraints Filter: | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| DocumentReference |
C | 0..* | VNCoreDocumentReference | A reference to a document Constraints: vn-birth-certificate-gcs-identifier, vn-birth-certificate-content-present
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Slices for identifier |
SO | 1..* | Identifier | Other identifiers for the document Slice: Unordered, Open by value:system
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| identifier:gcs |
SO | 1..1 | Identifier | Mã giấy chứng sinh (MA_GCS) — cùng mã với Composition tương ứng
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| system |
S | 1..1 | uri | The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/gcs | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| value |
S | 1..1 | string | The value that is unique | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| type |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| text |
S | 1..1 | string | Plain text representation of the concept | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| subject |
1..1 | Reference(Bệnh nhân VN Core — VN Core Patient Profile) | Trẻ được cấp giấy chứng sinh | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| date |
1..1 | instant | Thời điểm lập bản tài liệu | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| custodian |
1..1 | Reference(Cơ sở khám bệnh, chữa bệnh VN Core — VN Core KCB Organization Profile | Cơ sở y tế VN Core — VN Core Organization Profile) | Cơ sở y tế lưu trữ (theo TT 13/2025/TT-BYT) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| content |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| attachment |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| contentType |
1..1 | code | application/pdf hoặc application/xml | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| data |
S | 0..1 | base64Binary | Data inline, base64ed | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| url |
S | 0..1 | url | Uri where the data can be found | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| hash |
S | 0..1 | base64Binary | Băm nội dung — cơ sở đối chiếu toàn vẹn bản lưu | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| creation |
S | 1..1 | dateTime | Thời điểm tạo tệp — đối chiếu với ngày cấp NGAY_CS | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| context |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| related |
S | 0..* | Reference(Resource) | Trỏ tới Composition có cấu trúc của cùng giấy chứng sinh | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Documentation for this format | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Name | Kho hồ sơ EMR (Repository) | Cổng liên thông thủ tục hành chính (e-Service Gateway) | Nguồn tạo hồ sơ lâm sàng (Document Source) |
|---|---|---|---|
| DocumentReference |
|||
| Slices for identifier |
| ||
| identifier:gcs |
| ||
| Documentation for this format | |||
| Id | Grade | Path(s) | Description | Expression |
| vn-birth-certificate-content-present | error | DocumentReference | Bản giấy chứng sinh phải có dữ liệu nhúng hoặc đường dẫn. The attachment SHALL carry either inline data or a URL. |
content.all(attachment.data.exists() or attachment.url.exists())
|
| vn-birth-certificate-gcs-identifier | error | DocumentReference | Mã giấy chứng sinh phải đúng dạng XXXXX.GCS.ZZZZZ.YY. The birth certificate identifier SHALL follow the published pattern. |
identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/gcs').value.all(matches('^[0-9]{5}\\.GCS\\.[0-9]{5}\\.[0-9]{2}$'))
|
Dạng xem SnapshotView
| Name | Flags | Card. | Type | Description & Constraints Filter: | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| DocumentReference |
C | 0..* | VNCoreDocumentReference | A reference to a document Constraints: vn-document-number-issuer-scoped, vn-birth-certificate-gcs-identifier, vn-birth-certificate-content-present
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| id |
Σ | 0..1 | id | Logical id of this artifact | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| meta |
Σ | 0..1 | Meta | Metadata about the resource | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| implicitRules |
?!Σ | 0..1 | uri | A set of rules under which this content was created | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| language |
0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| text |
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 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| contained |
0..* | Resource | Contained, inline Resources | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Slices for extension |
0..* | Extension | Extension Slice: Unordered, Open by value:url | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| extension:paperConversion |
SOC | 0..1 | (Complex) | Bằng chứng chuyển đổi giấy ↔ điện tử theo Luật 20/2023/QH15 Điều 12 URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-paper-conversion Constraints: vn-paper-conversion-official-doc-signature
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| modifierExtension |
?! | 0..* | Extension | Extensions that cannot be ignored | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| masterIdentifier |
Σ | 0..1 | Identifier | Master Version Specific Identifier | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Slices for identifier |
SOΣ | 1..* | Identifier | Other identifiers for the document Slice: Unordered, Open by value:system
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| identifier:gcs |
SOΣ | 1..1 | Identifier | Mã giấy chứng sinh (MA_GCS) — cùng mã với Composition tương ứng
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| id |
0..1 | string | Unique id for inter-element referencing | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| extension |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| use |
?!Σ | 0..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known . | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| type |
Σ | 0..1 | CodeableConcept | Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| system |
SΣ | 1..1 | uri | The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/gcs | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| value |
SΣ | 1..1 | string | The value that is unique Example General: 123456 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| period |
Σ | 0..1 | Period | Time period when id is/was valid for use | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| assigner |
Σ | 0..1 | Reference(Organization) | Organization that issued id (may be just text) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| status |
?!SOΣ | 1..1 | code | Trạng thái tài liệu (current | superseded | entered-in-error) Binding: DocumentReferenceStatus (required): The status of the document reference.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| docStatus |
Σ | 0..1 | code | preliminary | final | amended | entered-in-error Binding: CompositionStatus (required): Status of the underlying document. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| type |
SOΣ | 1..1 | CodeableConcept | Loại tài liệu y tế Binding: DocumentTypeValueSet (preferred): Precise type of clinical document.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| id |
0..1 | string | Unique id for inter-element referencing | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| extension |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| coding |
Σ | 0..* | Coding | Code defined by a terminology system | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| text |
SΣ | 1..1 | string | Plain text representation of the concept | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| category |
SOΣ | 0..* | CodeableConcept | Phân loại tài liệu (bệnh án, XN, CĐHA, đơn thuốc...) Binding: DocumentClassValueSet (example): High-level kind of a clinical document at a macro level.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| subject |
SOΣ | 1..1 | Reference(Bệnh nhân VN Core — VN Core Patient Profile) | Trẻ được cấp giấy chứng sinh
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| date |
SOΣ | 1..1 | instant | Thời điểm lập bản tài liệu
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| author |
SOΣ | 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)
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| authenticator |
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 xác nhận tài liệu; bằng chứng chữ ký số nằm ngoài Reference này | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| custodian |
SO | 1..1 | Reference(Cơ sở khám bệnh, chữa bệnh VN Core — VN Core KCB Organization Profile | Cơ sở y tế VN Core — VN Core Organization Profile) | Cơ sở y tế lưu trữ (theo TT 13/2025/TT-BYT)
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| relatesTo |
Σ | 0..* | BackboneElement | Relationships to other documents | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| id |
0..1 | string | Unique id for inter-element referencing | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| extension |
0..* | Extension | Additional content defined by implementations | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| code |
Σ | 1..1 | code | replaces | transforms | signs | appends Binding: DocumentRelationshipType (required): The type of relationship between documents. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| target |
Σ | 1..1 | Reference(DocumentReference) | Target of the relationship | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| description |
SOΣ | 0..1 | string | Mô tả nội dung tài liệu
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| securityLabel |
Σ | 0..* | CodeableConcept | Document security-tags Binding: All Security Labels (extensible): Security Labels from the Healthcare Privacy and Security Classification System. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| content |
SOΣ | 1..* | BackboneElement | Nội dung tài liệu (attachment hoặc URL)
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| id |
0..1 | string | Unique id for inter-element referencing | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| extension |
0..* | Extension | Additional content defined by implementations | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| attachment |
SΣ | 1..1 | Attachment | File đính kèm (PDF, CDA, hình ảnh DICOM, v.v.) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| id |
0..1 | string | Unique id for inter-element referencing | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| extension |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| contentType |
SΣ | 1..1 | code | application/pdf hoặc application/xml Binding: Mime Types (required): The mime type of an attachment. Any valid mime type is allowed. Example General: text/plain; charset=UTF-8, image/png | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| language |
Σ | 0..1 | code | Human language of the content (BCP-47) Binding: CommonLanguages (preferred): A human language.
Example General: en-AU | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| data |
S | 0..1 | base64Binary | Data inline, base64ed | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| url |
SΣ | 0..1 | url | Uri where the data can be found Example General: http://www.acme.com/logo-small.png | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| size |
Σ | 0..1 | unsignedInt | Number of bytes of content (if url provided) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| hash |
SΣ | 0..1 | base64Binary | Băm nội dung — cơ sở đối chiếu toàn vẹn bản lưu | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| title |
Σ | 0..1 | string | Label to display in place of the data Example General: Official Corporate Logo | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| creation |
SΣ | 1..1 | dateTime | Thời điểm tạo tệp — đối chiếu với ngày cấp NGAY_CS | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| format |
Σ | 0..1 | Coding | Format/content rules for the document Binding: DocumentReferenceFormatCodeSet (preferred): Document Format Codes. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| context |
SOΣ | 0..1 | BackboneElement | Ngữ cảnh lâm sàng
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| id |
0..1 | string | Unique id for inter-element referencing | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| extension |
0..* | Extension | Additional content defined by implementations | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| encounter |
S | 0..* | Reference(Lượt khám/nhập viện VN Core — VN Core Encounter Profile) | Lượt khám liên quan | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| event |
0..* | CodeableConcept | Main clinical acts documented Binding: v3 Code System ActCode (example): This list of codes represents the main clinical acts being documented. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| period |
SΣ | 0..1 | Period | Thời gian hiệu lực tài liệu | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| facilityType |
0..1 | CodeableConcept | Kind of facility where patient was seen Binding: FacilityTypeCodeValueSet (example): XDS Facility Type. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| practiceSetting |
0..1 | CodeableConcept | Additional details about where the content was created (e.g. clinical specialty) Binding: PracticeSettingCodeValueSet (example): Additional details about where the content was created (e.g. clinical specialty). | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| sourcePatientInfo |
0..1 | Reference(Patient) | Patient demographics from source | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| related |
S | 0..* | Reference(Resource) | Trỏ tới Composition có cấu trúc của cùng giấy chứng sinh | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Documentation for this format | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Name | Bên yêu cầu dữ liệu lõi (Data Requester) | Kho hồ sơ EMR (Repository) | Bên đáp ứng dữ liệu lõi (Data Responder) | Cổng liên thông thủ tục hành chính (e-Service Gateway) | Ứng dụng người dân (Citizen App) | Nguồn tạo hồ sơ lâm sàng (Document Source) |
|---|---|---|---|---|---|---|
| DocumentReference |
||||||
| Slices for extension |
||||||
| extension:paperConversion |
|
| ||||
| Slices for identifier |
| |||||
| identifier:gcs |
| |||||
| status |
|
| ||||
| type |
|
| ||||
| category |
|
| ||||
| subject |
|
| ||||
| date |
|
| ||||
| author |
|
| ||||
| custodian |
|
| ||||
| description |
|
| ||||
| content |
|
| ||||
| context |
|
| ||||
| Documentation for this format | ||||||
| Path | Status | Usage | ValueSet | Version | Source |
| DocumentReference.language | Base | preferred | Common Languages | 📍4.0.1 | FHIR Std. |
| DocumentReference.identifier:gcs.use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std. |
| DocumentReference.identifier:gcs.type | Base | extensible | IdentifierType | 📍4.0.1 | FHIR Std. |
| DocumentReference.status | Base | required | DocumentReferenceStatus | 📍4.0.1 | FHIR Std. |
| DocumentReference.docStatus | Base | required | CompositionStatus | 📍4.0.1 | FHIR Std. |
| DocumentReference.type | Base | preferred | Document Type Value Set | 📍4.0.1 | FHIR Std. |
| DocumentReference.category | Base | example | Document Class Value Set | 📍4.0.1 | FHIR Std. |
| DocumentReference.relatesTo.code | Base | required | DocumentRelationshipType | 📍4.0.1 | FHIR Std. |
| DocumentReference.securityLabel | Base | extensible | SecurityLabels | 📍4.0.1 | FHIR Std. |
| DocumentReference.content.attachment.contentType | Base | required | MimeType | 📍4.0.1 | FHIR Std. |
| DocumentReference.content.attachment.language | Base | preferred | Common Languages | 📍4.0.1 | FHIR Std. |
| DocumentReference.content.format | Base | preferred | DocumentReference Format Code Set | 📍4.0.1 | FHIR Std. |
| DocumentReference.context.event | Base | example | v3 Code System ActCode | 📦3.0.0 | THO v7.2 |
| DocumentReference.context.facilityType | Base | example | Facility Type Code Value Set | 📍4.0.1 | FHIR Std. |
| DocumentReference.context.practiceSetting | Base | example | Practice Setting Code Value Set | 📍4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| dom-2 | error | DocumentReference | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | DocumentReference | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | DocumentReference | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated |
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
|
| dom-5 | error | DocumentReference | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | DocumentReference | A resource should have narrative for robust management |
text.`div`.exists()
|
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
hasValue() or (children().count() > id.count())
|
| ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both |
extension.exists() != value.exists()
|
| vn-birth-certificate-content-present | error | DocumentReference | Bản giấy chứng sinh phải có dữ liệu nhúng hoặc đường dẫn. The attachment SHALL carry either inline data or a URL. |
content.all(attachment.data.exists() or attachment.url.exists())
|
| vn-birth-certificate-gcs-identifier | error | DocumentReference | Mã giấy chứng sinh phải đúng dạng XXXXX.GCS.ZZZZZ.YY. The birth certificate identifier SHALL follow the published pattern. |
identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/gcs').value.all(matches('^[0-9]{5}\\.GCS\\.[0-9]{5}\\.[0-9]{2}$'))
|
| vn-document-number-issuer-scoped | error | DocumentReference | Số văn bản nội bộ ghi dưới URI dùng tạm cấp quốc gia (http://fhir.hl7.org.vn/core/sid/document-number) phải kèm `assigner` chỉ rõ cơ sở cấp mã; khuyến nghị chính là mỗi cơ sở công bố URI riêng. A local document number recorded under the shared national placeholder URI SHALL name its assigning facility; per-facility namespace URIs are preferred. |
identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/document-number').all(assigner.exists())
|
| vn-paper-conversion-official-doc-signature | error | DocumentReference.extension:paperConversion | Khi tài liệu giấy được chuyển đổi là giấy phép, giấy chứng nhận, chứng chỉ, văn bản xác nhận hoặc văn bản chấp thuận do cơ quan, tổ chức có thẩm quyền phát hành thì bản điện tử phải có chữ ký số của bên thực hiện chuyển đổi — Luật 20/2023/QH15 Điều 12 khoản 1 điểm d. Converting an official credential SHALL carry the converter's digital signature. |
extension.where(url = 'officialDocument').value.ofType(boolean) = true implies extension.where(url = 'signatureEvidence').exists()
|
| Name | Bên yêu cầu dữ liệu lõi (Data Requester) | Kho hồ sơ EMR (Repository) | Bên đáp ứng dữ liệu lõi (Data Responder) | Cổng liên thông thủ tục hành chính (e-Service Gateway) | Ứng dụng người dân (Citizen App) | Nguồn tạo hồ sơ lâm sàng (Document Source) |
|---|---|---|---|---|---|---|
| DocumentReference |
||||||
| Slices for extension |
||||||
| extension:paperConversion |
|
| ||||
| Slices for identifier |
| |||||
| identifier:gcs |
| |||||
| status |
|
| ||||
| type |
|
| ||||
| category |
|
| ||||
| subject |
|
| ||||
| date |
|
| ||||
| author |
|
| ||||
| custodian |
|
| ||||
| description |
|
| ||||
| content |
|
| ||||
| context |
|
| ||||
| Documentation for this format | ||||||
Summary
Mandatory: 8 elements
Must-Support: 10 elements
Fixed: 1 element
Structures
This structure refers to these other structures:
Slices
This structure defines the following Slices:
Biểu diễn khác của hồ sơ: CSV, Excel, Schematron
