Tạo mới người dùng

Ngày cập nhật: 21 tháng 2, 2025
Người cập nhật: VNPT eContract's team

---

Mục đích

Hàm thực hiện tạo mới thông tin người dùng và tài khoản đăng nhập hệ thống.

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

Key	Type	Description
code	string	[Bắt buộc] Mã người dùng
username	string	[Bắt buộc] Tên đăng nhập
name	string	[Bắt buộc] Họ và Tên người dùng
email	string	[Bắt buộc] Email người dùng
phone	string	[Bắt buộc] Số điện thoại
groupIds	Array[int]	Mảng Id nhóm người dùng
departmentIds	Array[int]	Mảng Id bộ phận
roleIds	Array[Guild]	Mảng Id vai trò
taxcode	string	Mã số thuế
address	string	Địa chỉ
fax	string	Số fax
description	string	Mô tả
signatureText	string	Văn bản ký mặc định
signConfirmationEnabled	boolean	Ký, phê duyệt sử dụng xác thực 2 lớp
generateSelfSignedCertEnabled	boolean	Tạo chữ ký số tự tạo
status	int	Trạng thái người dùng 1: Hoạt động -1: Ngưng hoạt động
receiveOtpMethod	int	Phương pháp nhận OTP 1: Email 2: SMS -1: Không có
receiveNotificationMethod	int	Phương pháp nhận thông báo chứng từ 0: Email 1: SMS -1: Không có
signMethod	int	Phương pháp ký 1: (Only old version) Sign draw 2: VNPT Smart CA 3: Ký số USB Token
receiveInfoAccountMethod	int	Phương pháp nhận thông tin tài khoản 0: Email 1: SMS -1: Không có

Mẫu request

{
    "code": "USER01",
    "username": "your_username",
    "name": "Nguyen Van A",
    "email": "email_address",
    "phone": "0919XXXXXX",
    "taxcode": "1234567890",
    "address": "Quan 3, TP.Ho Chi Minh",
    "fax": "123",
    "description": "",
    "signatureText": "",
    "signConfirmationEnabled": true,
    "generateSelfSignedCertEnabled": true,
    "status": 1,
    "receiveOtpMethod": 1,
    "receiveNotificationMethod": 0,
    "signMethod": 2,
    "groupIds": [2],
    "departmentIds": [23],
    "roleIds": ["2b999cd0-32ec-4e4a-16b8-08da6df5fc5a"]
}

Mẫu response body

{
    "data": {
        "id": 4401,
        "createdDate": "2022-12-13T14:55:32.2867265+07:00",
        "comId": 164,
        "code": "USER01",
        "name": "Nguyen Van A",
        "phone": "",
        "email": "email_address",
        "isValid": false,
        "signConfirmationEnabled": true,
        "isAccountLocked": false,
        "accountId": "75d5d881-9a88-40ea-9eca-5e370a087e3a",
        "signatureText": "",
        "signMethod": {
            "value": 2,
            "description": "VNPT Smart CA"
        },
        "status": {
            "value": 1,
            "description": "Enabled"
        },
        "receiveOtpMethod": {
            "value": 1,
            "description": "Email"
        },
        "receiveNotificationMethod": {
            "value": 0,
            "description": "Email"
        },
        "personalCertificateId": 3061,
        "personalCertificate": {
            "id": 3061,
            "personalCertificatePath": "164\\2022\\12\\13\\7aab7aeb-ae83-44f5...",
            "isValid": true,
            "issuerDN": "CN=VNPT eContract Certificate, O=VNPT eContract Group, OU=VNPT eContract, C=VN",
            "serialNumber": "747B0B58DAB71FD5",
            "subjectDN": "OID.0.9.2342.19200300.100.1.1=id:4401...",
            "validFrom": "2022-12-13T14:55:33+07:00",
            "validTo": "2027-12-13T14:55:33+07:00",
            "certificateType": 0,
            "createdDate": "2022-12-13T14:55:35.1629534+07:00",
            "createdByUserId": 2341,
            "isActive": true,
            "ownerId": 4401
        }
    },
    "success": true,
    "code": 0,
    "messages": [
        "Create user success"
    ]
}