/ ^ ^ fW k L V C Bô sung hình thứcHểữị thơng dG' liệu theo chn định dạng liệu đầu quy định Q uyết định số 4210/Q Đ -B Y T ngày 20 tháng năm 2017 Bộ Y Tế (Kèm theo cơng vah^ểjỊ$ì/J3ỉpéfĩ-CNTT ngàyX^thảng 10 năm 2017 ^vnơ^H X H Việt Nam) Két nối VVeb Service thông qua cổng tiếp nhặn Hệ thống sừ dụng chuẩn kết nối Web Service định dạng JSON 1.1 Hàm lây phiên làm việc 1.1.1 M ô tả Request URL HMAC http://egw.baohiemxahoi.gov.vn/api/token/take Request Method POST Request Header Content-Type: application/json Đối tượng “ApiToken”bao gồm { Form data “username”: { username }, “password”: {password } } Cơ sở khám chữa 3ệnh thực gửi yêu cầu cấp phiên làm việc lên hệ thống tiếp nhận ho sơ Hệ the ng trả Token tương ứng với phiên làm việc 1.1.2 Thông điệp yêu cầu Dữ liệu đầu vào Tên đăng nhập Mật Tên Field Ưsemame Password Kiểu liệu Ghi Chuỗi ký tự Tên đăng nhập vào hệ thống, BHXH VN cung cấp, trường bắt buộc Chuỗi ký tự Mật chuyển qua MD5 đăng nhập vào hệ thống, BHXH VN cung cấp, trường bắt buộc 1.1.3 Thông điệp trả lời Cấu trúc: - Header status: - Header Content-Type:application/json; charset=UTF-8 - Json data Trong đó: - Có hai khả thơng điệp trả lời: Trường hợp có lỗi q trình xử lý trường hợp xử lý thành cồng - Trường hợp lỗi: Xem danh mục lỗi gửi trả lại Trường Kết Header status :401 Unauthorized: Lỗi xác thực - Truồng hợp thành cỏng:Hệ thống trả về: Truông Kết Header status 200 Header ContentType application/json;charset=UTF-8 Json data Trả object bao gồm thuộc tính sau: + maKetQua: Trả mã kết giao dịch (Thành công, lỗi) + APIKey: object bao gồm (= null không thành công) { -access_token: Token sử dụng cho bước -idtoken: Mã client ID để sử dụng cho bước - expires in: Thời gian hết hạn của token (giờ GMT), sau thời gian token củalần đăng nhập khơng xác thực, cần phải đăng nhập lại để lay token - token type: bear } (Tham khảo mục 1.4.3.2) 1.2 Hàm gửi hồ so1giám định 1.2.1 Mô tả Request URL HMAC httDs://egw.baohiemxahoi.gov.vn/ani/egw/guiHoSoGiamDinh4210 Request Method POST Request Header Content-Type: application/json Query Parameters token= {token}& id_token= {id to k e n }&username= {username}&passw ord={password}&loaiHoSo={loaiHoSo}&maTinh={maTinh}&maCS KCB={maCSKCB} (Tham khảo mục 1.2.2) Form data “fileHS” : {fileHS} (Tham khảo mục 1.2.2) Cơ sở khám chữa bệnh thực gửi hồ sơ giám định nhận thông báo xác nhận kết nhận hồ sơ giám định quan Bảo hiểm qua hệ thống 1.2.2 Tlĩ ồng điệp yên cấu Dữ liệu đâu vào Tên Field Kiều liệu Ghi Dữ liệu hồ sơ fileHS Bytes Dạng bytes File XML, Trường bắt buộc Loại hồ sơ loaiHoSo Int Loại hồ sơ:3: KCB Mã Tỉnh maTinh Chuỗi ký tự Quy định 5084 Mã CSKCB maCSKCB Chuỗi ký tự Quy định 5084 Tên đăng nhập Username Chuỗi ký tự Tài khoản đăng nhập (an 5) Chuỗi ký tự Mật Password Token Token Chuỗi ký tự Token trả từ trước TokenlD id to k e n Chuỗi ký tự Token ID trả hàm trước Mật đăng nhập (an 10) 1.2.3 Thông diệp trả lời Cấu trúc: - Header status: - Header Content-Type:application/json;charset=ƯTF-8 - Json data Trong - Có hai khả thơng điệp trả lời: Trường họp có lỗi q trình xử lý trường hợp xử lý thành công - Trường hợp lỗi: Xem danh mục lỗi dược gửi trả lại. Truông Header status :400 Kết BadFormat: Dữ liệu nhập vào không cú pháp InvalidlnputData: Dữ liệu nhập vào cú pháp không định dạng quy định nghiệp vụ Header status :401 Unauthorized: Lỗi không xác thực Header status:500 An unexpected error occurred - Truông họp thành cỏng:Hệ thống trả về: Truong Ket qua Header status 200 Header ContentType application/json;charset=UTF-8 Json data Trả object bao gồm thuộc tính sau: + maKetQua: Trả mã kết giao dịch (Thành công, lỗi) + maGiaoDich: Mã lần eiao dịch cho việc tìm kiếm thơng tin sau 1.3 Hàm nhận kết tiếp nhận hồ SO' 1.3.1 M ô tả Request URL HMAC http://eew.baohiemxahoi.2ov.vn/aDi/e2w/nhanKOTieDNhanHS4 210 Request Method POST Request Header Content-Tvpe: application/json Query Parameters token= {token}& id_token= {id to k e n }&username= {username}& password={password}&loaiHoSo={loaiHoSo}&maCSKCB={m aCSKCB}&tuNgay={tuNgay}&denNgay={denNgay} Form data 1.3.2 Thông điêp yêu cầu Dữ liệu đầu vào Tên Field Kiểu liệu Ghi Từ ngày tuNgay Chuỗi ký tự Từ ngày (DD/MM/YYYY) Đen neày denNgay Chuỗi ký tự Đến ngày (DD/MM/YYYY) Mã CSKCB gửi maCSKCB Chuỗi ký tự Mã CSKCB gửi hồ sơ (Quy định 5084) Int Loại hồ sơ: 3: Hồ sơ KCB, 5:HỒ sơ 79/80a, 6: Hồ sơ 19, 7: Hồ sơ 20, 8: Hồ sơ 21, 9: Hồ sơ giấy chuyển tuyến Loại hô sơ loaiHoSo Tên đăng nhập Username Mật Password Chuỗi ký tự (an 5) Chuỗi ký tự (an 10) Tài khoản đăng nhập Mật đăng nhập Token Token Chuỗi ký tự Token trả từ trước TokenlD id to k e n Chuỗi ký tự Token ID trả hàm trước 1.3.3 Thông điệp trả lời Cấu trúc: - Header status: - Header Content-Type:application/json;charset=UTF-8 - Json data Trong - Có hai khả thơng điệp trả lời: trường hợp có lỗi q trình xử lý trường hợp xử lý thành cơng - Trường hợp lỗi: Xem danh mục lỗi dược gửi trả lại Truông Kết Header status :401 Unauthorized: Lỗi không xác thực Header status:500 An unexpected error occurred - Truồng họp thành công:Hệ thống trả về: T rưòng Ket Header status 200 Header ContentType application/json;charset=UTF-8 Json data Trả object bao gồm thuộc tính sau: + maKetQua: Trả mã kết giao dịch (Thành công, lỗi) + dsKQGuiHosoNgay: Danh sách object kết gửi hồ sơ theo ngày, object gồm { - ngayGui: ngày gửi hồ sơ - tongSo: tổng số hồ sơ gửi lên - soHSThanhCong: số hồ sơ thành công - soHSLoi: số hồ sơ lỗi - tongTien: Tổng tiền thành công } 1.4 Hàm nhận chi tiết hồ sơ ngày 1.4.1 Mô tả Request URL HMAC httDs://e2\v.baohiemxahoi.20v.vn/aDÌ/e2\v/nhanChiTietHSN2av42 10 Request Method POST Request Header Content-Type: application/json Query Parameters token={ token} &id_token={ id to k e n }&username={ username} &p assword={password}&loaiHoSo={loaiHoSo}&maCSKCB={maC SKCB}&ngayGui={ngayGui} Form data 1.4.2 Thông điệp yêu cầu Dữ liệu đầu vào Tên Field Kiểu liệu Ghi Ngày gửi ngayGui Chuỗi ký tự Ngày gửi hồ sơ (DD/MM/YYYY) Mã CSKCB gửi maCSKCB Chuỗi ký tự Mã CSKCB gửi hồ sơ (Quy định 5084) Loại hồ sơ loaiHoSo Tên đăne nhập Ưsemame Mật Password Loại hồ sơ: 3: Hồ sơ KCB, 5: Hồ sơ 79/80a, 6: Hồ sơ 19, 7: Hồ sơ 20, 8: Hồ sơ 21, 9: Hồ sơ giấy chuyển tuyến Int Chuỗi ký tự Tài khoản đăng nhập (an 5) Chuỗi ký tự Mật đăng nhập (an 10) Token Token Chuỗi ký tự Token trả từ trước TokenlD id to k en Chuỗi ký tự Token ID trả hàm trước 1.4.3 Thông điệp trả lời Cấu trúc: - Header status: - Header Content-Type:application/json;charset=ƯTF-8 - Json data Trong - Có hai khả thơng điệp trả lời: trường hợp có lỗi q trình xử lý trường hợp xử lý thành cơng - Trường hợp lỗi: Xem danh mục lỗi dược gửi trả lại. Truông Kết Header status :401 Unauthorized: Lồi không xác thực Header status:500 An unexpected error occurred - T ruồng họp thành công:Hệ thống trả về: Truông Két qua Header status 200 Header ContentType application/json;charset=UTF-8 Json data Trả vê object bao gồm thuộc tính sau: + maKetQua: Trả mã kết giao dịch (Thành công, lỗi) + dsHoSo: Danh sách object chi tiết giao dịch lỗi theo ngày, object gồm { - ngayGui: ngày gửi hồ sơ - maGiaoDich: mã giao dịch - soLuongHoSo: số lượng hồ sơ - slHoSoDung: số lượng hồ sơ - slHoSoLoi: số lượng hồ sơ lỗi - tongTien: Tông tiên - mieuTa: Miêu tả } 1.5 Hàm nhận chi tiết lỗi hồ SO' 1.5.1 Mơ tả Request URL HMAC httDs://eew.baohiemxahoi.20v.vn/aDÌ/eew/nhanChiTietLoiHS4 210 Request Method POST Request Header Content-Type: application/json Query Parameters token= {token}& id_token={ id to k e n }&username= {usernam e} &password={password}&maCSKCB={maCSKCB}&maGiao Dich={maGiaoDich} Form data 1.5.2 Tltông điệp yêu càU Dữ liệu đầu vào Tên Field Kiểu liệu Mã giao dịch maGiaoDich Chuỗi ký tự Mã giao dịch nhận từ service 1.10 Mã CSKCB gửi maCSKCB Chuỗi ký tự Mã CSKCB gửi hồ sơ (Quy định 5084) Tên đăng nhập Username Chuỗi ký tự (an 5) Ghi chủ Tài khoản đăng nhập Chuỗi ký tự Mật Password Token Token Chuỗi ký tự Token trả từ trước TokenlD id to k e n Chuỗi ký tự Token ID trả hàm trước (an 10) Mật đăng nhập 1.5.3 Thông điệp trả lời Cấu trúc: - Header status: - Header Content-Type:application/json;charset=UTF-8 - Json data Trong - Có hai khả thơng điệp trả lời: trường hợp có lỗi q trình xử lý trường hợp xử lý thành công - Trường hợp lỗi: Xem danh mục lỗi gửi trả lại Truông Kết Header status:401 Unauthorized: Lỗi không xác thực Header status:500 An unexpected error occurred - Trường họ p thảnh công:Hệ thống trả về: Trường Ket Header status 200 Header ContentType application/json;charset=UTF-8 Json data Trả vê object bao gồm thuộc tính sau: + maKetQua: Trả mã kết giao dịch (Thành công, lỗi) + dsLoi: Danh sách object lỗi giao dịch, object gồm { - maLoi: Mã lỗi - moTaLoi: mơ tả Lỗi } Chương trình đồng liệu (VAS) Tải chương trình đồng trang http://gdbhyt.baohiemxahoi.gov.vn/ Õ Phần mềm 81 Phàn m lm tự dồng VAS D □ Phản VSE D Net Framework 4.0 Tài ỉĩệu o Tài liệu hướng dan s dụng cổng tiếp nhân D Tài liệu hướng dẵn s đụng VSE L ) Tài liệu hướng dan s dụng Giám định BHYT Q Slide đào tạo lóp cơng tiếp nhận □ Slide tao lửp Giám dịnh Ũ Đề Idem tra Ẽ File mẫu D Hồ so XML □ File danh muc DVKT tai C SK C B õ File danh mục Thuốc tăi CSKCB ã File danh mục VTYT CSKCB Q File danh mục phụcvỊi giám định □ File mấu 79,80a □ File mẵu 19 Bước 1: Vào phần Trợ giúp, Tải phần mềm Bước 2: Nhằn vào « Phần mềm tự động đồng VAS » để tải phần mềm đồng Ghi chú: Trước cài đặt chương trình cần chắn Net Framework 4.0 cài đặt Trường hợp chưa cài đặt, chọn tải Net Framework 4.0 cài đặt 2.1 Chuẩn bị (lũ liệu Cơ sở khám chữa bệnh phải chuẩn bị hồ sơ cần thiết đề có thề đồng lên hệ thống giám định ngành 2.2 Cấu hình đồng Bật chương trình đồng để thực cấu hình Có thư mục quan trọng cần cấu hình trước thực đồng : - Thư mục 4210 : Chứa file xuất theo định 4210 - Thư mục QD917: Chứa file xuất theo định 917, chuẩn liệu 4210 - Thư mục kêt quả: Chứa file gửi thành công lên hệ thống tiếp nhận hồ sơ - Thư mục lỗi: Chứa file eửi thất bại lên hệ thống tiếp nhận hồ sơ - Thư mục tồng hợp : Chửa file tồng hợp gồm 79a,80a/19/20/21, quy tác đặt tên file : o Thống kê vật tư mẫu số 19: 19_MCSKCB_NamQTThangQT_ xlsx Ví dụ: 19_01004_201605_BENHNHANl.xlsx Nghĩa : File liệu thống kê vật tư toán BHYT tháng năm 2016 Thống kê vật tư mẫu số 20: 20_MCSKCB_NamQTThangQT_ xlsx Ví dụ: 20_01004_201605_BENHNHANl.xlsx Nghĩa : File liệu thống kê thuốc toán BHYT tháng năm 2016 o Thống kê vật tư mẫu số 21: 21_MCSKCB_NamQTThangQT_ xlsx Ví dụ: 21_01004_201605_BENHNHANl.xlsx Nghĩa : File dừ liệu thống kê dịch vụ kỹ thuật toán BHYT thána năm 2016 o Thống kê vật tư mẫu số 7980a: 7980a_MCSKCB_NamQTThangQT_ xlsx Ví dụ: 7980a_01004_201605_BENHNHANl.xlsx Nghĩa : File dừ liệu thống kê vật tư toán BHYT tháng năm 2016 - Thư mục danh mục: Chứa file hồ sơ danh mục Ngoài sở KCB cằn cấu hình « Tài khoản » « Mật » (như BHXH VN câp) để có thê đẩy dừ liệu lên hệ thống Có thê link đên kiểm tra thư mục cấu hình bàng cách: 2.3 Đồng hồ sơ đề nghị tốn © Pls3n © H è thõng giam d M h B H X K Client • ỊĐCng h i ý ủ in đinh) Chứcnẽng — □ X d? X Chương trình tự động thực chức đồng Chuẩn liệu 3.1 Quy ước biếu diễn dử liệu đặt namespace Đối vói liệu XML: Dừ liệu đặt bên thẻ XML (hay element theo thuật ngữ XML 1.1) Một thẻ chứa liệu bên khơng chứa thẻ khác gọi thẻ đơn Thẻ phức thẻ chứa thẻ không cỏ dừ liệu Trong tài liệu XML chứa dừ liệu trao đồi với hệ thống, chi có thẻ đơn hoặc/và thẻ phức (Chuẩn liệu: Unicode UTF8) Đối với liệu Excel: Các cột quy ước excel phải thứ tự tên theo quy định Chuẩn font dừ liệu Unicode UTF8) 3.2 HÒ sơ khám chữa bệnh Phần mơ tả chuẩn XML dành cho việc đóng gói liệu hồ sơ tốn BHYT Đe liên thơng với hệ thống tiếp nhận theo 03 hình thức mục II sở khám chừa bệnh BHYT phải đảm bảo kết xuất liệu theo chuẩn Cổng tiếp nhận 25 TTHUOC Á SO 15 26 TVTYT so 15 27 TTONGCHI SỐ 15 28 29 30 31 TBNTT TBNCCT TBHTT TNGUONKHAC SỐ SỐ SỐ SỐ Tông thành tiền khoản chi thuốc (kể oxy), dịch truyền, máu chế phẩm máu (đã bao gồm chi phí xét nghiệm NAT kháng thề bất thường, KIT gạn tách tiểu cầu), chi phí vận chuyền máu chi phí bao bì (đối với thuốc thang) file XML2, làm tròn số đến hai chữ số thập phân Sử dụng dấu Chấm (“.”) để phân cách số Nguyên (hàng đơn vị) với số thập phân Tồng thành tiền vật tư y tế file XML3, làm tròn số đến hai chữ số thập phân Sử dụng dấu Chấm (“.”) để phân cách số Nguyên (hàng đơn vị) với số thập phân Tồng chi phí lần khám bệnh đợt điều trị, tồng thành tiền XML2, XML3, làm tròn đến hai chữ số thập phân Sử dụng dấu Chấm để phân cách số Nguyên (hàng đơn vị) với số thập phân 15 Tông số tiền người bệnh tự trả phạm vi chi trả Quỹ BHYT XML2, XML3, làm tròn đến hai chữ số thập phân Sử dụng dấu Chấm đê phân cách số Nguyên (hàng đơn vị) với số thập phân 15 Tồng số tiền người bệnh chi trả phạm vi quyền lợi hưởng BHYT XML2, XML3, làm tròn đến hai chữ số thập phân Sử dụng dấu Chấm để phân cách số Nguyên (hàng đơn vị) với số thập phân 15 Tổng số tiền đề nghị quan bảo hiểm xã hội tốn XML2, XML3, làm tròn đên hai chữ số thập phân Sử dụng dấu Chấm để phân cách số Nguyên (hàng đơn vị) với số thập phân 15 Tồng số tiền người bệnh nguồn tài khác chi trả XML2, XML3, làm tròn đến hai chữ số thập phân Sử dụng dấu Chấm (“.”) để phân cách số Nguyên (hàng đơn vị) với số thập phân 32 T N G O A ID S Số 15 Chi phí ngồi định suất, làm tròn số đến chừ số thập phân, Sử dụns dấu Chấm (“.”) đề phân cách eiữa số Nguyên (hàng đơn vị) với số thập phân 33 NAMQT SỐ Năm đê nehị quan bảo hiểm xã hội toán 34 THANGQT Số Tháng đê nghị quan bảo hiểm xã hội toán 35 M A L O A IK C B Số 36 MAKHOA Chuỗi 37 M A C SK C B Chuỗi 38 MA_KHƯVƯC Chuỗi 39 MA_PTTT_QT 40 CAN_NANG Chuỗi Mã hóa hình thức khám bệnh, chữa bệnh (1: Khám bệnh; 2: Điều trị ngoại trú; 3: Điều trị nội trú) - Trường hợp điều trị ngoại trú bệnh mãn tính dài ngày liên tục năm gửi file XML tháng lằn (từ ngày 01 đến ngày cuối tháng) - Trường hợp điều trị ngoại trú bệnh khác gửi 01 file XML kết thúc đợt điều trị Mã khoa, bệnh nhân điều trị 15 nhiều khoa ghi mã khoa thực tổng kết hồ sơ bệnh án Mã sở khám bệnh, chừa bệnh nơi điều trị (Mã quan bảo hiểm xã hội cấp) Ghi mã nơi sinh sống thẻ "KI K2 K3" 255 số 4.2 File hồ SO' chi tiết Thuốc (XML2) Cấu trúc file XML: Mô tả chi tiêt: TT Chỉ tiêu Kiểu liệu Kích thước tối đa Diễn giải MAJLK Chuồi 15 Mã đợt điều trị (dùng để liên kết bảng tổng hợp (Bảng 1) bảne lần khám bệnh, chừa bệnh) STT Số Từ đến hết lần gửi dừ liệu DIENBIEN Chuỗi Ghi diễn biến bệnh lần khám Thêm thẻ: HOICHAN Ghi kết hội chẩn (nếu có) Chuồi Thêm thẻ: Mơ tả cách thức phẫu thuật PHAUJTHUAT NGAYYL Chuỗi Chuỗi Thêm thẻ: 12 Ngày y lệnh (gồm 13 ký tự, theo cấu trúc: yyyymmddHHmm = ký tự năm + ký tự tháng + ký tự ngày + ký tự (24 giờ) + ký tự phút) Ví dụ: ngày 31/03/2015 15:20 hiền thị là: 201503311520 Danh mục lỗi _■ _ TT Mã lỗi Nội dung lỗi 201 Định dạng xml không 202 Nội dung XML không 204 File XML khơng có nội dung 401 Lồi xác thực 408 Request TimeOut 500 Lỗi server 10 Lỗi lấy thông tin thẻ từ service so thẻ ... Form data 1.3.2 Thông điêp y u cầu Dữ liệu đầu vào Tên Field Kiểu liệu Ghi Từ ng y tuNgay Chuỗi ký tự Từ ng y (DD/MM/YYYY) Đen ne y denNgay Chuỗi ký tự Đến ng y (DD/MM/YYYY) Mã CSKCB gửi maCSKCB... quy định Bộ mã danh mục dùng chung Bộ Y tế ban hành - Mã vật tư y tế thực quy định Bộ mã danh mục dùng chung Bộ Y tế ban hành; ghi vật tư y tế chưa có cấu giá dịch vụ kỹ thuật; - Các vật tư y tế. .. và/hoặc mã bệnh y học cồ truyền bác sỹ, y sỹ y học cổ truyền chẩn đốn; có bệnh khác kèm theo ghi mã bệnh tương ứng, cách bàng dấu chấm ph y (;) 26 NGAY_YL Chuỗi 12 27 M A PTTT Số Ng y y lệnh (gồm