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
---------------

Hà Nội, ngày 30 tháng 8 năm 2017

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ế (để p/h);
- Tổng Giám đốc (để b/c);
- Các Phó Tổng Giám đốc;
- Các đơn vị: BT, CSYT, PC, VP, TT, ST, GĐB, GDN;
- 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/KQNhanLichSuKCB595

Request Method

POST

Request Header

Content-Type: application/json

Query Parameters

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

(Tham khảo mục 2)

Form data

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

{

“maThe”: { mã thẻ },

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

“ngaySinh”: { ngày sinh },

“gioiTinh”: { giới tính },

“maCSKCB”: { mã cơ sở khám chữa bệnh },

‘‘ngayBD”: { ngày bắt đầu },

“ngayKT”: { ngày kết thúc }

}

(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)

Giới tính

gioiTinh

Số

1: Nam ; 2: Nữ

Ngày bắt đầu

ngayBD

Chuỗi ký tự

Ngày bắt đầu hạn thẻ (DD/MM/YYYY)

Ngày kết thúc

ngayKT

Chuỗi ký tự

Ngày kết thúc hạn thẻ (DD/MM/YYYY)

Mã CSKCB

maCSKCB

Chuỗi ký tự

Mã CSKCB ban đầu

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:401

Unauthorized: Lỗi không được xác thực

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à một object 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)

+ hoTen: Họ tên chủ thẻ

+ gioiTinh: Giới tính chủ thẻ

+ diaChi: Địa chỉ chủ thẻ

+ maDKBD: Mã đăng ký KCB Ban đầu của chủ thẻ

+ cqBHXH: Cơ quan BHXH quản lý thu BHYT

+ gtTheTu: Giá trị thẻ từ

+ gtTheDen: Giá trị thẻ đến

+ maKV: Mã khu vực

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

+ dsLichSuKCB: Danh sách object, mỗi object bao gồm (= null nếu thông tin thẻ 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,

- tuNgay: từ ngày,

- denNgay: đến ngày,

- tenBenh: tên bệnh,

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

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

}

Mã kết quả

Mô tả

000

Thông tin thẻ chính xác

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

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

Khong thay thong tin the bhyt

060

Thẻ sai họ tên

061

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

070

Thẻ sai ngày sinh

080

Thẻ sai giới tính

090

Thẻ sai nơi đăng ký KCB ban đầu

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ẻ