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