Giải pháp thực hiện

I. TỔNG QUAN

1. Mô tả nghiệp vụ

  • 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ố
  • APITraCuuThongTinDoanhNghiep hỗ trợ phần mềm tại đơn vị kết nối vào Nền tảng HCM LGSP tra cứu thông tin doanh nghiệp từ CSDL dùng chung của Thành phố

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 thông tin doanh nghiệp về CSDL dùng chung của Thành phố.

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 tra cứu thông tin doanh nghiệp về CSDL dùng chung của Thành phố.

 II. MÔ HÌNH KẾT NỐI

1. Mô hình kết nối tra cứu thông tin doanh nghiệp

 

 Hình 1: Mô hình kết nối tra cứu thông tin doanh nghiệp

  • 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ố.
  • APITraCuuThongTinDoanhNghiep hỗ trợ phần mềm tại đơn vị kết nối vào Nền tảng HCM LGSP tra cứu thông tin doanh nghiệp từ CSDL dùng chung của Thành phố.
  1.  

2. Quá trình trao đổi gói tin

Hình 2: Quy trình trao đổi gói tin                            

  • Bước 1: Phần mềm của đơn vị đóng gói dữ liệu về dạng JSON.
  • Bước 2: Phần mềm của đơn vị gọi đến Nền tảng HCM LGSP thông qua api kèm theo access token.
  • Bước 3: Nền tảng HCM LGSP kiểm tra access token của đơn vị. Nếu thất bại sẽ trả về gói tin JSON lỗi cho phần mềm của đơn vị.
  • Bước 4: Nền tảng HCM LGSP xử lý dữ liệu và trả về gói tin JSON kết quả cho phần mềm đơn vị.

III. ĐẶC TẢ API TRA CỨU THÔNG TIN DOANH NGHIỆP

1. Thông tin kết nối

Kiểu

Diễn giải

Ví dụ

Địa chỉ adapter Nền tảng HCM thử nghiệm

Địa chỉ cổng dịch vụ chính thức

https://hcmesb-test.tphcm.gov.vn

Địa chỉ adapter Nền tảng HCM chính

Địa chỉ cổng dịch vụ thử nghiệm

https://hcmlgsp.tphcm.gov.vn

AccessKey

Khóa

rTkhYCBwHM

SecretKey

Khóa bí mật

DWkQgY1YSS

AppName

Đơn vị kết nối

TPHCM

PartnerCode

Mã đơn vị cung cấp ứng dụng

000.00.01.H29

PartnerCodeCus

Mã đơn vị sử dụng dịch vụ

000.00.01.H29

Authorization

Khai báo trong Header, Là chuỗi gồm 5 tham số dạng json được mã hóa thành StringBase64

ewoiQWNjZXNzS2V5IjoiclRraFlDQndITSIsCiJTZWNy

ZXRLZXkiOiJEV2tRZ1kxWVNTIiwKIkFwcE5hbWUiOi

AiVFBIQ00iLAoiUGFydG5lckNvZGUiOiAiMDAwLjAwLjA

xLkgyOSIsCiJQYXJ0bmVyQ29kZUN1cyI6ICIwMDAuM

DAuMDEuSDI5Igp9Cg==

được stringbase64 từ:

{

"AccessKey":"rTkhYCBwHM",

"SecretKey":"DWkQgY1YSS",

"AppName": "TPHCM",

"PartnerCode": "000.00.01.H29",

"PartnerCodeCus": "000.00.01.H29"

}

Bảng 1: bảng thông tin kết nối

2. API tra cứu thông tin doanh nghiệp

  • Đường dẫn: /TraCuuThongTinDoanhNghiep
  • Method: GET
  • Đầu vào:
    • Header: Authorization
    • Param:
      • MaSoDoanhNghiep : string
  • Đầu ra:
    • Chuỗi json chứa thông tin trả về

 

STT

Tham số

Thuộc tính tham số

Mô tả

1

StatusCode   

Int

Mã trạng thái gói tin

- 200: Request đã được tiếp nhận và xử lý thành công

- 400: Request bị lỗi hoặc không thể xử lý

- 404: Tài nguyên không tồn tại

- 500: Lỗi trong quá trình xử lý

2

Description

String

Nội dung lỗi trả về

3

ResultObject

JSON

Chuỗi json trả về tại mục 3.3

4

ResultType

String

Type của gói tin trả về Mặc định là “JSON”

5

Status

String

Trạng thái gói tin“SUCCESS” hoặc “FAIL”

6

ThrowException

bool

 Có lỗi xảy ra hay không

Bảng 3: tham số trả về của chuỗi json

Ví dụ:

Thành công

Lỗi

{

    "Description": null,

    "ResultObject": {

        "BUSI_LIINE_ALL": "Bán buôn chuyên doanh khác chưa được phân vào đâu chi tiết: mua bán hàng thủ công mỹ nghệ; Bán buôn đồ uống chi tiết: Mua bán rượu, bia, nước ngọt, nước khoáng,nước tinh khiết.; Bán buôn gạo chi tiết: Mua bán lương thực.; Bán buôn máy móc, thiết bị và phụ tùng máy khác chi tiết: Mua bán máy móc, thiết bị dụng cụ, vật tư liên quan ngành nhà hàng-khách sạn-du lịch.; Bán buôn thực phẩm chi tiết: mua bán thực phẩm; Bán lẻ hàng hóa khác mới trong các cửa hàng chuyên doanh chi tiết: mua bán đồ nữ trang; Cho thuê xe có động cơ chi tiết: Cho thuê ôtô. ; Đại lý du lịch Chi tiết: Dịch vụ du lịch lữ hành nội địa.; Dịch vụ lưu trú ngắn ngày Chi tiết: Kinh doanh cơ sở lưu trú du lịch: Khách sạn (Không hoạt động tại trụ sở).; Kinh doanh bất động sản, quyền sử dụng đất thuộc chủ sở hữu, chủ sử dụng hoặc đi thuê chi tiết: Kinh doanh nhà. Cho thuê nhà ở, văn phòng, nhà xưởng kho bãi.\r\n; Nhà hàng và các dịch vụ ăn uống phục vụ lưu động Chi tiết: Kinh doanh nhà hàng ăn uống (Không hoạt động tại trụ sở).; Sản xuất đồ kim hoàn và chi tiết liên quan chi tiết: Sản xuất hàng nữ trang (trừ gia công cơ khí, tái chế phế thải, xi mạ điện) ; Sản xuất khác chưa được phân vào đâu chi tiết: Sản xuất hàng thủ công mỹ nghệ (trừ tái chế phế thải, gia công cơ khí, xi mạ điện, chế biến gỗ, sản xuất gốm, sứ, thủy tinh tại trụ sở).; ",

        "ENTERPRISE_GDT_CODE": "0302345794",

        "ENTERPRISE_STATUS_NAME": "Bị khóa",

        "ENTERPRISE_TYPE_NAME": "Công ty trách nhiệm hữu hạn một thành viên",

        "FOUNDING_DATE": "28/06/2001",

        "HO_ADDRESS_FULLTEXT": "31 Nguyễn Văn Thủ, Phường Đa Kao, Quận 1, Thành phố Hồ Chí Minh, Việt Nam",

        "NAME": "CÔNG TY TNHH VẠN NĂM ",

        "NAME_F": null,

        "SHORT_NAME": null

    },

    "ResultType": "JSON",

    "Status": "SUCCESS",

    "StatusCode": 200,

    "ThrowException": false

}

{

    "StatusCode": 500,

    "Description": "Tham số đầu vào không đúng",

    "ResultObject": null,

    "ResultType": null,

    "Status": "FAIL",

    "ThrowException": true

}         

 3. Gói tin thông tin doanh nghiệp

STT

Tên trường

Định Dạng

Mô tả

  1.  

NAME

String

Tên doanh nghiệp viết bằng tiếng Việt

  1.  

NAME_F

String

Tên doanh nghiệp viết bằng tiếng nước ngoài

  1.  

SHORT_NAME

String

Tên doanh nghiệp viết tắt

  1.  

ENTERPRISE_GDT_CODE

String

Mã số doanh nghiệp

  1.  

FOUNDING_DATE

String

Ngày bắt đầu thành lập

  1.  

BUSI_LIINE_ALL

String

Tên ngành, nghề kinh doanh

  1.  

ENTERPRISE_TYPE_NAME

String

Loại hình pháp lý doanh nghiệp

  1.  

ENTERPRISE_STATUS_NAME

String

Tình trạng hoạt động của doanh nghiệp

  1.  

HO_ADDRESS_FULLTEXT

String

Địa chỉ trụ sở chính của doanh nghiệp

Bảng 6: Gói tin thông tin doanh nghiệp

Ví dụ:

{

    "Description": null,

    "ResultObject": {

        "BUSI_LIINE_ALL": "4511: Bán buôn ô tô và xe có động cơ khác-Chi tiết: Thực hiện quyền xuất khẩu, quyền nhập khẩu, quyền phân phối bán buôn (không thành lập cơ sở bán buôn) ô tô mới, ô tô đã qua sử dụng đối với các sản phẩm có mã HS 8703 (CPC 6111, 6113);4512: Bán lẻ ô tô con (loại 9 chỗ ngồi trở xuống)-Chi tiết: Thực hiện quyền xuất khẩu, quyền nhập khẩu, quyền phân phối bán lẻ (thành lập cơ sở bán lẻ) ô tô mới, ô tô đã qua sử dụng đối với các sản phẩm có mã HS 8703 (CPC 6111, 6113); 4530: Bán phụ tùng và các bộ phận phụ trợ của ô tô và xe có động cơ khác-Chi tiết: Thực hiện quyền xuất khẩu, quyền nhập khẩu, quyền phân phối bán buôn (không thành lập cơ sở bán buôn), quyền phân phối bán lẻ (thành lập cơ sở bán lẻ) phụ tùng thay thế đối với các sản phẩm có mã HS 8703, 8708 (CPC 6111, 6113); 4520: Bảo dưỡng, sửa chữa ô tô và xe có động cơ khác-Chi tiết: Cung cấp dịch vụ sau bán hàng bao gồm bảo hành, bảo trì, sửa chữa và sửa chữa đại tu đối với ô tô mang thương hiệu Ferrari do doanh nghiệp nhập khẩu và phân phối (CPC 6112);6810: Kinh doanh bất động sản, quyền sử dụng đất thuộc chủ sở hữu, chủ sử dụng hoặc đi thuê-Chi tiết: Thực hiện theo Điều 11 Luật kinh doanh bất động sản;4513: Đại lý ô tô và xe có động cơ khác-Chi tiết: Dịch vụ đại lý hoa hồng (CPC 621);  Doanh nghiệp có vốn đầu tư nước ngoài có trách nhiệm thực hiện thủ tục đầu tư theo quy định của Luật Đầu tư và Pháp luật có liên quan. Doanh nghiệp phải thực hiện đúng các quy định của pháp luật về đất đai, xây dựng, phòng cháy chữa cháy, bảo vệ môi trường, các quy định khác của pháp luật hiện hành và các điều kiện kinh doanh đối với ngành nghề kinh doanh có điều kiện. \r\nĐối với các trường hợp phải cấp Giấy phép kinh doanh để thực hiện hoạt động mua bán hàng hóa và các hoạt động liên quan trực tiếp đến mua bán hàng hóa theo quy định tại Nghị định số 09/2018/NĐ-CP ngày 15 tháng 01 năm 2018 của Chính phủ về việc quy định chi tiết Luật Thương mại và Luật Quản lý ngoại thương về hoạt động mua bán hàng hóa và các hoạt động liên quan trực tiếp đến mua bán hàng hóa của nhà đầu tư nước ngoài,  tổ chức kinh tế có vốn đầu tư nước ngoài tại Việt Nam, Tổ chức kinh tế thực hiện dự án đầu tư có trách nhiệm liên hệ Sở Công Thương để thực hiện thủ tục cấp Giấy phép kinh doanh, Giấy phép lập cơ sở bán lẻ (nếu có) theo đúng quy định trước khi hoạt động kinh doanh (trừ các trường hợp không phải cấp Giấy phép kinh doanh quy định tại Điều 6, Điều 50 Nghị định số 09/2018/NĐ-CP);",

        "ENTERPRISE_GDT_CODE": "0315509337",

        "ENTERPRISE_STATUS_NAME": "Đang hoạt động",

        "ENTERPRISE_TYPE_NAME": "Công ty trách nhiệm hữu hạn một thành viên",

        "FOUNDING_DATE": "31/01/2019",

        "HO_ADDRESS_FULLTEXT": "Tòa nhà EMall, Lô J1.20b-21, đường số 7, khu Thương mại Nam, Khu Chế xuất Tân Thuận, Phường Tân Thuận Đông, Quận 7, Thành phố Hồ Chí Minh, Việt Nam",

        "NAME": "CÔNG TY TNHH VINA ASC AUTOMOTIVE",

        "NAME_F": "VINA ASC AUTOMOTIVE COMPANY LIMITED",

        "SHORT_NAME": "VINA ASC AUTOMOTIVE"

    },

    "ResultType": "JSON",

    "Status": "SUCCESS",

    "StatusCode": 200,

    "ThrowException": false

}

Danh sách tệp tin đính kèm

  • DacTaLienThong_APITraCuuThongTinDoanhNghiep_v1.1.docx