Trong vận hành hồ sơ XML BHYT, một lỗi quản trị rất phổ biến là gom nhiều trạng thái khác nhau thành một trạng thái duy nhất:
“Đã gửi.”
Cách hiểu này không đủ.
Một hồ sơ có thể đã được kết xuất nhưng chưa gửi. Có thể đã gửi khỏi bệnh viện nhưng Cổng chưa xác nhận tiếp nhận. Có thể Cổng đã tiếp nhận nhưng chưa có kết quả giám định. Có thể đã có phản hồi nhưng bệnh viện chưa xử lý. Có thể đã điều chỉnh nhưng chưa gửi lại.
Thông tư 48/2017/TT-BYT phân biệt rõ việc gửi dữ liệu, Cổng tiếp nhận, phản hồi kết quả gửi/tiếp nhận, phản hồi kết quả giám định và xử lý trường hợp cảnh báo hoặc từ chối. Thông tư 12/2026/TT-BTC tiếp tục quy định phản hồi tự động đối với hồ sơ đề nghị thanh toán và việc điều chỉnh sau phản hồi.
Vì vậy nguyên tắc quan trọng là:
Trạng thái hồ sơ phải phản ánh đúng vị trí của hồ sơ trong vòng đời giao dịch, không chỉ phản ánh việc phần mềm đã bấm nút gửi hay chưa.
1. “Đã kết xuất” chỉ có nghĩa file đã được tạo
Trạng thái đầu tiên sau khi hệ thống tổng hợp dữ liệu có thể là:
ĐÃ KẾT XUẤT
Nó chỉ có nghĩa:
- hệ thống đã lấy dữ liệu nguồn;
- đã tạo cấu trúc XML;
- đã sinh ra một version hồ sơ.
Trạng thái này chưa chứng minh:
- XML đã đúng;
- đã qua tiền kiểm;
- đã ký số;
- đã gửi;
- hay Cổng đã tiếp nhận.
Do đó không nên dùng:
exported = sent
hoặc hiển thị chung “Đã xử lý”.
Một hồ sơ vừa được tạo nên được xem là artifact nội bộ cho đến khi giao dịch gửi thực sự xảy ra.
2. “Đã gửi” là trạng thái từ phía bệnh viện
Sau khi hệ thống thực hiện giao dịch truyền dữ liệu, hồ sơ có thể chuyển sang:
ĐÃ GỬI
Nhưng đây vẫn là trạng thái được quan sát từ phía hệ thống bệnh viện.
Nó có thể chỉ chứng minh rằng:
- request đã được phát đi;
- API client đã gửi payload;
- hoặc file đã được chuyển sang lớp giao tiếp.
Nó chưa chắc chứng minh:
Cổng đã nhận thành công.
Ví dụ có thể xảy ra:
- timeout;
- mất kết nối sau khi gửi;
- phía bệnh viện không nhận được response;
- Cổng nhận được nhưng client tưởng thất bại;
- client gửi thất bại trước khi payload đến Cổng.
Do đó:
SENT ≠ RECEIVED.
3. “Đã tiếp nhận” phải dựa trên phản hồi của Cổng
Điều 6 Thông tư 48 quy định sau khi nhận dữ liệu về kết thúc lần khám hoặc đợt điều trị, Cổng phải thông báo để cơ sở biết rằng dữ liệu đã được tiếp nhận.
Đối với dữ liệu đề nghị giám định, thanh toán, Điều 7 cũng quy định Cổng phản hồi ngay sau khi nhận để cơ sở biết kết quả gửi và tiếp nhận dữ liệu.
Do đó trạng thái:
ĐÃ TIẾP NHẬN
chỉ nên được xác lập khi có evidence từ phía Cổng.
Evidence có thể gồm:
- transaction ID;
- response code;
- timestamp;
- receipt;
- acknowledgement;
- hoặc dữ liệu phản hồi tương ứng.
Không nên suy ra:
“HTTP request không lỗi → Cổng đã tiếp nhận.”
4. “Đã tiếp nhận” vẫn chưa phải “đã chấp nhận thanh toán”
Đây là điểm quan trọng nhất.
Một hồ sơ được Cổng tiếp nhận chỉ chứng minh:
hệ thống nhận đã nhận được hồ sơ.
Sau đó vẫn còn các lớp kiểm tra:
- cấu trúc;
- định dạng;
- quan hệ dữ liệu;
- điều kiện thanh toán;
- giám định tự động;
- cảnh báo;
- từ chối;
- đối chiếu tổng hợp.
Thông tư 48 quy định trong 07 ngày làm việc kể từ khi tiếp nhận dữ liệu đề nghị giám định, Cổng giám định phải thông báo chi tiết kết quả giám định; nếu có cảnh báo hoặc từ chối thì phải trả chi tiết lỗi theo từng trường thông tin của từng bảng XML.
Vì vậy:
RECEIVED ≠ ACCEPTED ≠ PAYABLE.
5. “Có phản hồi” cũng chưa đủ để biết hồ sơ đã xong
Trạng thái:
CÓ PHẢN HỒI
vẫn còn quá chung chung.
Phản hồi có thể là:
- xác nhận đã nhận;
- cảnh báo gửi trễ;
- lỗi cấu trúc;
- lỗi định dạng;
- chênh lệch số liệu;
- kết quả giám định;
- cảnh báo;
- từ chối;
- hoặc yêu cầu điều chỉnh.
Do đó hệ thống nên lưu:
response_type
chứ không chỉ:
has_response = true.
Ví dụ có thể phân loại:
RECEIPT_ACK;STRUCTURE_ERROR;FORMAT_ERROR;RECONCILIATION_ERROR;AUDIT_WARNING;REJECTED;ACCEPTED.
6. Phản hồi 06 giờ, 24 giờ và 48 giờ cần được gắn đúng loại
Thông tư 12 quy định Cổng phản hồi tự động:
- tối đa 06 giờ với hồ sơ gửi không đúng thời hạn;
- tối đa 24 giờ với hồ sơ sai cấu trúc hoặc định dạng;
- tối đa 48 giờ với sai lệch giữa Bảng tổng hợp và Bảng kê chi tiết hoặc giữa Báo cáo quyết toán và Bảng tổng hợp.
Do đó một hồ sơ sau khi RECEIVED có thể đồng thời đang chờ nhiều loại phản hồi.
Không nên thiết kế một trạng thái:
WAITING_RESPONSE
mà không biết đang chờ gì.
Có thể cần:
waiting_structure_response;waiting_reconciliation_response;waiting_audit_response.
7. “Chờ xử lý” là trạng thái nội bộ của bệnh viện
Khi Cổng trả lỗi hoặc cảnh báo, hồ sơ có thể chuyển sang:
CHỜ XỬ LÝ
Đây không phải trạng thái của Cổng mà là trạng thái workflow nội bộ.
Ví dụ:
- lỗi mã thuốc → giao Dược;
- sai
MA_MAY→ giao bộ phận thiết bị/HIS; - sai chẩn đoán → giao khoa chuyên môn;
- lệch tiền → giao viện phí;
- lỗi định dạng → giao CNTT;
- lỗi danh mục → giao BHYT/master data.
Do đó trạng thái PENDING_PROCESSING nên có:
- loại lỗi;
- đơn vị xử lý;
- người phụ trách;
- deadline;
- mức ưu tiên;
- version bị ảnh hưởng.
8. Không nên coi cảnh báo và từ chối là một trạng thái
Điều 7 Thông tư 48 phân biệt trường hợp dữ liệu:
- bị cảnh báo;
- bị từ chối;
- hoặc vừa cảnh báo vừa từ chối.
Vì vậy trong Dr5-XML cũng không nên gom tất cả thành:
ERROR.
Nên giữ các trạng thái khác nhau:
WARN_REVIEW
Hồ sơ vẫn cần xem xét nhưng chưa chứng minh không thanh toán.
REJECTED
Có nội dung bị từ chối theo phản hồi.
PARTIAL_REJECTED
Một phần hồ sơ/dòng chi phí bị từ chối.
Điều này đặc biệt quan trọng với hồ sơ có nhiều dòng chi phí.
9. Trạng thái nên tồn tại ở cả cấp hồ sơ và cấp dòng
Một hồ sơ XML có thể gồm:
- 1 XML1;
- nhiều dòng XML2;
- nhiều dòng XML3;
- nhiều kết quả XML4;
- các chứng từ liên quan.
Có thể xảy ra:
- hồ sơ tổng thể được tiếp nhận;
- 2 dòng thuốc bị cảnh báo;
- 1 dịch vụ bị từ chối;
- các dòng còn lại không lỗi.
Do đó nên có hai lớp trạng thái:
Cấp package/hồ sơ
Ví dụ:
RECEIVED_WITH_ISSUES
Cấp finding/dòng dữ liệu
Ví dụ:
- XML2 dòng 15 →
WARN_REVIEW; - XML3 dòng 22 →
REJECTED; - XML3 dòng 23 →
OK.
Như vậy không biến một lỗi cục bộ thành kết luận sai rằng toàn bộ hồ sơ bị từ chối.
10. Cần lưu transaction riêng cho mỗi lần gửi
Một hồ sơ có thể được gửi nhiều lần.
Không nên cập nhật:
sent_at = thời gian mới nhất
rồi làm mất lần gửi trước.
Nên có bảng transaction hoặc event log:
| Thuộc tính | Ý nghĩa |
|---|---|
submission_id | mã lần gửi |
episode_id | đợt KCB |
xml_version | version dữ liệu |
purpose | management/payment/correction |
sent_at | thời điểm gửi |
received_at | thời điểm Cổng xác nhận |
gateway_transaction_id | mã giao dịch Cổng |
response_type | loại phản hồi |
response_at | thời điểm phản hồi |
status | trạng thái lần gửi |
Nhờ vậy có thể phân biệt:
hồ sơ nào
với:
lần gửi nào của hồ sơ đó.
11. Timeout là trạng thái không xác định, không phải gửi thất bại chắc chắn
Đây là vấn đề rất quan trọng trong hệ thống giao dịch.
Giả sử bệnh viện gửi hồ sơ:
- Cổng nhận được.
- Cổng lưu dữ liệu.
- Kết nối bị đứt trước khi response quay lại.
Bệnh viện thấy:
timeout.
Nếu hệ thống lập tức đánh:
FAILED
và gửi lại, có nguy cơ gửi trùng.
Trạng thái đúng hơn là:
UNKNOWN / DELIVERY_UNCONFIRMED
Sau đó phải:
- tra cứu transaction;
- kiểm tra acknowledgement;
- hoặc dùng cơ chế idempotency nếu có.
Nguyên tắc:
Không có phản hồi không đồng nghĩa với không được tiếp nhận.
12. Cần chống gửi trùng
Nếu người dùng thấy hồ sơ chưa có phản hồi và bấm gửi liên tục, có thể tạo:
- nhiều transaction;
- nhiều phiên bản;
- khó xác định bản nào là bản chính.
Hệ thống nên có cơ chế:
- khóa tạm khi đang gửi;
- idempotency key;
- hash package;
- phát hiện cùng version đã gửi;
- yêu cầu lý do nếu gửi lại.
Ví dụ:
cùng
episode_id + version + hash
đã có một transaction RECEIVED thì không nên gửi lại vô điều kiện.
13. Điều chỉnh phải chuyển sang một version mới
Thông tư 12 quy định khi nhận phản hồi về lỗi cấu trúc/định dạng hoặc sai lệch số liệu và phát hiện sai sót, cơ sở gửi dữ liệu điều chỉnh trong thời hạn 02 ngày làm việc, kèm văn bản ghi rõ nội dung sửa chữa, điều chỉnh.
Do đó khi hồ sơ cần sửa:
không cập nhật âm thầm version đã gửi.
Workflow nên là:
V1 SENT
→ V1 RECEIVED
→ V1 RESPONSE_ERROR
→ V1 CLOSED_AS_SUPERSEDED
→ V2 CREATED
→ V2 REVIEWED
→ V2 SIGNED
→ V2 SENT.
Version V1 vẫn phải được giữ lại.
14. “Đã gửi lại” cũng chưa phải “đã xử lý xong”
Sau khi tạo V2 và gửi lại, trạng thái phải quay về:
đang chờ xác nhận/đang chờ phản hồi
chứ không phải:
COMPLETED.
Chỉ khi chu kỳ mới hoàn tất mới được đóng workflow.
Điều này tránh tình trạng dashboard báo:
“100% lỗi đã xử lý”
trong khi thực tế chỉ mới gửi lại và chưa biết kết quả.
15. Khi nào có thể coi hồ sơ hoàn tất?
Không có một trạng thái “hoàn tất” duy nhất cho mọi mục đích.
Có thể cần phân biệt:
TRANSMISSION_COMPLETED
Cổng đã xác nhận nhận dữ liệu.
RESPONSE_COMPLETED
Đã nhận đầy đủ loại phản hồi đang theo dõi.
CORRECTION_COMPLETED
Các lỗi cần điều chỉnh đã được xử lý và gửi lại.
AUDIT_COMPLETED
Đã có kết quả giám định theo quy trình.
WORKFLOW_CLOSED
Không còn tác vụ nội bộ đang mở.
Như vậy “đóng hồ sơ” là quyết định workflow, không phải chỉ một response code.
16. Trạng thái gợi ý cho Dr5-XML
Một state machine thực dụng có thể gồm:
DRAFT
→GENERATED
→PRECHECK_FAILED/PRECHECK_PASSED
→SIGNED
→READY_TO_SEND
→SENDING
→SENT
→DELIVERY_UNCONFIRMEDhoặcRECEIVED
→WAITING_RESPONSE
→RESPONSE_RECEIVED
→ACTION_REQUIREDhoặcNO_ACTION_REQUIRED
→CORRECTED
→RESENT
→CLOSED
Không cần buộc mọi bệnh viện phải dùng đúng tên trên.
Điều quan trọng là nghĩa của từng trạng thái phải rõ và không chồng lấn.
17. Cần tách trạng thái giao vận khỏi trạng thái nghiệp vụ
Một mô hình tốt nên có ít nhất hai trục:
Trạng thái giao vận
- chưa gửi;
- đang gửi;
- đã gửi;
- chưa xác nhận;
- đã tiếp nhận.
Trạng thái nghiệp vụ
- chưa kiểm tra;
- có cảnh báo;
- có lỗi cần sửa;
- bị từ chối;
- đã xử lý;
- đang chờ kết quả.
Ví dụ một hồ sơ có thể đồng thời là:
transport = RECEIVED
và:
business = ACTION_REQUIRED.
Nếu chỉ dùng một cột status, thông tin này rất dễ bị mất.
18. Cần có SLA riêng cho mỗi trạng thái chờ
Trạng thái “chờ” không nên tồn tại vô thời hạn.
Ví dụ:
- đang chờ Cổng xác nhận;
- đang chờ phản hồi 24 giờ;
- đang chờ phản hồi 48 giờ;
- đang chờ khoa sửa;
- đang chờ ký lại.
Mỗi loại cần:
waiting_since;due_at;responsible_party;- escalation.
Nhờ vậy dashboard có thể phân biệt:
đang chờ bình thường
và:
đang chờ quá hạn.
19. Dashboard quản trị nên trả lời được năm câu hỏi
Một dashboard tốt cần trả lời ngay:
- Bao nhiêu hồ sơ đã kết xuất nhưng chưa gửi?
- Bao nhiêu hồ sơ đã gửi nhưng chưa xác nhận tiếp nhận?
- Bao nhiêu hồ sơ đã tiếp nhận nhưng đang chờ phản hồi?
- Bao nhiêu hồ sơ có phản hồi cần xử lý?
- Bao nhiêu hồ sơ đã điều chỉnh nhưng chưa hoàn tất vòng gửi lại?
Nếu không trả lời được năm câu hỏi này, rất dễ xuất hiện hồ sơ “rơi” giữa các bước.
20. Phân loại lỗi theo nơi cần xử lý
Khi nhận phản hồi, Dr5-XML nên routing tự động.
Ví dụ:
| Loại vấn đề | Nơi xử lý chính |
|---|---|
| sai cấu trúc XML | CNTT |
| mã danh mục | BHYT/master data |
| thuốc | Dược |
| vật tư | Vật tư |
| người thực hiện | Tổ chức cán bộ/BHYT/chuyên môn |
| chẩn đoán | khoa điều trị |
| thời gian y lệnh | chuyên môn/HIS |
| giá/thành tiền | viện phí |
| máy | thiết bị y tế/CNTT |
| sai lệch tổng hợp | viện phí/BHYT |
Như vậy ACTION_REQUIRED phải dẫn đến một task cụ thể, không chỉ hiển thị lỗi.
21. Audit trail tối thiểu
Mỗi lần thay đổi trạng thái nên lưu:
- trạng thái trước;
- trạng thái sau;
- thời điểm;
- người hoặc hệ thống thực hiện;
- version;
- transaction ID;
- lý do;
- phản hồi liên quan.
Ví dụ:
2026-10-25 14:03 V3 SENT2026-10-25 14:03 V3 RECEIVED2026-10-25 15:20 V3 RESPONSE_RECEIVED2026-10-25 15:21 V3 ACTION_REQUIRED2026-10-25 16:05 V4 CREATED
Đây là cơ sở để giải trình sau này.
22. Một số rule quản trị có giá trị cao
| Tình huống | Cảnh báo |
|---|---|
hồ sơ GENERATED quá lâu chưa gửi | cảnh báo deadline |
SENT nhưng quá ngưỡng chưa có receipt | kiểm tra giao dịch |
| cùng version gửi nhiều lần | cảnh báo duplicate |
RECEIVED nhưng hệ thống vẫn tự động retry | ERROR_TECH |
| có phản hồi lỗi nhưng chưa tạo task xử lý | cảnh báo workflow |
| task đã đóng nhưng chưa có version điều chỉnh | WARN_REVIEW |
| version mới đã gửi nhưng bản cũ bị xóa | ERROR_TECH |
hồ sơ ghi CLOSED trong khi còn lỗi mở | ERROR_TECH |
| phản hồi không gắn được với submission | ERROR_TECH |
| transaction không có timestamp Cổng | INFO_EVIDENCE |
Kết luận
Quản lý trạng thái gửi nhận XML không thể chỉ có hai giá trị:
chưa gửi / đã gửi.
Chuỗi tối thiểu phải nhận biết:
đã kết xuất
→ đã kiểm tra
→ đã ký/xác thực
→ đã gửi
→ Cổng đã tiếp nhận
→ đang chờ phản hồi
→ đã có phản hồi
→ cần xử lý hoặc không cần xử lý
→ điều chỉnh/gửi lại nếu cần
→ hoàn tất.
Năm nguyên tắc cần nhớ:
“Đã kết xuất” không đồng nghĩa “đã gửi”.
“Đã gửi” không đồng nghĩa “Cổng đã tiếp nhận”.
“Đã tiếp nhận” không đồng nghĩa “đã được chấp nhận thanh toán”.
“Có phản hồi” không đồng nghĩa “đã xử lý phản hồi”.
Mỗi lần gửi và mỗi lần điều chỉnh phải có version, transaction và audit trail riêng.
Đối với Dr5-XML, quản lý trạng thái tốt sẽ biến hệ thống từ một công cụ kiểm tra file thành một workflow engine cho vòng đời hồ sơ BHYT: biết hồ sơ đang ở đâu, đang chờ ai, còn bao lâu tới hạn, phản hồi nào chưa xử lý và version nào hiện là version có hiệu lực trong quy trình.
- Đăng nhập để gửi ý kiến