Cập nhật mẫu chứng từ

Ngày cập nhật: 18 tháng 08, 2026
Người cập nhật: VNPT eContract's team

---

Mục đích

Hàm thực hiện cập nhật các thông tin của mẫu chứng từ đã tạo trước đó.

• Request URL: /api/document-templates/update
• HTTP method: POST
• HTTP content-type: multipart/form-data
• Authorize: Bearer token
• Parameter:

Key	Type	Description
id	int	[Bắt buộc] Id mẫu chứng từ
file	file	File mẫu chứng từ
name	string	Tên mẫu chứng từ
description	string	Mô tả mẫu chứng từ

Mẫu response body

{
    "data": {
        "id": 1149,
        "name": "FILE MẪU IMPORT LÔ TEST ",
        "createdDate": "2022-11-22T14:18:25.3990136",
        "fillableFields": [
            {
                "key": "{{ngay}}",
                "name": "ngay",
                "description": "Ngày"
            },
            {
                "key": "{{thang}}",
                "name": "thang"
            },
            {
                "key": "{{nam}}",
                "name": "nam"
            }
        ],
        "fileName": "HĐ Dịch vụ Cấp nước Test Dochub.docx",
        "downloadUrl": "{HOST}/Api/Download?token=...",
        "pdfDownloadUrl": "{HOST}/Api/Download?token=...",
        "isDisabled": false,
        "isLaborContractTemplate": false
    },
    "success": true,
    "code": 0,
    "messages": [
      "Update document template success"
    ]
}

Mô tả Response Body

Key	Type	Description
success	boolean	Trạng thái phản hồi của yêu cầu (true: Thành công, false: Thất bại)
code	int	Mã phản hồi từ hệ thống
messages	array	Danh sách thông báo hoặc lỗi trả về từ hệ thống (Ví dụ: ["Update document template success"])
data	object	Đối tượng chứa thông tin chi tiết của mẫu chứng từ sau khi cập nhật (xem chi tiết bên dưới)

Chi tiết dữ liệu trong data:

Key	Type	Description
id	int	ID của mẫu chứng từ vừa tạo
name	string	Tên mẫu chứng từ
createdDate	string	Thời gian tạo mẫu chứng từ (định dạng ISO 8601)
fillableFields	array	Danh sách các trường dữ liệu động có thể điền thông tin (Array[object]) (xem chi tiết bên dưới)
fileName	string	Tên tệp tin gốc đã tải lên
downloadUrl	string	Đường dẫn tải tệp tin mẫu gốc (.docx)
pdfDownloadUrl	string	Đường dẫn tải tệp tin dưới dạng PDF
isDisabled	boolean	Trạng thái vô hiệu hóa mẫu chứng từ (true: Đã bị vô hiệu hóa, false: Hoạt động bình thường)
isLaborContractTemplate	boolean	Có phải mẫu hợp đồng lao động hay không (true: Có, false: Không)

Chi tiết danh sách fillableFields:

Danh sách chứa các trường dữ liệu dynamic trong mẫu chứng từ với các thuộc tính của 1 phần tử:

Key	Type	Description
key	string	Khóa định danh trường dữ liệu trong mẫu (ví dụ: {{ngay}}, {{so_hd}})
name	string	Tên trường dữ liệu
description	string	Mô tả chi tiết ý nghĩa của trường dữ liệu