CheckXML là phần mềm hỗ trợ kiểm tra các hồ sơ XML thanh toán BHYT nhằm phát hiện và giảm thiểu các lỗi kỹ thuật, logic trước khi gửi dữ liệu lên cổng tiếp nhận. Công cụ này cho phép giám sát tự động 24/7 các file XML, đối chiếu với quy tắc do Bộ Y tế và BHXH quy định, qua đó giúp cơ sở khám chữa bệnh hạn chế sai sót và rủi ro trong thanh quyết toán chi phí BHYT. Tài liệu này hướng dẫn chi tiết cách cài đặt và cấu hình CheckXML phiên bản theo chuẩn dữ liệu Quyết định 130/4750/3176 ... của BYT dành cho người dùng chưa có kinh nghiệm kỹ thuật, bao gồm cả phần máy trạm (client) và máy chủ (server), với các bước cụ thể kèm hình ảnh minh họa. Ngoài ra, tài liệu giải thích các lỗi thường gặp trong quá trình cài đặt, cấu hình và sử dụng, cùng cách khắc phục.
Chuẩn bị trước khi cài đặt – Yêu cầu hệ thống và phần mềm cần thiết
Tải xuống và cài đặt CheckXML – Hướng dẫn tải bộ cài và thiết lập ban đầu
Đăng ký tài khoản CheckXML – Tạo tài khoản và kích hoạt bản quyền sử dụng
Cấu hình CheckXML trên máy trạm (Client)
4.1. Cấu hình kết nối máy chủ CheckXML (Tab
CheckXML)
4.2. Cấu hình thư mục làm việc (Tab Thư mục làm việc)
4.3. Cấu hình lưu trữ kết quả (Tab Lưu trữ kết quả)
4.4. Cấu hình gửi dữ liệu lên cổng BHYT (Tab
Cổng tiếp nhận)
4.5. Cấu hình gửi email cảnh báo (Tab
Mail)
Cấu hình trên máy chủ (Tab Website) – Cập nhật quy luật và danh mục trên server
Sử dụng chương trình CheckXML – Khởi động kiểm tra và vận hành cơ bản
Các lỗi thường gặp và cách khắc phục – Tổng hợp thông báo lỗi và giải pháp
Hình 1: Giao diện trang quản lý tài khoản CheckXML (máy chủ free) sau khi đăng nhập (gói Basic)
Hình 2: Cấu hình kết nối đến máy chủ CheckXML trên tab CheckXML của phần mềm
Hình 3: Cấu hình các thư mục làm việc trên tab Thư mục làm việc
Hình 4: Cấu hình kết nối cơ sở dữ liệu lưu kết quả trên tab Lưu trữ kết quả
Hình 5: Cấu hình thông tin tài khoản cổng tiếp nhận BHYT trên tab Cổng tiếp nhận
Hình 6: Cấu hình thông tin gửi email cảnh báo trên tab Mail
Hình 7: Giao diện tab Website trong phần mềm (cấu hình trên server) với menu Chức năng để khai báo cấu hình, quy luật và danh mục
Trước khi tiến hành cài đặt CheckXML, hãy đảm bảo máy tính (đặc biệt là máy chủ dự kiến cài đặt cơ sở dữ liệu) đã đáp ứng các yêu cầu sau:
Hệ điều hành: Windows 7/8/10/11 (khuyến nghị bản 64-bit).
Quyền quản trị viên: Bạn cần quyền Admin trên hệ thống để cài đặt các thành phần.
Phần mềm nền tảng bắt buộc: Đã cài đặt Microsoft SQL Server (phiên bản 2012 trở lên) để làm cơ sở dữ liệu lưu trữ kết quả; SQL Server Management Studio (SSMS) để quản lý cơ sở dữ liệu; .NET Desktop Runtime (phiên bản 6.0 trở lên) và WebView2 để chạy được ứng dụngcheckxml.gpp.vn. (Lưu ý: Nếu máy bạn chưa có các thành phần này, hãy cài đặt theo hướng dẫn tương ứng trước khi cài CheckXML. Nội dung cài đặt các thành phần bổ trợ này không nằm trong phạm vi tài liệu này.)
Ngoài ra, để tránh xung đột trong quá trình sử dụng, hãy tạm thời tắt hoặc thêm ngoại lệ (exclude) cho chương trình diệt virus đối với thư mục cài đặt CheckXML. Nguyên nhân là file thực thi của CheckXML được đóng gói bảo vệ nên đôi khi bị hiểu nhầm là virus và bị xóa nhầm bởi antiviruscheckxml.gpp.vn.
Bước này hướng dẫn cách tải bộ cài CheckXML từ trang chủ và cài đặt chương trình trên máy tính:
Tải bộ cài CheckXML: Truy cập trang download chính thức của CheckXML (ví dụ: liên kết trên trang hướng dẫn hoặc trực tiếp từ trang chủ GPP). Tại đây, tìm phiên bản CheckXML 1.30 hoặc mới hơn và nhấn tải về máy (file nén dạng .zip hoặc .rar). (Trang hướng dẫn trực tuyến cung cấp sẵn liên kết tải về công cụ CheckXML phiên bản mới nhấtcheckxml.gpp.vn.)
Giải nén tệp cài đặt: Sau khi tải về, bạn sẽ có một file nén. Hãy giải nén toàn bộ nội dung file này vào một thư mục trên máy. Khuyến nghị: tạo thư mục D:\CheckXML (hoặc một đường dẫn tùy chọn dễ nhớ) và giải nén vào đócheckxml.gpp.vn. Thư mục sau khi giải nén sẽ chứa các tệp chương trình, bao gồm CheckXML.exe và các thư mục cấu hình đi kèm.
Thiết lập ngoại lệ Antivirus: Như đã lưu ý ở trên, ngay sau khi giải nén, hãy thêm thư mục D:\CheckXML (hoặc thư mục bạn đã chọn) vào danh sách ngoại lệ của phần mềm diệt virus trên máy. Việc này nhằm đảm bảo tệp thực thi CheckXML.exe không bị xóa nhầm. (Nếu sử dụng Windows Defender, bạn có thể vào Virus & threat protection > Manage settings > Add or remove exclusions và thêm thư mục cài đặt vào danh sách loại trừ.)
Khởi chạy trình cài đặt (lần đầu): Thực ra CheckXML
không có file cài đặt dạng .MSI hay .EXE riêng để chạy setup, mà sau khi giải
nén, bạn sử dụng luôn chương trình CheckXML.exe. Hãy mở file D:\CheckXML\CheckXML.exe
vừa giải nén để tiến hành các
bước cấu hình ban đầucheckxml.gpp.vn.
(Khuyên dùng: chạy với quyền
Administrator bằng cách phải chuột và chọn “Run as administrator” để đảm bảo
có đủ quyền cấu hình.)
Lần đầu mở lên, Windows có thể cảnh báo bảo mật (SmartScreen) do file tải từ Internet. Hãy chọn “More info” > “Run anyway” để tiếp tục.
Giao diện chính của phần mềm CheckXML sẽ xuất hiện với một menu thanh công cụ phía trên và màn hình chào. Bạn đã sẵn sàng để tiến hành cấu hình kết nối và các tham số ban đầu cho chương trình.