腾讯电子签批量创建合同审查任务

1. 接口描述

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

此接口（CreateBatchContractReviewTask）用来通过上传后的PDF资源编号来批量创建合同智能审查任务。

适用场景：根据合同内容识别出合同的风险信息。审查结果由AI生成，仅供参考。请结合相关法律法规和公司制度要求综合判断。

注:

PDF格式限制大小为10M以下
仅支持5份PDF文件批量发起（一份PDF对应一个审查任务）

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

推荐使用 API Explorer

点击调试

API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

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

参数名称	必选	类型	描述
Action	是	String	公共参数，本接口取值：CreateBatchContractReviewTask。
Version	是	String	公共参数，本接口取值：2020-11-11。
Region	否	String	公共参数，此参数为可选参数。
Operator	是	UserInfo	执行合同审查任务的员工信息。注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
ResourceIds.N	是	Array of String	合同审查的PDF文件资源编号列表，通过UploadFiles接口获取PDF文件资源编号。注: `目前，此接口仅支持5个文件发起。每个文件限制在10M以下，文件必须是PDF格式` 示例值：["yDRS4UUgygqdcj56UuO4zjExBQcOiB68","yDRS4UUgygqdcj5pUuO4zjEu602GFIe6"]
PolicyType	否	Integer	合同审查的审查尺度。默认为`0`严格尺度审查尺度如下： 0 - 【严格】以保护己方利益为核心，对合同条款进行严格把控，尽可能争取对己方有利的条款，同时对对方提出的不合理条款可进行坚决修改或删除。 1 - 【中立】以公平合理为原则，平衡双方的权利义务，既不过分强调己方利益，也不过度让步，力求达成双方均可接受的条款。 2 - 【宽松】以促成交易为核心，对合同条款的修改要求较为宽松，倾向于接受对方提出的条款，以尽快达成合作。示例值：0
Role	否	RiskIdentificationRoleInfo	合同审查中的角色信息，通过明确入参角色的名称和描述，可以提高合同审查的效率和准确性。用户不做配置时大模型会根据合同内容推荐出风险识别角色的名称和描述信息。
ChecklistId	否	String	用户配置的审查清单ID，基于此清单ID批量创建合同审查任务，为32位字符串。点击查看审查清单ID在控制台上的位置。如果用户不做此配置大模型会根据合同内容在当前企业下的审查清单和系统默认的清单中选择一个清单进行审查。示例值：yDtCMUUckpx3boo7UysNTh4vx0j0a6Ii
Agent	否	Agent	代理企业和员工的信息。在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
Comment	否	String	备注信息，长度不能超过100个字符示例值：备注信息
UserData	否	String	调用方自定义的个性化字段(可自定义此名称)，并以base64方式编码，支持的最大数据大小为 1024长度。在合同状态变更的回调信息等场景中，该字段的信息将原封不动地透传给贵方。回调的相关说明可参考开发者中心的回调通知模块。示例值：QmFzZTY0IEJhc2U2NCA

3. 输出参数

参数名称	类型	描述
TaskIds	Array of String	合同审查的任务ID列表，每个任务ID为32位字符串。建议开发者保存此任务ID，后续查询合同审查任务取详情需要此任务ID。注意：`返回的索引和ResourceIds数组一致` 示例值：["yDtG8UUckp9law7sUrCBqByFZLtkJ7cz"]
RequestId	String	唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 批量创建合同审查任务

输入示例

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

{
    "Operator": {
        "UserId": "yDwJGUU6xxxhztsrrmBe"
    },
    "ResourceIds": [
        "yDtG1UU2xexxxC1pfrsbRhIOj"
    ],
    "PolicyType": 0,
    "Role": {
        "Name": "授权方",
        "Description": "广州贸易测试有限公司"
    },
    "ChecklistId": "yDtCMUUckpxxx0j0a6Ii"
}

输出示例

{
    "Response": {
        "RequestId": "s1753417470034482869",
        "TaskIds": [
            "yDtIFUU2tnsxxx9d8"
        ]
    }
}

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. 错误码

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

错误码	描述
FailedOperation	操作失败。
FailedOperation.BalanceNotEnough	套餐余额不足。
InternalError	内部错误。
InternalError.DependsApi	依赖的第三方API返回错误。
InternalError.DependsDb	数据库执行错误。
InternalError.System	系统错误，请稍后重试。
InvalidParameter.ParamError	参数错误。
InvalidParameter.SensitiveFileContent	上传的文件包含敏感（不合规）的内容，请确认。
OperationDenied	操作被拒绝。
OperationDenied.NoLogin	用户未登录,请先登录后再操作。

批量创建合同审查任务

本页目录：