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 2.11. Quản lý hiệu lực danh mục: thêm mới, điều chỉnh, ngừng áp dụng, đồng bộ và lưu phiên bản lịch sử

XML

Sau các bài từ 2.05 đến 2.10, có thể thấy sáu danh mục tại Phụ lục II Thông tư 12/2026/TT-BTC đều có một đặc điểm chung rất quan trọng: chúng không phải những bảng dữ liệu tĩnh.

Khoa có thể được mở mới hoặc dừng hoạt động. Người hành nghề có thể thay đổi khoa, phạm vi hành nghề hoặc lịch làm việc. Thuốc, vật tư có thể thay đổi giá, nhà thầu, hợp đồng. Dịch vụ có thể được bổ sung, thay đổi giá hoặc ngừng thực hiện. Máy có thể được đưa vào sử dụng, hết hạn hợp đồng hoặc hết thời gian đủ điều kiện kỹ thuật.

Vì vậy, quản lý danh mục đúng không phải là:

“Danh mục hiện tại có những gì?”

mà phải trả lời được:

“Tại một thời điểm xác định trong quá khứ hoặc hiện tại, bản ghi nào đang có hiệu lực và căn cứ nào làm cho nó có hiệu lực?”

Đây chính là nền tảng của quản lý phiên bản danh mục theo thời gian.


1. TU_NGAY và DEN_NGAY là cấu trúc chung của cả sáu Mẫu DM

Một đặc điểm nhất quán trong Phụ lục II Thông tư 12 là cả sáu mẫu từ 01/DM đến 06/DM đều có cơ chế quản lý thời gian áp dụng.

Khi thông tin danh mục thay đổi, Thông tư quy định cách cập nhật theo hai dòng:

  • dòng thứ nhất giữ thông tin cũ và ghi DEN_NGAY là ngày ngừng áp dụng;
  • dòng thứ hai ghi thông tin mới với TU_NGAY là ngày bắt đầu áp dụng và để trống DEN_NGAY.

Cơ chế này được lặp lại ở cả sáu mẫu danh mục.

Như vậy nguyên tắc dữ liệu rất rõ:

Thay đổi danh mục không phải là sửa đè bản ghi cũ.

Mà là:

đóng phiên bản cũ → tạo phiên bản mới.


2. Thêm mới, điều chỉnh và ngừng áp dụng là ba nghiệp vụ khác nhau

Thêm mới

Là trường hợp một đối tượng trước đó chưa có trong danh mục của cơ sở.

Ví dụ:

  • thành lập thêm khoa;
  • bổ sung bác sĩ mới;
  • mua một thuốc mới;
  • triển khai DVKT mới;
  • đưa một máy mới vào hoạt động.

Khi đó cần tạo một bản ghi với TU_NGAY phù hợp.

Điều chỉnh

Đối tượng vẫn tiếp tục tồn tại nhưng một hoặc nhiều thuộc tính thay đổi.

Ví dụ:

  • bác sĩ đổi khoa;
  • thuốc thay giá hoặc nhà thầu;
  • DVKT thay quyết định giá;
  • máy được gia hạn hợp đồng;
  • khoa thay số giường.

Không nên sửa record hiện hành.

Phải:

kết thúc record cũ + tạo record mới.

Ngừng áp dụng

Đối tượng không còn được sử dụng trong phạm vi danh mục của cơ sở.

Ví dụ:

  • khoa dừng hoạt động;
  • nhân viên nghỉ việc;
  • thuốc hết hợp đồng và không còn nguồn sử dụng;
  • DVKT ngừng triển khai;
  • máy thanh lý hoặc hết điều kiện sử dụng.

Khi đó ghi DEN_NGAY cho phiên bản cuối cùng.


3. Không được xóa lịch sử chỉ vì đối tượng không còn sử dụng

Một trong những lỗi nghiêm trọng trong quản trị master data là:

đối tượng hết hiệu lực → xóa khỏi database.

Ví dụ một thuốc đã sử dụng năm 2025 nhưng năm 2026 không còn mua.

Nếu xóa record đó, khi kiểm tra lại hồ sơ năm 2025 hệ thống có thể kết luận:

“Không tìm thấy thuốc trong danh mục.”

Trong khi tại thời điểm năm 2025 thuốc hoàn toàn hợp lệ.

Do đó:

Danh mục phục vụ giám định phải là danh mục lịch sử, không chỉ là danh mục hiện hành.

Một record hết hiệu lực vẫn cần được giữ để kiểm tra dữ liệu quá khứ.


4. Kiểm tra đúng phải là membership theo thời điểm

Không nên dùng rule:

code ∈ current_catalog

cho dữ liệu lịch sử.

Rule đúng hơn là:

code ∈ catalog(date_of_event)

Tức là trước hết phải xác định ngày nghiệp vụ.

Ví dụ:

  • thuốc: ngày y lệnh/ngày thực hiện;
  • DVKT: ngày thực hiện;
  • khoa: ngày người bệnh điều trị tại khoa;
  • người hành nghề: thời điểm chỉ định/thực hiện;
  • máy: ngày thực hiện DVKT.

Sau đó tìm phiên bản danh mục thỏa:

TU_NGAY ≤ event_date ≤ DEN_NGAY

hoặc nếu DEN_NGAY trống:

event_date ≥ TU_NGAY.

Đây là effective-period validation.


5. TU_NGAY không phải lúc nào cũng là ngày tạo record trong HIS

Điều 8 Thông tư 12 quy định cơ sở gửi đề nghị cập nhật, điều chỉnh danh mục qua Cổng tiếp nhận, đồng thời gửi văn bản và tài liệu liên quan cho cơ quan BHXH.

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

Vì vậy phải phân biệt:

  • ngày tạo record trong HIS;
  • ngày ký quyết định nội bộ;
  • ngày hợp đồng có hiệu lực;
  • ngày gửi thông báo;
  • ngày áp dụng trên Cổng;
  • TU_NGAY dùng cho kiểm tra liên thông.

Không nên tự động lấy:

created_at của database

làm TU_NGAY.


6. Danh mục bệnh viện, danh mục trên Cổng và Dr5 phải đồng bộ nhưng không được đồng nhất

Trong hệ thống thực tế có thể tồn tại ít nhất ba bản:

  1. danh mục vận hành trong HIS;
  2. danh mục đã gửi/đang áp dụng trên Cổng;
  3. danh mục kiểm tra của Dr5-XML.

Ba lớp cần đồng bộ nhưng phục vụ mục đích khác nhau.

Ví dụ HIS có thể đã thêm DVKT mới để phục vụ cấu hình nội bộ, nhưng Mẫu 05/DM trên Cổng chưa đến ngày áp dụng.

Khi đó:

  • HIS: dịch vụ tồn tại;
  • Cổng: chưa có hiệu lực;
  • Dr5: phải cảnh báo nếu XML sử dụng dịch vụ trước ngày áp dụng.

Do đó Dr5 không nên chỉ copy danh mục HIS và coi đó là chân lý.


7. Đồng bộ phải nhận biết “khác dữ liệu” và “khác phiên bản”

Giả sử HIS hiện ghi:

DV001 → giá 150.000

trong khi Cổng có:

  • đến 30/09: 120.000;
  • từ 01/10: 150.000.

Nếu Dr5 chỉ so giá hiện tại:

HIS = 150.000
Cổng = 150.000

thì có vẻ đúng.

Nhưng nếu kiểm tra hồ sơ ngày 15/09, giá đúng phải là 120.000.

Vì vậy đồng bộ không chỉ là:

current value comparison

mà phải là:

version history comparison.


8. Không được tạo khoảng hiệu lực chồng lấn mâu thuẫn

Một catalog tốt phải tránh trường hợp cùng một khóa nghiệp vụ có hai phiên bản đồng thời có hiệu lực nhưng mang thông tin mâu thuẫn.

Ví dụ:

MA_THUOCDON_GIA_BHTU_NGAYDEN_NGAY
A10.00001/0131/12
A12.00001/07—

Khoảng 01/07–31/12 bị chồng lấn.

Nếu không có thêm thuộc tính phân biệt, engine không biết chọn giá nào.

Rule catalog cần phát hiện:

overlapping effective periods for same business key.

Đây nên là ERROR_TECH của dữ liệu danh mục.


9. Cũng không nên để khoảng trống hiệu lực ngoài ý muốn

Ví dụ:

MA_DICH_VUTU_NGAYDEN_NGAY
X01/0130/06
X02/07—

Ngày 01/07 không có bản ghi áp dụng.

Nếu ngày đó có XML3 sử dụng dịch vụ X, hệ thống phải xác định:

  • đây là khoảng trống thực sự;
  • lỗi nhập ngày;
  • hay dịch vụ thực tế ngừng áp dụng một ngày.

Không được tự động nối hai khoảng để “làm đẹp dữ liệu”.


10. Việc điều chỉnh trên Cổng có thể tác động ngược đến lịch sử

Điều 8 còn quy định trường hợp phát hiện danh mục trên Cổng có nội dung sai lệch 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ở KBCB phối hợp điều chỉnh hoặc hủy áp dụng; thời điểm điều chỉnh/hủy được tính từ thời điểm tạo lập hoặc cập nhật thông tin danh mục tương ứng.

Điều này có nghĩa version history không chỉ có:

version 1 → version 2.

Còn có trường hợp:

một version đã từng tồn tại nhưng sau đó được xác định là sai và bị điều chỉnh/hủy áp dụng.

Dr5 nên lưu cả trạng thái này thay vì xóa dấu vết.


11. Cần phân biệt “hiệu lực pháp lý”, “hiệu lực hợp đồng” và “hiệu lực danh mục”

Một record có thể chịu nhiều lớp thời gian.

Ví dụ thuốc:

  • danh mục quốc gia có hiệu lực từ ngày A;
  • hợp đồng mua sắm có hiệu lực từ ngày B;
  • bản ghi Mẫu 03/DM áp dụng từ ngày C;
  • thuốc thực tế sử dụng ngày D.

Điều kiện có thể là:

A ≤ D
B ≤ D
C ≤ D

nhưng A, B, C không nhất thiết bằng nhau.

Tương tự máy:

  • thời gian hợp đồng thuê;
  • thời gian kiểm định;
  • thời gian Mẫu 06/DM có hiệu lực;

là ba khoảng khác nhau.

Do đó không nên chỉ có một trường generic active=true.


12. Mỗi bản ghi cần provenance — biết nó đến từ đâu

Để kiểm tra và giải trình, Dr5 cần biết một catalog record được tạo từ:

  • văn bản pháp lý nào;
  • file danh mục nào;
  • Mẫu DM nào;
  • lần đồng bộ nào;
  • ngày nhận dữ liệu;
  • phiên bản nào;
  • có phải bản bị thay thế/hủy hay không.

Một record chỉ có:

code, name, valid_from, valid_to

là chưa đủ cho audit.

Ít nhất phải truy được:

“Tại sao hệ thống coi mã này hợp lệ vào ngày đó?”


13. Quy trình đồng bộ nên đi theo một chiều có kiểm soát

Một kiến trúc an toàn có thể là:

Nguồn chính thức / Cổng / dữ liệu bệnh viện
→ vùng nhập thô
→ chuẩn hóa
→ so sánh phiên bản
→ kiểm tra xung đột
→ publish catalog dùng cho rule engine.

Không nên import file mới rồi ghi đè trực tiếp catalog production.

Trước khi publish cần kiểm tra:

  • mã mới;
  • mã mất đi;
  • mã đổi thuộc tính;
  • ngày hiệu lực thay đổi;
  • khoảng chồng lấn;
  • khoảng trống;
  • record bị hủy;
  • mapping nội bộ bị mất.

14. “Ngừng áp dụng” khác “xóa”

Trong giao diện quản trị cũng nên phân biệt rõ:

Xóa

Chỉ dành cho dữ liệu nhập sai chưa từng được sử dụng và chưa từng publish, nếu quy trình cho phép.

Ngừng áp dụng

Ghi DEN_NGAY.

Hủy áp dụng

Dùng khi xác định bản ghi đã được tạo nhưng không đúng căn cứ và phải hủy theo quy trình.

Thay thế

Đóng version cũ và tạo version mới.

Bốn thao tác này không nên dùng chung một nút “Delete”.


15. Kiểm tra XML phải dùng phiên bản danh mục tại thời điểm sự kiện

Khi một hồ sơ XML được gửi vào Dr5, resolver nên thực hiện:

Bước 1: xác định field cần kiểm tra.
Bước 2: xác định loại catalog.
Bước 3: xác định ngày nghiệp vụ.
Bước 4: xác định MA_CSKCB.
Bước 5: tìm phiên bản catalog có hiệu lực.
Bước 6: kiểm tra membership và attributes.
Bước 7: kiểm tra relations.
Bước 8: kiểm tra payment conditions nếu có.

Không nên dùng catalog “mới nhất” mặc định.


16. Các lỗi quản trị danh mục cần cảnh báo

Tình huốngPhân loại
hai version cùng khóa chồng lấn thời gianERROR_TECH
DEN_NGAY < TU_NGAYERROR_TECH
phiên bản mới không đóng phiên bản cũERROR_TECH
XML dùng mã trước TU_NGAYWARN_REVIEW
XML dùng mã sau DEN_NGAYWARN_REVIEW
HIS có mã nhưng Cổng chưa có hiệu lựcWARN_REVIEW
Cổng có mã nhưng HIS mapping sang mã khácWARN_REVIEW
danh mục mới làm mất mapping lịch sửERROR_TECH
record bị hủy nhưng vẫn được resolver chọnERROR_TECH
nguồn pháp lý/phiên bản không xác địnhINFO_EVIDENCE

17. Kiến trúc Dr5-XML: catalog phải immutable theo phiên bản

Trong Dr5-XML, nguyên tắc nên là:

một version đã publish không bị sửa đè về mặt lịch sử.

Nếu có thay đổi:

  • đóng version;
  • tạo version mới;
  • lưu provenance.

dr5_catalog_binding nên chịu trách nhiệm chính cho:

  • source catalog;
  • mã;
  • mapping;
  • valid_from;
  • valid_to;
  • version;
  • source/provenance.

dr5_legal_basis giữ căn cứ pháp lý và chuỗi sửa đổi.

dr5_xml_relation cũng phải có hiệu lực theo thời gian nếu relation thay đổi.

Ví dụ:

dịch vụ X được thực hiện bằng máy A đến 30/6, từ 01/7 chuyển sang máy B.

Nếu chỉ version catalog nhưng relation không version thì vẫn kiểm tra sai lịch sử.


18. Mục tiêu cuối cùng: tái tạo được trạng thái danh mục tại bất kỳ ngày nào

Một hệ thống tốt phải trả lời được câu hỏi:

“Ngày 15/3/2026, tại cơ sở 77003, khoa nào đang hoạt động, bác sĩ nào được đăng ký, thuốc nào đang có hiệu lực, dịch vụ nào áp dụng, vật tư nào được khai báo và máy nào đủ điều kiện sử dụng?”

Nếu hệ thống chỉ biết trạng thái hôm nay thì chưa đủ cho giám định.

Đây là yêu cầu cốt lõi của:

historical catalog reconstruction.

Kết luận

Quản lý danh mục BHYT phải được xem là quản lý vòng đời dữ liệu, không phải quản lý một bảng mã hiện hành.

Năm nguyên tắc cần nhớ:

Thêm mới = tạo version bắt đầu từ TU_NGAY.

Điều chỉnh = đóng version cũ bằng DEN_NGAY và tạo version mới.

Ngừng áp dụng = kết thúc hiệu lực, không xóa lịch sử.

Đồng bộ = so sánh theo phiên bản và thời gian, không chỉ so giá trị hiện tại.

Kiểm tra XML = dùng danh mục có hiệu lực tại thời điểm phát sinh nghiệp vụ, không dùng mặc định danh mục mới nhất.

Thông tư 12 đã thể hiện rất rõ triết lý này khi cả sáu Mẫu DM đều áp dụng cơ chế dòng cũ kết thúc – dòng mới bắt đầu khi thông tin thay đổi.

Đối với Dr5-XML, đây phải trở thành một nguyên tắc kiến trúc:

Rule ổn định, catalog có version, lịch sử không bị ghi đè.

Khi làm được điều đó, hệ thống không chỉ kiểm tra hồ sơ hôm nay mà còn có thể tái hiện chính xác bối cảnh danh mục của bất kỳ hồ sơ lịch sử nào — điều kiện thiết yếu để tiền giám định, giải trình và rà soát nguy cơ xuất toán một cách đáng tin cậy.