Mục đích, đối tượng áp dụng, điều kiện phát sinh và phương thức cung cấp dữ liệu
Hệ thống dữ liệu đầu ra phục vụ quản lý, giám định, thanh toán chi phí khám bệnh, chữa bệnh và giải quyết các chế độ liên quan không phải là một file XML duy nhất. Chuẩn dữ liệu được tổ chức thành nhiều bảng, mỗi bảng phản ánh một lớp thông tin khác nhau của quá trình khám bệnh, chữa bệnh hoặc một loại chứng từ, hồ sơ chuyên biệt. Vì vậy, khi kiểm tra một hồ sơ không được mặc định rằng mọi bảng đều phải xuất hiện trong mọi lần khám bệnh, chữa bệnh.
Quyết định 130/QĐ-BYT ban đầu quy định Bảng check-in và các Bảng 1 đến 12, trong đó Bảng 1–5 phục vụ cung cấp thông tin chi tiết về KCB để quản lý, giám định, thanh toán và quyết toán; Bảng 6 phục vụ quản lý điều trị HIV; Bảng 7–11 phục vụ tạo lập các chứng từ liên quan chế độ BHXH; Bảng 12 phục vụ giám định y khoa. Các phiên bản sửa đổi, bổ sung sau đó đã làm thay đổi nội dung các bảng và mở rộng chuẩn với các Bảng 13–15.
Do đó, nguyên tắc đọc ma trận này là:
Bảng tồn tại trong chuẩn không đồng nghĩa bảng phải phát sinh ở mọi hồ sơ.
Việc một bảng có cần cung cấp hay không phải được xác định theo:
đối tượng người bệnh + loại hình KCB + sự kiện thực tế đã phát sinh + loại chứng từ cần tạo lập + phiên bản chuẩn áp dụng.
Đối với các Bảng 1–11, Quyết định 130 quy định cơ sở KCB gửi các bảng liên quan lên Cổng tiếp nhận tùy theo đối tượng và mục đích của người bệnh trong đợt KCB, theo quy định về trích chuyển dữ liệu điện tử. Riêng Bảng 12 được cơ sở giám định y khoa nhập trực tiếp trên Cổng.
1. Ma trận tổng hợp
| Bảng | Tên bảng | Mục đích chính | Đối tượng/phạm vi áp dụng | Điều kiện phát sinh dữ liệu | Phương thức cung cấp dữ liệu |
|---|---|---|---|---|---|
| Check-in | Bảng chỉ tiêu dữ liệu về trạng thái KCB | Thông báo trạng thái KCB của người bệnh trên Cổng; không dùng làm căn cứ giám định, thanh toán, quyết toán | Người bệnh KCB thuộc các trường hợp phải gửi trạng thái | Gửi sau khi phát sinh chi phí KCB đầu tiên; nếu vào điều trị nội trú, nội trú ban ngày hoặc điều trị ngoại trú thì gửi tiếp khi phát sinh chi phí đầu tiên tại khoa điều trị; có các trường hợp được miễn gửi theo quy định | Gửi điện tử lên Cổng tiếp nhận |
| XML1 | Chỉ tiêu tổng hợp khám bệnh, chữa bệnh | Mô tả tổng thể một lần/đợt KCB: người bệnh, BHYT, chẩn đoán, thời gian, kết quả điều trị, tổng chi phí và nguồn thanh toán | Hồ sơ KCB được trích chuyển để quản lý, giám định, thanh toán, quyết toán | Là bảng lõi của đợt KCB khi cung cấp dữ liệu KCB; các bảng chi tiết liên kết với đợt KCB tương ứng | Gửi XML lên Cổng cùng hồ sơ KCB theo quy định trích chuyển |
| XML2 | Chỉ tiêu chi tiết thuốc | Cung cấp chi tiết thuốc, dịch truyền, máu/chế phẩm máu và các khoản liên quan được thống kê theo cấu trúc bảng | Người bệnh có dữ liệu sử dụng/chi phí thuộc nhóm được biểu diễn tại XML2 | Phát sinh khi đợt KCB có các dòng thuốc, máu, chế phẩm máu hoặc nội dung tương ứng cần cung cấp | Gửi cùng bộ XML KCB lên Cổng |
| XML3 | Chỉ tiêu chi tiết dịch vụ kỹ thuật và vật tư y tế | Cung cấp chi tiết tiền khám, giường, DVKT, VTYT, số lượng, giá, người chỉ định/thực hiện, khoa, máy và chi phí | Người bệnh có dịch vụ, tiền khám, giường, VTYT hoặc khoản chi thuộc cấu trúc XML3 | Phát sinh theo từng business event/dòng chi phí có nội dung thuộc XML3 | Gửi cùng bộ XML KCB lên Cổng |
| XML4 | Chỉ tiêu chi tiết dịch vụ cận lâm sàng | Cung cấp kết quả chỉ số xét nghiệm, thăm dò chức năng và các dữ liệu kết quả CLS tương ứng | Người bệnh có thực hiện DVKT cận lâm sàng thuộc phạm vi bảng | Chỉ gửi khi người bệnh có thực hiện dịch vụ cận lâm sàng | Gửi XML lên Cổng; kết quả có sau thời điểm kết thúc KCB được bổ sung theo cơ chế hồ sơ thay thế tương ứng |
| XML5 | Chỉ tiêu chi tiết diễn biến lâm sàng | Cung cấp diễn biến, giai đoạn bệnh, hội chẩn, phẫu thuật/thủ thuật, thời điểm và người ghi nhận diễn biến | Các loại điều trị có yêu cầu cung cấp diễn biến lâm sàng | Chỉ gửi đối với các loại hình điều trị được quy định, gồm điều trị ngoại trú tương ứng, nội trú, nội trú ban ngày, lưu tại TYT/PKĐKKV và trường hợp điều trị nội trú dưới 4 giờ theo chuẩn áp dụng | Gửi cùng bộ XML KCB lên Cổng |
| XML6 | Chỉ tiêu hồ sơ bệnh án chăm sóc và điều trị HIV/AIDS | Quản lý thông tin chăm sóc và điều trị người nhiễm HIV/phơi nhiễm HIV | Người bệnh thuộc chương trình/chăm sóc, điều trị HIV/AIDS | Phát sinh khi có hồ sơ điều trị HIV/AIDS tương ứng | Gửi XML lên Cổng theo quy định trích chuyển; đồng thời gửi HMED khi có hướng dẫn của cơ quan quản lý HIV/AIDS |
| XML7 | Chỉ tiêu dữ liệu giấy ra viện | Tạo lập dữ liệu điện tử của giấy ra viện, phục vụ các chế độ liên quan | Người bệnh được cấp giấy ra viện theo trường hợp áp dụng | Phát sinh khi cơ sở tạo lập giấy ra viện; trường hợp sinh đôi hoặc nhiều hơn tạo dữ liệu giấy ra viện cho từng trẻ theo ghi chú của bảng | Gửi dữ liệu XML liên quan cùng hồ sơ/chứng từ theo quy định trích chuyển |
| XML8 | Chỉ tiêu dữ liệu tóm tắt hồ sơ bệnh án | Tạo lập dữ liệu tóm tắt HSBA để sử dụng cho các mục đích/chế độ liên quan | Người bệnh thuộc các loại điều trị có tóm tắt HSBA theo chuẩn | Chỉ gửi khi người bệnh điều trị nội trú, nội trú ban ngày hoặc điều trị lưu tại TYT tuyến xã/PKĐKKV theo điều kiện của bảng | Gửi dữ liệu XML lên Cổng theo quy định |
| XML9 | Chỉ tiêu dữ liệu giấy chứng sinh | Trước đây dùng để tạo lập dữ liệu giấy chứng sinh | Trẻ được cấp giấy chứng sinh trong giai đoạn chuẩn cũ | Chỉ có ý nghĩa lịch sử đối với dữ liệu theo chuẩn cũ | Không còn sử dụng XML9 cho dữ liệu mới từ 01/10/2025; được thay bằng chuẩn dữ liệu điện tử Giấy chứng sinh theo QĐ2919/QĐ-BYT |
| XML10 | Chỉ tiêu dữ liệu giấy chứng nhận nghỉ dưỡng thai | Tạo lập dữ liệu giấy chứng nhận nghỉ dưỡng thai để giải quyết chế độ BHXH | Người được cơ sở KCB cấp giấy chứng nhận nghỉ dưỡng thai | Phát sinh khi thực tế có cấp chứng từ này | Gửi dữ liệu điện tử của bảng liên quan lên Cổng theo quy định trích chuyển |
| XML11 | Chỉ tiêu dữ liệu giấy chứng nhận nghỉ việc hưởng BHXH | Tạo lập dữ liệu giấy chứng nhận nghỉ việc hưởng BHXH | Người bệnh/người lao động được cấp giấy chứng nhận nghỉ việc hưởng BHXH | Phát sinh khi cơ sở cấp chứng từ tương ứng | Gửi dữ liệu điện tử của bảng liên quan lên Cổng theo quy định trích chuyển |
| XML12 | Chỉ tiêu dữ liệu giám định y khoa | Phục vụ công tác giám định y khoa | Cơ sở giám định y khoa và các cơ quan, đơn vị liên quan | Phát sinh khi thực hiện hồ sơ/nghiệp vụ giám định y khoa | Cơ sở giám định y khoa nhập dữ liệu trực tiếp trên Cổng tiếp nhận |
| XML13 | Chỉ tiêu dữ liệu giấy chuyển tuyến/chuyển cơ sở KCB BHYT | Tạo lập dữ liệu giấy chuyển tuyến/chuyển cơ sở KCB, bao gồm thông tin nơi đi, nơi đến, tình trạng, lý do và hướng điều trị | Người bệnh được chuyển tuyến/chuyển cơ sở KCB | Chỉ trích chuyển khi có chuyển tuyến/chuyển cơ sở KCB; ghi chú của bảng xác định trường hợp MA_LOAI_RV = 2 hoặc 5 | Trích chuyển dữ liệu XML của bảng; khi bảng được ký số và giấy chuyển được hiển thị trên VNeID theo điều kiện quy định thì có giá trị tương đương bản giấy |
| XML14 | Chỉ tiêu dữ liệu giấy hẹn khám lại | Tạo lập dữ liệu giấy hẹn khám lại | Người bệnh được cơ sở KCB hẹn khám lại | Chỉ trích chuyển khi có hẹn khám lại cho người bệnh | Trích chuyển XML; khi bảng được ký số và giấy hẹn được hiển thị trên VNeID theo điều kiện quy định thì có giá trị tương đương giấy hẹn bản giấy |
| XML15 | Chỉ tiêu thông tin quản lý điều trị bệnh lao | Quản lý thông tin điều trị bệnh lao và hỗ trợ liên thông chương trình chống lao | Người bệnh được cơ sở KCB điều trị bệnh lao | Phát sinh khi có điều trị bệnh nhân lao | Gửi XML15 lên Cổng theo quy định trích chuyển; đồng thời gửi XML1, 2, 3, 4 và XML15 tới hệ thống Chương trình Chống lao Quốc gia khi có hướng dẫn |
2. Bảng Check-in không phải XML1
Bảng check-in có mục đích khác với các bảng dữ liệu đề nghị giám định, thanh toán. Quyết định 4750/QĐ-BYT xác định bảng này được sử dụng để thông báo trạng thái khám bệnh, chữa bệnh trên Cổng và không sử dụng dữ liệu của Bảng check-in làm căn cứ giám định, thanh toán, quyết toán chi phí KCB BHYT.
Theo quy định sửa đổi, cơ sở gửi check-in ngay sau khi có phát sinh chi phí KCB đầu tiên. Khi người bệnh được chỉ định vào điều trị nội trú, nội trú ban ngày hoặc điều trị ngoại trú, cơ sở gửi check-in sau khi phát sinh chi phí dịch vụ đầu tiên tại khoa điều trị tương ứng. Một số trường hợp như cấp cứu và trường hợp cơ sở chỉ tiếp nhận người bệnh hoặc mẫu bệnh phẩm để thực hiện dịch vụ cận lâm sàng thuộc phạm vi được quy định không phải gửi check-in.
Vì vậy:
Check-in là dữ liệu trạng thái, không phải bảng tổng hợp claim.
3. XML1 là bảng trung tâm của đợt KCB
XML1 chứa thông tin tổng hợp của một lần hoặc đợt KCB, bao gồm nhận diện người bệnh, BHYT, chẩn đoán, quá trình vào–ra viện, loại hình KCB, khoa, kết quả điều trị và các chỉ tiêu tổng chi phí. MA_LK được sử dụng làm mã đợt điều trị để liên kết XML1 với nhiều bảng khác trong cùng lần KCB.
Do đó về mặt kiến trúc:
XML1 mô tả episode; XML2–XML5 mở rộng episode bằng các dòng chi tiết và evidence.
Tuy nhiên, không nên suy diễn rằng MA_LK là khóa duy nhất cho mọi dòng chi tiết; các bảng có nhiều record trong cùng một đợt KCB vẫn phải được định vị và liên kết theo đúng cấu trúc của từng bảng.
4. XML2 — thuốc, máu và các nội dung tương ứng
XML2 là bảng chi tiết thuốc, chứa các thuộc tính nhận diện thuốc, đường dùng, hàm lượng, số đăng ký, thông tin thầu, số lượng, đơn giá, thành tiền, nguồn chi trả, khoa, bác sĩ, dịch vụ liên quan và thời điểm y lệnh/thực hiện.
Về điều kiện phát sinh, Quyết định 130 quy định chung rằng Bảng 1–5 được sử dụng để cung cấp toàn bộ thông tin KCB chi tiết; do đó, việc hiểu XML2 phát sinh khi có dữ liệu thuốc/máu/chế phẩm máu là cách diễn giải nghiệp vụ trực tiếp từ chức năng và cấu trúc của bảng, chứ không nên chuyển thành một quy tắc máy móc rằng “mọi hồ sơ bắt buộc phải có XML2”.
Nguyên tắc Dr5 nên sử dụng là:
Không có XML2 chỉ trở thành lỗi khi context của hồ sơ chứng minh rằng đáng lẽ phải có dòng dữ liệu thuộc XML2.
5. XML3 — DVKT, khám, giường và VTYT
XML3 chứa phạm vi dữ liệu rộng hơn tên gọi ngắn gọn của bảng: ngoài DVKT và VTYT, trường MA_DICH_VU còn được sử dụng cho mã tiền khám, tiền giường và một số trường hợp đặc biệt theo hướng dẫn.
Bảng này có thể có nhiều dòng trong một MA_LK. Các dòng có thể phản ánh:
- DVKT;
- tiền khám;
- tiền giường;
- VTYT;
- vận chuyển;
- các trường hợp chuyển thực hiện CLS;
- các tình huống đặc biệt được chuẩn mã hóa quy định.
Do đó không nên mô hình:
XML3 = chỉ DVKT.
6. XML4 chỉ phát sinh khi có dịch vụ cận lâm sàng
Đây là một trong những bảng có điều kiện phát sinh được nêu rất rõ trong chuẩn:
Cơ sở KCB chỉ gửi dữ liệu Bảng 4 trong trường hợp người bệnh có thực hiện các dịch vụ cận lâm sàng.
Bảng cung cấp các chỉ số và kết quả, gồm mã dịch vụ, mã chỉ số, tên chỉ số, giá trị, đơn vị đo, mô tả, kết luận, thời điểm kết quả và người đọc/duyệt kết quả.
Với kết quả xét nghiệm có sau ngày kết thúc đợt KCB, chuẩn cập nhật hướng dẫn cơ sở bổ sung đầy đủ kết quả và gửi hồ sơ thay thế lên Cổng để đề nghị thanh toán.
Vì vậy:
XML3 có dịch vụ CLS nhưng XML4 chưa có không mặc nhiên chứng minh dịch vụ không được thực hiện.
Trước hết cần xem:
- kết quả đã đến thời điểm phải có chưa;
- kết quả có ở LIS/RIS hay nguồn khác không;
- relation có resolve đúng không.
7. XML5 có điều kiện theo loại hình điều trị
Chuẩn quy định XML5 chỉ gửi khi người bệnh thuộc các nhóm điều trị nhất định, trong đó có điều trị ngoại trú với các mã loại KCB tương ứng, nội trú, nội trú ban ngày, điều trị lưu tại TYT/PKĐKKV và điều trị nội trú dưới 4 giờ theo chuẩn áp dụng.
Bảng này cung cấp:
- diễn biến lâm sàng;
- giai đoạn bệnh;
- hội chẩn;
- phẫu thuật/thủ thuật;
- thời điểm diễn biến;
- người thực hiện ghi chép.
Do đó XML5 là một lớp clinical timeline, không phải bảng chi phí.
8. XML6 — quản lý điều trị HIV/AIDS
Quyết định 130 xác định Bảng 6 được sử dụng bởi cơ sở KCB và các cơ quan, đơn vị liên quan để quản lý điều trị người nhiễm HIV theo quy định chuyên ngành.
Ghi chú hiện hành của bảng cho biết dữ liệu gắn với HSBA điều trị HIV/AIDS; cơ sở gửi XML về Cổng tiếp nhận theo quy định trích chuyển và đồng thời gửi về Cổng quản lý điều trị và dự phòng HIV HMED khi có hướng dẫn của cơ quan chuyên môn.
Như vậy XML6 có hai vai trò liên quan:
KCB/BHYT
và:
quản lý chương trình HIV.
9. XML7–XML11 là nhóm chứng từ, không phải bảng bắt buộc của mọi claim
Quyết định 130 quy định Bảng 7, 8, 9, 10 và 11 được sử dụng để tạo lập các chứng từ phục vụ giải quyết các chế độ BHXH theo các quy định liên quan.
Điều này rất quan trọng khi xây rule:
Không được kiểm tra “thiếu XML7–XML11” chỉ vì bảng không tồn tại trong hồ sơ.
Trước hết phải xác định:
có sự kiện/chứng từ tương ứng cần phát sinh hay không.
10. XML7 — giấy ra viện
XML7 được tạo khi có dữ liệu giấy ra viện tương ứng. Bảng chứa các thông tin như thời gian vào/ra, chẩn đoán, phương pháp điều trị, tình trạng, người ký và những thông tin phục vụ chứng từ.
Chuẩn còn có trường hợp đặc biệt:
nếu đẻ sinh đôi hoặc nhiều hơn, cơ sở tạo lập và gửi dữ liệu XML giấy ra viện cho từng trẻ.
Điều này cho thấy:
số XML7 không nhất thiết luôn bằng số episode theo quan hệ một–một đơn giản.
11. XML8 — tóm tắt hồ sơ bệnh án
XML8 là dữ liệu tóm tắt HSBA. Ghi chú hiện hành quy định cơ sở chỉ gửi bảng này đối với các loại điều trị như nội trú, nội trú ban ngày và điều trị lưu tại TYT/PKĐKKV theo mã loại KCB tương ứng.
Do đó đối với một lượt khám đơn thuần:
không được mặc định yêu cầu XML8.
12. XML9 — bảng lịch sử, không còn là chuẩn dữ liệu giấy chứng sinh hiện hành
Đây là trường hợp đặc biệt cần được đánh dấu rõ trong Dr5.
Quyết định 130 từng có:
Bảng 9 — Chỉ tiêu dữ liệu giấy chứng sinh.
Tuy nhiên Quyết định 2919/QĐ-BYT ngày 15/09/2025 ban hành chuẩn và thông điệp dữ liệu điện tử Giấy chứng sinh mới, có hiệu lực từ 01/10/2025, đồng thời:
bãi bỏ Bảng 9.
Quyết định 2919 quy định các cơ sở KCB và đơn vị liên quan sử dụng chuẩn dữ liệu Giấy chứng sinh mới để kết nối, chia sẻ với Phần mềm dịch vụ công liên thông.
Vì vậy:
XML9 chỉ được giữ trong Dr5 để kiểm tra dữ liệu lịch sử thuộc thời kỳ bảng này còn áp dụng.
Không được yêu cầu XML9 đối với giấy chứng sinh phát sinh theo chuẩn mới từ 01/10/2025.
13. XML10 — giấy chứng nhận nghỉ dưỡng thai
XML10 chứa dữ liệu của giấy chứng nhận nghỉ dưỡng thai, gồm số chứng từ, thời gian nghỉ, đơn vị, chẩn đoán/thông tin liên quan và người có thẩm quyền cấp.
Điều kiện phát sinh là:
thực tế cơ sở KCB có cấp giấy chứng nhận nghỉ dưỡng thai cho đối tượng thuộc trường hợp áp dụng.
Đây không phải bảng mặc định của:
mọi người bệnh nữ
hoặc:
mọi trường hợp có thai.
14. XML11 — giấy chứng nhận nghỉ việc hưởng BHXH
XML11 phản ánh dữ liệu giấy chứng nhận nghỉ việc hưởng BHXH, gồm số chứng từ, số seri, đơn vị, thông tin người hưởng, thời gian nghỉ, chẩn đoán và người có thẩm quyền ký. Cấu trúc bảng được thiết kế để tạo chứng từ phục vụ chế độ BHXH.
Vì vậy điều kiện rule phải là:
có phát sinh chứng từ nghỉ việc hưởng BHXH
chứ không:
người bệnh đi khám → bắt buộc XML11.
15. XML12 — giám định y khoa
Bảng 12 có phạm vi hoàn toàn khác nhóm Bảng 1–11. Quyết định 130 xác định bảng này được cơ sở giám định y khoa và các cơ quan, đơn vị có liên quan sử dụng phục vụ công tác giám định y khoa.
Về phương thức cung cấp, quy định nêu rõ:
cơ sở giám định y khoa nhập dữ liệu trực tiếp trên Cổng tiếp nhận.
Do đó không nên xây Dr5 với giả định:
mọi XML package KCB phải có XML12.
16. XML13 — giấy chuyển tuyến/chuyển cơ sở KCB
Bảng 13 chứa dữ liệu giấy chuyển tuyến/chuyển cơ sở KCB BHYT, bao gồm:
- số hồ sơ;
- số giấy;
- cơ sở đi;
- cơ sở đến;
- tình trạng lâm sàng;
- chẩn đoán;
- quá trình bệnh lý;
- phương pháp điều trị;
- lý do chuyển;
- hướng điều trị;
- người chỉ định;
- người có thẩm quyền ký.
Tên bảng hiện hành thể hiện cả chuyển tuyến và chuyển cơ sở KCB.
Ghi chú của bảng quy định:
cơ sở chỉ trích chuyển dữ liệu khi có chuyển tuyến/chuyển cơ sở KCB cho người bệnh, với
MA_LOAI_RVlà 2 hoặc 5; nếu bảng đã được ký số và giấy chuyển hiển thị trên VNeID theo điều kiện quy định thì có giá trị tương đương bản giấy.
Đây là một condition rất rõ và có thể được mô hình hóa trong:
dr5_xml_required.
17. XML14 — giấy hẹn khám lại
XML14 chứa thông tin giấy hẹn khám lại, gồm số giấy, cơ sở cấp, người bệnh, thời điểm hẹn, chẩn đoán và người có thẩm quyền ký.
Ghi chú hiện hành quy định:
Cơ sở KCB chỉ thực hiện trích chuyển dữ liệu Bảng này trong trường hợp có hẹn khám lại cho người bệnh.
Nếu bảng được ký số và giấy hẹn được hiển thị trên VNeID theo điều kiện quy định thì có giá trị tương đương giấy hẹn bản giấy.
Do đó rule đúng là:
has_followup_appointment = TRUE → evaluate XML14
không phải:
all episodes → require XML14.
18. XML15 — quản lý điều trị bệnh lao
XML15 được sử dụng cho thông tin quản lý điều trị bệnh lao. Ghi chú hiện hành quy định:
khi có điều trị bệnh nhân lao, cơ sở KCB gửi XML15 về Cổng tiếp nhận theo quy định của Thông tư 48/2017/TT-BYT; đồng thời gửi XML1, XML2, XML3, XML4 và XML15 về hệ thống của Chương trình Chống lao Quốc gia khi có hướng dẫn.
Như vậy điều kiện phát sinh rất rõ:
có điều trị bệnh nhân lao.
Không phải:
có ICD liên quan hô hấp là tự động yêu cầu XML15.
19. Ma trận theo nhóm chức năng
Có thể rút gọn 15 bảng thành năm nhóm lớn:
| Nhóm | Bảng | Vai trò |
|---|---|---|
| Trạng thái | Check-in | thông báo trạng thái KCB |
| Claim/KCB chính | XML1–XML5 | episode, chi phí, DVKT, CLS, diễn biến |
| Chương trình bệnh | XML6, XML15 | HIV/AIDS, lao |
| Chứng từ và liên thông | XML7–XML11, XML13, XML14 | giấy ra viện, HSBA tóm tắt, các chứng nhận, chuyển cơ sở, hẹn khám |
| Giám định chuyên biệt | XML12 | giám định y khoa |
Riêng:
XML9 hiện là historical table.
20. Ma trận phát sinh theo sự kiện
Một cách đọc khác phù hợp để code Dr5 là:
| Sự kiện | Bảng có khả năng phát sinh |
|---|---|
| Có đợt KCB/claim | XML1 |
| Có thuốc/máu/chế phẩm | XML2 |
| Có khám, giường, DVKT, VTYT | XML3 |
| Có CLS | XML4 |
| Có loại điều trị cần diễn biến | XML5 |
| Có điều trị HIV/AIDS | XML6 |
| Có cấp giấy ra viện | XML7 |
| Có tóm tắt HSBA thuộc đối tượng | XML8 |
| Giấy chứng sinh lịch sử trước chuẩn mới | XML9 |
| Có cấp giấy nghỉ dưỡng thai | XML10 |
| Có cấp giấy nghỉ việc hưởng BHXH | XML11 |
| Có nghiệp vụ giám định y khoa | XML12 |
| Có chuyển tuyến/chuyển cơ sở | XML13 |
| Có hẹn khám lại | XML14 |
| Có điều trị bệnh lao | XML15 |
Đây là ma trận triển khai Dr5 được suy ra từ mục đích, tên bảng và các ghi chú điều kiện phát sinh của chuẩn, không phải một bảng nguyên văn duy nhất được Bộ Y tế công bố.
21. Phương thức cung cấp dữ liệu không giống nhau giữa tất cả các bảng
Không nên xây một rule đơn giản:
all_tables → must_be_in_XML_package.
Ít nhất phải phân biệt:
Check-in
Được gửi theo thời điểm phát sinh trạng thái/chi phí ban đầu.
XML1–XML11
Được gửi các bảng liên quan tùy đối tượng và mục đích của người bệnh theo quy định về trích chuyển dữ liệu điện tử.
XML12
Được cơ sở giám định y khoa:
nhập trực tiếp trên Cổng.
XML13–XML14
Được trích chuyển khi phát sinh chứng từ tương ứng; chuẩn hiện hành còn hỗ trợ giá trị điện tử gắn với ký số và hiển thị trên VNeID trong điều kiện quy định.
XML15
Ngoài Cổng BHYT còn có luồng dữ liệu tới hệ thống Chương trình Chống lao Quốc gia khi có hướng dẫn.
XML6
Ngoài Cổng BHYT còn có luồng tới HMED khi có hướng dẫn của cơ quan quản lý HIV/AIDS.
Giấy chứng sinh hiện hành
Không còn sử dụng XML9; thực hiện theo chuẩn dữ liệu điện tử riêng của Quyết định 2919/QĐ-BYT và kết nối với Phần mềm dịch vụ công liên thông.
22. Ý nghĩa đối với kiểm tra “thiếu bảng”
Một trong những rule nguy hiểm nhất là:
“Không thấy bảng X → lỗi.”
Cách kiểm tra đúng phải là:
Sự kiện X có phát sinh không?
→ nếu không
→ NOT_APPLICABLE.
→ nếu có
→ bảng có thuộc diện phải cung cấp tại thời điểm này không?
→ nếu chưa đủ dữ liệu
→ INFO_EVIDENCE hoặc trạng thái phù hợp.
→ nếu đã đến thời điểm phải có và chắc chắn thiếu
→ mới tạo finding thích hợp.
Đây là nguyên tắc:
event first, table second.
23. Không được suy luận sự kiện lâm sàng chỉ từ việc bảng không tồn tại
Ví dụ:
XML4 không có
không tự chứng minh:
bệnh nhân không làm xét nghiệm.
Có thể:
- XML3 cho thấy có CLS;
- LIS có kết quả;
- nhưng relation/exporter chưa sinh XML4.
Khi đó vấn đề là:
data integration.
Không phải:
clinical event absent.
24. Quan hệ giữa XML1 và các bảng khác
Trong nhóm hồ sơ KCB, XML1 đóng vai trò tổng hợp, còn các bảng khác cung cấp detail hoặc chứng từ liên quan. Nhiều bảng sử dụng MA_LK để liên kết với đợt KCB; chuẩn mô tả MA_LK là mã đợt điều trị dùng để liên kết XML1 với các bảng còn lại tương ứng.
Tuy nhiên Dr5 không nên suy diễn:
MA_LK + STTlà universal key cho mọi relation.
Mỗi quan hệ phải được định nghĩa theo:
semantic/business identity của bảng.
25. Mức độ bắt buộc nên được biểu diễn theo context
Trong kiến trúc sáu catalog:
dr5_xml_field
Xác định field tồn tại và định nghĩa field.
dr5_xml_required
Xác định:
bảng/field nào phải xuất hiện trong context nào.
Ví dụ:
XML4 required when applicable CLS event exists.
XML13 applicable when transfer event exists.
XML14 applicable when follow-up appointment exists.
dr5_xml_relation
Kiểm tra:
quan hệ giữa các bảng khi chúng đã phát sinh.
Không nên hard-code:
if table_missing → error
ở parser chung.
26. Bảng check-in cũng cần rule riêng
Check-in không nên được xử lý như:
XML0 của claim.
Nó có:
- mục đích khác;
- thời điểm gửi khác;
- ngoại lệ khác;
- không dùng làm căn cứ giám định/thanh toán/quyết toán theo quy định được sửa đổi tại Quyết định 4750.
Do đó:
Check-in state validation
và:
claim XML validation
nên là hai nhóm rule riêng.
27. XML9 phải được đánh dấu historical_only
Trong Dr5, XML9 không nên bị xóa khỏi schema knowledge bởi vẫn cần:
kiểm tra hồ sơ lịch sử.
Nhưng effective period của bảng phải kết thúc phù hợp với việc Quyết định 2919 có hiệu lực và bãi bỏ Bảng 9 từ ngày 01/10/2025.
Candidate Resolver phải thực hiện:
event date trước mốc chuyển đổi → có thể resolve XML9 theo applicable standard;
event date thuộc chuẩn mới → không yêu cầu XML9.
28. Phân biệt “bảng không phát sinh” với “bảng rỗng”
Có ít nhất ba trạng thái:
NOT_APPLICABLE
Không có sự kiện làm phát sinh bảng.
APPLICABLE_BUT_ABSENT
Sự kiện có phát sinh nhưng bảng không được cung cấp.
PRESENT
Bảng tồn tại.
Sau đó mới tiếp tục kiểm tra:
row/field/value.
Ba trạng thái này không được gộp.
29. Cũng phải phân biệt “không có dòng” với “không có giá trị”
Ví dụ XML4 tồn tại nhưng:
GIA_TRIchưa có
do kết quả chưa hoàn tất.
Đây khác với:
XML4 hoàn toàn không tồn tại.
Rule phải đánh giá:
workflow maturity.
Không chỉ:
XML node existence.
30. Ma trận này nên trở thành dữ liệu cấu hình của Dr5
Về lâu dài, các thuộc tính như:
- applicable table;
- trigger event;
- treatment-type applicability;
- provision method;
- effective period
không nên nằm trong:
Python
if/else.
Chúng nên được mô hình bằng sáu catalog chuẩn, chủ yếu:
dr5_xml_field;dr5_xml_required;dr5_xml_relation;dr5_legal_basis.
Nhờ đó khi quy định thay đổi:
cập nhật catalog/version
thay vì:
sửa engine.
31. Mô hình logic đề xuất cho việc xác định bảng phải có
Có thể diễn đạt:
Episode/event context
→ resolve applicable standard version
→ determine whether business event exists
→ resolve applicable table requirement
→ determine provision timing/method
→ verify table presence
→ verify rows
→ verify fields
→ verify relations.
Không nên đảo thành:
parse XML → thấy thiếu table → báo lỗi.
32. Thứ tự kiểm tra đúng
Một cách tổng quát:
Sự kiện có tồn tại?
→ Bảng có áp dụng?
→ Đã đến thời điểm phải cung cấp chưa?
→ Bảng có tồn tại?
→ Dòng cần thiết có tồn tại?
→ Field cần thiết có tồn tại?
→ Giá trị có hợp lệ?
→ Quan hệ với các bảng khác có đúng?
Đây là nền tảng để hạn chế false positive.
33. Ma trận rút gọn cho người sử dụng
| Bảng | Câu hỏi cần trả lời trước khi kiểm tra thiếu bảng |
|---|---|
| Check-in | Trường hợp này có thuộc diện phải check-in không và đã đến trigger gửi chưa? |
| XML1 | Đây có phải một đợt KCB cần cung cấp dữ liệu không? |
| XML2 | Có thuốc/máu/chế phẩm thuộc phạm vi bảng không? |
| XML3 | Có DVKT/VTYT/khám/giường/khoản chi tương ứng không? |
| XML4 | Có thực hiện CLS không? |
| XML5 | Loại hình điều trị có thuộc nhóm phải gửi diễn biến không? |
| XML6 | Có chăm sóc/điều trị HIV không? |
| XML7 | Có phát hành giấy ra viện tương ứng không? |
| XML8 | Có thuộc loại điều trị phải cung cấp tóm tắt HSBA không? |
| XML9 | Event có thuộc thời kỳ XML9 còn hiệu lực không? |
| XML10 | Có cấp giấy nghỉ dưỡng thai không? |
| XML11 | Có cấp giấy nghỉ việc hưởng BHXH không? |
| XML12 | Có hồ sơ giám định y khoa không? |
| XML13 | Có chuyển tuyến/chuyển cơ sở không? |
| XML14 | Có hẹn khám lại không? |
| XML15 | Có điều trị bệnh lao không? |
34. Ba lớp mục đích khác nhau không nên trộn
Có thể chia chuẩn thành ba mục tiêu lớn:
KCB/BHYT
Check-in, XML1–XML5.
Chương trình quản lý bệnh/chuyên môn
XML6, XML15.
Chứng từ và chế độ liên quan
XML7–XML14, với từng bảng có phạm vi riêng; XML12 thuộc giám định y khoa.
Một bảng có thể tham gia nhiều luồng, nhưng không nên giả định:
mọi bảng đều có mục đích thanh toán BHYT giống XML1–XML3.
35. Một bảng có thể được cung cấp tới nhiều hệ thống
XML6 và XML15 là ví dụ rõ. Cùng dữ liệu có thể:
gửi Cổng BHYT
và:
gửi hệ thống quản lý chương trình chuyên ngành.
Vì vậy trong Dr5 nên tách:
table_applicability
khỏi:
destination/provision_method.
Không nên giả định:
một bảng = một nơi nhận.
36. Chữ ký số không làm bảng phát sinh
Đối với XML13 và XML14, chuẩn có nội dung liên quan ký số và VNeID. Tuy nhiên phải phân biệt:
trigger của bảng
với:
cơ chế xác thực/giá trị điện tử của chứng từ.
Ví dụ XML14 phát sinh vì:
người bệnh được hẹn khám lại.
Không phải vì:
hệ thống có chữ ký số.
37. Phương thức cung cấp cũng có effective period
Một bảng có thể:
trước đây gửi theo cơ chế A;
sau đó dùng cơ chế B.
Do đó provision_method cũng cần được đọc theo:
version và thời điểm áp dụng.
Không lưu một giá trị:
“SEND_GATEWAY”
vĩnh viễn cho mọi thời kỳ.
38. Phụ lục này không thay thế bảng field-level
Ma trận này trả lời:
Bảng nào dùng để làm gì và khi nào xuất hiện?
Nó không thay thế:
- danh sách field;
- datatype;
- max length;
- requiredness;
- mã danh mục;
- relation.
Các nội dung đó phải được tra theo:
phiên bản chuẩn applicable.
39. Mục đích của ma trận trong Dr5
Ma trận này đặc biệt hữu ích cho ba nhóm rule.
Rule 1 — Table applicability
Bảng có phải xuất hiện không?
Rule 2 — Table completeness
Nếu bảng phải xuất hiện, các dòng/field cần thiết có đủ không?
Rule 3 — Cross-table relation
Dữ liệu giữa các bảng có khớp nhau không?
Nếu Rule 1 sai:
Rule 2 và Rule 3 phía sau rất dễ tạo false positive.
40. Nguyên tắc cuối cùng
Không nên hỏi:
“Hồ sơ này thiếu bảng nào?”
trước khi hỏi:
“Hồ sơ này thực tế đã phát sinh những sự kiện nào và theo chuẩn áp dụng thì những sự kiện đó phải được biểu diễn ở bảng nào?”
Đó là khác biệt giữa:
kiểm tra cấu trúc XML đơn thuần
và:
kiểm tra dữ liệu có hiểu nghiệp vụ.
Kết luận
Chuẩn dữ liệu XML KCB được tổ chức theo nhiều bảng vì một lần khám bệnh, chữa bệnh có nhiều lớp thông tin khác nhau: trạng thái tiếp nhận, thông tin tổng hợp episode, thuốc, dịch vụ, kết quả cận lâm sàng, diễn biến lâm sàng, chương trình quản lý bệnh và các chứng từ phục vụ những chế độ liên quan. Quyết định 130 xác lập mục đích chung của các nhóm bảng và quy định Bảng 1–11 được cung cấp tùy theo đối tượng, mục đích của người bệnh, trong khi Bảng 12 được nhập trực tiếp trên Cổng. Các chuẩn sửa đổi sau đó tiếp tục bổ sung điều kiện phát sinh cụ thể cho nhiều bảng, như XML4 chỉ khi có CLS, XML5 theo loại hình điều trị, XML13 khi có chuyển tuyến/chuyển cơ sở, XML14 khi có hẹn khám lại và XML15 khi điều trị bệnh lao.
Đặc biệt, XML9 phải được quản lý như một bảng lịch sử, bởi Quyết định 2919/QĐ-BYT có hiệu lực từ ngày 01/10/2025 đã ban hành chuẩn dữ liệu điện tử Giấy chứng sinh mới và bãi bỏ Bảng 9.
Do đó, với Dr5-XML, logic kiểm tra sự tồn tại của bảng nên tuân theo công thức:
**Applicable standard version
- business event
- patient/treatment context
- document requirement
- provision timing
= expected XML table.**
Sau khi xác định được:
expected table
mới được kiểm tra:
table presence → row presence → field requiredness → value validity → catalog membership → cross-table relation.
Nguyên tắc quan trọng nhất của Phụ lục 2 là:
Không có bảng chưa chắc là thiếu dữ liệu; trước hết phải chứng minh rằng bảng đó đáng lẽ phải phát sinh.
Đây là nền tảng để Dr5 tránh một trong những loại false positive phổ biến nhất của kiểm tra XML: biến một bảng “không áp dụng” thành một bảng “bắt buộc nhưng bị thiếu”.
- Đăng nhập để gửi ý kiến