HL7 Vietnam VN Core FHIR Implementation Guide

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.6.0 - Draft for Community Review Viet Nam cờ

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Draft for Community Review (v0.6.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Chuẩn dữ liệu đầu ra BHYT (4210 → 3176)

Chuẩn dữ liệu đầu ra BHYT (XML 4210 → 3176) — BHYT Output Data Standard

Tại Việt Nam, định dạng dữ liệu đầu ra phục vụ giám định, thanh toán BHYT (quen gọi là "XML 4210") là nguồn dữ liệu thực tế chính chi phối hầu hết hệ thống thông tin bệnh viện (HIS/EMR/LIS/RIS). Đây là đặc thù quan trọng nhất khi thiết kế chuẩn hóa dữ liệu y tế cho Việt Nam: phần lớn cơ sở KCB đã có sẵn quy trình kết xuất bộ XML này để gửi cơ quan BHXH, nên thực tế nó đóng vai trò "xương sống" dữ liệu — quyết định trường nào được ghi nhận, mã hóa ra sao và gửi đi đâu.

Trang này tóm tắt đặc thù của bộ chuẩn này, tiến trình văn bản thay thế/kế thừa nó qua thời gian, trạng thái yêu cầu hiện hành, và quan hệ với VN Core FHIR. Cơ sở pháp lý đầy đủ xem Cơ sở pháp lý; cơ chế liên thông và quy tắc bắt buộc xem Liên thông hồ sơ BHYT.

Lưu ý thuật ngữ: "XML 4210" là cách gọi dân gian theo số hiệu văn bản gốc năm 2017; chuẩn dữ liệu đầu ra hiện hành không còn là QĐ 4210/QĐ-BYT mà là QĐ 3176/QĐ-BYT (trên nền QĐ 130/QĐ-BYT và QĐ 4750/QĐ-BYT). Dùng đúng số hiệu hiện hành khi viện dẫn.

1. Vì sao bộ chuẩn này là trục dữ liệu thực tế

  • Phủ rộng và bắt buộc nghiệp vụ: gần như mọi lượt KCB có BHYT đều phát sinh bộ dữ liệu XML gửi BHXH để giám định và thanh toán. Vì gắn trực tiếp với dòng tiền, bộ chuẩn này được tuân thủ nghiêm và cập nhật theo thực tế hơn nhiều chuẩn khác.
  • Là "mẫu số chung" của dữ liệu KCB: cấu trúc bảng XML (thông tin hành chính, chỉ định, thuốc, DVKT, chi phí, kết quả) phản ánh khá đầy đủ một lượt KCB → trở thành nguồn dữ liệu sẵn có nhất để ánh xạ sang FHIR.
  • Hệ quả thiết kế cho VN Core: VN Core chọn cách tiếp cận FHIR-native trước, gateway sau — mô hình hóa dữ liệu theo FHIR cho liên thông/EMR, rồi cung cấp lớp ánh xạ sang/từ bộ XML BHXH, thay vì lệ thuộc cứng vào cấu trúc XML (xem Liên thông hồ sơ BHYT).

2. Tiến trình văn bản (4210 và các bản kế thừa)

Văn bản Ban hành Vai trò Trạng thái
QĐ 4210/QĐ-BYT 20/09/2017 Chuẩn dữ liệu đầu ra XML phục vụ BHXH — bản gốc ("XML 4210") Hết hiệu lực (đã được kế thừa bởi QĐ 130/QĐ-BYT)
QĐ 130/QĐ-BYT 18/01/2023 Chuẩn dữ liệu đầu ra phục vụ BHXH — nền hiện hành của chuỗi Còn hiệu lực
QĐ 4750/QĐ-BYT 29/12/2023 Sửa đổi, bổ sung QĐ 130/QĐ-BYT Còn hiệu lực (trong chuỗi sửa đổi)
QĐ 3176/QĐ-BYT 29/10/2024 Chuẩn dữ liệu đầu ra KCB phục vụ BHXH — bản hiện hành mới nhất Còn hiệu lực
QĐ 2010/QĐ-BYT 19/06/2025 Danh mục mã tạm thời dùng chung (mã khoa, DVKT…) bổ trợ kết xuất Còn hiệu lực
QĐ 697/QĐ-BYT 19/03/2026 Mẫu bảng kê chi phí KCB (12 danh mục chi phí) — gắn với dữ liệu chi phí Chuyển tiếp (triển khai chậm nhất 01/07/2026)

Cách đọc chuỗi: bộ chuẩn không phải một văn bản đơn lẻ mà là một chuỗi xếp lớp — QĐ 4210/QĐ-BYT (2017) là bản gốc đã được kế thừa; QĐ 130/QĐ-BYT là nền, QĐ 4750/QĐ-BYT sửa đổi bổ sung QĐ 130/QĐ-BYT, và QĐ 3176/QĐ-BYT là bản đầu ra KCB hiện hành mới nhất. Khi triển khai, lấy QĐ 3176/QĐ-BYT làm chuẩn đầu ra hiện hành, đọc kèm QĐ 130/QĐ-BYT + QĐ 4750/QĐ-BYT cho phần nền và QĐ 2010/QĐ-BYT cho danh mục mã tạm thời.

3. Trạng thái yêu cầu hiện hành (cập nhật)

  • Chuẩn đầu ra hiện hành = QĐ 3176/QĐ-BYT (29/10/2024). Bộ XML BHXH vẫn đang là yêu cầu bắt buộc trên thực tế để giám định và thanh toán BHYT; chưa có văn bản chính thức thay bộ XML này bằng FHIR.
  • Giao dịch điện tử: việc gửi/nhận dữ liệu với cơ quan BHXH thực hiện theo NĐ 164/2025/NĐ-CP (29/06/2025) về giao dịch điện tử trong lĩnh vực BHXH (liên thông API Cổng BHXH, tra cứu thẻ BHYT — xem profile VNCoreCoverageEligibilityRequest/Response).
  • Bảng kê chi phí: QĐ 697/QĐ-BYT (19/03/2026) ban hành mẫu bảng kê chi phí KCB mới, triển khai phần mềm chậm nhất 01/07/2026 — ảnh hưởng trực tiếp tới phần chi phí/quyết toán (Claim/EOB).
  • Xu hướng FHIR: bệnh án điện tử theo TT 13/2025/TT-BYT (06/06/2025, hiệu lực 21/07/2025) và yêu cầu liên thông EMR/Sổ SKĐT đang tạo nhu cầu một lớp dữ liệu FHIR-native bên cạnh bộ XML BHXH. VN Core thiết kế để chạy song song: giữ kết xuất XML cho BHXH, đồng thời cung cấp mô hình FHIR cho liên thông — không hard-depend vào XML.

4. Quan hệ với VN Core FHIR

VN Core không sao chép cứng cấu trúc XML mà mô hình hóa FHIR-native + lớp ánh xạ:

Phạm vi ánh xạ hiện công bố là mapping ưu tiên/draft cho các trường trục, không phải conformance đầy đủ toàn bộ trường XML QĐ 3176/QĐ-BYT. Xem Liên thông hồ sơ BHYT để biết phạm vi đã/chưa công bố.

5. Khuyến nghị triển khai

  1. Lấy QĐ 3176/QĐ-BYT làm chuẩn đầu ra hiện hành; theo dõi QĐ 697/QĐ-BYT cho mốc bảng kê chi phí 01/07/2026.
  2. Chạy song song hai lớp: giữ kết xuất XML BHXH cho giám định/thanh toán; dùng FHIR cho liên thông EMR/Sổ SKĐT và trao đổi nội bộ/đa tuyến.
  3. Ánh xạ hai chiều qua một nguồn: dùng các ConceptMap/profile của VN Core làm điểm neo, tránh ánh xạ rời rạc mỗi hệ một kiểu.
  4. Viện dẫn đúng số hiệu hiện hành (QĐ 3176/QĐ-BYT), không dùng "4210" như chuẩn hiện hành trong tài liệu kỹ thuật/hợp đồng.

Liên hệ với các trang khác

Mục đích Trang
Cơ chế liên thông + quy tắc bắt buộc Liên thông hồ sơ BHYT
Toàn bộ căn cứ pháp lý Cơ sở pháp lý
Quyết định thiết kế (Core vs BHYT) Quyết định thiết kế
Mẫu bảng kê chi phí QĐ 697/QĐ-BYT Cơ sở pháp lý

English Summary

In Vietnam, the BHXH (social-health-insurance) XML output standard — colloquially "XML 4210" — is the de-facto primary data backbone for hospital systems, because it is tied to BHYT claim adjudication and payment. This page explains that specialty, traces the document chain (QĐ 4210/QĐ-BYT 2017, superseded → QĐ 130/QĐ-BYT 2023 → QĐ 4750/QĐ-BYT 2023 amending it → QĐ 3176/QĐ-BYT 2024, the current output standard; plus QĐ 2010/QĐ-BYT temporary code list and QĐ 697/QĐ-BYT cost-statement form effective 01/07/2026), and states the current requirement: the BHXH XML is still mandatory in practice; electronic submission follows NĐ 164/2025/NĐ-CP; no official FHIR replacement exists yet. VN Core stays FHIR-native first with a mapping layer (financial profiles, BHYT submission bundle, ConceptMaps for QĐ 3176/QĐ-BYT → adjudication and QĐ 697/QĐ-BYT cost groups), designed to run in parallel with the XML standard rather than hard-depending on it.