Giấy chứng nhận đăng kí doanh nghiệp#

Cung cấp phương thức để trích xuất thông tin trên Giấy chứng nhận đăng kí doanh nghiệp từ ảnh chụp hoặc file PDF.

API ở mục này sẽ trả về những thông tin dữ liệu trích xuất được từ một hoặc nhiều trang giấy tờ. Các thông tin được trích xuất bao gồm:

  • Thông tin của doanh nghiệp :

Tên trường

Ý nghĩa

authorized_capital

Vốn điều lệ

business_code

Mã số doanh nghiệp

company_address

Địa chỉ trụ sở chính

company_foreign_name

Tên công ty viết bằng tiếng nước ngoài

company_name

Tên công ty

company_phone

Số điện thoại

company_short_name

Tên công ty viết tắt

email

Địa chỉ email

fax

Số fax

first_register

Ngày đăng ký lần đầu

header

Tiêu đề của giấy tờ

par_value

Mệnh giá cổ phần

total_shares

Tổng số cổ phần

website

Địa chỉ website

  • Thông tin người đại diện theo pháp luật của công ty:

Tên trường

Ý nghĩa

birthday

Ngày/tháng/năm sinh

contact_address

Địa chỉ liên lạc (hiện tại)

ethnicity

Dân tộc

gender

Giới tính

id_address

Địa chỉ đăng ký hộ khẩu thường trú

id_issue_date

Ngày cấp giấy tờ tùy thân

id_issue_at

Nơi cấp giấy tờ tùy thân

id_number

Số giấy tờ tùy thân

id_type

Loại giấy tờ tùy thân

name

Tên đầy đủ

nationality

Quốc tịch

title

Chức danh

Request

Gọi vào API POST /business-registration, kèm theo các thông tin tối thiểu sau:

  • Request body:

    • files: một mảng các file dưới dạng byte.

Các querry param bao gồm:

  • selected_pages: danh sách các trang tài liệu chứa nội dung cần thiết

Ví dụ

CLI:

curl -X 'POST' 'https://api-uat.unicloud.ai/ekyc/business-registration' -u $MY_AUTH -F 'files=@path_to_file'

Response:

{
  "id": "a72555af-2154-42d9-5hg9-5f92c71aaa9c",
  "linked_file_ids": [
      "72948b59-g5ty-4700-55hg-9ca0d060635b"
  ],
  {
    "recognized_data": {
      "doc_type": "COMPANY REGISTRATION",
      "authorized_capital": "30.000.000.000 đồng.",
      "authorized_capital_conf": 0.9732,
      "birthday": "11/12/1973",
      "birthday_conf": 1.0,
      "business_code": "01234567890",
      "business_code_conf": 0.965,
      "company_address": "Tòa nhà Duni, Thành phố Hồ Chí Minh, Việt Nam",
      "company_address_conf": 0.9716,
      "company_foreign_name": "DUNI JOINT STOCK COMPANY",
      "company_foreign_name_conf": 0.9941,
      "company_name": "CÔNG TY CỔ PHẦN DUNI",
      "company_name_conf": 0.9619,
      "company_phone": "084 12345678",
      "company_phone_conf": 0.9995,
      "company_short_name": "DUNI COMPANY",
      "company_short_name_conf": 0.9956,
      "contact_address": "Tòa nhà Duni, Thành phố Hồ Chí Minh, Việt Nam",
      "contact_address_conf": 0.9871,
      "fax": "084 12345678",
      "fax_conf": 0.9995,
      "first_register": "11/12/2013",
      "first_register_conf": 0.9584,
      "gender": "Nam",
      "gender_conf": 1.0,
      "id_address": "Tòa nhà Duni",
      "id_address_conf": 0.9938,
      "id_issue_date": "11/12/2013",
      "id_issue_date_conf": 0.9846,
      "id_issued_at": "Việt Nam",
      "id_issued_at_conf": 0.9884,
      "id_number": "0123456789",
      "id_number_conf": 1.0,
      "id_type": "Hộ chiếu nước ngoài",
      "id_type_conf": 0.9962,
      "name": "NGUYEN, DU NI",
      "name_conf": 0.986,
      "nationality": "Việt Nam",
      "nationality_conf": 0.9953,
      "par_value": "10.000 đồng",
      "par_value_conf": 0.98,
      "title": "Chủ tịch hội đồng quản trị",
      "title_conf": 0.983,
      "total_shares": "3.000.000",
      "total_shares_conf": 0.9999
    },
    "result_code": 200,
    "message": "Success"
  }
}

Các trường hợp trả về.

Result code

Message

Note

200

Success

Trích xuất thông tin thành công

116

Filetype not supported

Đầu vào không đúng định dạng (chỉ chấp nhận PDF hoặc ảnh)

117

Too many PDF

Chỉ chấp nhận 1 file PDF trên 1 request

118

Too many filetype

Chỉ chấp nhận 1 loại định dạng (hoặc PDF, hoặc file ảnh)

119

Selected pages not valid

Trang được chọn không nằm trong tài liệu gửi lên