Công văn 366/BHXH-CNTT năm 2018 về bổ sung hàm tra cứu trên Hệ thống thông tin giám định bảo hiểm y tế do Bảo hiểm xã hội Việt Nam ban hành

BẢO HIỂM XÃ HỘI VỆ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ố: 366/BHXH-CNTT
V/v bổ sung hàm tra cứu trên Hệ thống thông tin giám định bảo hiểm y tế

Hà Nội, ngày 31 tháng 01 năm 2018

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)

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

KT. TỔNG GIÁM ĐỐC
PHÓ TỔNG GIÁM ĐỐC




Phạm Lương Sơn

Request URL

HMAC http://egw.baohiemxahoi.gov.vn/api/egw/NhanThongTinCSKCB

Request Method

POST

Request Header

Content-Type: application/json

Query Parameters

username= {username} &password= {password} &token= {token} &id_token={id_token}&macskcb={ macskcb } (Tham khảo mục 2)

Form data

Dữ liệu đầu vào

Tên Field

Kiểu dữ liệu

Ghi chú

Mã cơ sở KCB

macskcb

Chuỗi ký tự

Mã cơ sở khám chữa bệnh cần tra cứu

Tên đăng nhập

username

Chuỗi ký tự

Tài khoản đăng nhập

Mật khẩu

password

Chuỗi ký tự

Mật khẩu đăng nhập

Token

token

Chuỗi ký tự

Token được trả về từ trước

TokenlD

id_token

Chuỗi ký tự

Token ID được trả về ở hàm trước

Trường

Kết quả

Header status:500

An unexpected error occurred

Trường

Kết quả

Header status

200

Header Content- Type

application/json;charset=UTF-8

Json data

Trả về là object KQNhanThongTinCSKCB bao gồm các thuộc tính sau:

+ maketqua: Trả về mã kết quả giao dịch (Thành công, lỗi)

+ message: Thông báo

+ macskcb: Mã cơ sở khám chữa bệnh

+ ten: Tên cơ sở

+ hang: Hạng bệnh viện (0-đặc biệt, 1-hạng 1,2-hạng 2,3-hạng3,4- hạng 4,5-chưa phân hạng)

+ tuyen: Tuyến chuyên môn kỹ thuật (1-trung ương,2-tỉnh,3- huyện,4-xã)

+ diachi: Địa chỉ

+ tenchuquan: Tên cơ quan chủ quản

+ ngaysua: Ngày sửa

+ macha: Mã cơ sở cha

+ hieuluc: Hiệu lực (1 - có,0 - không)

+ ngayngunghoatdong: Ngày ngừng hoạt động

+ matinh: Mã tỉnh

+ mahuyen: Mã huyện

Mã kết quả

Mô tả

200

Nhận thông tin thành công

205

Sai định dạng tham số truyền vào

206

Không tìm thấy thông tin cơ sở

401

Lỗi xác thực tài khoản

500

Lỗi server

Request URL

HMAC

http://egw.baohiemxahoi.gov.vn/api/egw/NhanLichSuKCB2018

Request Method

POST

Request Header

Content-Type: application/json

Query Parameters

token= {token} &id_token= {id_token} &username={username} &password= {password}

(Tham khảo mục 2)

Form data

Đối tượng “theBHYT2018” bao gồm

{

“maThe”: { mã thẻ },

“hoTen”: ( họ tên },

“ngaySinh”: { ngày sinh }

}

(Tham khảo mục 2)

Dữ liệu đầu vào

Tên Field

Kiểu dữ liệu

Ghi chú

Mã thẻ

maThe

Chuỗi ký tự

Mã thẻ

Họ tên

hoTen

Chuỗi ký tự

Họ tên chủ thẻ

Ngày sinh

ngaySinh

Chuỗi ký tự

Ngày sinh (DD/MM/YYYY) /Trường hợp chỉ có năm sinh (YYYY).

Tên đăng nhập

username

Chuỗi ký tự (an 5)

Tài khoản đăng nhập

Mật khẩu

password

Chuỗi ký tự (an 6.. 10)

Mật khẩu đăng nhập

Token

token

Chuỗi ký tự

Token được trả về từ trước

TokenlD

id token

Chuỗi ký tự

Token ID được trả về ở hàm trước

Trường

Kết quả

Header status:500

An unexpected error occurred

Trường

Kết quả

Header status

200

Header Content-Type

application/json;charset=UTF-8

Json data

Trả về là object KQNhanLichSuKCB2018 bao gồm các thuộc tính sau:

+ maKetQua: Trả về mã kết quả giao dịch (Thành công, lỗi)

+ ghiChu: Ghi chú

+ maThe: Mã thẻ hiện tại

+ hoTen: Họ tên

+ ngaySinh: ngày sinh

+ gioiTinh: giới tính

+ diaChi: Địa chỉ

+ maDKBD: Mã đăng kí ban đầu

+ cqBHXH: Tên cơ quan bảo hiểm xã hội

+ gtTheTu: Thời gian thẻ có giá trị sử dụng

+ gtTheDen: Hạn thẻ

+ maKV: Mã khu vực

+ ngayDu5Nam: Ngày đủ năm năm liên tục

+ maSoBHXH: Mã số

+ maTheCu: Mã thẻ cũ

+ maTheMoi: Mã thẻ mới

+ gtTheTuMoi: Thời gian thẻ mới có giá trị sử dụng

+ gtTheDenMoi: Hạn thẻ mới

+ dsLichSuKCB2018: Danh sách object lịch sử khám chữa bệnh, mỗi object bao gồm (= null nếu thông tin thẻ không chính xác)

{

- maHoSo: mã hồ sơ, để tra cứu thông tin chi tiết

- maCSKCB: mã cơ sở khám chữa bệnh,

- ngayVao: ngày vào (định dạng yyyyMMddhhmm),

- ngayRa: ngày ra (định dạng yyyyMMddhhmm),

- tenBenh: tên bệnh,

- tinhTrang: tình trạng ra viện,

- kqDieuTri: kết quả điều trị

}

+ dsLichSuKT2018: Danh sách object lịch sử tra cứu thẻ, mỗi object bao gồm (= null nếu thông tin thẻ không chính xác)

{

- userKT: user tra cứu

- thoiGianKT: thời gian tra cứu (định dạng yyyyMMddhhmm),

- thongBao: thông báo

- maLoi: mã lỗi

}

Mã kết quả

Mô tả

000

Thẻ còn giá trị sử dụng

001

Thẻ do BHXH Bộ Quốc Phòng quản lý, đề nghị kiểm tra thẻ và thông tin giấy tờ tùy thân

002

Thẻ do BHXH Bộ Công An quản lý, đề nghị kiểm tra thẻ và thông tin giấy tờ tùy thân

003

Thẻ cũ hết giá trị sử dụng nhưng đã được cấp thẻ mới

004

Thẻ cũ còn giá trị sử dụng nhưng đã được cấp thẻ mới

010

Thẻ hết giá trị sử dụng

051

Mã thẻ không đúng

052

Mã tỉnh cấp thẻ(kí tự thứ 4,5 của mã thẻ) không đúng

053

Mã quyền lợi thẻ(kí tự thứ 3 của mã thẻ) không đúng

050

Không thấy thông tin thẻ bhyt

060

Thẻ sai họ tên

061

Thẻ sai họ tên(đúng kí tự đầu)

070

Thẻ sai ngày sinh

100

Lỗi khi lấy dữ liệu sổ thẻ

101

Lỗi server

110

Thẻ đã thu hồi

120

Thẻ đã báo giảm

121

Thẻ đã báo giảm. Giảm chuyển ngoại tỉnh

122

Thẻ đã báo giảm. Giảm chuyển nội tỉnh

123

Thẻ đã báo giảm. Thu hồi do tăng lại cùng đơn vị

124

Thẻ đã báo giảm. Ngừng tham gia

130

Trẻ em không xuất trình thẻ

205

Lỗi sai định dạng tham số truyền vào

401

Lỗi xác thực tài khoản