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

Ngày cập nhật: 30 tháng 4, 2023
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 (V, D, DR, A). Với:

• V là chỉ xem
• D là ký số
• DR là ký nháy
• A là phê duyệt
• F là điền dữ liệu

Caution

F luôn được xếp trước D 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"
    ]
}