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/CapabilityStatement/vn-core-server | Phiên bản: 0.10.0 | ||||
| Computable Name: VNCoreServerCapabilityStatement | |||||
| Định danh khác: OID:2.25.161089673617632664299011809196868855799.13.10 | |||||
CapabilityStatement THAM CHIẾU TỔNG HỢP: liệt kê toàn bộ bề mặt tài nguyên VN Core IG định nghĩa. KHÔNG một hệ thống đơn lẻ nào phải triển khai tất cả — đây không phải 'minimum national core server'. Yêu cầu tuân thủ thật theo từng vai trò nằm ở VNCoreEMRServer, VNBHYTGatewayClient, VNBHYTGatewayServer, VNCitizenAppClient và nghĩa vụ máy-đọc-được theo actor (obligation extension, ActorDefinition vn-actor-*).
Raw OpenAPI-Swagger Definition file | Tải xuống
Language: vi
json, xmlNote to Implementers: FHIR Capabilities
Any FHIR capability may be 'allowed' by the system unless explicitly marked as 'SHALL NOT'. A few items are marked as MAY in the Implementation Guide to highlight their potential relevance to the use case.
serverMáy chủ triển khai theo CapabilityStatement này phải hỗ trợ JSON và XML, đồng thời công bố SMART on FHIR làm dịch vụ bảo mật tối thiểu của hợp đồng VN Core Server. Cơ chế uỷ quyền, phạm vi truy cập và cấu hình triển khai phải được xác định trong hợp đồng triển khai; tuân thủ FHIR hoặc CapabilityStatement này không tự chứng minh tuân thủ pháp luật về bảo vệ dữ liệu cá nhân.
SMART-on-FHIRSMART on FHIR là yêu cầu kỹ thuật của CapabilityStatement này, không phải cơ chế duy nhất được pháp luật chỉ định. Bên kiểm soát/xử lý dữ liệu phải đánh giá độc lập các nghĩa vụ áp dụng theo Luật 91/2025/QH15 và NĐ 356/2025/NĐ-CP; dữ liệu sức khoẻ thuộc nhóm dữ liệu cá nhân nhạy cảm. Xem Bảo mật và Quyền riêng tư.
transactioninteraction described as follows:Bundle type=transaction PHẢI nguyên tử: hoặc mọi entry được áp dụng, hoặc không entry nào. Máy chủ không bảo đảm được tính nguyên tử thì KHÔNG khai transaction.
batchinteraction described as follows:Bundle type=batch KHÔNG nguyên tử — mỗi entry thành/bại độc lập.
The summary table lists the resources that are part of this configuration, and for each resource it lists:
_include_revincludeliteralread, search-type.create, update, vread, history-instance.Bệnh nhân Việt Nam — VNCorePatient profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | identifier | token | Tìm theo CCCD, mã BHXH, GKS, hộ chiếu, MRN hoặc định danh khác |
| SHOULD | name | string | Tìm theo họ tên (hỗ trợ Unicode tiếng Việt) |
| SHOULD | birthdate | date | |
| SHOULD | gender | token | |
| SHOULD | vn-cccd | token | Tìm theo số CCCD 12 chữ số (Luật Căn cước 2023) |
| SHOULD | vn-bhyt | token | Tìm theo số thẻ BHYT (Luật BHYT) |
| SHOULD | vn-bhxh | token | Tìm theo mã số BHXH 10 chữ số |
| SHOULD | vn-gks | token | Tìm theo số Giấy khai sinh |
| Conformance | Operation | Documentation |
|---|---|---|
| SHOULD | $summary | Trả tóm tắt sức khoẻ IPS qua Patient/[id]/$summary hoặc Patient/$summary?identifier=system|value; hỗ trợ parameter profile khi máy chủ công bố profile kết quả tương ứng. |
literalread, search-type.create, update, vread, history-instance.Cha/mẹ/người giám hộ/người đại diện — VNCoreRelatedPerson profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | patient | reference | Tìm RelatedPerson theo bệnh nhân liên quan |
| SHOULD | identifier | token | Tìm theo CCCD hoặc hộ chiếu của người liên quan |
| SHOULD | name | string |
literalread, search-type.vread.Nhân viên y tế — VNCorePractitioner profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | identifier | token | Tìm theo GPHN hiện hành, CCCD, hoặc CCHN lịch sử |
| SHOULD | name | string | |
| SHOULD | vn-gphn | token | Tìm theo số Giấy phép hành nghề khám bệnh, chữa bệnh hiện hành |
| SHOULD | vn-cchn | token | Tìm theo số Chứng chỉ hành nghề lịch sử khi chuyển đổi dữ liệu cũ |
literalread, search-type.vread.Vai trò nhân viên y tế — VNCorePractitionerRole profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | practitioner | reference | |
| SHOULD | organization | reference | |
| SHOULD | location | reference |
literalKhoa/Phòng VN Core — VN Core Organization Department Profile
Cơ sở khám bệnh, chữa bệnh VN Core — VN Core KCB Organization Profile
read, search-type.vread.Cơ sở KCB — VNCoreOrganization profile; VNCoreOrganizationDepartment cho khoa/phòng (đơn vị thực hiện trong bản tin dữ liệu đầu ra); VNCoreKCBOrganization cho cơ sở có giấy phép hoạt động KCB — là supportedProfile chứ không phải profile mặc định vì không phải Organization nào trong hệ thống cũng là cơ sở KCB (nhà cung cấp, cơ quan BHXH, đơn vị quản lý)
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | identifier | token | Tìm theo mã CSKCB |
| SHOULD | name | string | |
| SHOULD | vn-cskcb | token | Tìm theo mã cơ sở KCB 5 số (QĐ 3176/QĐ-BYT) |
literalread, search-type.create, update, vread, history-instance.Khoa/phòng/địa điểm cung cấp dịch vụ — VNCoreLocation profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | identifier | token | Tìm theo mã khoa/phòng hoặc mã địa điểm nội bộ |
| SHOULD | organization | reference | Tìm các Location thuộc một Organization |
| SHOULD | partof | reference | Tìm các Location con |
| SHOULD | name | string | Tìm theo tên khoa/phòng/địa điểm |
literalread, search-type.create, update, vread, history-instance.Lượt khám/điều trị — VNCoreEncounter profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | patient | reference | |
| SHOULD | date | date | |
| SHOULD | status | token | |
| SHOULD | class | token | |
| SHOULD | vn-malydo | token | Tìm theo danh mục loại KCB BHYT legacy MA_LYDO_VVIEN — QĐ 4210/QĐ-BYT (2017). Chuẩn hiện hành QĐ 3176/QĐ-BYT dùng MA_DOI_TUONG_KCB với danh mục 27 mã theo QĐ 3276/QĐ-BYT (xem VNPatientVisitTypeCS). |
| SHOULD | vn-ma-luot-kcb | token | Tìm theo Identifier MA_LUOT_KCB dùng đối soát BHXH; system khuyến nghị = http://fhir.hl7.org.vn/core/sid/ma-luot-kcb |
| SHOULD | identifier | token | Tiêu chí đối sánh của |
literalread, search-type.create, vread.Chẩn đoán — VNCoreCondition profile; VNCoreConditionDiagnosis cho chẩn đoán có phân vai (chính/kèm theo/biến chứng) khi gửi dữ liệu BHYT
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | patient | reference | |
| SHOULD | code | token | Tìm theo mã ICD-10 VN hoặc Mã U (YHCT) |
| SHOULD | encounter | reference | |
| SHOULD | vn-icd10 | token | Tìm theo mã ICD-10 edition 2026 (TT 06/2026/TT-BYT + QĐ 1849/QĐ-BYT; dữ liệu trước 01/07/2026 mang mã theo chuỗi QĐ 4469/QĐ-BYT legacy) |
| SHOULD | identifier | token | Tiêu chí đối sánh của |
literalSinh hiệu VN Core — VN Core Observation Vital Signs Profile
Đánh giá YHCT VN Core — VN Core Observation Traditional Medicine Profile
Phân loại ưu tiên cấp cứu VN Core — VN Core Triage Acuity Observation
Phân loại sức khoẻ VN Core — VN Core Observation Health Classification Profile
Huyết áp VN Core — VN Core Observation Blood Pressure Profile
Chiều cao VN Core — VN Core Observation Body Height Profile
Cân nặng VN Core — VN Core Observation Body Weight Profile
Nhiệt độ cơ thể VN Core — VN Core Observation Body Temperature Profile
Mạch VN Core — VN Core Observation Heart Rate Profile
Nhịp thở VN Core — VN Core Observation Respiratory Rate Profile
SpO2 VN Core — VN Core Observation SpO2 Profile
read, search-type.create, vread.Kết quả xét nghiệm, sinh hiệu, quan sát YHCT, phân loại ưu tiên cấp cứu (triage) và phân loại sức khoẻ KSK — VNCoreObservationLab + VitalSigns + YHCT + TriageAcuity + HealthClassification profiles, kèm 7 profile sinh hiệu chuyên biệt (huyết áp, chiều cao, cân nặng, nhiệt độ, mạch, nhịp thở, SpO2)
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | combo-code | token | Tìm theo mã thuộc tính ở CẢ |
| SHALL | combo-value-concept | token | Tìm finding YHCT (và mọi coded result) trên cả Observation.valueCodeableConcept lẫn component.valueCodeableConcept — kiểu query thống nhất của pattern thuộc-tính + finding |
| SHOULD | patient | reference | |
| SHOULD | code | token | Tìm theo LOINC code |
| SHOULD | date | date | |
| SHOULD | category | token | |
| SHOULD | identifier | token | Tiêu chí đối sánh của |
literalread, search-type.create, update, vread, history-instance.Mẫu bệnh phẩm — VNCoreSpecimen profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | subject | reference | Tìm theo bệnh nhân cung cấp mẫu |
| SHOULD | type | token | Tìm theo loại mẫu bệnh phẩm |
| SHOULD | accession | token | Tìm theo mã tiếp nhận mẫu tại phòng xét nghiệm |
| SHOULD | identifier | token | Tiêu chí đối sánh của |
literalread, search-type.create, vread.Dị ứng — VNCoreAllergyIntolerance profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | patient | reference | |
| SHOULD | clinical-status | token | |
| SHOULD | identifier | token | Tiêu chí đối sánh của |
literalread, search-type.create, vread.Thủ thuật/phẫu thuật — VNCoreProcedure profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | patient | reference | |
| SHOULD | code | token | Tìm theo mã ICD-9-CM |
| SHOULD | date | date | |
| SHOULD | identifier | token | Tiêu chí đối sánh của |
literalread, search-type.vread.Thẻ BHYT — VNCoreCoverage profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | beneficiary | reference | Tìm theo bệnh nhân thụ hưởng BHYT |
| SHOULD | identifier | token | Tìm theo số thẻ BHYT qua Coverage.identifier (CCCD/BHXH/format cũ) |
| SHOULD | subscriber | reference | Tìm theo subscriber của Coverage |
| SHOULD | status | token | |
| SHOULD | vn-bhyt-card | token | Tìm theo số thẻ BHYT trong Coverage.identifier[BHYT] (NĐ 188/2025/NĐ-CP) |
| SHOULD | vn-ma-dkbd | token | Tìm theo mã nơi ĐKKCB ban đầu MA_DKBD |
literalread, search-type.create, update, vread, history-instance.Yêu cầu thanh toán KCB BHYT — VNCoreClaim profile (QĐ 3176/QĐ-BYT → QĐ 697/QĐ-BYT). Bảng kê chi phí theo mẫu QĐ 697/QĐ-BYT nằm ở Invoice (vn-core-cost-statement-invoice), không phải Claim
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | patient | reference | Tìm theo bệnh nhân |
| SHOULD | provider | reference | Tìm theo cơ sở KCB |
| SHOULD | status | token | |
| SHOULD | created | date | Tìm theo ngày tạo yêu cầu |
| SHOULD | vn-ma-lk | token | Tìm theo mã liên kết hồ sơ MA_LK |
| SHOULD | identifier | token | Tiêu chí đối sánh của |
| Conformance | Operation | Documentation |
|---|---|---|
| SHOULD | $reverse-bhyt-claim | Thu hồi/đảo hồ sơ BHYT đã gửi |
Gói tài liệu IPS VN Core — VN Core IPS Document Bundle Profile
Bundle chứng nhận sức khoẻ (SHC/SHL payload) — VN Core Health Credential Bundle
Bundle hồ sơ thanh toán BHYT — VNCoreBHYTSubmissionBundle profile; endpoint cho operations validate/submit. Ngoài ra hỗ trợ Bundle tài liệu: IPS (trao đổi quốc tế) và hồ sơ chứng nhận sức khoẻ
| Conformance | Operation | Documentation |
|---|---|---|
| SHOULD | $validate-bhyt-claim | Validate Bundle hồ sơ BHYT trước khi gửi Cổng giám định BHXH |
| SHOULD | $submit-bhyt-claim | Gửi hồ sơ thanh toán BHYT theo lớp liên thông hồ sơ BHYT |
literalQuyết định xử lý dựa trên căn cứ pháp lý — VN Core Legal-Basis Decision AuditEvent
read, search-type.create.Nhật ký truy cập/chia sẻ dữ liệu y tế — VNCoreAuditEvent profile; bản ghi quyết định căn cứ pháp lý khi xử lý dữ liệu cá nhân (bằng chứng theo NĐ 356/2025/NĐ-CP)
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | date | date | Tìm theo thời điểm ghi nhận audit |
| SHOULD | patient | reference | Tìm audit liên quan tới bệnh nhân |
| SHOULD | agent | reference | Tìm theo người/hệ thống thực hiện hành động |
literalread, search-type.create.Nguồn gốc và chữ ký số của tài liệu/hồ sơ y tế — VNCoreProvenance profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | target | reference | Tìm theo resource đích được ký/xác nhận |
| SHOULD | recorded | date | Tìm theo thời điểm ghi nhận provenance |
literalĐơn thuốc ngoại trú VN Core — VN Core Outpatient Prescription Profile
Đơn thuốc cổ truyền ngoại trú VN Core — VN Core Traditional-Medicine Outpatient Prescription Profile
read, search-type.create, update, vread, history-instance.Đơn thuốc — VNCoreMedicationRequest profile (TT 13/2025/TT-BYT, Luật Dược 2016); đơn ngoại trú hoá dược theo TT 26/2025/TT-BYT và đơn YHCT theo TT 27/2025/TT-BYT
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | patient | reference | Tìm theo bệnh nhân |
| SHOULD | status | token | |
| SHOULD | intent | token | |
| SHOULD | authoredon | date | Tìm theo ngày kê đơn |
| SHOULD | medication | reference | Tìm theo thuốc |
| SHOULD | identifier | token | Tiêu chí đối sánh của |
literalread, search-type.create, update, vread, history-instance.Yêu cầu DVKT/CLS — VNCoreServiceRequest profile (TT 13/2025/TT-BYT, TT 23/2024/TT-BYT)
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | patient | reference | Tìm theo bệnh nhân |
| SHOULD | status | token | |
| SHOULD | category | token | Tìm theo loại dịch vụ (XN, CĐHA, PT, TT...) |
| SHOULD | code | token | Tìm theo mã DVKT / ICD-9-CM |
| SHOULD | authored | date | Tìm theo ngày chỉ định |
| SHOULD | identifier | token | Tiêu chí đối sánh của |
literalread, search-type.create, vread.Tài liệu y tế / Bệnh án điện tử — VNCoreDocumentReference profile (TT 13/2025/TT-BYT)
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | patient | reference | Tìm theo bệnh nhân |
| SHOULD | type | token | Tìm theo loại tài liệu |
| SHOULD | date | date | Tìm theo thời điểm tạo |
| SHOULD | encounter | reference | Tìm theo lượt khám liên quan |
| SHOULD | custodian | reference | Tìm theo cơ sở y tế lưu trữ |
| SHOULD | identifier | token | Tiêu chí đối sánh của |
literalread, search-type.vread.Phản hồi thanh toán BHYT — VNCoreClaimResponse profile (QĐ 3176/QĐ-BYT, QĐ 697/QĐ-BYT)
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | patient | reference | Tìm theo bệnh nhân |
| SHOULD | request | reference | Tìm theo Claim gốc |
| SHOULD | status | token | |
| SHOULD | vn-xml1-id | token | Tìm theo XML1_ID/mã phản hồi gateway của hồ sơ BHYT |
literalread, search-type.vread.Giải trình quyền lợi BHYT — VNCoreExplanationOfBenefit profile (QĐ 697/QĐ-BYT); bản chi tiết theo khoản mục chi phí phục vụ người dân tra cứu
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | patient | reference | Tìm theo bệnh nhân |
| SHOULD | status | token | |
| SHOULD | created | date | Tìm theo ngày tạo |
literalBáo cáo Xét nghiệm VN Core — VN Core Lab DiagnosticReport
Báo cáo Chẩn đoán hình ảnh VN Core — VN Core Imaging DiagnosticReport
Báo cáo Giải phẫu bệnh VN Core — VN Core Pathology DiagnosticReport
read, search-type.create, vread.Kết quả cận lâm sàng — VNCoreDiagnosticReport profile (TT 13/2025/TT-BYT, QĐ 1227/QĐ-BYT); ba profile chuyên biệt cho xét nghiệm, chẩn đoán hình ảnh và giải phẫu bệnh
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | patient | reference | Tìm theo bệnh nhân |
| SHOULD | code | token | Tìm theo loại báo cáo (LOINC) |
| SHOULD | date | date | Tìm theo ngày báo cáo |
| SHOULD | category | token | Tìm theo nhóm CLS (XN, CĐHA, GPB) |
| SHOULD | encounter | reference | Tìm theo lượt khám liên quan |
| SHOULD | identifier | token | Tiêu chí đối sánh của |
literalread, search-type.vread.Thuốc — VNCoreMedication profile (Luật Dược 2016, ATC/SNOMED CT)
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | code | token | Tìm theo mã thuốc (ATC, SNOMED CT) |
| SHOULD | status | token |
literalThiết bị cấy ghép VN Core — VN Core Implantable Device Profile
read, search-type.vread.Trang thiết bị y tế — VNCoreDevice profile; thiết bị cấy ghép gắn người bệnh dùng thêm VNCoreImplantableDevice
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | type | token | Tìm theo loại thiết bị |
| SHOULD | status | token | |
| SHOULD | vn-device-group | token | Tìm TBYT theo nhóm BHYT (N01–N09) |
| SHOULD | vn-ma-vat-tu | token | Tìm TBYT theo mã vật tư y tế |
| SHOULD | vn-registration-number | token | Tìm TBYT theo số đăng ký lưu hành |
| SHOULD | vn-risk-class | token | Tìm TBYT theo phân loại rủi ro A/B/C/D (NĐ 98/2021/NĐ-CP) |
literalread, search-type.vread.Sử dụng TBYT cho bệnh nhân — VNCoreDeviceUseStatement profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | patient | reference | Tìm theo bệnh nhân |
| SHOULD | device | reference | Tìm theo thiết bị |
literalread, search-type.create, update, vread, history-instance.Đồng ý xử lý DLCN y tế — VNCoreConsent profile (Luật 91/2025/QH15)
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | patient | reference | Tìm theo bệnh nhân |
| SHOULD | status | token | Tìm theo trạng thái (active, rejected, inactive) |
| SHOULD | category | token | Tìm theo loại đồng ý |
| SHOULD | date | date | Tìm theo ngày đồng ý |
| SHOULD | identifier | token | Tiêu chí đối sánh của |
literalGiấy khám sức khoẻ định kỳ VN Core — VN Core Health Checkup Composition Profile
Sổ Sức khoẻ điện tử VN Core — VN Core Health Record Summary (Patient Summary) Profile
Sổ Sức khoẻ điện tử bản IPS quốc tế — VN Core IPS Composition Profile
Thông báo vi phạm DLCN (Mẫu 08) — VN Core Breach Notification Composition Profile
Bản ghi attestation bảng kê chi phí khám bệnh, chữa bệnh — VN Core Cost Statement Composition
read, search-type.create, update, vread, history-instance.Bệnh án điện tử + giấy KSK + Sổ SKĐT (nội địa & bản IPS quốc tế) — VNCoreComposition + HealthCheckup/HealthRecordSummary/IPS profiles (TT 13/2025/TT-BYT, QĐ 1332/QĐ-BYT, QĐ 1551/QĐ-BYT hợp nhất QĐ 2062/QĐ-BYT); thông báo vi phạm dữ liệu cá nhân theo Mẫu số 08 NĐ 356/2025/NĐ-CP
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | patient | reference | Tìm theo bệnh nhân |
| SHOULD | type | token | Tìm theo loại bệnh án (LOINC) |
| SHOULD | date | date | Tìm theo ngày lập bệnh án |
| SHOULD | encounter | reference | Tìm theo lượt khám |
| SHOULD | identifier | token | Tiêu chí đối sánh của |
literalread, search-type.create, update, vread, history-instance.Đợt chăm sóc — VNCoreEpisodeOfCare profile (TT 13/2025/TT-BYT)
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | patient | reference | |
| SHOULD | status | token | |
| SHOULD | type | token | |
| SHOULD | identifier | token | Tiêu chí đối sánh của |
literalread, search-type.create, update, vread, history-instance.Kế hoạch chăm sóc — VNCoreCarePlan profile (TT 13/2025/TT-BYT)
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | patient | reference | |
| SHOULD | status | token | |
| SHOULD | category | token | |
| SHOULD | date | date | |
| SHOULD | identifier | token | Tiêu chí đối sánh của |
literalread, search-type.create, update, vread, history-instance.Nhóm chăm sóc — VNCoreCareTeam profile (TT 13/2025/TT-BYT, Luật KCB 2023)
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | patient | reference | |
| SHOULD | status | token | |
| SHOULD | identifier | token | Tiêu chí đối sánh của |
literalread, search-type.create, vread.Mục tiêu điều trị — VNCoreGoal profile (TT 13/2025/TT-BYT)
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | patient | reference | |
| SHOULD | lifecycle-status | token | |
| SHOULD | category | token | |
| SHOULD | identifier | token | Tiêu chí đối sánh của |
literalread, search-type.create, vread.Nhận định lâm sàng — VNCoreClinicalImpression profile (TT 13/2025/TT-BYT)
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | patient | reference | |
| SHOULD | status | token | |
| SHOULD | date | date | |
| SHOULD | identifier | token | Tiêu chí đối sánh của |
literalread, search-type.create, vread.Tiền sử dùng thuốc — VNCoreMedicationStatement profile (TT 13/2025/TT-BYT)
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | patient | reference | |
| SHOULD | status | token | |
| SHOULD | identifier | token | Tiêu chí đối sánh của |
literalread, search-type.create, vread.Cấp phát thuốc — VNCoreMedicationDispense profile (TT 13/2025/TT-BYT, TT 26/2025/TT-BYT)
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | patient | reference | |
| SHOULD | status | token | |
| SHOULD | identifier | token | Tiêu chí đối sánh của |
literalread, search-type.create, vread.Cho dùng thuốc — VNCoreMedicationAdministration profile (TT 13/2025/TT-BYT)
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | patient | reference | |
| SHOULD | context | reference | |
| SHOULD | status | token | |
| SHOULD | identifier | token | Tiêu chí đối sánh của |
literalread, search-type.create, vread.Tiền sử gia đình — VNCoreFamilyMemberHistory profile (QĐ 1551/QĐ-BYT, TT 13/2025/TT-BYT)
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | patient | reference | |
| SHOULD | status | token | |
| SHOULD | identifier | token | Tiêu chí đối sánh của |
literalread, search-type.vread.Mẫu phiếu KSK — VNCoreQuestionnaire profile (QĐ 2062/QĐ-BYT Phụ lục 01, HL7 SDC); 3 mẫu theo nhóm tuổi VNKSKQuestionnaireU06/06to18/18Plus + mẫu tâm thần VNKSKQuestionnaireMental (TT 25/2026/TT-BYT). 17 mẫu QĐ 1551/QĐ-BYT (VNKSKQuestionnaire01–17) đã retired.
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | url | uri | |
| SHOULD | status | token |
literalread, search-type.create, vread.Kết quả phiếu KSK — VNCoreQuestionnaireResponse profile (QĐ 2062/QĐ-BYT Phụ lục 01, TT 13/2025/TT-BYT); bản máy đọc được của thông báo vi phạm dữ liệu cá nhân (Mẫu số 08 NĐ 356/2025/NĐ-CP)
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | patient | reference | |
| SHOULD | questionnaire | reference | |
| SHOULD | status | token | |
| SHOULD | identifier | token | Tiêu chí đối sánh của |
read, search-type.create, vread.Tiêm chủng — VNCoreImmunization profile (Luật 114/2025/QH15 — đang áp dụng từ 01/07/2026; TCMR)
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | patient | reference | Tìm theo bệnh nhân |
| SHOULD | status | token | Tìm theo trạng thái (completed, entered-in-error, not-done) |
| SHOULD | date | date | Tìm theo ngày tiêm |
| SHOULD | identifier | token | Tiêu chí đối sánh của |
literalread, search-type, create, vread.Hai miền sự cố, hai profile: VNCoreAdverseEventPostImmunization cho sự cố bất lợi sau tiêm chủng (TT 13/2026/TT-BYT; NĐ 165/2026/NĐ-CP), VNCoreAdverseEventPatientSafety cho sự cố y khoa trong khám bệnh, chữa bệnh (TT 43/2018/TT-BYT). Cả hai còn draft.
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | subject | reference | Tìm theo người được tiêm chủng |
| SHOULD | date | date | Tìm theo thời điểm xảy ra sự cố |
| SHOULD | seriousness | token | Lọc tai biến nặng (serious-aefi) khỏi phản ứng thông thường (common-reaction) — cần cho nghĩa vụ báo cáo 24 giờ theo TT 13/2026/TT-BYT Điều 15 khoản 5 điểm a |
| SHOULD | identifier | token | Tiêu chí đối sánh của |
literalread, search-type.vread.Chẩn đoán hình ảnh — VNCoreImagingStudy profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | patient | reference | Tìm theo bệnh nhân |
| SHOULD | status | token | Tìm theo trạng thái (available, cancelled, entered-in-error) |
literalread, search-type.vread.Dịch vụ y tế — VNCoreHealthcareService profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | organization | reference | Tìm theo cơ sở cung cấp dịch vụ |
| SHOULD | active | token | Tìm theo trạng thái hoạt động |
literalread, search-type, vread.Lịch hẹn khám và phiếu hẹn khám lại — VNCoreAppointment profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | patient | reference | Tìm lịch hẹn theo bệnh nhân |
| SHOULD | date | date | Tìm theo ngày hẹn |
| SHOULD | status | token | Tìm theo trạng thái lịch hẹn (booked, arrived, fulfilled, cancelled, noshow) |
literalread, search-type, vread.Lịch làm việc của người hành nghề hoặc dịch vụ — VNCoreSchedule profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | actor | reference | Tìm theo người hành nghề, khoa/phòng hoặc dịch vụ |
| SHOULD | date | date |
literalread, search-type, vread.Khung giờ trống để đặt lịch — VNCoreSlot profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | schedule | reference | |
| SHOULD | status | token | Tìm theo trạng thái khung giờ (free, busy, busy-unavailable) |
literalread, search-type, vread.Nhiệm vụ điều phối giữa các hệ thống — VNCoreTask profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | patient | reference | |
| SHOULD | status | token | Tìm theo trạng thái nhiệm vụ (requested, in-progress, completed, rejected) |
literalread, search-type, vread.Nhóm đối tượng khám sức khoẻ hoặc tiêm chủng — VNCoreGroup profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | type | token | |
| SHOULD | code | token |
literalread, search-type, vread.Đối soát thanh toán chi phí KCB BHYT — VNCorePaymentReconciliation profile (TT 12/2026/TT-BTC)
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | created | date | Tìm theo kỳ đối soát |
| SHOULD | status | token |
literalread, search-type, vread.Định nghĩa chỉ số đo lường chất lượng — VNCoreMeasure profile (TT 35/2024/TT-BYT)
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | status | token |
literalread, search-type, vread.Kết quả đo lường chất lượng của cơ sở KCB — VNCoreMeasureReport profile (TT 35/2024/TT-BYT)
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | measure | reference | |
| SHOULD | period | date |
literalread, search-type.vread.Bảng kê chi phí khám bệnh, chữa bệnh theo mẫu QĐ 697/QĐ-BYT — chứng từ cơ sở phát hành cho người bệnh. Phủ được cả ca người KHÔNG có thẻ bảo hiểm y tế (Phần Hai của mẫu), điều mà trục Claim không làm được vì Claim.insurance là 1..* (ADR-0021).
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | identifier | token | Tra bảng kê theo mã liên kết hồ sơ (MA_LK) |
| SHALL | subject | reference | |
| SHOULD | date | date |
literalread, search-type, vread.Dòng chi phí phát sinh, nối về đợt khám bệnh, chữa bệnh qua
contextvà về y lệnh quaservice— mắt xích truy vết mà Invoice của FHIR R4 không tự có.
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | context | reference | Tra mọi khoản chi phí của một đợt khám bệnh, chữa bệnh |
| SHOULD | subject | reference |
literalread, search-type, vread.Bảng giá dịch vụ của cơ sở, kèm mốc hiệu lực và đường tra ngược về quyết định phê duyệt. Từ 01/01/2025 không còn khung giá quốc gia thống nhất theo hạng bệnh viện; giá do cấp có thẩm quyền phê duyệt cho từng cơ sở theo TT 21/2024/TT-BYT.
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHOULD | context-type | token |