Trong hệ thống dữ liệu khám chữa bệnh BHYT, từ “danh mục” thường được sử dụng cho nhiều loại dữ liệu khác nhau. Nếu không phân biệt rõ, rất dễ xảy ra một trong hai sai lầm:

• lấy danh mục nội bộ của bệnh viện làm chuẩn pháp lý;
• hoặc lấy danh mục đã có trên Cổng tiếp nhận làm bằng chứng rằng mọi thông tin trong đó đương nhiên đúng và đủ điều kiện thanh toán.

Thực tế cần phân biệt ít nhất bốn lớp danh mục:

1. Danh mục dùng chung do cơ quan có thẩm quyền ban hành;
2. Danh mục bệnh viện dùng trong vận hành HIS và các hệ thống chuyên môn;
3. Danh mục sử dụng trong liên thông dữ liệu trên Cổng tiếp nhận của từng cơ sở KBCB;
4. Danh mục kiểm tra nội bộ do cơ sở hoặc hệ thống tiền giám định xây dựng để phát hiện sai sót và nguy cơ xuất toán.

Bốn lớp này có quan hệ chặt chẽ nhưng không đồng nhất.

1. Danh mục dùng chung — lớp chuẩn hóa mã

Danh mục dùng chung là lớp chuẩn dùng để mã hóa và trao đổi dữ liệu giữa các cơ sở KBCB, cơ quan BHXH và các hệ thống liên quan.

Thông tư 12/2026/TT-BTC quy định danh mục sử dụng trong liên thông tại cơ sở KBCB phải được mã hóa theo các quy định về Bộ mã danh mục dùng chung của Bộ Y tế và phải tuân thủ chuẩn, định dạng tại Phụ lục II của Thông tư. Điều 7 dẫn chiếu chuỗi Quyết định 7603/QĐ-BYT và các văn bản sửa đổi, bổ sung tiếp theo.

Danh mục dùng chung trả lời những câu hỏi như:

• mã khoa chuẩn là gì;
• mã loại hình KCB là gì;
• mã dịch vụ nào được sử dụng;
• mã nhóm chi phí nào tương ứng;
• mã thuốc, vật tư hoặc cơ sở KCB được chuẩn hóa ra sao.

Một ví dụ hiện hành quan trọng là Quyết định 1804/QĐ-BYT ngày 19/6/2026, ban hành riêng Danh mục mã loại hình KCB và Danh mục mã khoa, dùng làm tài liệu chuyên môn kỹ thuật phục vụ mã hóa và trích chuyển dữ liệu điện tử KCB BHYT. Quyết định có hiệu lực từ ngày ký và yêu cầu thực hiện chậm nhất từ ngày 01/8/2026.

Điểm cần nhớ:

Danh mục dùng chung xác định chuẩn mã hóa, nhưng không mô tả toàn bộ những gì một bệnh viện thực tế đang có hoặc được phép sử dụng.

Một bệnh viện không phải cứ thấy một mã tồn tại trong danh mục dùng chung là có quyền sử dụng mã đó cho mọi hồ sơ.

2. Danh mục bệnh viện — lớp vận hành thực tế tại cơ sở KBCB

Danh mục bệnh viện là dữ liệu do cơ sở KBCB quản lý trong HIS, LIS, RIS/PACS, phần mềm dược, vật tư, nhân sự và các hệ thống khác.

Ví dụ:

• danh mục khoa/phòng nội bộ;
• danh mục bàn khám;
• danh mục thuốc bệnh viện;
• danh mục vật tư;
• danh mục DVKT;
• danh mục máy;
• danh sách người hành nghề;
• danh mục giường;
• mã dịch vụ tài chính nội bộ.

Các mã này được thiết kế để phục vụ vận hành và có thể khác hoàn toàn mã chuẩn bên ngoài.

Ví dụ bệnh viện có thể dùng:

KHOA_NOI_TIM = NTIM

trong HIS, nhưng mã gửi XML phải là mã tương ứng theo danh mục do Bộ Y tế quy định.

Quan hệ đúng phải là:

Mã nội bộ bệnh viện → ánh xạ → mã chuẩn dùng trong liên thông.

Không nên yêu cầu tất cả hệ thống nội bộ phải đổi trực tiếp sang mã của Bộ Y tế nếu việc đó gây ảnh hưởng vận hành. Điều cần thiết là duy trì lớp mapping chính xác, có hiệu lực theo thời gian.

Danh mục bệnh viện còn phản ánh những yếu tố mà danh mục dùng chung không thể hiện đầy đủ, ví dụ:

• bệnh viện thực tế có khoa nào;
• khoa hoạt động từ ngày nào;
• dịch vụ nào được phê duyệt thực hiện tại cơ sở;
• thiết bị nào đang có;
• người hành nghề nào làm việc tại đâu;
• thuốc hoặc vật tư nào đã được mua sắm;
• giá và thời gian áp dụng cụ thể.

Do đó:

Danh mục dùng chung trả lời “mã chuẩn là gì”; danh mục bệnh viện trả lời “cơ sở này thực tế có gì và sử dụng gì”.

3. Danh mục trên Cổng tiếp nhận — danh mục liên thông của từng cơ sở

Thông tư 12/2026/TT-BTC sử dụng khái niệm “danh mục sử dụng trong liên thông dữ liệu khám bệnh, chữa bệnh BHYT áp dụng tại cơ sở KBCB”.

Đây là lớp rất quan trọng và không nên đánh đồng với toàn bộ danh mục dùng chung.

Theo Điều 7, sau khi ký hợp đồng lần đầu, cơ sở KBCB phải lập danh mục này, ký số xác thực và gửi cơ quan BHXH qua Cổng tiếp nhận, bảo đảm khớp đúng với hồ sơ ký hợp đồng.

Có thể hiểu:

Danh mục dùng chung = tập mã chuẩn có thể dùng trong hệ thống.

Trong khi:

Danh mục trên Cổng của bệnh viện = tập các nội dung bệnh viện này khai báo đang sử dụng để liên thông và đề nghị thanh toán trong phạm vi của mình.

Đây là sự khác biệt rất lớn.

Ví dụ, Bộ Y tế có thể có hàng nghìn mã DVKT trong danh mục dùng chung. Nhưng một bệnh viện tuyến huyện chỉ thực hiện một phần trong số đó. Danh mục trên Cổng phải phản ánh đúng phạm vi thực tế và hồ sơ pháp lý của bệnh viện.

Phụ lục II Thông tư 12 quy định sáu nhóm danh mục phục vụ liên thông, gồm các mẫu về:

• bộ phận chuyên môn KCB BHYT;
• nhân lực thực hiện KCB BHYT;
• thuốc, máu, chế phẩm máu;
• thiết bị y tế áp dụng trong thanh toán;
• dịch vụ KCB;
• thiết bị y tế để thực hiện DVKT.

Ví dụ Mẫu 01/DM quy định trường MA_KHOA phải dùng mã khám bệnh hoặc mã khoa theo danh mục dùng chung của Bộ Y tế, đồng thời có các trường phản ánh cơ cấu thực tế của bệnh viện như tên khoa, số bàn khám và số giường được phê duyệt.

Như vậy danh mục trên Cổng là giao điểm giữa chuẩn quốc gia và thực tế được khai báo của từng cơ sở.

4. Danh mục trên Cổng không phải “chân lý tuyệt đối”

Một lỗi suy luận nguy hiểm là:

“Mã đã có trên Cổng thì chắc chắn đúng.”

Thông tư 12 không cho phép hiểu như vậy.

Điều 8 quy định cơ sở KBCB phải gửi đề nghị cập nhật, điều chỉnh danh mục khi có thay đổi, kèm văn bản và tài liệu chứng minh. Cơ quan BHXH xem xét và phản hồi trong thời hạn quy định.

Đặc biệt, khoản 5 Điều 8 quy định nếu phát hiện danh mục trên Cổng có nội dung sai lệch so với danh mục dùng chung hoặc không đúng với văn bản được cấp có thẩm quyền phê duyệt, hai bên phải phối hợp điều chỉnh hoặc hủy áp dụng thông tin đó.

Điều này chứng minh rõ:

Sự hiện diện của một mã trên Cổng không làm mất yêu cầu đối chiếu với danh mục chuẩn và hồ sơ pháp lý.

Vì vậy khi tiền giám định cần kiểm tra ít nhất ba lớp:

mã XML → danh mục trên Cổng → danh mục dùng chung/hồ sơ pháp lý.

5. Danh mục kiểm tra nội bộ — lớp kiểm soát của bệnh viện/Dr5-XML

Danh mục kiểm tra nội bộ là lớp thứ tư và có bản chất hoàn toàn khác.

Đây không phải danh mục do Bộ Y tế hay BHXH ban hành để trực tiếp sử dụng làm mã XML.

Nó là dữ liệu do cơ sở KBCB hoặc hệ thống tiền giám định xây dựng nhằm trả lời những câu hỏi như:

• dịch vụ này có được thực hiện tại khoa này không;
• người hành nghề này có được phép chỉ định hoặc thực hiện dịch vụ không;
• máy này có phù hợp với DVKT không;
• thuốc này có nằm trong cấu hình được phép tại thời điểm điều trị không;
• mã nào đã hết hiệu lực;
• hồ sơ nào sử dụng mã nội bộ chưa được ánh xạ;
• trường hợp nào cần cảnh báo trước khi ký hoặc gửi XML.

Ví dụ, bệnh viện có thể xây dựng danh mục kiểm tra:

MA_DICH_VU X chỉ được thực hiện tại các khoa A, B, C.

Danh mục này có thể dựa trên:

• phạm vi chuyên môn được phê duyệt;
• cấu hình tổ chức của bệnh viện;
• danh mục dịch vụ trên Cổng;
• hướng dẫn chuyên môn;
• quy trình nội bộ.

Nhưng bản thân nó không phải một danh mục pháp lý mới.

Do đó:

Danh mục kiểm tra nội bộ là lớp suy diễn và kiểm soát, không được dùng để thay thế nguồn pháp lý gốc.

6. So sánh bốn loại danh mục

Mối quan hệ nên được hiểu như sau:

Danh mục dùng chung
↓ chuẩn hóa
Danh mục bệnh viện
↓ ánh xạ + hồ sơ pháp lý
Danh mục sử dụng trên Cổng
↓ đối chiếu
XML thực tế

Song song với toàn bộ chuỗi đó:

Danh mục kiểm tra nội bộ theo dõi và cảnh báo sai lệch.

7. Ví dụ: một dịch vụ kỹ thuật

Giả sử bệnh viện có dịch vụ nội bộ:

DV001 – Siêu âm tim

Để gửi XML3, không thể chỉ gửi DV001.

Cần lần lượt xác định:

Bước 1 — Danh mục dùng chung

Tìm mã DVKT chuẩn tương ứng.

Bước 2 — Danh mục bệnh viện

Xác định:

• dịch vụ nội bộ nào ánh xạ với mã đó;
• giá;
• khoa thực hiện;
• thời gian bắt đầu sử dụng;
• điều kiện cấu hình tại bệnh viện.

Bước 3 — Danh mục trên Cổng

Kiểm tra dịch vụ đã được khai báo trong danh mục sử dụng của cơ sở, có thời điểm áp dụng phù hợp và đủ hồ sơ chứng minh hay chưa.

Điều 7 Thông tư 12 quy định thời điểm áp dụng danh mục phải gắn với hồ sơ, hợp đồng và các tài liệu liên quan; riêng thuốc và thiết bị có thêm yêu cầu về thời điểm mua sắm.

Bước 4 — Danh mục kiểm tra nội bộ

Dr5-XML có thể tiếp tục hỏi:

• mã dịch vụ có phù hợp khoa không;
• người chỉ định có hợp lệ không;
• người thực hiện có phù hợp không;
• máy có hợp lệ không;
• ngày thực hiện có nằm trong thời gian danh mục được áp dụng không.

Như vậy một mã dịch vụ “có tồn tại” mới chỉ vượt qua một phần rất nhỏ của kiểm tra.

8. Hiệu lực theo thời gian là thuộc tính bắt buộc của danh mục

Một danh mục không nên chỉ lưu:

code → name

mà tối thiểu phải lưu theo mô hình:

code → nội dung → nguồn → valid_from → valid_to → trạng thái.

Thông tư 12 quy định khá rõ việc cập nhật, điều chỉnh và thời điểm áp dụng danh mục. Khi đủ điều kiện và hồ sơ, cơ quan BHXH áp dụng danh mục từ ngày nhận văn bản thông báo hoặc từ ngày cơ sở đề nghị nếu ngày đề nghị muộn hơn; đối với một số thuốc, thiết bị y tế cấp cứu có quy định thời điểm riêng theo ngày hóa đơn.

Do đó không nên hỏi:

“Dịch vụ này hiện có trên Cổng không?”

mà phải hỏi:

“Dịch vụ này đã được áp dụng trên Cổng tại ngày thực hiện dịch vụ hay chưa?”

Đây là khác biệt giữa membership check và effective-period check.

9. Ý nghĩa đối với giám định và nguy cơ xuất toán

Thông tư 12 quy định hệ thống giám định tự động rà soát, trong số các nội dung khác:

• phạm vi thanh toán thuốc, thiết bị y tế và dịch vụ theo danh mục sử dụng tại cơ sở;
• mức thanh toán;
• tỷ lệ và điều kiện thanh toán;
• phạm vi hoạt động chuyên môn của cơ sở;
• phạm vi hành nghề của người hành nghề;
• số lượng thuốc, thiết bị y tế theo mua sắm.

Vì vậy sai danh mục có thể xuất hiện ở nhiều cấp:

Cấp 1 — sai mã:
mã không tồn tại.

Cấp 2 — sai ánh xạ:
mã nội bộ ánh xạ nhầm mã chuẩn.

Cấp 3 — sai hiệu lực:
mã đúng nhưng chưa hoặc không còn được áp dụng.

Cấp 4 — sai phạm vi cơ sở:
mã tồn tại nhưng bệnh viện chưa khai báo/không có căn cứ sử dụng.

Cấp 5 — sai quan hệ:
dịch vụ có trong danh mục nhưng khoa, người hành nghề, máy hoặc điều kiện chuyên môn không phù hợp.

Chỉ kiểm tra cấp 1 là chưa đủ.

10. Cách triển khai trong Dr5-XML

Trong Dr5-XML không nên tạo bảng riêng như dr5_service, dr5_staff, dr5_equipment cho từng loại danh mục.

Kiến trúc generic tiếp tục sử dụng sáu danh mục chuẩn.

dr5_catalog_binding

Đây là thành phần trung tâm của Loạt 2.

Nó cần mô tả quan hệ giữa:

field XML → hệ danh mục → mã chuẩn → mã nội bộ → nguồn → phiên bản → khoảng hiệu lực.

dr5_xml_relation

Dùng để kiểm tra các quan hệ như:

• dịch vụ ↔ khoa;
• dịch vụ ↔ người hành nghề;
• dịch vụ ↔ máy;
• thuốc ↔ dịch vụ;
• giường ↔ khoa.

dr5_legal_basis

Lưu căn cứ của từng phiên bản danh mục.

dr5_payment_condition

Chỉ ghi những điều kiện thực sự quyết định phạm vi hoặc mức thanh toán.

Như vậy khi danh mục Bộ Y tế hoặc danh mục trên Cổng thay đổi, mục tiêu là:

cập nhật catalog và hiệu lực, không sửa engine.

Kết luận

Bốn lớp danh mục có thể tóm tắt bằng bốn câu hỏi:

Danh mục dùng chung: “Mã chuẩn của quốc gia là gì?”

Danh mục bệnh viện: “Bệnh viện thực tế đang quản lý và sử dụng gì?”

Danh mục trên Cổng: “Bệnh viện đã khai báo và được áp dụng nội dung gì trong liên thông BHYT tại thời điểm đó?”

Danh mục kiểm tra nội bộ: “Hệ thống cần kiểm tra thêm điều gì để ngăn sai sót trước khi gửi dữ liệu?”

Sai lầm cần tránh nhất là coi bốn lớp này như một.

Một hồ sơ tốt cần thỏa đồng thời:

Mã XML đúng → ánh xạ đúng danh mục dùng chung → phù hợp danh mục thực tế của bệnh viện → đã được áp dụng đúng trên Cổng tại thời điểm phát sinh → vượt qua các kiểm tra nội bộ về quan hệ và điều kiện.

Đó sẽ là mô hình nền cho toàn bộ các bài tiếp theo của Chương 2, đặc biệt từ Bài 2.5 đến 2.10 khi đi trực tiếp vào sáu mẫu danh mục của Phụ lục II Thông tư 12/2026/TT-BTC.