Nhà cung cấp HIS / EMR
Sinh resource đúng profile và workflow VN Core đã chọn; chỉ gửi bệnh án/BHYT khi giao diện áp dụng yêu cầu.
VNCoreEMRServer →Conformance
Tuân thủ VN Core là profile + API + kiểm thử, không chỉ validate JSON.
Trang này tóm tắt cách chứng minh một hệ thống tuân thủ VN Core và liên kết tới các trang kỹ thuật chi tiết trong Implementation Guide. Mức độ tuân thủ được xác định theo VAI TRÒ (sender, receiver, server, client) và theo GÓI (package) bạn triển khai.
Bạn là ai?
Mỗi vai trò có một CapabilityStatement riêng nêu rõ interaction và search ở mức SHALL/SHOULD/MAY. Chọn vai trò gần nhất với hệ thống của bạn.
FHIR server nội bộ bệnh viện
Công bố read/search, profile, search parameter, _include/_revinclude và cơ chế authorization thực sự hỗ trợ.
VNCoreServer →Gateway giám định BHYT
Map XML 4210/3176 ↔ FHIR Claim/Coverage, validate trước khi gửi Cổng BHXH.
VNBHYTGatewayServer/Client →Ứng dụng người dân / PHR
Đọc dữ liệu trong phạm vi endpoint và authorization đã công bố; áp dụng chính sách đồng ý/quyền truy cập khi use case yêu cầu.
VNCitizenAppClient →Cơ quan quản lý / kiến trúc tiêu chuẩn
Đặt ngưỡng tuân thủ tối thiểu, đánh giá bằng chứng sẵn sàng của đơn vị triển khai.
Conformance theo actor →Must Support nghĩa là gì
Must Support là cam kết theo vai trò, không phải cardinality bắt buộc. Hiểu sai điểm này là lỗi tuân thủ phổ biến nhất.
| Vai trò | Nghĩa vụ Must Support |
|---|---|
| Hệ thống GỬI (Producer) | Phải điền phần tử Must Support khi nguồn dữ liệu CÓ giá trị. Khi không có, dùng Data Absent Reason đúng quy ước thay vì bịa giá trị giả. |
| Hệ thống NHẬN (Consumer) | Phải xử lý/lưu trữ được phần tử Must Support khi nhận, không được loại bỏ âm thầm. Không bắt buộc tự sinh dữ liệu. |
| FHIR Server | Khai báo profile hỗ trợ qua supportedProfile + mức kỳ vọng SHALL/SHOULD/MAY cho mỗi interaction/search trong CapabilityStatement. |
| Client | Tuân theo CapabilityStatement của vai trò: chỉ dựa vào interaction/search được khai là SHALL; coi SHOULD/MAY là tùy chọn. |
Quy trình kiểm thử tuân thủ
Sáu bước có thể tái lập để chuyển từ "JSON hợp lệ" sang "tuân thủ VN Core có bằng chứng".
1
Cài package đúng phạm vi
Chọn gói theo nhu cầu: hl7.fhir.vn.core.base (nền), hl7.fhir.vn.bhyt.submission (giám định BHYT), hl7.fhir.vn.terminology.clinical / traditional-medicine, hl7.fhir.vn.device. Tải tại trang Downloads của IG.
Tải package →2
Validate resource bằng $validate
Chạy validator chính thức (HL7 FHIR Validator) với package VN Core. Mọi instance phải qua FHIRPath invariants Tầng 1 (vd vn-cccd-format, vn-addr-province) trước khi nói tới Must Support.
Hướng dẫn validation 3 tầng →3
Kiểm tra Must Support theo vai trò
Hệ thống gửi (producer) phải điền các phần tử Must Support khi có dữ liệu; hệ thống nhận (consumer) phải xử lý được khi nhận. Đối chiếu nghĩa Must Support trong VN Core, không nhầm với "bắt buộc phải có giá trị".
Must Support guidance →4
Test search + operation
Server: kiểm các search parameter và tổ hợp quan trọng (Patient/MPI, Encounter, Claim theo MA_LK, Coverage/BHYT) + _include/_revinclude theo CapabilityStatement. Kiểm operation áp dụng: $summary (IPS), $validate, luồng nộp BHYT.
Search & interaction →5
Đối chiếu OperationOutcome
Khi validate thất bại, mã OperationOutcome phải khớp registry quy tắc của IG (Tầng 2/3). Đây là bằng chứng kiểm thử có thể tái lập, không chỉ "JSON hợp lệ".
OperationOutcome rules →6
Tự đánh giá sẵn sàng & gửi báo cáo
Dùng checklist sẵn sàng pilot làm bằng chứng tuân thủ. Gửi implementation report (kèm gap thực tế) để đóng góp cho cộng đồng và lộ trình nâng mức độ trưởng thành.
Checklist sẵn sàng pilot →Bảo mật & quyền riêng tư
Mỗi triển khai phải xác định baseline bảo mật theo vai trò, luồng dữ liệu và threat model. OAuth 2.0/SMART có thể dùng cho authorization khi endpoint công bố hỗ trợ; Consent, AuditEvent và Provenance chỉ biểu diễn các lựa chọn, sự kiện và nguồn gốc mà policy/event model áp dụng. Các Resource này không tự tạo tuân thủ Luật 91/2025/QH15 hay NĐ 356/2025/NĐ-CP.