Một cảnh báo như:
“Hồ sơ có nguy cơ xuất toán.”
gần như không đủ giá trị để xử lý.
Người sử dụng sẽ phải tự hỏi:
- hồ sơ nào?
- bảng XML nào?
- dòng nào?
- field nào?
- giá trị hiện tại là gì?
- hệ thống cho rằng giá trị nào mới đúng?
- đối chiếu với danh mục nào?
- danh mục phiên bản nào?
- khoản tiền nào bị ảnh hưởng?
- quy định nào được áp dụng?
- rule này là quy định pháp lý, tiêu chí chính thức hay kiểm soát nội bộ?
- hệ thống có đủ evidence để kết luận hay chỉ đang cảnh báo cần xem?
Một hệ thống tiền giám định chỉ thực sự có giá trị khi người sử dụng có thể đi theo chuỗi:
Finding
→ dữ liệu gây finding
→ nguồn đối chiếu
→ điều kiện được kiểm tra
→ evidence
→ căn cứ
→ hành động cần thực hiện.
Đây là:
explainable finding.
Điều 10 Thông tư 12/2026/TT-BTC quy định việc giám định tự động bao gồm nhiều nội dung khác nhau như thông tin thẻ, quyền lợi, danh mục thuốc–thiết bị–dịch vụ, mức thanh toán, điều kiện thanh toán, phạm vi chuyên môn, người hành nghề, khoảng cách giữa các lần KCB, tính thống nhất của Bảng kê và số lượng thuốc, thiết bị sử dụng. Kết quả xử lý còn có thể bao gồm trường hợp chưa đủ thông tin để xác định điều kiện thanh toán đối với một số nội dung.
Điều đó cho thấy một cảnh báo đáng tin cậy phải chỉ rõ:
đang kiểm tra nội dung nào và dựa trên thông tin nào.
Đồng thời Điều 16 quy định BHXH Việt Nam ban hành hướng dẫn kỹ thuật và các tiêu chí, tiêu chuẩn áp dụng trên Hệ thống thông tin giám định BHYT.
Vì vậy Dr5 phải luôn phân biệt:
căn cứ pháp lý hoặc tiêu chí chính thức
với:
rule kiểm soát nội bộ hoặc analytics của bệnh viện.
Nguyên tắc trung tâm của Bài 8.5 là:
Mọi cảnh báo phải có khả năng trả lời được: dữ liệu nào tạo ra cảnh báo, giá trị quan sát là gì, điều kiện kỳ vọng là gì, nguồn nào được dùng để đối chiếu, khoản chi nào bị ảnh hưởng và căn cứ nào cho phép hệ thống đưa ra mức kết luận hiện tại.
1. Cảnh báo không nên bắt đầu từ một câu message
Một cách thiết kế yếu là:
code phát hiện lỗi
→ tạo chuỗi:
“Sai dịch vụ.”
Một cách tốt hơn là tạo trước:
structured finding object.
Sau đó từ object này mới sinh:
- thông báo trên màn hình;
- báo cáo;
- log;
- API;
- file Excel;
- bằng chứng giải trình.
Message chỉ là:
một representation của finding.
2. Một finding phải có định danh ổn định
Ví dụ:
finding_id.
Nó giúp theo dõi cùng một vấn đề qua:
- lúc phát hiện;
- phân công;
- bổ sung evidence;
- sửa dữ liệu;
- đánh giá lại;
- đóng finding.
Không nên mỗi lần chạy rule lại tạo:
một cảnh báo hoàn toàn mới
nếu đây vẫn là cùng một business issue.
3. Finding phải xác định hồ sơ nào
Tối thiểu cần:
- cơ sở KCB;
- người bệnh hoặc định danh nội bộ phù hợp;
MA_LK;- episode;
- kỳ dữ liệu;
- submission version.
MA_LK có vai trò trung tâm trong liên kết các bảng XML của cùng một lần KCB.
Nhưng finding cần biết thêm:
payload/version nào đang được kiểm tra.
Bởi cùng một MA_LK có thể:
được điều chỉnh và gửi lại.
4. Finding phải chỉ được bảng XML
Không nên chỉ:
“Sai mã dịch vụ.”
Phải biết:
XML3.
Hoặc:
XML2.
Hoặc:
XML1 ↔ XML3.
Đây là bước đầu để người xử lý tìm đúng dữ liệu.
5. Phải chỉ chính xác dòng gây cảnh báo
Ví dụ:
XML3.STT = 25.
Nhưng cần lưu ý:
STT nên được dùng như line locator trong payload cụ thể, không nên coi là định danh business event bất biến xuyên mọi lần gửi.
Do đó finding tốt hơn còn lưu:
- payload version;
- mã dịch vụ;
- timestamp;
- các thuộc tính nhận diện event.
6. Nên có cả source_locator và business_event_identity
Source locator
Giúp người dùng tìm đúng dòng:
XML3 / STT 25.
Business event identity
Giúp hệ thống biết:
đây là cùng một sự kiện sau khi dữ liệu được xuất lại.
Hai khái niệm khác nhau.
7. Phải chỉ field cụ thể nếu lỗi ở cấp field
Ví dụ:
XML3.MA_KHOA.
Không:
“XML3 sai.”
Hoặc:
XML2.MA_THUOC.
Hoặc:
XML1.T_TONGCHI_BV.
Field path nên được thể hiện đầy đủ:
TABLE.FIELD.
8. Cảnh báo phải hiển thị giá trị quan sát
Ví dụ:
Observed:
MA_KHOA = K99.
Nếu chỉ nói:
“mã khoa sai”
thì người xử lý vẫn phải:
mở XML để tìm giá trị.
Explainability tốt phải giảm:
số bước điều tra thủ công.
9. Nếu có normalization, phải hiển thị cả giá trị gốc và giá trị đã chuẩn hóa
Ví dụ:
Raw value:
abc
Normalized value:
ABC.
Nếu evaluation dựa trên normalized value:
phải lưu cả hai.
Không được để người dùng nhìn:
raw A
nhưng engine thực chất kiểm tra:
transformed B
mà không biết.
10. Nếu giá trị bị mapping, phải chỉ mapping nào được dùng
Ví dụ:
Local code
DV001
→ canonical code X.YYYY.ZZZZ.
Finding cần biết:
- mapping source;
- mapping version;
- effective period.
Nếu mapping sai:
finding phía sau cũng có thể sai.
11. Cảnh báo phải nói giá trị kỳ vọng là gì
Ví dụ không chỉ:
“MA_KHOA không hợp lệ.”
Mà:
Expected: code phải thuộc danh mục khoa áp dụng tại ngày 15/09/2026.
Hoặc:
Expected:
T_TONGCHI_BVphải bằng tổngTHANH_TIEN_BVcủa XML2 và XML3.
Chuẩn dữ liệu xác định T_TONGCHI_BV là tổng THANH_TIEN_BV tại XML2 và XML3.
12. Expected value không phải lúc nào cũng là một giá trị cụ thể
Có thể là:
Exact value
phải bằng 100.
Range
từ A đến B.
Catalog membership
phải thuộc catalog X.
Relation
A = B + C.
Temporal condition
event B phải sau A.
Evidence condition
phải có evidence Y.
Explainability phải phù hợp với:
loại condition.
13. Không nên hiển thị hàng nghìn giá trị catalog như “expected”
Nếu code không thuộc danh mục gồm:
20.000 mã,
không nên đưa toàn bộ.
Có thể nói:
“Không thuộc danh mục DVKT applicable version V.”
và cung cấp:
link hoặc chức năng tra cứu candidate catalog.
14. Phải chỉ rõ nguồn đối chiếu
Đây là thành phần đặc biệt quan trọng.
Một cảnh báo có thể đối chiếu với:
- chuẩn XML;
- danh mục dùng chung;
- danh mục sử dụng của cơ sở;
- danh mục nhân viên;
- danh mục thiết bị;
- dữ liệu mua sắm;
- LIS;
- RIS/PACS;
- HSBA;
- rule analytics nội bộ.
Người dùng cần biết:
Dr5 đã so với cái gì.
15. Không nên chỉ ghi “so với danh mục”
Phải cụ thể:
danh mục gì?
version nào?
hiệu lực khi nào?
scope nào?
Một cảnh báo:
“Không có trong danh mục”
mà không xác định danh mục:
rất khó kiểm toán.
16. Catalog version phải được lưu trong finding
Ví dụ:
catalog_version = 2026-08-01.
Hoặc version ID nội bộ tương ứng.
Nếu sau này catalog thay đổi:
finding lịch sử vẫn phải giải thích được.
17. Effective date phải xuất hiện trong explanation khi có ý nghĩa
Ví dụ:
Event date: 20/09/2026.
Catalog applicable: version effective from 01/08/2026.
Điều này giúp người dùng hiểu:
vì sao hệ thống không dùng danh mục hiện tại khác.
18. Cần phân biệt source data và reference data
Source data
Dữ liệu của hồ sơ:
MA_DICH_VU = X.
Reference data
Dữ liệu dùng để đánh giá:
catalog applicable.
Finding cần chứa:
cả hai.
Nếu chỉ lưu conclusion:
không thể reproduce evaluation.
19. Với rule quan hệ, phải hiển thị cả hai phía
Ví dụ:
XML3 service X
không resolve được:
XML4 result tương ứng.
Không nên chỉ:
“Thiếu kết quả.”
Cần hiển thị:
Source event: XML3 STT 25,
MA_DICH_VU = X.
Expected relation: corresponding XML4 result.
Resolved targets: none.
20. Relation phải chỉ join logic
Một finding cross-table nên biết:
relation dùng các field nào để nối.
Ví dụ conceptual:
MA_LK + MA_DICH_VU + context...
Không nên chỉ nói:
“Không tìm thấy dữ liệu liên quan.”
Điều này đặc biệt quan trọng khi debug false positive.
21. Nếu relation không thể resolve chắc chắn, không được giả rằng target không tồn tại
Kết quả có thể là:
INFO_EVIDENCE.
Không:
“dịch vụ không có kết quả.”
Nên nói:
“Dr5 chưa resolve được kết quả tương ứng từ các nguồn hiện có.”
Đây là wording chính xác hơn.
22. Cảnh báo chi phí phải chỉ rõ dòng chi phí bị ảnh hưởng
Một payment-related finding không nên chỉ ở:
cấp episode.
Phải xác định nếu có thể:
- XML2 hay XML3;
- STT;
- thuốc/DVKT/VTYT;
- số lượng;
- đơn giá;
- thành tiền.
Đây là:
financial evidence.
23. Cần phân biệt các loại số tiền
Không nên chỉ ghi:
“Số tiền: 5.000.000 đồng.”
Phải biết:
THANH_TIEN_BV;THANH_TIEN_BH;T_BHTT;T_BNCCT;T_BNTT;- nguồn khác.
Ở XML1, các chỉ tiêu này có ý nghĩa khác nhau; T_TONGCHI_BV, T_TONGCHI_BH, T_BNTT, T_BNCCT, T_BHTT và T_NGUONKHAC không phải cùng một khái niệm.
24. “Amount at risk” phải được định nghĩa rõ
Ví dụ có thể có:
Line gross amount
giá trị dòng.
BHYT eligible amount
phần trong phạm vi.
Requested BHYT amount
số tiền đang đề nghị quỹ.
Estimated affected amount
amount Dr5 ước tính liên quan finding.
Không nên gọi tất cả:
“tiền xuất toán”.
25. Estimated amount không phải quyết định từ chối chính thức
Nếu Dr5 tính:
amount_at_risk = 2.000.000
thì UI phải ghi:
Estimated amount potentially affected by this internal check.
Không:
Số tiền BHXH xuất toán: 2.000.000
khi chưa có kết quả chính thức.
26. Một finding có thể ảnh hưởng nhiều dòng chi phí
Ví dụ:
một condition chung cho nhiều VTYT.
Khi đó cần:
finding-level summary
và:
affected-line list.
Không nên duplicate:
một message chung thành hàng trăm cảnh báo khó quản lý.
27. Ngược lại, mỗi dòng có thể có nhiều finding
Ví dụ một dòng DVKT:
- mã sai;
- thời gian sai;
- provider context chưa phù hợp;
- payment condition chưa đủ evidence.
Không nên gom thành:
“Dòng sai.”
Phải tách:
từng finding atomic.
28. Cảnh báo phải ghi rule nào đã chạy
Ví dụ:
rule_id
rule_version
implementation.
Người dùng nghiệp vụ không nhất thiết cần thấy implementation.
Nhưng audit/debug:
phải có.
29. Rule version là bắt buộc
Một finding tháng 5 được tạo bởi:
Rule V1.
Tháng 9 rule đã là:
V2.
Finding tháng 5 vẫn phải chỉ:
V1.
Không render lại explanation bằng:
nội dung V2
rồi làm thay đổi lịch sử.
30. Implementation version cũng hữu ích cho reproducibility
Nếu generic engine thay đổi:
toán tử hoặc resolver,
cùng catalog có thể tạo kết quả khác.
Do đó evaluation snapshot nên biết:
engine/implementation version
khi cần audit kỹ thuật.
31. Cảnh báo phải ghi source type của rule
Ví dụ:
LEGAL
OFFICIAL_TECHNICAL
INTERNAL_CONTROL
ANALYTIC_SCREENING.
Điều này giúp người dùng biết:
mức thẩm quyền của finding.
32. Đây là điều đặc biệt quan trọng với Điều 16
BHXH Việt Nam là cơ quan ban hành các tiêu chí, tiêu chuẩn áp dụng trên Hệ thống thông tin giám định BHYT.
Do đó Dr5 không được trình bày:
INTERNAL_CONTROL
như:
tiêu chí chính thức của BHXH.
33. Một cảnh báo phải chỉ văn bản áp dụng nếu có
Không nên:
“Theo quy định hiện hành.”
Nên:
văn bản X;
điều Y;
khoản Z;
điểm K;
phụ lục nếu có.
Đây là:
legal provenance.
34. Legal basis cần gắn đúng với conclusion
Nếu văn bản chỉ quy định:
format dữ liệu,
không nên dùng nó để kết luận:
chi phí không hợp lý chuyên môn.
Nếu văn bản chỉ là:
hướng dẫn chuyên môn,
không tự động là:
payment condition.
Căn cứ phải support:
đúng loại kết luận.
35. Không được “citation laundering”
Một hệ thống có thể tạo cảm giác đáng tin bằng cách:
gắn một văn bản pháp luật vào mọi cảnh báo.
Nhưng nếu văn bản:
không trực tiếp hỗ trợ conclusion,
đó là sai.
Legal basis không phải:
decoration.
36. Có thể cần nhiều căn cứ cho một rule
Ví dụ một condition có thể dựa trên:
- văn bản gốc;
- văn bản sửa đổi;
- danh mục;
- hướng dẫn chuyển tiếp.
Finding nên resolve:
applicable legal chain.
Không chỉ:
văn bản mới nhất.
37. Cần hiển thị ngày hiệu lực của căn cứ
Ví dụ:
Applicable from: ...
Nếu hồ sơ nằm ngoài thời gian:
rule không nên áp dụng.
Điều này hỗ trợ:
retrospective audit.
38. Không chỉ legal basis, catalog basis cũng cần provenance
Ví dụ:
code được lấy từ danh mục nào?
file/version nào?
ngày publish?
Nếu catalog được cập nhật:
vẫn phải biết finding dùng bản nào.
39. Cảnh báo nên có “why applicable?”
Một người dùng cần biết không chỉ:
condition là gì,
mà:
tại sao hồ sơ này bị đưa vào rule.
Ví dụ:
Rule áp dụng vì
MA_DICH_VU = XvàNGAY_TH_YLthuộc effective period Y.
Đây là:
applicability explanation.
40. Đây là một thành phần quan trọng để debug false positive
Nếu người dùng nói:
“Rule này không áp dụng cho bệnh nhân này.”
Dr5 có thể cho thấy:
applicability resolver đã dựa vào dữ liệu nào.
Có thể phát hiện:
mapping sai;
ICD sai;
date sai;
catalog binding sai.
41. Finding phải nói condition được evaluate thế nào
Ví dụ:
Observed: 5 lần/48 giờ.
Threshold: 3.
Operator:
>.
Đối với arithmetic:
Observed A = 100.
Expected B + C = 90.
Difference = 10.
Explainability phải cụ thể.
42. Nhưng không cần phơi bày code nội bộ cho người dùng cuối
Người dùng cần:
logic nghiệp vụ.
Không cần:
stack trace;
Python expression;
SQL.
Technical trace có thể:
mở ở chế độ audit/debug.
43. Nên có hai tầng giải thích
Tầng 1 — Operational explanation
Ngắn, dễ hành động.
Tầng 2 — Audit explanation
Đầy đủ:
- data;
- rule;
- catalog;
- condition;
- evidence;
- basis;
- versions.
Điều này cân bằng:
usability
và:
traceability.
44. Ví dụ tầng 1
Mã khoa chưa phù hợp danh mục áp dụng.
XML3 STT 25,
MA_KHOA=...
Hành động: kiểm tra khoa thực hiện và mapping mã khoa.
45. Ví dụ tầng 2
Có thể mở:
Rule ID;
version;
event date;
binding;
catalog version;
observed value;
membership result;
legal/source basis.
Không cần làm màn hình chính quá tải.
46. INFO_EVIDENCE phải giải thích evidence nào chưa resolve
Một cảnh báo tốt:
Chưa đủ dữ liệu để xác định điều kiện Y.
Evidence cần: ...
Đã kiểm tra nguồn: XML4, LIS.
Kết quả: chưa resolve.
Không tốt:
“Thiếu bằng chứng.”
47. Phải phân biệt “chưa tìm thấy” và “xác nhận không có”
UI có thể dùng:
NOT_RESOLVED
và:
CONFIRMED_ABSENT.
Chỉ trường hợp thứ hai mới có thể hỗ trợ:
condition failure
khi rule yêu cầu evidence đó.
48. WARN_REVIEW phải chỉ comparator
Ví dụ:
Tần suất: 5 lần.
Comparator median: 1.
P95: 3.
Population: ...
Time window: 48 giờ.
Nếu không có comparator:
người dùng không hiểu vì sao đây là outlier.
49. Analytics finding phải ghi rõ đây không phải payment threshold
Có thể thêm:
Nguồn cảnh báo: phân tích nội bộ. Không phải điều kiện thanh toán nếu chưa có căn cứ tương ứng.
Điều này đặc biệt cần thiết ở:
các dashboard outlier.
50. PAYMENT_CONDITION cần evidence chain đầy đủ nhất
Một finding loại này nên trả lời:
- Khoản chi nào?
- Rule nào áp dụng?
- Vì sao rule áp dụng?
- Condition là gì?
- Evidence nào đã được dùng?
- Evidence cho kết quả gì?
- Exception nào đã được kiểm tra?
- Căn cứ nào?
- Effective period nào?
- Số tiền nào có thể bị ảnh hưởng?
Nếu thiếu nhiều thành phần:
chưa nên classification ở mức này.
51. Không nên tạo PAYMENT_CONDITION chỉ từ “không tìm thấy evidence”
Nếu evidence nằm:
ngoài XML,
cần:
evidence workflow.
Không được:
XML không có → condition false.
Đây là nguyên tắc xuyên suốt của Dr5.
52. Cảnh báo phải cho phép đi tới source record
Một UX tốt:
click finding
→ mở:
đúng hồ sơ;
đúng bảng;
đúng dòng;
đúng field.
Nếu tích hợp sâu:
mở trực tiếp màn hình HIS/EMR tương ứng.
Đây là:
trace-to-source.
53. Nhưng phải bảo đảm source record là đúng version
Nếu finding được tạo từ:
submission V2,
không nên mở:
current source V4
rồi nói đây là dữ liệu đã đánh giá.
Nên cho phép:
xem snapshot V2
và:
current value
riêng.
54. Cần hiển thị “before” và “after” khi dữ liệu đã sửa
Ví dụ:
Original:
K99
Current:
K09
Re-evaluation: PASS.
Đây là bằng chứng:
finding đã được xử lý như thế nào.
55. Không overwrite evidence cũ sau khi sửa
Nếu sửa giá trị:
snapshot cũ phải còn.
Nếu không:
không thể giải thích tại sao alert từng tồn tại.
Audit trail cần:
immutable history.
56. Cảnh báo cần timestamp
Tối thiểu:
- detected_at;
- evaluated_at;
- source_updated_at nếu có;
- resolved_at.
Điều này rất quan trọng với:
workflow real-time.
57. Event time và evaluation time phải tách nhau
Ví dụ:
dịch vụ thực hiện ngày 01/09.
Dr5 đánh giá:
ngày 05/09.
Rule applicability có thể dựa:
event time.
Không phải:
evaluation time.
58. Finding nên chứa control point
Ví dụ:
ORDER
EXECUTION
RECORD_CLOSE
PRE_SUBMISSION.
Điều này cho biết:
hệ thống phát hiện ở giai đoạn nào.
59. Finding cũng cần owner/action
Một cảnh báo tốt không chỉ nói:
vấn đề.
Nó nên nói:
ai cần xem?
hành động nào?
Ví dụ:
Owner: Khoa Dược.
Action: xác minh mapping thuốc.
Hoặc:
Owner: khoa điều trị.
Action: bổ sung/xác minh evidence.
60. Nhưng action recommendation không được làm thay quyết định chuyên môn
Ví dụ:
“Xem xét chỉ định.”
Không:
“Hủy dịch vụ.”
trừ khi rule deterministic và workflow đã được governance phê duyệt.
Hệ thống hỗ trợ:
quyết định.
Không tự động quyết định vượt phạm vi.
61. Cảnh báo cần severity và priority riêng
Ví dụ:
finding_class =
WARN_REVIEW.
severity = HIGH.
financial_priority = VERY_HIGH.
Người dùng hiểu:
vấn đề chưa được xác nhận nhưng đáng ưu tiên.
62. Không dùng màu để thay nội dung
Màu đỏ không giải thích:
tại sao.
Mọi alert dù có màu vẫn phải có:
text classification.
Ví dụ:
INFO_EVIDENCE – Chưa đủ dữ liệu.
63. Có thể xây “finding summary card”
Một card có thể gồm:
Finding: ...
Class: ...
Source: ...
Affected item: ...
Observed: ...
Expected: ...
Amount: ...
Basis: ...
Action: ...
Đây là presentation layer.
64. Sau đó có “evidence panel”
Hiển thị:
- source fields;
- related records;
- catalog candidates;
- source documents;
- timestamps.
Người review không cần:
tự truy tìm nhiều hệ thống.
65. Có thể có “legal panel”
Hiển thị:
- văn bản;
- điều/khoản/điểm;
- effective period;
- version;
- amendment chain;
- đoạn diễn giải nội bộ.
Tuy nhiên:
phần diễn giải nội bộ phải tách khỏi nguyên văn/căn cứ chính thức.
66. Không nên sửa nghĩa văn bản trong phần giải thích
Có thể có hai trường:
Official basis
citation.
Dr5 interpretation
cách rule đã mô hình hóa.
Như vậy nếu có tranh luận:
biết đâu là nguồn,
đâu là interpretation của hệ thống.
67. Đây là đặc biệt quan trọng khi văn bản có tính diễn giải
Một condition không hoàn toàn machine-readable có thể:
cần interpretation nghiệp vụ.
Dr5 phải lưu:
người duyệt interpretation;
version.
Không được giả rằng:
interpretation chính là nguyên văn pháp luật.
68. Một finding nên có reproducibility package
Về nguyên tắc, từ finding phải có thể lấy lại:
- input snapshot;
- rule version;
- catalog version;
- evidence;
- parameters;
- output.
Nếu chạy lại cùng snapshot:
phải thu được cùng kết quả
trừ khi engine version được thay đổi có chủ đích.
69. Đây là yêu cầu quan trọng cho tranh luận và giải trình
Nếu khoa nói:
“Tại sao hôm qua hệ thống cảnh báo mà hôm nay không?”
Dr5 phải trả lời được:
- data đã thay đổi;
- catalog version thay đổi;
- rule version thay đổi;
- evidence được bổ sung;
- hay engine lỗi.
Không nên:
không biết.
70. Cần lưu hash/snapshot của payload khi pre-send
Đặc biệt với final validation:
finding phải gắn với exact payload.
Nếu payload thay đổi:
validation cũ không còn bảo đảm.
Có thể yêu cầu:
re-evaluate.
71. Explainability phải hỗ trợ cả machine-to-machine
Không chỉ UI.
API finding nên trả:
- structured identifiers;
- observed values;
- source refs;
- basis refs;
- action code.
HIS có thể hiển thị:
theo workflow riêng.
72. Không nên chỉ trả một chuỗi message qua API
Nếu Dr5 API chỉ trả:
"Sai điều kiện thanh toán"
thì HIS không thể:
- filter;
- route;
- highlight field;
- mở evidence.
Nên trả:
structured finding.
73. Message có thể được sinh từ structured finding
Lợi ích:
cùng một finding có thể render:
- tiếng Việt;
- báo cáo;
- dashboard;
- API;
- PDF.
Không phải:
viết logic riêng cho từng UI.
74. Cần chuẩn hóa mã lý do
Ví dụ:
CATALOG_NOT_MEMBER
REQUIRED_VALUE_MISSING
ARITHMETIC_MISMATCH
EVIDENCE_NOT_RESOLVED
FREQUENCY_OUTLIER
PAYMENT_CONDITION_FAILED.
Reason code giúp:
analytics về finding.
75. Reason code không thay finding class
Ví dụ:
EVIDENCE_NOT_RESOLVED
thường map:
INFO_EVIDENCE.
Nhưng vẫn là:
hai thuộc tính khác nhau.
Reason mô tả:
nguyên nhân kỹ thuật.
Class mô tả:
bản chất kết luận.
76. Có thể chuẩn hóa evidence_type
Ví dụ:
- XML_FIELD;
- XML_RECORD;
- CATALOG_RECORD;
- RESULT;
- MEDICAL_RECORD;
- PRACTITIONER_RECORD;
- EQUIPMENT_RECORD;
- PROCUREMENT_RECORD;
- ANALYTIC_METRIC.
Nhờ đó evidence graph có cấu trúc.
77. Evidence graph tốt hơn một đoạn text dài
Ví dụ:
Finding F
← XML3 row R
← service code X
← catalog record C
← payment condition P
← legal basis L.
Người dùng có thể:
mở từng node.
Đây là kiến trúc rất phù hợp với Dr5.
78. Không phải mọi evidence đều cần hiển thị mặc định
UI chính chỉ cần:
evidence quan trọng nhất.
Audit view có thể:
mở toàn bộ graph.
Tránh:
information overload.
79. Một cảnh báo tốt phải giúp xử lý trong vài bước
Nếu để xử lý finding, nhân viên phải:
mở 6 hệ thống;
copy mã;
tìm văn bản;
tính tiền thủ công;
thì explainability chưa đạt.
Mục tiêu là:
tập trung context cần thiết vào finding.
80. Nhưng Dr5 không nên copy toàn bộ HSBA vào finding
Chỉ nên:
tham chiếu evidence cần thiết.
Việc sao chép quá nhiều:
- tăng rủi ro dữ liệu;
- làm snapshot lớn;
- khó phân quyền.
Nên lưu:
reference + necessary snapshot.
81. Phân quyền finding phải phù hợp dữ liệu y tế
Một nhân viên CNTT cần:
debug XML
không nhất thiết được xem:
toàn bộ diễn biến lâm sàng.
Explainability không đồng nghĩa:
mọi người xem mọi evidence.
Cần:
role-based access.
82. Điều 16 cũng yêu cầu cơ sở quản lý tài khoản, phân quyền, an toàn thông tin và bảo vệ thông tin cá nhân.
Do đó evidence panel phải:
tuân thủ phân quyền.
Không vì muốn giải thích rule mà:
mở rộng quyền truy cập không cần thiết.
83. Cần log ai đã xem hoặc thay đổi finding quan trọng
Đặc biệt:
- payment findings;
- override;
- evidence upload;
- rule review.
Audit trail giúp:
accountability.
84. Cảnh báo nên hỗ trợ phản hồi “hệ thống sai”
Người dùng cần có lựa chọn:
FALSE_POSITIVE.
Nhưng nên yêu cầu:
lý do/evidence.
Không chỉ:
dismiss.
85. False-positive feedback phải đi về rule owner
Nếu 20 finding cùng loại bị xác nhận:
false positive,
rule cần:
review.
Đây là vòng cải tiến.
86. Cũng cần phản hồi VALID_EXCEPTION
Ví dụ rule đúng nhưng:
case thuộc exception.
Nếu exception này xảy ra thường xuyên:
có thể cần đưa vào catalog chính thức nếu có căn cứ.
Không sửa code bằng:
điều kiện ad hoc.
87. Finding nên có trạng thái “why resolved?”
Ví dụ:
DATA_CORRECTED
EVIDENCE_ADDED
VALID_EXCEPTION
RULE_FALSE_POSITIVE
PAYMENT_ITEM_WITHDRAWN
NO_ACTION_REQUIRED.
Nhờ đó báo cáo cải tiến:
có ý nghĩa.
88. Không nên đóng cảnh báo chỉ bằng nút “Đã xử lý”
“Đã xử lý” không nói:
xử lý thế nào.
Hệ thống cần:
resolution evidence.
89. Sau sửa dữ liệu phải re-evaluate
Nếu:
observed value thay đổi,
rule phải chạy lại.
Finding chỉ được:
resolved
khi evaluation mới phù hợp.
Không dựa:
hoàn toàn vào tick của người dùng.
90. Cảnh báo có thể giải trình giúp kiểm thử rule tốt hơn
Khi test thất bại, developer có thể thấy:
- input;
- expected;
- candidate catalog;
- chosen condition;
- evidence;
- basis.
Nếu chỉ có:
PASS/FAIL,
debug rất khó.
91. Explainability phải được thiết kế từ engine, không vá ở UI
Nếu engine không lưu:
candidate resolution;
evidence;
version,
UI không thể:
tạo ra sau.
Do đó finding evidence là:
core architecture.
Không phải:
tính năng giao diện phụ.
92. Đây là lý do FindingEvidence quan trọng
Mỗi evaluation nên tạo:
structured evidence.
Không chỉ:
message string.
Evidence có thể phục vụ:
- người dùng;
- audit;
- test;
- analytics;
- dispute review.
93. Cảnh báo tốt còn hỗ trợ bảo vệ khoản chi hợp lệ
Ví dụ BHXH phản hồi:
condition chưa rõ.
Nếu Dr5 đã lưu:
- condition;
- source;
- evidence;
- căn cứ;
cơ sở có thể nhanh chóng:
xây hồ sơ giải trình.
Như vậy explainability không chỉ phục vụ:
phát hiện lỗi.
Nó còn phục vụ:
bảo vệ chi phí đúng.
94. Đây là cầu nối giữa Chương 8 và Chương 6
Chương 6 đã trình bày:
evidence-based explanation/dispute.
Chương 8 phải tạo evidence:
ngay từ lúc tiền kiểm tra.
Không chờ:
sau khi bị phản hồi mới bắt đầu tìm.
95. Một finding tốt chính là một “mini audit package”
Tối thiểu gồm:
Who/episode
Where in data
What observed
What expected
Compared against what
Which condition
Which evidence
Which basis
Which amount
What action.
96. Mẫu cấu trúc finding đề xuất
Có thể hình dung:
Finding ID: F...
Class:
ERROR_TECH / INFO_EVIDENCE / WARN_REVIEW / PAYMENT_CONDITION
Source type: ...
Control point: ...
MA_LK: ...
Table / row: ...
Field: ...
Observed value: ...
Normalized value: ...
Expected condition: ...
Reference source: ...
Catalog/version: ...
Related records: ...
Evidence: ...
Affected amount: ...
Rule ID/version: ...
Legal/source basis: ...
Effective period: ...
Explanation: ...
Owner: ...
Recommended action: ...
Đây là đề xuất kiến trúc Dr5, không phải biểu mẫu pháp lý bắt buộc.
97. Ví dụ 1 — ERROR_TECH
Class:
ERROR_TECH
Location: XML3, STT 25
Field:
MA_KHOA
Observed: K99
Expected: thuộc danh mục khoa applicable tại event date
Reference: catalog version V...
Reason:
CATALOG_NOT_MEMBER
Action: kiểm tra khoa thực hiện và mapping tại hệ thống nguồn.
Finding này không cần:
suy luận chuyên môn.
98. Ví dụ 2 — INFO_EVIDENCE
Class:
INFO_EVIDENCE
Item: DVKT X
Source: XML3 STT 12
Expected evidence: kết quả tương ứng
Sources searched: XML4, LIS connector
Result: chưa resolve được
Action: kiểm tra nguồn kết quả/HSBA.
Không nên ghi:
“DVKT không có kết quả.”
99. Ví dụ 3 — WARN_REVIEW
Class:
WARN_REVIEW
Item: DVKT X
Observed: 5 business events/48h
Comparator: P95 = 3
Source: Internal analytics
Affected cost: ...
Action: rà soát timeline, kết quả và diễn biến.
Không có:
kết luận thanh toán.
100. Ví dụ 4 — PAYMENT_CONDITION
Một finding chỉ nên ở mức này nếu có:
condition cụ thể;
applicability đã resolve;
event date phù hợp;
evidence đầy đủ;
exception đã được đánh giá;
condition được chứng minh không đạt.
Finding phải hiển thị:
Condition: ...
Observed evidence: ...
Expected: ...
Legal basis: ...
Estimated affected requested amount: ...
Action: payment review/correction.
Và vẫn phải ghi:
đây là kết quả tiền kiểm tra nội bộ của Dr5, không phải quyết định giám định chính thức của BHXH.
101. Ma trận thông tin tối thiểu theo finding class
| Thành phần | ERROR_TECH | INFO_EVIDENCE | WARN_REVIEW | PAYMENT_CONDITION |
|---|---|---|---|---|
| Field/record | Bắt buộc | Khi relevant | Khi relevant | Bắt buộc |
| Observed value | Bắt buộc | Có nếu có | Bắt buộc | Bắt buộc |
| Expected | Bắt buộc | Evidence cần | Comparator | Bắt buộc |
| Reference source | Bắt buộc | Bắt buộc | Bắt buộc | Bắt buộc |
| Legal/source basis | Theo rule | Theo rule | Ghi source | Bắt buộc |
| Amount | Nếu liên quan | Nếu liên quan | Nên có | Bắt buộc nếu xác định được |
| Action | Bắt buộc | Bắt buộc | Bắt buộc | Bắt buộc |
102. Một cảnh báo chỉ thực sự “có thể giải trình” khi có thể tái dựng
Người kiểm tra phải có thể hỏi:
Tại sao Dr5 tạo finding này?
và hệ thống trả lời được bằng:
dữ liệu + logic + reference + version + căn cứ.
Không phải:
“Vì AI đánh giá như vậy.”
Không phải:
“Vì rule 123 nói vậy.”
103. AI có thể viết phần giải thích nhưng không được sáng tạo evidence
AI có thể chuyển structured finding thành:
câu dễ hiểu.
Nhưng không được:
- invent legal basis;
- invent missing result;
- invent indication;
- invent exception.
Nội dung giải thích phải:
grounded trong evidence graph.
104. Nếu AI tạo summary, structured finding vẫn là source of truth
Ví dụ AI viết:
“Dịch vụ có nguy cơ không đủ điều kiện...”
Người dùng vẫn phải mở được:
source data phía dưới.
Không dùng AI prose làm:
bằng chứng.
105. Explainability phải bảo tồn uncertainty
Nếu condition = UNKNOWN:
phần giải thích phải nói UNKNOWN.
Không để language model biến:
“chưa tìm thấy”
thành:
“không có”.
Đây là một nguy cơ lớn nếu sinh message tự động.
106. Có thể kiểm thử chính nội dung explanation
Test không chỉ kiểm tra:
classification.
Còn có thể kiểm tra:
- đúng field;
- đúng value;
- đúng catalog version;
- đúng legal basis;
- không gọi UNKNOWN là FALSE.
Đây là:
explainability regression test.
107. Không nên để message chứa dữ liệu cũ sau re-evaluation
Nếu source thay đổi:
structured finding phải update state.
Message được render lại từ:
evaluation mới.
Không cache:
câu cũ
làm người dùng nhầm.
108. Nhưng historical message/evaluation vẫn phải giữ trong audit
Operational view:
trạng thái hiện tại.
Audit view:
lịch sử.
Hai mục tiêu khác nhau.
109. Explainability cũng hỗ trợ quản trị catalog
Nếu người dùng thấy:
hàng loạt finding cùng reference sai,
có thể phát hiện:
catalog version lỗi.
Không cần:
debug từng hồ sơ.
110. Nó cũng hỗ trợ quản trị rule
Có thể nhóm finding theo:
rule_id.
Xem:
- số phát hiện;
- số false positive;
- số valid exception;
- amount;
- resolution.
Rule owner có cơ sở:
cải tiến rule.
111. Cảnh báo càng nghiêm trọng càng cần explanation mạnh
Một:
informational message
có thể ngắn.
Một:
hard stop
phải giải thích:
rất rõ.
Một:
payment condition
phải có:
full evidence/basis chain.
Nguyên tắc:
hậu quả càng lớn → yêu cầu giải trình càng cao.
112. Không nên có hard stop “black box”
Nếu hệ thống cấm người dùng tiếp tục:
phải cho biết lý do.
Ngoại trừ các giới hạn bảo mật cần thiết, người dùng phải hiểu:
họ cần làm gì để giải quyết.
113. Cũng không nên có payment finding không truy được khoản tiền
Nếu finding liên quan một khoản chi:
phải chỉ được dòng.
Nếu chỉ biết:
episode có rủi ro chung
nhưng chưa xác định khoản nào:
nên giữ ở
WARN_REVIEWhoặc lớp phù hợp hơn.
Không nên gán:
toàn bộ
T_BHTT
là amount at risk.
114. Amount attribution phải bảo thủ
Nếu condition chỉ liên quan:
một dòng dịch vụ,
không nên tính:
toàn episode
là số tiền rủi ro.
Nếu relation ảnh hưởng:
nhiều dòng,
phải nêu:
phạm vi.
Không phóng đại financial impact.
115. Không cộng trùng amount của nhiều finding
Một dòng 1 triệu có:
ba finding.
Không có nghĩa:
tổng risk = 3 triệu.
Cần:
deduplicate affected financial object
khi tổng hợp.
Đây là yêu cầu quan trọng của dashboard tài chính.
116. Finding và financial exposure là hai mô hình liên quan nhưng khác nhau
Một finding có thể:
ảnh hưởng một hoặc nhiều khoản.
Một khoản có thể:
bị nhiều finding tác động.
Do đó tổng amount-at-risk cần:
aggregation logic riêng.
Không sum:
finding amounts một cách mù quáng.
117. Cảnh báo phải hỗ trợ export và báo cáo
Một danh sách tiền giám định cần có thể xuất:
- MA_LK;
- người bệnh;
- table/row;
- item;
- finding class;
- observed;
- expected;
- basis;
- amount;
- owner;
- status.
Nhưng dữ liệu nhạy cảm cần:
phân quyền phù hợp.
118. Có thể dùng finding để tạo hồ sơ review tự động
Ví dụ:
50 payment findings cùng rule.
Hệ thống có thể:
gom thành review batch.
Nhưng từng finding vẫn giữ:
evidence riêng.
119. Cảnh báo explainable còn giúp đào tạo
Một nhân viên mới nhìn finding có thể học:
field này có ý nghĩa gì;
vì sao cần đối chiếu;
căn cứ nào.
Như vậy Dr5 còn đóng vai trò:
embedded learning system.
120. Mục tiêu cuối cùng là “one-click traceability”
Từ một cảnh báo, người dùng lý tưởng có thể đi:
Finding
→ source line
→ related evidence
→ reference catalog
→ condition
→ legal basis
→ resolution.
Không phải:
tự tìm từng thành phần ở nhiều nơi.
Kết luận
Một cảnh báo có thể giải trình không phải là một message dài hơn.
Nó là:
một cấu trúc bằng chứng có thể truy ngược.
Một finding tốt phải trả lời ít nhất:
Hồ sơ nào?
Bảng nào?
Dòng nào?
Field nào?
Giá trị hiện tại là gì?
Điều kiện hoặc giá trị kỳ vọng là gì?
Nguồn nào được dùng để đối chiếu?
Phiên bản nào?
Khoản chi nào liên quan?
Rule nào tạo finding?
Căn cứ nào áp dụng?
Evidence nào đã có hoặc còn thiếu?
Người dùng phải làm gì tiếp theo?
Mười nguyên tắc cần nhớ:
Cảnh báo phải được xây từ structured finding, không bắt đầu và kết thúc bằng một chuỗi message.
Phải chỉ rõ table, row, field và observed value; với dòng chi phí phải định vị chính xác khoản thuốc/DVKT/VTYT liên quan khi có thể.
STT có giá trị để định vị dòng trong payload, nhưng không nên được sử dụng như business identifier bất biến xuyên mọi lần gửi; finding phải gắn với submission/version và context của event.
Reference source phải được xác định cụ thể: danh mục nào, version nào, source system nào, evidence nào.
Với dữ liệu tài chính phải phân biệt rõ tổng chi, phần trong phạm vi BHYT, cùng chi trả, tự trả, nguồn khác và số tiền đề nghị quỹ thanh toán; không gọi chung tất cả là “tiền xuất toán”.
Legal basis phải hỗ trợ đúng conclusion của rule; không được gắn một văn bản chỉ để làm cảnh báo có vẻ có căn cứ.
Rule nội bộ, analytics screening và tiêu chí chính thức phải được gắn source type khác nhau; Điều 16 giao BHXH Việt Nam ban hành tiêu chí, tiêu chuẩn chính thức áp dụng trên Hệ thống thông tin giám định BHYT.
UNKNOWN phải được giải thích là chưa đủ dữ liệu; “chưa resolve được” không được tự chuyển thành “không tồn tại”.
Finding lịch sử phải giữ snapshot của dữ liệu, rule, catalog và căn cứ đã được dùng tại thời điểm đánh giá để có thể tái dựng kết quả.
Hậu quả của cảnh báo càng lớn — đặc biệt hard stop hoặc
PAYMENT_CONDITION— yêu cầu evidence chain và explainability càng phải chặt chẽ.
Đối với Dr5-XML, một finding có thể được hình dung theo công thức:
**Finding =
Subject
- Source location
- Observed value
- Expected condition
- Reference source
- Evidence
- Rule/version
- Legal/source basis
- Financial impact
- Resolution path.**
Vì vậy Dr5 không nên nói đơn giản:
“Hồ sơ này sai.”
Mà phải nói được:
“Tại XML3, dòng chi phí này có giá trị X. Rule R phiên bản V áp dụng vì context C và event date D. Giá trị này được đối chiếu với catalog/condition Y phiên bản Z. Kết quả hiện tại là..., evidence được sử dụng gồm..., căn cứ áp dụng là..., số tiền có khả năng liên quan là..., và hành động tiếp theo cần thực hiện là...”
Khi một cảnh báo đạt được mức đó, người sử dụng không còn phải:
tin Dr5.
Họ có thể:
kiểm tra Dr5.
Đó chính là tiêu chuẩn quan trọng nhất của một hệ thống tiền giám định có thể giải trình.
- Đăng nhập để gửi ý kiến