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 4.3. Kiểm tra mã và thuộc tính danh mục: đúng mã chưa đủ, còn phải đúng thông tin và thời điểm áp dụng

XML

Một trong những cách kiểm tra XML đơn giản nhất là:

Mã này có tồn tại trong danh mục hay không?

Đây là phép kiểm tra cần thiết, nhưng chưa đủ.

Một mã có thể:

  • đúng cú pháp;
  • tồn tại trong danh mục dùng chung;
  • thậm chí đang tồn tại trong danh mục hiện tại của bệnh viện;

nhưng vẫn có thể sai trong hồ sơ cụ thể vì:

  • không đúng sản phẩm hoặc đối tượng thực tế;
  • các thuộc tính đi kèm không khớp;
  • không thuộc danh mục sử dụng của chính cơ sở KCB;
  • chưa có hiệu lực tại ngày phát sinh;
  • đã hết hiệu lực;
  • đúng mã nhưng sai giá, đơn vị tính, thông tin thầu hoặc quyết định áp dụng;
  • đúng đối tượng nhưng sử dụng sai ngữ cảnh.

Thông tư 12/2026/TT-BTC quy định danh mục sử dụng trong liên thông dữ liệu của cơ sở phải được mã hóa theo danh mục dùng chung và theo chuẩn, định dạng của Phụ lục II; Điều 10 đồng thời đưa phạm vi thanh toán đối với thuốc, thiết bị y tế, dịch vụ KCB theo danh mục sử dụng tại cơ sở KCB vào nội dung giám định tự động.

Vì vậy nguyên tắc trung tâm của Bài 4.3 là:

Đúng mã chưa đủ; phải đúng đối tượng, đúng thuộc tính, đúng danh mục của cơ sở, đúng phiên bản và đúng thời điểm áp dụng.


1. Kiểm tra danh mục không chỉ là phép code exists

Phép kiểm tra cơ bản nhất là:

code ∈ catalog

Ví dụ:

  • MA_THUOC có tồn tại;
  • MA_DICH_VU có tồn tại;
  • MA_VAT_TU có tồn tại;
  • MA_KHOA có tồn tại;
  • MA_MAY có được khai báo.

Nếu mã không tồn tại trong danh mục áp dụng thì đây là một vấn đề rõ ràng.

Nhưng nếu mã tồn tại, chưa thể kết luận:

“dữ liệu đúng”.

Phải tiếp tục kiểm tra:

mã đó đang đại diện cho cái gì?


2. Một mã phải đi cùng một tập thuộc tính nhất quán

Đối với thuốc, không nên coi MA_THUOC là toàn bộ định danh nghiệp vụ.

Một dòng thuốc còn liên quan đến:

  • tên thuốc;
  • hoạt chất;
  • hàm lượng;
  • đường dùng;
  • dạng bào chế;
  • số đăng ký;
  • đơn vị tính;
  • thông tin thầu;
  • đơn giá;
  • loại thuốc.

Mẫu 03/DM của Thông tư 12 còn quản lý các thuộc tính về hợp đồng cung ứng, loại thầu, hình thức thầu, dịch vụ kỹ thuật liên quan đối với thuốc phóng xạ/chất đánh dấu và các thông tin chuyên biệt khác.

Do đó tình huống:

MA_THUOC đúng nhưng SO_DANG_KY của một thuốc khác

không thể được coi là hợp lệ chỉ vì mã thuốc có trong danh mục.

Đây là kiểm tra:

ATTRIBUTE_CONSISTENCY.


3. Cần kiểm tra một “tuple nhận dạng”, không chỉ một field

Có thể hình dung một thuốc bằng tuple:

MA_THUOC + TEN_THUOC + HAM_LUONG + DUONG_DUNG + DANG_BAO_CHE + SO_DANG_KY + DON_VI_TINH

Không nhất thiết tất cả field đều tạo thành một khóa kỹ thuật chính thức.

Nhưng về kiểm tra dữ liệu, chúng phải tạo thành một bộ thuộc tính hợp lý và nhất quán.

Tương tự với thiết bị y tế thanh toán:

MA_VAT_TU + TEN_VAT_TU + MA_HIEU + SO_LUU_HANH + QUY_CACH + DON_VI_TINH

Mẫu 04/DM quy định không chỉ mã VTYT mà còn 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 và các thuộc tính giá/thanh toán.

Nếu mã đúng nhưng model hoặc sản phẩm thực tế khác, cần tiếp tục rà soát.


4. “Đúng mã quốc gia” chưa đủ nếu cơ sở không có mã đó trong danh mục sử dụng

Chương 2 đã phân biệt:

  • danh mục dùng chung;
  • danh mục bệnh viện;
  • danh mục sử dụng trong liên thông của cơ sở;
  • danh mục kiểm tra nội bộ.

Một dịch vụ có thể tồn tại hợp pháp trong danh mục dùng chung trên toàn quốc nhưng bệnh viện cụ thể:

  • chưa được phê duyệt thực hiện;
  • chưa khai báo trong danh mục sử dụng;
  • hoặc chưa đến thời điểm áp dụng.

Mẫu 05/DM vì vậy không chỉ chứa MA_DICH_VU mà còn có:

  • tên dịch vụ;
  • tên dịch vụ theo quyết định giá;
  • đơn giá;
  • quy trình;
  • quyết định phê duyệt DVKT;
  • quyết định phê duyệt giá;
  • thông tin chuyển giao kỹ thuật;
  • thông tin chuyển CLS;
  • thời gian áp dụng.

Điều 10 Thông tư 12 cũng kiểm tra phạm vi thanh toán theo danh mục sử dụng tại cơ sở KCB, không chỉ dựa vào việc mã tồn tại trong danh mục dùng chung.


5. Mã đúng nhưng sai thuộc tính giá vẫn là bất nhất

Ví dụ Mẫu 04/DM chứa cả:

  • DON_GIA;
  • DON_GIA_BH;
  • TYLE_TT_BH.

Trong đó DON_GIA phản ánh giá mua sắm tương ứng với đơn vị tính, còn DON_GIA_BH là giá thanh toán BHYT; TYLE_TT_BH thể hiện tỷ lệ thanh toán, với thiết bị không có tỷ lệ riêng thì ghi 100.

Do đó:

MA_VAT_TU đúng

nhưng:

DON_GIA_BH hoặc TYLE_TT_BH không khớp version danh mục áp dụng

vẫn là vấn đề cần phát hiện.

Phép kiểm tra không thể dừng ở membership.


6. Đơn vị tính là một thuộc tính đặc biệt quan trọng

Một mã đúng nhưng đơn vị tính khác có thể làm sai:

  • số lượng;
  • đơn giá;
  • thành tiền.

Ví dụ danh mục quản lý:

1 hộp

nhưng XML ghi:

10 viên

thì không thể so đơn giá và số lượng trực tiếp nếu chưa có quy tắc quy đổi.

Do đó phải phân biệt:

mã đúng

với:

mã + đơn vị + số lượng + giá đúng cùng một hệ quy chiếu.

Rule tự động không nên tự suy ra quy đổi đơn vị nếu chưa có mapping chính thức.


7. Thông tin thầu, hợp đồng và nguồn mua sắm cũng thuộc bối cảnh của mã

Mẫu 03/DM và Mẫu 04/DM đều quản lý:

  • nhà thầu;
  • thông tin thầu;
  • loại thầu;
  • hình thức thầu;
  • thời gian hợp đồng.

Ví dụ Mẫu 03/DM quy định TU_NGAY_HD, DEN_NGAY_HD, LOAI_THAU, HT_THAU cùng với thông tin của thuốc.

Điều này cho thấy:

cùng một mã thuốc có thể tồn tại qua nhiều đợt mua sắm với thuộc tính giá và thầu khác nhau.

Nếu chỉ lookup theo MA_THUOC mà bỏ qua version/hợp đồng, resolver có thể chọn nhầm bản ghi.


8. Thời điểm áp dụng là một phần của tính hợp lệ

Đây là điểm nối trực tiếp với Bài 2.11.

Mẫu 03–06 đều có:

  • TU_NGAY;
  • DEN_NGAY.

Ví dụ Mẫu 05/DM quy định TU_NGAY cho trường hợp tạo lập hoặc cập nhật danh mục và DEN_NGAY khi điều chỉnh hoặc ngừng sử dụng. Khi thông tin thay đổi, bản cũ được kết thúc bằng DEN_NGAY, bản mới bắt đầu bằng TU_NGAY.

Do đó phép lookup đúng phải là:

catalog record effective at event_date

không phải:

latest catalog record today.


9. Không được dùng danh mục hiện tại để phán xét hồ sơ lịch sử

Ví dụ:

  • giá A có hiệu lực đến 30/06;
  • giá B áp dụng từ 01/07.

Hồ sơ ngày 15/06 phải kiểm tra theo A.

Nếu hệ thống lấy danh mục hiện tại B để kiểm tra lại hồ sơ tháng 6 thì có thể tạo lỗi giả.

Ngược lại, nếu hồ sơ ngày 15/07 vẫn sử dụng A, cần phát hiện khả năng dùng version cũ.

Nguyên tắc:

Dữ liệu lịch sử phải được kiểm tra bằng danh mục lịch sử.


10. Thời điểm hợp đồng và thời điểm danh mục áp dụng không phải lúc nào cũng giống nhau

Đây là một điểm dễ bị bỏ qua.

Thông tư 12 quy định đối với danh mục được gửi đúng và đủ tài liệu, thời điểm áp dụng có cơ chế xác định cụ thể. Riêng thuốc và thiết bị y tế, thời điểm áp dụng không được sớm hơn thời điểm có hiệu lực của hợp đồng mua sắm hoặc thời điểm mua sắm tương ứng.

Khi cập nhật/điều chỉnh, thời điểm áp dụng còn phụ thuộc vào ngày nhận văn bản thông báo hoặc ngày cơ sở đề nghị nếu ngày đề nghị muộn hơn; trường hợp thuốc, thiết bị mua sắm phục vụ cấp cứu có quy định riêng theo ngày hóa đơn.

Do đó phải phân biệt:

  • hiệu lực của mã trong danh mục quốc gia;
  • hiệu lực hợp đồng;
  • hiệu lực danh mục tại cơ sở;
  • ngày sử dụng thực tế.

11. Mã có trên Cổng cũng không phải “chân lý bất biến”

Điều 8 Thông tư 12 quy định trường hợp 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ăn bản được cấp có thẩm quyền phê duyệt, cơ quan BHXH và cơ sở KCB phối hợp điều chỉnh hoặc hủy áp dụng thông tin đó.

Điều này rất quan trọng.

Không nên xây rule:

if code exists on portal → always valid.

Cổng là một nguồn dữ liệu quan trọng, nhưng vẫn phải đối chiếu:

danh mục dùng chung + văn bản phê duyệt + version của cơ sở.


12. Một mã máy đúng cũng phải đúng máy thực tế

Mẫu 06/DM quản lý thiết bị thực hiện DVKT bằng nhiều thuộc tính:

  • tên thiết bị;
  • model;
  • nhà sản xuất;
  • nước sản xuất;
  • năm sản xuất;
  • năm bắt đầu sử dụng;
  • MA_MAY;
  • số lưu hành;
  • thời gian hợp đồng;
  • thời gian áp dụng.

Vì vậy XML3 có MA_MAY tồn tại trong danh mục vẫn chưa đủ.

Phải kiểm tra:

  • có đúng cơ sở không;
  • đang có hiệu lực không;
  • đúng máy thực hiện không;
  • máy đó có phù hợp với DVKT không.

Phần cuối là kiểm tra relation, không chỉ catalog membership.


13. Mã dịch vụ đúng chưa chứng minh dịch vụ được phép thực hiện trong mọi bối cảnh

Mẫu 05/DM còn có:

  • QD_DVKT;
  • QD_PD_GIA;
  • CSKCB_CGKT;
  • CSKCB_CLS;
  • QUY_TRINH.

Các thuộc tính này cho thấy một mã DVKT có thể xuất hiện trong nhiều bối cảnh:

  • cơ sở tự thực hiện;
  • nhận chuyển giao kỹ thuật;
  • chuyển CLS sang cơ sở khác;
  • sử dụng giá của bối cảnh đặc thù.

Do đó:

same code ≠ same operational context.

Rule phải tránh kết luận sai đối với những trường hợp chuyển giao hoặc chuyển CLS hợp lệ.


14. Kiểm tra catalog nên có ít nhất bốn lớp

Một kiến trúc thực dụng gồm:

Lớp 1 — Membership

Mã có tồn tại trong catalog thích hợp không?

Lớp 2 — Attribute consistency

Tên, đơn vị, số đăng ký, model, giá, thầu... có khớp bản ghi không?

Lớp 3 — Effective period

Bản ghi có hiệu lực tại thời điểm nghiệp vụ không?

Lớp 4 — Context

Bản ghi đó có phù hợp:

  • cơ sở;
  • khoa;
  • nhân lực;
  • máy;
  • dịch vụ;
  • điều kiện sử dụng

hay không?

Chỉ sau bốn lớp này mới có bức tranh đáng tin cậy hơn.


15. Ngày dùng để kiểm tra phải là ngày nghiệp vụ phù hợp

Không phải mọi catalog đều lookup bằng:

NGAY_RA.

Ví dụ có thể cần:

  • thuốc → ngày y lệnh/thực hiện;
  • DVKT → ngày thực hiện;
  • vật tư → ngày sử dụng/DVKT;
  • máy → ngày thực hiện DVKT;
  • khoa → thời gian người bệnh thuộc khoa.

Rule phải xác định:

event date relevant to catalog.

Nếu dùng một ngày duy nhất cho tất cả catalog sẽ tạo sai lệch.


16. Một hồ sơ có thể đi qua hai version danh mục

Ví dụ đợt điều trị:

  • vào viện ngày 28/06;
  • ra viện ngày 03/07.

Danh mục thay đổi ngày 01/07.

Các sự kiện ngày 29/06 phải kiểm tra theo version cũ; các sự kiện ngày 02/07 có thể phải kiểm tra theo version mới.

Không được chọn một catalog version duy nhất chỉ vì hồ sơ có một NGAY_RA.

Required resolver phải hoạt động ở cấp sự kiện/dòng, không chỉ cấp hồ sơ.


17. Không nên ép tên XML phải giống tuyệt đối tên catalog trong mọi trường hợp

Tên là thuộc tính quan trọng nhưng không phải lúc nào cũng là khóa.

Có thể có:

  • cách viết hoa/thường;
  • chuẩn hóa khoảng trắng;
  • tên thương mại;
  • tên theo quyết định giá;
  • tên nội bộ.

Đặc biệt Mẫu 05/DM còn phân biệt TEN_DICH_VU với TEN_DVKT_GIA.

Do đó nếu tên khác cần xác định:

đây là khác biệt biểu diễn hay khác bản chất đối tượng?

Không nên dùng string equality đơn giản cho mọi trường.


18. Cần phân biệt mismatch chắc chắn với mismatch cần rà soát

Ví dụ:

Chắc chắn cao

MA_THUOC không tồn tại trong catalog áp dụng.

→ ERROR_TECH.

Cần rà soát

Tên thuốc hơi khác nhưng mã, hàm lượng, số đăng ký đều khớp.

→ có thể WARN_REVIEW hoặc normalization issue.

Cần bằng chứng

Dịch vụ có mã đúng nhưng bối cảnh chuyển giao kỹ thuật chưa có đủ dữ liệu để xác minh.

→ INFO_EVIDENCE.

Điều kiện thanh toán

Chỉ khi quy định thanh toán cụ thể được xác lập và vi phạm.

→ PAYMENT_CONDITION.

Không nên dùng một mức severity cho mọi mismatch.


19. “Có trong danh mục” không đồng nghĩa “được thanh toán”

Đây là nguyên tắc đặc biệt quan trọng.

Một thuốc hoặc VTYT có trong danh mục có thể vẫn cần kiểm tra:

  • phạm vi hưởng;
  • tỷ lệ;
  • điều kiện;
  • mức thanh toán;
  • quan hệ với DVKT;
  • thực tế sử dụng.

Điều 10 Thông tư 12 tách riêng:

  • phạm vi thanh toán theo danh mục;
  • mức thanh toán;
  • tỷ lệ và điều kiện thanh toán.

Như vậy:

catalog membership ≠ payment entitlement.

Catalog chỉ là một lớp trong quá trình giám định.


20. Kiến trúc Dr5-XML: không hard-code danh sách mã trong Python

Nhóm rule này rất phù hợp với Generic Catalog Framework.

dr5_catalog_binding

Quản lý:

  • mã ngoài;
  • mapping nội bộ;
  • source catalog;
  • version;
  • valid_from;
  • valid_to;
  • các thuộc tính cần đối chiếu.

dr5_xml_relation

Quản lý quan hệ như:

  • service ↔ machine;
  • service ↔ supply;
  • service ↔ department;
  • service ↔ practitioner.

dr5_payment_condition

Quản lý điều kiện thanh toán.

dr5_legal_basis

Quản lý nguồn pháp lý và thời gian hiệu lực.

Không nên tạo các bảng riêng như:

  • dr5_drug;
  • dr5_service;
  • dr5_supply;
  • dr5_equipment.

21. Các generic implementation phù hợp

Có thể sử dụng các nhóm rule:

  • catalog_membership;
  • catalog_attribute_match;
  • catalog_effective_period;
  • catalog_lookup_constraint;
  • catalog_relation_constraint.

Ví dụ thay vì code:

check_ma_thuoc_ABC

rule sẽ mô tả:

XML2.MA_THUOC
→ lookup catalog drug binding
→ effective at NGAY_TH_YL
→ compare SO_DANG_KY, DON_VI_TINH, TT_THAU...

Khi danh mục thay đổi:

update catalog, không sửa implementation.


22. Một pipeline kiểm tra catalog

Có thể thực hiện:

1. Xác định loại đối tượng
→ 2. Xác định catalog/version áp dụng
→ 3. Xác định event date
→ 4. Lookup mã
→ 5. Kiểm tra hiệu lực
→ 6. Kiểm tra thuộc tính
→ 7. Kiểm tra cơ sở/bối cảnh
→ 8. Kiểm tra relations
→ 9. Kiểm tra payment conditions nếu cần.

Điều này tốt hơn:

SELECT code FROM current_catalog.


23. Một số rule có giá trị cao

Tình huốngKết quả đề xuất
mã không tồn tại trong catalog áp dụngERROR_TECH
mã tồn tại nhưng chưa đến TU_NGAYWARN_REVIEW
mã đã qua DEN_NGAYWARN_REVIEW
cùng mã có hai version hiệu lực chồng lấnERROR_TECH catalog
mã thuốc đúng nhưng số đăng ký không khớpWARN_REVIEW
mã VTYT đúng nhưng model không khớpWARN_REVIEW
đơn vị tính không khớp catalogWARN_REVIEW
mã quốc gia tồn tại nhưng không tìm thấy trong danh mục sử dụng của cơ sởWARN_REVIEW
mã dịch vụ đúng nhưng thiếu căn cứ chuyển giao/chuyển CLSINFO_EVIDENCE
mã hợp lệ nhưng vi phạm một điều kiện thanh toán cụ thểPAYMENT_CONDITION

Việc chuyển WARN_REVIEW thành kết luận mạnh hơn chỉ nên thực hiện khi có đủ căn cứ.


Kết luận

Kiểm tra danh mục không phải là câu hỏi:

“Mã có tồn tại không?”

Mà là chuỗi câu hỏi:

Mã thuộc danh mục nào?
→ đại diện cho đối tượng nào?
→ các thuộc tính đi kèm có khớp không?
→ cơ sở có được áp dụng bản ghi này không?
→ bản ghi có hiệu lực tại ngày nghiệp vụ không?
→ bối cảnh sử dụng có phù hợp không?

Sáu nguyên tắc cần nhớ:

Đúng cú pháp mã chưa chắc đúng danh mục.

Đúng mã chưa chắc đúng đối tượng nếu các thuộc tính không nhất quán.

Đúng mã trong danh mục dùng chung chưa chắc thuộc danh mục sử dụng có hiệu lực của cơ sở.

Danh mục phải được kiểm tra theo thời điểm phát sinh nghiệp vụ, không mặc định theo phiên bản hiện tại.

Membership trong danh mục không đồng nghĩa đủ điều kiện thanh toán.

Rule phải catalog-driven và version-aware, không hard-code hàng nghìn mã vào Python.

Đối với Dr5-XML, Bài 4.3 là nền tảng của CatalogCandidateResolver: từ một giá trị XML, hệ thống phải tìm đúng bản ghi danh mục tương ứng theo loại đối tượng + cơ sở + thời điểm + version, sau đó mới đánh giá thuộc tính, quan hệ và điều kiện thanh toán. Khi làm đúng lớp này, việc cập nhật danh mục sẽ trở thành cập nhật dữ liệu dr5_..., thay vì phải sửa lại hàng loạt rule mỗi khi mã, giá hoặc thời gian áp dụng thay đổi.