;
/**
* 下载后的文件命名,只有FileType为zip的时候生效
*/
FileName?: string;
/**
* 要下载的文件类型,取值如下:
*/
FileType?: string;
/**
* 指定分页返回第几页的数据,如果不传默认返回第一页,页码从 0 开始,即首页为 0,最大 1000。
*/
Offset?: number;
/**
* 指定分页每页返回的数据条数,如果不传默认为 20,单页最大支持 100。
*/
Limit?: number;
/**
* 下载url过期时间,单位秒。0: 按默认值5分钟,允许范围:1s~24x60x60s(1天)
*/
UrlTtl?: number;
/**
* 暂不开放
* @deprecated
*/
CcToken?: string;
/**
* 暂不开放
* @deprecated
*/
Scene?: string;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
}
/**
* CreateMiniAppPrepareFlow返回参数结构体
*/
export interface CreateMiniAppPrepareFlowResponse {
/**
* H5跳转到电子签小程序链接, 一般用于发送短信中带的链接, 打开后进入腾讯电子签小程序
*/
LongUrl?: string;
/**
* H5跳转到电子签小程序链接的短链形式, 一般用于发送短信中带的链接, 打开后进入腾讯电子签小程序
*/
ShortUrl?: string;
/**
* APP或小程序跳转电子签小程序链接, 一般用于客户小程序或者APP跳转过来, 打开后进入腾讯电子签小程序
*/
MiniAppPath?: string;
/**
* 创建的合同id(还未实际发起,也未扣费),每次调用会生成新的id,用户可以记录此字段对应后续在小程序发起的合同,若在小程序上未成功发起,则此字段无效。
*/
FlowId?: string;
/**
* 跳转至电子签小程序的二维码链接
*/
QrcodeUrl?: string;
/**
* 直接跳转至电子签小程序的二维码链接,无需通过中转页。需要自行将其转换为二维码,使用微信扫码后可直接进入。
*/
WeixinQrcodeUrl?: string;
/**
* 链接过期时间,精确到秒,若在此过期时间前未使用,则链接失效。
*/
ExpiredOn?: number;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateConvertTaskApi请求参数结构体
*/
export interface CreateConvertTaskApiRequest {
/**
* 需要进行转换的资源文件类型
支持的文件类型如下:
- doc
- docx
- xls
- xlsx
- jpg
- jpeg
- png
- html
- bmp
- txt
*/
ResourceType: string;
/**
* 需要进行转换操作的文件资源名称,带资源后缀名。
注: `资源名称长度限制为256个字符`
*/
ResourceName: string;
/**
* 需要进行转换操作的文件资源Id,通过UploadFiles接口获取文件资源Id。
注: `目前,此接口仅支持单个文件进行转换。`
*/
ResourceId: string;
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator?: UserInfo;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 暂未开放
* @deprecated
*/
Organization?: OrganizationInfo;
}
/**
* OperateTemplate请求参数结构体
*/
export interface OperateTemplateRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 模板ID,为32位字符串。
*/
TemplateId: string;
/**
* 操作类型,可取值如下:
- DELETE: 删除
- ENABLE: 启用
- DISABLE: 停用
- COPY: 复制新建
*/
OperateType: string;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 模板名称,长度不超过64字符。
模板复制时指定有效,若为空,则复制后模板名称为 **原模板名称_副本**。
*/
TemplateName?: string;
}
/**
* CreateBatchQuickSignUrl返回参数结构体
*/
export interface CreateBatchQuickSignUrlResponse {
/**
* 签署人签署链接信息
*/
FlowApproverUrlInfo?: FlowApproverUrlInfo;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 创建流程的签署方信息
*/
export interface FlowCreateApprover {
/**
* 在指定签署方时,可以选择企业B端或个人C端等不同的参与者类型,可选类型如下:
- 0 :企业B端。
- 1 :个人C端。
- 3 :企业B端静默(自动)签署,无需签署人参与,自动签署可以参考自动签署使用说明文档。
- 7 :个人C端自动签署,适用于个人自动签场景。注: 个人自动签场景为白名单功能,使用前请联系对接的客户经理沟通。
*/
ApproverType: number;
/**
* 组织机构名称。
请确认该名称与企业营业执照中注册的名称一致。
如果名称中包含英文括号(),请使用中文括号()代替。
注: 当approverType=0(企业签署方) 或 approverType=3(企业静默签署)时,必须指定
*/
OrganizationName?: string;
/**
* 签署方经办人的姓名。
经办人的姓名将用于身份认证和电子签名,请确保填写的姓名为签署方的真实姓名,而非昵称等代名。
在未指定签署人电子签UserId情况下,为必填参数
*/
ApproverName?: string;
/**
* 签署方经办人手机号码, 支持中国大陆手机号11位数字(无需加+86前缀或其他字符)。 此手机号用于通知和用户的实名认证等环境,请确认手机号所有方为此合同签署方。
注:在未指定签署人电子签UserId情况下,为必填参数
*/
ApproverMobile?: string;
/**
* 证件类型,支持以下类型
- ID_CARD: 居民身份证 (默认值)
- HONGKONG_AND_MACAO : 港澳居民来往内地通行证
- HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证)
*/
ApproverIdCardType?: string;
/**
* 证件号码,应符合以下规则
- 中国大陆居民身份证号码应为18位字符串,由数字和大写字母X组成(如存在X,请大写)。
- 中国港澳居民来往内地通行证号码共11位。第1位为字母,“H”字头签发给中国香港居民,“M”字头签发给中国澳门居民;第2位至第11位为数字。
- 中国港澳台居民居住证号码编码规则与中国大陆身份证相同,应为18位字符串。
*/
ApproverIdCardNumber?: string;
/**
* 签署方经办人在模板中配置的参与方ID,与控件绑定,是控件的归属方,ID为32位字符串。
模板发起合同时,该参数为必填项,可以通过查询模板信息接口获得。
文件发起合同时,该参数无需传值。
如果开发者后续用合同模板发起合同,建议保存此值,在用合同模板发起合同中需此值绑定对应的签署经办人 。
*/
RecipientId?: string;
/**
* 签署意愿确认渠道,默认为WEIXINAPP:人脸识别
注: <font color="red">不再使用, 用ApproverSignTypes签署人签署合同时的认证方式代替, 新客户可请用ApproverSignTypes来设置
*/
VerifyChannel?: Array;
/**
* 通知签署方经办人的方式, 有以下途径:
- **sms** : (默认)短信
- **email** : 邮件
- **all** : 邮件+短信
- **none** : 不通知
注: 既是发起方又是签署方时,不给此签署方发送短信
枚举值:
- sms: 短信通知
- email: 邮件通知
- all: 邮件通知+短信通知
- none: 不做任何形式的通知
*/
NotifyType?: string;
/**
* 合同强制需要阅读全文,无需传此参数
*/
IsFullText?: boolean;
/**
* 签署方在签署合同之前,需要强制阅读合同的时长,可指定为3秒至300秒之间的任意值。
若未指定阅读时间,则会按照合同页数大小计算阅读时间,计算规则如下:
- 合同页数少于等于2页,阅读时间为3秒;
- 合同页数为3到5页,阅读时间为5秒;
- 合同页数大于等于6页,阅读时间为10秒。
*/
PreReadTime?: number;
/**
* 签署人userId,仅支持本企业的员工userid, 可在控制台组织管理处获得
注:
如果传进来的UserId已经实名, 则忽略ApproverName,ApproverIdCardType,ApproverIdCardNumber,ApproverMobile这四个入参(会用此UserId实名的身份证和登录的手机号覆盖)
*/
UserId?: string;
/**
* 字段不再使用,当前只支持true,默认为true
*/
Required?: boolean;
/**
* 在企微场景下使用,需设置参数为WEWORKAPP,以表明合同来源于企微。
*/
ApproverSource?: string;
/**
* 在企业微信场景下,表明该合同流程为或签,其最大长度为64位字符串。
所有参与或签的人员均需具备该标识。
注意,在合同中,不同的或签参与人必须保证其CustomApproverTag唯一。
如果或签签署人为本方企业微信参与人,则需要指定ApproverSource参数为WEWORKAPP。
*/
CustomApproverTag?: string;
/**
* 快速注册相关信息
*/
RegisterInfo?: RegisterInfo;
/**
* 签署人个性化能力值,如是否可以转发他人处理、是否可以拒签、是否为动态补充签署人等功能开关。
*/
ApproverOption?: ApproverOption;
/**
* 签署完前端跳转的url,暂未使用
* @deprecated
*/
JumpUrl?: string;
/**
* 签署人的签署ID
- 在CreateFlow、CreatePrepareFlow等发起流程时不需要传入此参数,电子签后台系统会自动生成。
- 在CreateFlowSignUrl、CreateBatchQuickSignUrl等生成签署链接时,可以通过查询详情接口获取签署人的SignId,然后可以将此值传入,为该签署人创建签署链接。这样可以避免重复传输姓名、手机号、证件号等其他信息。
*/
SignId?: string;
/**
* 此签署人(员工或者个人)签署时,是否需要发起方企业审批,取值如下:
- **false**:(默认)不需要审批,直接签署。
- **true**:需要走审批流程。当到对应参与人签署时,会阻塞其签署操作,等待企业内部审批完成。
企业可以通过CreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果- 如果企业通知腾讯电子签平台审核通过,签署方可继续签署动作。
- 如果企业通知腾讯电子签平台审核未通过,平台将继续阻塞签署方的签署动作,直到企业通知平台审核通过。
注:此功能可用于与发起方企业内部的审批流程进行关联,支持手动、静默签署合同

*/
ApproverNeedSignReview?: boolean;
/**
* 签署人签署控件, 此参数仅针对文件发起(CreateFlowByFiles)生效
合同中的签署控件列表,列表中可支持下列多种签署控件,控件的详细定义参考开发者中心的Component结构体
此参数仅针对文件发起设置生效,模板发起合同签署流程, 请以模板配置为主
*/
SignComponents?: Array;
/**
* 签署人填写控件 此参数仅针对文件发起(CreateFlowByFiles)生效
合同中的填写控件列表,列表中可支持下列多种填写控件,控件的详细定义参考开发者中心的Component结构体
- 单行文本控件
- 多行文本控件
- 勾选框控件
- 数字控件
- 图片控件
- 动态表格等填写控件
此参数仅针对文件发起设置生效,模板发起合同签署流程, 请以模板配置为主
*/
Components?: Array;
/**
* 当签署方控件类型为 SIGN_SIGNATURE 时,可以指定签署方签名方式。如果不指定,签署人可以使用所有的签名类型,可指定的签名类型包括:
- HANDWRITE :需要实时手写的手写签名。
- HANDWRITTEN_ESIGN :长效手写签名, 是使用保存到个人中心的印章列表的手写签名。(并且包含HANDWRITE)
- OCR_ESIGN :AI智能识别手写签名。
- ESIGN :个人印章类型。
- IMG_ESIGN : 图片印章。该类型支持用户在签署将上传的PNG格式的图片作为签名。
- SYSTEM_ESIGN :系统签名。该类型可以在用户签署时根据用户姓名一键生成一个签名来进行签署。
各种签名的样式可以参考下图:

*/
ComponentLimitType?: Array;
/**
* 指定个人签署方查看合同的校验方式,可以传值如下:
- **1** : (默认)人脸识别,人脸识别后才能合同内容
- **2** : 手机号验证, 用户手机号和参与方手机号(ApproverMobile)相同即可查看合同内容(当手写签名方式为OCR_ESIGN时,该校验方式无效,因为这种签名方式依赖实名认证)
注: - 如果合同流程设置ApproverVerifyType查看合同的校验方式, 则忽略此签署人的查看合同的校验方式
- 此字段可传多个校验方式
此参数仅针对文件发起设置生效,模板发起合同签署流程, 请以模板配置为主
.
*/
ApproverVerifyTypes?: Array;
/**
* 您可以指定签署方签署合同的认证校验方式,可传递以下值:
- **1**:人脸认证,需进行人脸识别成功后才能签署合同;
- **2**:签署密码,需输入与用户在腾讯电子签设置的密码一致才能校验成功进行合同签署;
- **3**:运营商三要素,需到运营商处比对手机号实名信息(名字、手机号、证件号)校验一致才能成功进行合同签署。(如果是港澳台客户,建议不要选择这个)
- **5**:设备指纹识别,需要对比手机机主预留的指纹信息,校验一致才能成功进行合同签署。(iOS系统暂不支持该校验方式)
- **6**:设备面容识别,需要对比手机机主预留的人脸信息,校验一致才能成功进行合同签署。(Android系统暂不支持该校验方式)
注:
- 默认情况下,认证校验方式为人脸认证和签署密码两种形式;
- 您可以传递多种值,表示可用多种认证校验方式。
- 校验方式不允许只包含设备指纹识别和设备面容识别,至少需要再增加一种其他校验方式。
- 设备指纹识别和设备面容识别只支持小程序使用,其他端暂不支持。
注:
此参数仅针对文件发起设置生效,模板发起合同签署流程, 请以模板配置为主
*/
ApproverSignTypes?: Array;
/**
* 生成H5签署链接时,您可以指定签署方签署合同的认证校验方式的选择模式,可传递一下值:
- **0**:签署方自行选择,签署方可以从预先指定的认证方式中自由选择;
- **1**:自动按顺序首位推荐,签署方无需选择,系统会优先推荐使用第一种认证方式。
注:不指定该值时,默认为签署方自行选择。
*/
SignTypeSelector?: number;
/**
* 签署人的签署截止时间,格式为Unix标准时间戳(秒), 超过此时间未签署的合同变成已过期状态,不能在继续签署
注: 若不设置此参数,则默认使用合同的截止时间,此参数暂不支持合同组子合同
*/
Deadline?: number;
/**
* 只有在生成H5签署链接的情形下( 如调用获取H5签署链接、获取H5批量签署链接等接口),该配置才会生效。
您可以指定H5签署视频核身的意图配置,选择问答模式或点头模式的语音文本。
注意:
- 视频认证为白名单功能,使用前请联系对接的客户经理沟通。
- 使用视频认证时,生成H5签署链接必须将签署认证方式指定为人脸(即ApproverSignTypes设置成人脸签署)。
- 签署完成后,可以通过查询签署认证人脸视频获取到当时的视频。
*/
Intention?: Intention;
/**
* 进入签署流程的限制,目前支持以下选项:
- 空值(默认) :无限制,可在任何场景进入签署流程。
- link :选择此选项后,将无法通过控制台或电子签小程序列表进入填写或签署操作,仅可预览合同。填写或签署流程只能通过短信或发起方提供的专用链接进行。
*/
SignEndpoints?: Array;
/**
* 是否不保存联系人
默认 false 保存联系人 true 不保存联系人
设置这个参数为保存联系人的时候,他方企业签署人会被保存进发起人的联系人中。
联系人查看可登录电子签控制台 进行查看。
如下图位置:

*/
NotSaveContact?: boolean;
/**
* 客户指定的邮箱信息
*/
ApproverEmail?: string;
}
/**
* DeleteSingleSignOnEmployees返回参数结构体
*/
export interface DeleteSingleSignOnEmployeesResponse {
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 权限树节点权限
*/
export interface Permission {
/**
* 权限名称
*/
Name?: string;
/**
* 权限key
*/
Key?: string;
/**
* 权限类型 1前端,2后端
*/
Type?: number;
/**
* 是否隐藏
*/
Hide?: number;
/**
* 数据权限标签 1:表示根节点,2:表示叶子结点
*/
DataLabel?: number;
/**
* 数据权限独有,1:关联其他模块鉴权,2:表示关联自己模块鉴权
*/
DataType?: number;
/**
* 数据权限独有,表示数据范围,1:全公司,2:部门及下级部门,3:自己
*/
DataRange?: number;
/**
* 关联权限, 表示这个功能权限要受哪个数据权限管控
*/
DataTo?: string;
/**
* 父级权限key
*/
ParentKey?: string;
/**
* 是否选中
*/
IsChecked?: boolean;
/**
* 子权限集合
*/
Children?: Array;
}
/**
* CreateUserMobileChangeUrl返回参数结构体
*/
export interface CreateUserMobileChangeUrlResponse {
/**
* 腾讯电子签小程序的实名认证链接。 如果没有传递,默认值是 HTTP。 链接的有效期均是 7 天。
1.如果EndPoint是APP,
得到的链接类似于pages/guide/index?to=MOBILE_CHANGE_INTENTION&shortKey=yDCZHUyOcExAlcOvNod0, 用法可以参考描述中的"跳转到小程序的实现"
2.如果EndPoint是HTTP,
得到的链接类似于https://res.ess.tencent.cn/cdn/h5-activity/jump-mp.html?to=MOBILE_CHANGE_INTENTION&shortKey=yDCZHUyOcChrfpaswT0d,点击后会跳转到腾讯电子签小程序进行签署
3.如果EndPoint是HTTP_SHORT_URL,
得到的链接类似于https://essurl.cn/2n**42Nd,点击后会跳转到腾讯电子签小程序进行签署
注: 生成的链路后面不能再增加参数
*/
Url?: string;
/**
* 链接失效期限,为Unix时间戳(单位秒),有如下规则:
- 如果指定更换绑定手机号的用户(指定用户ID或姓名等信息),则设定的链接失效期限为7天后。
- 如果没有指定更换绑定手机号的用户,则生成通用跳转到个人换手机号的界面,链接不会过期。
*/
ExpireTime?: number;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DescribeFlowTemplates请求参数结构体
*/
export interface DescribeFlowTemplatesRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 查询内容控制
- **0**:模板列表及详情(默认)
- **1**:仅模板列表
*/
ContentType?: number;
/**
* 搜索过滤的条件,本字段允许您通过指定模板 ID 或模板名称来进行查询。- 模板 ID:Key设置为
template-id ,Values为您想要查询的 模板 ID 列表。 - 主企业模板 ID:Key设置为
share-template-id ,Values为您想要查询的 主企业模板 ID 列表。用来查询主企业分享模板到子企业场景下,子企业的模板信息,在此情境下,参数 Agent.ProxyOrganizationId(子企业的组织ID)为必填项。 - 模板名称:Key设置为
template-name ,Values为您想要查询的模板名称列表。 - 模板的用户合同类型:Key设置为
user-flow-type-id ,Values为您想要查询的用户模板类型id列表。
*/
Filters?: Array;
/**
* 查询结果分页返回,指定从第几页返回数据,和Limit参数配合使用。
注:`1.offset从0开始,即第一页为0。`
`2.默认从第一页返回。`
*/
Offset?: number;
/**
* 指定每页返回的数据条数,和Offset参数配合使用。
注:`1.默认值为20,单页做大值为200。`
*/
Limit?: number;
/**
* 通过指定[第三方应用的应用号(ApplicationId)](https://qcloudimg.tencent-cloud.cn/raw/60efa1e9049732e5246b20a268882b1a.png),您可以查询【应用模板库管理】中某个第三方应用下的模板。
注意事项:
- 当 ApplicationId 为空时(默认),系统将查询平台企业的所有模板(自建应用使用的模板)。
- 当 ApplicationId 不为空时,系统将从【应用模板库管理】中查询该特定应用下的模板(分享给第三方应用子企业的模板)。
*/
ApplicationId?: string;
/**
* 默认为false,查询SaaS模板库列表;
为true,查询第三方应用集成平台企业模板库管理列表
* @deprecated
*/
IsChannel?: boolean;
/**
* 暂未开放
* @deprecated
*/
Organization?: OrganizationInfo;
/**
* 暂未开放
* @deprecated
*/
GenerateSource?: number;
/**
* 是否获取模板预览链接。
设置为true之后, 返回参数PreviewUrl,为模板的H5预览链接, 有效期5分钟。可以通过浏览器打开此链接预览模板,或者嵌入到iframe中预览模板。
*/
WithPreviewUrl?: boolean;
}
/**
* DescribeFlowEvidenceReport返回参数结构体
*/
export interface DescribeFlowEvidenceReportResponse {
/**
* 出证报告PDF的下载 URL,`有效期为5分钟`,超过有效期后将无法再下载。
*/
ReportUrl?: string;
/**
* 出证任务执行的状态, 状态含义如下:
- **EvidenceStatusExecuting**: 出证任务在执行中
- **EvidenceStatusSuccess**: 出证任务执行成功
- **EvidenceStatusFailed** : 出证任务执行失败
*/
Status?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateRiskIdentificationTaskFeedback返回参数结构体
*/
export interface CreateRiskIdentificationTaskFeedbackResponse {
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 批量认证企业任务详情信息,其中包括 TaskId,状态信息等。
*/
export interface BatchOrganizationRegistrationTasksDetails {
/**
* 生成注册链接的任务Id
*/
TaskId?: string;
/**
* 批量创建企业任务的状态
- Processing
- Create
- Submit
- Authorization
- Failed
各个状态所代表的含义如下表格所示:
| 任务状态名称 | 任务状态详情 |
| Processing | 企业认证任务处理中,用户调用了CreateBatchOrganizationRegistrationTasks接口,但是任务还在处理中的状态 |
| Create | 创建企业认证链接任务完成,可以调用生成任务链接接口 |
| Submit | 企业认证任务已提交,到如下界面之后,会变为这个状态
 |
| Authorization | 企业认证任务认证成功,点击下图下一步,进入到授权书上传或者法人认证,则会变为这个状态
 |
| Failed | 企业认证任务失败 |
*/
Status?: string;
/**
* 如果任务失败,会返回错误信息
*/
ErrorMessage?: string;
/**
* 认证流 Id 是指在企业认证过程中,当前操作人的认证流程的唯一标识。每个企业在认证过程中只能有一条认证流认证成功。这意味着在同一认证过程内,一个企业只能有一个认证流程处于成功状态,以确保认证的唯一性和有效性。认证流 Id可以通过回调[授权书认证审核结果回调](https://qian.tencent.com/developers/company/callback_types_staffs/#%E5%8D%81%E5%85%AD-%E6%8E%88%E6%9D%83%E4%B9%A6%E8%AE%A4%E8%AF%81%E5%AE%A1%E6%A0%B8%E7%BB%93%E6%9E%9C%E5%9B%9E%E8%B0%83)
*/
AuthorizationInfoId?: string;
}
/**
* 参与方填写控件信息
*/
export interface RecipientComponentInfo {
/**
* 签署方经办人在合同流程中的参与方ID,与控件绑定,是控件的归属方
*/
RecipientId?: string;
/**
* 参与方填写状态
- **空值** : 此参与方没有填写控件
- **0**: 未填写, 表示此参与方还没有填写合同的填写控件
- **1**: 已填写, 表示此参与方已经填写所有的填写控件
*/
RecipientFillStatus?: string;
/**
* 是否为发起方
*/
IsPromoter?: boolean;
/**
* 改参与方填写控件信息列表
*/
Components?: Array;
}
/**
* ExportContractReviewResult返回参数结构体
*/
export interface ExportContractReviewResultResponse {
/**
* 文件下载链接
*/
Url?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 单点登录企业员工信息。
*/
export interface SingleSignOnEmployees {
/**
* 用户在idp分配的唯一值,需要保持跟在电子签应用集成->单点登录配置->端点配置中配置的。
如下图配置。
*/
OpenId: string;
/**
* 企业员工姓名。 员工的姓名将用于身份认证和电子签名,请确保填写的姓名为签署方的真实姓名,而非昵称等代名。
*/
Name: string;
/**
* 用户手机号码, 支持中国大陆手机号11位数字(无需加+86前缀或其他字符)。
*/
Mobile: string;
/**
* 员工在腾讯电子签平台的唯一身份标识,为32位字符串。
注:`创建和更新场景无需填写。`
*/
UserId?: string;
/**
* 用户邮箱。
*/
Email?: string;
/**
* 员工角色信息。
此处roleId为电子签配置的 RoleId,可通过接口[查询企业角色列表](https://qian.tencent.com/developers/companyApis/roles/DescribeIntegrationRoles) 获取
*/
RoleIds?: Array;
/**
* 员工是否实名。
*/
IsVerified?: boolean;
/**
* 员工创建时间戳,单位秒。
*/
CreatedOn?: number;
}
/**
* 页面主题配置
*/
export interface WebThemeConfig {
/**
* 是否显示页面底部电子签logo,取值如下:
- **true**:页面底部显示电子签logo
- **false**:页面底部不显示电子签logo(默认)
*/
DisplaySignBrandLogo?: boolean;
/**
* 主题颜色:
支持十六进制颜色值以及RGB格式颜色值,例如:#D54941,rgb(213, 73, 65)
*/
WebEmbedThemeColor?: string;
}
/**
* CreateBatchContractReviewTask请求参数结构体
*/
export interface CreateBatchContractReviewTaskRequest {
/**
* 执行合同审查任务的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 合同审查的PDF、WORD文件资源编号列表,通过[UploadFiles](https://qian.tencent.com/developers/companyApis/templatesAndFiles/UploadFiles)接口获取PDF、WORD文件资源编号。
注: `目前,此接口仅支持5个文件发起。每个文件限制在10M以下,文件必须是PDF、WORD格式`
*/
ResourceIds: Array;
/**
* 合同审查的审查尺度。默认为`0`严格尺度
审查尺度如下:
- **0** - 【严格】以保护己方利益为核心,对合同条款进行严格把控,尽可能争取对己方有利的条款,同时对对方提出的不合理条款可进行坚决修改或删除。
- **1** - 【中立】以公平合理为原则,平衡双方的权利义务,既不过分强调己方利益,也不过度让步,力求达成双方均可接受的条款。
- **2** - 【宽松】以促成交易为核心,对合同条款的修改要求较为宽松,倾向于接受对方提出的条款,以尽快达成合作。
*/
PolicyType?: number;
/**
* 该字段已不再使用!
合同审查中的角色信息,通过明确入参角色的名称和描述,可以提高合同审查的效率和准确性。用户不做配置时大模型会根据合同内容推荐出风险识别角色的名称和描述信息。
*/
Role?: RiskIdentificationRoleInfo;
/**
* 合同审查中的角色信息,通过明确入参角色的名称和描述,可以提高合同审查的效率和准确性。用户不做配置时大模型会根据合同内容推荐出风险识别角色的名称和描述信息。
*/
Roles?: Array;
/**
* 该字段已不再使用!
用户配置的审查清单ID,基于此清单ID批量创建合同审查任务,为32位字符串。[点击查看审查清单ID在控制台上的位置](https://qcloudimg.tencent-cloud.cn/raw/2c6588549e28ca49bd8bb7f4a072b19e.png)。如果用户不做此配置大模型会根据合同内容在当前企业下的审查清单和系统默认的清单中选择一个清单进行审查。
*/
ChecklistId?: string;
/**
* 用户配置的审查清单ID,基于此清单ID批量创建合同审查任务,为32位字符串。[点击查看审查清单ID在控制台上的位置](https://qcloudimg.tencent-cloud.cn/raw/2c6588549e28ca49bd8bb7f4a072b19e.png)。如果用户不做此配置大模型会根据合同内容在当前企业下的审查清单和系统默认的清单中选择一个清单进行审查。
*/
ChecklistIds?: Array;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 备注信息,长度不能超过100个字符
*/
Comment?: string;
/**
* 调用方自定义的个性化字段(可自定义此名称),并以base64方式编码,支持的最大数据大小为 1024长度。
在合同状态变更的回调信息等场景中,该字段的信息将原封不动地透传给贵方。回调的相关说明可参考开发者中心的[回调通知](https://qian.tencent.com/developers/company/callback_types_v2)模块。
*/
UserData?: string;
/**
* 启用附加通用风险审查清单。默认为启用状态
可选值如下:
- 1: 启用系统提供的附加通用风险审查清单
- 2:不启用系统提供的附加通用风险审查清单
*/
EnableGeneralChecklist?: number;
}
/**
* DeleteIntegrationDepartment返回参数结构体
*/
export interface DeleteIntegrationDepartmentResponse {
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 自动签开启、签署相关配置
*/
export interface AutoSignConfig {
/**
* 自动签开通个人用户信息, 包括名字,身份证等
*/
UserInfo: UserThreeFactor;
/**
* 是否回调证书信息:
- **false**: 不需要(默认)
- **true**:需要
注:`该字段已经失效,请勿设置此参数。`
*/
CertInfoCallback?: boolean;
/**
* 是否支持用户自定义签名印章:
- **false**: 不能自己定义(默认)
- **true**: 可以自己定义
*/
UserDefineSeal?: boolean;
/**
* 回调中是否需要自动签将要使用的印章(签名) 图片的 base64:
- **false**: 不需要(默认)
- **true**: 需要
*/
SealImgCallback?: boolean;
/**
* 执行结果的回调URL,该URL仅支持HTTP或HTTPS协议,建议采用HTTPS协议以保证数据传输的安全性。
腾讯电子签服务器将通过POST方式,application/json格式通知执行结果,请确保外网可以正常访问该URL。
回调的相关说明可参考开发者中心的回调通知模块。
* @deprecated
*/
CallbackUrl?: string;
/**
* 开通时候的身份验证方式, 取值为:
- **WEIXINAPP** : 微信人脸识别
- **INSIGHT** : 慧眼人脸识别
- **TELECOM** : 运营商三要素验证
注:
- 如果是小程序开通链接,仅支持 WEIXINAPP 。为空默认 WEIXINAPP
- 如果是 H5 开通链接,支持传 INSIGHT / TELECOM。为空默认 INSIGHT
*/
VerifyChannels?: Array;
/**
* 设置用户自动签合同的扣费方式。
注:`该字段已经失效,请勿设置此参数。`
*/
LicenseType?: number;
/**
* 开通成功后前端页面跳转的url,此字段的用法场景请联系客户经理确认。
注:`仅支持H5开通场景`, `跳转链接仅支持 https:// , qianapp:// 开头`
跳转场景:
- **贵方H5 -> 腾讯电子签H5 -> 贵方H5** : JumpUrl格式: https://YOUR_CUSTOM_URL/xxxx,只需满足 https:// 开头的正确且合规的网址即可。
- **贵方原生App -> 腾讯电子签H5 -> 贵方原生App** : JumpUrl格式: qianapp://YOUR_CUSTOM_URL,只需满足 qianapp:// 开头的URL即可。`APP实现方,需要拦截Webview地址跳转,发现url是qianapp:// 开头时跳转到原生页面。`APP拦截地址跳转可参考:Android,IOS
成功结果返回:
若贵方需要在跳转回时通过链接query参数提示开通成功,JumpUrl中的query应携带如下参数:`appendResult=qian`。这样腾讯电子签H5会在跳转回的url后面会添加query参数提示贵方签署成功,例如: qianapp://YOUR_CUSTOM_URL?action=sign&result=success&from=tencent_ess
*/
JumpUrl?: string;
}
/**
* DescribeThirdPartyAuthCode请求参数结构体
*/
export interface DescribeThirdPartyAuthCodeRequest {
/**
* 腾讯电子签小程序跳转客户企业小程序时携带的授权查看码,AuthCode由腾讯电子签小程序生成。
*/
AuthCode: string;
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator?: UserInfo;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
}
/**
* 合同摘要
*/
export interface ContractSummary {
/**
* 提取内容分类:
Base 合同信息
Identity 主体信息
Performance 履约条款
*/
Name?: string;
/**
* 详细信息
*/
Infos?: Array;
}
/**
* CreateBatchInitOrganizationUrl请求参数结构体
*/
export interface CreateBatchInitOrganizationUrlRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 初始化操作类型
- CREATE_SEAL : 创建印章
- AUTH_JOIN_ORGANIZATION_GROUP : 加入集团企业
- OPEN_AUTO_SIGN :开通企业自动签署
- PARTNER_AUTO_SIGN_AUTH :合作方企业授权自动签
- CHANGE_SUB_ORGANIZATION_ADMIN_AUTH :变更子企业超管授权(**授权后,主企业可变更子企业超管,此功能需联系客户经理开通白名单使用**)
*/
OperateTypes: Array;
/**
* 批量操作的企业Id列表,最大支持50个
*/
OrganizationIds: Array;
/**
* 代理相关应用信息,如集团主企业代子企业操作的场景中ProxyOrganizationId必填
*/
Agent?: Agent;
/**
* 被授权的合作方企业在电子签的企业电子签账号,当操作类型包含 PARTNER_AUTO_SIGN_AUTH (合作方企业授权自动签)时必传。
企业电子签账号可在[电子签的网页端](https://qian.tencent.com/console/company-settings/company-center) ,于企业设置-企业信息菜单栏下复制获取。

*/
AuthorizedOrganizationId?: string;
/**
* 初始化操作类型里含有CHANGE_SUB_ORGANIZATION_ADMIN_AUTH(变更子企业超管授权)操作类型时,授权协议中主企业的签署方是否使用自动签(需操作人有自动签授权)
*/
ChangeAdminAuthAutoSign?: boolean;
}
/**
* DeleteOrganizationAuthorizations返回参数结构体
*/
export interface DeleteOrganizationAuthorizationsResponse {
/**
* 清理的认证流的详细信息,其中包括企业名称,认证流唯一 Id 以及清理过程中产生的错误信息
*/
DeleteOrganizationAuthorizationInfos?: Array;
/**
* 批量清理认证流返回的状态值
其中包括
- 1 全部成功
- 2 部分成功
- 3 全部失败
*/
Status?: number;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 小程序发起页面个性化配置参数
*/
export interface MiniAppCreateFlowPageOption {
/**
* 发起后隐藏签署码
*/
HideSignCodeAfterStart?: boolean;
}
/**
* 签署人详情信息
*/
export interface FlowApproverDetail {
/**
* 签署时的相关信息
*/
ApproveMessage?: string;
/**
* 签署方姓名
*/
ApproveName?: string;
/**
* 签署方的签署状态
0:还没有发起
1:流程中 没有开始处理
2:待签署
3:已签署
4:已拒绝
5:已过期
6:已撤销
7:还没有预发起
8:待填写
9:因为各种原因而终止
10:填写完成
15:已解除
19:转他人处理
*/
ApproveStatus?: number;
/**
* 模板配置中的参与方ID,与控件绑定
* @deprecated
*/
ReceiptId?: string;
/**
* 客户自定义的用户ID
*/
CustomUserId?: string;
/**
* 签署人手机号
*/
Mobile?: string;
/**
* 签署顺序,如果是有序签署,签署顺序从小到大
*/
SignOrder?: number;
/**
* 签署人签署时间,时间戳,单位秒
*/
ApproveTime?: number;
/**
* 签署方类型,ORGANIZATION-企业员工,PERSON-个人,ENTERPRISESERVER-企业静默签
*/
ApproveType?: string;
/**
* 签署方侧用户来源,如WEWORKAPP-企业微信等
*/
ApproverSource?: string;
/**
* 客户自定义签署方标识
*/
CustomApproverTag?: string;
/**
* 签署方企业Id
*/
OrganizationId?: string;
/**
* 签署方企业名称
*/
OrganizationName?: string;
/**
* 签署参与人在本流程中的编号ID(每个流程不同),可用此ID来定位签署参与人在本流程的签署节点,也可用于后续创建签署链接等操作。
*/
SignId?: string;
/**
* 自定义签署人角色
*/
ApproverRoleName?: string;
/**
* 模板配置中的参与方ID,与控件绑定
*/
RecipientId?: string;
}
/**
* CreateFlowForwards请求参数结构体
*/
export interface CreateFlowForwardsRequest {
/**
* 执行本接口操作的员工信息。注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 合同对应参与方需要修改的目标经办人。其UserId可在企业控制台中组织管理里面找到。或者使用获取员工信息接口得到。
注意:`需要保证目标经办人已经加入企业且已实名`
*/
TargetUserId: string;
/**
* 企业签署方的合同及对应签署方
*/
FlowForwardInfos: Array;
/**
* 代理企业和员工的信息。在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
}
/**
* CreateIntegrationDepartment返回参数结构体
*/
export interface CreateIntegrationDepartmentResponse {
/**
* 电子签部门ID。建议开发者保存此部门ID,方便后续查询或修改部门信息。
*/
DeptId?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 跳转事件的结构体,其中包括认证期间收录,授权书审核,企业认证的回跳事件。
*/
export interface JumpEvent {
/**
* 跳转事件枚举,
* 1 - 企业收录。
* 2 - 超管授权书审核。
* 3 - 认证完成。
*/
JumpEventType?: number;
/**
* 为认证成功后页面进行回跳的URL,请确保回跳地址的可用性。
Endpoint如果是APP 类型,请传递"true"
如果 Endpoint 是 H5 类型,请参考文档[跳转电子签H5](https://qian.tencent.com/developers/company/openqianh5/)
p.s. 如果Endpoint是 APP,传递的跳转地址无效,不会进行跳转,仅会进行回跳。
*/
JumpUrl?: string;
}
/**
* DeleteSealPolicies返回参数结构体
*/
export interface DeleteSealPoliciesResponse {
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DescribeOrganizationAuthStatus返回参数结构体
*/
export interface DescribeOrganizationAuthStatusResponse {
/**
* 企业是否已认证
*/
IsVerified?: boolean;
/**
* 企业认证状态 0-未认证 1-认证中 2-已认证
*/
AuthStatus?: number;
/**
* 企业认证信息
*/
AuthRecords?: Array;
/**
* 企业在腾讯电子签平台的唯一身份标识,为32位字符串。
可登录腾讯电子签控制台,在 "更多"->"企业设置"->"企业中心"- 中查看企业电子签账号。
p.s. 只有当前企业认证成功的时候返回
*/
OrganizationId?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DescribeBatchOrganizationRegistrationTasks请求参数结构体
*/
export interface DescribeBatchOrganizationRegistrationTasksRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 企业批量认证链接的子任务 SubTaskId,该 SubTaskId 是通过接口[查询企业批量认证链接](https://qian.tencent.com/developers/companyApis/organizations/DescribeBatchOrganizationRegistrationUrls)可以得到。
*/
TaskIds?: Array;
}
/**
* 用户的三要素:姓名,证件号,证件类型
*/
export interface UserThreeFactor {
/**
* 签署方经办人的姓名。
经办人的姓名将用于身份认证和电子签名,请确保填写的姓名为签署方的真实姓名,而非昵称等代名。
*/
Name: string;
/**
* 证件类型,支持以下类型
- ID_CARD : 中国大陆居民身份证 (默认值)
- HONGKONG_AND_MACAO : 中国港澳居民来往内地通行证
- HONGKONG_MACAO_AND_TAIWAN : 中国港澳台居民居住证(格式同中国大陆居民身份证)
*/
IdCardType: string;
/**
* 证件号码,应符合以下规则
- 中国大陆居民身份证号码应为18位字符串,由数字和大写字母X组成(如存在X,请大写)。
- 中国港澳居民来往内地通行证号码共11位。第1位为字母,“H”字头签发给中国香港居民,“M”字头签发给中国澳门居民;第2位至第11位为数字。
- 中国港澳台居民居住证号码编码规则与中国大陆身份证相同,应为18位字符串。
*/
IdCardNumber: string;
}
/**
* 签署二维码的基本信息,用于创建二维码,用户可扫描该二维码进行签署操作。
*/
export interface SignQrCode {
/**
* 二维码ID,为32位字符串。
*/
QrCodeId?: string;
/**
* 二维码URL,可通过转换二维码的工具或代码组件将此URL转化为二维码,以便用户扫描进行流程签署。
*/
QrCodeUrl?: string;
/**
* 二维码的有截止时间,格式为Unix标准时间戳(秒)。
一旦超过二维码的有效期限,该二维码将自动失效。
*/
ExpiredTime?: number;
/**
* 微信小程序二维码
*/
WeixinQrCodeUrl?: string;
}
/**
* CreateSealPolicy返回参数结构体
*/
export interface CreateSealPolicyResponse {
/**
* 最终授权成功的用户ID,在腾讯电子签平台的唯一身份标识,为32位字符串。
可登录腾讯电子签控制台,在 "更多能力"->"组织管理" 中查看某位员工的UserId(在页面中展示为用户ID)。
*/
UserIds?: Array;
/**
* 人脸验证操作人链接,用法可以参考"[跳转电子签小程序配置](https://qian.tencent.com/developers/company/openwxminiprogram/)",默认为空。
*/
SealOperatorVerifyPath?: string;
/**
* 人脸验证操作人二维码链接,扫码后会跳转到腾讯电子签小程序进行人脸验证,默认为空。
*/
SealOperatorVerifyQrcodeUrl?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateSchemeUrl返回参数结构体
*/
export interface CreateSchemeUrlResponse {
/**
* 腾讯电子签小程序的签署链接。
- 如果EndPoint是**APP**,得到的链接类似于`pages/guide?from=default&where=mini&id=yDwJSUUirqauh***7jNSxwdirTSGuH&to=CONTRACT_DETAIL&name=&phone=&shortKey=yDw***k1xFc5`, 用法可以参加接口描述中的"跳转到小程序的实现"
- 如果EndPoint是**HTTP**,得到的链接类似于 `https://res.ess.tencent.cn/cdn/h5-activity/jump-mp.html?where=mini&from=SFY&id=yDwfEUUw**4rV6Avz&to=MVP_CONTRACT_COVER&name=%E9%83%**5%86%9B`,点击后会跳转到腾讯电子签小程序进行签署
- 如果EndPoint是**HTTP_SHORT_URL**,得到的链接类似于 `https://essurl.cn/2n**42Nd`,点击后会跳转到腾讯电子签小程序进行签署
注: 生成的链路后面不能再增加参数
*/
SchemeUrl?: string;
/**
* 二维码,在生成动态签署人跳转封面页链接时返回 注:`此二维码下载链接有效期为5分钟,可下载二维码后本地保存。`
*/
SchemeQrcodeUrl?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateFlowSignUrl返回参数结构体
*/
export interface CreateFlowSignUrlResponse {
/**
* 签署人签署链接信息
*/
FlowApproverUrlInfos?: Array;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* RenewAutoSignLicense返回参数结构体
*/
export interface RenewAutoSignLicenseResponse {
/**
* 续期成功后新的自动签许可到期时间。当且仅当已通过许可开通自动签时有值。
值为unix时间戳,单位为秒。
*/
LicenseTo?: number;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 用户信息
*/
export interface UserInfo {
/**
* 用户在平台的编号
*/
UserId?: string;
/**
* 用户的来源渠道,一般不用传,特定场景根据接口说明传值
* @deprecated
*/
Channel?: string;
/**
* 用户在渠道的编号,一般不用传,特定场景根据接口说明传值
* @deprecated
*/
OpenId?: string;
/**
* 用户真实IP,内部字段,暂未开放
* @deprecated
*/
ClientIp?: string;
/**
* 用户代理IP,内部字段,暂未开放
* @deprecated
*/
ProxyIp?: string;
}
/**
* 授权企业列表(目前仅用于“企业自动签 -> 合作企业授权”)
*/
export interface HasAuthOrganization {
/**
* 授权企业id
*/
OrganizationId?: string;
/**
* 授权企业名称
*/
OrganizationName?: string;
/**
* 被授权企业id
*/
AuthorizedOrganizationId?: string;
/**
* 被授权企业名称
*/
AuthorizedOrganizationName?: string;
/**
* 授权模板id(仅当授权方式为模板授权时有值)
*/
TemplateId?: string;
/**
* 授权模板名称(仅当授权方式为模板授权时有值)
*/
TemplateName?: string;
/**
* 授权时间,格式为时间戳,单位s
*/
AuthorizeTime?: number;
}
/**
* CreateIntegrationRole返回参数结构体
*/
export interface CreateIntegrationRoleResponse {
/**
* 角色id
*/
RoleId?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DescribeFlowComponents请求参数结构体
*/
export interface DescribeFlowComponentsRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 合同流程ID,为32位字符串。
[点击查看FlowId在控制台中的位置](https://qcloudimg.tencent-cloud.cn/raw/0a83015166cfe1cb043d14f9ec4bd75e.png)
*/
FlowId: string;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
}
/**
* VerifyDigitFile返回参数结构体
*/
export interface VerifyDigitFileResponse {
/**
* 加签文件MD5哈希值
*/
PdfResourceMd5?: string;
/**
* 验签结果代码,代码的含义如下:- **1**:文件验证成功。
- **2**:文件验证失败。
*/
VerifyResult?: number;
/**
* 验签序列号, 为11位数字组成的字符串
*/
VerifySerialNo?: string;
/**
* 验签结果详情,每个签名域对应的验签结果。
*/
VerifyDigitFileResults?: Array;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateContractReviewChecklistWebUrl返回参数结构体
*/
export interface CreateContractReviewChecklistWebUrlResponse {
/**
* 嵌入式web页面链接。注意:`链接有效期为5分钟,且链接仅能使用一次。`
*/
WebUrl?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DeleteIntegrationEmployees请求参数结构体
*/
export interface DeleteIntegrationEmployeesRequest {
/**
* 执行本接口操作的员工信息。使用此接口时,必须填写UserId。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 待离职员工的信息最多不超过100个。应符合以下规则:
1. UserId和OpenId不可同时为空,必须填写其中一个,优先使用UserId。
2. **若需要进行离职交接**,交接人信息ReceiveUserId和ReceiveOpenId不可同时为空,必须填写其中一个,优先使用ReceiveUserId。
*/
Employees: Array;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
}
/**
* 更新员工信息失败返回的数据信息
*/
export interface FailedUpdateStaffData {
/**
* 用户传入的名称
*/
DisplayName?: string;
/**
* 用户传入的手机号,明文展示
*/
Mobile?: string;
/**
* 失败原因
*/
Reason?: string;
/**
* 员工在腾讯电子签平台的唯一身份标识,为32位字符串。
可登录腾讯电子签控制台,在 "更多能力"->"组织管理" 中查看某位员工的UserId(在页面中展示为用户ID)。
*/
UserId?: string;
/**
* 员工在第三方平台的openId
*/
OpenId?: string;
}
/**
* GetTaskResultApi请求参数结构体
*/
export interface GetTaskResultApiRequest {
/**
* 转换任务Id,通过接口创建文件转换任务接口得到的转换任务id
*/
TaskId: string;
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator?: UserInfo;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 暂未开放
* @deprecated
*/
Organization?: OrganizationInfo;
}
/**
* 合同审查清单
*/
export interface Checklist {
/**
* 审查清单id
*/
Id?: string;
/**
* 审查清单名称
*/
Name?: string;
/**
* 审查点数量
*/
Count?: number;
/**
* 启用状态
*/
Enabled?: boolean;
/**
* 修改人
*/
Updater?: string;
/**
* 修改时间
*/
ModifiedOn?: number;
/**
* 是否官方清单
*/
Official?: boolean;
/**
* 配置状态,[0(未配置), 1(已配置)]
*/
ConfigStatus?: number;
}
/**
* CreatePartnerAuthorizationLink请求参数结构体
*/
export interface CreatePartnerAuthorizationLinkRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 腾讯电子签平台给生态集成方分配的**生态集成业务标识**,
**此生态集成业务标识需要提前联系产品经理配置**。
*/
BusinessId: string;
/**
* 合作方企业在腾讯电子签注册企业后生成的企业id,需要合作方企业登录
电子签控制台获取

*/
PartnerOrganizationId: string;
/**
* 第三方应用的配置信息。
其中包括 回调地址,加密KEY等信息。
*/
ApplicationInfo: CallbackInfo;
/**
* 第三方应用下企业用户信息。
其中包括企业的OrganizationOpenId和超管的UserOpenId。
具体含义请参考结构体解释
*/
ProxyOrganizationInfo: ProxyOrganizationInfo;
/**
* 若未填写,则会创建一个生态集成应用。
若填写, 则必须是生态集成企业给合作方企业通过此接口**CreatePartnerAuthorizationLink**创建的应用号。
应用号可以从下图位置获取。

*/
PartnerApplicationId?: string;
}
/**
* 动态签署领取链接配置,当全部签署方均为动态签署方时生效。
*/
export interface DynamicSignOption {
/**
* 多份合同批量签署时,动态签署领取要求:- 0(默认值): 可以领取部分合同进入签署。
- 1 : 必须全部领取进入签署,生成链接的所有合同必须相同经办人完成合同的领取签署。
*/
DynamicReceiveType?: number;
/**
* 动态签署方时,预设的企业名称,预设企业名称后,只允许对应的企业员工进行领取签署。
*/
OrganizationName?: string;
}
/**
* 此结构体(FlowDetailInfo)描述的是合同(流程)的详细信息
*/
export interface FlowDetailInfo {
/**
* 合同流程ID,为32位字符串。
*/
FlowId?: string;
/**
* 合同流程的名称(可自定义此名称),长度不能超过200,只能由中文、字母、数字和下划线组成。
*/
FlowName?: string;
/**
* 合同流程的类别分类(如销售合同/入职合同等)。
该字段将被废弃,不建议使用。
*/
FlowType?: string;
/**
* 合同流程当前的签署状态, 会存在下列的状态值
- **0** : 未开启流程(合同中不存在填写环节)
- **1** : 待签署
- **2** : 部分签署
- **3** : 已拒签
- **4** : 已签署
- **5** : 已过期
- **6** : 已撤销
- **7** : 未开启流程(合同中存在填写环节)
- **8** : 等待填写
- **9** : 部分填写
- **10** : 已拒填
- **16** : 已失效(可能因为参与方修改姓名等原因)
- **21** : 已解除
*/
FlowStatus?: number;
/**
* 当合同流程状态为已拒签(即 FlowStatus=3)或已撤销(即 FlowStatus=6)时,此字段 FlowMessage 为拒签或撤销原因。
*/
FlowMessage?: string;
/**
* 合同流程描述信息。
*/
FlowDescription?: string;
/**
* 合同流程的创建时间戳,格式为Unix标准时间戳(秒)。
*/
CreatedOn?: number;
/**
* 合同流程的签署方数组
*/
FlowApproverInfos?: Array;
/**
* 合同流程的关注方信息数组
*/
CcInfos?: Array;
/**
* 合同流程发起方的员工编号, 即员工在腾讯电子签平台的唯一身份标识。
*/
Creator?: string;
/**
* 用户合同的自定义分类。
自定义合同类型的位置,在下图所示地方:

*/
UserFlowType?: UserFlowType;
/**
* 发起模板时,使用的模板Id
*/
TemplateId?: string;
}
/**
* CreatePersonAuthCertificateImage请求参数结构体
*/
export interface CreatePersonAuthCertificateImageRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 个人用户名称
*/
UserName: string;
/**
* 证件类型,支持以下类型
- ID_CARD : 中国大陆居民身份证 (默认值)
- HONGKONG_AND_MACAO : 中国港澳居民来往内地通行证
- HONGKONG_MACAO_AND_TAIWAN : 中国港澳台居民居住证(格式同中国大陆居民身份证)
*/
IdCardType: string;
/**
* 证件号码,应符合以下规则
- 中国大陆居民身份证号码应为18位字符串,由数字和大写字母X组成(如存在X,请大写)。
- 中国港澳居民来往内地通行证号码共11位。第1位为字母,“H”字头签发给中国香港居民,“M”字头签发给中国澳门居民;第2位至第11位为数字。
- 中国港澳台居民居住证号码编码规则与中国大陆身份证相同,应为18位字符串。
*/
IdCardNumber: string;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 自动签使用的场景值, 可以选择的场景值如下:
- **E_PRESCRIPTION_AUTO_SIGN** : 电子处方场景
- **OTHER** : 通用场景
注: `不传默认为处方单场景,即E_PRESCRIPTION_AUTO_SIGN`
*/
SceneKey?: string;
}
/**
* CreateFlowByFiles返回参数结构体
*/
export interface CreateFlowByFilesResponse {
/**
* 合同流程ID,为32位字符串。
建议开发者妥善保存此流程ID,以便于顺利进行后续操作。
注: 如果是预览模式(即NeedPreview设置为true)时, 此处不会有值返回。
[点击查看FlowId在控制台中的位置](https://qcloudimg.tencent-cloud.cn/raw/0a83015166cfe1cb043d14f9ec4bd75e.png)
*/
FlowId?: string;
/**
* 合同预览链接URL。
注:如果是预览模式(即NeedPreview设置为true)时, 才会有此预览链接URL
*/
PreviewUrl?: string;
/**
* 签署方信息,如角色ID、角色名称等
*/
Approvers?: Array;
/**
* 发起审批流id,仅在CreateFlowByFiles时指定了WorkFlow=true时返回
*/
WorkflowInstanceId?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* UploadFiles返回参数结构体
*/
export interface UploadFilesResponse {
/**
* 文件资源ID数组,每个文件资源ID为32位字符串。
建议开发者保存此资源ID,后续创建合同或创建合同流程需此资源ID。
注:`有效期一个小时(超过一小时后系统不定期清理,会有部分时间差), 有效期内此文件id可以反复使用, 超过有效期无法使用`
*/
FileIds?: Array;
/**
* 上传成功文件数量
*/
TotalCount?: number;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 预设的动态签署方的补充信息,仅匹配对应信息的签署方才能领取合同。暂时仅对个人参与方生效。
*/
export interface PresetApproverInfo {
/**
* 预设参与方姓名。
*/
Name?: string;
/**
* 预设参与方手机号。
*/
Mobile?: string;
/**
* 预设参与方证件号,需要和IdCardType同时传入。
证件号码,应符合以下规则
- 中国大陆居民身份证号码应为18位字符串,由数字和大写字母X组成(如存在X,请大写)。
*/
IdCardNumber?: string;
/**
* 预设参与方的证件类型,需要与IdCardNumber同时传入。
证件类型,支持以下类型
*/
IdCardType?: string;
}
/**
* DescribeContractReviewChecklistsWebUrl返回参数结构体
*/
export interface DescribeContractReviewChecklistsWebUrlResponse {
/**
* 嵌入式web页面链接。注意:`链接有效期为5分钟,且链接仅能使用一次。`
*/
WebUrl?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DescribeBillUsage返回参数结构体
*/
export interface DescribeBillUsageResponse {
/**
* 企业套餐余额及使用情况
*/
Summary?: Array;
/**
* 集团子企业套餐使用情况
*/
SubOrgSummary?: Array;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* ModifyIntegrationDepartment请求参数结构体
*/
export interface ModifyIntegrationDepartmentRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得组织架构管理权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 电子签部门ID,通过DescribeIntegrationDepartments接口获得。
*/
DeptId: string;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 电子签父部门ID,通过DescribeIntegrationDepartments接口获得。
*/
ParentDeptId?: string;
/**
* 部门名称,最大长度为50个字符。
*/
DeptName?: string;
/**
* 客户系统部门ID,最大长度为64个字符。
*/
DeptOpenId?: string;
/**
* 排序号,支持设置的数值范围为1~30000。同一父部门下,排序号越大,部门顺序越靠前。
*/
OrderNo?: number;
}
/**
* 合同转交相关信息
*/
export interface FlowForwardInfo {
/**
* 合同流程ID,为32位字符串。此接口的合同流程ID需要由[创建签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlow)接口创建得到。
*/
FlowId: string;
/**
* 签署方经办人在合同中的参与方ID,为32位字符串。
*/
RecipientId: string;
}
/**
* CreateOrganizationBatchSignUrl返回参数结构体
*/
export interface CreateOrganizationBatchSignUrlResponse {
/**
* 批量签署入口链接,用户可使用这个链接跳转到控制台页面对合同进行签署操作。
*/
SignUrl?: string;
/**
* 链接过期截止时间,格式为Unix标准时间戳(秒),默认为7天后截止。
*/
ExpiredTime?: number;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 模板中文件的信息结构
*/
export interface FileInfo {
/**
* 文件ID
*/
FileId?: string;
/**
* 文件名
*/
FileName?: string;
/**
* 文件大小,单位为Byte
*/
FileSize?: number;
/**
* 文件上传时间,格式为Unix标准时间戳(秒)
*/
CreatedOn?: number;
}
/**
* 信息提取结果字段反馈
*/
export interface FeedbackInfo {
/**
* 合同信息提取结果反馈。
`值如下`:
- 0: 未反馈
- 1: 信息提取正确
- 2: 信息提取有错误
*/
Result?: number;
/**
* 信息提取错误原因,当Result为2时需要填写此信息
*/
Reason?: FeedbackInfoReason;
}
/**
* CreatePartnerAutoSignAuthUrl请求参数结构体
*/
export interface CreatePartnerAutoSignAuthUrlRequest {
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator?: UserInfo;
/**
* 被授企业id/授权方企业id(即OrganizationId),和AuthorizedOrganizationName二选一传入
*/
AuthorizedOrganizationId?: string;
/**
* 被授企业名称/授权方企业的名字,和AuthorizedOrganizationId二选一传入即可。请确认该名称与企业营业执照中注册的名称一致。
注: `如果名称中包含英文括号(),请使用中文括号()代替。`
*/
AuthorizedOrganizationName?: string;
/**
* 在设置印章授权时,可以指定特定的印章类型,以确保在授权过程中只使用相应类型的印章。支持的印章类型包括:
- OFFICIAL:企业公章,用于代表企业对外的正式文件和重要事务的认证。
- CONTRACT:合同专用章,专门用于签署各类合同。
- FINANCE:财务专用章,用于企业的财务相关文件,如发票、收据等财务凭证的认证。
- PERSONNEL:人事专用章,用于人事管理相关文件,如劳动合同、人事任命等。
*/
SealTypes?: Array;
/**
* 在处理授权关系时,授权的方向
- false(默认值):表示我方授权他方。在这种情况下,
AuthorizedOrganizationName 代表的是【被授权方】的企业名称,即接收授权的企业。
- true:表示他方授权我方。在这种情况下,
AuthorizedOrganizationName 代表的是【授权方】的企业名称,即提供授权的企业。
*/
AuthToMe?: boolean;
}
/**
* CreatePartnerAuthorizationLink返回参数结构体
*/
export interface CreatePartnerAuthorizationLinkResponse {
/**
* 授权链接,以短链形式返回。短链的有效期参考回参中的 ExpiredTime。
注:
1. 非小程序和APP集成使用
2. 生成的链路后面不能再增加参数(会出现覆盖链接中已有参数导致错误)
*/
Link?: string;
/**
* 链接过期时间以 Unix 时间戳格式表示,从生成链接时间起,往后7天有效期。过期后短链将失效,无法打开。
*/
ExpireTime?: number;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateExtendedServiceAuthInfos返回参数结构体
*/
export interface CreateExtendedServiceAuthInfosResponse {
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 合同信息提取结果
*/
export interface ExtractionTaskResult {
/**
* 用于合同信息提取的资源ID。
*/
ResourceId?: string;
/**
* 用于合同信息提取的资源名称。
*/
ResourceName?: string;
/**
* 根据当前合同提取出的字段信息
*/
ExtractionFieldResults?: Array;
}
/**
* 指定签署人限制项
*/
export interface ApproverRestriction {
/**
* 指定签署人名字
*/
Name?: string;
/**
* 指定签署人手机号,11位数字
*/
Mobile?: string;
/**
* 指定签署人证件类型,ID_CARD-身份证
*/
IdCardType?: string;
/**
* 指定签署人证件号码,字母大写
*/
IdCardNumber?: string;
}
/**
* 意愿核身(点头确认模式)使用的文案,若未使用意愿核身(点头确认模式),则该字段无需传入。当前仅支持一个提示文本。
*/
export interface IntentionAction {
/**
* 点头确认模式下,系统语音播报使用的问题文本,问题最大长度为150个字符。
*/
Text?: string;
}
/**
* DescribeDraftContractByPromptsTask返回参数结构体
*/
export interface DescribeDraftContractByPromptsTaskResponse {
/**
* 任务状态,枚举,0 已创建,1 执行中,2 成功,3 失败
*/
Status?: number;
/**
* 任务错误信息,仅在失败时返回
*/
Message?: string;
/**
* 生成的合同名称
*/
ContractName?: string;
/**
* 生成的合同文件资源id
*/
ResourceId?: string;
/**
* 生成的合同文件下载链接,有效期2小时
*/
ContractUrl?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateOrganizationBatchSignUrl请求参数结构体
*/
export interface CreateOrganizationBatchSignUrlRequest {
/**
* 执行本接口操作的员工信息。使用此接口时,必须填写userId。
支持填入集团子公司经办人 userId 代发合同。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 请指定需执行批量签署的流程ID,数量范围为1-100。您可登录腾讯电子签控制台,浏览 "合同"->"合同中心" 以查阅某一合同的FlowId(在页面中显示为合同ID)。用户将利用链接对这些合同实施批量操作。 注:生成动态签署方领取时此参数必传。
*/
FlowIds?: Array;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 员工在腾讯电子签平台的独特身份标识,为32位字符串。
您可登录腾讯电子签控制台,在 "更多能力"->"组织管理" 中查阅某位员工的UserId(在页面中显示为用户ID)。
UserId必须是传入合同(FlowId)中的签署人。
- 1. 若UserId为空,Name和Mobile 必须提供。
- 2. 若UserId 与 Name,Mobile均存在,将优先采用UserId对应的员工。
*/
UserId?: string;
/**
* 员工姓名,必须与手机号码一起使用。
如果UserId为空,则此字段不能为空。同时,姓名和手机号码必须与传入合同(FlowId)中的签署人信息一致。
*/
Name?: string;
/**
* 员工手机号,必须与姓名一起使用。
如果UserId为空,则此字段不能为空。同时,姓名和手机号码必须与传入合同(FlowId)中的签署人信息一致。
*/
Mobile?: string;
/**
* 为签署方经办人在签署合同中的参与方ID,必须与参数FlowIds数组一一对应。您可以通过查询合同接口(DescribeFlowInfo)查询此参数。若传了此参数,则可以不传 UserId, Name, Mobile等参数 注:生成动态签署方领取时此参数必传。
*/
RecipientIds?: Array;
/**
* 合同组Id,传入此参数则可以不传FlowIds
*/
FlowGroupId?: string;
/**
* 是否允许此链接中签署方批量拒签。 - false (默认): 不允许批量拒签
- true : 允许批量拒签。
注:`当前合同组不支持批量拒签功能。请对合同组中的每个子合同逐一执行拒签操作,以达到拒签整个合同组的效果。`
*/
CanBatchReject?: boolean;
/**
* 动态签署方领取链接配置。
*/
DynamicSignOption?: DynamicSignOption;
}
/**
* 企业角色数据信息
*/
export interface IntegrateRole {
/**
* 角色id
*/
RoleId?: string;
/**
* 角色名
*/
RoleName?: string;
/**
* 角色状态,1-启用,2-禁用
*/
RoleStatus?: number;
/**
* 是否是集团角色,true-是,false-否
*/
IsGroupRole?: boolean;
/**
* 管辖的子企业列表
*/
SubOrgIdList?: Array;
/**
* 权限树
*/
PermissionGroups?: Array;
}
/**
* CreateDraftContractByPromptsTask返回参数结构体
*/
export interface CreateDraftContractByPromptsTaskResponse {
/**
* 起草任务id
注意:此字段可能返回 null,表示取不到有效值。
*/
TaskId?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DeleteIntegrationDepartment请求参数结构体
*/
export interface DeleteIntegrationDepartmentRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得组织架构管理权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 电子签中的部门ID,通过DescribeIntegrationDepartments接口可获得。
*/
DeptId: string;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 交接部门ID。
待删除部门中的合同、印章和模板数据,将会被交接至该部门ID下;若未填写则交接至公司根部门。
*/
ReceiveDeptId?: string;
}
/**
* 创建流程的签署方信息
*/
export interface MiniAppCreateApproverInfo {
/**
* 在指定签署方时,可以选择企业B端或个人C端等不同的参与者类型,可选类型如下:
- 0 :企业B端。
- 1 :个人C端。
- 3 :企业B端静默(自动)签署,无需签署人参与,自动签署可以参考自动签署使用说明文档。
- 7 :个人C端自动签署,适用于个人自动签场景。注: 个人自动签场景为白名单功能,使用前请联系对接的客户经理沟通。
*/
ApproverType: number;
/**
* 组织机构名称。
请确认该名称与企业营业执照中注册的名称一致。
如果名称中包含英文括号(),请使用中文括号()代替。
注: `当approverType=0(企业签署方) 或 approverType=3(企业静默签署)时,必须指定`
*/
OrganizationName?: string;
/**
* 签署方经办人的姓名。
经办人的姓名将用于身份认证和电子签名,请确保填写的姓名为签署方的真实姓名,而非昵称等代名。
在未指定签署人电子签UserId情况下,为必填参数
*/
ApproverName?: string;
/**
* 签署方经办人手机号码, 支持中国大陆手机号11位数字(无需加+86前缀或其他字符)。 此手机号用于通知和用户的实名认证等环境,请确认手机号所有方为此合同签署方。
注:`在未指定签署人电子签UserId情况下,为必填参数`
*/
ApproverMobile?: string;
/**
* 证件类型,支持以下类型
- ID_CARD: 居民身份证 (默认值)
- HONGKONG_AND_MACAO : 港澳居民来往内地通行证
- HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证)
*/
ApproverIdCardType?: string;
/**
* 证件号码,应符合以下规则
- 中国大陆居民身份证号码应为18位字符串,由数字和大写字母X组成(如存在X,请大写)。
- 中国港澳居民来往内地通行证号码共11位。第1位为字母,“H”字头签发给中国香港居民,“M”字头签发给中国澳门居民;第2位至第11位为数字。
- 中国港澳台居民居住证号码编码规则与中国大陆身份证相同,应为18位字符串。
*/
ApproverIdCardNumber?: string;
/**
* 签署方经办人在模板中配置的参与方ID,与控件绑定,是控件的归属方,ID为32位字符串。
模板发起合同时,该参数为必填项,可以通过[查询模板信息接口](https://qian.tencent.com/developers/companyApis/templatesAndFiles/DescribeFlowTemplates)获得。
文件发起合同时,该参数无需传值。
如果开发者后续用合同模板发起合同,建议保存此值,在用合同模板发起合同中需此值绑定对应的签署经办人 。
*/
RecipientId?: string;
}
/**
* 印章扩展信息
*/
export interface ExtendScene {
/**
* 印章来源类型
印章来源类型包括下面几种:
- CREATE-客户上传图片创建
- GENERATE-系统模板印章生成
- SIST_SEAL-深圳电子印章
*/
GenerateType?: string;
/**
* 印章来源类型描述
*/
GenerateTypeDesc?: string;
/**
* 印章来源logo
*/
GenerateTypeLogo?: string;
}
/**
* DescribeFileCounterSignResult返回参数结构体
*/
export interface DescribeFileCounterSignResultResponse {
/**
* 加签任务的状态。
- PROCESSING: 任务正在执行中。
- FINISHED: 已执行成功
- FAILED: 执行失败
*/
Status?: string;
/**
* 加签完成后新的文件Id
*/
ResultFileId?: string;
/**
* 失败的错误信息,加签任务失败的情况下会返回。
*/
ErrorDetail?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 意愿核身点头确认模式结果
*/
export interface IntentionActionResult {
/**
* 意愿核身结果详细数据,与每段点头确认过程一一对应
*/
Details?: Array;
}
/**
* CreateBatchSignUrl请求参数结构体
*/
export interface CreateBatchSignUrlRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 签署方经办人的姓名。
经办人的姓名将用于身份认证和电子签名,请确保填写的姓名为签署方的真实姓名,而非昵称等代名。
注:
- 请确保和合同中填入的一致。
- 在动态签署人补充链接场景中,可以通过传入这个值,对补充的个人参与方信息进行限制。仅匹配传入姓名的参与方才能补充合同。此参数预设信息功能暂时仅支持个人动态参与方。
*/
Name?: string;
/**
* 手机号码, 支持中国大陆手机号11位数字(无需加+86前缀或其他字符)。请确认手机号所有方为此业务通知方。注:- 请确保和合同中填入的一致, 若无法保持一致,请确保在发起和生成批量签署链接时传入相同的参与方证件信息。
- 在生成动态签署人补充链接场景中,可以通过传入此值,对补充的个人参与方信息进行限制。仅匹配传入手机号的参与方才能补充合同。此参数预设信息功能暂时仅支持个人动态参与方。
*/
Mobile?: string;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 证件类型,支持以下类型
- ID_CARD : 中国大陆居民身份证 (默认值)
- HONGKONG_AND_MACAO : 港澳居民来往内地通行证
- HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同中国大陆居民身份证)
注:
1. `请确保和合同中填入的一致`。
2. `在生成动态签署人补充链接场景中,可以通过传入此值,对补充的个人参与方信息进行限制。仅匹配传入证件类型的参与方才能补充合同。此参数预设信息功能暂时仅支持个人动态参与方,且需要和证件号参数一同传递,不能单独进行限制。`
*/
IdCardType?: string;
/**
* 指定批量签署合同的签名类型,可传递以下值:- **0**:手写签名
- **1**:OCR楷体
- **2**:姓名印章
- **3**:图片印章
- **4**:系统签名
- **5**:长效手写签名(包含手写签名)
注:- 不传值的情况则计算所有合同中个人签署区的签名类型,规则如下:
- 1.如果所有合同中所有的个人签署区方式包含多种则是手写
- 2.如果所有合同中所有个人签名区签名类型仅为一种则就是那一种签名方式(例如合同1有多个签署区都是指定OCR楷体,合同2中也是多个签署区都是指定OCR楷体...则使用OCR楷体)
- 该参数会覆盖您合同中的签名类型,若您在发起合同时限定了签名类型(赋值签名类型给ComponentTypeLimit),请将这些签名类型赋予此参数
*/
SignatureTypes?: Array;
/**
* 证件号码,应符合以下规则
- 中国大陆居民身份证号码应为18位字符串,由数字和大写字母X组成(如存在X,请大写)。
- 中国港澳居民来往内地通行证号码共11位。第1位为字母,“H”字头签发给中国香港居民,“M”字头签发给中国澳门居民;第2位至第11位为数字。
- 中国港澳台居民居住证号码编码规则与中国大陆身份证相同,应为18位字符串。
注:
1. `请确保和合同中填入的一致`。
2. `在生成动态签署人补充链接场景中,可以通过传入此值,对补充的个人参与方信息进行限制。仅匹配传入证件号的参与方才能补充合同。此参数预设信息功能暂时仅支持个人动态参与方。`
*/
IdCardNumber?: string;
/**
* 通知用户方式:
- **NONE** : 不通知(默认)
- **SMS** : 短信通知(发送短信通知到Mobile参数所传的手机号)
*/
NotifyType?: string;
/**
* 批量签署的合同流程ID数组,此参数必传。
注: `在调用此接口时,请确保合同流程均为本企业发起,且合同数量不超过100个。`
*/
FlowIds?: Array;
/**
* 目标签署人的企业名称,签署人如果是企业员工身份,需要传此参数。
注:
- 请确认该名称与企业营业执照中注册的名称一致。
- 如果名称中包含英文括号(),请使用中文括号()代替。
*/
OrganizationName?: string;
/**
* 是否直接跳转至合同内容页面进行签署
- **false**: 会跳转至批量合同流程的列表, 点击需要批量签署合同后进入合同内容页面进行签署(默认)
- **true**: 跳过合同流程列表, 直接进入合同内容页面进行签署
*/
JumpToDetail?: boolean;
/**
* 批量签署合同相关信息,指定合同和签署方的信息,用于补充动态签署人。
*/
FlowBatchUrlInfo?: FlowBatchUrlInfo;
/**
* 签署完成后是否自动回跳
- false:否, 签署完成不会自动跳转回来(默认)
- true:是, 签署完成会自动跳转回来
注:
1. 该参数只针对APP类型(电子签小程序跳转贵方小程序)场景 的签署链接有效
2. 手机应用APP 或 微信小程序需要监控界面的返回走后序逻辑, 微信小程序的文档可以参考[这个](https://developers.weixin.qq.com/miniprogram/dev/reference/api/App.html#onShow-Object-object)
3. 电子签小程序跳转贵方APP,不支持自动跳转,必须用户手动点击完成按钮(微信的限制)
*/
AutoJumpBack?: boolean;
/**
* 仅公众号 H5 跳转电子签小程序时,如需签署完成的“返回应用”功能,在获取签署链接接口的 UrlUseEnv 参数需设置为 **WeChatOfficialAccounts**,小程序签署成功的结果页面中才会出现“返回应用”按钮。在用户点击“返回应用”按钮之后,会返回到公众号 H5。
参考 [公众号 H5 跳转电子签小程序](https://qian.tencent.com/developers/company/openwxminiprogram/#23-%E5%85%AC%E4%BC%97%E5%8F%B7-h5-%E4%B8%AD%E8%B7%B3%E8%BD%AC)。
*/
UrlUseEnv?: string;
/**
* 是否允许此链接中签署方批量拒签。 - false (默认): 不允许批量拒签
- true : 允许批量拒签。
注:`1. 当前合同组不支持批量拒签功能。请对合同组中的每个子合同逐一执行拒签操作,以达到拒签整个合同组的效果。2. 如果是链接直接跳转至详情页(JumpToDetail参数为true),也不支持批量拒签功能`
*/
CanBatchReject?: boolean;
/**
* 是否允许此链接中签署方批量确认已读文件。 - false (默认): 不允许批量确认已读文件。
- true : 允许批量确认已读文件。
注:`1. 此功能为白名单功能,使用前请联系对应客户经理进行开通。2. 使用此功能时,FlowIds参数必传。3. 对于企业签署方,如果对印章/签名控件有限制要求,需要保证所有印章/签名签署控件限制要求(印章id或印章/签名类型限制)一致,否则无法使用此功能。`
*/
CanSkipReadFlow?: boolean;
}
/**
* CreateBatchInformationExtractionTask返回参数结构体
*/
export interface CreateBatchInformationExtractionTaskResponse {
/**
* 合同智能提取的任务ID列表,每个任务ID为32位字符串。
建议开发者保存此任务ID,后续查询合同智能提取详情需要此任务ID。
注意:返回的索引和ResourceIds数组一致
*/
TaskIds?: Array;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 合同组签署方信息
*/
export interface FlowGroupApprovers {
/**
* 合同流程ID
*/
FlowId?: string;
/**
* 签署方信息,包含合同ID和角色ID用于定位RecipientId。
*/
Approvers?: Array;
}
/**
* DescribeContractComparisonTask请求参数结构体
*/
export interface DescribeContractComparisonTaskRequest {
/**
* 执行合同审查任务的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 合同对比任务ID,该参数通过调用接口CreateContractComparisonTask获取。
*/
TaskId: string;
/**
* 是否返回详细的对比结果。为 true时,响应中将包含详细的对比信息,如相似度、文本差异具体内容等;为 false时,仅返回任务基本状态信息。
注:`详细结果数据量可能较大,请按需开启。`
*/
ShowDetail?: boolean;
/**
* 搜索条件,具体参考Filter结构体。本接口取值:
1. **format-type:**
按照【 合同文本格式类型 】进行过滤;
类型:String;
是否必填项:否;
类型如下:
- **0**:段落(正文)
- **1**:标点符号
- **2**:页眉页脚
- **3**:目录
- **4**:印章
- **5**:序号
- **7**:下划线内容(填写区)
*/
Filters?: Array;
}
/**
* DescribeFlowBriefs请求参数结构体
*/
export interface DescribeFlowBriefsRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 查询的合同流程ID列表最多支持100个流程ID。
如果某个合同流程ID不存在,系统会跳过此ID的查询,继续查询剩余存在的合同流程。
可登录腾讯电子签控制台,在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。[点击查看FlowId在控制台中的位置](https://qcloudimg.tencent-cloud.cn/raw/0a83015166cfe1cb043d14f9ec4bd75e.png)
*/
FlowIds: Array;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
}
/**
* CreateInformationExtractionWebUrl返回参数结构体
*/
export interface CreateInformationExtractionWebUrlResponse {
/**
* 合同信息提取嵌入式web页面链接。
注意:`链接有效期为5分钟,且链接仅能使用一次。`
*/
Url?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateFlowGroupSignReview请求参数结构体
*/
export interface CreateFlowGroupSignReviewRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 合同(流程)组的合同组Id,为32位字符串,通过接口[通过多文件创建合同组签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlowGroupByFiles) 或[通过多模板创建合同组签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlowGroupByTemplates)创建合同组签署流程时返回。
*/
FlowGroupId: string;
/**
* 提交的审核结果,审核结果有下面三种情况
- PASS: 审核通过,合同流程可以继续执行签署等操作
- REJECT: 审核拒绝,合同流程不会变动
- SIGN_REJECT:拒签,合同流程直接结束,合同状态变为**合同拒签**
*/
ReviewType: string;
/**
* 需要进行签署审核的签署人的个人信息或企业信息,签署方的匹配方式按照以下规则:
个人:二选一(选择其中任意信息组合即可)
企业:二选一 (选择其中任意信息组合即可)
- 企业名+姓名+证件类型+证件号
- 企业名+姓名+手机号
*/
ApproverInfo: NeedReviewApproverInfo;
/**
* 代理相关应用信息,如集团主企业代子企业操作的场景中ProxyOrganizationId必填
*/
Agent?: Agent;
/**
* 审核不通过的原因,该字段的字符串长度不超过200个字符。
注:`当审核类型(ReviewType)为审核拒绝(REJECT)或拒签(SIGN_REJECT)时,审核结果原因字段必须填写`
*/
ReviewMessage?: string;
}
/**
* 企业超管信息
*/
export interface Admin {
/**
* 超管名
*/
Name?: string;
/**
* 超管手机号,打码显示
示例值:138****1569
*/
Mobile?: string;
}
/**
* 此结构体 (Caller) 用于描述调用方属性。
*/
export interface Caller {
/**
* 应用号
* @deprecated
*/
ApplicationId?: string;
/**
* 主机构ID
* @deprecated
*/
OrganizationId?: string;
/**
* 经办人的用户ID,同UserId
*/
OperatorId?: string;
/**
* 下属机构ID
* @deprecated
*/
SubOrganizationId?: string;
}
/**
* ExportContractComparisonTask返回参数结构体
*/
export interface ExportContractComparisonTaskResponse {
/**
* 对比任务详情下载链接。
*/
ResourceUrl?: string;
/**
* 下载链接有效截止时间。
*/
ExpireTime?: number;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 个性化参数
*/
export interface EmbedUrlOption {
/**
* 合同详情预览,允许展示控件信息
- true:允许在合同详情页展示控件
- false:(默认)不允许在合同详情页展示控件
*/
ShowFlowDetailComponent?: boolean;
/**
* 模板预览,允许展示模板控件信息
- true :允许在模板预览页展示控件
- false :(默认)不允许在模板预览页展示控件
*/
ShowTemplateComponent?: boolean;
/**
* 跳过上传文件,默认为false(展示上传文件页)
- false: 展示上传文件页
- true: 不展示上传文件页
注意: 此参数仅针对**EmbedType=CREATE_TEMPLATE(创建模板)和EmbedType=CREATE_CONTRACT_DRAFT_COOPEDIT(创建起草合同)有效**,
*/
SkipUploadFile?: boolean;
/**
* 隐藏下载文件按钮,默认为false(展示下载文件按钮)
- false: 展示下载文件按钮
- true: 不展示下载文件按钮
注意: 此参数仅针对**EmbedType=PREVIEW_FLOW_DETAIL(查看合同详情)**有效
*/
SkipDownloadFile?: boolean;
/**
* 是否禁止编辑(展示)水印控件属性
- (默认) false -否
- true - 禁止编辑
*/
ForbidEditWatermark?: boolean;
/**
* 印章描述
*/
SealDescription?: string;
/**
* 是否禁止编辑印章描述内容
- (默认) false -否
- true - 禁止编辑
*/
ForbidEditSealDescription?: boolean;
}
/**
* DescribeContractReviewMarkedRiskExportTask请求参数结构体
*/
export interface DescribeContractReviewMarkedRiskExportTaskRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 导出任务 ID。
*/
TaskId: string;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
}
/**
* DescribeContractComparisonTask返回参数结构体
*/
export interface DescribeContractComparisonTaskResponse {
/**
* 合同对比任务ID。
*/
TaskId?: string;
/**
* 合同对比任务状态。
状态如下:
- **0**:待创建(未执行)
- **1**:对比中
- **2**:对比成功
- **3**:对比失败
*/
Status?: number;
/**
* 对比失败的具体原因描述,仅当状态为失败时返回此字段。
*/
Message?: string;
/**
* 原版文件ID,对比基准的旧版本文件唯一标识。
*/
OriginalFileResourceId?: string;
/**
* 新版文件ID,与旧版进行对比的新版本文件唯一标识。
*/
DiffFileResourceId?: string;
/**
* 对比任务备注,长度不能超过50个字符。
*/
Comment?: string;
/**
* 合同对比差异点总数。
*/
TotalDiffCount?: number;
/**
* 合同对比新增点数量。
*/
AddDiffCount?: number;
/**
* 合同对比修改点数量。
*/
ChangeDiffCount?: number;
/**
* 合同对比删除点数量。
*/
DeleteDiffCount?: number;
/**
* 提交人,提交此任务或请求的用户唯一标识。
*/
Operator?: string;
/**
* 合同对比任务创建时间,时间戳。
*/
CreateTime?: number;
/**
* 对比差异详情,请求参数ShowDetail为true时返回。
*/
ComparisonDetail?: Array;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateModifyAdminAuthorizationUrl返回参数结构体
*/
export interface CreateModifyAdminAuthorizationUrlResponse {
/**
* 变更企业超管授权书链接。
没有有效期限制。
注意:
此链接仅能由当时认证企业的认证人使用。
*/
Url?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateOrganizationInfoChangeUrl返回参数结构体
*/
export interface CreateOrganizationInfoChangeUrlResponse {
/**
* 创建的企业信息变更链接。
*/
Url?: string;
/**
* 链接过期时间。链接7天有效。
*/
ExpiredTime?: number;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateFlow返回参数结构体
*/
export interface CreateFlowResponse {
/**
* 合同流程ID,为32位字符串。
建议开发者妥善保存此流程ID,以便于顺利进行后续操作。
注:
此返回的合同流程ID,需再次调用创建电子文档和发起签署流程接口将合同开始后,合同才能进入签署环节,[点击查看FlowId在控制台中的位置(只在进入签署环节后有效)](https://qcloudimg.tencent-cloud.cn/raw/0a83015166cfe1cb043d14f9ec4bd75e.png)
*/
FlowId?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateUserNameChangeUrl返回参数结构体
*/
export interface CreateUserNameChangeUrlResponse {
/**
* 腾讯电子签小程序的个人更名链接。
如果没有传递,默认值是 HTTP。 链接的有效期均是 7 天。
1.如果EndPoint是APP:
得到的链接类似于pages/guide/index?to=MP_PERSONAL_VERIFY&shortKey=yDCZHUyOcExAlcOvNod0, 用法可以参考描述中的"跳转到小程序的实现"
2.如果EndPoint是HTTP:
得到的链接类似于 https://res.ess.tencent.cn/cdn/h5-activity/jump-mp.html?to=TAG_VERIFY&shortKey=yDCZHUyOcChrfpaswT0d,点击后会跳转到腾讯电子签小程序进行签署
3.如果EndPoint是HTTP_SHORT_URL:
得到的链接类似于https://essurl.cn/2n**42Nd,点击后会跳转到腾讯电子签小程序进行签署
`注:` 生成的链路后面不能再增加参数,防止出错重复参数覆盖原有的参数
*/
UserVerifyUrl?: string;
/**
* 链接过期时间,为Unix时间戳(单位为秒)。
*/
ExpireTime?: number;
/**
* 小程序appid,用于半屏拉起电子签小程序, 仅在 Endpoint 设置为 APP 的时候返回
*/
MiniAppId?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* ModifySingleSignOnEmployees请求参数结构体
*/
export interface ModifySingleSignOnEmployeesRequest {
/**
* 执行本接口操作的员工信息。使用此接口时,必须填写userId。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 单点登录应用号的id,获取位置如下图
*/
SsoApplicationId: string;
/**
* 待修改员工的信息。
*/
Employee: SingleSignOnEmployees;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
}
/**
* DeleteSingleSignOnEmployees请求参数结构体
*/
export interface DeleteSingleSignOnEmployeesRequest {
/**
* 执行本接口操作的员工信息。使用此接口时,必须填写userId。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 单点登录应用号的id,获取位置如下图
*/
SsoApplicationId: string;
/**
* 需要删除的单点登录员工的唯一Id 值
*/
OpenId: string;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
}
/**
* CancelMultiFlowSignQRCode返回参数结构体
*/
export interface CancelMultiFlowSignQRCodeResponse {
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 用户计费使用情况详情
*/
export interface BillUsageDetail {
/**
* 合同流程ID,为32位字符串。
可登录腾讯电子签控制台,在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
*/
FlowId?: string;
/**
* 合同经办人名称
如果有多个经办人用分号隔开。
*/
OperatorName?: string;
/**
* 发起方组织机构名称
*/
CreateOrganizationName?: string;
/**
* 合同流程的名称。
*/
FlowName?: string;
/**
* 当前合同状态,如下是状态码对应的状态。
- **0**: 还没有发起
- **1**: 等待签署
- **2**: 部分签署
- **3**: 拒签
- **4**: 已签署
- **5**: 已过期
- **6**: 已撤销
- **7**: 还没有预发起
- **8**: 等待填写
- **9**: 部分填写
- **10**: 拒签
- **11**: 已解除
*/
Status?: number;
/**
* 查询的套餐类型
对应关系如下:
- **CloudEnterprise**: 企业版合同
- **SingleSignature**: 单方签章
- **CloudProve**: 签署报告
- **CloudOnlineSign**: 腾讯会议在线签约
- **ChannelWeCard**: 微工卡
- **SignFlow**: 合同套餐
- **SignFace**: 签署意愿(人脸识别)
- **SignPassword**: 签署意愿(密码)
- **SignSMS**: 签署意愿(短信)
- **PersonalEssAuth**: 签署人实名(腾讯电子签认证)
- **PersonalThirdAuth**: 签署人实名(信任第三方认证)
- **OrgEssAuth**: 签署企业实名
- **FlowNotify**: 短信通知
- **AuthService**: 企业工商信息查询
*/
QuotaType?: string;
/**
* 合同使用量
注: `如果消耗类型是撤销返还,此值为负值代表返还的合同数量`
*/
UseCount?: number;
/**
* 消耗的时间戳,格式为Unix标准时间戳(秒)。
*/
CostTime?: number;
/**
* 消耗的套餐名称
*/
QuotaName?: string;
/**
* 消耗类型
**1**.扣费
**2**.撤销返还
*/
CostType?: number;
/**
* 备注
*/
Remark?: string;
}
/**
* 合同智能提取字段信息
*/
export interface ExtractionField {
/**
* 用于合同智能提取的字段名称。
注意: `长度不能超过30个字符`
*/
Name: string;
/**
* 指定合同智能提取的字段类型,目前仅支持`TEXT`、`DATE`、`NUMBER`、`OPTION`类型。
类型支持如下:
1、TEXT(文本)
2、DATE(日期)
3、NUMBER(数字)
4、OPTION(选项值)
*/
Type: string;
/**
* 用于描述字段信息。
注意:
1、描述字段不能超过100个字符
*/
Description?: string;
/**
* 提取出合同中的字段信息。
*/
Values?: Array;
/**
* 当字段类型`Type`为OPTION时为必输项,输入选项值
*/
ChoiceList?: Array;
}
/**
* DescribeUserFlowType返回参数结构体
*/
export interface DescribeUserFlowTypeResponse {
/**
* 查询到的所有用户合同类型列表
*/
AllUserFlowTypes?: Array;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 合同信息提取字段值信息。
*/
export interface ExtractionFieldResult {
/**
* 字段ID
*/
Id?: string;
/**
* 用于合同智能提取的字段名称。
*/
Name?: string;
/**
* 合同智能提取的字段类型,目前仅支持TEXT、DATE、NUMBER、OPTION类型。
类型支持如下: 1、TEXT(文本) 2、DATE(日期) 3、NUMBER(数字) 4、OPTION(选项值)
*/
Type?: string;
/**
* 提取出合同中的字段信息。
*/
Values?: Array;
/**
* 是否需要语义提取,默认为false
*/
RequiresSemanticExtraction?: boolean;
/**
* 提取出值在合同中的坐标位置信息
*/
Positions?: Array;
}
/**
* DescribeExtendedServiceAuthDetail返回参数结构体
*/
export interface DescribeExtendedServiceAuthDetailResponse {
/**
* 服务授权的信息列表,根据查询类型返回特定扩展服务的授权状况。
*/
AuthInfoDetail?: AuthInfoDetail;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateLegalSealQrCode返回参数结构体
*/
export interface CreateLegalSealQrCodeResponse {
/**
* 二维码图片base64值,二维码有效期7天(604800秒)
二维码图片的样式如下图:

*/
QrcodeBase64?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DescribeIntegrationDepartments返回参数结构体
*/
export interface DescribeIntegrationDepartmentsResponse {
/**
* 部门信息列表。部门信息根据部门排序号OrderNo降序排列,根据部门创建时间升序排列。
*/
Departments?: Array;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateFileCounterSign请求参数结构体
*/
export interface CreateFileCounterSignRequest {
/**
* 需要加签的文件Id。
注: `暂时只支持pdf类型的文件`
*/
FileId: string;
/**
* 执行本接口操作的员工信息。注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator?: UserInfo;
/**
* 代理企业和员工的信息。在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 是否使用同步模式。
- false:异步模式,返回taskId。需要使用taskId轮询结果查询接口。
- true: 同步模式,此接口将直接返回taskId和ResultFileId(加签后文件id)。
注:
1. 当加签文件较大的时候,建议使用异步接口进行操作。否则文件加签时间过长会导致接口超时。
*/
SyncMode?: boolean;
}
/**
* 提取web嵌入页面个性化设置
*/
export interface WebUrlOption {
/**
* 禁用链接预览
*/
DisableLinkPreview?: boolean;
/**
* 禁用任务编辑
*/
DisableTaskEditing?: boolean;
/**
* 禁用任务结果编辑
*/
DisableTaskResultEditing?: boolean;
}
/**
* DescribeOrganizationVerifyStatus返回参数结构体
*/
export interface DescribeOrganizationVerifyStatusResponse {
/**
* 当前企业认证状态
*/
VerifyStatus?: number;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DeleteExtendedServiceAuthInfos返回参数结构体
*/
export interface DeleteExtendedServiceAuthInfosResponse {
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DescribeEnterpriseContractReviewChecklists返回参数结构体
*/
export interface DescribeEnterpriseContractReviewChecklistsResponse {
/**
* 查询的总条数
*/
Total?: number;
/**
* 清单列表
*/
Checklists?: Array;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 企业扩展服务授权列表详情
*/
export interface AuthInfoDetail {
/**
* 扩展服务类型,和入参一致
*/
Type?: string;
/**
* 扩展服务名称
*/
Name?: string;
/**
* 授权员工列表
*/
HasAuthUserList?: Array;
/**
* 授权企业列表(企业自动签时,该字段有值)
*/
HasAuthOrganizationList?: Array;
/**
* 授权员工列表总数
*/
AuthUserTotal?: number;
/**
* 授权企业列表总数
*/
AuthOrganizationTotal?: number;
}
/**
* ModifyApplicationCallbackInfo返回参数结构体
*/
export interface ModifyApplicationCallbackInfoResponse {
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 催办邮件结构体
*/
export interface RemindEmailInfo {
/**
* 签署编号
*/
SignId?: string;
/**
* 指定邮箱地址,催办时使用此邮箱替代 DB 中存储的邮箱
*/
ApproverEmail?: string;
}
/**
* 用于定义合同风险识别角色信息。
*/
export interface RiskIdentificationRoleInfo {
/**
* 风险识别角色的名称。用于唯一标识和区分不同的风险识别角色。
注意:`最大长度应不超过200个字符`
*/
Name: string;
/**
* 风险识别角色的详细说明。
注意: `最大长度应不超过500个字符`
*/
Description?: string;
}
/**
* CreateUserVerifyUrl请求参数结构体
*/
export interface CreateUserVerifyUrlRequest {
/**
* 操作人信息
*/
Operator: UserInfo;
/**
* 要实名的姓名
*/
Name?: string;
/**
* 要实名的身份证号码,
身份证号码如果有x的话,统一传大写X
*/
IdCardNumber?: string;
/**
* 证件类型,目前只支持身份证类型:ID_CARD
*/
IdCardType?: string;
/**
* 要实名的手机号,兼容带+86的格式
*/
Mobile?: string;
/**
* 实名完之后的跳转链接,最大长度1000个字符。
链接类型请参考 跳转电子签H5。
注:此参数仅支持 Endpoint 为 H5 或 H5_SHORT_URL 的时候传递
*/
JumpUrl?: string;
/**
* 要跳转的链接类型
- HTTP:适用于短信通知或H5跳转的电子签小程序HTTP长链接
- HTTP_SHORT_URL:适用于短信通知或H5跳转的电子签小程序HTTP短链接
- APP:(默认类型)适用于第三方APP或小程序跳转的电子签小程序路径
- H5:适用于跳转至电子签H5实名页面的长链接
- H5_SHORT_URL:适用于跳转至电子签H5实名页面的短链接
注:如果不传递,默认值是 APP
*/
Endpoint?: string;
/**
* 签署完成后是否自动回跳
- false:否, 实名完成不会自动跳转回来(默认)
- true:是, 实名完成会自动跳转回来
注:
1. 该参数只针对APP类型(第三方APP或小程序跳转电子签小程序)场景 的实名链接有效
2. 手机应用APP 或 微信小程序需要监控界面的返回走后序逻辑, 微信小程序的文档可以参考[这个](https://developers.weixin.qq.com/miniprogram/dev/reference/api/App.html#onShow-Object-object)
3. 电子签小程序跳转贵方APP,不支持自动跳转,必需用户手动点击完成按钮(微信的限制)
*/
AutoJumpBack?: boolean;
/**
* 在用户完成实名认证后,其自定义数据将通过[企业引导个人实名认证后回调](https://qian.tencent.com/developers/company/callback_types_staffs/#%E5%8D%81%E4%BA%8C-%E4%BC%81%E4%B8%9A%E5%BC%95%E5%AF%BC%E4%B8%AA%E4%BA%BA%E5%AE%9E%E5%90%8D%E8%AE%A4%E8%AF%81%E5%90%8E%E5%9B%9E%E8%B0%83)返回,以便用户确认其个人数据信息。请注意,自定义数据的字符长度上限为1000,且必须采用base64编码格式。
*/
UserData?: string;
}
/**
* DescribeLMInformationExtractionTaskFieldFeedback请求参数结构体
*/
export interface DescribeLMInformationExtractionTaskFieldFeedbackRequest {
/**
* 执行合同智能提取任务的员工信息。
*/
Operator: UserInfo;
/**
* 合同智能提取任务ID,该参数通过调用接口[批量创建合同智能提取任务](https://qian.tencent.com/developers/companyApis/%E5%90%88%E5%90%8C%E6%99%BA%E8%83%BD%E7%9B%B8%E5%85%B3%E6%8E%A5%E5%8F%A3/CreateBatchInformationExtractionTask/)获取。
*/
TaskId?: string;
}
/**
* CreateIntegrationEmployees请求参数结构体
*/
export interface CreateIntegrationEmployeesRequest {
/**
* 执行本接口操作的员工信息。使用此接口时,必须填写userId。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 待创建员工的信息最多不超过20个。
**1. 在创建企业微信员工的场景下** : 只需传入下面的参数,其他信息不支持设置。
| 参数 | 是否必填 | 含义 |
| WeworkOpenId | 是 | 企业微信用户账号ID |
**2. 在其他场景下** : 只需传入下面的参数,其他信息不支持设置。
| 参数 | 是否必填 | 含义 |
| DisplayName | 是 | 用户的真实名字 |
| Mobile | 是 | 用户手机号码 |
| OpenId | 否 | 用户的自定义ID |
| Email | 否 | 用户的邮箱 |
| Department.DepartmentId | 否 | 用户加入后的部门ID |
注: `每个手机号每天最多使用3次`
*/
Employees: Array;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 员工邀请方式
可通过以下途径进行设置:
- **SMS(默认)**:邀请将通过短信或企业微信消息发送。若场景非企业微信,则采用企业微信消息;其他情境下则使用短信通知。短信内含链接,点击后将进入微信小程序进行认证并加入企业的流程。
- **H5**:将生成H5链接,用户点击链接后可进入H5页面进行认证并加入企业的流程。
- **NONE**:系统会根据Endpoint生成签署链接,业务方需获取链接并通知客户。
*/
InvitationNotifyType?: string;
/**
* 回跳地址,为认证成功后页面进行回跳的URL,请确保回跳地址的可用性。
注:`只有在员工邀请方式(InvitationNotifyType参数)为H5场景下才生效, 其他方式下设置无效。`
*/
JumpUrl?: string;
/**
* 要跳转的链接类型- **HTTP**:跳转电子签小程序的http_url, 短信通知或者H5跳转适合此类型 ,此时返回长链 (默认类型)
- **HTTP_SHORT_URL**:跳转电子签小程序的http_url, 短信通知或者H5跳转适合此类型,此时返回短链
- **APP**: 第三方APP或小程序跳转电子签小程序的path, APP或者小程序跳转适合此类型
- **H5**: 第三方移动端浏览器进行嵌入,不支持小程序嵌入,过期时间一个月
注意:InvitationNotifyType 和 Endpoint 的关系图| 通知类型(InvitationNotifyType) | Endpoint |
| SMS(默认) | 不需要传递,会将 Endpoint 默认设置为HTTP_SHORT_URL |
| H5 | 不需要传递,会将 Endpoint 默认设置为 H5 |
| NONE | 所有 Endpoint 都支持(HTTP_URL/HTTP_SHORT_URL/H5/APP)默认为HTTP_SHORT_URL |
*/
Endpoint?: string;
}
/**
* 创建合同个性化参数
*/
export interface CreateFlowOption {
/**
* 是否允许修改发起合同时确认弹窗的合同信息(合同名称、合同类型、签署截止时间),若不允许编辑,则表单字段将被禁止输入。
true:允许编辑
false:不允许编辑(默认值)
*/
CanEditFlow?: boolean;
/**
* 是否允许编辑模板控件
true:允许编辑模板控件信息
false:不允许编辑模板控件信息(默认值)
*/
CanEditFormField?: boolean;
/**
* 发起页面隐藏合同名称展示
true:发起页面隐藏合同名称展示
false:发起页面不隐藏合同名称展示(默认值)
*/
HideShowFlowName?: boolean;
/**
* 发起页面隐藏合同类型展示
true:发起页面隐藏合同类型展示
false:发起页面不隐藏合同类型展示(默认值)
*/
HideShowFlowType?: boolean;
/**
* 发起页面隐藏合同截止日期展示
true:发起页面隐藏合同截止日期展示
false:发起页面不隐藏合同截止日期展示(默认值)
*/
HideShowDeadline?: boolean;
/**
* 发起页面允许跳过添加签署人环节
true:发起页面允许跳过添加签署人环节
false:发起页面不允许跳过添加签署人环节(默认值)
*/
CanSkipAddApprover?: boolean;
/**
* 文件发起页面跳过文件上传步骤
true:文件发起页面跳过文件上传步骤
false:文件发起页面不跳过文件上传步骤(默认值)
*/
SkipUploadFile?: boolean;
/**
* 禁止编辑填写控件
true:禁止编辑填写控件
false:允许编辑填写控件(默认值)
*/
ForbidEditFillComponent?: boolean;
/**
* 定制化发起合同弹窗的描述信息,描述信息最长500字符
*/
CustomCreateFlowDescription?: string;
/**
* 禁止添加签署方,若为true则在发起流程的可嵌入页面隐藏“添加签署人按钮”
*/
ForbidAddApprover?: boolean;
/**
* 是否可以编辑签署人包括新增,修改,删除
- (默认) false -可以编辑签署人
- true - 禁止编辑签署人
注意:如果设置参数为 true, 则 参数签署人 [FlowApproverList](https://qian.tencent.com/developers/partnerApis/embedPages/ChannelCreatePrepareFlow) 不能为空
*/
ForbidEditApprover?: boolean;
/**
* 禁止设置签署流程属性 (顺序、合同签署认证方式等),若为true则在发起流程的可嵌入页面隐藏签署流程设置面板
*/
ForbidEditFlowProperties?: boolean;
/**
* 在发起流程的可嵌入页面要隐藏的控件列表,和 ShowComponentTypes 参数 只能二选一使用(注:
空数组代表未指定),具体的控件类型如下
- SIGN_SIGNATURE : 个人签名/印章
- SIGN_SEAL : 企业印章
- SIGN_PAGING_SEAL : 骑缝章
- SIGN_LEGAL_PERSON_SEAL : 法定代表人章
- SIGN_APPROVE : 签批
- SIGN_OPINION : 签署意见
- SIGN_PAGING_SIGNATURE : 手写签名骑缝控件
- BUSI-FULL-NAME : 企业全称
- BUSI-CREDIT-CODE : 统一社会信用代码
- BUSI-LEGAL-NAME : 法人/经营者姓名
- PERSONAL-NAME : 签署人姓名
- PERSONAL-MOBILE : 签署人手机号
- PERSONAL-IDCARD-TYPE : 签署人证件类型
- PERSONAL-IDCARD : 签署人证件号
- TEXT : 单行文本
- MULTI_LINE_TEXT : 多行文本
- CHECK_BOX : 勾选框
- SELECTOR : 选择器
- DIGIT : 数字
- DATE : 日期
- FILL_IMAGE : 图片
- ATTACHMENT : 附件
- EMAIL : 邮箱
- LOCATION : 地址
- EDUCATION : 学历
- GENDER : 性别
- DISTRICT : 省市区
*/
HideComponentTypes?: Array;
/**
* 在发起流程的可嵌入页面要显示的控件列表,和 HideComponentTypes 参数 只能二选一使用(注:
空数组代表未指定),具体的控件类型如下
- SIGN_SIGNATURE : 个人签名/印章
- SIGN_SEAL : 企业印章
- SIGN_PAGING_SEAL : 骑缝章
- SIGN_LEGAL_PERSON_SEAL : 法定代表人章
- SIGN_APPROVE : 签批
- SIGN_OPINION : 签署意见
- SIGN_PAGING_SIGNATURE : 手写签名骑缝控件
- BUSI-FULL-NAME : 企业全称
- BUSI-CREDIT-CODE : 统一社会信用代码
- BUSI-LEGAL-NAME : 法人/经营者姓名
- PERSONAL-NAME : 签署人姓名
- PERSONAL-MOBILE : 签署人手机号
- PERSONAL-IDCARD-TYPE : 签署人证件类型
- PERSONAL-IDCARD : 签署人证件号
- TEXT : 单行文本
- MULTI_LINE_TEXT : 多行文本
- CHECK_BOX : 勾选框
- SELECTOR : 选择器
- DIGIT : 数字
- DATE : 日期
- FILL_IMAGE : 图片
- ATTACHMENT : 附件
- EMAIL : 邮箱
- LOCATION : 地址
- EDUCATION : 学历
- GENDER : 性别
- DISTRICT : 省市区
*/
ShowComponentTypes?: Array;
/**
* 发起流程的可嵌入页面结果页配置
*/
ResultPageConfig?: Array;
/**
* 签署控件的配置信息,用在嵌入式发起的页面配置,包括
- 签署控件 是否默认展示日期.
*/
SignComponentConfig?: SignComponentConfig;
/**
* 是否禁止编辑(展示)水印控件属性
- (默认) false -否
- true - 禁止编辑
*/
ForbidEditWatermark?: boolean;
/**
* 隐藏操作指引: 具体的控件类型如下
- 1 : 操作指引入口
- 2 : 操作文档
- 3 : 操作视频
注:仅对新版页面生效
* @deprecated
*/
HideOperationInstructions?: Array;
/**
* 隐藏操作步骤: 具体的控件类型如下
- 1 : 选择文件及签署方
- 2 : 补充文件内容
- 4 : 发起前合同信息与设置确认
注:仅对新版页面生效
*/
HideOperationSteps?: Array;
/**
* 本企业简称,注:仅对新版页面生效
*/
SelfName?: string;
/**
* 发起后签署码隐藏,默认false,注:仅对新版页面生效
*/
HideSignCodeAfterStart?: boolean;
/**
* 发起成功后是否预览合同 - (默认) false -否
- true - 展示预览按钮
*/
PreviewAfterStart?: boolean;
/**
* 发起成功之后是否签署合同,仅当前经办人作为签署人时生效 - (默认) false -否
- true - 展示签署按钮
*/
SignAfterStart?: boolean;
/**
* 发起过程中是否保存草稿
*/
NeedFlowDraft?: boolean;
}
/**
* DescribeContractDiffTaskWebUrl返回参数结构体
*/
export interface DescribeContractDiffTaskWebUrlResponse {
/**
* 合同对比嵌入式web页面链接,有效期:5分钟
链接仅能使用一次
*/
WebUrl?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 机构信息
*/
export interface OrganizationInfo {
/**
* 机构在平台的编号,内部字段,暂未开放
* @deprecated
*/
OrganizationId?: string;
/**
* 用户渠道,内部字段,暂未开放
* @deprecated
*/
Channel?: string;
/**
* 用户在渠道的机构编号,内部字段,暂未开放
* @deprecated
*/
OrganizationOpenId?: string;
/**
* 用户真实的IP,内部字段,暂未开放
* @deprecated
*/
ClientIp?: string;
/**
* 机构的代理IP,内部字段,暂未开放
* @deprecated
*/
ProxyIp?: string;
}
/**
* 动态签署2.0合同参与人信息
*/
export interface ArchiveDynamicApproverData {
/**
* 签署方唯一编号,一个全局唯一的标识符,不同的流程不会出现冲突。
可以使用签署方的唯一编号来生成签署链接(也可以通过RecipientId来生成签署链接)。
*/
SignId?: string;
/**
* 签署方角色编号,签署方角色编号是用于区分同一个流程中不同签署方的唯一标识。不同的流程会出现同样的签署方角色编号。
填写控件和签署控件都与特定的角色编号关联。
*/
RecipientId?: string;
}
/**
* CreateOrganizationAuthUrl请求参数结构体
*/
export interface CreateOrganizationAuthUrlRequest {
/**
* 操作人信息
*/
Operator: UserInfo;
/**
* 指定授权方式 支持多选:
*/
AuthorizationTypes?: Array;
/**
* 认证企业名称,请确认该名称与企业营业执照中注册的名称一致。
注:
如果名称中包含英文括号(),请使用中文括号()代替。
EndPointType=“H5”或者"SHORT_H5"时,该参数必填
*/
OrganizationName?: string;
/**
* 企业统一社会信用代码
*/
UniformSocialCreditCode?: string;
/**
* 企业法人的姓名
*/
LegalName?: string;
/**
* 即将废弃,入参请使用JumpEvents。
认证完成跳回的链接,最长500个字符。
*/
AutoJumpUrl?: string;
/**
* 营业执照企业地址
*/
OrganizationAddress?: string;
/**
* 认证人姓名
*/
AdminName?: string;
/**
* 认证人手机号
*/
AdminMobile?: string;
/**
* 认证人身份证号
*/
AdminIdCardNumber?: string;
/**
* 认证人证件类型, 支持以下类型
- ID_CARD : 中国大陆居民身份证 (默认值)
- HONGKONG_AND_MACAO : 中国港澳居民来往内地通行证
- HONGKONG_MACAO_AND_TAIWAN : 中国港澳台居民居住证(格式同中国大陆居民身份证)
*/
AdminIdCardType?: string;
/**
* 对方打开链接认证时,对方填写的营业执照的社会信用代码是否与接口上传上来的要保持一致。
- false(默认值):关闭状态,实际认证时允许与接口传递的信息存在不一致。
- true:启用状态,实际认证时必须与接口传递的信息完全相符。
*/
UniformSocialCreditCodeSame?: boolean;
/**
* 对方打开链接认证时,法人姓名是否要与接口传递上来的保持一致。
- false(默认值):关闭状态,实际认证时允许与接口传递的信息存在不一致。
- true:启用状态,实际认证时必须与接口传递的信息完全相符。
p.s. 仅在法人姓名不为空时有效
*/
LegalNameSame?: boolean;
/**
* 对方打开链接认证时,认证人姓名是否要与接口传递上来的保持一致。
- false(默认值):关闭状态,实际认证时允许与接口传递的信息存在不一致。
- true:启用状态,实际认证时必须与接口传递的信息完全相符。
p.s. 仅在认证人姓名不为空时有效
*/
AdminNameSame?: boolean;
/**
* 对方打开链接认证时,认证人居民身份证件号是否要与接口传递上来的保持一致。
- false(默认值):关闭状态,实际认证时允许与接口传递的信息存在不一致。
- true:启用状态,实际认证时必须与接口传递的信息完全相符。
p.s. 仅在认证人身份证号不为空时有效
*/
AdminIdCardNumberSame?: boolean;
/**
* 对方打开链接认证时,认证人手机号是否要与接口传递上来的保持一致。
- false(默认值):关闭状态,实际认证时允许与接口传递的信息存在不一致。
- true:启用状态,实际认证时必须与接口传递的信息完全相符。
p.s. 仅在认证人手机号不为空时有效
*/
AdminMobileSame?: boolean;
/**
* 对方打开链接认证时,企业名称是否要与接口传递上来的保持一致。
- false(默认值):关闭状态,实际认证时允许与接口传递的信息存在不一致。
- true:启用状态,实际认证时必须与接口传递的信息完全相符。
p.s. 仅在企业名称不为空时有效
*/
OrganizationNameSame?: boolean;
/**
* 营业执照正面照(支持PNG或JPG格式)需以base64格式提供,且文件大小不得超过5MB。
*/
BusinessLicense?: string;
/**
* 跳转链接类型:
- PC:适用于PC端的认证链接
- APP:用于全屏或半屏跳转的小程序链接
- SHORT_URL:跳转小程序的链接的短链形式
- H5:适用于H5页面的认证链接
- SHORT_H5:H5认证链接的短链形式
*/
Endpoint?: string;
/**
* 指定企业初始化引导,现在可以配置如下的选项:
1: 启用此选项后,在企业认证的最终步骤将添加创建印章的引导。如下图的位置

2:开通企业授权API签署协议,目前仅支持PC网页端,即Endpoint=PC(该功能需联系电子签客服开通)

枚举值:
*/
Initialization?: Array;
/**
* 授权书(PNG或JPG或PDF) base64格式, 大小不超过8M 。
授权书可以通过接口生成企业授权书 来获得。
p.s. 如果上传授权书 ,需遵循以下条件
- 超管的信息(超管姓名,超管手机号)必须为必填参数。
- 认证方式AuthorizationTypes必须只能是上传授权书方式
*/
PowerOfAttorneys?: Array;
/**
* 调用方自定义的个性化字段(可自定义此名称),并以base64方式编码,支持的最大数据大小为 4096长度。
在. 企业引导企业实名认证后回调中,该字段的信息将原封不动地透传给贵方。回调的相关说明可参考开发者中心的回调通知模块。
*/
UserData?: string;
/**
* 组织机构对公打款账号,账户名跟企业名称一致。
p.s.
只有认证方式是授权书+对公打款时才生效。
*/
BankAccountNumber?: string;
/**
* 对方打开链接认证时,对公打款账号是否要与接口传递上来的保持一致。
- false(默认值):关闭状态,实际认证时允许与接口传递的信息存在不一致。
- true:启用状态,实际认证时必须与接口传递的信息完全相符。
p.s. 仅在对公打款不为空时有效
*/
BankAccountNumberSame?: boolean;
/**
* 跳转事件,其中包括认证期间收录,授权书审核,企业认证的回跳事件。
p.s.
Endpoint如果是APP 类型,请传递JumpUrl为"true"
如果 Endpoint 是 H5 类型,请参考文档跳转电子签H5
p.s. 如果Endpoint是 APP,传递的跳转地址无效,不会进行跳转,仅会进行回跳。
*/
JumpEvents?: Array;
/**
* 企业证照类型:
- USCC :(默认)工商组织营业执照
- PRACTICELICENSEOFMEDICALINSTITUTION :医疗机构执业许可证
- CLINICFILLINGCERTIFICATE :诊所备案证
注意 :
如果企业证照类型是医疗机构执业许可证或者诊所备案证,则参数设置企业授权方式(AuthorizationTypes)和企业认证方式(AuthorizationMethods)都无效.
医疗机构执业许可证和诊所备案证的企业授权方式 仅有授权书的方式。企业认证仅有上传营业执照的方式。
*/
OrganizationIdCardType?: string;
/**
* 是否允许编辑企业注册时的证照类型
true:不允许编辑。
false:允许编辑(默认值)。
注意:
入参中的OrganizationIdCardType值不为空的时候,才可设置为不可编辑。
*/
OrganizationIdCardTypeSame?: boolean;
/**
* 指定企业认证的授权方式 支持多选:
- 1: 上传营业执照
- 2: 腾讯云快速认证
- 3: 腾讯商户号授权(仅支持小程序端)
注意:
1.如果没有指定,则默认是1,仅有上传营业执照。
2.H5 仅支持上传营业执照。
*/
AuthorizationMethod?: Array;
}
/**
* CreateIntegrationRole请求参数结构体
*/
export interface CreateIntegrationRoleRequest {
/**
* 角色名称,最大长度为20个字符,仅限中文、字母、数字和下划线组成。
*/
Name: string;
/**
* 执行本接口操作的员工信息。使用此接口时,必须填写userId。
支持填入集团子公司经办人 userId 代发合同。
注: 在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。
*/
Operator: UserInfo;
/**
* 角色描述,最大长度为50个字符
*/
Description?: string;
/**
* 角色类型,0:saas角色,1:集团角色
默认0,saas角色
*/
IsGroupRole?: number;
/**
* 权限树
*/
PermissionGroups?: Array;
/**
* 集团角色的话,需要传递集团子企业列表,如果是全选,则传1
*/
SubOrganizationIds?: Array;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
}
/**
* DescribeIntegrationRoles请求参数结构体
*/
export interface DescribeIntegrationRolesRequest {
/**
* 执行本接口操作的员工信息。使用此接口时,必须填写UserId。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。
*/
Operator: UserInfo;
/**
* 指定分页每页返回的数据条数,单页最大支持 200。
*/
Limit: number;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 查询的关键字段,支持Key-Value单值查询。可选键值对如下:
- Key:"RoleType",查询角色类型,Values可选:
- **"1"**:查询系统角色
- **"2"**:查询自定义角色
- Key:"RoleStatus",查询角色状态,Values可选:
- **"1"**:查询启用角色
- **"2"**:查询禁用角色
- Key:"IsGroupRole",是否查询集团角色,Values可选:
- **"0"**:查询非集团角色
- **"1"**:查询集团角色
- Key:"IsReturnPermissionGroup",是否返回角色对应权限树,Values可选:
- **"0"**:接口不返回角色对应的权限树字段
- **"1"**:接口返回角色对应的权限树字段
*/
Filters?: Array;
/**
* OFFSET 用于指定查询结果的偏移量,如果不传默认偏移为0,最大2000。
分页参数, 需要limit, offset 配合使用
例如:
您希望得到第三页的数据, 且每页限制最多10条
您可以使用 LIMIT 10 OFFSET 20
*/
Offset?: number;
}
/**
* CreateFlowGroupSignReview返回参数结构体
*/
export interface CreateFlowGroupSignReviewResponse {
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateFlowReminds返回参数结构体
*/
export interface CreateFlowRemindsResponse {
/**
* 合同催办结果的详细信息列表。
*/
RemindFlowRecords?: Array;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 集团子企业使用集团主企业的套餐使用情况
*/
export interface SubOrgBillUsage {
/**
* 套餐使用数
*/
Used?: number;
/**
* 套餐类型
对应关系如下:
- **CloudEnterprise**: 企业版合同
- **SingleSignature**: 单方签章
- **CloudProve**: 签署报告
- **CloudOnlineSign**: 腾讯会议在线签约
- **ChannelWeCard**: 微工卡
- **SignFlow**: 合同套餐
- **SignFace**: 签署意愿(人脸识别)
- **SignPassword**: 签署意愿(密码)
- **SignSMS**: 签署意愿(短信)
- **PersonalEssAuth**: 签署人实名(腾讯电子签认证)
- **PersonalThirdAuth**: 签署人实名(信任第三方认证)
- **OrgEssAuth**: 签署企业实名
- **FlowNotify**: 短信通知
- **AuthService**: 企业工商信息查询
*/
QuotaType?: string;
}
/**
* DescribeOrganizationGroupOrganizations请求参数结构体
*/
export interface DescribeOrganizationGroupOrganizationsRequest {
/**
* 执行本接口操作的员工信息,userId必填。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。
*/
Operator: UserInfo;
/**
* 指定分页每页返回的数据条数,单页最大支持 200。
*/
Limit: number;
/**
* 偏移量,默认为0,最大20000。关于Offset的更进一步介绍请参考 API 简介中的相关小节。
*/
Offset: number;
/**
* 查询成员企业的企业名,模糊匹配
* @deprecated
*/
Name?: string;
/**
* 成员企业加入集团的当前状态
- **1**:待授权
- **2**:已授权待激活
- **3**:拒绝授权
- **4**:已解除
- **5**:已加入
*/
Status?: number;
/**
* 是否导出当前成员企业数据
- **false**:不导出(默认值)
- **true**:导出
p.s.
若传入此参数, LImit参数将无效,导出的为全量数据。
*/
Export?: boolean;
/**
* 成员企业机构 ID,32 位字符串,在PC控制台 集团管理可获取
*/
Id?: string;
}
/**
* 代理相关应用信息,如集团主企业代子企业操作
*/
export interface Agent {
/**
* 代理机构的应用编号,32位字符串,一般不用传
* @deprecated
*/
AppId?: string;
/**
* 被代理机构的应用号,一般不用传
* @deprecated
*/
ProxyAppId?: string;
/**
* 被代理机构在电子签平台的机构编号,集团代理下场景必传
*/
ProxyOrganizationId?: string;
/**
* 被代理机构的经办人,一般不用传
* @deprecated
*/
ProxyOperator?: string;
}
/**
* 企业应用回调信息
*/
export interface CallbackInfo {
/**
* 回调url,。请确保回调地址能够接收并处理 HTTP POST 请求,并返回状态码 200 以表示处理正常。
*/
CallbackUrl: string;
/**
* 回调加密key,已废弃
* @deprecated
*/
Token?: string;
/**
* 回调加密key,用于回调消息加解密。
*/
CallbackKey?: string;
/**
* 回调验签token,用于回调通知校验。
*/
CallbackToken?: string;
}
/**
* DescribeBatchOrganizationRegistrationUrls请求参数结构体
*/
export interface DescribeBatchOrganizationRegistrationUrlsRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 通过接口CreateBatchOrganizationRegistrationTasks创建企业批量认证链接任得到的任务Id
*/
TaskId: string;
/**
* 代理相关应用信息,如集团主企业代子企业操作的场景中ProxyOrganizationId必填
*/
Agent?: Agent;
}
/**
* 此结构体 (TemplateInfo) 用于描述模板的信息。
> **模板组成**
>
> 一个模板通常会包含以下结构信息
>- 模板基本信息
>- 发起方参与信息Promoter、签署参与方 Recipients,后者会在模板发起合同时用于指定参与方
>- 填写控件 Components
>- 签署控件 SignComponents
>- 生成模板的文件基础信息 FileInfos
*/
export interface TemplateInfo {
/**
* 模板ID,模板的唯一标识
*/
TemplateId?: string;
/**
* 模板的名字
*/
TemplateName?: string;
/**
* 此模块需要签署的各个参与方的角色列表。RecipientId标识每个参与方角色对应的唯一标识符,用于确定此角色的信息。
[点击查看在模板中配置的签署参与方角色列表的样子](https://qcloudimg.tencent-cloud.cn/raw/e082bbcc0d923f8cb723d98382410aa2.png)
*/
Recipients?: Array;
/**
* 模板的填充控件列表
[点击查看在模板中配置的填充控件的样子](https://qcloudimg.tencent-cloud.cn/raw/cb2f58529fca8d909258f9d45a56f7f4.png)
*/
Components?: Array;
/**
* 此模板中的签署控件列表
[点击查看在模板中配置的签署控件的样子](https://qcloudimg.tencent-cloud.cn/raw/29bc6ed753a5a0fce4a3ab02e2c0d955.png)
*/
SignComponents?: Array;
/**
* 模板描述信息
*/
Description?: string;
/**
* 此模板的资源ID
*/
DocumentResourceIds?: Array;
/**
* 生成模板的文件基础信息
*/
FileInfos?: Array;
/**
* 此模板里边附件的资源ID
*/
AttachmentResourceIds?: Array;
/**
* 签署人参与签署的顺序,可以分为以下两种方式:
无序:不限定签署人的签署顺序,签署人可以在任何时间签署。此种方式值为 :{-1}
有序:通过序列数字标识签署顺序,从0开始编码,数字越大签署顺序越靠后,签署人按照指定的顺序依次签署。此种方式值为: {0,1,2,3………}
*/
SignOrder?: Array;
/**
* 此模板的状态可以分为以下几种:
-1:不可用状态。
0:草稿态,即模板正在编辑或未发布状态。
1:正式态,只有正式态的模板才可以发起合同。
*/
Status?: number;
/**
* 模板的创建者信息,用户的名字
注: `是创建者的名字,而非创建者的用户ID`
*/
Creator?: string;
/**
* 模板创建的时间戳,格式为Unix标准时间戳(秒)
*/
CreatedOn?: number;
/**
* 此模板创建方角色信息。
[点击查看在模板中配置的创建方角色的样子](https://qcloudimg.tencent-cloud.cn/raw/e082bbcc0d923f8cb723d98382410aa2.png)
*/
Promoter?: Recipient;
/**
* 模板类型可以分为以下两种:
1:带有本企业自动签署的模板,即签署过程无需签署人手动操作,系统自动完成签署。
3:普通模板,即签署人需要手动进行签署操作。
*/
TemplateType?: number;
/**
* 模板可用状态可以分为以下两种:
1:(默认)启用状态,即模板可以正常使用。
2:停用状态,即模板暂时无法使用。
可到控制台启停模板
*/
Available?: number;
/**
* 创建模板的企业ID,电子签的机构ID
*/
OrganizationId?: string;
/**
* 模板创建人用户ID
*/
CreatorId?: string;
/**
* 模板的 H5 预览链接,有效期为 5 分钟。
您可以通过浏览器直接打开此链接预览模板,或将其嵌入到 iframe 中进行预览。
注意:只有在请求接口时将 WithPreviewUrl 参数设置为 true,才会生成预览链接。
*/
PreviewUrl?: string;
/**
* 用户自定义合同类型。
返回配置模板的时候选择的合同类型。[点击查看配置的位置](https://qcloudimg.tencent-cloud.cn/raw/4a766f0540253bf2a05d50c58bd14990.png)
自定义合同类型配置的地方如链接图所示。[点击查看自定义合同类型管理的位置](https://qcloudimg.tencent-cloud.cn/raw/36582cea03ae6a2559894844942b5d5c.png)
*/
UserFlowType?: UserFlowType;
/**
* 模板版本的编号,旨在标识其独特的版本信息,通常呈现为一串字符串,由日期和递增的数字组成
*/
TemplateVersion?: string;
/**
* 模板是否已发布可以分为以下两种状态:
true:已发布状态,表示该模板已经发布并可以正常使用。
false:未发布状态,表示该模板还未发布,无法使用。
*/
Published?: boolean;
/**
* 集体账号场景下: 集团账号分享给子企业的模板的来源模板ID。
*/
ShareTemplateId?: string;
/**
* 此模板配置的预填印章列表(包括自动签署指定的印章)
*/
TemplateSeals?: Array;
/**
* 模板内部指定的印章列表
注意:此字段可能返回 null,表示取不到有效值。
* @deprecated
*/
Seals?: Array;
}
/**
* DescribeEnterpriseContractReviewChecklists请求参数结构体
*/
export interface DescribeEnterpriseContractReviewChecklistsRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 过滤条件
*/
Filters?: Filter;
/**
* 指定每页返回的数据条数,和Offset参数配合使用。
*/
Limit?: number;
/**
* 查询结果分页返回,指定从第几页返回数据,和Limit参数配合使用。
*/
Offset?: number;
}
/**
* CreateDocument返回参数结构体
*/
export interface CreateDocumentResponse {
/**
* 合同流程的底层电子文档ID,为32位字符串。
注:
后续需用同样的FlowId再次调用[发起签署流程](https://qian.tencent.com/developers/companyApis/startFlows/StartFlow),合同才能进入签署环节
*/
DocumentId?: string;
/**
* 合同预览链接URL。
注: `1.如果是预览模式(即NeedPreview设置为true)时, 才会有此预览链接URL`
`2.当使用的模板中存在动态表格控件时,预览结果中没有动态表格的填写内容,完整的预览链接需通过[合同文档合成完成回调](https://qian.tencent.com/developers/company/callback_types_contracts_sign/#%E4%B9%9D-%E5%90%88%E5%90%8C%E6%96%87%E6%A1%A3%E5%90%88%E6%88%90%E5%AE%8C%E6%88%90%E5%9B%9E%E8%B0%83)获取。
*/
PreviewFileUrl?: string;
/**
* 签署方信息,如角色ID、角色名称等
*/
Approvers?: Array;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateIntegrationUserRoles返回参数结构体
*/
export interface CreateIntegrationUserRolesResponse {
/**
* 绑定角色失败列表信息
*/
FailedCreateRoleData?: Array;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateEmbedWebUrl返回参数结构体
*/
export interface CreateEmbedWebUrlResponse {
/**
* 嵌入的web链接,有效期:5分钟
链接仅能使用一次
建议:每次都用接口生成链接,保证链接的有效性
EmbedType=PREVIEW_CC_FLOW,该url为h5链接
*/
WebUrl?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 集成版企业角色信息。
*/
export interface StaffRole {
/**
* 角色ID。
*/
RoleId?: string;
/**
* 角色名称。
*/
RoleName?: string;
}
/**
* UnbindEmployeeUserIdWithClientOpenId返回参数结构体
*/
export interface UnbindEmployeeUserIdWithClientOpenIdResponse {
/**
* 解绑是否成功。
*/
Status?: number;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateReleaseFlow返回参数结构体
*/
export interface CreateReleaseFlowResponse {
/**
* 解除协议流程编号
`注意:这里的流程编号对应的合同是本次发起的解除协议。`
*/
FlowId?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 合同审查清单个性化参数,用于控制页面的展示内容
*/
export interface ContractReviewChecklistWebUrlOption {
/**
* 禁用新建清单功能。默认 false,设置为 true 会隐藏界面的新建按钮。
*/
DisableCreateChecklist?: boolean;
}
/**
* BindEmployeeUserIdWithClientOpenId请求参数结构体
*/
export interface BindEmployeeUserIdWithClientOpenIdRequest {
/**
* 执行本接口操作的员工信息。使用此接口时,必须填写UserId。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 员工在腾讯电子签平台的唯一身份标识,为32位字符串。
通过DescribeIntegrationEmployees接口获取,也可登录腾讯电子签控制台查看

*/
UserId: string;
/**
* 员工在贵司业务系统中的唯一身份标识,用于与腾讯电子签账号进行映射,确保在同一企业内不会出现重复。 该标识最大长度为64位字符串,仅支持包含26个英文字母和数字0-9的字符。
*/
OpenId: string;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
}
/**
* DescribeIntegrationDepartments请求参数结构体
*/
export interface DescribeIntegrationDepartmentsRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得组织架构管理权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 查询类型,支持以下类型:
- **0**:查询单个部门节点列表,不包含子节点部门信息
- **1**:查询单个部门节点级一级子节点部门信息列表
*/
QueryType: number;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 查询的部门ID。
注:`如果同时指定了DeptId与DeptOpenId参数,系统将优先使用DeptId参数进行查询。当二者都未指定时,系统将返回根节点部门数据。`
*/
DeptId?: string;
/**
* 查询的客户系统部门ID。
注:`如果同时指定了DeptId与DeptOpenId参数,系统将优先使用DeptId参数进行查询。当二者都未指定时,系统将返回根节点部门数据。`
*/
DeptOpenId?: string;
}
/**
* DescribeExtendedServiceAuthDetail请求参数结构体
*/
export interface DescribeExtendedServiceAuthDetailRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 要查询的扩展服务类型。
如下所示:
- OPEN_SERVER_SIGN:企业静默签署
- BATCH_SIGN:批量签署
*/
ExtendServiceType?: string;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 指定每页返回的数据条数,和Offset参数配合使用。 注:`1.默认值为20,单页做大值为200。`
*/
Limit?: number;
/**
* 查询结果分页返回,指定从第几页返回数据,和Limit参数配合使用。 注:`1.offset从0开始,即第一页为0。` `2.默认从第一页返回。`
*/
Offset?: number;
}
/**
* CreateOrganizationAuthFile请求参数结构体
*/
export interface CreateOrganizationAuthFileRequest {
/**
* 企业授权书信息参数, 需要自行保证这些参数跟营业执照中的信息一致。
*/
OrganizationCommonInfo: OrganizationCommonInfo;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator?: UserInfo;
/**
* 授权书类型:
- 0: 企业认证超管授权书
- 1: 超管变更授权书
- 2: 企业注销授权书
*/
Type?: number;
}
/**
* 签署控件的类型和范围限制条件,用于控制文件发起后签署人拖拽签署区时可使用的控件类型和具体的印章或签名方式。
*/
export interface ComponentLimit {
/**
* 控件类型,支持以下类型
- SIGN_SEAL : 印章控件
- SIGN_PAGING_SEAL : 骑缝章控件
- SIGN_LEGAL_PERSON_SEAL : 企业法定代表人控件
- SIGN_SIGNATURE : 用户签名控件
*/
ComponentType: string;
/**
* 签署控件类型的值(可选),用与限制签署时印章或者签名的选择范围
1.当ComponentType 是 SIGN_SEAL 或者 SIGN_PAGING_SEAL 时可传入企业印章Id(支持多个)或者以下印章类型
- OFFICIAL : 企业公章
- CONTRACT : 合同专用章
- FINANCE : 财务专用章
- PERSONNEL : 人事专用章
- OTHER : 其他
**注:`限制印章控件或骑缝章控件情况下,仅本企业签署方可以指定具体印章(通过传递ComponentValue,支持多个),他方企业签署人只能限制类型.若同时指定了印章类型和印章Id,以印章Id为主,印章类型会被忽略`**
2.当ComponentType 是 SIGN_SIGNATURE 时可传入以下类型(支持多个)
- HANDWRITE : 需要实时手写的手写签名
- HANDWRITTEN_ESIGN : 长效手写签名, 是使用保存到个人中心的印章列表的手写签名(并且包含HANDWRITE)
- OCR_ESIGN : OCR印章(智慧手写签名)
- ESIGN : 个人印章
- SYSTEM_ESIGN : 系统印章
3.当ComponentType 是 SIGN_LEGAL_PERSON_SEAL 时无需传递此参数。
*/
ComponentValue?: Array;
}
/**
* ModifyPartnerAuthorization请求参数结构体
*/
export interface ModifyPartnerAuthorizationRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 腾讯电子签平台分配的生态集成业务的**业务标识**,**需要联系接入产品经理提供**。
*/
BusinessId: string;
/**
* 合作方企业通过集成方创建的应用id, 必须与业务标记(Business)保持对应。

*/
PartnerApplicationId: string;
/**
* 第三方应用的配置信息。其中包括 回调地址,加密KEY等信息。
执行成功后会覆盖掉对应的第三方应用的回调相关配置。
*/
ApplicationInfo: CallbackInfo;
}
/**
* CreateIntegrationSubOrganizationActiveRecord返回参数结构体
*/
export interface CreateIntegrationSubOrganizationActiveRecordResponse {
/**
* 激活失败的成员企业ID集合
*/
FailedSubOrganizationIds?: Array;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 补充签署人信息
- RecipientId 必须指定
- 通过企业微信自定义账号ID补充签署人时,ApproverSource 和 CustomUserId 必填,ApproverSource取值:WEWORKAPP
- 通过二要素(姓名/手机号)补充签署人时,ApproverName 和 ApproverMobile 必填,ApproverSource设置为空
- 补充个人签署方时,若该用户已在电子签完成实名则可通过指定姓名和证件类型、证件号码完成补充
*/
export interface FillApproverInfo {
/**
* 签署方经办人在模板中配置的参与方ID,与控件绑定,是控件的归属方,ID为32位字符串。
模板发起合同时,该参数为必填项。
文件发起合同时,该参数无需传值。
如果开发者后序用合同模板发起合同,建议保存此值,在用合同模板发起合同中需此值绑定对应的签署经办人 。
*/
RecipientId: string;
/**
* 签署人来源
WEWORKAPP: 企业微信
仅【企微或签】时指定WEWORKAPP
*/
ApproverSource?: string;
/**
* 企业微信UserId
当ApproverSource为WEWORKAPP的企微或签场景下,必须指企业自有应用获取企业微信的UserId
*/
CustomUserId?: string;
/**
* 企业签署人的员工姓名。除企业微信应用场景(ApproverSource设置为WEWORKAPP)外,本字段为必填。
*/
ApproverName?: string;
/**
* 补充企业签署人员工手机号
- ApproverSource!=WEWORKAPP时,必传
*/
ApproverMobile?: string;
/**
* 补充企业动态签署人时,需要指定对应企业名称
*/
OrganizationName?: string;
/**
* 签署方经办人的证件类型,支持以下类型
- ID_CARD 中国大陆居民身份证
- HONGKONG_AND_MACAO 中国港澳居民来往内地通行证
- HONGKONG_MACAO_AND_TAIWAN 中国港澳台居民居住证(格式同中国大陆居民身份证)
- OTHER_CARD_TYPE 其他证件
注: `1.其他证件类型为白名单功能,使用前请联系对接的客户经理沟通。`
`2.补充个人签署方时,若该用户已在电子签完成实名则可通过指定姓名和证件类型、证件号码完成补充。`
*/
ApproverIdCardType?: string;
/**
* 签署方经办人的证件号码,应符合以下规则
- 中国大陆居民身份证号码应为18位字符串,由数字和大写字母X组成(如存在X,请大写)。
- 中国港澳居民来往内地通行证号码共11位。第1位为字母,“H”字头签发给中国香港居民,“M”字头签发给中国澳门居民;第2位至第11位为数字
- 中国港澳台居民居住证号码编码规则与中国大陆身份证相同,应为18位字符串
注:`补充个人签署方时,若该用户已在电子签完成实名则可通过指定姓名和证件类型、证件号码完成补充。`
*/
ApproverIdCardNumber?: string;
/**
* 合同流程ID
- 补充合同组子合同动态签署人时必传。
- 补充普通合同时,请阅读:补充签署人接口的接口使用说明
*/
FlowId?: string;
/**
* 通知类型:
当FillApproverType =0,或签场景补充签署人时,指定是否发送或签领取短信
SMS:开启或签领取短信通知
NONE:关闭或签领取短信通知
当NotifyType=NONE时,可调用获取跳转至腾讯电子签小程序的签署链接接口生成签署链接来完成或签领取
*/
NotifyType?: string;
}
/**
* CreatePersonAuthCertificateImage返回参数结构体
*/
export interface CreatePersonAuthCertificateImageResponse {
/**
* 个人用户认证证书图片下载URL,`有效期为5分钟`,超过有效期后将无法再下载。
*/
AuthCertUrl?: string;
/**
* 个人用户认证证书的编号, 为20位数字组成的字符串, 由腾讯电子签下发此编号 。
该编号会合成到个人用户证书证明图片。
注: `个人用户认证证书的编号和证明图片绑定, 获取新的证明图片编号会变动`
*/
ImageCertId?: string;
/**
* 在数字证书申请过程中,系统会自动生成一个独一无二的序列号。请注意,当证书到期并自动续期时,该序列号将会发生变化。值得注意的是,此序列号不会被合成至个人用户证书的证明图片中。
*/
SerialNumber?: string;
/**
* CA证书颁发时间,格式为Unix标准时间戳(秒)
该时间格式化后会合成到个人用户证书证明图片
*/
ValidFrom?: number;
/**
* CA证书有效截止时间,格式为Unix标准时间戳(秒)
该时间格式化后会合成到个人用户证书证明图片
*/
ValidTo?: number;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 转交合同结果
*/
export interface FlowForwardResult {
/**
* 合同流程ID为32位字符串。您可以登录腾讯电子签控制台,在 "合同" -> "合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。[点击查看FlowId在控制台中的位置](https://qcloudimg.tencent-cloud.cn/raw/0a83015166cfe1cb043d14f9ec4bd75e.png)。
*/
FlowId?: string;
/**
* 如果失败,返回的错误细节。
*/
ErrorDetail?: string;
}
/**
* DescribeLMInformationExtractionTaskFieldFeedback返回参数结构体
*/
export interface DescribeLMInformationExtractionTaskFieldFeedbackResponse {
/**
* 合同智能提取子任务反馈信息
*/
SubTaskFeedbackList?: Array;
/**
* 合同智能提取任务ID
*/
TaskId?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateLMInformationExtractionTaskFieldFeedback返回参数结构体
*/
export interface CreateLMInformationExtractionTaskFieldFeedbackResponse {
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DescribeIntegrationEmployees返回参数结构体
*/
export interface DescribeIntegrationEmployeesResponse {
/**
* 员工信息列表。
*/
Employees?: Array;
/**
* 偏移量
*/
Offset?: number;
/**
* 指定分页每页返回的数据条数,单页最大支持 20。
*/
Limit?: number;
/**
* 符合条件的员工数量。
*/
TotalCount?: number;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* ModifyFlowDeadline返回参数结构体
*/
export interface ModifyFlowDeadlineResponse {
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateBatchCancelFlowUrl返回参数结构体
*/
export interface CreateBatchCancelFlowUrlResponse {
/**
* 批量撤回签署流程链接
*/
BatchCancelFlowUrl?: string;
/**
* 签署流程撤回失败信息
数组里边的错误原因与传进来的FlowIds一一对应,如果是空字符串则标识没有出错
*/
FailMessages?: Array;
/**
* 签署连接过期时间字符串:年月日-时分秒
*/
UrlExpireOn?: string;
/**
* 批量撤销任务编号,为32位字符串,可用于[查询批量撤销签署流程任务结果](https://qian.tencent.com/developers/companyApis/operateFlows/CreateBatchCancelFlowUrl) 或关联[批量撤销任务结果回调](https://qian.tencent.com/developers/company/callback_types_contracts_sign#%E4%B9%9D-%E6%89%B9%E9%87%8F%E6%92%A4%E9%94%80%E7%BB%93%E6%9E%9C%E5%9B%9E%E8%B0%83)
*/
TaskId?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 创建员工的失败数据
*/
export interface FailedCreateStaffData {
/**
* 员工名
*/
DisplayName?: string;
/**
* 员工手机号
*/
Mobile?: string;
/**
* 传入的企微账号id
*/
WeworkOpenId?: string;
/**
* 失败原因
*/
Reason?: string;
}
/**
* CreateUserAutoSignEnableUrl返回参数结构体
*/
export interface CreateUserAutoSignEnableUrlResponse {
/**
* 个人用户自动签的开通链接, 短链形式。过期时间受 `ExpiredTime` 参数控制。
*/
Url?: string;
/**
* 腾讯电子签小程序的 AppID,用于其他小程序/APP等应用跳转至腾讯电子签小程序使用
注: `如果获取的是H5链接, 则不会返回此值`
*/
AppId?: string;
/**
* 腾讯电子签小程序的原始 Id, ,用于其他小程序/APP等应用跳转至腾讯电子签小程序使用
注: `如果获取的是H5链接, 则不会返回此值`
*/
AppOriginalId?: string;
/**
* 腾讯电子签小程序的跳转路径,用于其他小程序/APP等应用跳转至腾讯电子签小程序使用
注: `如果获取的是H5链接, 则不会返回此值`
*/
Path?: string;
/**
* base64 格式的跳转二维码图片,可通过微信扫描后跳转到腾讯电子签小程序的开通界面。
注: `如果获取的是H5链接, 则不会返回此二维码图片`
*/
QrCode?: string;
/**
* 返回的链接类型
- 空: 默认小程序端链接
- **H5SIGN** : h5端链接
*/
UrlType?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 此结构体(FlowGroupInfo)描述的是合同组(流程组)的单个合同(流程)信息
*/
export interface FlowGroupInfo {
/**
* 合同流程的名称(可自定义此名称),长度不能超过200,只能由中文、字母、数字和下划线组成。
该名称还将用于合同签署完成后的下载文件名。
*/
FlowName: string;
/**
* 签署流程参与者信息,最大限制50方
注意 approver中的顺序需要和模板中的顺序保持一致, 否则会导致模板中配置的信息无效。
*/
Approvers: Array;
/**
* 文件资源ID,通过多文件上传[UploadFiles](https://qian.tencent.com/developers/companyApis/templatesAndFiles/UploadFiles)接口获得,为32位字符串。
注:此字段定义为数组,但仅支持单个文件
*/
FileIds?: Array;
/**
* 合同模板ID,为32位字符串。
建议开发者保存此模板ID,后续用此模板发起合同流程需要此参数。
可登录腾讯电子签控制台,在 "模板"->"模板中心"->"列表展示设置"选中模板 ID 中查看某个模板的TemplateId(在页面中展示为模板ID)。
*/
TemplateId?: string;
/**
* 签署流程的类型(如销售合同/入职合同等),最大长度200个字符
*/
FlowType?: string;
/**
* 签署流程描述,最大长度1000个字符
*/
FlowDescription?: string;
/**
* 签署流程的签署截止时间。
值为unix时间戳,精确到秒,不传默认为当前时间一年后
示例值:1604912664
*/
Deadline?: number;
/**
* 合同(流程)的回调地址
* @deprecated
*/
CallbackUrl?: string;
/**
* 调用方自定义的个性化字段(可自定义此字段的值),并以base64方式编码,支持的最大数据大小为 20480长度。
在合同状态变更的回调信息等场景中,该字段的信息将原封不动地透传给贵方。
回调的相关说明可参考开发者中心的回调通知模块。
*/
UserData?: string;
/**
* 发送类型:
true:无序签
false:有序签
注:默认为false(有序签),请和模板中的配置保持一致
示例值:true
*/
Unordered?: boolean;
/**
* 模板或者合同中的填写控件列表,列表中可支持下列多种填写控件,控件的详细定义参考开发者中心的Component结构体
- 单行文本控件
- 多行文本控件
- 勾选框控件
- 数字控件
- 图片控件
- 动态表格等填写控件
*/
Components?: Array;
/**
* 发起方企业的签署人进行签署操作是否需要企业内部审批。使用此功能需要发起方企业有参与签署。
若设置为true,审核结果需通过接口 [CreateFlowSignReview](https://qian.tencent.com/developers/companyApis/operateFlows/CreateFlowSignReview) 通知电子签,审核通过后,发起方企业签署人方可进行签署操作,否则会阻塞其签署操作。
注:企业可以通过此功能与企业内部的审批流程进行关联,支持手动、静默签署合同。
示例值:true
*/
NeedSignReview?: boolean;
/**
* 个人自动签场景。发起自动签署时,需设置对应自动签署场景,目前仅支持场景:处方单-E_PRESCRIPTION_AUTO_SIGN
*/
AutoSignScene?: string;
/**
* 在短信通知、填写、签署流程中,若标题、按钮、合同详情等地方存在“合同”字样时,可根据此配置指定文案,可选文案如下: - 0 :合同(默认值)
- 1 :文件
- 2 :协议
- 3 :文书
效果如下:
*/
FlowDisplayType?: number;
}
/**
* CreatePartnerAutoSignAuthUrl返回参数结构体
*/
export interface CreatePartnerAutoSignAuthUrlResponse {
/**
* 授权链接,以短链形式返回,短链的有效期参考回参中的 ExpiredTime。
*/
Url?: string;
/**
* 从客户小程序或者客户APP跳转至腾讯电子签小程序进行批量签署的跳转路径
*/
MiniAppPath?: string;
/**
* 链接过期时间以 Unix 时间戳格式表示,从生成链接时间起,往后7天有效期。过期后短链将失效,无法打开。
*/
ExpireTime?: number;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* ArchiveDynamicFlow请求参数结构体
*/
export interface ArchiveDynamicFlowRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 合同流程ID, 为32位字符串。
可登录腾讯电子签控制台,[点击查看FlowId在控制台中的位置](https://qcloudimg.tencent-cloud.cn/raw/0a83015166cfe1cb043d14f9ec4bd75e.png)
*/
FlowId: string;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
}
/**
* ModifyIntegrationRole返回参数结构体
*/
export interface ModifyIntegrationRoleResponse {
/**
* 角色id
*/
RoleId?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 签署方在使用个人印章签署控件(SIGN_SIGNATURE) 时可使用的签署方式
*/
export interface ApproverComponentLimitType {
/**
* 签署方经办人在模板中配置的参与方ID,与控件绑定,是控件的归属方,ID为32位字符串。
*/
RecipientId: string;
/**
* 签署方经办人控件类型是个人印章签署控件(SIGN_SIGNATURE) 时,可选的签名方式,可多选
签名方式:
- HANDWRITE-手写签名
- ESIGN-个人印章类型
- OCR_ESIGN-AI智能识别手写签名
- SYSTEM_ESIGN-系统签名
*/
Values: Array;
}
/**
* CreateSingleSignOnEmployees返回参数结构体
*/
export interface CreateSingleSignOnEmployeesResponse {
/**
* 导入员工返回的错误信息,信息数组的顺序跟导入的保持一致
*/
ErrorMessages?: Array;
/**
* 导入员工返回的状态码
0-全部成功
1-部分成功
2-全部失败
*/
Status?: number;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateFlowEvidenceReport返回参数结构体
*/
export interface CreateFlowEvidenceReportResponse {
/**
* 出证报告 ID,可用于获取出证报告任务执行结果查询出证任务结果和出证PDF的下载URL
*/
ReportId?: string;
/**
* 出证任务执行的状态, 状态含义如下:
- **EvidenceStatusExecuting**: 出证任务在执行中
- **EvidenceStatusSuccess**: 出证任务执行成功
- **EvidenceStatusFailed** : 出证任务执行失败
*/
Status?: string;
/**
* 此字段已经废除,不再使用.
出证的PDF下载地址请调用DescribeChannelFlowEvidenceReport接口获取
* @deprecated
*/
ReportUrl?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 视频核身相关配置
*/
export interface RuleIdConfig {
/**
* 意愿核身语音播报速度,配置后问答模式和点头模式的语音播报环节都会生效,默认值为0:
0-智能语速(根据播报文案的长度自动调整语音播报速度)
1-固定1倍速
2-固定1.2倍速
3-固定1.5倍速
*/
Speed?: number;
}
/**
* OperateTemplate返回参数结构体
*/
export interface OperateTemplateResponse {
/**
* 模板ID,为32位字符串,模板复制新建时返回
*/
TemplateId?: string;
/**
* 模板名称,模板复制新建时返回
*/
TemplateName?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateOrganizationGroupInvitationLink返回参数结构体
*/
export interface CreateOrganizationGroupInvitationLinkResponse {
/**
* 加入集团二维码链接,子企业的管理员可以直接扫码进入。
注意:1. 该链接有效期时间为ExpireTime,同时需要注意保密,不要外泄给无关用户。2. 该链接不支持小程序嵌入,仅支持移动端浏览器打开。3. 生成的链路后面不能再增加参数(会出现覆盖链接中已有参数导致错误)
*/
Link?: string;
/**
* 到期时间(以秒为单位的时间戳)
*/
ExpireTime?: number;
/**
* 加入集团短链接。
注意:
1. 该链接有效期时间为ExpireTime,同时需要注意保密,不要外泄给无关用户。
2. 该链接不支持小程序嵌入,仅支持移动端浏览器打开。
3. 生成的链路后面不能再增加参数(会出现覆盖链接中已有参数导致错误)
*/
JumpUrl?: string;
/**
* 腾讯电子签小程序加入集团链接。
小程序和APP集成使用
得到的链接类似于`pages/guide?shortKey=yDw***k1xFc5`, 用法可以参考:跳转电子签小程序
注: 生成的链路后面不能再增加参数
*/
MiniAppPath?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DeleteIntegrationRoleUsers返回参数结构体
*/
export interface DeleteIntegrationRoleUsersResponse {
/**
* 角色id
*/
RoleId?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateFlowGroupByFiles请求参数结构体
*/
export interface CreateFlowGroupByFilesRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 合同(流程)组名称(可自定义此名称),长度不能超过200,只能由中文、字母、数字和下划线组成。
*/
FlowGroupName: string;
/**
* 合同(流程)组的子合同信息,支持2-50个子合同
*/
FlowGroupInfos: Array;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 合同(流程)组的配置项信息。
其中包括:
*/
FlowGroupOptions?: FlowGroupOptions;
/**
* 用户自定义合同类型。
自定义合同类型配置的地方如链接图所示。[点击查看自定义合同类型管理的位置](https://qcloudimg.tencent-cloud.cn/raw/36582cea03ae6a2559894844942b5d5c.png)
注意:
如果传递了自定义合同类型,则每一个子合同设置的自定义合同类型将会失效,已最外层定义的为准。
例如:
这份合同组有三个子合同,设置合同类型为人事/劳务
第一份子合同设置的合同自定义合同类型是采购
第二份和第三份子合同设置的合同自定义合同类型是人事/劳务
但最终这个合同组的合同类型是人事/劳务
*/
UserFlowType?: UserFlowType;
}
/**
* 催办接口返回的详细信息。
*/
export interface RemindFlowRecords {
/**
* 合同流程是否可以催办:
true - 可以,false - 不可以。
若无法催办,将返回RemindMessage以解释原因。
*/
CanRemind?: boolean;
/**
* 合同流程ID,为32位字符串。
*/
FlowId?: string;
/**
* 在合同流程无法催办的情况下,系统将返回RemindMessage以阐述原因。
*/
RemindMessage?: string;
}
/**
* CreatePreparedPersonalEsign返回参数结构体
*/
export interface CreatePreparedPersonalEsignResponse {
/**
* 导入生成的印章ID,为32位字符串。
建议开发者保存此印章ID,开头实名认证后,通过此 ID查询导入的印章。
*/
SealId?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 此结构体(FlowGroupOptions)描述的是合同组的个性化配置,支持控制是否发送短信、未实名个人签署方查看合同组时是否需要实名认证(仅在合同组文件发起配置时生效)
*/
export interface FlowGroupOptions {
/**
* 签署人校验方式,支持以下类型
- VerifyCheck : 人脸识别 (默认值)
- MobileCheck : 手机号验证
参数说明:此参数仅在合同组文件发起有效,可选人脸识别或手机号验证两种方式,若选择后者,未实名个人签署方在签署合同时,无需经过实名认证和意愿确认两次人脸识别,该能力仅适用于个人签署方。
*/
ApproverVerifyType?: string;
/**
* 发起合同(流程)组本方企业经办人通知方式
签署通知类型,支持以下类型
*/
SelfOrganizationApproverNotifyType?: string;
/**
* 发起合同(流程)组他方经办人通知方式
签署通知类型,支持以下类型
*/
OtherApproverNotifyType?: string;
/**
* 是否开启发起合同组的发起审批,默认:false(不开启),开启后,发起合同组会提交电子签内置审批流
*/
FlowGroupNeedWorkflow?: boolean;
}
/**
* 创建合同,若对方签署人的企业信息还未在腾讯电子签注册。则在进行引导企业注册时控制企业填写的信息。
具体可查看[视频](https://qian.tencent.com/developers/video/?menu=scene&id=6)
*/
export interface RegisterInfo {
/**
* 法人姓名
*/
LegalName: string;
/**
* 社会统一信用代码
注意:此字段可能返回 null,表示取不到有效值。
* @deprecated
*/
Uscc?: string;
/**
* 社会统一信用代码
*/
UnifiedSocialCreditCode?: string;
/**
* 组织机构企业注册地址。 请确认该企业注册地址与企业营业执照中注册的地址一致。
*/
OrganizationAddress?: string;
/**
* 指定企业认证的授权方式 支持多选:
*/
AuthorizationTypes?: Array;
/**
* 指定企业认证的授权方式:
* @deprecated
*/
AuthorizationType?: number;
/**
* 指定企业认证的授权方式 支持多选:
- 1: 上传营业执照
- 2: 腾讯云快速认证
- 3: 腾讯商户号授权(仅支持小程序端)
*/
AuthorizationMethods?: Array;
/**
* 企业证照类型:
USCC :(默认)工商组织营业执照
PRACTICELICENSEOFMEDICALINSTITUTION :医疗机构执业许可证
CLINICFILLINGCERTIFICATE:诊所备案证
*/
OrganizationIdCardType?: string;
/**
* 企业创建时候的个性化参数。
其中,包括一下内容:
LegalNameSame 是否可以编辑法人。
UnifiedSocialCreditCodeSame 是否可以编辑证件号码。
OrganizationIdCardTypeSame 是否可以更改证照类型。
*/
RegisterInfoOption?: RegisterInfoOption;
}
/**
* 合同审查反馈信息
*/
export interface RiskIdentificationFeedbackInfo {
/**
* 审查结果ID
*/
RiskId?: string;
/**
* 反馈结果
- 1: 其他错误
- 2: 审查错误
- 3: 审查正确
*/
FeedbackResult?: number;
/**
* 反馈原因
*/
Reason?: string;
}
/**
* CreateReleaseFlow请求参数结构体
*/
export interface CreateReleaseFlowRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 待解除的签署流程编号(即原签署流程的编号)。
*/
NeedRelievedFlowId: string;
/**
* 解除协议内容, 包括解除理由等信息。
*/
ReliveInfo: RelieveInfo;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 替换解除协议的签署人, 如不指定新的签署人,将继续使用原流程的签署人作为本解除协议的参与方。
如需更换原合同中的企业端签署人,可通过指定该签署人的RecipientId编号更换此企业端签署人。(可通过接口DescribeFlowInfo查询签署人的RecipientId编号)
注:
1. 支持更换企业的签署人,不支持更换个人类型的签署人。
2. 己方企业支持自动签署,他方企业不支持自动签署。
3. 仅将需要替换的签署人添加至此列表,无需替换的签署人无需添加进来。
*/
ReleasedApprovers?: Array;
/**
* 合同流程的签署截止时间,格式为Unix标准时间戳(秒),如果未设置签署截止时间,则默认为合同流程创建后的7天时截止。
如果在签署截止时间前未完成签署,则合同状态会变为已过期,导致合同作废。
*/
Deadline?: number;
/**
* 调用方自定义的个性化字段,该字段的值可以是字符串JSON或其他字符串形式,客户可以根据自身需求自定义数据格式并在需要时进行解析。该字段的信息将以Base64编码的形式传输,支持的最大数据大小为20480长度。
在合同状态变更的回调信息等场景中,该字段的信息将原封不动地透传给贵方。
回调的相关说明可参考开发者中心的回调通知模块。
*/
UserData?: string;
}
/**
* CreateIntegrationUserRoles请求参数结构体
*/
export interface CreateIntegrationUserRolesRequest {
/**
* 执行本接口操作的员工信息。 注: 在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。
*/
Operator: UserInfo;
/**
* 绑定角色的用户id列表,不能重复,不能大于 100 个
*/
UserIds: Array;
/**
* 绑定角色的角色id列表,不能重复,不能大于 100,可以通过DescribeIntegrationRoles接口获取角色信息
*/
RoleIds: Array;
/**
* 代理企业和员工的信息。 在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
}
/**
* 更新员工信息成功返回的数据信息, 仅支持未实名的用户进行更新
会通过短信、企微消息或者H5Url 链接
如果是通过H5邀请加入的方式,会返回H5 链接
*/
export interface SuccessUpdateStaffData {
/**
* 传入的用户名称
*/
DisplayName?: string;
/**
* 传入的手机号,没有打码
*/
Mobile?: string;
/**
* 员工在腾讯电子签平台的唯一身份标识,为32位字符串。
可登录腾讯电子签控制台,在 "更多能力"->"组织管理" 中查看某位员工的UserId(在页面中展示为用户ID)。
*/
UserId?: string;
/**
* H5端员工实名链接
只有入参 InvitationNotifyType = H5的时候才会进行返回。
*/
Url?: string;
}
/**
* 创建/修改员工成功返回的信息
现在支持saas/企微/H5端进行加入。
*/
export interface SuccessCreateStaffData {
/**
* 员工名
*/
DisplayName?: string;
/**
* 员工手机号
*/
Mobile?: string;
/**
* 员工在电子签平台的id
*/
UserId?: string;
/**
* 提示,当创建已存在未实名用户时,该字段有值
*/
Note?: string;
/**
* 传入的企微账号id
*/
WeworkOpenId?: string;
/**
* 员工邀请返回链接 根据入参的 InvitationNotifyType 和 Endpoint 返回链接 | 链接类型 | 有效期 | 示例 |
| HTTP_SHORT_URL(短链) | 一天 | https://test.essurl.cn/fvG7UBEd0F |
| HTTP(长链) | 一天 | https://res.ess.tencent.cn/cdn/h5-activity-dev/jump-mp.html?where=mini&from=MSG&to=USER_VERIFY&verifyToken=yDCVbUUckpwocmfpUySko7IS83LTV0u0&expireTime=1710840183 |
| H5 | 30 天 | https://quick.test.qian.tencent.cn/guide?Code=yDCVbUUckpwtvxqoUbTw4VBBjLbfAtW7&CodeType=QUICK&shortKey=yDCVbUY7lhqV7mZlCL2d |
| APP | 一天 | /pages/guide/index?to=USER_VERIFY&verifyToken=yDCVbUUckpwocm96UySko7ISvEIZH7Yz&expireTime=1710840455 |
*/
Url?: string;
}
/**
* 主体信息
*/
export interface Identity {
/**
* 统一社会信用代码
*/
CreditCode?: string;
/**
* 组织机构代码
*/
OrgCode?: string;
/**
* 营业执照注册编号
*/
RegNo?: string;
/**
* 企业名称
*/
EntName?: string;
/**
* 修改人法人代表姓名
*/
LegalRepName?: string;
/**
* 渠道经营状态
*/
OpState?: string;
/**
* 经营期限自(格式YYYY-MM-DD)
*/
OpFromDate?: string;
/**
* 经营期限至
*/
OpToDate?: string;
/**
* 成立日期(格式YYYY-MM-DD)
*/
EstabDate?: string;
/**
* 核准日期(格式YYYY-MM-DD)
*/
ApprDate?: string;
/**
* 吊销日期(格式YYYY-MM-DD)
*/
RevoDate?: string;
/**
* 注销日期(格式YYYY-MM-DD)
*/
CancelDate?: string;
/**
* 登记机关
*/
RegOrg?: string;
/**
* 企业类型编码
*/
EntTypeCode?: string;
/**
* 企业类型
*/
EntType?: string;
/**
* 经营业务范围
*/
BizScope?: string;
/**
* 许可经营项目
*/
LicenseBizItem?: string;
/**
* 注册地址行政编号
*/
RegAreaCode?: string;
/**
* 注册地址
*/
RegAddress?: string;
/**
* 注册资本币种
*/
RegCapitalCurtype?: string;
/**
* 注册资本(万元)
*/
RegCapital?: string;
/**
* 实收资本(万元)
*/
PaidCapital?: string;
/**
* 原注册号
*/
OriRegNo?: string;
/**
* 企业英文名称
*/
EntNameEng?: string;
/**
* 曾用名
*/
OriEntName?: string;
/**
* 企业经营状态枚举。常见值如下:
未定义的状态 = 0
正常 = 1
注销 = 2
吊销 = 3
吊销后注销 = 4
撤销 = 5
其他 = 99
*/
OpStateCode?: number;
/**
* 查询日期(格式YYYY-MM-DD)
*/
SearchDate?: string;
}
/**
* 此结构体 (UploadFile) 用于描述多文件上传的文件信息。
*/
export interface UploadFile {
/**
* Base64编码后的文件内容
*/
FileBody: string;
/**
* 文件的名字。
文件名的最大长度应不超过200个字符,并且文件名的后缀必须反映其文件类型。
例如,PDF文件应以“.pdf”结尾,如“XXX.pdf”,而Word文件应以“.doc”或“.docx”结尾,如“XXX.doc”或“XXX.docx”。
*/
FileName?: string;
}
/**
* CreateFlowSignReview返回参数结构体
*/
export interface CreateFlowSignReviewResponse {
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* RenewAutoSignLicense请求参数结构体
*/
export interface RenewAutoSignLicenseRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 自动签使用的场景值, 可以选择的场景值如下:
- **E_PRESCRIPTION_AUTO_SIGN** : 电子处方场景
- **OTHER** : 通用场景
*/
SceneKey: string;
/**
* 需要续期自动签的个人的信息,如姓名,证件信息等。
*/
UserInfo: UserThreeFactor;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
}
/**
* 文档内的填充控件返回结构体,返回控件的基本信息和填写内容值
*/
export interface FilledComponent {
/**
* 控件Id
*/
ComponentId?: string;
/**
* 控件名称
*/
ComponentName?: string;
/**
* 控件填写状态;0-未填写;1-已填写
*/
ComponentFillStatus?: string;
/**
* 控件填写内容
*/
ComponentValue?: string;
/**
* 控件所属参与方Id
*/
ComponentRecipientId?: string;
/**
* 图片填充控件下载链接,如果是图片填充控件时,这里返回图片的下载链接。
*/
ImageUrl?: string;
}
/**
* CreateWebThemeConfig请求参数结构体
*/
export interface CreateWebThemeConfigRequest {
/**
* 注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 主题类型,取值如下:
- **EMBED_WEB_THEME**:嵌入式主题(默认),web页面嵌入的主题风格配置
*/
ThemeType: string;
/**
* 电子签logo是否展示,主体颜色等配置项
*/
WebThemeConfig: WebThemeConfig;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
}
/**
* CreateEmployeeQualificationSealQrCode返回参数结构体
*/
export interface CreateEmployeeQualificationSealQrCodeResponse {
/**
* 二维码图片的Base64 注: `此二维码的有效时间为7天,过期后需要重新生成新的二维码图片`
*/
QrcodeBase64?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateUserVerifyUrl返回参数结构体
*/
export interface CreateUserVerifyUrlResponse {
/**
* 腾讯电子签小程序的实名认证链接。
如果没有传递,默认值是 HTTP。 链接的有效期均是 7 天。
1.如果EndPoint是APP:
得到的链接类似于pages/guide/index?to=MP_PERSONAL_VERIFY&shortKey=yDCZHUyOcExAlcOvNod0, 用法可以参考描述中的"跳转到小程序的实现"
2.如果EndPoint是HTTP:
得到的链接类似于 https://res.ess.tencent.cn/cdn/h5-activity/jump-mp.html?to=TAG_VERIFY&shortKey=yDCZHUyOcChrfpaswT0d,点击后会跳转到腾讯电子签小程序进行签署
3.如果EndPoint是HTTP_SHORT_URL:
得到的链接类似于https://essurl.cn/2n**42Nd,点击后会跳转到腾讯电子签小程序进行签署
4.如果EndPoint是H5:
得到的链接类似于 https://quick.test.qian.tencent.cn/guide?Code=yDU****VJhsS5q&CodeType=xxx&shortKey=yD*****frcb,点击后会跳转到腾讯电子签H5页面进行签署
5.如果EndPoint是H5_SHORT_URL:
得到的链接类似于https://essurl.cn/2n**42Nd,点击后会跳转到腾讯电子签H5页面进行签署
`注:` 生成的链路后面不能再增加参数,防止出错重复参数覆盖原有的参数
示例值:https://essurl.cn/2n**42Nd
*/
UserVerifyUrl?: string;
/**
* 链接过期时间,为Unix时间戳(单位为秒)。
*/
ExpireTime?: number;
/**
* 小程序appid,用于半屏拉起电子签小程序, 仅在 Endpoint 设置为 APP 的时候返回
*/
MiniAppId?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* GetTaskResultApi返回参数结构体
*/
export interface GetTaskResultApiResponse {
/**
* 任务Id
*/
TaskId?: string;
/**
* 任务状态,需要关注的状态
- **0** :NeedTranform - 任务已提交
- **4** :Processing - 文档转换中
- **8** :TaskEnd - 任务处理完成
- **-2** :DownloadFailed - 下载失败
- **-6** :ProcessFailed - 转换失败
- **-13**:ProcessTimeout - 转换文件超时
*/
TaskStatus?: number;
/**
* 状态描述,需要关注的状态
- **NeedTranform** : 任务已提交
- **Processing** : 文档转换中
- **TaskEnd** : 任务处理完成
- **DownloadFailed** : 下载失败
- **ProcessFailed** : 转换失败
- **ProcessTimeout** : 转换文件超时
*/
TaskMessage?: string;
/**
* 资源Id(即FileId),用于[用PDF文件创建签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlowByFiles)
*/
ResourceId?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 用户自定义合同类型, 自定义合同类型的管理可以[点击查看在控制台位置的截图](https://qcloudimg.tencent-cloud.cn/raw/85a9b2ebce07b0cd6d75d5327d538235.png)
*/
export interface UserFlowType {
/**
* 合同类型ID
*/
UserFlowTypeId?: string;
/**
* 合同类型名称
*/
Name?: string;
/**
* 合同类型说明
*/
Description?: string;
}
/**
* CreatePrepareFlowGroup请求参数结构体
*/
export interface CreatePrepareFlowGroupRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 合同(流程)组名称(可自定义此名称),长度不能超过200,只能由中文、字母、数字和下划线组成。
*/
FlowGroupName: string;
/**
* 合同(流程)组的子合同信息,支持2-50个子合同
*/
FlowGroupInfos: Array;
/**
* 资源类型,取值有:
*/
ResourceType: number;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 合同组发起控制参数,当前仅支持FlowGroupNeedWorkflow,表示开启嵌入式合同组发起审批
*/
FlowGroupOptions?: FlowGroupOptions;
}
/**
* CreateFileCounterSign返回参数结构体
*/
export interface CreateFileCounterSignResponse {
/**
* 加签任务的状态。
- PROCESSING: 任务正在执行中。
- FINISHED: 已执行成功
*/
Status?: string;
/**
* 加签完成后新的文件Id
*/
ResultFileId?: string;
/**
* 异步模式下用于轮询状态的任务Id
*/
TaskId?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 数字加签文件验签结果
*/
export interface VerifyDigitFileResult {
/**
* 证书起始时间的Unix时间戳,单位毫秒
*/
CertNotBefore?: number;
/**
* 证书过期时间的时间戳,单位毫秒
*/
CertNotAfter?: number;
/**
* 证书序列号,在数字证书申请过程中,系统会自动生成一个独一无二的序号。
*/
CertSn?: string;
/**
* 证书签名算法, 如SHA1withRSA等算法
*/
SignAlgorithm?: string;
/**
* 签署时间的Unix时间戳,单位毫秒
*/
SignTime?: number;
/**
* 签名类型。0表示带签章的数字签名,1表示仅数字签名
*/
SignType?: number;
/**
* 申请证书的主体的名字
如果是在腾讯电子签平台签署, 则对应的主体的名字个数如下
**企业**: ESS@企业名称@编码
**个人**: ESS@个人姓名@证件号@808854
如果在其他平台签署的, 主体的名字参考其他平台的说明
*/
SignerName?: string;
}
/**
* CreatePrepareFlow请求参数结构体
*/
export interface CreatePrepareFlowRequest {
/**
* 执行本接口操作的员工信息。使用此接口时,必须填写userId。
支持填入集团子公司经办人 userId 代发合同。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 资源id,与ResourceType相对应,取值范围:
- 文件Id(通过UploadFiles获取文件资源Id)
- 模板Id(通过控制台创建模板后获取模板Id)
- 草稿Id(通过嵌入页面保存草稿后获取草稿Id)
注意:需要同时设置 ResourceType 参数指定资源类型
*/
ResourceId: string;
/**
* 自定义的合同流程的名称,长度不能超过200个字符,只能由中文汉字、中文标点、英文字母、阿拉伯数字、空格、小括号、中括号、中划线、下划线以及(,)、(;)、(.)、(&)、(+)组成。
该名称还将用于合同签署完成后文件下载的默认文件名称。
*/
FlowName: string;
/**
* 资源类型,取值有:
- **1**:模板
- **2**:文件(默认值)
- **3**:草稿
*/
ResourceType?: number;
/**
* 合同流程的签署顺序类型:
- **false**:(默认)有序签署, 本合同多个参与人需要依次签署
- **true**:无序签署, 本合同多个参与人没有先后签署限制
*/
Unordered?: boolean;
/**
* 合同流程的签署截止时间,格式为Unix标准时间戳(秒),如果未设置签署截止时间,则默认为合同流程创建后的365天时截止。
*/
Deadline?: number;
/**
* 用户自定义合同类型Id
该id为电子签企业内的合同类型id, 可以在控制台-合同-自定义合同类型处获取
注: `该参数如果和FlowType同时传,以该参数优先生效`
*/
UserFlowTypeId?: string;
/**
* 合同流程的类别分类(可自定义名称,如销售合同/入职合同等),最大长度为200个字符,仅限中文、字母、数字和下划线组成。
*/
FlowType?: string;
/**
* 合同流程的参与方列表,最多可支持50个参与方,可在列表中指定企业B端签署方和个人C端签署方的联系和认证方式等信息,具体定义可以参考开发者中心的ApproverInfo结构体。
如果合同流程是有序签署,Approvers列表中参与人的顺序就是默认的签署顺序,请确保列表中参与人的顺序符合实际签署顺序。
*/
Approvers?: Array;
/**
* 开启或者关闭智能添加填写区:
- **OPEN**:开启(默认值)
- **CLOSE**:关闭
*/
IntelligentStatus?: string;
/**
* 该字段已不再使用,请使用InitiatorComponents
*/
Components?: Component;
/**
* 发起合同个性化参数
用于满足创建及页面操作过程中的个性化要求
具体定制化内容详见数据接口说明
*/
FlowOption?: CreateFlowOption;
/**
* 发起方企业签署员工,在进行签署操作前,是否需要先通过企业内部审批流程 (签署审核)
1. **false(默认)**: 无需审批,发起方企业签署员工可直接进行签署操作。
2. **true**: 需要先走企业内部审批流程。 当流程进展到发起方企业签署员工时,其签署操作会被阻塞,等待企业内部审批结果。
企业应通过 提交签署流程审批结果审批接口,将内部审批结果通知腾讯电子签平台:
1. 若通知为“审核通过”,发起方企业签署员工可继续完成签署操作。
2. 若通知为“审核未通过”,平台将继续阻塞该签署方的签署操作,直到企业再次通知平台审核通过为止。
说明: 此能力可用于与企业内部审批流程打通,适用于手动签署和自动签署两种模式。
*/
NeedSignReview?: boolean;
/**
* 发起方在创建合同流程前,是否必须先通过企业内部审批流程 (发起审核)
当设置为 `true` 时:
1. 您需要在企业内部完成审批,并通过接口 提交签署流程审批结果 将审批结果回传给腾讯电子签。
2. 只有当审核状态为“通过”时,合同流程正常发起。
3. 若未通过或未回传审核结果,发起操作将被阻塞,阻止合同流程。
当设置为 `false` (默认值)时:
发起方无需经过企业内部审批,可直接发起合同流程。
*/
NeedCreateReview?: boolean;
/**
* 调用方自定义的个性化字段(可自定义此名称),并以base64方式编码,支持的最大数据大小为 20480长度。
在合同状态变更的回调信息等场景中,该字段的信息将原封不动地透传给贵方。回调的相关说明可参考开发者中心的回调通知模块。
*/
UserData?: string;
/**
* 合同流程的抄送人列表,最多可支持50个抄送人,抄送人可查看合同内容及签署进度,但无需参与合同签署。
*/
CcInfos?: Array;
/**
* 合同Id:用于通过一个已发起的合同快速生成一个发起流程web链接
注: `该参数必须是一个待发起审核的合同id,并且还未审核通过`
*/
FlowId?: string;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 模板或者合同中的填写控件列表,列表中可支持下列多种填写控件,控件的详细定义参考开发者中心的Component结构体
*/
InitiatorComponents?: Array;
/**
* 在短信通知、填写、签署流程中,若标题、按钮、合同详情等地方存在“合同”字样时,可根据此配置指定文案,可选文案如下: - 0 :合同(默认值)
- 1 :文件
- 2 :协议
- 3 :文书
效果如下:
*/
FlowDisplayType?: number;
/**
* 此字段已不再使用,请使用 CreateFlowOption 里面的 SignComponentConfig
签署控件的配置信息,用在嵌入式发起的页面配置,
包括
- 签署控件 是否默认展示日期.
* @deprecated
*/
SignComponentConfig?: SignComponentConfig;
/**
* 是否开启嵌入式合同发起时,提交发起审批流,默认:false(不开启),开启后,嵌入式合同发起后,会提交电子签内置审批流
*/
Workflow?: boolean;
}
/**
* DescribeCancelFlowsTask请求参数结构体
*/
export interface DescribeCancelFlowsTaskRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。
*/
Operator: UserInfo;
/**
* 批量撤销任务编号,为32位字符串,通过接口[获取批量撤销签署流程腾讯电子签小程序链接](https://qian.tencent.com/developers/companyApis/operateFlows/CreateBatchCancelFlowUrl)获得。
*/
TaskId: string;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
}
/**
* DescribeContractReviewMarkedRiskExportTask返回参数结构体
*/
export interface DescribeContractReviewMarkedRiskExportTaskResponse {
/**
* 导出文件 url。
*/
Url?: string;
/**
* 任务状态。未知 = 0; 创建完成 = 1; 队列中 = 2; 执行中 = 3; 执行成功 = 4; 失败 = 5; 终止 = 6;
*/
Status?: number;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateSealPolicy请求参数结构体
*/
export interface CreateSealPolicyRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 用户在电子文件签署平台标识信息,具体参考UserInfo结构体。可跟下面的UserIds可叠加起作用
*/
Users: Array;
/**
* 电子印章ID,为32位字符串。
建议开发者保留此印章ID,后续指定签署区印章或者操作印章需此印章ID。
可登录腾讯电子签控制台,在 "印章"->"印章中心"选择查看的印章,在"印章详情" 中查看某个印章的SealId(在页面中展示为印章ID)。
*/
SealId: string;
/**
* 授权有效期,时间戳秒级。可以传0,代表有效期到2099年12月12日23点59分59秒。
*/
Expired: number;
/**
* 需要授权的用户UserId集合。跟上面的SealId参数配合使用。选填,跟上面的Users同时起作用
*/
UserIds?: Array;
/**
* 印章授权内容
*/
Policy?: string;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 个性化配置字段,默认不传。
*/
Options?: Array