Trong HIS, phần mềm dược, kho vật tư và hệ thống viện phí, bệnh viện thường sử dụng các mã nội bộ do chính cơ sở xây dựng. Một thuốc có thể mang mã TH000123, một dịch vụ có mã DV001245, một vật tư có mã VT00987. Những mã này hoàn toàn phù hợp cho quản trị nội bộ nhưng không mặc nhiên là mã được phép gửi trong dữ liệu XML BHYT.
Khi tạo dữ liệu liên thông, hệ thống phải chuyển từ:
danh mục nội bộ của bệnh viện → danh mục chuẩn/danh mục dùng chung → danh mục sử dụng của cơ sở trên Cổng → dữ liệu XML thực tế.
Đây không đơn giản là bài toán “đổi một mã thành một mã khác”.
Một ánh xạ đúng phải bảo đảm đồng thời:
đúng đối tượng + đúng mã + đúng thuộc tính + đúng thời điểm + đúng hồ sơ mua sắm/phê duyệt + đúng ngữ cảnh sử dụng.
Điều này đặc biệt quan trọng với bốn nhóm có tỷ trọng chi phí lớn: thuốc, máu/chế phẩm máu, dịch vụ KCB và vật tư/thiết bị y tế.
1. Mã nội bộ và mã chuẩn phục vụ hai mục đích khác nhau
Danh mục nội bộ của bệnh viện thường được thiết kế theo nhu cầu vận hành.
Ví dụ một thuốc có thể được tạo thành nhiều mã nội bộ theo:
- nhà cung cấp;
- lô;
- giá nhập;
- kho;
- nguồn kinh phí;
- hình thức mua sắm;
- đơn vị đóng gói.
Trong khi mã XML cần phản ánh thuốc theo quy tắc chuẩn do Bộ Y tế quy định.
Tương tự, một DVKT nội bộ có thể được tách thành nhiều dòng vì:
- khoa thực hiện khác nhau;
- mức giá khác nhau;
- gây tê/không gây tê;
- vị trí thực hiện khác nhau;
- thực hiện tại cơ sở khác.
Do đó:
Không tồn tại nguyên tắc bắt buộc “1 mã nội bộ = 1 mã chuẩn” trong mọi trường hợp.
Có thể xảy ra:
- nhiều mã nội bộ → một mã chuẩn;
- một mã nội bộ → nhiều bản ghi mapping theo thời gian;
- một mã chuẩn → nhiều cấu hình bệnh viện khác nhau.
Mapping phải là một quan hệ có điều kiện, không phải một cột mã thay thế đơn giản.
2. Thuốc không được ánh xạ chỉ bằng tên thuốc
Trong XML2, trường trung tâm là MA_THUOC, nhưng nhận diện thuốc còn liên quan đến:
TEN_THUOC;HAM_LUONG;DUONG_DUNG;DANG_BAO_CHE;SO_DANG_KY;DON_VI_TINH;TT_THAU;- và các thông tin mua sắm, nguồn thuốc khác.
Mẫu 03/DM của Phụ lục II Thông tư 12/2026/TT-BTC cũng quản lý đồng thời MA_THUOC, tên hoạt chất, tên thuốc, hàm lượng, đường dùng, mã đường dùng, dạng bào chế, số đăng ký, đơn vị tính, nhà sản xuất, thông tin thầu và thời gian hiệu lực.
Vì vậy không nên ánh xạ:
“Paracetamol” → một
MA_THUOC
chỉ dựa vào tên.
Cần nhận diện tối thiểu theo một bộ thuộc tính nhất quán.
Ví dụ hai thuốc cùng tên thương mại nhưng:
- khác hàm lượng;
- khác dạng bào chế;
- khác đường dùng;
- khác số đăng ký;
không nên bị gộp thành một mapping nếu danh mục chuẩn phân biệt chúng.
Ngược lại, khác mã kho nội bộ nhưng thực chất cùng thuốc chuẩn có thể ánh xạ về cùng mã nếu các thuộc tính nghiệp vụ tương ứng.
3. MA_THUOC không phải khóa duy nhất của mọi thông tin thanh toán
Một sai lầm khác là coi MA_THUOC như khóa duy nhất để xác định toàn bộ điều kiện thanh toán.
Trong thực tế, việc đề nghị thanh toán còn phụ thuộc:
- giá;
- kết quả mua sắm;
- thời gian hiệu lực hợp đồng;
- loại thầu;
- nhà cung cấp;
- phạm vi BHYT;
- tỷ lệ thanh toán;
- số lượng thực tế.
Mẫu 03/DM ghi riêng:
SO_LUONG;DON_GIA;DON_GIA_BH;TT_THAU;TU_NGAY_HD;DEN_NGAY_HD;LOAI_THAU;HT_THAU;TU_NGAY;DEN_NGAY.
Do đó:
Mã thuốc đúng không đồng nghĩa dòng thuốc được thanh toán đúng.
Cần kiểm tra thêm:
thuốc chuẩn + hợp đồng/mua sắm + thời điểm + giá + phạm vi + hồ sơ sử dụng.
4. Máu và chế phẩm máu dùng chung cấu trúc nhưng có thuộc tính riêng
Mẫu 03/DM quản lý chung:
thuốc, máu và chế phẩm máu
nhưng không phải mọi field áp dụng giống nhau.
Ví dụ:
TEN_HOAT_CHAT: không ghi với máu/chế phẩm máu;DANG_BAO_CHE: không áp dụng cho máu/chế phẩm máu;HAM_LUONG: với máu/chế phẩm máu được diễn giải theo thể tích thực;LOAI_THUOC = 9: máu;LOAI_THUOC = 10: chế phẩm máu.
Như vậy không nên dùng chung một bộ rule requiredness của thuốc hóa dược cho máu.
Một record máu hợp lệ có thể không có hoạt chất hoặc dạng bào chế, nhưng điều này không phải lỗi.
Đây là ví dụ điển hình của nguyên tắc:
Cùng một bảng danh mục không đồng nghĩa mọi loại đối tượng có cùng bộ trường bắt buộc.
5. Dịch vụ kỹ thuật phải ánh xạ cả mã và căn cứ thực hiện
Đối với XML3, trường chính là:
MA_DICH_VU.
Nhưng Mẫu 05/DM cho thấy danh mục dịch vụ KCB không chỉ có mã và tên.
Nó còn chứa:
- tên dịch vụ;
- tên dịch vụ theo văn bản giá;
- đơn giá;
- quy trình chuyên môn;
- quyết định phê duyệt danh mục kỹ thuật;
- quyết định/nghị quyết phê duyệt giá;
- thông tin chuyển giao kỹ thuật;
- cơ sở thực hiện CLS nếu chuyển gửi;
- các thông tin thuốc phóng xạ/chất đánh dấu khi có.
Điều đó có nghĩa:
Mapping dịch vụ không chỉ là
DV_NOIBO → MA_DICH_VU.
Cần xác định thêm:
dịch vụ nội bộ → dịch vụ chuẩn → quyết định phê duyệt kỹ thuật → giá → khoa → thời gian áp dụng.
Nếu cùng một DVKT có nhiều biến thể giá hoặc phương pháp, việc ánh xạ phải giữ được sự khác biệt đó.
6. Tên giống nhau chưa đủ để kết luận là cùng dịch vụ
Một lỗi thường gặp khi import danh mục là dùng fuzzy matching tên.
Ví dụ:
- “Siêu âm tim”;
- “Siêu âm Doppler tim”;
- “Siêu âm tim qua thực quản”;
- “Siêu âm tim [gây tê]”.
Các tên có thể gần giống nhau nhưng không phải một DVKT.
Mẫu 05/DM còn yêu cầu trường hợp cần phân biệt vị trí, phương pháp thực hiện hoặc mức giá thì ghi mô tả chi tiết trong dấu ngoặc vuông; dịch vụ dùng phương pháp vô cảm gây tê phải bổ sung [gây tê].
Do đó:
Tên chỉ là dữ liệu hỗ trợ mapping, không nên là khóa mapping duy nhất.
Một mapping dịch vụ tốt phải ưu tiên:
- mã chuẩn;
- quyết định phê duyệt;
- nội dung kỹ thuật;
- cấu hình giá;
- thời gian hiệu lực.
7. Vật tư/thiết bị y tế cần nhận diện đến mức đủ phân biệt sản phẩm
Trong XML3, MA_VAT_TU không nên được hiểu đơn giản là “mã nhóm vật tư”.
Mẫu 04/DM của Thông tư 12 yêu cầu nhiều thuộc tính:
MA_VAT_TU;- nhóm vật tư;
- tên thương mại;
- mã hiệu;
- số lưu hành;
- tính năng kỹ thuật;
- quy cách;
- hãng sản xuất;
- nước sản xuất;
- đơn vị tính;
- đơn giá.
Điều này phản ánh bản chất của vật tư y tế:
Cùng tên chung nhưng khác kích thước, cấu hình hoặc mã hiệu có thể là những đối tượng thanh toán khác nhau.
Ví dụ:
“Vít xương”
không đủ để ánh xạ.
Có thể cần phân biệt:
- loại vít;
- đường kính;
- chiều dài;
- vật liệu;
- hãng;
- mã hiệu;
- số lưu hành;
- quy cách.
Do đó mapping VTYT phải sử dụng thuộc tính sản phẩm, không chỉ tên.
8. Vật tư dùng trong dịch vụ không đồng nghĩa được thanh toán riêng
Một vật tư có mã hợp lệ và thực tế đã sử dụng chưa có nghĩa phải tạo một dòng thanh toán riêng trong XML3.
Chuẩn dữ liệu XML3 phân biệt:
- VTYT chưa nằm trong cơ cấu giá;
- VTYT được thanh toán riêng theo quy định;
- VTYT nằm trong giá DVKT;
- các tình huống dịch vụ không thực hiện trọn vẹn hoặc chưa có giá.
Vì vậy phải tách hai câu hỏi:
Vật tư nào đã sử dụng?
và:
Vật tư nào được phép thống kê/đề nghị thanh toán riêng?
Danh mục chỉ giúp trả lời câu hỏi nhận diện và phạm vi sử dụng; điều kiện thanh toán phải được xử lý ở lớp dr5_payment_condition.
9. Mối quan hệ dịch vụ – vật tư là quan hệ nhiều chiều
Trong XML3 có đồng thời:
MA_DICH_VU;MA_VAT_TU;GOI_VTYT;MA_HIEU_SP.
Một VTYT có thể:
- đi kèm DVKT;
- nằm trong gói VTYT;
- được dùng nhiều lần;
- hoặc thanh toán riêng.
Do đó không nên viết một rule cứng:
MA_VAT_TU X luôn đi với MA_DICH_VU Y.
Đúng hơn phải là một quan hệ có điều kiện:
VTYT X + DVKT Y + phạm vi + thời điểm + cấu hình thanh toán.
Trong Dr5-XML đây là loại quan hệ phù hợp với:
SERVICE_SUPPLY_LINK
trong dr5_xml_relation.
10. Mapping phải có thời gian hiệu lực
Một mapping đúng hôm nay có thể sai trong quá khứ hoặc tương lai.
Mẫu 03/DM và Mẫu 04/DM đều có:
TU_NGAY;DEN_NGAY.
Thông tư 12 còn quy định khi một thông tin danh mục thay đổi thì gửi hai dòng:
- dòng cũ có
DEN_NGAY; - dòng mới có
TU_NGAY, để trốngDEN_NGAY.
Đây chính là mô hình versioning mà HIS và Dr5-XML nên áp dụng.
Ví dụ:
| Mã nội bộ | Mã chuẩn | Giá | Từ ngày | Đến ngày |
|---|---|---|---|---|
TH001 | A | 10.000 | 01/01/2026 | 30/6/2026 |
TH001 | A | 9.500 | 01/7/2026 | — |
Không nên sửa dòng cũ thành giá mới và làm mất lịch sử.
11. Không nên sửa trực tiếp XML khi mapping sai
Giả sử XML2 gửi sai MA_THUOC.
Cách xử lý sai:
sửa file XML trước khi gửi.
Cách xử lý đúng:
xác định mã nội bộ → sửa mapping trong danh mục nguồn → kiểm tra các thuộc tính liên quan → sinh lại XML → kiểm tra lại tổng tiền và các bảng liên quan.
Tương tự đối với DVKT và VTYT.
Nếu chỉ sửa XML:
- lần xuất sau lỗi sẽ lặp lại;
- HIS và XML không còn khớp;
- audit trail bị mất;
- có nguy cơ tạo chênh lệch với bảng kê và danh mục trên Cổng.
Nguyên tắc phải là:
Sửa tại nguồn sinh dữ liệu, không vá lớp đầu ra.
12. Chuỗi kiểm tra chuẩn cho từng loại đối tượng
Có thể chuẩn hóa việc mapping bằng bốn chuỗi.
Thuốc
Mã thuốc nội bộ
→ hoạt chất/tên/hàm lượng/dạng bào chế/đường dùng/số đăng ký
→ MA_THUOC chuẩn
→ danh mục Mẫu 03/DM của cơ sở
→ XML2.
Máu/chế phẩm máu
Mã nội bộ
→ loại máu/chế phẩm + thể tích + đơn vị + nguồn cung
→ mã chuẩn
→ Mẫu 03/DM
→ XML2.
Dịch vụ
Mã DVKT nội bộ
→ nội dung kỹ thuật + quyết định phê duyệt + giá
→ MA_DICH_VU chuẩn
→ Mẫu 05/DM
→ XML3.
VTYT
Mã vật tư nội bộ
→ nhóm + tên thương mại + mã hiệu + số lưu hành + quy cách
→ MA_VAT_TU chuẩn
→ Mẫu 04/DM
→ XML3.
Nếu một bước trong chuỗi không xác định được chắc chắn, hệ thống không nên tự động “đoán mã”.
13. Các lỗi mapping cần cảnh báo sớm
Một số tình huống có giá trị tiền kiểm cao:
| Lỗi | Phân loại ban đầu |
|---|---|
| mã nội bộ chưa có mapping | ERROR_TECH |
| mapping đến mã không còn hiệu lực | ERROR_TECH |
| cùng một mã nội bộ đồng thời map tới hai mã chuẩn trong cùng thời điểm | ERROR_TECH |
| thuốc cùng mã nhưng hàm lượng/số đăng ký không khớp | WARN_REVIEW |
| VTYT mã đúng nhưng mã hiệu/quy cách không tương thích | WARN_REVIEW |
| DVKT đúng mã nhưng chưa có trong danh mục áp dụng của cơ sở | WARN_REVIEW / INFO_EVIDENCE |
| mã trên XML khác mã trong danh mục Cổng tại ngày sử dụng | WARN_REVIEW |
| vật tư thuộc cơ cấu giá nhưng vẫn đề nghị thanh toán riêng | cần kiểm tra PAYMENT_CONDITION |
| giá/thông tin thầu ngoài khoảng hiệu lực | WARN_REVIEW / PAYMENT_CONDITION tùy căn cứ |
Một mã không tồn tại là lỗi dễ phát hiện.
Các sai lệch nguy hiểm hơn thường là:
mã tồn tại nhưng mapping sai sản phẩm, sai phiên bản hoặc sai điều kiện thanh toán.
14. Thiết kế Dr5-XML cho bài toán mapping
Không cần tạo các bảng chuyên biệt dr5_drug, dr5_service, dr5_supply.
Kiến trúc generic vẫn chỉ cần sáu danh mục chuẩn.
dr5_catalog_binding
Đây là thành phần trọng tâm:
- mã nội bộ;
- loại đối tượng;
- mã chuẩn;
- danh mục nguồn;
- phiên bản;
valid_from;valid_to;- thuộc tính dùng để xác nhận mapping.
dr5_xml_relation
Quản lý:
- thuốc ↔ dịch vụ;
- dịch vụ ↔ vật tư;
- dịch vụ ↔ khoa;
- vật tư ↔ gói;
- dịch vụ ↔ thiết bị.
dr5_payment_condition
Quản lý các điều kiện như:
- vật tư được thanh toán riêng hay nằm trong giá;
- tỷ lệ thanh toán;
- phạm vi hưởng;
- điều kiện đặc thù.
dr5_legal_basis
Lưu nguồn pháp lý của từng mapping và từng phiên bản danh mục.
Mục tiêu cuối cùng là:
Engine không cần biết từng mã cụ thể; engine chỉ cần biết cách kiểm tra catalog, version và relationship.
Kết luận
Ánh xạ danh mục nội bộ sang danh mục dùng chung không phải thao tác:
internal_code → standard_code
mà là:
đối tượng nội bộ → xác minh bộ thuộc tính → xác định mã chuẩn → kiểm tra danh mục cơ sở → kiểm tra hiệu lực → sử dụng trong XML.
Với thuốc, phải kiểm tra đồng thời danh tính thuốc và dữ liệu mua sắm.
Với máu/chế phẩm máu, phải sử dụng requiredness riêng thay vì sao chép quy tắc thuốc hóa dược.
Với DVKT, phải gắn mã với nội dung kỹ thuật, quyết định phê duyệt và giá.
Với VTYT, phải phân biệt sản phẩm đến mức mã hiệu, số lưu hành, cấu hình/quy cách khi cần.
Và quan trọng nhất:
Mã đúng không có nghĩa thanh toán đúng.
Danh mục giải quyết bài toán nhận diện và chuẩn hóa; còn việc một khoản chi có được thanh toán hay không phải tiếp tục kiểm tra phạm vi, điều kiện, giá, thời điểm và bằng chứng thực tế sử dụng.
Đây sẽ là nền tảng để đi sâu vào sáu mẫu danh mục của Phụ lục II Thông tư 12 trong các Bài 2.05–2.10.
- Đăng nhập để gửi ý kiến