7. Các lỗi thường gặp và cách khắc phục
Trong quá trình cài đặt và sử dụng CheckXML, người dùng có thể gặp phải một số lỗi hoặc thông báo sự cố. Dưới đây là danh sách các lỗi thường gặp và hướng dẫn cách xử lý:
Lỗi tải cấu hình không thành công: Xảy ra khi nhấn Tải cấu hình nhưng không lấy được danh sách session. Thông báo có thể như “Tải cấu hình thất bại” hoặc “Sai thông tin đăng nhập”. Nguyên nhân: Thông tin Host, Email, Mật khẩu hoặc Mã CSKCB khai báo sai, hoặc tài khoản chưa được đăng ký trên máy chủ đó. Cách khắc phục: Kiểm tra lại từng thông tin đã nhập trên tab CheckXML:
Đúng địa chỉ Host máy chủ (đúng URL, đúng cổng).
Đúng Email (tài khoản) và Mật khẩu (phân biệt chữ hoa thường, không có khoảng trắng thừa).
Đúng Mã CSKCB (đúng mã của đơn vị, đủ số, khớp với mã dùng khi đăng ký tài khoản).
Kiểm tra kết nối mạng từ máy bạn tới
máy chủ (có truy cập internet, không bị tường lửa chặn).
Nhập đúng và thử lại. Nếu vẫn lỗi, thử
đăng nhập tài khoản đó trên trang web máy chủ (phần đăng ký) để chắc rằng
tài khoản hoạt động. Nếu quên mật khẩu, sử dụng chức năng khôi phục trên
web.
Lỗi không kết nối được đến máy chủ CheckXML: Xảy ra khi mở phần mềm hoặc tải cấu hình, báo lỗi kết nối (ví dụ: “Cannot connect to server”). Nguyên nhân: Máy chủ Host không phản hồi – có thể do sai địa chỉ hoặc do đường mạng. Cách khắc phục: Đảm bảo rằng bạn đã nhập đúng URL máy chủ (ví dụ thiếu “http://” cũng có thể gây lỗi). Thử mở URL đó trên trình duyệt; nếu không vào được, có thể máy chủ đang bảo trì hoặc mạng của bạn chặn. Kiểm tra proxy, firewall. Nếu bạn dùng máy chủ riêng nội bộ, đảm bảo máy chủ đó đang chạy và có IP đúng. Chỉnh lại Host nếu cần rồi thử tải cấu hình lại.
Lỗi antivirus xóa mất file CheckXML.exe: Biểu hiện: bạn giải nén xong nhưng file .exe biến mất hoặc khi chạy thì trình diệt virus chặn lại. Nguyên nhân: Như đã đề cập, một số antivirus nhận nhầm CheckXML là virus do cách đóng gói file. Cách khắc phục: Vào phần cách ly/quarantine của antivirus, khôi phục file nếu bị cách ly. Thêm thư mục cài đặt CheckXML vào danh sách ngoại lệ (exclusions) của antivirus. Sau đó giải nén lại bộ cài để phục hồi file bị xóa và chạy lại chương trình.
Lỗi không tạo được kết nối cơ sở dữ liệu (Test connect thất bại): Thông báo lỗi khi bấm Test connect như “Failed to connect to database” hoặc “Login failed for user ...”. Nguyên nhân: Sai tên máy chủ SQL hoặc instance, SQL Server chưa mở cổng hoặc chưa cho phép login, sai user/mật khẩu, hoặc database chưa tồn tại. Cách khắc phục: Kiểm tra tên máy chủ khai báo:
Nếu SQL cài cùng máy, thử dùng localhost hoặc . thay vì tên instance phức tạp.
Nếu SQL Express, tên instance thường .\SQLEXPRESS.
Đảm bảo SQL Server đang chạy (mở SQL Server Configuration Manager kiểm tra dịch vụ).
Mở SQL Server Configuration: bật TCP/IP trong Network Protocols, mở cổng 1433 trong Windows Firewall (nếu kết nối từ xa).
Kiểm tra user và password SQL: tài
khoản sa đã enable và đúng
mật khẩu chưa (mặc định SQL Express cài có thể khóa sa, cần mở và đặt mật
khẩu). Thử dùng SSMS đăng nhập bằng user đó để kiểm tra.
Nếu báo “database not found”, vào
SSMS tạo database đúng tên rồi thử lại.
Sau khi điều chỉnh, bấm Test connect lại đến khi báo thành
công.
Lỗi “Cập nhật CSDL” thất bại: Khi nhấn nút Cập nhật CSDL, chương trình báo lỗi,
không tạo được bảng. Nguyên
nhân: Tài khoản SQL không có quyền, hoặc database chưa trống (có bảng
trùng tên), hoặc phiên bản không tương thích. Cách khắc phục: Đảm bảo user SQL có quyền db_owner trên database, hoặc đăng
nhập bằng sa. Kiểm tra trong
database xem có bảng nào của CheckXML tạo dở dang không – nếu có, xóa đi rồi
chạy cập nhật lại. Nếu vẫn lỗi, có thể do phiên bản phần mềm; hãy kiểm tra xem
bạn có dùng đúng phiên bản CheckXML phù hợp DB hay không, hoặc liên hệ hỗ
trợ.
Lỗi không gửi được dữ liệu lên cổng BHYT: Sau khi kiểm tra xong, hồ sơ không đến được cổng BHYT, và file nằm trong thư mục “Gửi lỗi”. Nguyên nhân: Có nhiều khả năng:
Sai thông tin tài khoản_BV hoặc mật khẩu API (đã nhập ở tab Cổng tiếp nhận) dẫn đến lỗi xác thực.
Kết nối mạng tới cổng BHYT gặp sự cố (cổng BHYT có thể không phản hồi tạm thời).
Hồ sơ bị lỗi định dạng nên cổng từ chối ngay.
Tùy chọn SendXML lên cổng chưa được tích nên chương trình không
gửi (dù cấu hình tài khoản đúng).
Cách khắc
phục: Mở file log hoặc thông báo lỗi (nếu có) để xác định nguyên
nhân. Kiểm tra lại tài khoản_BV và mật khẩu: thử đăng nhập tài khoản đó trên
trang web cổng BHYT xem
đúng không (lưu ý tài khoản web thường không có _BV, nhưng mật khẩu thì
giống). Nếu sai thì nhập lại cho đúng và thử gửi lại. Nếu mạng lỗi, kiểm tra
đường truyền internet. Nếu hồ sơ bị từ chối do lỗi nội dung (xem phần “danh
sách lỗi từ chối” nếu có hoặc mở trên cổng BHYT mục Tra cứu hồ sơ), thì sửa dữ liệu và gửi lại. Đảm bảo đã
tích chọn SendXML trên tab Cổng tiếp nhận.
Lỗi “Danh mục chưa được phê duyệt”: Trong kết quả kiểm tra, hồ sơ bị cảnh báo với lỗi liên quan đến danh mục (ví dụ thuốc, dịch vụ) chưa được phê duyệt, mặc dù danh mục này thực tế đã có trong hệ thống BHYT. Nguyên nhân: Chưa thực hiện hoặc chưa cập nhật đầy đủ danh mục trên server cho session của bạn, dẫn đến chương trình không nhận biết được mã đó hợp lệ. Cách khắc phục: Vào tab Website > Quản lý danh mục như hướng dẫn ở mục 5.3, tiến hành cập nhật lại danh mục cho session:
Trước tiên đảm bảo đã khai báo đúng userBH và passBH (tài khoản cổng) ở Cài đặt cấu hình.
Chạy cập nhật các danh mục liên quan (thuốc, dịch vụ, vật tư... tùy lỗi nào báo chưa duyệt).
Cập nhật danh mục dùng chung nếu
cần.
Sau khi cập nhật thành công,
chạy kiểm tra lại hồ sơ. Nếu danh mục đã có trong dữ liệu cập nhật, cảnh báo
sẽ biến mất.
Lỗi không gửi được email cảnh báo: Chương trình báo gửi mail thất bại hoặc bạn không nhận được email nào khi có lỗi. Nguyên nhân: Cấu hình email (SMTP) sai hoặc email bị chặn. Cách khắc phục: Thử lại chức năng Test trong tab Mail để kiểm tra. Nếu thất bại, kiểm tra:
Trường SMTP, Port có đúng nhà cung cấp không (ví dụ Gmail: smtp.gmail.com và 587 với SSL).
Đã tích SSL nếu dùng TLS/SSL.
Tài khoản Gmail nếu dùng cần bật cho phép ứng dụng kém an toàn hoặc dùng mật khẩu ứng dụng (nếu bảo mật 2 lớp).
Kiểm tra trên hòm thư người gửi xem có cảnh báo đăng nhập bất thường không (đôi khi Google chặn đăng nhập mới).
Nếu mọi thứ đúng mà vẫn không gửi
được, thử dùng SMTP của một email khác để loại trừ vấn đề.
Sau khi điều chỉnh, test lại đến khi
thành công. Ngoài ra, kiểm tra danh sách người nhận: nếu không cấu hình gửi
cho khoa/NVYT cụ thể, hãy chắc chắn tùy chọn gửi về địa chỉ gửi mail (mail
nguồn) được bật để ít nhất email về được mail nguồn.
Phần mềm không chạy hoặc bị lỗi .NET: Nếu khi mở CheckXML.exe mà không thấy chương trình chạy, hoặc hiện thông báo lỗi thiếu runtime (.dll .NET), nguyên nhân có thể do máy chưa cài .NET Desktop Runtime hoặc WebView2 cần thiết. Cách khắc phục: Cài đặt .NET Desktop Runtime phiên bản phù hợp (ví dụ .NET 6.x hoặc 7.x) và WebView2 Runtime, sau đó khởi động lại máy và chạy lại CheckXML. (Xem lại mục 1 – chuẩn bị).
Các lỗi khác: Trong quá trình dùng có thể có những lỗi hiếm gặp như lỗi giao diện, treo chương trình, v.v. Hầu hết có thể khắc phục bằng cách khởi động lại phần mềm. Đảm bảo luôn dùng phiên bản mới nhất của CheckXML để hưởng các sửa lỗi và tính năng mới. Nếu gặp lỗi không rõ nguyên nhân, bạn có thể liên hệ đội hỗ trợ GPP hoặc cộng đồng sử dụng CheckXML (nhóm Facebook/Zalo nếu có) để được trợ giúp kịp thời.