Dữ liệu XML BHYT có thể phải điều chỉnh sau khi đã được tạo hoặc đã gửi.
Nguyên nhân có thể đến từ:
- phát hiện sai lệch so với hồ sơ thực tế;
- thiếu thông tin;
- sai cấu trúc hoặc định dạng;
- sai danh mục;
- sai giá, số lượng hoặc thành tiền;
- dữ liệu tổng hợp không khớp dữ liệu chi tiết;
- phản hồi cảnh báo hoặc từ chối từ Cổng;
- dữ liệu chuyên môn phát sinh bổ sung sau thời điểm gửi trước.
Thông tư 48/2017/TT-BYT yêu cầu cơ sở KCB kiểm tra, đối chiếu, hiệu chỉnh dữ liệu sai lệch, bổ sung thông tin còn thiếu hoặc loại bỏ thông tin chưa phù hợp trước khi gửi dữ liệu đề nghị thanh toán. Khi Cổng trả cảnh báo hoặc từ chối, thông tin lỗi phải được phản hồi chi tiết để cơ sở hoàn chỉnh kịp thời.
Thông tư 12/2026/TT-BTC tiếp tục quy định trường hợp Cổng phản hồi lỗi cấu trúc, định dạng hoặc sai lệch giữa các bảng; nếu xác định có sai sót, cơ sở gửi hồ sơ điều chỉnh kèm văn bản nêu rõ thông tin, số liệu sửa chữa, điều chỉnh trong thời hạn quy định.
Nhưng về công nghệ thông tin, “điều chỉnh” không nên được hiểu là:
mở file XML đã gửi → sửa vài field → ghi đè → gửi lại.
Cách quản trị đúng hơn là:
xác định nguyên nhân → sửa tại nguồn → tạo version mới → kiểm tra lại → xác thực/ký lại khi cần → gửi lại → giữ nguyên dấu vết version cũ.
1. Điều chỉnh dữ liệu khác với sửa âm thầm dữ liệu lịch sử
Một hồ sơ đã được gửi là một sự kiện đã xảy ra.
Ví dụ:
- V1 được tạo lúc 10:00;
- ký lúc 10:15;
- gửi lúc 10:20;
- Cổng tiếp nhận lúc 10:21.
Nếu sau đó phát hiện sai, không nên sửa nội dung V1 và làm như thể bản sai chưa từng tồn tại.
Đúng hơn phải hiểu:
V1 là phiên bản đã từng được gửi.
Sau khi điều chỉnh:
V2 là phiên bản mới thay thế V1 trong quy trình tiếp theo.
V1 vẫn cần được giữ lại để trả lời:
- đã gửi gì;
- lúc nào;
- ai gửi;
- Cổng phản hồi gì;
- vì sao phải sửa.
2. Sửa dữ liệu phải bắt đầu từ nguồn nghiệp vụ
Nguyên tắc của Bài 3.1 tiếp tục áp dụng.
Nếu XML sai:
Sai MA_KHOA
Kiểm tra:
- khoa thực tế;
- chuyển khoa;
- mapping danh mục;
- Mẫu 01/DM.
Sai thuốc
Kiểm tra:
- y lệnh;
- cấp phát;
- hoàn trả;
- danh mục thuốc;
- mapping Mẫu 03/DM.
Sai vật tư
Kiểm tra:
- xuất dùng;
- hoàn trả;
- DVKT;
- đơn vị tính;
- Mẫu 04/DM.
Sai MA_MAY
Kiểm tra:
- thiết bị thực tế;
- LIS/RIS;
- mapping máy;
- Mẫu 06/DM.
Sai thành tiền
Kiểm tra:
- số lượng;
- đơn giá;
- tỷ lệ;
- công thức;
- dữ liệu chi tiết XML2/XML3.
Không nên:
sửa XML cuối mà không sửa dữ liệu nguồn.
Nếu không, lần kết xuất sau lỗi có thể xuất hiện trở lại.
3. Cần phân biệt “correction” với “new event”
Không phải thay đổi nào cũng là sửa lỗi.
Ví dụ:
- kết quả xét nghiệm phát sinh sau thời điểm gửi trước;
- hồ sơ được bổ sung theo đúng quy trình;
- thông tin mới thực sự phát sinh sau đó.
Đây có thể là:
bổ sung dữ liệu mới
khác với:
sửa dữ liệu sai.
Hệ thống nên lưu change_type, ví dụ:
CORRECTION;COMPLETION;ADDITION;CANCELLATION;RECALCULATION.
Điều này giúp giải trình đúng bản chất thay đổi.
4. Version phải gắn với nội dung, không chỉ với tên file
Không nên quản lý phiên bản bằng cách:
hoso_moi.xml;hoso_moi2.xml;hoso_final.xml;hoso_final_final.xml.
Version phải là một thuộc tính chính thức.
Ví dụ:
| Version | Ý nghĩa |
|---|---|
| V1 | gửi lần đầu |
| V2 | sửa lỗi giá |
| V3 | bổ sung kết quả CLS |
| V4 | điều chỉnh sau phản hồi Cổng |
Mỗi version cần có ít nhất:
version_id;episode_id;created_at;created_by;change_reason;supersedes_version;- trạng thái;
- hash nội dung.
5. Version mới phải chỉ rõ thay thế version nào
Quan hệ quan trọng là:
V2 supersedes V1
hoặc:
V3 supplements V2
Tùy nghiệp vụ.
Không nên chỉ biết:
“V3 là bản mới nhất.”
Cần biết lịch sử:
V1 → V2 → V3.
Nhờ đó có thể tái dựng toàn bộ chuỗi thay đổi.
6. Không phải mọi thay đổi đều cần gửi lại toàn bộ theo cùng một cách
Phạm vi gửi lại phụ thuộc:
- loại hồ sơ;
- yêu cầu của Cổng;
- nội dung điều chỉnh;
- quy định giao dịch đang áp dụng.
Nguồn được sử dụng ở đây xác nhận yêu cầu gửi hồ sơ điều chỉnh khi có sai sót đối với các tình huống quy định tại Điều 9 Thông tư 12, nhưng không mô tả một cơ chế kỹ thuật duy nhất áp dụng cho mọi loại điều chỉnh XML.
Do đó phần mềm không nên tự suy diễn:
mọi lỗi → gửi lại toàn bộ package theo cùng một thủ tục.
Phải tuân theo loại giao dịch thực tế của Cổng.
7. Điều chỉnh sau phản hồi phải gắn với phản hồi gây ra điều chỉnh
Nếu Cổng trả:
XML3 dòng 25 sai
MA_DICH_VU
và bệnh viện tạo V2 sửa lỗi này, hệ thống cần lưu:
V2 được tạo để xử lý response R123 của submission S456.
Không nên chỉ ghi:
“đã sửa”.
Một chain đầy đủ là:
Submission S1
→ Response R1
→ Finding F1
→ Correction V2
→ Submission S2.
Đây là traceability rất quan trọng.
8. Thông tư 12 yêu cầu nêu rõ thông tin, số liệu sửa chữa
Điều 9 quy định khi nhận phản hồi thuộc các trường hợp sai cấu trúc/định dạng hoặc sai lệch số liệu và xác định có sai sót, cơ sở gửi hồ sơ điều chỉnh kèm văn bản ghi rõ thông tin, số liệu sửa chữa, điều chỉnh.
Về CNTT, đây là cơ sở tốt để hệ thống tự động tạo:
change summary.
Ví dụ:
| Field | Trước | Sau | Lý do |
|---|---|---|---|
DON_GIA_BH | 150.000 | 120.000 | áp sai version giá |
MA_KHOA | K03 | K04 | sai mapping khoa |
SO_LUONG | 10 | 1 | sai hệ số đơn vị |
Không nên bắt nhân viên viết lại thủ công toàn bộ nếu hệ thống đã có diff.
9. Phải lưu cả dữ liệu trước và sau khi thay đổi
Một audit trail tốt không chỉ lưu:
“User A changed MA_KHOA.”
Mà cần:
before = K03after = K04
và:
- thời điểm;
- người sửa;
- lý do;
- nguồn căn cứ;
- version liên quan.
Nếu nhiều field cùng đổi, lưu theo transaction thay đổi.
10. Khi sửa một field phải đánh giá tác động lan truyền
Một thay đổi có thể ảnh hưởng nhiều bảng.
Ví dụ sửa:
MA_KHOA
Có thể ảnh hưởng:
- XML1;
- XML2;
- XML3;
- nhân lực;
- giường;
- dịch vụ.
NGAY_RA
Có thể ảnh hưởng:
- số ngày điều trị;
- ngày giường;
- thời hạn gửi;
- giấy ra viện;
- giấy hẹn.
Giá DVKT
Có thể ảnh hưởng:
- XML3;
- thành tiền;
- XML1;
- Bảng tổng hợp;
- quyết toán.
Do đó sau correction phải chạy:
impact analysis → regenerate related outputs → reconciliation.
Không nên chỉ sửa đúng field bị Cổng báo lỗi.
11. Version mới phải được tiền kiểm lại
Một lỗi phổ biến là:
V1 đã tiền kiểm
→ sửa một field thành V2
→ gửi ngay.
Nhưng thay đổi một field có thể tạo lỗi mới.
Ví dụ đổi MA_DICH_VU có thể làm:
- khoa không còn phù hợp;
- máy không phù hợp;
- giá sai;
- chẩn đoán không hợp lý;
- vật tư liên quan sai.
Vì vậy:
mọi version mới phải đi qua lại các rule chịu ảnh hưởng.
Không nhất thiết chạy toàn bộ rule nếu hệ thống hỗ trợ dependency graph, nhưng phải đảm bảo đủ phạm vi.
12. Nếu version đã ký bị thay đổi thì phải ký lại
Như Bài 3.4 đã nêu:
chữ ký gắn với nội dung cụ thể.
Nếu V1 đã ký mà dữ liệu thay đổi:
V2 không thể kế thừa chữ ký của V1.
Workflow đúng:
V1 SIGNED
→ correction
→ V2 DRAFT
→ PRECHECK
→ APPROVED
→ SIGNED
→ SENT.
Không nên:
V1 SIGNED → edit file → resend.
13. Tránh gửi trùng: trước hết phải phân biệt retry với resend
Hai khái niệm khác nhau.
Retry
Thử lại cùng một transaction hoặc cùng nội dung do lỗi kỹ thuật.
Ví dụ:
- timeout;
- mất mạng;
- kết nối gián đoạn.
Resend
Gửi một version mới hoặc một giao dịch điều chỉnh có chủ đích.
Ví dụ:
- sửa dữ liệu;
- bổ sung;
- gửi lại sau phản hồi.
Nếu hệ thống không phân biệt hai trường hợp này, nguy cơ gửi trùng rất cao.
14. Timeout không phải bằng chứng hồ sơ chưa đến Cổng
Một tình huống điển hình:
- bệnh viện gửi V1;
- Cổng nhận thành công;
- response bị mất;
- client timeout.
Nếu client kết luận:
“gửi thất bại”
và gửi lại ngay, Cổng có thể nhận hai lần.
Do đó trạng thái đúng là:
DELIVERY_UNCONFIRMED
trước khi xác định được transaction thực tế.
Cần tra cứu trạng thái trước khi retry khi cơ chế giao dịch cho phép.
15. Idempotency là biện pháp CNTT nên có
Các văn bản đang xét không quy định cụ thể thuật ngữ idempotency key.
Đây là khuyến nghị kiến trúc CNTT.
Có thể tạo khóa theo:
facility + episode + purpose + version
hoặc theo transaction identifier phù hợp với giao thức.
Mục tiêu:
cùng một version không tạo nhiều submission logic ngoài ý muốn.
Nếu người dùng bấm “Gửi” hai lần thì hệ thống nội bộ vẫn nhận biết đây là cùng một yêu cầu.
16. Hash giúp nhận biết cùng nội dung hay nội dung đã thay đổi
Có thể tính:
SHA-256(xml_package)
cho từng version.
Nếu:
- hash giống nhau;
- version giống nhau;
- hồ sơ đã được Cổng xác nhận tiếp nhận;
thì hệ thống có thể cảnh báo trước khi gửi lại:
“Nội dung này đã được gửi và tiếp nhận.”
Nếu hash thay đổi:
đó thực chất là nội dung khác và phải được quản lý như version mới.
Hash là biện pháp kỹ thuật nội bộ, không thay thế chữ ký số hoặc quy định nghiệp vụ.
17. Không nên tự động retry vô hạn
Một sender không được thiết kế:
lỗi → retry liên tục cho đến khi thành công.
Điều này có thể:
- tạo tải lớn;
- gây gửi trùng;
- làm mất dấu nguyên nhân;
- che giấu sự cố kéo dài.
Nên có:
- số lần retry;
- backoff;
- trạng thái trung gian;
- ngưỡng chuyển sang xử lý thủ công.
Ví dụ:
SEND_FAILED_TEMPORARYDELIVERY_UNCONFIRMEDMANUAL_REVIEW_REQUIRED.
18. Phải xác định “version hiện hành” nhưng không xóa version cũ
Trong workflow có thể có:
- V1 superseded;
- V2 rejected;
- V3 current.
Hệ thống cần biết:
current_effective_version = V3
nhưng vẫn lưu:
- V1;
- V2;
- các transaction;
- các phản hồi.
Không nên chỉ lưu file cuối cùng.
19. Không phải bản mới nhất luôn là bản hợp lệ nhất
Giả sử:
- V1 đã gửi thành công;
- V2 được tạo nhưng chưa ký;
- V3 đang chỉnh sửa.
Nếu hỏi:
“Bản đã gửi hợp lệ gần nhất là bản nào?”
câu trả lời vẫn có thể là V1.
Do đó cần phân biệt:
latest_created_version;latest_signed_version;latest_sent_version;latest_received_version;current_working_version.
Không nên dùng một field:
latest_version.
20. Cần bảo đảm consistency giữa XML chi tiết và dữ liệu tổng hợp sau điều chỉnh
Một thay đổi ở XML2/XML3 có thể làm thay đổi:
- XML1;
- Bảng kê chi tiết;
- Bảng tổng hợp;
- Báo cáo quyết toán.
Thông tư 12 có cơ chế phản hồi trong trường hợp Bảng tổng hợp lệch Bảng kê chi tiết hoặc Báo cáo quyết toán không khớp Bảng tổng hợp.
Vì vậy sau correction cần thực hiện:
recalculate → regenerate → reconcile.
Không chỉ:
“sửa field → resend”.
21. Không được dùng correction để hợp thức hóa dữ liệu không có căn cứ
Điều chỉnh được phép khi dữ liệu:
- sai lệch so với thực tế;
- thiếu;
- chưa phù hợp;
- hoặc cần sửa theo phản hồi.
Thông tư 48 yêu cầu việc hiệu chỉnh hướng tới việc làm dữ liệu phù hợp với thực tế.
Do đó không được:
- thêm DVKT không có bằng chứng thực hiện;
- đổi chẩn đoán chỉ để đạt điều kiện thanh toán;
- đổi thời gian không có căn cứ;
- tạo y lệnh hồi cứu chỉ để khớp XML.
Nguyên tắc:
correction phải làm dữ liệu gần thực tế hơn, không phải làm hồ sơ “đẹp hơn”.
22. Một correction workflow nên có các bước
Có thể chuẩn hóa:
1. Phát hiện vấn đề
→ 2. Xác định source of truth
→ 3. Xác định phạm vi ảnh hưởng
→ 4. Sửa dữ liệu nguồn
→ 5. Tạo version mới
→ 6. Tính toán lại
→ 7. Regenerate XML
→ 8. Chạy tiền kiểm
→ 9. So sánh diff
→ 10. Phê duyệt/ký lại
→ 11. Gửi lại
→ 12. Theo dõi phản hồi.
Đây là thiết kế CNTT đề xuất, không phải trình tự được văn bản liệt kê từng bước.
23. Diff phải trở thành một artifact chính thức
Trước khi gửi version điều chỉnh, hệ thống nên tự động tạo diff.
Ví dụ:
V1 → V2
- XML1.
T_TONGCHI_BV: 5.200.000 → 5.080.000 - XML3.STT 12.
DON_GIA_BH: 620.000 → 500.000 - XML3.STT 12.
THANH_TIEN_BH: tính lại - XML1.
T_BHTT: tính lại
Người phê duyệt có thể xem:
chính xác dữ liệu nào đã thay đổi.
Điều này tốt hơn nhiều so với đọc lại toàn bộ XML.
24. Dấu vết thay đổi cần đủ để giải trình nhiều năm sau
Một correction record nên trả lời được:
- version cũ là gì;
- version mới là gì;
- lý do sửa;
- lỗi đến từ đâu;
- ai yêu cầu;
- ai thực hiện;
- field nào đổi;
- trước/sau là gì;
- bằng chứng nào;
- ai phê duyệt;
- gửi lại lúc nào;
- Cổng phản hồi thế nào.
Đây là audit trail.
Thông tư 48 cũng đặt yêu cầu chung về bảo đảm tính chính xác, toàn vẹn và an toàn của dữ liệu điện tử; việc lưu dấu vết thay đổi là một biện pháp CNTT phù hợp với mục tiêu quản trị đó.
25. Trạng thái gợi ý cho version
Có thể dùng:
| Trạng thái | Ý nghĩa |
|---|---|
DRAFT | đang chỉnh sửa |
REVIEW_REQUIRED | chờ kiểm tra |
PRECHECK_PASSED | đã qua tiền kiểm |
APPROVED | đã phê duyệt |
SIGNED | đã ký |
SENT | đã gửi |
RECEIVED | Cổng xác nhận nhận |
ACTION_REQUIRED | có phản hồi cần xử lý |
SUPERSEDED | đã có version thay thế |
CANCELLED | không sử dụng |
CLOSED | hoàn tất workflow |
Một version SUPERSEDED không bị xóa.
26. Một số rule kiểm soát có giá trị cao
| Tình huống | Cảnh báo |
|---|---|
sửa trực tiếp version đã SENT | ERROR_TECH |
sửa version đã SIGNED nhưng không tạo version mới | ERROR_TECH |
| V2 không khai báo supersede V1 | WARN_REVIEW |
cùng version/hash gửi nhiều lần sau khi đã RECEIVED | duplicate warning |
| version mới chưa tiền kiểm nhưng đã gửi | ERROR_TECH |
| dữ liệu XML sửa nhưng nguồn nghiệp vụ không đổi | WARN_REVIEW |
| thay đổi XML2/XML3 nhưng không tính lại XML1 | ERROR_TECH |
| phản hồi yêu cầu sửa nhưng không có change reason | INFO_EVIDENCE |
| version cũ bị xóa | ERROR_TECH |
| transaction mới không gắn response cũ | WARN_REVIEW |
27. Thiết kế cho Dr5-XML
Dr5-XML nên coi:
episode
và:
submission version
là hai thực thể khác nhau.
Một episode có thể có:
V1 → V2 → V3.
Mỗi version lại có thể có:
0 hoặc nhiều validation runs
→ một chữ ký
→ một hoặc nhiều transaction kỹ thuật có kiểm soát
→ các response.
Rule engine cần biết version nào đang được đánh giá.
Finding cũng nên gắn với:
episode_id + version_id
để không xảy ra trường hợp lỗi của V1 vẫn hiển thị như lỗi của V3 dù đã được sửa.
Kết luận
Điều chỉnh và gửi lại dữ liệu không phải là thao tác sửa file đơn giản.
Đó là một quy trình quản lý phiên bản:
phát hiện sai
→ xác định nguồn
→ sửa nguồn
→ tạo version mới
→ tái tính toán và kết xuất
→ tiền kiểm
→ xác thực/ký lại
→ gửi lại
→ nhận phản hồi
→ đóng version cũ nhưng không xóa lịch sử.
Sáu nguyên tắc cần nhớ:
Không sửa đè phiên bản đã gửi.
Không sửa XML tách rời dữ liệu nguồn.
Mọi thay đổi phải truy được trước–sau, lý do và người thực hiện.
Version đã thay đổi sau khi ký phải được kiểm tra và ký lại.
Retry kỹ thuật khác với gửi lại một version điều chỉnh.
Không có phản hồi không đồng nghĩa hồ sơ chưa được Cổng tiếp nhận; phải tránh gửi trùng do timeout hoặc trạng thái không xác định.
Đối với Dr5-XML, đây là nền tảng để hình thành một hệ thống versioned claim workflow: mỗi lần sửa đều có nguyên nhân, mỗi lần gửi đều có transaction, mỗi phản hồi đều gắn được với đúng version và toàn bộ lịch sử vẫn có thể tái dựng để phục vụ giám định, giải trình và kiểm toán.
- Đăng nhập để gửi ý kiến