Import lô chứng từ nâng cao

Ngày cập nhật: 09 tháng 01, 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 template mẫu chứng từ có sẵn.

• 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ự.

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}}",
        "{{dia_chi}}",
        "{{dien_tich_dat}}",
        "{{dien_tich_nha}}"
    ],
    "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",
            "HCM",
            "150m2",
            "450m2"
        ],
        [
            "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",
            "HCM",
            "200m2",
            "180m2"
        ]
    ]
}

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"
    ]
}