I. TỔNG QUAN
1. Mô tả nghiệp vụ
- Phần mềm ISO điện tử khi có nhu cầu tra cứu hộ cá thể đã đăng ký kinh doanh hay chưa thì sẽ gọi api kiếm tra thông tin đăng ký kinh doanh lên Nền tảng HCM LGSP (API_kiemtraDKKD_HCT)
- HCM LGSP sẽ kiểm tra trong kho dữ liệu ĐKKD thông tin hộ cá thể được kiểm tra đã đăng ký kinh doanh trên TPHCM chưa và sẽ trả thông tin về cho đơn vị.
2. Mục đích tài liệu
- Tài liệu này nhằm hướng dẫn đơn vị tra cứu hộ cá thể đã có đăng ký kinh doanh hay chưa.
3. Phạm vi và đối tượng áp dụng
- Tài liệu này được sử dụng bởi các kỹ thuật viên của các đơn vị cần dữ liệu ĐKKD từ chuẩn CSDL dùng chung của Thành phố.
4. Thông tin kết nối
- Đơn vị cần kết nối liên hệ sở Thông tin và Truyền thông để được cung cấp thông tin kết nối bao gồm:
- AppName
- AccessKey
- SecretKey
II. MÔ HÌNH KẾT NỐI
1. Mô hình kết nối kiểm tra thông tin đăng ký kinh doanh
Hình 1: Mô hình kết nối kiểm tra thông tin đăng ký kinh doanh
- CSDL Dùng chung là nơi tập trung toàn bộ kho dữ liệu dùng chung của TPHCM. Cơ quan, tổ chức có thể thực hiện việc khai thác và đồng bộ dữ liệu về CSDL Dùng chung của Thành phố thông qua Nền tảng HCM LGSP.
- Nền tảng HCM LGSP đảm nhiệm vai trò chính trong việc cung cấp các thông tin kết nối đến các phần mềm tại đơn vị, khai thác và đồng bộ dữ liệu từ CSDL tập trung của thành phố.
- API_kiemtraDKKD_HCT hỗ trợ phần mềm kết nối vào Nền tảng HCM LGSP lấy bộ danh mục Dân tộc chuẩn từ CSDL dùng chung của Thành phố.
2. Quá trình trao đổi gói tin
Căn cứ khoản 2 điều 67 NĐ: 78/2015/NĐ-CP
Điều 67. Quyền thành lập hộ kinh doanh và nghĩa vụ đăng ký của hộ kinh doanh
2. Cá nhân, hộ gia đình quy định tại Khoản 1 Điều này chỉ được đăng ký một hộ kinh doanh trong phạm vi toàn quốc. Cá nhân quy định tại Khoản 1 Điều này được quyền góp vốn, mua cổ phần trong doanh nghiệp với tư cách cá nhân.
- Bước 1: Tại màn hình tiếp nhận của phần mềm MCĐT và màn hình thụ lý phần mềm ĐKKD bổ sung thêm nút “kiểm tra” thông tin ĐKKD..
- Bước 2: Hệ thống MCĐT và ĐKKD truyền Params (CMND/Hộ chiếu...) vào API_KiemtraDKKD_HCT do LGSP cung cấp.
- Bước 3: API kiểm tra trong kho dữ liệu ĐKKD thông tin người được kiểm tra đã có đăng ký kinh doanh trên địa bàn TPHCM chưa.
- Bước 4: API trả về thông tin kết quả kiểm tra cho hệ thống MCDT và ĐKKD.
- Bước 5: Hệ thống MCĐT và ĐKKD nhận kết quả và thông báo cho người dùng
III. ĐẶC TẢ API KIỂM TRA ĐKKD HỘ CÁ THỂ
1. Thông tin kết nối
|
Kiểu
|
Diễn giãi
|
Ví dụ
|
|
Địa chỉ adapter Nền tảng HCM chính
|
Địa chỉ cổng dịch vụ dự kiến chính thức
|
https://api-dip.tphcm.gov.vn/api/kdhct/getByCMND
|
|
Địa chỉ adapter Nền tảng HCM thử nghiệm
|
Địa chỉ cổng dịch vụ thử nghiệm
|
https://api-dip.tphcm.gov.vn/api/kdhct/getByCMND
|
Bảng 1: bảng thông tin kết nối
2. API kiểm tra đăng ký kinh doanh hộ cá thể
- Đường dẫn: ://api-dip.tphcm.gov.vn/api/kdhct/getByCMND
- Method: POST
- Đầu vào:
- Param
- socmnd = <<Số giấy tờ tùy thân>>
- apikey = b884e69c8e41f880b63e3130139c8808"
- Đầu ra:
- chuỗi json chứa thông tin trả về, resultObject là chuỗi json array chứa thông tin danh mục, chi tiết dữ liệu tại mục 3.3
|
STT
|
Tên trường
|
Định dạng
|
Mô tả
|
|
1
|
cmnd
|
String
|
Số cmnd
|
|
2
|
hoTen
|
String
|
Tên
|
|
3
|
mst
|
String
|
mã số thuế
|
|
4
|
soGiayPhep
|
String
|
|
|
5
|
banHieu
|
String
|
|
|
6
|
quan
|
String
|
Tên quận
|
|
7
|
diaChi
|
String
|
Địa chỉ
|
Bảng 2: tham số trả về của chuỗi json
Ví dụ:
|
Thành công
|
Lỗi
|
|
{
"cmnd": 011945275,
"hoTen": "Nguyễn Đức Hạnh",
"mst": 0100605001,
"soGiayPhep": null,
"banHieu": null,
"quan": “Quận 1”,
“diaChi”:”Vincom Center Đồng Khởi Số 72 Lê Thánh Tôn”
}
|
{
"error_code": 400,
"error_message": “Param error”,
"data": null
}
|
-
3. Gói tin trả về
|
STT
|
Tên trường
|
Định dạng
|
Mô tả
|
|
1
|
cmnd
|
String
|
Số cmnd
|
|
2
|
hoTen
|
String
|
Tên
|
|
3
|
mst
|
String
|
mã số thuế
|
|
4
|
soGiayPhep
|
String
|
|
|
5
|
banHieu
|
String
|
|
|
6
|
quan
|
String
|
Tên quận
|
|
7
|
diaChi
|
String
|
Địa chỉ
|
Bảng 3: Gói tin danh mục dân tộc
Ví dụ:
{
"Ma": "01",
"MoTa": "Kinh",
"Ten": "Kinh (Việt)",
"Used": true
}