离职企业员工

1. 接口描述

接口请求域名： ess.tencentcloudapi.com 。

该接口（DeleteIntegrationEmployees）用于离职本企业员工，同时可选择是否进行离职交接。

• 如果该员工没有未处理的合同，可不设置交接人的ReceiveUserId或ReceiveOpenId进行离职操作。
• 如果该员工有未处理的合同，需要设置ReceiveUserId或ReceiveOpenId表示交接的负责人，交接后员工会进行离职操作。

未处理的合同包括以下：

• 待签署的合同（包括顺序签署还没有轮到的合同，此类合同某些情况可能不会出现在用户的列表中）。
• 待填写的合同。
• 待解除的合同等。

注：

1. 超管或法人身份的员工不能被离职， 需要在控制台或小程序更换法人和超管后进行离职删除。
2. 员工存在待处理合同时必须交接后才能离职无人交接时不能被离职删除。
3. 未实名的员工可以直接离职，不用交接合同

默认接口请求频率限制：20次/秒。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。

3. 输出参数

4. 示例

示例1 删除员工（员工有待处理的合同）

被删除员工存在待处理合同，且设置了交接人ReceiveUserId，调用此接口时，会先进行合同交接，然后删除员工。

输入示例

POST / HTTP/1.1
Host: ess.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DeleteIntegrationEmployees
<公共请求参数>

{
    "Operator": {
        "UserId": "yDCNLUUckptelvkwUy06roXCPebdVqZt"
    },
    "Employees": [
        {
            "UserId": "yDCVKUUckpwsohygUEX7r4kvwy4jPAGW",
            "ReceiveUserId": "yDCNLUUckptelvkwUy06roXCPebdVqZt"
        }
    ]
}

输出示例

{
    "Response": {
        "DeleteEmployeeResult": {
            "SuccessEmployeeData": [
                {
                    "DisplayName": "典子谦",
                    "Mobile": "17300000000",
                    "UserId": "yDCVKUUckpwsohygUEX7r4kvwy4jPAGW"
                }
            ],
            "FailedEmployeeData": []
        },
        "RequestId": "f053ae01-9715-45e6-ad79-6d8a9a674fd7"
    }
}

示例2 删除员工（员工没有待处理的合同）

删除员工，不设置交接人（员工没有待处理的合同），员工将被直接移除。

输入示例

POST / HTTP/1.1
Host: ess.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DeleteIntegrationEmployees
<公共请求参数>

{
    "Operator": {
        "UserId": "yDxbTUyKQWPt6NUuO4zjEuyFAyOX2v9C"
    },
    "Employees": [
        {
            "OpenId": "n9527"
        }
    ]
}

输出示例

{
    "Response": {
        "DeleteEmployeeResult": {
            "FailedEmployeeData": [],
            "SuccessEmployeeData": [
                {
                    "DisplayName": "张三",
                    "Mobile": "13500000000",
                    "UserId": "yDCNCUUckpv0ox66UC7yFOvFzax82lgp"
                }
            ]
        },
        "RequestId": "ee7969233c6c"
    }
}

示例3 错误示例-如果没有设置交接人删除有处理合同的员工

调用此接口时，若出现异常删除失败，员工信息及原因将会被返回。

输入示例

POST / HTTP/1.1
Host: ess.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DeleteIntegrationEmployees
<公共请求参数>

{
    "Operator": {
        "UserId": "yDCNLUUckptelvkwUy06roXCPebdVqZt"
    },
    "Employees": [
        {
            "UserId": "yDCVKUUckpwsohygUEX7r4kvwy4jPAGW"
        }
    ]
}

输出示例

{
    "Response": {
        "DeleteEmployeeResult": {
            "SuccessEmployeeData": [],
            "FailedEmployeeData": [
                {
                    "UserId": "yDCVKUUckpwsohygUEX7r4kvwy4jPAGW",
                    "OpenId": "",
                    "Reason": "删除用户存在处理中的合同 ，需要指定交接人"
                }
            ]
        },
        "RequestId": "857544a1-9d6c-4304-8bf1-268163521060"
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

• Tencent Cloud SDK 3.0 for Python: GitHub Gitee
• Tencent Cloud SDK 3.0 for Java: GitHub Gitee
• Tencent Cloud SDK 3.0 for PHP: GitHub Gitee
• Tencent Cloud SDK 3.0 for Go: GitHub Gitee
• Tencent Cloud SDK 3.0 for Node.js: GitHub Gitee
• Tencent Cloud SDK 3.0 for .NET: GitHub Gitee
• Tencent Cloud SDK 3.0 for C++: GitHub Gitee
• Tencent Cloud SDK 3.0 for Ruby: GitHub Gitee

命令行工具

• Tencent Cloud CLI 3.0

6. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。