Website được thiết kế tối ưu cho thành viên chính thức. Hãy Đăng nhập hoặc Đăng ký để truy cập đầy đủ nội dung và chức năng. Nội dung bạn cần không thấy trên website, có thể do bạn chưa đăng nhập. Nếu là thành viên của website, bạn cũng có thể yêu cầu trong nhóm Zalo "BHYT" các nội dung bạn quan tâm.

Bài 3.5. Quản lý trạng thái gửi nhận: đã kết xuất, đã gửi, đã tiếp nhận, có phản hồi và chờ xử lý

XML

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_idmã lần gửi
episode_idđợt KCB
xml_versionversion dữ liệu
purposemanagement/payment/correction
sent_atthời điểm gửi
received_atthời điểm Cổng xác nhận
gateway_transaction_idmã giao dịch Cổng
response_typeloại phản hồi
response_atthời điểm phản hồi
statustrạ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ơ:

  1. Cổng nhận được.
  2. Cổng lưu dữ liệu.
  3. 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_UNCONFIRMED hoặc RECEIVED
→ WAITING_RESPONSE
→ RESPONSE_RECEIVED
→ ACTION_REQUIRED hoặc NO_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:

  1. Bao nhiêu hồ sơ đã kết xuất nhưng chưa gửi?
  2. Bao nhiêu hồ sơ đã gửi nhưng chưa xác nhận tiếp nhận?
  3. Bao nhiêu hồ sơ đã tiếp nhận nhưng đang chờ phản hồi?
  4. Bao nhiêu hồ sơ có phản hồi cần xử lý?
  5. 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 XMLCNTT
mã danh mụcBHYT/master data
thuốcDược
vật tưVật tư
người thực hiệnTổ chức cán bộ/BHYT/chuyên môn
chẩn đoánkhoa điều trị
thời gian y lệnhchuyên môn/HIS
giá/thành tiềnviện phí
máythiết bị y tế/CNTT
sai lệch tổng hợpviệ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 SENT
2026-10-25 14:03 V3 RECEIVED
2026-10-25 15:20 V3 RESPONSE_RECEIVED
2026-10-25 15:21 V3 ACTION_REQUIRED
2026-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ốngCảnh báo
hồ sơ GENERATED quá lâu chưa gửicảnh báo deadline
SENT nhưng quá ngưỡng chưa có receiptkiểm tra giao dịch
cùng version gửi nhiều lầncảnh báo duplicate
RECEIVED nhưng hệ thống vẫn tự động retryERROR_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ỉnhWARN_REVIEW
version mới đã gửi nhưng bản cũ bị xóaERROR_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 submissionERROR_TECH
transaction không có timestamp CổngINFO_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.