Import lô chứng từ nâng cao
Ngày cập nhật: 17 tháng 07, 2025
Người cập nhật: VNPT eContract's team
Mục đích
Thực hiện tạo hàng loạt chứng từ bằng mẫu chứng từ đã chuẩn bị trước đó, tham khảo Quản lý mẫu chứng từ Hoặc tải file mẫu chứng từ tại đây
- Request URL:
/api/batch-imports/create-advance - HTTP method:
POST - HTTP content-type:
application/json - Authorize:
Bearer token - Parameter:
| Key | Type | Description |
|---|---|---|
name | string | [Bắt buộc] Tên lô chứng từ |
departmentId | int | [Bắt buộc] Id bộ phận |
documentTypeId | int | [Bắt buộc] Id loại chứng từ |
documentTemplateId | int | [Bắt buộc] Id mẫu chứng từ |
parameters | List<string> | [Bắt buộc] Danh sách tham số |
rows | List<List<string>> | [Bắt buộc] Danh sách các dữ liệu |
mẹo
accessPermissionCode là các quyền truy cập xử lý chứng từ:
- V là chỉ xem
- D là ký số
- E là ký điện tử
- EKYC là ký eKYC
- DR là ký nháy
- A là phê duyệt
- F là điền dữ liệu
- C là điều phối
Caution
- F luôn được xếp trước D, E, EKYC và DR trong quy trình xử lý tuần tự.
- Tham khảo biến
{{#items}}nếu bạn muốn truyền kiểu dữ liệu dạng mảng (array) - Dùng ký tự
\nđể xuống dòng (xem ví dụ ở biến{{nhiem_vu_cong_viec}}) - Độ dài các biến mặc định là 2000 ký tự
Mẫu request
{
"name": "[DEMO] Lô hợp đồng thuê nhà 02/2023",
"departmentId": 1,
"documentTypeId": 1,
"documentTemplateId": 2,
"parameters": [
"{{D.FileName}}",
"{{D.No}}",
"{{D.Subject}}",
"{{D.ExpiryDate}}",
"{{D.Description}}",
"{{D.IsOrder}}",
"{{P.Code}}",
"{{P.AccessPermission}}",
"{{P.Code}}",
"{{P.AccessPermission}}",
"{{day}}",
"{{month}}",
"{{year}}",
"{{ben_a}}",
"{{ben_b}}",
"{{nhiem_vu_cong_viec}}",
"{{dien_tich_dat}}",
"{{dien_tich_nha}}",
"{{#items}}",
],
"rows": [
[
"fileNameHdtn01",
"HDTN01",
"Hợp đồng thuê nhà ông Nguyễn Văn A",
"",
"Nội dung mô tả hợp đồng",
"Y",
"baoth",
"DR",
"nguyenvana",
"D",
"17",
"02",
"2022",
"Tô Hoài Bảo",
"Nguyễn Văn A",
"- Tuân thủ quy định về việc sử dụng trang thiết bị, máy móc, vật tư của người lao động.\n- Chấp hành quy định về trang phục, tác phong, thái độ làm việc của người lao động.\n- Chấp hành quy định về an toàn, vệ sinh lao động trong môi trường làm việc.",
"150m2",
"450m2",
"[ {\"no\": \"1\",\"name\": \"Quy trinh\",\"creator\": \"Ngo Thuy Trinh\",\"year\": \"2025\"}, {\"no\": \"2\",\"name\": \"Quy dinh\",\"creator\": \"Thuy Trinh\",\"year\": \"2020\"} ]"
],
[
"fileNameHdtn02",
"HDTN02",
"Hợp đồng thuê nhà ông Trần Thùy Trinh",
"",
"Nội dung mô tả hợp đồng",
"Y",
"baoth",
"DR",
"tranthuytrinh",
"D",
"20",
"02",
"2022",
"Tô Hoài Bảo",
"Trần Thùy Trinh",
"- Tuân thủ quy định về bảo vệ bí mật kinh doanh, bí mật công nghệ của doanh nghiệp.\n- Chấp hành quy định về an toàn, vệ sinh lao động trong môi trường làm việc.",
"200m2",
"180m2",
"[ {\"no\": \"1\",\"name\": \"Quy trinh phong A\",\"creator\": \"Ngo Thuy Trinh\",\"year\": \"04.2025\"}, {\"no\": \"2\",\"name\": \"Quy dinh\",\"creator\": \"Thuy Trinh\",\"year\": \"2020\"} ]"
]
]
}
Mẫu response body
{
"data": {
"id": 1234,
"createdDate": "2022-12-13T10:21:51.712847+07:00",
"uploadedByUserId": 2341,
"numberOfRecords": 3,
"name": "Test import lô chứng từ bằng API",
"documents": [
{
"id": "e429b738-f30c-44e6-f25b-08dadcb92ffb",
"createdDate": "2022-12-13T10:21:54.618228+07:00",
"lastModifiedDate": "2022-12-13T10:21:54.6181865+07:00",
"expiryDate": "2022-12-15T00:00:00",
"no": "WV38",
"subject": "HĐLĐ_01",
"hasVerified": false,
"fileType": 0,
"status": {
"value": 1,
"description": "New document"
},
"description": "Hợp đồng lao động 01",
"department": {
"id": 33,
"name": "VNPT eContract",
"code": "DHB",
"users": []
},
"createdByUserId": 2341,
"processRecipientCount": 3,
"processInOrder": true,
"isWaitToSignDraw": false,
"isWaitToSignDigital": false,
"isWaitToApprove": false,
"isCancelable": false,
"isEditable": true,
"isShareable": false,
"isAccessable": false,
"isExpired": false,
"canDownload": false,
"type": {
"id": 47,
"code": "TOTRINH",
"name": "Tờ trình",
"description": "Tờ trình nội bộ",
"documentCount": 3
},
"documentTemplate": {
"id": 130,
"name": "Mẫu hợp đồng không thời hạn",
"createdDate": "2022-10-31T13:43:38.9327148",
"fileName": "Mau_hop_hong.docx",
"downloadUrl": "{HOST}/Api/Download?token=...",
"pdfDownloadUrl": "{HOST}/Api/Download?token=",
"isShareable": false,
"isDeletelable": false,
"isUpdateable": false
},
"processes": [
{
"id": "39e86913-d55a-4bd8-d61f-08dadcb93017",
"createdDate": "2022-12-13T10:21:54.6172923+07:00",
"comId": 164,
"isOrder": true,
"orderNo": 1,
"displayType": {
"value": 0,
"description": "0"
},
"accessPermission": {
"value": 2,
"description": "Sign draw"
},
"status": {
"value": 1,
"description": "Waiting"
},
"processedByUserId": 2328,
"documentId": "e429b738-f30c-44e6-f25b-08dadcb92ffb"
}
],
"file": {
"name": "Import_lo_1.pdf",
"size": 164711
},
"downloadUrl": "{HOST}/Api/Download?token=..."
}
],
"isSendable": true,
"isCancelable": true
},
"success": true,
"code": 0,
"messages": [
"Import batch document success"
]
}