Công văn 1245/BHXH-CNTT năm 2024 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 4750/QĐ-BYT do Bảo hiểm xã hội Việt Nam ban hành
Công văn 1245/BHXH-CNTT năm 2024 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 4750/QĐ-BYT do Bảo hiểm xã hội Việt Nam ban hành
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 | Ngày hiệu lực: | Đã biết |
Ngày công báo: | Đang cập nhật | Số công báo: | Đang cập nhật |
Tình trạng: | Đã biết |
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 |
Ngày hiệu lực: | Đã biết |
Ngày công báo: | Đang cập nhật |
Số công báo: | Đang cập nhật |
Tình trạng: | Đã biết |
BẢO HIỂM XÃ HỘI
VIỆT NAM |
CỘNG HÒA XÃ HỘI
CHỦ NGHĨA VIỆT NAM |
Số: 1245/BHXH-CNTT |
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; |
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./.
|
KT. TỔNG GIÁM ĐỐ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.
● 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
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 |
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 |
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.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:
(Không có nội dung)
Vì chưa Đăng Nhập nên Bạn chỉ xem được Thuộc tính của Văn bản. Bạn chưa xem được Hiệu lực của Văn bản, Văn bản Liên quan, Văn bản thay thế, Văn bản gốc, Văn bản tiếng Anh,...
Nếu chưa có Tài khoản, mời Bạn Đăng ký Tài khoản tại đây
(Không có nội dung)
Vì chưa Đăng Nhập nên Bạn chỉ xem được Thuộc tính của Văn bản. Bạn chưa xem được Hiệu lực của Văn bản, Văn bản Liên quan, Văn bản thay thế, Văn bản gốc, Văn bản tiếng Anh,...
Nếu chưa có Tài khoản, mời Bạn Đăng ký Tài khoản tại đây
Vì chưa Đăng Nhập nên Bạn chỉ xem được Thuộc tính của Văn bản. Bạn chưa xem được Hiệu lực của Văn bản, Văn bản Liên quan, Văn bản thay thế, Văn bản gốc, Văn bản tiếng Anh,...
Nếu chưa có Tài khoản, mời Bạn Đăng ký Tài khoản tại đây
-
Ban hành: {{m.News_Dates_Date}} Hiệu lực: {{m.News_EffectDate_Date}} Tình trạng: {{m.TinhTrang}} Cập nhật: {{m.Email_SendDate_Date}} Ban hành: {{m.News_Dates_Date}}Hiệu lực: {{m.News_EffectDate_Date}}Tình trạng: {{m.TinhTrang}}Cập nhật: {{m.Email_SendDate_Date}}
Vì chưa Đăng Nhập nên Bạn chỉ xem được Thuộc tính của Văn bản. Bạn chưa xem được Hiệu lực của Văn bản, Văn bản Liên quan, Văn bản thay thế, Văn bản gốc, Văn bản tiếng Anh,...
Nếu chưa có Tài khoản, mời Bạn Đăng ký Tài khoản tại đây
-
Ban hành: {{m.News_Dates_Date}} Hiệu lực: {{m.News_EffectDate_Date}} Tình trạng: {{m.TinhTrang}} Cập nhật: {{m.Email_SendDate_Date}} Ban hành: {{m.News_Dates_Date}}Hiệu lực: {{m.News_EffectDate_Date}}Tình trạng: {{m.TinhTrang}}Cập nhật: {{m.Email_SendDate_Date}}
Vì chưa Đăng Nhập nên Bạn chỉ xem được Thuộc tính của Văn bản. Bạn chưa xem được Hiệu lực của Văn bản, Văn bản Liên quan, Văn bản thay thế, Văn bản gốc, Văn bản tiếng Anh,...
Nếu chưa có Tài khoản, mời Bạn Đăng ký Tài khoản tại đây
Vì chưa Đăng Nhập nên Bạn chỉ xem được Thuộc tính của Văn bản. Bạn chưa xem được Hiệu lực của Văn bản, Văn bản Liên quan, Văn bản thay thế, Văn bản gốc, Văn bản tiếng Anh,...
Nếu chưa có Tài khoản, mời Bạn Đăng ký Tài khoản tại đây