Công văn 1245/BHXH-CNTT 2024 kiểm thử tiếp nhận dữ liệu điện tử theo định dạng XML

• Số hiệu: 1245/BHXH-CNTT
• Loại văn bản: Công văn
• Nơi ban hành: Bảo hiểm xã hội Việt Nam
• Người ký: Chu Mạnh Sinh
• Ngày ban hành: 03/05/2024

BẢO HIỂM XÃ HỘI VIỆT NAM -------	CỘNG HÒA XÃ HỘI CHỦ NGHĨA VIỆT NAM Độc lập - Tự do - Hạnh phúc ---------------
Số: 1245/BHXH-CNTT V/v triển khai kiểm thử tiếp nhận dữ liệu điện tử theo định dạng XML của các Bảng chỉ tiêu dữ liệu quy định tại Quyết định số 4750/QĐ-BYT	Hà Nội, ngày 03 tháng 5 năm 2024

Kính gửi:

- Bảo hiểm xã hội các tỉnh, thành phố trực thuộc Trung ương; - Bảo hiểm xã hội Bộ Quốc phòng; - Bảo hiểm xã hội Công an Nhân dân. (Sau đây gọi chung là BHXH các tỉnh)

Thực hiện Quyết định số 4750/QĐ-BYT ngày 29/12/2023 của Bộ Y tế về việc Quyết định sửa đổi, bổ sung Quyết định số 130/QĐ-BYT ngày 18/01/2023 của Bộ trưởng Bộ Y tế quy định Chuẩn và định dạng dữ liệu đầu ra phục vụ việc quản lý, giám định, thanh toán chi phí khám bệnh, chữa bệnh (KCB) và giải quyết các chế độ liên quan; Công văn số 907/BYT-BH ngày 01/3/2024 của Bộ Y tế về việc đôn đốc triển khai kiểm thử gửi và nhận dữ liệu KCB BHYT theo Chuẩn và định dạng dữ liệu đầu ra ban hành kèm theo Quyết định số 4750/QĐ-BYT , Bảo hiểm xã hội (BHXH) Việt Nam đã điều chỉnh, nâng cấp Cổng tiếp nhận dữ liệu Hệ thống thông tin giám định BHYT đảm bảo liên thông dữ liệu điện tử từ cơ sở KCB theo đúng chuẩn dữ liệu quy định. BHXH Việt Nam yêu cầu BHXH các tỉnh thực hiện một số nội dung sau:

1. Chủ động phối hợp với Sở Y tế hỗ trợ các cơ sở KCB kiểm thử việc liên thông dữ liệu theo chuẩn và định dạng dữ liệu đầu ra phục vụ việc quản lý, giám định, thanh toán chi phí KCB và giải quyết các chế độ liên quan ban hành kèm theo Quyết định số 4750/QĐ-BYT theo tài liệu hướng dẫn tại Phụ lục kèm theo.

2. Yêu cầu các cơ sở KCB kịp thời điều chỉnh phần mềm để có thể gửi dữ liệu theo theo chuẩn và định dạng dữ liệu ban hành kèm theo Quyết định số Quyết định số 4750/QĐ-BYT .

Trong quá trình thực hiện, nếu có phát sinh vướng mắc, đề nghị BHXH các tỉnh báo cáo kịp thời về Bảo hiểm xã hội Việt Nam (Trung tâm Công nghệ thông tin) để xem xét, giải quyết./.

Nơi nhận: - Như trên; - Bộ Y tế (để b/c); - Tổng Giám đốc (để b/c); - Phó TGĐ Nguyễn Đức Hòa; - Các đơn vị: CSYT, CSXH, GĐĐT, TTTT, VP; - Lưu: VT, CNTT.

KT. TỔNG GIÁM ĐỐC PHÓ TỔNG GIÁM ĐỐC Chu Mạnh Sinh

PHỤ LỤC

HƯỚNG DẪN LIÊN THÔNG DỮ LIỆU PHỤC VỤ VIỆC QUẢN LÝ, GIÁM ĐỊNH, THANH TOÁN CHI PHÍ KCB VÀ GIẢI QUYẾT CÁC CHẾ ĐỘ LIÊN QUAN THEO QUYẾT ĐỊNH 4750/QĐ-BYT
(Ban hành kèm theo Công văn số 1245/BHXH-CNTT ngày 03/5/2024 của BHXH Việt Nam)

I. GỬI DỮ LIỆU KHÁM BỆNH, CHỮA BỆNH THÔNG QUA DỊCH VỤ WEB

Hệ thống sử dụng chuẩn kết nối là Web Service định dạng JSON.

1. Dịch vụ lấy phiên làm việc

● URL:

https://daotaoegw.baohiemxahoi.gov.vn/api/token/take

● Phương thức: POST

1.1. Headers:

Tên tham số	Kiểu dữ liệu - giá trị	Bắt buộc	Mô tả
Content-Type	String	x	application/x-www-form-urlencoded

1.2. Body:

Tên tham số	Kiểu dữ liệu - giá trị	Bắt buộc	Mô tả
username	String	x	Tên tài khoản được cấp
password	String	x	Mật khẩu truy cập được cấp (mã hóa MD5 uppercase)

1.3. Response:

Tên trường	Kiểu dữ liệu - giá trị	Mô tả
maKetQua	String	Mã kết quả trả về
APIKey	ResultObject	Dữ liệu trả về

Trong đó, ResultObject được định nghĩa như sau:

Tên trường	Kiểu dữ liệu - giá trị	Mô tả
access_token	String	Mã token truy cập hệ thống
id_token	String	Id token truy cập
token_type	String	Kiểu token truy cập
username	String	Tên đăng nhập
expires_in	datetime	Thời gian hết hạn token(UTC)

2. Dịch vụ gửi dữ liệu trạng thái khám bệnh, chữa bệnh (bảng check-in)

● URL:

https://daotaoegw.baohiemxahoi.gov.vn/api/qd130/checkInKcbQd4750

● Phương thức: POST

2.1. Headers:

Tên tham số	Kiểu dữ liệu - giá trị	Bắt buộc	Mô tả
Content-Type	String	x	application/x-www-form- urlencoded
accessToken	String	x	Token lấy được tại mục 1
tokenId	String	x	Id token lấy được tại mục 1
passwordHash	String	x	Password được mã hóa md5

2.2. Body:

Tên tham số	Kiểu dữ liệu - giá trị	Bắt buộc	Mô tả
username	String	x	Tên tài khoản được cấp
loaiHoSo	String	x	Loại hồ sơ: mặc định điền 0
maTinh	String	x	Mã tỉnh cơ sở khám bệnh, chữa bệnh trực thuộc
maCSKCB	String	x	Mã cơ sở khám bệnh, chữa bệnh
fileHSBase64	String	x	File xml theo cấu trúc XML0 (được mô tả tại mục 2.4) được mã hóa thành chuỗi base64

2.3. Response:

Tên trường	Kiểu dữ liệu - giá trị	Mô tả
maKetQua	String	Mã kết quả trả về (200 - success, 401 unauthen, 403 - unauthoried…)
maGiaoDich	String	Mã giao dịch (lưu lại để đối chiếu)
thoiGianTiepNhan	String	Thời điểm tiếp nhận định dạng: yyyyMMddHHmmss
thongDiep	String	Thông điệp trả về, kèm theo thông điệp lỗi nếu có

2.4. Cấu trúc file XML

3. Dịch vụ gửi dữ liệu khám bệnh, chữa bệnh

● URL:

https://daotaoegw.baohiemxahoi.gov.vn/api/qd130/guiHoSoXmlQD4750

● Phương thức: POST

3.1. Headers:

Tên tham số	Kiểu dữ liệu - giá trị	Bắt buộc	Mô tả
Content-Type	String	x	application/x-www-form- urlencoded
accessToken	String	x	Token lấy được tại mục 1
tokenId	String	x	Id token lấy được tại mục 1
passwordHash	String	x	Password được mã hóa md5

3.2. Body:

Tên tham số	Kiểu dữ liệu - giá trị	Bắt buộc	Mô tả
username	String	x	Tên tài khoản được cấp
loaiHoSo	String	x	Loại hồ sơ: mặc định điền 130
maTinh	String	x	Mã tỉnh cơ sở khám bệnh, chữa bệnh trực thuộc
maCSKCB	String	x	Mã cơ sở khám bệnh, chữa bệnh
fileHSBase64	String	x	File xml theo cấu trúc quy định tại Quyết định số 4750/QĐ-BYT (được mô tả tại mục 3.4) được mã hóa thành chuỗi base64

3.3.Response:

Tên trường	Kiểu dữ liệu - giá trị	Mô tả
maKetQua	String	Mã kết quả trả về (200 - success, 401 unauthen, 403 - unauthoried…)
maGiaoDich	String	Mã giao dịch (lưu lại để đối chiếu)
thoiGianTiepNhan	String	Thời điểm tiếp nhận định dạng: yyyyMMddHHmmss
thongDiep	String	Thông điệp trả về, kèm theo thông điệp lỗi nếu có

3.4. Cấu trúc file XML

3.5. Mô tả định dạng các file XML theo quy định tại Quyết định 4750/QĐ-BYT , được mã hóa thành nội dung file kèm theo file XML tại mục 3.4

3.5.1. XML1. Chỉ tiêu tổng hợp khám bệnh, chữa bệnh

3.5.2. XML2. Chỉ tiêu chi tiết thuốc

3.5.3. XML3 (Chỉ tiêu chi tiết dịch vụ kỹ thuật và vật tư y tế)

3.5.4. XML4 (Chỉ tiêu chi tiết dịch vụ cận lâm sàng)

3.5.5. XML5 (Chỉ tiêu chi tiết diễn biến lâm sàng)

3.5.6. XML6 (Chỉ tiêu hồ sơ bệnh án chăm sóc và điều trị HIV/AIDS)

3.5.7.XM7 (Chỉ tiêu dữ liệu giấy ra viện)

3.5.8.XML8 (Chỉ tiêu dữ liệu tóm tắt hồ sơ bệnh án)

3.5.9. XML9 (Chỉ tiêu dữ liệu giấy chứng sinh)

3.5.10. XML10 (Chỉ tiêu dữ liệu giấy chứng nhận nghỉ dưỡng thai)

3.5.11. XML11 (Chỉ tiêu dữ liệu giấy chứng nhận nghỉ hưởng bảo hiểm xã hội)

3.5.13. XML13 (Chỉ tiêu dữ liệu giấy chuyển tuyến)

3.5.14. XML14 (Chỉ tiêu dữ liệu giấy hẹn khám lại)

3.5.15. XML15 (Chỉ tiêu dữ liệu chi tiết điều trị bệnh lao)

II. CHỨC NĂNG KIỂM SOÁT HỒ SƠ TRÊN CỔNG TIẾP NHẬN DỮ LIỆU HỆ THỐNG THÔNG TIN GIÁM DỊNH BHYT (CỔNG)

1. Kiểm tra tình trạng xử lý các file đã đẩy lên hệ thống

Bước 1: Đăng nhập Cổng bằng tài khoản đã được cấp => Chọn Hồ sơ đề nghị thanh toán => Chọn Hồ sơ XML => Chọn Quyết định 4750/QĐ-BYT => Chọn Danh sách tiếp nhận, Màn hình hiển thị như sau:

Bước 2: Chọn các điều kiện :

- Cơ sở KCB (Mặc định cơ sở tương ứng với user đăng nhập)

- Thời gian (Giai đoạn, tháng)

- Tình trạng file (File đã nhận và đang chờ xử lý, file đã xử lý xong)

Bước 3: Chọn các trường rồi nhận biểu tượng hiển thị danh sách chi tiết hồ sơ lỗi:

2. Tra cứu kết quả gửi hồ sơ XML

Bước 1: Đăng nhập Cổng bằng tài khoản đã được cấp => Chọn Hồ sơ đề nghị thanh toán => Hồ sơ XML => Quyết định 4750/QĐ-BYT => Kết quả gửi hồ sơ XML, Màn hình hiển thị như sau:

Bước 2: Cơ sở chọn các trường thông tin tìm kiếm sau:

Cơ sở KCB	Mặc định cơ sở đăng nhập tài khoản
Từ ngày	Tối đa 60 ngày cho tới ngày hiện tại
Đến ngày	Mặc định ngày hiện tại tìm kiếm (cho phép chọn lại)

Bước 3: Chọn Tìm kiếm để tìm kiếm số hồ sơ phù hợp với điều kiện tìm kiếm đã chọn.

Bước 4: Tại màn hình Danh sách, nhấn chọn vào Tổng số hồ sơ gửi lỗi

Bước 5: Xem thông tin chi tiết hồ sơ lỗi: