Tạo mới hoặc cập nhật 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 hoặc cập nhật các thông tin của 1 hoặc nhiều người người dùng trong hệ thống.

• Request URL: /api/users/create-or-update
• 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	Họ và Tên người dùng
email	string	Email người dùng
phone	string	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": "Quận 3, TP.Hồ Chí Minh",
        "fax": "123",
        "description": "",
        "signatureText": "",
        "signConfirmationEnabled": true,
        "generateSelfSignedCertEnabled": true,
        "status": 1,
        "receiveOtpMethod": 1,
        "receiveNotificationMethod": 0,
        "signMethod": 2,
        "groupIds": [
            1014
        ],
        "departmentIds": [
            33
        ],
        "roleIds": [
            "2b999cd0-32ec-4e4a-16b8-08da6df5fc5a"
        ]
    }
]

Mẫu response body

{
    "data": [
        {
            "id": 8072,
            "createdDate": "2023-06-28T14:31:30.9534748",
            "comId": 164,
            "code": "USER01",
            "name": "Nguyen Van A",
            "phone": "0919XXXXXX",
            "email": "email_address",
            "isValid": false,
            "signConfirmationEnabled": true,
            "isAccountLocked": false,
            "signatureText": "",
            "signMethod": {
                "value": 2,
                "description": "VNPT Smart CA"
            },
            "status": {
                "value": 1,
                "description": "Enabled"
            },
            "receiveOtpMethod": {
                "value": 1,
                "description": "Email"
            },
            "receiveNotificationMethod": {
                "value": 0,
                "description": "Email"
            },
            "personalCertificateId": 5111
        }
    ],
    "success": true,
    "code": 0,
    "messages": [
        "Create 0 user success, update 1 user success."
    ]
}