Tạo chứng từ cho Hợp đồng lao động (HĐLĐ)

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

---

Mục đích

Sinh chứng từ (document) chính thức từ hợp đồng lao động đã khởi tạo ở API mục 7.2, làm cơ sở để đưa vào quy trình trình ký/duyệt trong hệ thống.

• Request URL: /api/documents/create
• HTTP method: POST
• HTTP content-type: application/json
• Authorize: Bearer token
• Parameter:

Key	Type	Bắt buộc	Mô tả
TypeId	int	Có	ID loại chứng từ theo danh mục hệ thống (ví dụ: 8950 = "HDLD" — Hợp đồng lao động)
DepartmentId	int	Có	ID phòng/ban phát hành chứng từ
LaborContractId	string (GUID)	Có	ID hợp đồng lao động dạng GUID trả về ở API mục 7.2

---

Request mẫu

{
  "TypeId": 8950,
  "DepartmentId": 9855,
  "LaborContractId": "969bfc9a-570f-4d4e-a98b-42361a73f7e8"
}

---

Response mẫu — HTTP 200

{
  "data": {
    "id": "75807d54-7c01-43fd-bd52-309eb04d9fc4",
    "createdDate": "2026-08-05T13:21:54.7071423+07:00",
    "lastModifiedDate": "2026-08-05T13:21:54.7072758+07:00",
    "validFrom": "2026-06-24T00:00:00",
    "validTo": "2027-06-24T23:59:59",
    "no": "HDLD-NVC-20260805062149",
    "subject": "Employment contract Nguyễn Văn Cường 2149",
    "hasVerified": false,
    "hasVerify": false,
    "hasSeal": true,
    "requireVerifiedUserSigning": true,
    "status": {
      "value": 1,
      "description": "New"
    },
    "contractStatus": {
      "value": 1,
      "description": "Contract valid"
    },
    "createdByUserId": 27938,
    "processRecipientCount": 0,
    "waitingProcesses": [],
    "processInOrder": false,
    "isWaitToSignDraw": false,
    "isWaitToSignDigital": false,
    "isWaitToApprove": false,
    "isWaitToFillData": false,
    "isWaitToCoordinate": false,
    "isWaitToESign": false,
    "isWaitToEkyc": false,
    "isFillable": false,
    "type": {
      "id": 8950,
      "code": "HDLD",
      "name": "Hợp đồng lao động",
      "documentCount": 1,
      "enableVnptSeal": false,
      "requireVerifiedUserSigning": false,
      "children": []
    },
    "laborContractRevision": {
      "id": "7a2d74b5-140f-4893-8b4b-fc409077e289",
      "laborContractId": "969bfc9a-570f-4d4e-a98b-42361a73f7e8",
      "version": 1,
      "status": {
        "value": 0,
        "description": "Draft"
      },
      "contractNumber": "HDLD-NVC-20260805062149",
      "employeeFullName": "Nguyễn Văn Cường 2149"
    },
    "processes": [],
    "accessibleViewProcesses": [],
    "histories": [
      {
        "createdDate": "2026-08-05T13:21:54.8353817+07:00",
        "requestType": {
          "value": 0,
          "description": "Web"
        },
        "ipAddress": "10.70.39.163",
        "activity": {
          "value": 1,
          "description": "Create document"
        }
      }
    ],
    "attachments": [],
    "relatedDocuments": [],
    "linkedDocuments": [],
    "messages": [],
    "file": {
      "name": "HDLD-NVC-20260805062149.pdf",
      "size": 358043
    },
    "downloadUrl": "{HOST}/Api/Download?token=...",
    "downloadOriginalUrl": "{HOST}/Api/Download?token=...",
    "downloadWatermarkMetadataUrl": "{HOST}/Api/Download?token=...",
    "fillingItems": [],
    "sharedUsers": [],
    "isMarkStar": false,
    "requiresSealSendConfirmation": false,
    "fixedPosition": false
  },
  "success": true,
  "code": 0,
  "messages": [
    "Create document success"
  ]
}

thông tin

Lưu ý: data.id chính là DocumentId (mã chứng từ) vừa được tạo. Ngay sau khi tạo, chứng từ ở trạng thái "New" (status.value = 1), chưa có người xử lý (processRecipientCount = 0). Việc cấu hình và gửi quy trình trình ký cho chứng từ nằm ở bước xử lý quy trình tiếp theo.

---

Response Parameter

Key	Type	Description
data	object	Thông tin chi tiết chứng từ vừa được khởi tạo (xem bên dưới)
success	boolean	Trạng thái xử lý yêu cầu (true: Thành công, false: Thất bại)
code	int	Mã trạng thái phản hồi
messages	array	Danh sách thông báo kết quả xử lý từ hệ thống

---

Chi tiết đối tượng data trong Response:

Key	Type	Description
id	string	Mã chứng từ (DocumentId dạng GUID) vừa được tạo
createdDate	string	Thời gian tạo chứng từ (định dạng ISO 8601)
lastModifiedDate	string	Thời gian cập nhật chứng từ gần nhất (định dạng ISO 8601)
validFrom	string	Thời gian bắt đầu hiệu lực (định dạng ISO 8601)
validTo	string	Thời gian kết thúc hiệu lực (định dạng ISO 8601)
no	string	Số văn bản/chứng từ
subject	string	Tiêu đề chứng từ
hasVerified	boolean	Trạng thái xác thực chứng từ
hasSeal	boolean	Chứng từ có sử dụng con dấu hay không
requireVerifiedUserSigning	boolean	Yêu cầu người ký phải xác thực tài khoản
status	object	Trạng thái chứng từ (1: New)
contractStatus	object	Trạng thái hợp đồng (1: Contract valid)
createdByUserId	int	ID tài khoản người tạo chứng từ
processRecipientCount	int	Số lượng người nhận xử lý chứng từ
waitingProcesses	array	Danh sách các quy trình đang chờ
type	object	Chi tiết loại chứng từ (id, code, name)
laborContractRevision	object	Chi tiết bản ghi hợp đồng lao động liên kết (tương tự dữ liệu trả về ở mục 7.2)
file	object	Thông tin file chứng từ (name, size)
downloadUrl	string	Đường dẫn tải xuống file chứng từ
downloadOriginalUrl	string	Đường dẫn tải xuống file gốc
downloadWatermarkMetadataUrl	string	Đường dẫn tải xuống file có đính kèm metadata/watermark