/**
* SyncProxyOrganization返回参数结构体
*/
export interface SyncProxyOrganizationResponse {
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 批量签署合同相关信息,指定批量签署合同和签署方的信息,用于补充动态签署人。
*/
export interface FlowBatchUrlInfo {
/**
* 批量签署合同和签署方的信息,用于补充动态签署人。
*/
FlowBatchApproverInfos?: Array 批量生成企业认证链接的详细错误信息,顺序与输入参数子企业列表顺序一致。 控件唯一ID。 在绝对定位方式方式下,ComponentId为控件的ID,长度不能超过30,只能由中文、字母、数字和下划线组成,可以在后续的操作中使用该名称来引用控件。 在关键字定位方式下,ComponentId不仅为控件的ID,也是关键字整词。此方式下可以通过"^"来决定是否使用关键字整词匹配能力。 例: 注: 如果是Component填写控件类型,则可选的字段为: 如果是SignComponent签署控件类型, 注: 在绝对定位方式方式下,ComponentName为控件名,长度不能超过20,只能由中文、字母、数字和下划线组成,可以在后续的操作中使用该名称来引用控件。 在表单域定位方式下,ComponentName不仅为控件名,也是表单域名称。 注: 如果是填写控件,ComponentRequired表示在填写页面此控件是否必填 在通过接口拉取控件信息场景下,为出参参数,此控件归属的参与方的角色ID角色(即RecipientId),发起合同时候不要填写此字段留空即可 【暂未使用】控件所属文件的序号(取值为:0-N)。 目前单文件的情况下,值一直为0 控件生成的方式: 在绝对定位方式和关键字定位方式下,指定控件宽度,控件宽度是指控件在PDF文件中的宽度,单位为pt(点)。 在绝对定位方式和关键字定位方式下,指定控件的高度, 控件高度是指控件在PDF文件中的高度,单位为pt(点)。 在绝对定位方式方式下,指定控件所在PDF文件上的页码 注: 在绝对定位方式下,可以指定控件横向位置的位置,单位为pt(点)。 在绝对定位方式下,可以指定控件纵向位置的位置,单位为pt(点)。 在所有的定位方式下,控件的扩展参数,为JSON格式,不同类型的控件会有部分非通用参数。 ComponentType为TEXT、MULTI_LINE_TEXT时,支持以下参数: ComponentType为DATE时,支持以下参数: ComponentType为WATERMARK时,支持以下参数: ComponentType为FILL_IMAGE时,支持以下参数: ComponentType为SELECTOR时,支持以下参数: ComponentType为SIGN_SIGNATURE、SIGN_PAGING_SIGNATURE类型时,可以ComponentTypeLimit参数控制签署方式 ComponentType为SIGN_DATE时,支持以下参数: ComponentType为SIGN_SEAL、SIGN_SIGNATURE类型时,支持以下参数: 签署印章旋转功能,当ComponentType为SIGN_SIGNATURE、SIGN_DATE、SIGN_SEAL时,可以通过以下参数设置签署图片的旋转角度: 签署印章透明度功能设置,当ComponentType为SIGN_SIGNATURE、SIGN_SEAL、SIGN_PAGING_SEAL、SIGN_LEGAL_PERSON_SEAL时,可以通过以下参数设置签署印章的透明度: 签署印章大小功能设置,当ComponentType为SIGN_SEAL、SIGN_PAGING_SEAL、SIGN_LEGAL_PERSON_SEAL时,可以通过以下参数设置签署时按照实际印章的大小进行签署,如果印章没有设置大小,那么默认会是4.2cm的印章大小: 签署意见功能设置,当ComponentType为SIGN_OPINION时,可以通过以下参数设置签署意见的相关内容: 关键字模式下支持关键字找不到的情况下不进行报错的设置 ComponentType为SIGN_VIRTUAL_COMBINATION或者VIRTUAL_COMBINATION时,支持以下参数: 控件填充vaule,ComponentType和传入值类型对应关系: 控件值约束说明: 【暂未使用】日期签署控件的字号,默认为 12 【暂未使用】控件归属的文档的ID, 发起合同时候不要填写此字段留空即可 【暂未使用】控件描述,用户自定义,不影响合同发起流程 如果控件是关键字定位方式,可以对关键字定位出来的区域进行横坐标方向的调整,单位为pt(点)。例如,如果关键字定位出来的区域偏左或偏右,可以通过调整横坐标方向的参数来使控件位置更加准确。 如果控件是关键字定位方式,可以对关键字定位出来的区域进行纵坐标方向的调整,单位为pt(点)。例如,如果关键字定位出来的区域偏上或偏下,可以通过调整纵坐标方向的参数来使控件位置更加准确。 【暂未使用】第三方应用集成平台模板控件 ID 标识 如果控件是关键字定位方式,指定关键字排序规则时,可以选择Positive或Reverse两种排序方式。 在指定KeywordIndexes时,如果使用Positive排序方式,0代表在PDF内查找内容时,查找到的第一个关键字;如果使用Reverse排序方式,0代表在PDF内查找内容时,查找到的最后一个关键字。 如果控件是关键字定位方式,在KeywordPage中指定关键字页码时,将只会在该页码中查找关键字,非该页码的关键字将不会查询出来。如果不设置查找所有页面中的关键字。 如果控件是关键字定位方式,关键字生成的区域的对齐方式, 可以设置下面的值 如果控件是关键字定位方式,关键字索引是指在PDF文件中存在多个相同的关键字时,通过索引指定使用哪一个关键字作为最后的结果。可以通过指定多个索引来同时使用多个关键字。例如,[0,2]表示使用PDF文件内第1个和第3个关键字位置作为最后的结果。 注意:关键字索引是从0开始计数的 填写控件在腾讯电子签小程序填写界面展示的提示信息,例如,在身份证号码填写控件中,提示信息可以设置成“请输入18位身份证号码”。 web嵌入发起合同场景下, 是否锁定填写和签署控件值不允许嵌入页面进行编辑 web嵌入发起合同场景下,是否禁止移动和删除填写和签署控件 合同流程ID,为32位字符串。 签署参与人在本流程中的编号ID(每个流程不同),可用此ID来定位签署参与人在本流程的签署节点,也可用于后续创建签署链接等操作。 关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。 此接口下面信息必填。 是否允许修改签署人信息 是否可以拒签 默认false-可以拒签 true-不可以拒签 是否可以转发 默认false-可以转发 true-不可以转发 当签署方有多个签署区时候,是否隐藏一键所有的签署区 false:(默认)不隐藏 签署人阅读合同限制参数 禁止在签署过程中添加签署日期控件 在嵌入式文件发起下,若合同是通过文件,当签署人控件指定了印章类型(或印章Id),在嵌入页面上是否能修改 批量撤销任务编号,为32位字符串。 任务状态,需要关注的状态
*/
ErrorMessages?: Array控件ID可以在一个PDF中不可重复
点击查看ComponentId在模板页面的位置
需要根据签署人的类型可选的字段为表单域的控件不能作为印章和签名控件控件名可以在一个PDF中可以重复
如果是签署控件,签批控件中签署意见等可以不填写, 其他签署控件不受此字段影响
*/
ComponentRequired?: boolean;
/**
*
*/
GenerateMode?: string;
/**
*
在使用文件发起的情况下,绝对定位方式的填写控件和签署控件支持使用负数来指定控件在PDF文件上的页码,使用负数时,页码从最后一页开始。例如:ComponentPage设置为-1,即代表在PDF文件的最后一页,以此类推。
*/
ComponentPage?: number;
/**
*
参数样例:{"FontColor":"255,0,0","FontSize":12,"Bold":false}
参数样例:{"FontColor":"255,0,0","FontSize":12}
参数样例:"{\"Font\":\"黑体\",\"FontSize\":20,\"Opacity\":0.1,\"Density\":2,\"SubType\":\"PERSON_INFO_WATERMARK\"}"
参考样例:{"ComponentTypeLimit": ["SYSTEM_ESIGN"]}印章的对应关系参考下图
ComponentType为SIGN_SEAL 或者 SIGN_PAGING_SEAL类型时,可以通过**ComponentTypeLimit**参数控制签署方签署时要使用的印章类型,支持指定以下印章类型
参考样例:{\"ComponentTypeLimit\":[\"PERSONNEL\",\"FINANCE\"]} 表示改印章签署区,客户需使用人事专用章或财务专用章盖章签署。
如果extra参数为空,默认为”yyyy年m月d日”格式的居中日期特别地,如果extra中Format字段为空或无法被识别,则extra参数会被当作默认值处理(Font,FontSize,Gaps和FontAlign都不会起效)参数样例: "{"Format":"yyyy m d","FontSize":12,"Gaps":"2,2", "FontAlign":"Right"}"
参数样例:"{"PageRanges":[{"BeginPage":1,"EndPage":-1}]}"
参数样例:{"Rotate":-30,"RotateRelation":"Component_Id1"}
参数样例:{"Opacity":0.7}
参数样例:{"UseSealSize":true}
参数样例:{"Values":"我已知晓内容并同意签署","ValuesArray":["我","已知晓","内容","并","同意","签署"]}
场景说明:如果使用关键字进行定位,但是指定的PDF文件中又没有设置的关键字时,发起合同会进行关键字是否存在的校验,如果关键字不存在,会进行报错返回。如果不希望进行报错,可以设置"IgnoreKeywordError"来忽略错误。请注意,如果关键字签署控件对应的签署方在整个PDF文件中一个签署控件都没有,还是会触发报错逻辑。参数样例:"{"IgnoreKeywordError":1}"{"Children":["ComponentId_29","ComponentId_27","ComponentId_28","ComponentId_30"]}
参数样例: 字段名称 类型 描述 ComponentType string 子控件类型-可选值:SIGN_SIGNATURE,SIGN_DATE,SIGN_SELECTOR,SIGN_MULTI_LINE_TEXT ComponentName string 子控件名称 Placeholder string 子控件提示语 ComponentValue string 子控件值(签署方不可设置) ComponentOffsetX float 控件偏移位置X(相对于父控件(签批控件的ComponentX)) ComponentOffsetY float 控件偏移位置Y 相对于父控件(签批控件的ComponentY)) ComponentWidth float 控件宽 ComponentHeight float 控件高 ComponentExtra string 控件的附属信息,根据ComponentType设置 { "ChildrenComponents": [ { "ComponentType": "SIGN_SIGNATURE", "ComponentName": "个人签名", "Placeholder": "请签名", "ComponentOffsetX": 10, "ComponentOffsetY": 30, "ComponentWidth": 119, "ComponentHeight": 43, "ComponentExtra": "{\"ComponentTypeLimit\":[\"SYSTEM_ESIGN\"]}" }, { "ComponentType": "SIGN_SELECTOR", "ComponentName": "是否同意此协议", "Placeholder": "", "ComponentOffsetX": 50, "ComponentOffsetY": 130, "ComponentWidth": 120, "ComponentHeight": 43, "ComponentExtra": "{\"Values\":[\"同意\",\"不同意\",\"再想想\"],\"FontSize\":12,\"FontAlign\":\"Left\",\"Font\":\"黑体\",\"MultiSelect\":false}" }, { "ComponentType": "SIGN_MULTI_LINE_TEXT", "ComponentName": "批注附言", "Placeholder": "", "ComponentOffsetX": 150, "ComponentOffsetY": 300, "ComponentWidth": 200, "ComponentHeight": 86, "ComponentExtra": "" } ]}
*/
ComponentExtra?: string;
/**
*
注: 特殊控件 填写约束 企业全称控件 企业名称中文字符中文括号 统一社会信用代码控件 企业注册的统一社会信用代码 法人名称控件 最大50个字符,2到25个汉字或者1到50个字母 签署意见控件 签署意见最大长度为50字符 签署人手机号控件 国内手机号 13,14,15,16,17,18,19号段长度11位 签署人身份证控件 合法的身份证号码检查 控件名称 控件名称最大长度为20字符,不支持表情 单行文本控件 只允许输入中文,英文,数字,中英文标点符号,不支持表情 多行文本控件 只允许输入中文,英文,数字,中英文标点符号,不支持表情 勾选框控件 选择填字符串true,不选填字符串false 选择器控件 同单行文本控件约束,填写选择值中的字符串 数字控件 请输入有效的数字(可带小数点) 日期控件 格式:yyyy年mm月dd日 附件控件 JPG或PNG图片,上传数量限制,1到6个,最大6个附件,填写上传的资源ID 图片控件 JPG或PNG图片,填写上传的图片资源ID 邮箱控件 有效的邮箱地址, w3c标准 地址控件 只允许输入中文,英文,数字,中英文标点符号,不支持表情 省市区控件 只允许输入中文,英文,数字,中英文标点符号,不支持表情 性别控件 选择值中的字符串 学历控件 选择值中的字符串 水印控件 水印控件设置为CUSTOM_WATERMARK类型时的水印内容 部分特殊控件需要在控制台配置模板形式创建
*/
ComponentValue?: string;
/**
*
注意: 向左调整设置为负数, 向右调整设置成正数
注意: 向上调整设置为负数, 向下调整设置成正数
示例:如果设置Middle的关键字盖章,则印章的中心会和关键字的中心重合,如果设置Below,则印章在关键字的正下方
*/
RelativeLocation?: string;
/**
*
注:签署控件设置此字段无效
*/
LockComponentValue?: boolean;
/**
*
*/
ForbidMoveAndDelete?: boolean;
}
/**
* DescribeUserFlowType返回参数结构体
*/
export interface DescribeUserFlowTypeResponse {
/**
* 查询到的所有用户合同类型列表
*/
AllUserFlowTypes?: Array
注:
`1.链接仅单次有效,每次登录需要需要重新创建新的链接`
`2.创建的链接应避免被转义,如:&被转义为\u0026;如使用Postman请求后,请选择响应类型为 JSON,否则链接将被转义`
*/
AuthUrl?: string;
/**
* 企业批量注册的错误信息,例如:企业三要素不通过
*/
ErrorMessage?: string;
/**
* 企业批量注册 传递过来的企业名称,方便客户定位企业
*/
OrganizationName?: string;
/**
* 企业批量注册的唯一 Id, 此 Id 可以用在[创建企业批量认证链接-单链接](https://qian.tencent.com/developers/partnerApis/accounts/CreateBatchOrganizationRegistrationTasks)。
*/
SubTaskId?: string;
}
/**
* 合同组相关信息,指定合同组子合同和签署方的信息,用于补充动态签署人。
*/
export interface FlowGroupUrlInfo {
/**
* 合同组子合同和签署方的信息,用于补充动态签署人。
*/
FlowGroupApproverInfos?: Array 子客企业状态 子客企业员工状态 Endpoint 链接有效期限 企业未激活 员工未认证 PC 5分钟 企业未激活 员工未认证 CHANNEL/SHORT_URL/APP 一年 企业已激活 员工未认证 PC 5分钟 企业已激活 员工未认证 CHANNEL/SHORT_URL/APP 一年 企业已激活 员工已认证 PC 5分钟 企业已激活 员工已认证 CHANNEL/SHORT_URL/APP 一年
建议开发者妥善保存此流程ID,以便于顺利进行后续操作。
可登录腾讯电子签控制台,在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
第三方平台子客企业和员工必须已经经过实名认证
*/
Agent: Agent;
}
/**
* ChannelDisableUserAutoSign返回参数结构体
*/
export interface ChannelDisableUserAutoSignResponse {
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DescribeExtendedServiceAuthDetail返回参数结构体
*/
export interface DescribeExtendedServiceAuthDetailResponse {
/**
* 服务授权的信息列表,根据查询类型返回特定扩展服务的开通和授权状况。
*/
AuthInfoDetail?: AuthInfoDetail;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 第三方应用集成员工部门信息
*/
export interface Department {
/**
* 部门id
*/
DepartmentId?: string;
/**
* 部门名称
*/
DepartmentName?: string;
}
/**
* CreateLegalSealQrCode返回参数结构体
*/
export interface CreateLegalSealQrCodeResponse {
/**
* 二维码图片base64值,二维码有效期7天(604800秒)
二维码图片的样式如下图:

*/
QrcodeBase64?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 签署人配置信息。
此参数对子客和自动签无效,不允许进行修改。
*/
export interface CommonApproverOption {
/**
*
true:隐藏,每个签署区要单独选择印章或者签名
取值:
*/
FlowReadLimit?: string;
/**
*
前置条件:文件发起合同时,指定SignBeanTag=1(可以在签署过程中添加签署控件):
*/
ForbidAddSignDate?: boolean;
/**
*
批量撤销成功的签署流程编号
*/ SuccessFlowIds?: Array批量撤销失败的签署流程信息
*/ FailureFlows?: Array合同对应参与方需要修改的目标经办人对应的OpenId。
注意:需要保证目标经办人已经加入企业且已实名
企业签署方的合同及对应签署方
*/ FlowForwardInfos: Array关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。此接口下面信息必填。
关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
此接口下面信息必填。
需要进行转换的资源文件类型
支持的文件类型如下:
枚举值:
需要进行转换操作的文件资源名称,带资源后缀名。
注: 资源名称长度限制为256个字符
需要进行转换操作的文件资源Id,通过UploadFiles接口获取文件资源Id。
注: 目前,此接口仅支持单个文件进行转换。
签署人签署链接信息
*/ FlowApproverUrlInfos?: Array任务Id
*/ TaskId?: string; /** *任务状态,需要关注的状态
枚举值:
状态描述,需要关注的状态
资源Id(即FileId),用于用PDF文件创建签署流程
*/ ResourceId?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ChannelCreateBatchSignUrl返回参数结构体 */ export interface ChannelCreateBatchSignUrlResponse { /** *批量签署链接,以短链形式返回,短链的有效期参考回参中的 ExpiredTime。
注:
链接过期时间以 Unix 时间戳格式表示,从生成链接时间起,往后7天有效期。过期后短链将失效,无法打开。
*/ ExpiredTime?: number; /** *从客户小程序或者客户APP跳转至腾讯电子签小程序进行批量签署的跳转路径
注:
关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
此接口下面信息必填。
组织机构要变更的超管姓名。 在超管变更流程中,必须是超管本人进行操作,需要更当前操作人的姓名保持一致。
*/ NewAdminName?: string; /** *组织机构要变更的超管手机号。 在超管变更流程中,必须是超管本人进行操作,需要更当前操作人的手机号保持一致。 超管手机号 和超管证件号 二选一 必填。 注意: 1. 如果新超管的个人身份在电子签进行了手机号的变更,之前提交的超管变更任务将无法获取。
*/ NewAdminMobile?: string; /** *组织机构要变更的超管证件类型支持以下类型
枚举值:
默认值:ID_CARD
*/ NewAdminIdCardType?: string; /** *组织机构要变更的超管证件号。 在超管变更流程中,必须是超管本人进行操作,需要更当前操作人的证件号保持一致。 超管手机号和超管证件号 二选一必填。
*/ NewAdminIdCardNumber?: string; /** *要跳转的链接类型
枚举值:
默认值:HTTP
*/ Endpoint?: string; } /** * ChannelCreatePrepareFlow返回参数结构体 */ export interface ChannelCreatePrepareFlowResponse { /** * 发起的合同嵌入链接, 可以直接点击进入进行合同发起, 有效期为5分钟 */ PrepareFlowUrl?: string; /** * 合同发起后预览链接, 注意此时合同并未发起,仅只是展示效果, 有效期为5分钟 */ PreviewFlowUrl?: string; /** * 发起的合同临时Id, 只有当点击进入链接,成功发起合同后, 此Id才有效 */ FlowId?: string; /** * 临时的草稿id(还未实际保存草稿),用户可以记录此字段对应后续页面保存的草稿,若在页面上未保存草稿,则此字段无效。 */ DraftId?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * CreateBatchInitOrganizationUrl返回参数结构体 */ export interface CreateBatchInitOrganizationUrlResponse { /** * 小程序路径,有效时间为7天 */ MiniAppPath?: string; /** * 操作长链,有效时间为7天 */ OperateLongUrl?: string; /** * 操作短链,有效时间为7天 */ OperateShortUrl?: string; /** * 操作二维码,有效时间为7天 */ QRCodeUrl?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 视频认证结果 */ export interface DetectInfoVideoData { /** * 活体视频的base64编码,mp4格式 注:`需进行base64解码获取活体视频文件` */ LiveNessVideo?: string; } /** * OperateChannelTemplate返回参数结构体 */ export interface OperateChannelTemplateResponse { /** * 第三方应用平台的应用ID */ AppId?: string; /** * 合同模板ID */ TemplateId?: string; /** * 描述模板可见性更改的结果。签署文件资源Id列表,目前仅支持单个文件
*/ FileIds: Array签署流程名称,长度不超过200个字符
*/ FlowName: string; /** *签署流程签约方列表,最多不超过5个参与方
*/ FlowApprovers: Array签署流程截止时间,十位数时间戳,最大值为33162419560,即3020年
*/ Deadline?: number; /** *签署流程的描述,长度不超过1000个字符
*/ FlowDescription?: string; /** *签署流程的类型,长度不超过255个字符
枚举值:
已废弃,请使用【应用号配置】中的回调地址统一接收消息
* @deprecated */ CallbackUrl?: string; /** *第三方应用的业务信息,最大长度1000个字符。
*/ CustomerData?: string; /** *合同签署顺序类型(无序签,顺序签),默认为false,即有序签署
*/ Unordered?: boolean; /** *签署文件中的发起方的填写控件,需要在发起的时候进行填充
*/ Components?: Array合同显示的页卡模板,说明:只支持{合同名称}, {发起方企业}, {发起方姓名}, {签署方N企业}, {签署方N姓名},且N不能超过签署人的数量,N从1开始
*/ CustomShowMap?: string; /** *本企业(发起方企业)是否需要签署审批
*/ NeedSignReview?: boolean; /** *在短信通知、填写、签署流程中,若标题、按钮、合同详情等地方存在“合同”字样时,可根据此配置指定文案,可选文案如下:
*/
FlowDisplayType?: number;
}
/**
* 创建合同个性化参数
*/
export interface CreateFlowOption {
/**
* 是否允许修改合同信息,
true:可以
false:(默认)不可以
是否允许发起合同弹窗隐藏合同名称
true:允许
false:(默认)不允许
是否允许发起合同弹窗隐藏合同类型,
true:允许
false:(默认)不允许
是否允许发起合同弹窗隐藏合同到期时间
true:允许
false:(默认)不允许
是否允许发起合同步骤跳过指定签署方步骤
true:允许
false:(默认)不允许
是否可以编辑签署人包括新增,修改,删除
注意:
定制化发起合同弹窗的描述信息,长度不能超过500,只能由中文、字母、数字和标点组成。
*/ CustomCreateFlowDescription?: string; /** *禁止编辑填写控件
true:禁止编辑填写控件
false:(默认)允许编辑填写控件
跳过上传文件步骤
true:跳过
false:(默认)不跳过,需要传ResourceId
签署控件的配置信息,用在嵌入式发起的页面配置,包括
是否禁止编辑(展示)水印控件属性
发起成功后是否预览合同
发起成功之后是否签署合同,仅当前经办人作为签署人时生效
隐藏操作步骤: 具体的控件类型如下
本企业简称,注:仅对新版页面生效
*/ SelfName?: string; /** *发起后签署码隐藏,默认false,注:仅对新版页面生效
*/ HideSignCodeAfterStart?: boolean; /** *发起过程中是否保存草稿
*/ NeedFlowDraft?: boolean; /** *在发起流程的可嵌入页面要隐藏的控件列表,和 ShowComponentTypes 参数 只能二选一使用(注:
空数组代表未指定),具体的控件类型如下
在发起流程的可嵌入页面要显示的控件列表,和 HideComponentTypes 参数 只能二选一使用(注:
空数组代表未指定),具体的控件类型如下
禁止添加签署方,若为true则在发起流程的可嵌入页面隐藏“添加签署人按钮”
*/ ForbidAddApprover?: boolean; /** *禁止设置签署流程属性 (顺序、合同签署认证方式等),若为true则在发起流程的可嵌入页面隐藏签署流程设置面板
*/ ForbidEditFlowProperties?: boolean; /** *发起流程的可嵌入页面结果页配置
*/ ResultPageConfig?: CreateResultPageConfig; /** *若指定了合同抄送人,此参数用来控制操作人能否在嵌入式页面看见或编辑(修改、增加、删除)抄送人信息。
枚举值:
默认值:0
*/ CcInfoVisibility?: number; } /** * ChannelCreateRole请求参数结构体 */ export interface ChannelCreateRoleRequest { /** * 角色名称,最大长度为20个字符,仅限中文、字母、数字和下划线组成。 */ Name: string; /** * 关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。 此接口下面信息必填。跳转链接, 链接的有效期根据企业,员工状态和终端等有区别, 可以参考下表
| 子客企业状态 | 子客企业员工状态 | Endpoint | 链接有效期限 |
|---|---|---|---|
| 企业未激活 | 员工未认证 | PC/PC_SHORT_URL | 5分钟 |
| 企业未激活 | 员工未认证 | CHANNEL/APP/H5/SHORT_H5/WEIXIN_QRCODE_URL | 30天 |
| 企业已激活 | 员工未认证 | PC/PC_SHORT_URL | 5分钟 |
| 企业已激活 | 员工未认证 | CHANNEL/APP/H5/SHORT_H5/WEIXIN_QRCODE_URL | 30天 |
| 企业已激活 | 员工已认证 | PC | 5分钟 |
| 企业已激活 | 员工已认证 | CHANNEL/APP/H5/SHORT_H5/WEIXIN_QRCODE_URL | 30天 |
注:
子客企业是否已开通腾讯电子签,
注:企业是否实名根据传参Agent.ProxyOrganizationOpenId进行判断,非企业名称或者社会信用代码
当前经办人是否已认证并加入功能
关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
此接口下面信息必填。
合同流程ID,为32位字符串。
建议开发者妥善保存此流程ID,以便于顺利进行后续操作。
可登录腾讯电子签控制台,在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
流程签署人列表,其中结构体的ApproverType必传。
若为个人签署方或saas企业签署方,则Name,Mobile必传。OrganizationName 传对应企业名称。
若为子客企业签署方则需传OpenId、OrganizationOpenId、OrganizationName, 其他可不传。(如果对应OrganizationOpenId 子客已经认证激活了,则可以省去OrganizationName)
此结构体和发起接口参与方结构体复用,除了上述参数外,可传递的参数有:
注:
用于指定进入视频签署的限制次数,次数取值范围:1 - 10,不设置则默认为5次,仅视频签署时生效。
*/ VideoVerifyTimesLimit?: number; /** *用户信息,暂未开放
* @deprecated */ Operator?: UserInfo; /** *机构信息,暂未开放
* @deprecated */ Organization?: OrganizationInfo; /** *签署完之后的H5页面的跳转链接,最大长度1000个字符。链接类型请参考 跳转电子签H5
*/ JumpUrl?: string; /** *链接类型,支持指定以下类型
1. 当指定链接类型为1时,链接为预览链接,打开链接无法签署仅支持预览以及查看当前合同状态。2. 如需生成发起方预览链接,则签署方信息传空,即FlowApproverInfos传空或者不传。
*/
UrlType?: number;
/**
* 链接的有效时间,单位为秒。取值范围为 30分钟(1800)-90天(7776000)。如果不传,默认有效期为30分钟。
注意:
出于安全性考虑,若有效期大于30分钟,同设备24小时内点击链接查看合同需要进行手机验证码校验。此校验将会扣除短信份额,不建议通过设置此值来缓存签署链接,建议在用户需要签署的时候临时生成链接。若生成合同发起方预览链接,有效期大于30分钟,则需要进行验证码校验的手机号为发起方账号绑定的手机号。关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
此接口下面信息必填。
模板ID,为32位字符串。
*/ TemplateId: string; /** *操作类型,可取值如下:
模板名称,长度不超过64字符。
模板复制时指定有效,若为空,则复制后模板名称为 原模板名称_副本。
核身视频结果。
*/ VideoData?: DetectInfoVideoData; /** *意愿核身问答模式结果。若未使用该意愿核身功能,该字段返回值可以不处理。
*/ IntentionQuestionResult?: IntentionQuestionResult; /** *意愿核身点头确认模式的结果信息,若未使用该意愿核身功能,该字段返回值可以不处理。
注意:此字段可能返回 null,表示取不到有效值。 */ IntentionActionResult?: IntentionActionResult; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ChannelCancelUserAutoSignEnableUrl返回参数结构体 */ export interface ChannelCancelUserAutoSignEnableUrlResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 签署流程下载信息 */ export interface DownloadFlowInfo { /** * 文件夹名称 */ FileName: string; /** * 签署流程的标识数组 */ FlowIdList: Array全量撤销企业合同任务编号,为32位字符串,可用于查询批量撤销合同结果 或关联全量撤销任务结果回调
*/ TaskId?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 复杂文档合成任务的任务信息 */ export interface TaskInfo { /** * 合成任务Id,可以通过 ChannelGetTaskResultApi 接口获取任务信息 */ TaskId?: string; /** * 任务状态:READY - 任务已完成;NOTREADY - 任务未完成; */ TaskStatus?: string; } /** * 需要进行签署审核的签署人信息 */ export interface NeedReviewApproverInfo { /** * 签署方经办人的类型,支持以下类型合同的发起企业和发起人信息,点击查看合同发起企业和人展示的位置
此接口下面信息必填。
合同流程的名称(可自定义此名称),长度不能超过200,只能由中文、字母、数字和下划线组成。
*/ FlowName?: string; /** *合同流程描述信息(可自定义此描述),最大长度1000个字符。
*/ FlowDescription?: string; /** *合同流程的参与方列表, 最多可支持50个参与方,可在列表中指定企业B端签署方和个人C端签署方的联系和认证方式等信息,不同类型的签署方传参方式可以参考文档 签署方入参指引。
如果合同流程是有序签署,Approvers列表中参与人的顺序就是默认的签署顺序, 请确保列表中参与人的顺序符合实际签署顺序。
*/ FlowApprovers?: Array本合同流程需包含的PDF文件资源编号列表,通过UploadFiles接口获取PDF文件资源编号。
注: 目前,此接口仅支持单个文件发起。
模板或者合同中的填写控件列表,列表中可支持下列多种填写控件,控件的详细定义参考开发者中心的Component结构体

合同流程的签署截止时间,格式为Unix标准时间戳(秒),如果未设置签署截止时间,则默认为合同流程创建后的365天时截止。
如果在签署截止时间前未完成签署,则合同状态会变为已过期,导致合同作废。
该字段已废弃,请使用【应用号配置】中的回调地址
* @deprecated */ CallbackUrl?: string; /** *合同流程的签署顺序类型:
有序签署时以传入FlowApprovers数组的顺序作为签署顺序
*/
Unordered?: boolean;
/**
* 合同流程的类别分类(可自定义名称,如销售合同/入职合同等),最大长度为255个字符,仅限中文、字母、数字和下划线组成。
*/ FlowType?: string; /** *您可以自定义腾讯电子签小程序合同列表页展示的合同内容模板,模板中支持以下变量:
例如,如果是腾讯公司张三发给李四名称为“租房合同”的合同,您可以将此字段设置为:合同名称:{合同名称};发起方: {发起方企业}({发起方姓名});签署方:{签署方1姓名},则小程序中列表页展示此合同为以下样子
合同名称:租房合同
发起方:腾讯公司(张三)
签署方:李四
调用方自定义的个性化字段(可自定义此名称),并以base64方式编码,支持的最大数据大小为 1000长度。
在合同状态变更的回调信息等场景中,该字段的信息将原封不动地透传给贵方。回调的相关说明可参考开发者中心的回调通知模块。
*/ CustomerData?: string; /** *发起方企业的签署人进行签署操作前,是否需要企业内部走审批流程,取值如下:
此功能可用于与企业内部的审批流程进行关联,支持手动、静默签署合同
*/
NeedSignReview?: boolean;
/**
* 签署人校验方式
VerifyCheck: 人脸识别(默认)
MobileCheck:手机号验证,用户手机号和参与方手机号(ApproverMobile)相同即可查看合同内容(当手写签名方式为OCR_ESIGN时,该校验方式无效,因为这种签名方式依赖实名认证)
参数说明:可选人脸识别或手机号验证两种方式,若选择后者,未实名个人签署方在签署合同时,无需经过实名认证和意愿确认两次人脸识别,该能力仅适用于个人签署方。
签署方签署控件(印章/签名等)的生成方式:
注:
1.发起后添加控件功能不支持添加签批控件
2.签署方在签署时自行添加签署控件仅支持电子签小程序或web控制台签署,不支持H5
合同流程的抄送人列表,最多可支持50个抄送人,抄送人可查看合同内容及签署进度,但无需参与合同签署。
注
可以设置以下时间节点来给抄送人发送短信通知来查看合同内容:
个人自动签名的使用场景包括以下, 个人自动签署(即ApproverType设置成个人自动签署时)业务此值必传:
个人自动签名场景是白名单功能,使用前请与对接的客户经理联系沟通。
*/
AutoSignScene?: string;
/**
* 操作者的信息,不用传
* @deprecated */ Operator?: UserInfo; /** *在短信通知、填写、签署流程中,若标题、按钮、合同详情等地方存在“合同”字样时,可根据此配置指定文案,可选文案如下:
*/
FlowDisplayType?: number;
/**
* 是否为预览模式,取值如下:
注: 预览服务按照合同份额 1:2的比例赠送预览次数。例如:购买 100 份合同,将赠送 200 次合同预览额度。当赠送的预览额度使用完后,如需继续使用预览服务,则需要单独购买预览服务额度。
*/ NeedPreview?: boolean; /** *预览模式下产生的预览链接类型
此参数在NeedPreview 为true时有效
*/
PreviewType?: number;
/**
* 是否开启动态合同(动态签署人2.0)
是否开启动态合同(动态签署人2.0)
发起合同流程时对合同流程的部分操作加以限制的配置。
*/ FlowOperateLimit?: FlowOperateLimit; } /** * UploadFiles返回参数结构体 */ export interface UploadFilesResponse { /** *上传成功文件数量
注: 如果一个文件上传失败, 则全部文件皆上传失败
文件资源ID数组,每个文件资源ID为32位字符串。
建议开发者保存此资源ID,后续创建合同或创建合同流程需此资源ID。
注:有效期一个小时(超过一小时后系统不定期清理,会有部分时间差), 有效期内此文件id可以反复使用, 超过有效期无法使用
对应上传文件的下载链接,过期时间5分钟
*/ FileUrls?: Array文件的截止有效期,如果超过截止有效期则文件Id会失效,无法再进行使用
默认过期时间是上传时间加10分钟
*/ Deadline?: number; /** * 唯一请求 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电子印章ID,为32位字符串。
建议开发者保留此印章ID,后续指定签署区印章或者操作印章需此印章ID。
可登录腾讯电子签控制台,在 "印章"->"印章中心"选择查看的印章,在"印章详情" 中查看某个印章的SealId(在页面中展示为印章ID)。
转换任务Id,通过接口创建文件转换任务接口得到的转换任务id
*/ TaskId: string; /** *关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
此接口下面信息必填。
业务状态码。
0 表示正常(无阻断);非 0 表示存在阻断,例如企业名称变更且存在未完结合同时返回 1。
枚举值:
提示文案。
例如企业名称变更且存在未完结合同时返回「存在 X 份未完结的合同,请先撤销或者完成合同」。
未完结合同总数。
仅当企业名称变更且存在未完结合同时有值。
SaaS 企业下未完结合同的 flowId 列表。注:SaaS企业下的合同ID可能无法查询,可通知子客企业去处理相应的合同
渠道子客企业下未完结合同的 flowId 列表。注:子客企业在其他渠道下的合同ID可能无法查询,可通知子客企业去处理其他渠道下相应的合同
| 任务状态名称 | 任务状态详情 |
|---|---|
| Processing | 企业认证任务处理中,用户调用了CreateBatchOrganizationRegistrationTasks接口,但是任务还在处理中的状态 |
| Create | 创建企业认证链接任务完成,可以调用生成任务链接接口 |
| Submit | 企业认证任务已提交,到如下界面之后,会变为这个状态  |
| Authorization | 企业认证任务认证成功,点击下图下一步,进入到授权书上传或者法人认证,则会变为这个状态  |
| Failed | 企业认证任务失败 |
签署流程编号,为32位字符串
*/ FlowId?: string; /** *撤销失败原因
*/ Reason?: string; /** *合同流程名称
*/ FlowName?: string; } /** * ChannelDescribeRoles请求参数结构体 */ export interface ChannelDescribeRolesRequest { /** * 关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。 此接口下面信息必填。加密算法使用的初始化向量。固定为 16 字节,将 IV 原始字节使用标准 Base64 编码后传入。
*/ IV?: string; /** *使用 AES-CBC 或 SM4-CBC 加密返回内容得到的密文。加密前返回内容采用 PKCS#7 Padding;将密文原始字节使用标准 Base64 编码后传入。
*/ EncryptedData?: string; /** *用于校验请求数据完整性。对 IV 原始字节和密文原始字节直接拼接(不加拼接符)后计算 HMAC-SHA256,再将计算结果使用标准 Base64 编码后传入。
*/ EncryptionSignature?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 流程签署二维码的签署信息,适用于客户系统整合二维码功能。 通过链接,用户可直接访问电子签名小程序并签署合同。 */ export interface SignUrl { /** * 跳转至电子签名小程序签署的链接地址。 适用于客户端APP及小程序直接唤起电子签名小程序。 */ AppSignUrl?: string; /** * 签署链接有效时间,格式类似"2022-08-05 15:55:01" */ EffectiveTime?: string; /** * 跳转至电子签名小程序签署的链接地址,格式类似于https://essurl.cn/xxx。 打开此链接将会展示H5中间页面,随后唤起电子签名小程序以进行合同签署。 */ HttpSignUrl?: string; } /** * 此结构体 (TemplateInfo) 用于描述模板的信息。 > **模板组成** > > 一个模板通常会包含以下结构信息 >- 模板基本信息 >- 签署参与方 Recipients,在模板发起合同时用于指定参与方 >- 填写控件 Components >- 签署控件 SignComponents */ export interface TemplateInfo { /** * 模板ID,模板的唯一标识 */ TemplateId?: string; /** * 模板名 */ TemplateName?: string; /** * 模板描述信息 */ Description?: string; /** * 模板的填充控件列表 [点击查看在模板中配置的填充控件的样子](https://qcloudimg.tencent-cloud.cn/raw/cb2f58529fca8d909258f9d45a56f7f4.png) */ Components?: Array关于渠道应用的相关信息,包括子客企业及应用编、号等详细内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
*/ Agent: Agent; /** *请指定需执行批量签署的流程ID,数量范围为1-100。 您可登录腾讯电子签控制台,浏览 "合同"->"合同中心" 以查阅某一合同的FlowId(在页面中显示为合同ID)。 用户将利用链接对这些合同实施批量操作。
*/ FlowIds?: Array第三方应用平台的用户openid。 您可登录腾讯电子签控制台,在 "更多能力"->"组织管理" 中查阅某位员工的OpenId。 OpenId必须是传入合同(FlowId)中的签署人。
签署方经办人的姓名。
经办人的姓名将用于身份认证和电子签名,请确保填写的姓名为签署方的真实姓名,而非昵称等代名。
注:请确保和合同中填入的一致
员工手机号,必须与姓名一起使用。 如果OpenId为空,则此字段不能为空。同时,姓名和手机号码必须与传入合同(FlowId)中的签署人信息一致。
*/ Mobile?: string; /** *合同组Id,传入此参数则可以不传FlowIds
*/ FlowGroupId?: string; /** *是否允许此链接中签署方批量拒签。
动态签署方领取链接配置。
*/ DynamicSignOption?: DynamicSignOption; /** *为签署方经办人在签署合同中的参与方ID,必须与参数FlowIds数组一一对应。 注:生成动态签署方领取时此参数必传。
*/ RecipientIds?: Array合同参与方的角色ID
*/ RecipientId?: string; /** *参与者类型, 可以选择的类型如下:
合同参与方的角色描述,长度不能超过100,只能由中文、字母、数字和下划线组成。
*/ Description?: string; /** *合同参与方的角色名字,长度不能超过20,只能由中文、字母、数字和下划线组成。
*/ RoleName?: string; /** *是否需要校验,
true-是,
false-否
是否必须填写,
true-是,
false-否
内部字段,签署类型
枚举值:
签署顺序:数字越小优先级越高
*/ RoutingOrder?: number; /** *是否是发起方,
true-是
false-否
签署人查看合同校验方式, 支持的类型如下:
签署人进行合同签署时的认证方式,支持的类型如下:
签署方是否可以转他人处理
模板详情列表数据
*/ Templates?: Array查询到的模板总数
*/ TotalCount?: number; /** *每页返回的数据条数
*/ Limit?: number; /** *偏移量:从 0 开始,最大20000。
*/ Offset?: number; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 自动签开启、签署相关配置 */ export interface AutoSignConfig { /** *自动签开通个人用户信息, 包括名字,身份证等
*/ UserInfo: UserThreeFactor; /** *是否回调证书信息:
注:该字段已经失效,请勿设置此参数。
是否支持用户自定义签名印章:
回调中是否需要自动签将要使用的印章(签名)图片的 base64:
该字段已废弃,请使用【应用号配置】中的回调地址统一接口消息
* @deprecated */ CallbackUrl?: string; /** *开通时候的身份验证方式, 取值为:
设置用户开通自动签时是否绑定个人自动签账号许可。
注:该字段已经失效,请勿设置此参数。
开通成功后前端页面跳转的url,此字段的用法场景请联系客户经理确认。
注:仅支持H5开通场景, 跳转链接仅支持 https:// , qianapp:// 开头
跳转场景:
APP实现方,需要拦截Webview地址跳转,发现url是qianapp:// 开头时跳转到原生页面。APP拦截地址跳转可参考:返回应用JumpUrl格式 成功结果返回:
若贵方需要在跳转回时通过链接query参数提示开通成功,JumpUrl中的query应携带如下参数:appendResult=qian。这样腾讯电子签H5会在跳转回的url后面会添加query参数提示贵方签署成功,例如:qianapp://YOUR_CUSTOM_URL?action=sign&result=success&from=tencent_ess
发起合同流程时,对签署完成后是否能发起对应的解除合同加以限制:
关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
此接口下面信息必填。
合同流程ID,为32位字符串。
建议开发者妥善保存此流程ID,以便于顺利进行后续操作。
暂未开放
* @deprecated */ Operator?: UserInfo; /** *指定申请的报告类型,可选类型如下:
枚举值:
合同组中每个合同签署流程的信息,合同组中最少包含2个合同,不能超过50个合同。
*/ BaseFlowInfos: Array合同组的名称(可自定义此名称),长度不能超过200,只能由中文、字母、数字和下划线组成。
*/ FlowGroupName: string; /** *资源类型,取值有:
合同的发起企业和发起人信息,点击查看合同发起企业和人展示的位置
此接口下面信息必填。
合同的发起企业和发起人必需已经完成实名,并加入企业
*/ Agent?: Agent; /** *合同组发起参数控制,包括对合同组名称、过期时间、发起后签署以及查看等操作
*/ FlowGroupOptions?: FlowGroupOptions; /** *合同组类型,会应用到所有子合同
*/ FlowGroupType?: string; /** *合同组过期时间,会应用到所有子合同
*/ FlowGroupDeadline?: number; } /** * DescribeExtendedServiceAuthDetail请求参数结构体 */ export interface DescribeExtendedServiceAuthDetailRequest { /** * 关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。 此接口下面信息必填。组织机构名称。
请确认该名称与企业营业执照中注册的名称一致。
如果名称中包含英文括号(),请使用中文括号()代替。
组织机构企业统一社会信用代码。
请确认该企业统一社会信用代码与企业营业执照中注册的统一社会信用代码一致。
组织机构法人的姓名。
请确认该企业统一社会信用代码与企业营业执照中注册的法人姓名一致。
组织机构法人的证件类型
枚举值:
组织机构法人的证件号码
*/ LegalIdCardNumber?: string; /** *组织机构超管姓名。
*/ AdminName?: string; /** *组织机构超管手机号。
*/ AdminMobile?: string; /** *组织机构超管证件类型
枚举值:
组织机构超管证件号码
*/ AdminIdCardNumber?: string; /** *原超管姓名
*/ OldAdminName?: string; /** *原超管手机号
*/ OldAdminMobile?: string; /** *原超管证件类型
枚举值:
原超管证件号码
*/ OldAdminIdCardNumber?: string; } /** * 跳转事件的结构体,其中包括认证期间收录,授权书审核,企业认证的回跳事件。 */ export interface JumpEvent { /** *跳转事件枚举
枚举值:
为认证成功后页面进行回跳的URL,请确保回跳地址的可用性。
Endpoint如果是APP 类型,请传递"true"
如果 Endpoint 是 H5 类型,请参考文档跳转电子签H5
p.s. 如果Endpoint是 APP,传递的跳转地址无效,不会进行跳转,仅会进行回跳。
关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容
此接口下面信息必填。
1. 企业激活时, 此时的Agent.ProxyOrganizationOpenId将会是企业激活后企业的唯一标识,建议开发者保存企业ProxyOrganizationOpenId,后续各项接口调用皆需要此参数。2. 员工认证时, 此时的Agent.ProxyOperator.OpenId将会是员工认证加入企业后的唯一标识,建议开发者保存此员工的OpenId,后续各项接口调用皆需要此参数。3. 同渠道应用(Agent.AppId)下,企业唯一标识ProxyOrganizationOpenId需要保持唯一,员工唯一标识OpenId也要保持唯一 (而不是企业下唯一)。
*/
Agent: Agent;
/**
* 第三方平台子客的企业名称,请确认该企业名称与企业营业执照中注册的名称完全一致。
在测试环境联调的过程中,企业名称请统一加上“测试”二字,如:典子谦示例企业测试,否则将无法审核通过。
企业名称请使用以下名称, 以下名称可以不用走收录。
子客测试专用企业1 - 子客测试专用企业9
注:
1. 如果名称中包含英文括号(),请使用中文括号()代替。
2、该名称需要与Agent.ProxyOrganizationOpenId相匹配, 企业激活后Agent.ProxyOrganizationOpenId会跟此企业名称一一绑定; 如果您的企业已经在认证授权中或者激活完成,这里修改子客企业名字将不会生效。
子客企业统一社会信用代码,最大长度200个字符
注意:如果您的企业已经在认证授权中或者激活完成,这里修改子客企业名字将不会生效。
子客企业员工的姓名,最大长度50个字符, 员工的姓名将用于身份认证和电子签名,请确保填写的姓名为签署方的真实姓名,而非昵称等代名。
注:该姓名需要和Agent.ProxyOperator.OpenId相匹配, 当员工完成认证后该姓名会和Agent.ProxyOperator.OpenId一一绑定, 若员工已认证加入企业,这里修改经办人名字传入将不会生效
子客企业员工的手机码, 支持国内手机号11位数字(无需加+86前缀或其他字符)。注:该手机号需要和Agent.ProxyOperator.OpenId相匹配, 当员工完成认证后该手机号会和Agent.ProxyOperator.OpenId一一绑定, 若员工已认证加入企业,这里修改经办人手机号传入将不会生效
Web控制台登录后进入的功能模块, 支持的模块包括:
该参数和Module参数配合使用,用于指定模块下的资源Id,指定后链接登录将展示该资源的详情。
根据Module参数的不同所代表的含义不同(ModuleId需要和Module对应,ModuleId可以通过API或者控制台获取到)。当前支持:
| Module传值 | ModuleId传值 | 进入的目标页面 |
|---|---|---|
| SEAL | 印章ID | 查看指定印章的详情页面 |
| TEMPLATE | 合同模板ID | 指定模板的详情页面 |
| DOCUMENT | 合同ID | 指定合同的详情页面 |
是否展示左侧菜单栏
生成链接的类型:
已废弃 请使用 JumpEvents 参数,进行替换。
触发自动跳转事件,仅对EndPoint为App类型有效,可选值包括:
可选的此企业允许的授权方式, 可以设置的方式有:
子客经办人身份证
注意:如果已同步,这里非空会更新同步的经办人身份证号,暂时只支持中国大陆居民身份证类型。
已废弃 请使用 JumpEvents 参数,进行替换。
认证完成跳转链接。
注意:此功能仅在Endpoint参数设置成 H5 或 PC时才有效。
是否展示头顶导航栏
是否自动激活子客企业,有下面两种选项:
false(默认设置):不自动激活子客户。您需要通过控制台或调用激活或者续期子企业接口手动完成激活过程。
true:若持有的许可证充足,子客户企业注册完成后将自动激活,无需手动操作或访问控制台。
注:如果应用扩展服务中的自动激活子客企业为打开态, 则忽略本接口的AutoActive这个参数(若持有的许可证充足,子客户企业注册完成后将自动激活),具体位置参考下图:
营业执照正面照(支持PNG或JPG格式)需以base64格式提供,且文件大小不得超过5MB。
和BusinessLicenseId二选一即可
组织机构企业注册地址。 请确认该企业注册地址与企业营业执照中注册的地址一致。
*/ ProxyAddress?: string; /** *组织机构法人的姓名。 请确认该企业统一社会信用代码与企业营业执照中注册的法人姓名一致。
*/ ProxyLegalName?: string; /** *授权书(PNG或JPG或PDF) base64格式, 大小不超过8M 。
p.s. 如果上传授权书 ,需遵循以下条件
企业认证时个性化能力信息
*/ OrganizationAuthorizationOptions?: OrganizationAuthorizationOptions; /** *组织机构对公打款 账号,账户名跟企业名称一致。
p.s.
只有认证方式是授权书+对公打款时才生效。
无
* @deprecated */ Operator?: UserInfo; /** *跳转事件,其中包括认证期间收录,授权书审核,企业认证的回跳事件。
p.s.Endpoint如果是APP 类型,请传递JumpUrl为"true"
如果 Endpoint 是 H5 类型,请参考文档跳转电子签H5 p.s. 如果Endpoint是 APP,传递的跳转地址无效,不会进行跳转,仅会进行回跳。
企业证照类型:
枚举值:
营业执照正面照(支持PNG或JPG格式)的FileId(通过UploadFiles获取),且文件大小不得超过8MB。
和BusinessLicense二选一即可
指定签署人非第三方平台子客企业下员工还是SaaS平台企业,在ApproverType为ORGANIZATION时指定。
在指定签署方时,可选择企业B端或个人C端等不同的参与者类型,可选类型如下:
0 :企业/企业员工(企业签署方或模板发起时的企业静默签)
1 :个人/自然人
3 :企业/企业员工自动签(他方企业自动签署或文件发起时的本方企业自动签)
注:类型为3(企业/企业员工自动签)时,此接口会默认完成该签署方的签署。静默签署仅进行盖章操作,不能自动签名。
使用自动签时,请确保企业已经开通自动签功能,开通方式:控制台 -> 企业设置 -> 扩展服务 -> 企业自动签。
使用文件发起自动签时使用前请联系对接的客户经理沟通。
电子签平台给企业生成的企业id
*/ OrganizationId?: string; /** *企业OpenId,第三方应用集成非静默签子客企业签署人发起合同必传
*/ OrganizationOpenId?: string; /** *企业名称,第三方应用集成非静默签子客企业签署人必传,saas企业签署人必传
*/ OrganizationName?: string; /** *电子签平台给企业员工或者自热人生成的用户id
*/ UserId?: string; /** *第三方平台子客企业员工的唯一标识
*/ OpenId?: string; /** *签署方经办人的姓名。
经办人的姓名将用于身份认证和电子签名,请确保填写的姓名为签署方的真实姓名,而非昵称等代名。
签署人手机号,saas企业签署人,个人签署人必传
*/ ApproverMobile?: string; /** *签署方经办人的证件类型,支持以下类型
签署方经办人的证件号码,应符合以下规则
签署人Id,使用模板发起是,对应模板配置中的签署人RecipientId
注意:模板发起时该字段必填
签署前置条件:阅读时长限制,不传默认10s,最大300s,最小3s
*/ PreReadTime?: number; /** *签署前置条件:阅读全文限制
*/ IsFullText?: boolean; /** *通知签署方经办人的方式, 有以下途径:
注: 签署方为第三方子客企业时会被置为NONE, 不会发短信通知
签署人配置,用于控制签署人相关属性
*/ ApproverOption?: CommonApproverOption; /** *使用PDF文件直接发起合同时,签署人指定的签署控件;
使用模板发起合同时,指定本企业印章签署控件的印章ID:
通过ComponentId或ComponenetName指定签署控件,ComponentValue为印章ID。
指定个人签署方查看合同的校验方式,可以传值如下:
签署人签署合同时的认证方式
默认为1(人脸认证 ),2(签署密码),3(运营商三要素),5(设备指纹识别),6(设备面容识别)
注:
签署方经办人控件类型是个人印章签署控件(SIGN_SIGNATURE) 时,可选的签名方式。
枚举值:
签署方经办人在模板中配置的参与方ID,与控件绑定,是控件的归属方,ID为32位字符串。
*/ RecipientId: string; /** *指定企业经办签署人OpenId
注: 签署人OpenId未实名时,需要传入签署人姓名以及手机号码。
签署人姓名
*/ ApproverName?: string; /** *签署人手机号码
*/ ApproverMobile?: string; /** *企业名称
*/ OrganizationName?: string; /** *企业OpenId
*/ OrganizationOpenId?: string; /** *签署企业非渠道子客,默认为false,即表示同一渠道下的企业;如果为true,则目前表示接收方企业为SaaS企业, 为渠道子客时,OrganizationOpenId 必传
*/ NotChannelOrganization?: boolean; /** *签署方经办人的证件类型,支持以下类型
注:补充个人签署方时,若该用户已在电子签完成实名则可通过指定姓名和证件类型、证件号码完成补充。
*/ ApproverIdCardType?: string; /** *签署方经办人的证件号码,应符合以下规则
注:补充个人签署方时,若该用户已在电子签完成实名则可通过指定姓名和证件类型、证件号码完成补充。
合同流程ID
关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
此接口下面信息必填。
被授企业id/授权方企业id(即OrganizationId),如果是企业之间授权和AuthorizedOrganizationName二选一传入。
注:被授权企业必须和当前企业在同一应用号下
被授企业名称/授权方企业的名字,如果是企业之间授权和AuthorizedOrganizationId二选一传入即可。请确认该名称与企业营业执照中注册的名称一致。
注:
是否给平台应用授权
AuthorizedOrganizationId和AuthorizedOrganizationName。注:授权给平台应用需要开通【基于子客授权第三方应用可文件发起子客自动签署】白名单,请联系运营经理开通。
*/ PlatformAppAuthorization?: boolean; /** *在处理授权关系时,授权的方向
AuthorizedOrganizationName 代表的是【被授权方】的企业名称,即接收授权的企业。AuthorizedOrganizationName 代表的是【授权方】的企业名称,即提供授权的企业。在设置印章授权时,可以指定特定的印章类型,以确保在授权过程中只使用相应类型的印章。
枚举值:
限制授权方式
枚举值:
默认值:0
*/ LimitAuthType?: string; } /** * CreateEmployeeQualificationSealQrCode请求参数结构体 */ export interface CreateEmployeeQualificationSealQrCodeRequest { /** * 关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。此接口下面信息必填。渠道应用相关信息。
*/ Agent: Agent; /** *自动签使用的场景值, 可以选择的场景值如下:
自动签开通个人用户信息,包括名字,身份证等。
*/ UserInfo: UserThreeFactor; /** *执行本接口操作的员工信息。
注: 在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。
链接的过期时间,格式为Unix时间戳,不能早于当前时间,且最大为当前时间往后30天。如果不传,默认过期时间为当前时间往后7天。
要跳转的链接类型
关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
*/ Agent: Agent; /** *自动签使用的场景值, 可以选择的场景值如下:
执行本接口操作的员工信息。
注: 在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。
自动签开通配置信息, 包括开通的人员的信息等
*/ AutoSignConfig?: AutoSignConfig; /** *生成的链接类型:
是否通知开通方,通知类型:
如果通知类型NotifyType选择为SMS,则此处为手机号, 其他通知类型不需要设置此项
*/ NotifyAddress?: string; /** *链接的过期时间,格式为Unix时间戳,不能早于当前时间,且最大为当前时间往后30天。如果不传,默认过期时间为当前时间往后7天。
调用方自定义的个性化字段(可自定义此字段的值),并以base64方式编码,支持的最大数据大小为 20480长度。 在个人自动签的开通、关闭等回调信息场景中,该字段的信息将原封不动地透传给贵方。
*/ UserData?: string; /** *要跳转的链接类型
操作的接口名称。取值参考接口文档输入参数章节关于公共参数 Action 的说明。
*/ RequestAction: string; /** *第三方应用的唯一标识,对应通用参数 Agent.AppId。
*/ ApplicationId: string; /** *加密算法使用的初始化向量。固定为 16 字节,将 IV 原始字节使用标准 Base64 编码后传入。
*/ IV: string; /** *使用 AES-CBC 或 SM4-CBC 加密请求内容得到的密文。加密前请求内容采用 PKCS#7 Padding;将密文原始字节使用标准 Base64 编码后传入。
*/ EncryptedData: string; /** *用于校验请求数据完整性。对 IV 原始字节和密文原始字节直接拼接(不加拼接符)后计算 HMAC-SHA256,再将计算结果使用标准 Base64 编码后传入。
*/ EncryptionSignature?: string; } /** * ChannelCancelMultiFlowSignQRCode请求参数结构体 */ export interface ChannelCancelMultiFlowSignQRCodeRequest { /** * 关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。 此接口下面信息必填。发起方企业经办人(即签署人为发起方企业员工)是否需要对子合同进行独立的意愿确认
非发起方企业经办人(即:签署人为个人或者不为发起方企业的员工)是否需要对子合同进行独立的意愿确认
是否不可编辑合同名称 true-不可编辑 false-可编辑(默认)
*/ NoEditFlowName?: boolean; /** *是否不可编辑合同类型 true-不可编辑 false-可编辑(默认)
*/ NoEditFlowType?: boolean; /** *是否不可编辑合同截止日期 true-不可编辑 false-可编辑(默认)
*/ NoEditDeadline?: boolean; /** *签署控件配置(如是否默认展示日期),用于嵌入式发起页面配置
*/ SignComponentConfig?: SignComponentConfig; /** *是否禁止编辑水印控件属性 true-禁止 false-否(默认)
*/ ForbidEditWatermark?: boolean; /** *发起成功后是否隐藏签署码 true-隐藏 false-否(默认)
*/ HideSignCodeAfterStart?: boolean; /** *发起成功后是否签署合同,仅当前经办人为签署人时生效 true-展示签署 false-否(默认)
*/ SignAfterStart?: boolean; /** *发起成功后是否预览合同 true-展示预览按钮 false-否(默认)
*/ PreviewAfterStart?: boolean; } /** * ChannelDescribeOrganizationSeals请求参数结构体 */ export interface ChannelDescribeOrganizationSealsRequest { /** *关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
此接口下面信息必填。
指定分页每页返回的数据条数,单页最大支持 100。默认值为20
*/ Limit?: number; /** *分页查询偏移量,默认为0,最大为20000
*/ Offset?: number; /** *查询授权用户信息类型,取值如下:
印章id,是否查询特定的印章(没有输入返回所有)
注: 没有输入返回所有记录,最大返回100条。
电子印章类型 , 可选类型如下:
1.为空时查询所有类型的印章。2.OTHER_XX该类型为其他印章子类型,如需使用,请联系对接客服申请开通。具体可传入的子类型值,需在申请开通后由客服提供。
*/
SealTypes?: Array需查询的印章状态列表。
授权链接,以短链形式返回,短链的有效期参考回参中的 ExpiredTime。
*/ Url?: string; /** *从客户小程序或者客户APP跳转至腾讯电子签小程序进行批量签署的跳转路径
*/ MiniAppPath?: string; /** *链接过期时间以 Unix 时间戳格式表示,从生成链接时间起,往后7天有效期。过期后短链将失效,无法打开。
*/ ExpireTime?: number; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ArchiveDynamicFlow请求参数结构体 */ export interface ArchiveDynamicFlowRequest { /** * 关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。 此接口下面信息必填。合同流程的名称(可自定义此名称),长度不能超过200,只能由中文、字母、数字和下划线组成。
*/ FlowName: string; /** *合同流程的签署截止时间,格式为Unix标准时间戳(秒),如果未设置签署截止时间,则默认为合同流程创建后的365天时截止。
如果在签署截止时间前未完成签署,则合同状态会变为已过期,导致合同作废。
示例值:1604912664
用户配置的合同模板ID,会基于此模板创建合同文档,为32位字符串。
如果使用模板发起接口,此参数为必填。
可以通过生成子客登录链接登录企业控制台, 在企业模板中得到合同模板ID。
*/ TemplateId?: string; /** *合同流程的参与方列表,最多可支持50个参与方。对应不同签署人的传参方式可以参考文档 签署方入参指引
注:
在发起流程时,需要保证 FlowApprovers中的顺序与模板定义顺序一致,否则会发起失败。
例如,如果模板中定义的第一个参与人是个人用户,第二个参与人是企业员工,则在 approver 中传参时,第一个也必须是个人用户,第二个参与人必须是企业员工。
发起方角色的填写控件的填充内容。
注:只有在控制台编辑模板时,归属给发起方的填写控件(如下图)才能在创建文档的时候进行内容填充。(白名单功能需要联系对接经理开通,否则模板编辑时无法将填写控件分配给发起方)。
该字段已废弃,请使用【应用号配置】中的回调地址统一接口消息
* @deprecated */ CallbackUrl?: string; /** *合同流程的类别分类(可自定义名称,如销售合同/入职合同等),最大长度为200个字符,仅限中文、字母、数字和下划线组成。
*/ FlowType?: string; /** *合同流程描述信息(可自定义此描述),最大长度1000个字符。
*/ FlowDescription?: string; /** *调用方自定义的个性化字段(可自定义此名称),并以base64方式编码,支持的最大数据大小为1000长度。
在合同状态变更的回调信息等场景中,该字段的信息将原封不动地透传给贵方。回调的相关说明可参考开发者中心的回调通知模块。
*/ CustomerData?: string; /** *您可以自定义腾讯电子签小程序合同列表页展示的合同内容模板,模板中支持以下变量:
例如,如果是腾讯公司张三发给李四名称为“租房合同”的合同,您可以将此字段设置为:合同名称:{合同名称};发起方: {发起方企业}({发起方姓名});签署方:{签署方1姓名},则小程序中列表页展示此合同为以下样子
合同名称:租房合同
发起方:腾讯公司(张三)
签署方:李四

合同流程的抄送人列表,最多可支持50个抄送人,抄送人可查看合同内容及签署进度,但无需参与合同签署。
注
发起方企业的签署人进行签署操作前,是否需要企业内部走审批流程,取值如下:
此功能可用于与企业内部的审批流程进行关联,支持手动、静默签署合同
*/
NeedSignReview?: boolean;
/**
* 若在创建签署流程时指定了关注人CcInfos,此参数可设定向关注人发送短信通知的类型:
个人自动签名的使用场景包括以下, 个人自动签署(即ApproverType设置成个人自动签署时)业务此值必传:
个人自动签名场景是白名单功能,使用前请与对接的客户经理联系沟通。
*/
AutoSignScene?: string;
/**
* 在短信通知、填写、签署流程中,若标题、按钮、合同详情等地方存在“合同”字样时,可根据此配置指定文案,可选文案如下:
*/
FlowDisplayType?: number;
/**
* 发起合同流程时对合同流程的部分操作加以限制的配置。
注:此参数目前只支持 CreateFlowsByTemplates接口 。
*/ FlowOperateLimit?: FlowOperateLimit; } /** * ChannelCreateDynamicFlowApprover请求参数结构体 */ export interface ChannelCreateDynamicFlowApproverRequest { /** * 动态合同信息 */ FillDynamicFlowList: Array腾讯电子签小程序的AppId,用于其他小程序/APP等应用跳转至腾讯电子签小程序使用。
*/ AppId?: string; /** *腾讯电子签小程序的原始Id,用于其他小程序/APP等应用跳转至腾讯电子签小程序使用。
*/ AppOriginalId?: string; /** *个人用户自动签的开通链接, 短链或者长链接形式。过期时间受 ExpiredTime 参数控制。
腾讯电子签小程序的跳转路径,用于其他小程序/APP等应用跳转至腾讯电子签小程序使用。
*/ Path?: string; /** *base64格式的跳转二维码图片,可通过微信扫描后跳转到腾讯电子签小程序的开通界面。
*/ QrCode?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 指定签署方经办人控件类型是个人印章签署控件(SIGN_SIGNATURE) 时,可选的签名方式。 */ export interface ApproverComponentLimitType { /** * 签署方经办人在模板中配置的参与方ID,与控件绑定,是控件的归属方,ID为32位字符串。 */ RecipientId: string; /** * 签署方经办人控件类型是个人印章签署控件(SIGN_SIGNATURE) 时,可选的签名方式。 签名方式:批量签署的流程签署人,其中姓名(ApproverName)、参与人类型(ApproverType)必传,手机号(ApproverMobile)和证件信息(ApproverIdCardType、ApproverIdCardNumber)可任选一种或全部传入。
注:1. 暂不支持签署人拖动签署控件功能,以及签批控件。2. 当需要通过短信验证码签署时,手机号ApproverMobile需要与发起合同时填写的用户手机号一致。
关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
*/ Agent?: Agent; /** *批量签署的合同流程ID数组。
注: 在调用此接口时,请确保合同流程均为本企业发起,且合同数量不超过100个。
合同组编号
注:该参数和合同流程ID数组必须二选一
签署完之后的H5页面的跳转链接,此链接及支持http://和https://,最大长度1000个字符。(建议https协议)
*/ JumpUrl?: string; /** *指定批量签署合同的签名类型,可传递以下值:
指定批量签署合同的认证校验方式,可传递以下值:
生成H5签署链接时,您可以指定签署方签署合同的认证校验方式的选择模式,可传递一下值:
不指定该值时,默认为签署方自行选择。
*/
SignTypeSelector?: number;
/**
* 批量签署合同相关信息,指定合同和签署方的信息,用于补充动态签署人。
注: 若签署方为企业员工,暂不支持通过H5端进行动态签署人的补充
只有在生成H5签署链接的情形下( 如调用获取H5签署链接、获取H5批量签署链接等接口),该配置才会生效。 您可以指定H5签署视频核身的意图配置,选择问答模式或点头模式的语音文本。 注意: 1. 视频认证为白名单功能,使用前请联系对接的客户经理沟通。 2. 使用视频认证时,生成H5签署链接的时候必须将签署认证方式指定为人脸(即ApproverSignTypes设置成人脸签署)。 3. 签署完成后,可以通过查询签署认证人脸视频获取到当时的视频。
*/ Intention?: Intention; /** *用于指定进入视频签署的限制次数,次数取值范围:1 - 10,不设置则默认为5次,仅视频签署时生效。
*/ VideoVerifyTimesLimit?: number; /** *缓存签署人信息。在H5签署链接动态领取场景,首次填写后,选择缓存签署人信息,在下次签署人点击领取链接时,会自动将个人信息(姓名、身份证号、手机号)填入,否则需要每次手动填写。
注: 若参与方为企业员工时,暂不支持对参与方信息进行缓存
是否允许此链接中签署方批量拒签。
当前合同组不支持批量拒签功能。请对合同组中的每个子合同逐一执行拒签操作,以达到拒签整个合同组的效果。
*/
CanBatchReject?: boolean;
/**
* 预设的动态签署方的补充信息,仅匹配对应信息的签署方才能领取合同。若为个人动态签署方,支持预设姓名、证件、手机号。若为企业员工动态签署方,仅支持预设企业名称(仅限预设SaaS企业参与方,不支持子客企业)。
*/ PresetApproverInfo?: PresetApproverInfo; /** *是否允许此链接中签署方批量确认已读文件。
1. 此功能为白名单功能,使用前请联系对应客户经理进行开通。2. 若批量签署的合同中第一份待签署合同所选择的印章或者签名无法完全覆盖后续合同要求,或者当前签署人没有指定印章使用权限,则无法使用此功能,会自动退化为逐份确认。
*/
CanSkipReadFlow?: boolean;
/**
* 链接的有效时间,单位为秒。取值范围为 30分钟(1800)-90天(7776000)。如果不传,默认有效期为30分钟。
注意:
出于安全性考虑,若有效期大于30分钟,同设备24小时内点击链接查看合同需要进行手机验证码校验。此校验将会扣除短信份额,不建议通过设置此值来缓存签署链接,建议在用户需要签署的时候临时生成链接。动态签署方链接暂不支持修改过期时间。模板ID,为32位字符串,模板复制新建时返回
*/ TemplateId?: string; /** *模板名称,模板复制新建时返回
*/ TemplateName?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 授权用户 */ export interface AuthorizedUser { /** * 第三方应用平台的用户openid */ OpenId?: string; } /** * 视频核身意图配置,可指定问答模式或者点头模式的语音文本。 注: `视频认证为白名单功能,使用前请联系对接的客户经理沟通。` */ export interface Intention { /** * 视频认证类型,支持以下类型批量企业注册链接-单链接包含多条认证流,根据Endpoint的不同设置,返回不同的链接地址。失效时间:7天
跳转链接, 链接的有效期根据企业,员工状态和终端等有区别, 可以参考下表
| Endpoint | 示例 | 链接有效期限 |
|---|---|---|
| HTTP | https://res.ess.tencent.cn/cdn/h5-activity-dev/jump-mp.html?to=AUTHORIZATION_ENTERPRISE_FOR_BATCH_SUBMIT&shortKey=yDCHHURDfBxSB2rj2Bfa | 7天 |
| HTTP_SHORT_URL | https://test.essurl.cn/8gDKUBAWK8 | 7天 |
| APP | pages/guide/index?to=AUTHORIZATION_ENTERPRISE_FOR_BATCH_SUBMIT&shortKey=yDCHpURDfR6iEkdpsDde | 7天 |
| QR_CODE | https://dyn.test.ess.tencent.cn/imgs/qrcode_urls/authorization_enterprise_for_batch_submit/yDCHHUUckpbdauq9UEjnoFDCCumAMmv1.png | 7天 |
1.创建的链接应避免被转义,如:&被转义为\u0026;如使用Postman请求后,请选择响应类型为 JSON,否则链接将被转义
*/
Url?: string;
/**
* 链接过期时间,为 7 天后,创建时间,格式为Unix标准时间戳(秒)。
单位:格式为Unix标准时间戳(秒)
*/ ExpireTime?: number; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeUsage返回参数结构体 */ export interface DescribeUsageResponse { /** * 用量明细条数 */ Total?: number; /** * 用量明细 */ Details?: Array关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
此接口下面信息必填。
合同流程ID数组,最多支持100个。
注:
合同组编号
注:该参数和合同流程ID数组必须二选一
签署链接类型,可以设置的参数如下
注:动态签署人场景,如果签署链接类型设置为APP,则仅支持跳转到封面页。
详细使用场景可以参考接口描述说明中的 主要使用场景EndPoint分类
*/ Endpoint?: string; /** *签署链接生成类型,可以选择的类型如下
SaaS平台企业员工签署方的企业名称如果名称中包含英文括号(),请使用中文括号()代替。 注: 1.GenerateType为"NOT_CHANNEL"时必填 2.获取B端动态签署人领取链接时,可指定此字段来预先设定签署人的企业,预设后只能以该企业身份去领取合同并完成签署
合同流程里边参与方的姓名。
注:
GenerateType为"PERSON"(即个人签署方)时必填。在动态签署人补充链接场景中,可以通过传入这个值,对补充的个人参与方信息进行限制。仅匹配传入姓名的参与方才能补充合同。此参数预设信息功能暂时仅支持个人动态参与方。合同流程里边签署方经办人手机号码, 支持国内手机号11位数字(无需加+86前缀或其他字符)。
注:
GenerateType为"PERSON"或"FOLLOWER"时必填。在动态签署人补充链接场景中,可以通过传入此值,对补充的个人参与方信息进行限制。仅匹配传入手机号的参与方才能补充合同。此参数预设信息功能暂时仅支持个人动态参与方。证件类型,支持以下类型
注:在动态签署人补充链接场景中,可以通过传入此值,对补充的个人参与方信息进行限制。仅匹配传入证件类型的参与方才能补充合同。此参数预设信息功能暂时仅支持个人动态参与方,且需要和证件号参数一同传递,不能单独进行限制。
证件号码,应符合以下规则
注:在动态签署人补充链接场景中,可以通过传入此值,对补充的个人参与方信息进行限制。仅匹配传入证件号的参与方才能补充合同。此参数预设信息功能暂时仅支持个人动态参与方。
第三方平台子客企业的企业的标识, 即OrganizationOpenId。 注: 1.GenerateType为"CHANNEL"时必填 2.获取B端动态签署人领取链接时,可指定此字段来预先设定签署人的平台子客企业,预设后只能以该平台子客企业身份去领取合同并完成签署
第三方平台子客企业员工的标识OpenId,GenerateType为"CHANNEL"时可用,指定到具体参与人, 仅展示已经实名的经办人信息
注:
如果传进来的OpenId已经实名并且加入企业, 则忽略Name,IdCardType,IdCardNumber,Mobile这四个入参(会用此OpenId实名的身份证和登录的手机号覆盖)
签署完成后是否自动回跳
注:
签署完之后的H5页面的跳转链接,针对Endpoint为CHANNEL时有效,最大长度1000个字符。
*/ JumpUrl?: string; /** *暂未开放
* @deprecated */ Operator?: UserInfo; /** *生成的签署链接在签署页面隐藏的按钮列表,可设置如下:
注: 字段为数组, 可以传值隐藏多个按钮
参与方角色ID,用于生成动态签署人链接完成领取。
注:使用此参数需要与flow_ids数量一致并且一一对应, 表示在对应同序号的流程中的参与角色ID,
合同组相关信息,指定合同组子合同和签署方的信息,用于补充动态签署人。
*/ FlowGroupUrlInfo?: FlowGroupUrlInfo; /** *仅公众号 H5 跳转电子签小程序时,如需签署完成的“返回应用”功能,在获取签署链接接口的 UrlUseEnv 参数需设置为 WeChatOfficialAccounts,小程序签署成功的结果页面中才会出现“返回应用”按钮。在用户点击“返回应用”按钮之后,会返回到公众号 H5。
参考 公众号 H5 跳转电子签小程序。
*/ UrlUseEnv?: string; /** *是否允许此链接中签署方批量确认已读文件。
1. 此功能为白名单功能,使用前请联系对应客户经理进行开通。2. 使用此功能时,FlowIds参数必传。3. 对于企业签署方,如果对印章/签名控件有限制要求,需要保证所有印章/签名签署控件限制要求(印章id或印章/签名类型限制)一致,否则无法使用此功能。默认值:false
*/ CanSkipReadFlow?: boolean; } /** * 企业认证信息参数, 需要保证这些参数跟营业执照中的信息一致。 */ export interface RegistrationOrganizationInfo { /** * 组织机构名称。 请确认该名称与企业营业执照中注册的名称一致。 如果名称中包含英文括号(),请使用中文括号()代替。 */ OrganizationName: string; /** * 机构在贵司业务系统中的唯一标识,用于与腾讯电子签企业账号进行映射,确保在同一应用内不会出现重复。 该标识最大长度为64位字符串,仅支持包含26个英文字母和数字0-9的字符。 */ OrganizationOpenId: string; /** * 员工在贵司业务系统中的唯一身份标识,用于与腾讯电子签账号进行映射,确保在同一应用内不会出现重复。 该标识最大长度为64位字符串,仅支持包含26个英文字母和数字0-9的字符。 */ OpenId: string; /** * 组织机构企业统一社会信用代码。 请确认该企业统一社会信用代码与企业营业执照中注册的统一社会信用代码一致。 */ UniformSocialCreditCode: string; /** * 组织机构法人的姓名。 请确认该企业统一社会信用代码与企业营业执照中注册的法人姓名一致。 */ LegalName: string; /** * 组织机构企业注册地址。 请确认该企业注册地址与企业营业执照中注册的地址一致。 */ Address?: string; /** * 组织机构超管姓名。 在注册流程中,必须是超管本人进行操作。 如果法人作为超管管理组织机构,超管姓名就是法人姓名 */ AdminName?: string; /** * 组织机构超管手机号。 在注册流程中,这个手机号必须跟操作人在电子签注册的个人手机号一致。 */ AdminMobile?: string; /** * 可选的此企业允许的授权方式, 可以设置的方式有: 1:上传授权书 2:法人授权超管 5:授权书+对公打款 注: `1. 当前仅支持一种认证方式` `2. 如果当前的企业类型是政府/事业单位, 则只支持上传授权书+对公打款` `3. 如果当前操作人是法人,则是法人认证` */ AuthorizationTypes?: Array关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
此接口下面信息必填。
合同模板ID,为32位字符串。
*/ TemplateId: string; /** *合同流程的名称(可自定义此名称),长度不能超过200,只能由中文、字母、数字和下划线组成。 该名称还将用于合同签署完成后的下载文件名。
*/ FlowName: string; /** *通过此二维码可发起的流程最大限额,如未明确指定,默认为5份。 一旦发起流程数超越该限制,该二维码将自动失效。
*/ MaxFlowNum?: number; /** *合同流程的签署有效期限,若未设定签署截止日期,则默认为自合同流程创建起的7天内截止。 若在签署截止日期前未完成签署,合同状态将变更为已过期,从而导致合同无效。 最长设定期限不得超过30天。
*/ FlowEffectiveDay?: number; /** *在短信通知、填写、签署流程中,若标题、按钮、合同详情等地方存在“合同”字样时,可根据此配置指定文案,可选文案如下:
效果如下:
枚举值:
默认值:0
*/ FlowDisplayType?: number; /** *二维码的有效期限,默认为7天,最高设定不得超过90天。 一旦超过二维码的有效期限,该二维码将自动失效。
* @deprecated */ QrEffectiveDay?: number; /** *指定签署人信息。 在指定签署人后,仅允许特定签署人通过扫描二维码进行签署。
*/ Restrictions?: Array指定签署方经办人控件类型是个人印章签署控件(SIGN_SIGNATURE) 时,可选的签名方式。
*/ ApproverComponentLimitTypes?: Array已废弃,回调配置统一使用企业应用管理-应用集成-第三方应用中的配置
通过一码多扫二维码发起的合同,回调消息可参考文档 https://qian.tencent.com/developers/partner/callback_types_contracts_sign
用户通过签署二维码发起合同时,因企业额度不足导致失败 会触发签署二维码相关回调,具体参考文档 https://qian.tencent.com/developers/partner/callback_types_commons#%E7%AD%BE%E7%BD%B2%E4%BA%8C%E7%BB%B4%E7%A0%81%E7%9B%B8%E5%85%B3%E5%9B%9E%E8%B0%83
限制二维码用户条件(已弃用)
* @deprecated */ ApproverRestrictions?: ApproverRestriction; /** *暂未开放
* @deprecated */ Operator?: UserInfo; /** *禁止个人用户重复签署,默认不禁止,即同一用户可多次扫码签署多份合同。若要求同一用户仅能扫码签署一份合同,请传入true。
*/ ForbidPersonalMultipleSign?: boolean; /** *合同流程名称是否应包含扫码签署人的信息,且遵循特定格式(flowname-姓名-手机号后四位)。 例如,通过参数FlowName设定的扫码发起合同名称为“员工入职合同”,当扫码人张三(手机号18800009527)扫码签署时,合同名称将自动生成为“员工入职合同-张三-9527”。
*/ FlowNameAppendScannerInfo?: boolean; /** *签署二维码的名称(可自定义此名称),长度不能超过200,只能由中文、字母、数字和下划线组成,会在生成的二维码图片上展示,若为空,则使用FlowName
*/ QrCodeName?: string; /** *签署二维码截止时间,格式为Unix标准时间戳(秒),如果未设置签署截止时间,则默认为签署二维码创建后的7天时截止,最长可设置为签署二维码创建后的365天时截止。
*/ QrCodeExpiredOn?: number; } /** * 企业认证可选项,其中包括 社会信用代码是否一致,企业名称是否一致,法人是否一致, 对公打款账号是否一致等信息。 代表生成链接的时候指定的这些信息不能被用户修改。 p.s. 注意这些选项一旦传递,相关的信息也不会被上传的营业执照里面包含的信息所覆盖。 */ export interface OrganizationAuthorizationOptions { /** *对方打开链接认证时,对方填写的营业执照的社会信用代码是否与接口上传上来的要保持一致。
对方打开链接认证时,企业名称是否要与接口传递上来的保持一致。
对方打开链接认证时,法人姓名是否要与接口传递上来的保持一致。
对方打开链接认证时,对公打款账号是否要与接口传递上来的保持一致。
对方打开链接认证时,公司地址是否要与接口传递上来的保持一致。
*/
AddressSame?: boolean;
/**
* 对方打开链接认证时,公司营业执照是否要与接口传递上来的保持一致。
p.s. 仅在公司营业执照(BusinessLicense)不为空时有效
如下图
*/
BizLicenseSame?: boolean;
}
/**
* 签署二维码的基本信息,用于创建二维码,用户可扫描该二维码进行签署操作。
*/
export interface SignQrCode {
/**
* 二维码ID,为32位字符串。
注: 需要保留此二维码ID, 用于后序通过取消一码多扫二维码关闭这个二维码的签署功能。
*/
QrCodeId?: string;
/**
* 二维码URL,可通过转换二维码的工具或代码组件将此URL转化为二维码,以便用户扫描进行流程签署。
*/
QrCodeUrl?: string;
/**
* 二维码的有截止时间,格式为Unix标准时间戳(秒),可以通过入参的QrEffectiveDay来设置有效期,默认为7天有效期。
一旦超过二维码的有效期限,该二维码将自动失效。
*/
ExpiredTime?: number;
/**
* 微信小程序二维码
*/
WeixinQrCodeUrl?: string;
}
/**
* 创建签署流程签署人入参。
**各种场景传参说明**:
| 场景编号 | 发起方类型 | 签署方类型 | 签署方传参说明 |
|---|---|---|---|
| 场景一 | 第三方子企业A员工 | 第三方子企业A员工 |
|
| 场景二 | 第三方子企业A员工 | 第三方子企业B(不指定经办人走领取方式) |
|
| 场景三 | 第三方子企业A员工 | 第三方子企业B员工 |
|
| 场景四 | 第三方子企业A员工 | 个人/自然人 |
|
| 场景五 | 第三方子企业A员工 | SaaS平台企业员工 |
|
签署方经办人的姓名。
经办人的姓名将用于身份认证和电子签名,请确保填写的姓名为签署方的真实姓名,而非昵称等代名。
签署方经办人的证件类型,支持以下类型
签署方经办人的证件号码,应符合以下规则
签署方经办人手机号码, 支持国内手机号11位数字(无需加+86前缀或其他字符), 不支持海外手机号。
请确认手机号所有方为此合同签署方。
组织机构名称。
请确认该名称与企业营业执照中注册的名称一致。
如果名称中包含英文括号(),请使用中文括号()代替。
指定签署人非第三方平台子客企业下员工还是SaaS平台企业,在ApproverType为ORGANIZATION时指定。
第三方平台子客企业员工的唯一标识,长度不能超过64,只能由字母和数字组成
当签署方为同一第三方平台下的员工时,该字段若不指定,则发起【待领取】的流程
注:
如果传进来的OpenId已经实名并且加入企业, 则忽略Name,IdCardType,IdCardNumber,Mobile这四个入参(会用此OpenId实名的身份证和登录的手机号覆盖)
同应用下第三方平台子客企业的唯一标识,定义Agent中的ProxyOrganizationOpenId一样,签署方为非发起方企业场景下必传,最大长度64个字符
*/ OrganizationOpenId?: string; /** *在指定签署方时,可选择企业B端或个人C端等不同的参与者类型,可选类型如下:
注:1. 个人自动签场景(PERSON_AUTO_SIGN)为白名单功能, 使用前请联系对接的客户经理沟通。2. 若要实现他方企业(同一应用下)自动签,需要满足3个条件:
签署流程签署人在模板中对应的签署人Id;在非单方签署、以及非B2C签署的场景下必传,用于指定当前签署方在签署流程中的位置;
*/ RecipientId?: string; /** *签署人的签署截止时间,格式为Unix标准时间戳(秒)
注: 若不设置此参数,则默认使用合同的截止时间,此参数暂不支持合同组子合同
签署完回调url,最大长度1000个字符
* @deprecated */ CallbackUrl?: string; /** *使用PDF文件直接发起合同时,签署人指定的签署控件;
使用模板发起合同时,指定本企业印章签署控件的印章ID:注意:(如果模板里面指定了印章,默认使用模板里面配置的印章,不能进行变更)
通过ComponentId或ComponenetName指定签署控件,ComponentValue为印章ID。

当签署方控件类型为 SIGN_SIGNATURE 时,可以指定签署方签名方式。如果不指定,签署人可以使用所有的签名类型,可指定的签名类型包括:
各种签名的样式可以参考下图:
签署方在签署合同之前,需要强制阅读合同的时长,可指定为3秒至300秒之间的任意值。
若未指定阅读时间,则会按照合同页数大小计算阅读时间,计算规则如下:
签署完前端跳转的url,此字段的用法场景请联系客户经理确认
*/ JumpUrl?: string; /** *可以控制签署方在签署合同时能否进行某些操作,例如拒签、转交他人、是否为动态补充签署人等。
详细操作可以参考开发者中心的ApproverOption结构体。
此签署人(员工或者个人)签署前,是否需要发起方企业进行审批,取值如下:
注:此功能可用于与发起方企业内部的审批流程进行关联,支持手动、静默签署合同

指定个人签署方查看合同的校验方式,可以传值如下:
签署人签署合同时的认证方式
默认为:
1(人脸认证 ),2(签署密码),3(运营商三要素),5(设备指纹识别),6(设备面容识别)
注:
签署ID
通知签署方经办人的方式(仅在指定NotChannelOrganization=true时有效), 有以下途径:
注: 签署方为第三方子客企业时会被置为NONE, 不会发短信通知
枚举值:
通过文件创建签署流程时,如果设置了外层参数SignBeanTag=1(允许签署过程中添加签署控件),则可通过此参数明确规定合同所使用的签署控件类型(骑缝章、普通章法人章等)和具体的印章(印章ID,或者印章类型)或签名方式。
注:限制印章控件或骑缝章控件情况下,仅本企业签署方可以指定具体印章(通过传递ComponentValue,支持多个),他方企业或个人只支持限制控件类型。
可以自定义签署人角色名:收款人、开具人、见证人等,长度不能超过20,只能由中文、字母、数字和下划线组成。
注: 如果是用模板发起, 优先使用此处上传的, 如果不传则用模板的配置的
生成H5签署链接时,您可以指定签署方签署合同的认证校验方式的选择模式,可传递一下值:
不指定该值时,默认为签署方自行选择。
*/
SignTypeSelector?: number;
/**
* 签署人在合同中的填写控件列表,列表中可支持下列多种填写控件,控件的详细定义参考开发者中心的Component结构体
具体使用说明可参考为签署方指定填写控件
注:此参数仅在通过文件发起合同或者合同组时生效

只有在生成H5签署链接的情形下( 如调用获取H5签署链接、获取H5批量签署链接等接口),该配置才会生效。
您可以指定H5签署视频核身的意图配置,选择问答模式或点头模式的语音文本。
注意:
进入签署流程的限制,目前支持以下选项:
用户指定的邮箱地址
*/ ApproverEmail?: string; } /** * ChannelCreateUserAutoSignEnableUrl返回参数结构体 */ export interface ChannelCreateUserAutoSignEnableUrlResponse { /** *个人用户自动签的开通链接, 短链或者长链接形式。过期时间受 ExpiredTime 参数控制。
腾讯电子签小程序的 AppID,用于其他小程序/APP等应用跳转至腾讯电子签小程序使用
注: 如果获取的是H5链接, 则不会返回此值
腾讯电子签小程序的原始 Id, ,用于其他小程序/APP等应用跳转至腾讯电子签小程序使用
注: 如果获取的是H5链接, 则不会返回此值
腾讯电子签小程序的跳转路径,用于其他小程序/APP等应用跳转至腾讯电子签小程序使用
注: 如果获取的是H5链接, 则不会返回此值
base64 格式的跳转二维码图片,可通过微信扫描后跳转到腾讯电子签小程序的开通界面。
注: 如果获取的是H5链接, 则不会返回此二维码图片
返回的链接类型
关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
此接口下面信息必填。
渠道应用标识: Agent.AppId
第三方平台子客企业标识: Agent.ProxyOrganizationOpenId
第三方平台子客企业中的员工标识: Agent. ProxyOperator.OpenId
第三方平台子客企业和员工必须已经经过实名认证
*/ Agent: Agent; /** *指定分页每页返回的数据条数,单页最大支持 200。
*/ Limit: number; /** *该字段是指第三方平台子客企业的唯一标识,用于查询单独某个子客的企业数据。
注:如果需要批量查询本应用下的所有企业的信息,则该字段不需要赋值
可以按照当前企业的认证状态进行过滤。可值如下:
偏移量:从 0 开始,最大20000。
*/ Offset?: number; } /** * ChannelDescribeBillUsageDetail返回参数结构体 */ export interface ChannelDescribeBillUsageDetailResponse { /** * 返回查询记录总数 */ Total?: number; /** * 消耗记录详情 */ Details?: Array修改员工信息的小程序链接
跳转到腾讯电子签小程序的实现可以参考微信的官方文档:开放能力/打开 App
H5跳转到电子签小程序链接, 一般用于发送短信中带的链接, 打开后进入腾讯电子签小程序
*/ LongUrl?: string; /** *H5跳转到电子签小程序链接的短链形式, 一般用于发送短信中带的链接, 打开后进入腾讯电子签小程序
*/ ShortUrl?: string; /** *链接过期时间以 Unix 时间戳格式表示,从生成链接时间起,往后7天有效期。过期后短链将失效,无法打开。
*/ ExpireTime?: number; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ChannelRenewAutoSignLicense请求参数结构体 */ export interface ChannelRenewAutoSignLicenseRequest { /** * 关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。 */ Agent: Agent; /** * 自动签使用的场景值, 可以选择的场景值如下:关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
*/ Agent: Agent; /** *个人用户姓名
*/ UserName: string; /** *证件号码, 应符合以下规则
电子印章名字,1-50个中文字符
注:同一企业下电子印章名字不能相同
电子印章图片base64编码,大小不超过10M(原始图片不超过5M),只支持PNG或JPG图片格式。
*/ SealImage?: string; /** *执行本接口操作的员工信息。
注: 在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。
证件类型,支持以下类型
注: 其他证件类型为白名单功能,使用前请联系对接的客户经理沟通。
是否开启印章图片压缩处理,默认不开启,如需开启请设置为 true。当印章超过 2M 时建议开启,开启后图片的 hash 将发生变化。
*/ SealImageCompress?: boolean; /** *手机号码;当需要开通自动签时,该参数必传
*/ Mobile?: string; /** *该字段已不再使用
* @deprecated */ EnableAutoSign?: boolean; /** *设置用户开通自动签时是否绑定个人自动签账号许可。一旦绑定后,将扣减购买的个人自动签账号许可一次(1年有效期),不可解绑释放。不传默认为绑定自动签账号许可。 0-绑定个人自动签账号许可,开通后将扣减购买的个人自动签账号许可一次 1-不绑定,发起合同时将按标准合同套餐进行扣减
*/ LicenseType?: number; /** *印章图片文件 id取值:填写的FileId通过UploadFiles接口上传文件获取。
*/ FileId?: string; } /** * CancelOrganizationFlows请求参数结构体 */ export interface CancelOrganizationFlowsRequest { /** *关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。此接口下面信息必填。
撤回原因,长度不能超过200,只能由中文、字母、数字和下划线组成。备注:如果不传递撤回原因,那么默认撤回原因是 "自动撤销(通过接口实现)"
撤销理由自定义格式, 会展示在合同预览的界面中, 可以选择下面的组合方式:0 : 默认格式, 合同封面页面会展示为: 发起方-企业名称-撤销的经办人名字以CancelMessage的理由撤销当前合同1 : 合同封面页面会展示为: 发起方以CancelMessage的理由撤销当前合同2 : 保留企业名称, 合同封面页面会展示为: 发起方-企业名称以CancelMessage的理由撤销当前合同3 : 保留企业名称+经办人名字, 合同封面页面会展示为: 发起方-企业名称-撤销的经办人名字以CancelMessage的理由撤销当前合同注: CancelMessage为撤销当前合同的理由
枚举值:
生成的合同流程ID数组,合同流程ID为32位字符串。
建议开发者妥善保存此流程ID数组,以便于顺利进行后续操作。
第三方应用平台的业务信息, 与创建合同的FlowInfos数组中的CustomerData一一对应
*/ CustomerData?: Array创建消息,对应多个合同ID,
成功为“”,创建失败则对应失败消息
合同预览链接URL数组。
注:如果是预览模式(即NeedPreview设置为true)时, 才会有此预览链接URL
如果预览的文件中指定了动态表格控件,此时此接口返回的是合成前的文档预览链接,合成完成后的文档预览链接需要通过合同文档合成完成回调获取或使用返回的TaskInfo中的TaskId通过查询转换任务状态接口查询得到
复杂文档合成任务(如,包含动态表格的预览任务)的任务信息数组;
如果文档需要异步合成,此字段会返回该异步任务的任务信息,后续可以通过ChannelGetTaskResultApi接口查询任务详情;
签署方信息,如角色ID、角色名称等
*/ FlowApprovers?: Array关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
此接口下面信息必填。
签署报告编号, 由提交申请出证报告任务产生
*/ ReportId: string; /** *暂未开放
* @deprecated */ Operator?: UserInfo; /** *指定申请的报告类型,可选类型如下:
枚举值:
| 特殊控件 | 填写约束 |
|---|---|
| 企业全称控件 | 企业名称中文字符中文括号 |
| 统一社会信用代码控件 | 企业注册的统一社会信用代码 |
| 法人名称控件 | 最大50个字符,2到25个汉字或者1到50个字母 |
| 签署意见控件 | 签署意见最大长度为50字符 |
| 签署人手机号控件 | 国内手机号 13,14,15,16,17,18,19号段长度11位 |
| 签署人身份证控件 | 合法的身份证号码检查 |
| 控件名称 | 控件名称最大长度为20字符,不支持表情 |
| 单行文本控件 | 只允许输入中文,英文,数字,中英文标点符号,不支持表情 |
| 多行文本控件 | 只允许输入中文,英文,数字,中英文标点符号,不支持表情 |
| 勾选框控件 | 选择填字符串true,不选填字符串false |
| 选择器控件 | 同单行文本控件约束,填写选择值中的字符串 |
| 数字控件 | 请输入有效的数字(可带小数点) |
| 日期控件 | 格式:yyyy年mm月dd日 |
| 附件控件 | JPG或PNG图片,上传数量限制,1到6个,最大6个附件,填写上传的资源ID |
| 图片控件 | JPG或PNG图片,填写上传的图片资源ID |
| 邮箱控件 | 有效的邮箱地址, w3c标准 |
| 地址控件 | 只允许输入中文,英文,数字,中英文标点符号,不支持表情 |
| 省市区控件 | 只允许输入中文,英文,数字,中英文标点符号,不支持表情 |
| 性别控件 | 选择值中的字符串 |
| 学历控件 | 选择值中的字符串 |
关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
此接口下面信息必填。
待修改的员工OpenId
*/ OpenId?: string; /** *待修改的员工手机号,支持海外格式
参数格式:
国内:+86 1825195xxxx 或者 1825195xxxx
海外:+12 12345xxx
电子签平台给企业分配的ID(在不同应用下同一个企业会分配通用的ID)
*/ OrganizationId?: string; /** *第三方平台子客企业的唯一标识
*/ OrganizationOpenId?: string; /** *第三方平台子客企业名称
*/ OrganizationName?: string; /** *企业的统一社会信用代码
*/ UnifiedSocialCreditCode?: string; /** *企业法定代表人的姓名
*/ LegalName?: string; /** *企业法定代表人作为第三方平台子客企业员工的唯一标识
*/ LegalOpenId?: string; /** *企业超级管理员的姓名
*/ AdminName?: string; /** *企业超级管理员作为第三方平台子客企业员工的唯一标识
*/ AdminOpenId?: string; /** *企业超级管理员的手机号码
注:手机号码脱敏(隐藏部分用*替代)
企业认证状态枚举值及说明如下:
| 枚举值 | 说明 |
|---|---|
UNVERIFIED | 企业未认证 |
VERIFYING | 企业认证中,还未选择授权方式 |
VERIFYINGLEGALPENDINGAUTHORIZATION | 企业认证中,待法人授权或法人认证 |
VERIFYINGAUTHORIZATIONFILEPENDING | 企业认证中,已上传授权书,授权书待审核 |
VERIFYINGAUTHORIZATIONFILEREJECT | 企业认证中,授权书审核被驳回 |
VERIFIED | 企业已认证成功 |
企业认证流程的典型流转路径如下:
UNVERIFIED → VERIFYING(提交企业信息,选择授权方式) ├─ 法人授权 → VERIFYINGLEGALPENDINGAUTHORIZATION → VERIFIED ├─ 法人认证 → VERIFYINGLEGALPENDINGAUTHORIZATION → VERIFIED └─ 授权书 → VERIFYINGAUTHORIZATIONFILEPENDING ├─ 审核通过 → VERIFIED └─ 审核驳回 → VERIFYINGAUTHORIZATIONFILEREJECT枚举值:
企业认证方式字段。值如下:
子企业激活状态。值如下:
账号到期时间,时间戳
*/ LicenseExpireTime?: number; /** *是否已提交企业认证信息
默认值:false
此参数表示客户是否已提交企业信息。如图所示,在点击提交按钮之前,该字段为 false;点击提交按钮之后,该字段变为 true。

注意:该字段并非在变为 true 后就不再变化。任何导致当前认证记录失效的操作都会将其重置为 false,包括但不限于:重新提交企业信息、审核被拒绝后重新上传企业信息等操作。
关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容此接口下面信息必填。
1. 企业激活时, 此时的Agent.ProxyOrganizationOpenId将会是企业激活后企业的唯一标识,建议开发者保存企业ProxyOrganizationOpenId,后续各项接口调用皆需要此参数。2. 员工认证时, 此时的Agent.ProxyOperator.OpenId将会是员工认证加入企业后的唯一标识,建议开发者保存此员工的OpenId,后续各项接口调用皆需要此参数。3. 同渠道应用(Agent.AppId)下,企业唯一标识ProxyOrganizationOpenId需要保持唯一,员工唯一标识OpenId也要保持唯一 (而不是企业下唯一)。
*/
Agent: Agent;
/**
* 企业营业执照或相关证照图片的 resourceId,需提前通过上传文件接口获取后传入。
注意:电子签不会对上传的营业执照图片做 OCR 识别,该图片仅作为企业信息变更的凭证留存;企业最新的名称、法人、地址等信息仍需通过本接口的其它字段显式传入。
变更后的最新工商登记企业名称。
仅当企业名称发生变更时传入,未变更则不传(系统自动沿用电子签侧当前企业名称)。
变更后的企业注册地址。
仅当地址发生变更时传入,未变更则不传;传入后系统会自动解析省/市/区。
变更后的企业类型。
仅当企业类型发生变更时传入,未变更则不传(沿用当前类型)。
目前仅支持个体工商户(INDIVIDUALBIZ)变更为企业(ENTERPRISE)。
枚举值:
变更后的最新工商登记法人姓名。
仅当法人发生变更时传入,未变更则不传(系统自动沿用当前法人姓名)。
新法人的手机号。
仅当法人发生变更时传入,用于向新法人发送短信通知。
需为合法的手机号或固定电话格式。
生成的签署参与者的签署链接信息数组。
*/ SignUrlInfos?: Array生成失败时的错误信息,成功返回”“,顺序和出参SignUrlInfos保持一致
*/ ErrorMessages?: Array签署人签署链接信息
*/ FlowApproverUrlInfo?: FlowApproverUrlInfo; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * CreateBatchOrganizationAuthorizationUrl返回参数结构体 */ export interface CreateBatchOrganizationAuthorizationUrlResponse { /** * 批量企业注册链接-单链接包含多条认证流,根据Endpoint的不同设置,返回不同的链接地址。失效时间:7天跳转链接, 链接的有效期根据企业,员工状态和终端等有区别, 可以参考下表| Endpoint | 示例 | 链接有效期限 |
|---|---|---|
| HTTP | https://res.ess.tencent.cn/cdn/h5-activity-dev/jump-mp.html?to=AUTHORIZATION_ENTERPRISE_FOR_BATCH_SUBMIT&shortKey=yDCHHURDfBxSB2rj2Bfa | 7天 |
| HTTP_SHORT_URL | https://test.essurl.cn/8gDKUBAWK8 | 7天 |
| APP | pages/guide/index?to=AUTHORIZATION_ENTERPRISE_FOR_BATCH_SUBMIT&shortKey=yDCHpURDfR6iEkdpsDde | 7天 |
| QR_CODE | https://dyn.test.ess.tencent.cn/imgs/qrcode_urls/authorization_enterprise_for_batch_submit/yDCHHUUckpbdauq9UEjnoFDCCumAMmv1.png | 7天 |
关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
此接口下面信息必填。
被授企业id/授权方企业id(即OrganizationId),如果是企业之间授权和AuthorizedOrganizationName二选一传入。
注:被授权企业必须和当前企业在同一应用号下
被授企业名称/授权方企业的名字,如果是企业之间授权和AuthorizedOrganizationId二选一传入即可。请确认该名称与企业营业执照中注册的名称一致。
注:
是否给平台应用授权
AuthorizedOrganizationIds和AuthorizedOrganizationNames。注:授权给平台应用需要开通【基于子客授权第三方应用可文件发起子客自动签署】白名单,请联系运营经理开通。
*/ PlatformAppAuthorization?: boolean; /** *在设置印章授权时,可以指定特定的印章类型,以确保在授权过程中只使用相应类型的印章。
枚举值:
在处理授权关系时,授权的方向
AuthorizedOrganizationNames 代表的是【被授权方】的企业名称,即接收授权的企业。AuthorizedOrganizationNames 代表的是【授权方】的企业名称,即提供授权的企业。此场景下不支持批量被授企业id/授权方企业id(即OrganizationId),如果是企业之间授权和AuthorizedOrganizationNames二选一传入,最大支持50个,注:被授权企业必须和当前企业在同一应用号下
被授企业名称/授权方企业的名字,如果是企业之间授权和AuthorizedOrganizationIds二选一传入即可。请确认该名称与企业营业执照中注册的名称一致。注: 1. 如果名称中包含英文括号(),请使用中文括号()代替。2. 被授权企业必须和当前企业在同一应用号下 3. 数组最大长度50
*/ AuthorizedOrganizationNames?: Array限制授权方式
枚举值:
默认值:0
*/ LimitAuthType?: number; } /** * DescribeBatchOrganizationRegistrationTasks返回参数结构体 */ export interface DescribeBatchOrganizationRegistrationTasksResponse { /** * 企业批量任务状态明细 */ Details?: Array预设参与方姓名。
*/ Name?: string; /** *预设参与方手机号。
*/ Mobile?: string; /** *预设参与方证件号,需要和IdCardType同时传入。
证件号码,应符合以下规则
预设参与方的证件类型,需要与IdCardNumber同时传入。
证件类型,支持以下类型
企业用户动态签署方场景指定预设企业名称。注意:1. 若为企业动态签署方场景,此参数必须要指定。2. 企业动态签署方场景暂不支持指定姓名证件手机号等参数,仅支持指定企业名称。3. 暂不支持指定子客企业,此处预设的企业仅支持SaaS企业。
失败的合同id以及错误详情
*/ FailedFlows?: Array成功的合同id
*/ SuccessFlows?: Array合同流程ID,为32位字符串。
建议开发者妥善保存此流程ID,以便于顺利进行后续操作。
签署方信息,如角色ID、角色名称等
*/ Approvers?: Array预览链接,有效期5分钟
注:如果是预览模式(即NeedPreview设置为true)时, 才会有此预览链接URL
在设定了SealId时,返回值为0或1;若未设定SealId,则返回公司的总印章数量
*/ TotalCount?: number; /** *查询到的印章结果数组
*/ Seals?: Array电子印章ID,为32位字符串。
建议开发者保留此印章ID,后续指定签署区印章或者操作印章需此印章ID。
电子印章预览链接地址,地址默认失效时间为24小时。
注:图片上传生成的电子印章无预览链接地址
人脸验证操作人链接,用法可以参考"跳转电子签小程序配置",默认为空。
*/ SealOperatorVerifyPath?: string; /** *人脸验证操作人二维码链接,扫码后会跳转到腾讯电子签小程序进行人脸验证,默认为空。
*/ SealOperatorVerifyQrcodeUrl?: string; /** *创建印章预览逻辑,返回的是印章加盖在示例文件上的效果图片链接。链接有效期为90天。
*/ PreviewFileUrl?: string; /** *创建印章预览逻辑,返回的是印章加盖在示例文件上的效果PDF文件链接。链接有效期为90天。
*/ PreviewPdfUrl?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 动态合同信息 */ export interface DynamicFlowInfo { /** * 合同流程ID,为32位字符串。 - FlowId 在通过[ChannelCreateFlowByFiles](https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowByFiles) 发起,可以在返回参数FlowId中获取。 - 建议开发者妥善保存此流程ID,以便于顺利进行后续操作。 - 可登录腾讯电子签控制台,在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。 */ FlowId: string; /** * 合同流程的参与方列表, 最多可支持50个参与方,可在列表中指定企业B端签署方和个人C端签署方的联系和认证方式等信息,不同类型的签署方传参方式可以参考文档 [签署方入参指引](https://qian.tencent.com/developers/partner/flow_approver)。 如果合同流程是有序签署,Approvers列表中参与人的顺序就是默认的签署顺序, 请确保列表中参与人的顺序符合实际签署顺序。 */ FlowApprovers: Array要变更的企业Id。 使用接口进行变更,所支持的企业有两种。
注意:
此参数和 ChangeAdminOrganizationOpenId二选一,如果都传递了,但是不一致会进行报错拦截。
要变更的企业Id。 使用接口进行变更,所支持的企业有两种。
注意: 此参数和 ChangeAdminOrganizationId二选一,如果都传递了,不一致会进行报错拦截。
组织机构要变更的超管OpenId。
*/ NewAdminOpenId?: string; /** *组织机构要变更的超管姓名。
*/ NewAdminName?: string; /** *组织机构要变更的超管手机号。 跟超管变更的操作人保持一致。
*/ NewAdminMobile?: string; /** *组织机构要变更的超管证件类型支持以下类型
跟超管变更的操作人保持一致。
枚举值:
组织机构新超管证件号。 跟超管变更的操作人保持一致。
*/ NewAdminIdCardNumber?: string; /** *授权书(PNG或JPG或PDF) base64格式, 大小不超过8M 。
p.s. 如果上传授权书 ,需遵循以下条件 1. 超管的信息(超管姓名,超管手机号)必须为必填参数。
*/ AuthFiles?: Array一码多签签署码的基本信息,用户可扫描该二维码进行签署操作。
*/ QrCode?: SignQrCode; /** *一码多签签署码链接信息,适用于客户系统整合二维码功能。通过链接,用户可直接访问电子签名小程序并签署合同。
*/ SignUrls?: SignUrl; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 签署人个性化能力信息 */ export interface ApproverOption { /** *是否可以拒签 默认false-可以拒签 true-不可以拒签
*/ NoRefuse?: boolean; /** *是否可以转发 默认false-可以转发 true-不可以转发
*/ NoTransfer?: boolean; /** *当签署方有多个签署区时候,是否隐藏一键所有的签署区
false:(默认)不隐藏
true:隐藏,每个签署区要单独选择印章或者签名
签署人信息补充类型,默认无需补充。
企业自动签不支持动态补充使用动态签署人能力前,需登录腾讯电子签控制台打开服务开关枚举值:
签署人阅读合同限制参数
取值:
禁止在签署过程中添加签署日期控件
前置条件:文件发起合同时,指定SignBeanTag=1(可以在签署过程中添加签署控件):
签署人手机号传参模式
枚举值:
默认值:""
会触发手机号传参模式的前提是:签署人是指定了具体身份信息的
【仅 SignBeanTag=1 时有效】 签署方自行添加签署印章类控件(SIGN_SEAL、SIGN_PAGING_SEAL、SIGN_LEGAL_PERSON_SEAL)时,「盖章区适配签署方印章尺寸」开关的控制策略
枚举值:
合同组ID,为32位字符串。
建议开发者妥善保存此合同组ID,以便于顺利进行后续操作。
嵌入式发起链接
*/ PrepareUrl?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeCancelFlowsTask请求参数结构体 */ export interface DescribeCancelFlowsTaskRequest { /** *关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
此接口下面信息必填。
批量撤销任务编号,为32位字符串,通过接口批量撤销合同流程或者获取批量撤销签署流程腾讯电子签小程序链接或者全量撤销企业合同获得。
*/ TaskId: string; /** *撤销任务类型
枚举值:
枚举值:
| 可以分配的角色 | 角色名称 | 角色描述 |
|---|---|---|
| admin | 业务管理员(IT 系统负责人,e.g. CTO) | 有企业合同模块、印章模块、模板模块等全量功能及数据权限。 |
| channel-normal-operator | 经办人(企业法务负责人) | 有发起合同、签署合同(含填写、拒签)、撤销合同、持有印章等权限能力,可查看企业所有合同数据。 |
| channel-sales-man | 业务员(一般为销售员、采购员) | 有发起合同、签署合同(含填写、拒签)、撤销合同、持有印章等权限能力,可查看自己相关所有合同数据。 |
关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
此接口下面信息必填。
签署方经办人的姓名。
经办人的姓名将用于身份认证和电子签名,请确保填写的姓名为签署方的真实姓名,而非昵称等代名。
注:
手机号码, 支持国内手机号11位数字(无需加+86前缀或其他字符)。
请确认手机号所有方为此业务通知方。
注:
执行本接口操作的员工信息。
注: 在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。
证件类型,支持以下类型
注:
请确保和合同中填入的一致。在生成动态签署人补充链接场景中,可以通过传入此值,对补充的个人参与方信息进行限制。仅匹配传入证件类型的参与方才能补充合同。此参数预设信息功能暂时仅支持个人动态参与方,且需要和证件号参数一同传递,不能单独进行限制。证件号码,应符合以下规则
注:
请确保和合同中填入的一致。在生成动态签署人补充链接场景中,可以通过传入此值,对补充的个人参与方信息进行限制。仅匹配传入证件号的参与方才能补充合同。此参数预设信息功能暂时仅支持个人动态参与方。通知用户方式:
批量签署的合同流程ID数组。此参数必传。
注: 在调用此接口时,请确保合同流程均为本企业发起,且合同数量不超过100个。
SaaS平台企业员工签署方的企业名称。目标签署人如果为saas应用企业员工身份,此参数必填。
注:
指定批量签署合同的签名类型,可传递以下值:
是否直接跳转至合同内容页面进行签署
批量签署合同相关信息,指定合同和签署方的信息,用于补充动态签署人。
*/ FlowBatchUrlInfo?: FlowBatchUrlInfo; /** *第三方平台子客企业员工的标识OpenId,批签合同经办人为子客员工的情况下为必填。
注:
第三方平台子客企业的企业的标识, 即OrganizationOpenId,批签合同经办人为子客企业员工是为必填。
*/ OrganizationOpenId?: string; /** *签署完成后是否自动回跳
注:
仅公众号 H5 跳转电子签小程序时,如需签署完成的“返回应用”功能,在获取签署链接接口的 UrlUseEnv 参数需设置为 WeChatOfficialAccounts,小程序签署成功的结果页面中才会出现“返回应用”按钮。在用户点击“返回应用”按钮之后,会返回到公众号 H5。
参考 公众号 H5 跳转电子签小程序。
*/ UrlUseEnv?: string; /** *是否允许此链接中签署方批量拒签。
1. 当前合同组不支持批量拒签功能。请对合同组中的每个子合同逐一执行拒签操作,以达到拒签整个合同组的效果。2. 如果是链接直接跳转至详情页(JumpToDetail参数为true),也不支持批量拒签功能
*/
CanBatchReject?: boolean;
/**
* 是否允许此链接中签署方批量确认已读文件。
1. 此功能为白名单功能,使用前请联系对应客户经理进行开通。2. 使用此功能时,FlowIds参数必传。3. 对于企业签署方,如果对印章/签名控件有限制要求,需要保证所有印章/签名控件的限制要求(印章id或印章/签名类型限制)一致,否则无法使用此功能。
*/
CanSkipReadFlow?: boolean;
}
/**
* ChannelUpdateSealStatus返回参数结构体
*/
export interface ChannelUpdateSealStatusResponse {
/**
* 人脸验证操作人链接,用法可以参考"[跳转电子签小程序配置](https://qian.tencent.com/developers/company/openwxminiprogram/)",默认为空。
*/
SealOperatorVerifyPath?: string;
/**
* 人脸验证操作人二维码链接,扫码后会跳转到腾讯电子签小程序进行人脸验证,默认为空。
*/
SealOperatorVerifyQrcodeUrl?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* ChannelCreateOrganizationModifyQrCode返回参数结构体
*/
export interface ChannelCreateOrganizationModifyQrCodeResponse {
/**
* 二维码下载链接
*/
QrCodeUrl?: string;
/**
* 二维码失效时间 UNIX 时间戳 精确到秒
*/
ExpiredTime?: number;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* ChannelDeleteSealPolicies返回参数结构体
*/
export interface ChannelDeleteSealPoliciesResponse {
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* ChannelCreateWebThemeConfig返回参数结构体
*/
export interface ChannelCreateWebThemeConfigResponse {
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* GetDownloadFlowUrl请求参数结构体
*/
export interface GetDownloadFlowUrlRequest {
/**
* 关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
此接口下面信息必填。
嵌入的web链接,5分钟有效
*/ WebUrl?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ChannelBatchCancelFlows请求参数结构体 */ export interface ChannelBatchCancelFlowsRequest { /** * 关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。 此接口下面信息必填。