account_circle
date_range
BẢO HIỂM XÃ HỘI#
1. API tra cứu thông tin hộ gia đình từ mã số bảo hiểm xã hội#
1. Request Header
- URL: ***/ngsp/BaoHiemXaHoi/TraCuuThongTinHoGiaDinh
- Method:: POST
- Authorization: Bearer 'token'
- Content-Type: application/json
2. Request body
{
"maSoBhxh": "Mã số BHXH cần tra cứu thông tin hộ gia đình",
}3. Response body
{
"code": "Mã trạng thái HTTP trả về", // Tham khảo phụ lục
"status": "Mã trạng thái xử lý trả về", // Tham khảo phụ lục
"correlationId": "Mã correlationId dành cho người lập trình trong quá trình kiểm tra kết nối",
"response": {
"TST_GetTraCuuTtHgdByMaSoBhxhResponse": {
"successful": {
"dataThongTinHgd": {
"hoTen": "Họ tên",
"soSoCu": "Số sổ BHXH cũ",
"ngaySinh": "Ngày tháng năm sinh theo thứ tự Năm – tháng – ngày viết liền. vd: 19890812",
"loaiNgaySinh": "Nhận 3 giá trị:
0: đầy đủ ngày, tháng, năm sinh;
1: chỉ có năm sinh;
2: chỉ có năm, tháng sinh",
"gioiTinh": "Nhận 3 giá trị:
1: Nam;
2: Nữ;
3: Khác",
"maTinhKs": "Mã tỉnh theo quy định của tổng cục thống kê",
"maHuyenKs": "Mã huyện theo quy định của tổng cục thống kê",
"maXaKs": "Mã xã theo quy định của tổng cục thống kê",
"trangThai": "Trạng thái"
},
"errorCode": "Mã trạng thái lỗi trả về"
}
}
}
}2. API lấy mã số bảo hiểm theo tiêu chí#
1. Request Header
- URL: ***/ngsp/BaoHiemXaHoi/TraCuuMaSoBhxhTheoTieuChi
- Method:: POST
- Authorization: Bearer 'token'
- Content-Type: application/json
2. Request body
{
"hoTen":"Họ tên",
"ngaySinh":"Ngày tháng năm sinh theo thứ tự Năm – tháng – ngày viết liền. vd: 19890812",
"loaiNgaySinh":"Nhận 3 giá trị:
0: đầy đủ ngày, tháng, năm sinh
1: chỉ có năm sinh
2: chỉ có năm, tháng sinh",
"gioiTinh":"Nhận 3 giá trị:
1: Nam
2: Nữ
3: Khác",
"maTinhKs":"Mã tỉnh theo quy định của tổng cục thống kê",
"maHuyenKs":"Mã huyện theo quy định của tổng cục thống kê",
"maXaKs":"Mã xã theo quy định của tổng cục thống kê",
"isKs":"Nhận 2 giá trị:
1: tra cứu theo địa chỉ khai sinh
0: tra cứu theo địa chỉ hộ khẩu"
}3. Response body
{
"code": "Mã trạng thái HTTP trả về", // Tham khảo phụ lục
"status": "Mã trạng thái xử lý trả về", // Tham khảo phụ lục
"correlationId": "Mã correlationId dành cho người lập trình trong quá trình kiểm tra kết nối",
"response": {
"TST_GetMaSoBhxhTheoTieuChiResponse": {
"successful": {
"maSoBhxh": "Mã số BHXH",
"trangThai": "Trạng thái",
"errorCode": "Mã lỗi"
}
}
}3. API tra cứu thông tin hộ gia đình#
1. Request Header
- URL: ***/ngsp/BaoHiemXaHoi/XacMinhThongTinNguoiDung
- Method:: POST
- Authorization: Bearer 'token'
- Content-Type: application/json
2. Request body
{
"maTinh":"Mã tỉnh theo quy định của tổng cục thống kê",
"hoTen":"Họ tên",
"ngaySinh":"Ngày tháng năm sinh theo thứ tự Năm – tháng – ngày viết liền. vd: 19890812",
"loaiNgaySinh":"Nhận 3 giá trị:
0: đầy đủ ngày, tháng, năm sinh
1: chỉ có năm sinh
2: chỉ có năm, tháng sinh",
"gioiTinh":"Nhận 3 giá trị:
1: Nam
2: Nữ
3: Khác",
"soSo":"Số sổ BHXH",
"maThe":"Mã thẻ BHXH",
"isKs":"Nhận 2 giá trị:
1: tra cứu theo địa chỉ khai sinh
0: tra cứu theo địa chỉ hộ khẩu"
}3. Response body
{
"code": "Mã trạng thái HTTP trả về", // Tham khảo phụ lục
"status": "Mã trạng thái xử lý trả về", // Tham khảo phụ lục
"correlationId": "Mã correlationId dành cho người lập trình trong quá trình kiểm tra kết nối",
"response": {
"TST_GetTraCuuThongTinHgdResponse": {
"successful": {
"resultThongTinHgd": {
"maSo": "Mã số",
"hoTen": "Họ tên",
"gioiTinh": "Nhận 3 giá trị:
1: Nam
2: Nữ
3: Khác",
"ngaySinh": "Ngày tháng năm sinh theo thứ tự Năm – tháng – ngày viết liền. vd: 19890812",
"loaiNgaySinh": "Nhận 3 giá trị:
0: đầy đủ ngày, tháng, năm sinh
1: chỉ có năm sinh
2: chỉ có năm, tháng sinh",
"maHo": "Mã hộ gia đình",
"diaChi": "Địa chỉ",
"trangThai": "Trạng thái"
},
"errorCode": "00"
}
}
}4. API xác thực, xác minh thông tin người sử dụng#
1. Request Header
- URL: ***/ngsp/BaoHiemXaHoi/XacMinhThongTinNguoiDung
- Method:: POST
- Authorization: Bearer 'token'
- Content-Type: application/json
2. Request body
{
"maBaoHiem":"Mã bảo hiểm (Mã số BHXH)",
"hoVaTenDem":"Họ và tên đệm",
"ten":"Tên",
"soDinhDanh":"Số định danh (Số cmnd, hộ chiếu)",
"loaiDinhDanh":"Loại định danh (length = 9 : 1, length = 12 : 2)",
"ngaySinh":"Ngày sinh – dd",
"thangSinh":"Tháng sinh – MM",
"namSinh":"Năm sinh – yyyy",
"soDiDong":"Số điện thoại",
"email":"Email"
}3. Response body
{
"code": "Mã trạng thái HTTP trả về", // Tham khảo bên dưới
"status": "Mã trạng thái xử lý trả về", // Tham khảo bên dưới
"correlationId": "Mã correlationId dành cho người lập trình trong quá trình kiểm tra kết nối",
"response": {
"TST_CheckVssInforResponse": {
"successful": {
"maGiaoDich": "Thông tin từ request",
"maBaoHiem": "Thông tin từ request",
"trangThai": "Trạng thái (có nhân khẩu: 1, không có nhân khẩu: 2)",
"hoVaTenDem": "So sánh thông tin request với thông tin select trong database (DB HGD)
+ True: đúng
+ False: không đúng
",
"ten": true,
"soDinhDanh": true,
"loaiDinhDanh": true,
"ngaySinh": true,
"thangSinh": true,
"namSinh": true,
"soDiDong": false,
"email": false
}
}
}
}