Nộp giấy tờ kinh doanh
Được sử dụng để nộp giấy tờ doanh nghiệp với metadata. Đây là bước 2 trong quy trình tải lên giấy tờ doanh nghiệp (two-phase process). Trước khi gọi API này, bạn cần tải lên tệp giấy tờ bằng API Tải lên tệp giấy tờ để lấy fileId.
Parameters
| Property | Type | Required | Description |
|---|---|---|---|
| miniAppId | Long | true | ID của Mini App |
| businessDocuments | List<BusinessDocument> | true | Danh sách giấy tờ doanh nghiệp |
BusinessDocument
| Property | Type | Required | Description |
|---|---|---|---|
| fileId | String | true | ID của tệp (từ bước 1) |
| fileName | String | true | Tên của tệp (từ bước 1) |
| type | String | true | Loại giấy tờ: "BUSINESS_LICENSE" hoặc "ADDITIONAL_LICENSE" |
| documentTypeId | Integer | false | ID loại giấy tờ (khuyến nghị sử dụng) |
| documentType | String | false | Tên loại giấy tờ (legacy, vẫn hỗ trợ) |
| subCategoryId | Integer | false | ID danh mục con |
mẹo
Khuyến nghị sử dụng documentTypeId thay vì documentType để dễ bảo trì hơn. Nếu cả hai được cung cấp, documentTypeId sẽ được ưu tiên.
Return Values
| Property | Type | Description |
|---|---|---|
| error | int | Mã lỗi của kết quả trả về, bằng 0 nếu request thành công |
| message | String | Lời nhắn chi tiết tương ứng với mã lỗi |
| data | Object | Kết quả nộp giấy tờ |
Lưu ý
- Nếu đang có tài liệu đang được xử lý, API sẽ trả về lỗi:
- error: -101
- message: "Nộp tài liệu không thành công, bạn đang có tài liệu đang được xử lý"
- Nếu ứng dụng chưa cập nhật
subCateIds, API sẽ trả về lỗi:- message: "Vui lòng cập nhật thông tin"
- Vui lòng sử dụng API Cập nhật loại hình để cập nhật
subCateIds. Có thể lấy danh sáchsubCateIdshợp lệ từ API Lấy thông tin Mini App.
Giới hạn
Số lượng tệp giấy tờ được tải lên không quá 100 file/tháng.
Data Object
| Property | Type | Description |
|---|---|---|
| businessResults | DocumentRequestResult | Kết quả cho giấy tờ BUSINESS_LICENSE |
| additionalResults | DocumentRequestResult | Kết quả cho giấy tờ ADDITIONAL_LICENSE |
DocumentRequestResult
| Property | Type | Description |
|---|---|---|
| id | Long | ID của request |
| reviewStatus | String | Trạng thái xét duyệt |
| ownerId | String | ID của chủ sở hữu |
| createdAt | Long | Thời gian tạo |
| documentFiles | List<DocumentInfo> | Danh sách thông tin giấy tờ |
Sample Code
Code demo fallback when rendering server side!
