;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 发起流程的可嵌入页面操作结果页配置
*/
export interface CreateResultPageConfig {
/**
*
- 0 : 发起审批成功页面(通过接口创建发起流程web页面发起时设置了NeedCreateReview参数为true)
*/
Type: number;
/**
* 结果页标题,不超过50字
*/
Title: string;
/**
* 结果页描述,不超过200字
*/
Description?: string;
}
/**
* 此结构体 (Component) 用于描述控件属性。
在通过文件发起合同时,对应的component有三种定位方式
1. 绝对定位方式 (可以通过 [PDF坐标计算助手](https://qian.tencent.com/developers/tools/template-editor)计算控件的坐标)
2. 表单域(FIELD)定位方式
3. 关键字(KEYWORD)定位方式,使用关键字定位时,请确保PDF原始文件内是关键字以文字形式保存在PDF文件中,不支持对图片内文字进行关键字查找
*/
export interface Component {
/**
* **如果是Component填写控件类型,则可选的字段为**:
- TEXT : 普通文本控件,输入文本字符串;
- MULTI_LINE_TEXT : 多行文本控件,输入文本字符串;
- CHECK_BOX : 勾选框控件,若选中填写ComponentValue 填写 true或者 false 字符串;
- FILL_IMAGE : 图片控件,ComponentValue 填写图片的资源 ID;
- DYNAMIC_TABLE : 动态表格控件;
- ATTACHMENT : 附件控件,ComponentValue 填写附件图片的资源 ID列表,以逗号分隔;
- SELECTOR : 选择器控件,ComponentValue填写选择的字符串内容;
- DATE : 日期控件;默认是格式化为xxxx年xx月xx日字符串;
- WATERMARK : 水印控件;只能分配给发起方,必须设置ComponentExtra;
- DISTRICT : 省市区行政区控件,ComponentValue填写省市区行政区字符串内容;
- VIRTUAL_COMBINATION : 虚拟控件,内部特定控件(CHECK_BOX),本身不填充任何文字内容
**如果是SignComponent签署控件类型,
需要根据签署人的类型可选的字段为**
* 企业方
- SIGN_SEAL : 签署印章控件;
- SIGN_DATE : 签署日期控件;
- SIGN_SIGNATURE : 用户签名控件;
- SIGN_PAGING_SIGNATURE : 用户签名骑缝章控件;;若文件发起,需要对应填充ComponentPosY、ComponentWidth、ComponentHeight
- SIGN_PAGING_SEAL : 骑缝章;若文件发起,需要对应填充ComponentPosY、ComponentWidth、ComponentHeight
- SIGN_OPINION : 签署意见控件,用户需要根据配置的签署意见内容,完成对意见内容的确认;
- SIGN_VIRTUAL_COMBINATION : 签批控件。内部最多组合4个特定控件(SIGN_SIGNATURE,SIGN_DATA,SIGN_MULTI_LINE_TEXT,SIGN_SELECTOR),本身不填充任何文字内容
- SIGN_MULTI_LINE_TEXT : 多行文本,仅可用在签批控件内部作为组合控件,单独无法使用,常用作批注附言
- SIGN_SELECTOR : 选择器,仅可用在签批控件内部作为组合控件,单独无法使用,常用作审批意见的选择
- SIGN_LEGAL_PERSON_SEAL : 企业法定代表人控件。
* 个人方
- SIGN_DATE : 签署日期控件;
- SIGN_SIGNATURE : 用户签名控件;
- SIGN_PAGING_SIGNATURE : 用户签名骑缝章控件;
- SIGN_VIRTUAL_COMBINATION : 签批控件。内部最多组合4个特定控件(SIGN_SIGNATURE,SIGN_DATA,SIGN_MULTI_LINE_TEXT,SIGN_SELECTOR),本身不填充任何文字内容
- SIGN_MULTI_LINE_TEXT : 多行文本,仅可用在签批控件内部作为组合控件,单独无法使用,常用作批注附言
- SIGN_SELECTOR : 选择器,仅可用在签批控件内部作为组合控件,单独无法使用,常用作审批意见的选择
- SIGN_OPINION : 签署意见控件,用户需要根据配置的签署意见内容,完成对意见内容的确认;
注:` 表单域的控件不能作为印章和签名控件`
*/
ComponentType: string;
/**
* **在绝对定位方式和关键字定位方式下**,指定控件的高度, 控件高度是指控件在PDF文件中的高度,单位为pt(点)。
*/
ComponentHeight: number;
/**
* **在绝对定位方式和关键字定位方式下**,指定控件宽度,控件宽度是指控件在PDF文件中的宽度,单位为pt(点)。
*/
ComponentWidth: number;
/**
* **在绝对定位方式方式下**,指定控件所在PDF文件上的页码
**在使用文件发起的情况下**,绝对定位方式的填写控件和签署控件支持使用负数来指定控件在PDF文件上的页码,使用负数时,页码从最后一页开始。例如:ComponentPage设置为-1,即代表在PDF文件的最后一页,以此类推。
注:
1. 页码编号是从1开始编号的。
2. 页面编号不能超过PDF文件的页码总数。如果指定的页码超过了PDF文件的页码总数,在填写和签署时会出现错误,导致无法正常进行操作。
*/
ComponentPage: number;
/**
* **在绝对定位方式下**,可以指定控件横向位置的位置,单位为pt(点)。
*/
ComponentPosX: number;
/**
* **在绝对定位方式下**,可以指定控件纵向位置的位置,单位为pt(点)。
*/
ComponentPosY: number;
/**
* 【暂未使用】控件所属文件的序号(取值为:0-N)。 目前单文件的情况下,值一直为0
*/
FileIndex: number;
/**
* 控件生成的方式:
- NORMAL : 绝对定位控件
- FIELD : 表单域
- KEYWORD : 关键字(设置关键字时,请确保PDF原始文件内是关键字以文字形式保存在PDF文件中,不支持对图片内文字进行关键字查找)
*/
GenerateMode?: string;
/**
* 控件唯一ID。
**在绝对定位方式方式下**,ComponentId为控件的ID,长度不能超过30,只能由中文、字母、数字和下划线组成,可以在后续的操作中使用该名称来引用控件。
**在关键字定位方式下**,ComponentId不仅为控件的ID,也是关键字整词。此方式下可以通过"^"来决定是否使用关键字整词匹配能力。
例:
- 如传入的关键字"^甲方签署^",则会在PDF文件中有且仅有"甲方签署"关键字的地方(前后不能有其他字符)进行对应操作。
- 如传入的关键字为"甲方签署",则PDF文件中每个出现关键字的位置(前后可以有其他字符)都会执行相应操作。
注:`控件ID可以在一个PDF中不可重复`
点击查看ComponentId在模板编辑页面的位置
*/
ComponentId?: string;
/**
* **在绝对定位方式方式下**,ComponentName为控件名,长度不能超过20,只能由中文、字母、数字和下划线组成,可以在后续的操作中使用该名称来引用控件。
**在表单域定位方式下**,ComponentName不仅为控件名,也是表单域名称。
注:`控件名可以在一个PDF中可以重复`
点击查看ComponentName在模板页面的位置
*/
ComponentName?: string;
/**
* 如果是填写控件,ComponentRequired表示在填写页面此控件是否必填
- false(默认):可以不填写
- true :必须填写此填写控件
如果是签署控件,签批控件中签署意见等可以不填写, 其他签署控件不受此字段影响
*/
ComponentRequired?: boolean;
/**
* **在通过接口拉取控件信息场景下**,为出参参数,此控件归属的参与方的角色ID角色(即RecipientId),**发起合同时候不要填写此字段留空即可**
*/
ComponentRecipientId?: string;
/**
* **在所有的定位方式下**,控件的扩展参数,为JSON格式,不同类型的控件会有部分非通用参数。
ComponentType为TEXT、MULTI_LINE_TEXT时,支持以下参数:
- Font:目前只支持黑体、宋体、仿宋
- FontSize: 范围6 :72
- FontAlign: Left/Right/Center,左对齐/居中/右对齐
- FontColor:字符串类型,格式为RGB颜色数字
- Bold是否加粗:true/false
参数样例:`{"FontColor":"255,0,0","FontSize":12,"Bold":false}`
ComponentType为DATE时,支持以下参数:
- Font:目前只支持黑体、宋体、仿宋
- FontSize: 范围6 :72
参数样例:`{"FontColor":"255,0,0","FontSize":12}`
ComponentType为WATERMARK时,支持以下参数:
- Font:目前只支持黑体、宋体、仿宋
- FontSize: 范围6 :72
- Opacity: 透明度,范围0 :1
- Rotate: 水印旋转角度,范围0 :359
- Density: 水印样式,1-宽松,2-标准(默认值),3-密集,
- Position: 水印位置,None-平铺(默认值),LeftTop-左上,LeftBottom-左下,RightTop-右上,RightBottom-右下,Center-居中
- SubType: 水印类型:CUSTOM_WATERMARK-自定义内容,PERSON_INFO_WATERMARK-访问者信息
参数样例:`"{\"Font\":\"黑体\",\"FontSize\":20,\"Opacity\":0.1,\"Density\":2,\"SubType\":\"PERSON_INFO_WATERMARK\"}"`
ComponentType为FILL_IMAGE时,支持以下参数:
- NotMakeImageCenter:bool。是否设置图片居中。false:居中(默认)。 true : 不居中
- FillMethod : int. 填充方式。0-铺满(默认);1-等比例缩放
ComponentType为SELECTOR时,支持以下参数:
- WordWrap:bool。是否支持选择控件内容自动折行合成。false:不支持(默认)。 true : 支持自动折行合成
ComponentType为SIGN_SIGNATURE、SIGN_PAGING_SIGNATURE类型时,可以通过**ComponentTypeLimit**参数控制签名方式
- HANDWRITE : 需要实时手写的手写签名
- HANDWRITTEN_ESIGN : 长效手写签名, 是使用保存到个人中心的印章列表的手写签名(并且包含HANDWRITE)
- OCR_ESIGN : AI智能识别手写签名
- ESIGN : 个人印章类型
- SYSTEM_ESIGN : 系统签名(该类型可以在用户签署时根据用户姓名一键生成一个签名来进行签署)
- IMG_ESIGN : 图片印章(该类型支持用户在签署将上传的PNG格式的图片作为签名)
参考样例:`{"ComponentTypeLimit": ["SYSTEM_ESIGN"]}`
印章的对应关系参考下图

ComponentType为SIGN_SEAL 或者 SIGN_PAGING_SEAL类型时,可以通过**ComponentTypeLimit**参数控制签署方签署时要使用的印章类型,支持指定以下印章类型
- OFFICIAL : 企业公章
- CONTRACT : 合同专用章
- FINANCE : 财务专用章
- PERSONNEL : 人事专用章
- OTHER : 其他
参考样例:`{\"ComponentTypeLimit\":[\"PERSONNEL\",\"FINANCE\"]}` 表示改印章签署区,客户需使用人事专用章或财务专用章盖章签署。
ComponentType为SIGN_DATE时,支持以下参数:
- Font :字符串类型目前只支持"黑体"、"宋体"、"仿宋",如果不填默认为"黑体"
- FontSize : 数字类型,范围6-72,默认值为12
- FontAlign : 字符串类型,可取Left/Right/Center,对应左对齐/居中/右对齐
- Format : 字符串类型,日期格式,必须是以下五种之一 “yyyy m d”,”yyyy年m月d日”,”yyyy/m/d”,”yyyy-m-d”,”yyyy.m.d”。
- Gaps : 字符串类型,仅在Format为“yyyy m d”时起作用,格式为用逗号分开的两个整数,例如”2,2”,两个数字分别是日期格式的前后两个空隙中的空格个数
如果extra参数为空,默认为”yyyy年m月d日”格式的居中日期
特别地,如果extra中Format字段为空或无法被识别,则extra参数会被当作默认值处理(Font,FontSize,Gaps和FontAlign都不会起效)
参数样例: ` "{"Format":"yyyy m d","FontSize":12,"Gaps":"2,2", "FontAlign":"Right"}"`
ComponentType为SIGN_SEAL、SIGN_SIGNATURE类型时,支持以下参数:
- PageRanges :PageRange的数组,通过PageRanges属性设置该印章在PDF所有页面上盖章(适用于标书在所有页面盖章的情况)
参数样例:` "{"PageRanges":[{"BeginPage":1,"EndPage":-1}]}"`
签署印章透明度功能设置,当ComponentType为SIGN_SIGNATURE、SIGN_SEAL、SIGN_PAGING_SEAL、SIGN_LEGAL_PERSON_SEAL时,可以通过以下参数设置签署印章的透明度:
- Opacity:印章透明度,支持范围:0.6-1,0.7表示70%的透明度,1表示无透明度
参数样例:`{"Opacity":0.7}`
签署印章大小功能设置,当ComponentType为SIGN_SEAL、SIGN_PAGING_SEAL、SIGN_LEGAL_PERSON_SEAL时,可以通过以下参数设置签署时按照实际印章的大小进行签署,如果印章没有设置大小,那么默认会是4.2cm的印章大小:
- UseSealSize:使用印章设置的大小盖章,true表示使用印章设置的大小盖章,false表示使用签署控件的大小进行盖章;不传则为false
参数样例:`{"UseSealSize":true}`
签署意见功能设置,当ComponentType为SIGN_OPINION时,可以通过以下参数设置签署意见的相关内容:
- Values:签署意见预设的需要用户填写的文本
- ValuesArray:签署意见需要用户按顺序点击的分词(组合后应和Values内容一致)
参数样例:`{"Values":"我已知晓内容并同意签署","ValuesArray":["我","已知晓","内容","并","同意","签署"]}`
关键字模式下支持关键字找不到的情况下不进行报错的设置
- IgnoreKeywordError :1-关键字查找不到时不进行报错
场景说明:如果使用关键字进行定位,但是指定的PDF文件中又没有设置的关键字时,发起合同会进行关键字是否存在的校验,如果关键字不存在,会进行报错返回。如果不希望进行报错,可以设置"IgnoreKeywordError"来忽略错误。请注意,如果关键字签署控件对应的签署方在整个PDF文件中一个签署控件都没有,还是会触发报错逻辑。
参数样例:` "{"IgnoreKeywordError":1}"`
ComponentType为SIGN_VIRTUAL_COMBINATION或者VIRTUAL_COMBINATION时,支持以下参数:
- Children: 绝对定位模式下,用来指定此签批控件的组合子控件
参数样例:
`{"Children":["ComponentId_29","ComponentId_27","ComponentId_28","ComponentId_30"]}`
- ChildrenComponents: 关键字定位模式下,用来指定此签批控件的组合子控件
ChildrenComponent结构体定义:
| 字段名称 | 类型 | 描述 |
| 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;
/**
* **在通过接口拉取控件信息场景下**,为出参参数,此控件是否通过表单域定位方式生成,默认false-不是,**发起合同时候不要填写此字段留空即可**
*/
IsFormType?: boolean;
/**
* 控件填充vaule,ComponentType和传入值类型对应关系:
- TEXT : 文本内容
- MULTI_LINE_TEXT : 文本内容,可以用 \n 来控制换行位置
- CHECK_BOX : true/false
- FILL_IMAGE、ATTACHMENT : 附件的FileId,需要通过UploadFiles接口上传获取
- SELECTOR : 选项值
- DYNAMIC_TABLE - 传入json格式的表格内容,详见说明:[数据表格](https://qian.tencent.com/developers/company/dynamic_table)
- DATE : 格式化为:xxxx年xx月xx日(例如2024年05年28日)
- SIGN_SEAL : 印章ID,于控制台查询获取, [点击查看在控制台上位置](https://qcloudimg.tencent-cloud.cn/raw/f7b0f2ea4a534aada4b893dbf9671eae.png)
- SIGN_PAGING_SEAL : 可以指定印章ID,于控制台查询获取, [点击查看在控制台上位置](https://qcloudimg.tencent-cloud.cn/raw/f7b0f2ea4a534aada4b893dbf9671eae.png)
控件值约束说明:
| 特殊控件 | 填写约束 |
| 企业全称控件 | 企业名称中文字符中文括号 |
| 统一社会信用代码控件 | 企业注册的统一社会信用代码 |
| 法人名称控件 | 最大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;
/**
* **如果控件是关键字定位方式**,可以对关键字定位出来的区域进行横坐标方向的调整,单位为pt(点)。例如,如果关键字定位出来的区域偏左或偏右,可以通过调整横坐标方向的参数来使控件位置更加准确。
注意: `向左调整设置为负数, 向右调整设置成正数`
*/
OffsetX?: number;
/**
* **如果控件是关键字定位方式**,可以对关键字定位出来的区域进行纵坐标方向的调整,单位为pt(点)。例如,如果关键字定位出来的区域偏上或偏下,可以通过调整纵坐标方向的参数来使控件位置更加准确。
注意: `向上调整设置为负数, 向下调整设置成正数`
*/
OffsetY?: number;
/**
* **如果控件是关键字定位方式**,指定关键字排序规则时,可以选择Positive或Reverse两种排序方式。
- Positive :表示正序,即根据关键字在PDF文件内的顺序进行排列
- Reverse :表示倒序,即根据关键字在PDF文件内的反序进行排列
在指定KeywordIndexes时,如果使用Positive排序方式,0代表在PDF内查找内容时,查找到的第一个关键字;如果使用Reverse排序方式,0代表在PDF内查找内容时,查找到的最后一个关键字。
*/
KeywordOrder?: string;
/**
* **如果控件是关键字定位方式**,在KeywordPage中指定关键字页码时,将只会在该页码中查找关键字,非该页码的关键字将不会查询出来。如果不设置查找所有页面中的关键字。
*/
KeywordPage?: number;
/**
* **如果控件是关键字定位方式**,关键字生成的区域的对齐方式, 可以设置下面的值
- Middle :居中
- Below :正下方
- Right :正右方
- LowerRight :右下角
- UpperRight :右上角。
示例:如果设置Middle的关键字盖章,则印章的中心会和关键字的中心重合,如果设置Below,则印章在关键字的正下方
*/
RelativeLocation?: string;
/**
* **如果控件是关键字定位方式**,关键字索引是指在PDF文件中存在多个相同的关键字时,通过索引指定使用哪一个关键字作为最后的结果。可以通过指定多个索引来同时使用多个关键字。例如,[0,2]表示使用PDF文件内第1个和第3个关键字位置作为最后的结果。
注意:关键字索引是从0开始计数的
*/
KeywordIndexes?: Array;
/**
* **web嵌入发起合同场景下**, 是否锁定填写和签署控件值不允许嵌入页面进行编辑
- false(默认):不锁定控件值,允许在页面编辑控件值
- true:锁定控件值,在页面无法编辑控件值
*/
LockComponentValue?: boolean;
/**
* **web嵌入发起合同场景下**,是否禁止移动和删除填写和签署控件
- false(默认) :可以移动和删除控件
- true : 禁止移动和删除控件
*/
ForbidMoveAndDelete?: boolean;
/**
* 【暂未使用】日期签署控件的字号,默认为 12
*/
ComponentDateFontSize?: number;
/**
* 【暂未使用】第三方应用集成平台模板控件 ID 标识
*/
ChannelComponentId?: string;
/**
* 【暂未使用】第三方应用集成中子客企业控件来源。
*/
ChannelComponentSource?: number;
}
/**
* 合同组相关信息,指定合同组子合同和签署方的信息,用于补充动态签署人。
*/
export interface FlowGroupUrlInfo {
/**
* 合同组子合同和签署方的信息,用于补充动态签署人。
*/
FlowGroupApproverInfos?: Array;
}
/**
* 信息提取子任务反馈信息
*/
export interface SubTaskFeedback {
/**
* 信息提取子任务ID
*/
SubTaskId?: string;
/**
* 提取结果反馈信息
*/
FeedbackList?: Array;
}
/**
* UpdateIntegrationEmployees返回参数结构体
*/
export interface UpdateIntegrationEmployeesResponse {
/**
* 更新成功的用户列表
*/
SuccessEmployeeData?: Array;
/**
* 更新失败的用户列表
*/
FailedEmployeeData?: Array;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* ModifyPartnerAutoSignAuthUrl请求参数结构体
*/
export interface ModifyPartnerAutoSignAuthUrlRequest {
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator?: UserInfo;
/**
* 被授企业id/授权方企业id(即OrganizationId),和AuthorizedOrganizationName二选一传入
*/
AuthorizedOrganizationId?: string;
/**
* 被授企业名称/授权方企业的名字,和AuthorizedOrganizationId二选一传入即可。请确认该名称与企业营业执照中注册的名称一致。
注: `如果名称中包含英文括号(),请使用中文括号()代替。`
*/
AuthorizedOrganizationName?: string;
/**
* 在处理授权关系时,授权的方向
- false(默认值):表示我方授权他方。在这种情况下,
AuthorizedOrganizationName 代表的是【被授权方】的企业名称,即接收授权的企业。
- true:表示他方授权我方。在这种情况下,
AuthorizedOrganizationName 代表的是【授权方】的企业名称,即提供授权的企业。
*/
AuthToMe?: boolean;
}
/**
* DescribeInformationExtractionWebUrl返回参数结构体
*/
export interface DescribeInformationExtractionWebUrlResponse {
/**
* 合同信息提取嵌入式web页面链接。
注意:`链接有效期为5分钟,且链接仅能使用一次。`
*/
Url?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateExtendedServiceAuthInfos请求参数结构体
*/
export interface CreateExtendedServiceAuthInfosRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 本企业员工的id,需要已实名,正常在职员工
*/
UserIds: Array;
/**
* 取值
- OPEN_SERVER_SIGN:企业自动签
- BATCH_SIGN:批量签署
*/
ExtendServiceType?: string;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
}
/**
* CreatePrepareFlowGroup返回参数结构体
*/
export interface CreatePrepareFlowGroupResponse {
/**
* 合同(流程)组的合同组Id
*/
FlowGroupId?: string;
/**
* 嵌入式合同组发起链接
*/
PrepareUrl?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateMultiFlowSignQRCode返回参数结构体
*/
export interface CreateMultiFlowSignQRCodeResponse {
/**
* 一码多签签署码的基本信息,用户可扫描该二维码进行签署操作。
*/
QrCode?: SignQrCode;
/**
* 一码多签签署码的链接信息,适用于客户系统整合二维码功能。通过链接,用户可直接访问电子签名小程序并签署合同。
*/
SignUrls?: SignUrl;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DescribeThirdPartyAuthCode返回参数结构体
*/
export interface DescribeThirdPartyAuthCodeResponse {
/**
* AuthCode 中对应个人用户是否实名
- **VERIFIED** : 此个人已实名
- **UNVERIFIED**: 此个人未实名
*/
VerifyStatus?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateBatchInitOrganizationUrl返回参数结构体
*/
export interface CreateBatchInitOrganizationUrlResponse {
/**
* 小程序路径
*/
MiniAppPath?: string;
/**
* 操作长链
*/
OperateLongUrl?: string;
/**
* 操作短链
*/
OperateShortUrl?: string;
/**
* 操作二维码
*/
QRCodeUrl?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* BindEmployeeUserIdWithClientOpenId返回参数结构体
*/
export interface BindEmployeeUserIdWithClientOpenIdResponse {
/**
* 绑定是否成功。
*/
Status?: number;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateOrganizationAuthFile返回参数结构体
*/
export interface CreateOrganizationAuthFileResponse {
/**
* 授权书链接,有效期5分钟。
*/
FileUrl?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 批量签署合同相关信息,指定批量签署合同和签署方的信息,用于补充动态签署人。
*/
export interface FlowBatchApproverInfo {
/**
* 合同流程ID。
*/
FlowId?: string;
/**
* 签署节点ID,用于生成动态签署人链接完成领取。注:`生成动态签署人补充链接时必传。`
*/
RecipientId?: string;
}
/**
* StartFlow返回参数结构体
*/
export interface StartFlowResponse {
/**
* 发起成功后返回的状态,根据合同流程的不同,返回不同状态:
- **START** : 发起成功, 合同进入签署环节
- **REVIEW** : 提交审核成功, 合同需要发起审核, 发起方企业通过接口审核通过后合同才进入签署环境 `白名单功能,使用前请联系对接的客户经理沟通。`
- **EXECUTING** : 已提交发起任务且PDF合同正在合成中, 等PDF合同合成成功后进入签署环节
*/
Status?: string;
/**
* 发起审批流id,仅在CreateFlow时指定了WorkFlow=true时返回
*/
WorkflowInstanceId?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DescribeRiskIdentificationTaskFeedback返回参数结构体
*/
export interface DescribeRiskIdentificationTaskFeedbackResponse {
/**
* 合同审查任务反馈信息列表
*/
FeedbackList?: Array;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 签署控件的配置信息,用在嵌入式发起的页面配置,包括
- 签署控件是否默认展示日期.
*/
export interface SignComponentConfig {
/**
* 签署控件默认属性配置,是否默认展示签署日期, 在页面中可以进行修改。
- false 展示签署日期(默认)
- true 不展示签署日期
。
*/
HideDate?: boolean;
}
/**
* DescribeInformationExtractionWebUrl请求参数结构体
*/
export interface DescribeInformationExtractionWebUrlRequest {
/**
* 执行本接口操作的员工信息。使用此接口时,必须填写userId。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 合同信息提取任务ID,该参数可通过回调事件[回调通知](https://qian.tencent.com/developers/company/callback_types_v2)获取或者从控制台信息提取任务列表获取。
注意:`不填写任务ID时返回信息提取任务列表URL,填写任务ID时返回信息提取任务详情URL`
*/
TaskId?: string;
}
/**
* DescribeFlowComponents返回参数结构体
*/
export interface DescribeFlowComponentsResponse {
/**
* 合同流程关联的填写控件信息,包括填写控件的归属方以及是否填写等内容。
*/
RecipientComponentInfos?: Array;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DescribeContractReviewWebUrl返回参数结构体
*/
export interface DescribeContractReviewWebUrlResponse {
/**
* 合同审查嵌入式web页面链接。
注意:`链接有效期为5分钟,且链接仅能使用一次。如果上传的合同文件为word时不能进行iframe方式嵌入到贵方系统的网页中,需要单独页面打开此链接显示`
*/
WebUrl?: string;
/**
* 合同审查任务状态。任务状态为`5`时没有WebUrl链接。
状态如下:
- **1** - 合同审查任务创建成功
- **2** - 合同审查任务排队中
- **3** - 合同审查任务执行中
- **4** - 合同审查任务执行成功
- **5** - 合同审查任务执行失败
*/
Status?: number;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 撤销失败的流程信息
*/
export interface CancelFailureFlow {
/**
* 合同流程ID,为32位字符串。
*/
FlowId?: string;
/**
* 撤销失败原因
*/
Reason?: string;
}
/**
* DescribeIntegrationEmployees请求参数结构体
*/
export interface DescribeIntegrationEmployeesRequest {
/**
* 执行本接口操作的员工信息。使用此接口时,必须填写UserId。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 指定分页每页返回的数据条数,单页最大支持 20。
*/
Limit?: number;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 查询的关键字段,支持Key-Values查询。可选键值如下:
- Key:**"Status"**,根据实名状态查询员工,Values可选:
- **["IsVerified"]**:查询已实名的员工
- **["NotVerified"]**:查询未实名的员工
- Key:**"DepartmentId"**,根据部门ID查询部门下的员工,Values为指定的部门ID:**["DepartmentId"]**
- Key:**"UserId"**,根据用户ID查询员工,Values为指定的用户ID:**["UserId"]**
- Key:**"UserWeWorkOpenId"**,根据用户企微账号ID查询员工,Values为指定用户的企微账号ID:**["UserWeWorkOpenId"]**
- Key:**"StaffOpenId"**,根据第三方系统用户OpenId查询员工,Values为第三方系统用户OpenId列表:**["OpenId1","OpenId2",...]**
- Key:**"RoleId"**,根据电子签角色ID查询员工,Values为指定的角色ID,满足其中任意一个角色即可:**["RoleId1","RoleId2",...]**
*/
Filters?: Array;
/**
* 偏移量,默认为0,最大20000。关于Offset的更进一步介绍请参考 API 简介中的相关小节。
*/
Offset?: number;
}
/**
* DescribeContractReviewTaskListWebUrl返回参数结构体
*/
export interface DescribeContractReviewTaskListWebUrlResponse {
/**
* 嵌入式web页面链接。注意:`链接有效期为5分钟,且链接仅能使用一次。`
*/
WebUrl?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateFlow请求参数结构体
*/
export interface CreateFlowRequest {
/**
* 本合同的发起人,点击查看合同发起人展示的位置
注: 支持填入集团子公司经办人 userId 代发合同。
*/
Operator: UserInfo;
/**
* 自定义的合同流程的名称,长度不能超过200个字符,只能由中文汉字、中文标点、英文字母、阿拉伯数字、空格、小括号、中括号、中划线、下划线以及(,)、(;)、(.)、(&)、(+)组成。
该名称还将用于合同签署完成后文件下载的默认文件名称。
*/
FlowName: string;
/**
* 合同流程的参与方列表,最多可支持50个参与方,可在列表中指定企业B端签署方和个人C端签署方的联系和认证方式等信息,具体定义可以参考开发者中心的ApproverInfo结构体。
注:
在发起流程时,需要保证 approver 中的顺序与模板定义顺序一致,否则会发起失败。
例如,如果模板中定义的第一个参与人是个人用户,第二个参与人是企业员工,则在 approver 中传参时,第一个也必须是个人用户,第二个参与人必须是企业员工。
[点击查看模板参与人顺序定义位置](https://qcloudimg.tencent-cloud.cn/raw/d14457b48cc66b29262ccb9d7b3ed556.png)
*/
Approvers: Array;
/**
* 合同流程描述信息(可自定义此描述),最大长度1000个字符。
*/
FlowDescription?: string;
/**
* 合同流程的类别分类(可自定义名称,如销售合同/入职合同等),最大长度为200个字符,仅限中文、字母、数字和下划线组成。
此合同类型需要跟模板配置的合同类型保持一致。
*/
FlowType?: string;
/**
* 该字段已不再使用
*/
ClientToken?: string;
/**
* 合同流程的签署截止时间,格式为Unix标准时间戳(秒),如果未设置签署截止时间,则默认为合同流程创建后的365天时截止。
如果在签署截止时间前未完成签署,则合同状态会变为已过期,导致合同作废。
*/
DeadLine?: number;
/**
* 合同到期提醒时间,为Unix标准时间戳(秒)格式,支持的范围是从发起时间开始到后10年内。
到达提醒时间后,腾讯电子签会短信通知发起方企业合同提醒,可用于处理合同到期事务,如合同续签等事宜。
*/
RemindedOn?: number;
/**
* 调用方自定义的个性化字段(可自定义此名称),并以base64格式编码,支持的最大数据大小为 20480长度。
在合同状态变更的回调信息等场景中,该字段的信息将原封不动地透传给贵方。回调的相关说明可参考开发者中心的回调通知模块。
*/
UserData?: string;
/**
* 合同流程的签署顺序类型:
- **false**:(默认)有序签署, 本合同多个参与人需要依次签署
- **true**:无序签署, 本合同多个参与人没有先后签署限制
注:`请和模板中的配置保持一致`
*/
Unordered?: boolean;
/**
* 您可以自定义**腾讯电子签小程序合同列表页**展示的合同内容模板,模板中支持以下变量:
- {合同名称}
- {发起方企业}
- {发起方姓名}
- {签署方N企业}
- {签署方N姓名}
其中,N表示签署方的编号,从1开始,不能超过签署人的数量。
例如,如果是腾讯公司张三发给李四名称为“租房合同”的合同,您可以将此字段设置为:`合同名称:{合同名称};发起方: {发起方企业}({发起方姓名});签署方:{签署方1姓名}`,则小程序中列表页展示此合同为以下样子
合同名称:租房合同
发起方:腾讯公司(张三)
签署方:李四

*/
CustomShowMap?: string;
/**
* 发起方企业的签署人进行签署操作前,是否需要企业内部走审批流程,取值如下:
- **false**:(默认)不需要审批,直接签署。
- **true**:需要走审批流程。当到对应参与人签署时,会阻塞其签署操作,等待企业内部审批完成。
企业可以通过CreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果
- 如果企业通知腾讯电子签平台审核通过,签署方可继续签署动作。
- 如果企业通知腾讯电子签平台审核未通过,平台将继续阻塞签署方的签署动作,直到企业通知平台审核通过。
注:`此功能可用于与企业内部的审批流程进行关联,支持手动、静默签署合同`
*/
NeedSignReview?: boolean;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 合同流程的抄送人列表,最多可支持50个抄送人,抄送人可查看合同内容及签署进度,但无需参与合同签署。
注
1. 抄送人名单中可以包括自然人以及本企业的员工。
2. 请确保抄送人列表中的成员不与任何签署人重复。
*/
CcInfos?: Array;
/**
* 个人自动签名的使用场景包括以下, 个人自动签署(即ApproverType设置成个人自动签署时)业务此值必传:
- **E_PRESCRIPTION_AUTO_SIGN**:电子处方单(医疗自动签)
- **OTHER** : 通用场景
注: `个人自动签名场景是白名单功能,使用前请与对接的客户经理联系沟通。`
*/
AutoSignScene?: string;
/**
* 暂未开放
* @deprecated
*/
RelatedFlowId?: string;
/**
* 暂未开放
* @deprecated
*/
CallbackUrl?: string;
/**
* 在短信通知、填写、签署流程中,若标题、按钮、合同详情等地方存在“合同”字样时,可根据此配置指定文案,可选文案如下:
- 0 :合同(默认值)
- 1 :文件
- 2 :协议
- 3 :文书
效果如下:

*/
FlowDisplayType?: number;
/**
* 是否开启发起合同审批,默认:false(不开启),开启后,发起合同(StartFlow),会提交电子签内置的审批流
*/
Workflow?: boolean;
}
/**
* 下载文件的URL信息
*/
export interface FileUrl {
/**
* 下载文件的URL,有效期为输入的UrlTtl,默认5分钟
*/
Url: string;
/**
* 下载文件的附加信息。如果是pdf文件,会返回pdf文件每页的有效高宽
*/
Option: string;
}
/**
* CreateContractReviewWebUrl请求参数结构体
*/
export interface CreateContractReviewWebUrlRequest {
/**
* 执行本接口操作的员工信息。使用此接口时,必须填写userId。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 需要审查的合同文件资源ID,可通过UploadFiles接口获取文件资源ID。
注: `目前,每个文件限制在10M以下,文件仅支持pdf、doc、docx格式`
*/
ResourceId?: string;
/**
* 调用方自定义的个性化字段(可自定义此名称),并以base64方式编码,支持的最大数据大小为 1024长度。
在合同状态变更的回调信息等场景中,该字段的信息将原封不动地透传给贵方。回调的相关说明可参考开发者中心的[回调通知](https://qian.tencent.com/developers/company/callback_types_v2)模块。
*/
UserData?: string;
/**
* 个性化参数,用于控制页面展示内容
*/
Option?: ContractReviewWebUrlOption;
}
/**
* CreateDynamicFlowApprover返回参数结构体
*/
export interface CreateDynamicFlowApproverResponse {
/**
* 合同流程ID,为32位字符串
*/
FlowId?: string;
/**
* 补充动态合同签署人的结果数组
*/
DynamicFlowApproverList?: Array;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateBatchOrganizationRegistrationTasks返回参数结构体
*/
export interface CreateBatchOrganizationRegistrationTasksResponse {
/**
* 生成注册链接的任务Id,
根据这个id, 调用DescribeBatchOrganizationRegistrationUrls 获取生成的链接,进入认证流程
*/
TaskId?: string;
/**
* 批量生成企业认证链接的详细错误信息,
顺序与输入参数保持一致。
若企业认证均成功生成,则不返回错误信息;
若存在任何错误,则返回具体的错误描述。
*/
ErrorMessages?: Array;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 业务逻辑个性化配置字段,默认不传
注: `配置前请联系对接的客户经理沟通确认。`
*/
export interface Option {
/**
* 个性化配置参数Key字段,对应传入字段的字段名
*/
Key: string;
/**
* 个性化配置参数Value字段,对应传入字段的字段值
*/
Value: string;
}
/**
* DescribeOrganizationSeals返回参数结构体
*/
export interface DescribeOrganizationSealsResponse {
/**
* 在设定了SealId时,返回值为0或1;若未设定SealId,则返回公司的总印章数量
*/
TotalCount?: number;
/**
* 查询到的印章结果数组
*/
Seals?: Array;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DescribeBillUsageDetail请求参数结构体
*/
export interface DescribeBillUsageDetailRequest {
/**
* 查询开始时间字符串,格式为yyyymmdd,时间跨度不能大于31天
*/
StartTime: string;
/**
* 查询结束时间字符串,格式为yyyymmdd,时间跨度不能大于31天
*/
EndTime: string;
/**
* 指定分页返回第几页的数据,如果不传默认返回第一页,页码从 0 开始,即首页为 0
*/
Offset?: number;
/**
* 指定分页每页返回的数据条数,如果不传默认为 50,单页最大支持 50。
*/
Limit?: number;
/**
* 查询的套餐类型 (选填 )不传则查询所有套餐;
目前支持:
- **CloudEnterprise**: 企业版合同
- **SingleSignature**: 单方签章
- **CloudProve**: 签署报告
- **CloudOnlineSign**: 腾讯会议在线签约
- **ChannelWeCard**: 微工卡
- **SignFlow**: 合同套餐
- **SignFace**: 签署意愿(人脸识别)
- **SignPassword**: 签署意愿(密码)
- **SignSMS**: 签署意愿(短信)
- **PersonalEssAuth**: 签署人实名(腾讯电子签认证)
- **PersonalThirdAuth**: 签署人实名(信任第三方认证)
- **OrgEssAuth**: 签署企业实名
- **FlowNotify**: 短信通知
- **AuthService**: 企业工商信息查询
- **NoAuthSign**: 形式签
*/
QuotaType?: string;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
}
/**
* 信息提取任务反馈信息列表
*/
export interface FeedbackList {
/**
* 信息提取结果字段ID
*/
Id?: string;
/**
* 反馈信息
*/
Info?: FeedbackInfo;
}
/**
* CreateBatchAdminChangeInvitationsUrl请求参数结构体
*/
export interface CreateBatchAdminChangeInvitationsUrlRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 组织机构要变更的超管姓名。 在超管变更流程中,必须是超管本人进行操作,需要更当前操作人的姓名保持一致。
*/
NewAdminName: string;
/**
* 组织机构要变更的超管手机号。
在超管变更流程中,必须是超管本人进行操作,需要更当前操作人的手机号保持一致。
超管手机号 和超管证件号 二选一 必填。
注意:
1. 如果新超管的个人身份在电子签进行了手机号的变更,之前提交的超管变更任务将无法获取。
*/
NewAdminMobile?: string;
/**
* 组织机构要变更的超管证件类型支持以下类型
- ID_CARD : 中国大陆居民身份证 (默认值)
- HONGKONG_AND_MACAO : 中国港澳居民来往内地通行证
- HONGKONG_MACAO_AND_TAIWAN : 中国港澳台居民居住证(格式同中国大陆居民身份证)
需要更当前操作人的证件类型保持一致。
*/
NewAdminIdCardType?: string;
/**
* 组织机构要变更的超管证件号。
在超管变更流程中,必须是超管本人进行操作,需要更当前操作人的证件号保持一致。
超管手机号和超管证件号 二选一必填。
*/
NewAdminIdCardNumber?: string;
/**
* 通知方式。
NONE(默认)
SMS - 如果使用这个方式,则会给即将变更的超管发信息。
注意:
发送信息的手机号,是用户传递的手机号。
如果用户同时传递了证件号,手机号会被用户在电子签注册的手机号进行覆盖。
*/
NotifyType?: string;
/**
* 要跳转的链接类型
- **HTTP**:跳转电子签小程序的http_url,短信通知或者H5跳转适合此类型 ,此时返回长链 (默认类型)。
- **HTTP_SHORT_URL**:跳转电子签小程序的http_url,短信通知或者H5跳转适合此类型,此时返回短链。
- **APP**: 第三方APP或小程序跳转电子签小程序的path,APP或者小程序跳转适合此类型。
- **QR_CODE**: 跳转电子签小程序的http_url的二维码形式,可以在页面展示适合此类型。
*/
Endpoint?: string;
}
/**
* CreateUserAutoSignSealUrl返回参数结构体
*/
export interface CreateUserAutoSignSealUrlResponse {
/**
* 腾讯电子签小程序的AppId,用于其他小程序/APP等应用跳转至腾讯电子签小程序使用。
*/
AppId?: string;
/**
* 腾讯电子签小程序的原始Id,用于其他小程序/APP等应用跳转至腾讯电子签小程序使用。
*/
AppOriginalId?: string;
/**
* 个人用户自动签的开通链接, 短链形式。过期时间受 `ExpiredTime` 参数控制。
*/
Url?: string;
/**
* 腾讯电子签小程序的跳转路径,用于其他小程序/APP等应用跳转至腾讯电子签小程序使用。
*/
Path?: string;
/**
* base64格式的跳转二维码图片,可通过微信扫描后跳转到腾讯电子签小程序的开通界面。
*/
QrCode?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 持有的电子印章信息
*/
export interface OccupiedSeal {
/**
* 电子印章编号
*/
SealId?: string;
/**
* 电子印章名称
*/
SealName?: string;
/**
* 电子印章授权时间戳,单位秒
*/
CreateOn?: number;
/**
* 电子印章授权人的UserId
*/
Creator?: string;
/**
* 电子印章策略Id
*/
SealPolicyId?: string;
/**
* 印章状态,有以下六种:CHECKING(审核中)SUCCESS(已启用)FAIL(审核拒绝)CHECKING-SADM(待超管审核)DISABLE(已停用)STOPPED(已终止)
*/
SealStatus?: string;
/**
* 审核失败原因
*/
FailReason?: string;
/**
* 印章图片url,5分钟内有效
*/
Url?: string;
/**
* 印章类型,OFFICIAL-企业公章, CONTRACT-合同专用章,ORGANIZATIONSEAL-企业印章(本地上传印章类型),LEGAL_PERSON_SEAL-法人印章
*/
SealType?: string;
/**
* 用印申请是否为永久授权,true-是,false-否
*/
IsAllTime?: boolean;
/**
* 授权人列表
*/
AuthorizedUsers?: Array;
/**
* 印章扩展数据信息
*/
ExtendScene?: ExtendScene;
/**
* 印章的真实宽度,单位毫米
*/
RealWidth?: number;
/**
* 印章的真实高度,单位毫米
*/
RealHeight?: number;
/**
* 自定义子类型印章
*/
SubSealType?: string;
/**
* 自定义子类型印章名称
*/
SubSealName?: string;
/**
* 印章描述
*/
SealDescription?: string;
}
/**
* 意愿核身点头确认模式结果详细数据
*/
export interface IntentionActionResultDetail {
/**
* 视频base64编码(其中包含全程提示文本和点头音频,mp4格式)
*/
Video?: string;
}
/**
* CreateEmployeeQualificationSealQrCode请求参数结构体
*/
export interface CreateEmployeeQualificationSealQrCodeRequest {
/**
* 执行本接口操作的员工信息。使用此接口时,必须填写userId。 支持填入集团子公司经办人 userId 代发合同。 注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 代理企业和员工的信息。 在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 提示信息,扫码后此信息会展示给扫描用户,用来提示用户授权操作的目的,会在授权界面下面的位置展示。

*/
HintText?: string;
/**
* 调用方自定义的个性化字段(可自定义此名称),并以base64方式编码,支持的最大数据大小为 2000长度。在执业章授权完成后的回调场景,该字段的信息将原封不动地透传给贵方。回调的相关说明可参考开发者中心的回调通知模块。
*/
UserData?: string;
}
/**
* 删除员工失败数据
*/
export interface FailedDeleteStaffData {
/**
* 员工在电子签的userId
*/
UserId?: string;
/**
* 员工在第三方平台的openId
*/
OpenId?: string;
/**
* 失败原因
*/
Reason?: string;
}
/**
* DescribeInformationExtractionTask返回参数结构体
*/
export interface DescribeInformationExtractionTaskResponse {
/**
* 合同信息提取字段信息
*/
Fields?: Array;
/**
* 合同智能提取任务状态。
状态如下:
- **0** - 任务创建成功(还未执行)
- **1** - 排队中(等待执行)
- **2** - 提取中(正在执行)
- **3** - 提取成功
- **4** - 提取失败
*/
Status?: number;
/**
* 合同智能提取结果下载,文件格式为`xlsx`。
注意:`链接有效期为5分钟,过期后可重新获取`
*/
Url?: string;
/**
* 合同信息提取结果信息
*/
Results?: Array;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 合同审查任务识别出的风险结果信息
*/
export interface OutputRisk {
/**
* 合同审查风险结果ID
*/
RiskId?: string;
/**
* 风险名称
*/
RiskName?: string;
/**
* 风险描述
*/
RiskDescription?: string;
/**
* 风险等级别名。
等级描述如下:
- **HIGH** - 高风险
- **NORMAL** - 风险
*/
RiskLevel?: string;
/**
* 风险建议
*/
RiskAdvice?: string;
/**
* 风险评估
*/
RiskPresentation?: Array;
/**
* PDF风险原文内容
*/
Content?: string;
/**
* 审查出的PDF段落位置信息
*/
Positions?: Array;
/**
* 是否已修订
*/
IsMark?: boolean;
/**
* 是否已忽略
*/
IsIgnore?: boolean;
/**
* 审查依据
*/
RiskBasis?: string;
/**
* 风险等级id。1 为最高风险等级,0 为最低风险等级,从[2,n]数字越大风险等级逐渐降低。
*/
RiskLevelId?: number;
/**
* 风险标签
*/
RiskLabels?: Array;
/**
* 风险来源 0:模型标注的风险 1:人工标注的风险
*/
RiskOrigin?: number;
/**
* 创建人
*/
Creator?: string;
/**
* 创建人ID
*/
CreatorId?: string;
/**
* 创建时间
*/
CreatedOn?: number;
/**
* 风险等级别名
*/
RiskLevelAliasName?: string;
}
/**
* CreateEmployeeChangeUrl返回参数结构体
*/
export interface CreateEmployeeChangeUrlResponse {
/**
* 修改员工信息的小程序链接
跳转到腾讯电子签小程序的实现可以参考微信的官方文档:开放能力/打开 App
*/
MiniAppPath?: string;
/**
* 链接过期时间以 Unix 时间戳格式表示,从生成链接时间起,往后7天有效期。过期后短链将失效,无法打开。
*/
ExpireTime?: number;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateConvertTaskApi返回参数结构体
*/
export interface CreateConvertTaskApiResponse {
/**
* 接口返回的文件转换任务Id,可以调用接口查询转换任务状态获取转换任务的状态和转换后的文件资源Id。
*/
TaskId?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateFlowSignReview请求参数结构体
*/
export interface CreateFlowSignReviewRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 合同流程ID,为32位字符串。
- 建议开发者妥善保存此流程ID,以便于顺利进行后续操作。
- 可登录腾讯电子签控制台,在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
*/
FlowId: string;
/**
* 企业内部审核结果
- PASS: 审核通过
- REJECT: 审核拒绝
- SIGN_REJECT:拒签(流程结束)
*/
ReviewType: string;
/**
* 代理相关应用信息,如集团主企业代子企业操作的场景中ProxyOrganizationId必填
*/
Agent?: Agent;
/**
* 审核节点的签署人标志,用于指定当前审核的签署方
*/
RecipientId?: string;
/**
* 操作类型:(接口通过该字段区分不同的操作类型)
- SignReview: 签署审核(默认)
- CreateReview: 创建审核
如果审核节点是个人,则操作类型只能为SignReview。
*/
OperateType?: string;
/**
* 审核结果原因
- 字符串长度不超过200
- 当ReviewType 是拒绝(REJECT) 时此字段必填。
- 当ReviewType 是拒绝(SIGN_REJECT) 时此字段必填。
*/
ReviewMessage?: string;
}
/**
* CreateOrganizationAuthUrl返回参数结构体
*/
export interface CreateOrganizationAuthUrlResponse {
/**
* 生成的认证链接。
注: `链接有效期统一30天`
*/
AuthUrl?: string;
/**
* 链接过期时间,格式为Unix标准时间戳(秒)
*/
ExpiredTime?: number;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DescribeOrganizationAuthStatus请求参数结构体
*/
export interface DescribeOrganizationAuthStatusRequest {
/**
* 执行本接口操作的员工信息。使用此接口时,必须填写userId。 支持填入集团子公司经办人 userId 代发合同。 注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 组织机构名称。 请确认该名称与企业营业执照中注册的名称一致。 如果名称中包含英文括号(),请使用中文括号()代替。
*/
OrganizationName?: string;
/**
* 企业统一社会信用代码
注意:OrganizationName和UniformSocialCreditCode不能同时为空
*/
UniformSocialCreditCode?: string;
/**
* 法人姓名
*/
LegalName?: string;
}
/**
* CreateUserAutoSignSealUrl请求参数结构体
*/
export interface CreateUserAutoSignSealUrlRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 自动签使用的场景值, 可以选择的场景值如下:
- **E_PRESCRIPTION_AUTO_SIGN** : 电子处方场景
- **OTHER** : 通用场景
*/
SceneKey: string;
/**
* 自动签开通个人用户信息, 包括名字,身份证等。
*/
UserInfo: UserThreeFactor;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 链接的过期时间,格式为Unix时间戳,不能早于当前时间,且最大为当前时间往后30天。`如果不传,默认过期时间为当前时间往后7天。`
*/
ExpiredTime?: number;
}
/**
* ModifyFlowDeadline请求参数结构体
*/
export interface ModifyFlowDeadlineRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 合同流程ID,为32位字符串。
- 建议开发者妥善保存此流程ID,以便于顺利进行后续操作。
- 可登录腾讯电子签控制台,在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
*/
FlowId: string;
/**
* 签署流程或签署人新的签署截止时间,格式为Unix标准时间戳(秒)
*/
Deadline: number;
/**
* 代理相关应用信息,如集团主企业代子企业操作的场景中ProxyOrganizationId必填
*/
Agent?: Agent;
/**
* 签署方角色编号,为32位字符串
- 若指定了此参数,则只调整签署流程中此签署人的签署截止时间,否则调整合同整体的签署截止时间(合同截止时间+发起时未设置签署人截止时间的参与人的签署截止时间)
- 通过[用PDF文件创建签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlowByFiles)发起合同,或通过[模板发起合同-创建电子文档](https://qian.tencent.com/developers/companyApis/startFlows/CreateDocument)时,返回参数[Approvers](https://qian.tencent.com/developers/companyApis/dataTypes/#approveritem)会返回此信息,建议开发者妥善保存
- 也可通过[查询合同流程的详情信息](https://qian.tencent.com/developers/companyApis/queryFlows/DescribeFlowInfo)接口查询签署人的RecipientId编号
*/
RecipientId?: string;
}
/**
* CreateFlowApprovers请求参数结构体
*/
export interface CreateFlowApproversRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 补充签署环节签署候选人信息。
注:` 如果发起方指定的补充签署人是企业微信签署人(ApproverSource=WEWORKAPP),则需要提供企业微信UserId进行补充; 如果不指定,则使用姓名和手机号进行补充。`
*/
Approvers: Array;
/**
* 合同流程ID,为32位字符串。
- 建议开发者妥善保存此流程ID,以便于顺利进行后续操作。
- 可登录腾讯电子签控制台,在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
- 不建议继续使用,请使用补充签署人结构体中的FlowId来指定需要补充的合同id
*/
FlowId?: string;
/**
* 签署人信息补充方式
- **0**: 或签合同添加签署候选人,或签支持一个节点传多个签署人,不传值默认或签。
注: `或签只支持企业签署方`
- **1**: 动态签署人合同的添加签署候选人,支持企业或个人签署方。
*/
FillApproverType?: number;
/**
* 在可定制的企业微信通知中,发起人可以根据具体需求进行自定义设置。
*/
Initiator?: string;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 合同流程组的组ID, 在合同流程组场景下,生成合同流程组的签署链接时需要赋值
*/
FlowGroupId?: string;
}
/**
* 扩展服务开通和授权的详细信息
*/
export interface ExtendAuthInfo {
/**
* 扩展服务的类型,可能是以下值:
- OPEN_SERVER_SIGN:企业自动签署
- BATCH_SIGN:批量签署
- OVERSEA_SIGN:企业与港澳台居民签署合同
- AGE_LIMIT_EXPANSION:拓宽签署方年龄限制
- MOBILE_CHECK_APPROVER:个人签署方仅校验手机号
- HIDE_OPERATOR_DISPLAY:隐藏合同经办人姓名
- ORGANIZATION_OCR_FALLBACK:正楷临摹签名失败后更换其他签名类型
- ORGANIZATION_FLOW_NOTIFY_TYPE:短信通知签署方
- HIDE_ONE_KEY_SIGN:个人签署方手动签字
- PAGING_SEAL:骑缝章
- ORGANIZATION_FLOW_PASSWD_NOTIFY:签署密码开通引导
*/
Type?: string;
/**
* 扩展服务的名称
*/
Name?: string;
/**
* 扩展服务的开通状态:
- ENABLE : 已开通
- DISABLE : 未开通
*/
Status?: string;
/**
* 操作扩展服务的操作人UserId,员工在腾讯电子签平台的唯一身份标识,为32位字符串。
*/
OperatorUserId?: string;
/**
* 扩展服务的操作时间,格式为Unix标准时间戳(秒)。
*/
OperateOn?: number;
/**
* 该扩展服务若可以授权,此参数对应授权人员的列表
*/
HasAuthUserList?: Array;
}
/**
* CreatePreparedPersonalEsign请求参数结构体
*/
export interface CreatePreparedPersonalEsignRequest {
/**
* 个人用户姓名
*/
UserName: string;
/**
* 证件号码,应符合以下规则
- 中国大陆居民身份证号码应为18位字符串,由数字和大写字母X组成(如存在X,请大写)。
- 中国港澳居民来往内地通行证号码共11位。第1位为字母,“H”字头签发给中国香港居民,“M”字头签发给中国澳门居民;第2位至第11位为数字。。
- 中国港澳台居民居住证号码编码规则与中国大陆身份证相同,应为18位字符串。
*/
IdCardNumber: string;
/**
* 印章名称,长度1-50个字。
*/
SealName: string;
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator?: UserInfo;
/**
* 证件类型,支持以下类型
- ID_CARD : 中国大陆居民身份证 (默认值)
- HONGKONG_AND_MACAO : 中国港澳居民来往内地通行证
- HONGKONG_MACAO_AND_TAIWAN : 中国港澳台居民居住证(格式同 中国大陆居民身份证)
*/
IdCardType?: string;
/**
* 该字段已不再使用
* @deprecated
*/
SealImage?: string;
/**
* 是否开启印章图片压缩处理,默认不开启,如需开启请设置为 true。当印章超过 2M 时建议开启,开启后图片的 hash 将发生变化。
*/
SealImageCompress?: boolean;
/**
* 手机号码;当需要开通自动签时,该参数必传
*/
Mobile?: string;
/**
* 该字段已不再使用
*/
EnableAutoSign?: boolean;
/**
* 印章颜色(参数ProcessSeal=true时生效)
默认值:BLACK黑色
取值:
BLACK 黑色,
RED 红色,
BLUE 蓝色。
*/
SealColor?: string;
/**
* 是否处理印章,默认不做印章处理。
取值如下:
- false:不做任何处理;
- true:做透明化处理和颜色增强。
*/
ProcessSeal?: boolean;
/**
* 印章图片文件 id
取值:
填写的FileId通过UploadFiles接口上传文件获取。
*/
FileId?: string;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 设置用户开通自动签时是否绑定个人自动签账号许可。一旦绑定后,将扣减购买的个人自动签账号许可一次(1年有效期),不可解绑释放。不传默认为绑定自动签账号许可。 0-绑定个人自动签账号许可,开通后将扣减购买的个人自动签账号许可一次 1-不绑定,发起合同时将按标准合同套餐进行扣减
*/
LicenseType?: number;
/**
* 自动签使用的场景值, 可以选择的场景值如下:
- **E_PRESCRIPTION_AUTO_SIGN** : 电子处方场景
- **OTHER** : 通用场景
注: `不传默认为处方单场景,即E_PRESCRIPTION_AUTO_SIGN`
*/
SceneKey?: string;
}
/**
* CreateMiniAppPrepareFlow请求参数结构体
*/
export interface CreateMiniAppPrepareFlowRequest {
/**
* 执行本接口操作的员工信息。使用此接口时,必须填写userId。
支持填入集团子公司经办人 userId 代发合同。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 资源类型,取值有:
*/
ResourceType: number;
/**
* 资源id,与ResourceType相对应,取值范围:
- 文件Id(通过UploadFiles获取文件资源Id)
- 模板Id(通过控制台创建模板后获取模板Id)
注意:需要同时设置 ResourceType 参数指定资源类型
*/
ResourceId: string;
/**
* 自定义的合同流程的名称,长度不能超过200个字符,只能由中文汉字、中文标点、英文字母、阿拉伯数字、空格、小括号、中括号、中划线、下划线以及(,)、(;)、(.)、(&)、(+)组成。
该名称还将用于合同签署完成后文件下载的默认文件名称。
*/
FlowName: string;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 合同流程的参与方列表,最多可支持50个参与方,可在列表中指定企业B端签署方和个人C端签署方的联系和认证方式等信息。
*/
Approvers?: Array;
/**
* 合同流程的抄送人列表,最多可支持50个抄送人,抄送人可查看合同内容及签署进度,但无需参与合同签署。
**注:暂不支持通过NotifyType参数控制抄送人通知方式**
*/
CcInfos?: Array;
/**
* 合同流程的签署顺序类型:
- **false**:(默认)有序签署, 本合同多个参与人需要依次签署
- **true**:无序签署, 本合同多个参与人没有先后签署限制
**注:仅在文件发起模式下设置有效,模板发起以模板配置为准**
*/
Unordered?: boolean;
/**
* 合同发起后经过多少天截止(1-30天可选),默认7天
*/
DeadlineAfterStartDays?: number;
/**
* 用户自定义合同类型Id 该id为电子签企业内的合同类型id, 可以在控制台-合同-自定义合同类型处获取
*/
UserFlowTypeId?: string;
/**
* 发起合同个性化参数
用于满足小程序合同创建的个性化要求
具体定制化内容详见数据接口说明
*/
FlowOption?: MiniAppCreateFlowOption;
/**
* 发起合同小程序页面个性化参数
用于满足小程序合同创建页面的个性化要求 具体定制化内容详见数据接口说明
*/
PageOption?: MiniAppCreateFlowPageOption;
/**
* 调用方自定义的个性化字段(可自定义此名称),并以base64方式编码,支持的最大数据大小为 1000 长度。
在合同状态变更的回调信息等场景中,该字段的信息将原封不动地透传给贵方。回调的相关说明可参考开发者中心的回调通知模块。
*/
UserData?: string;
/**
* 生成的签署链接在签署页面隐藏的按钮列表,可设置如下:
- **0** :合同签署页面更多操作按钮
- **1** :合同签署页面更多操作的拒绝签署按钮
- **2** :合同签署页面更多操作的转他人处理按钮
- **3** :签署成功页的查看详情按钮
- **4** :合同签署页面更多操作的查看合同基本信息按钮
- **5** :合同签署页面更多操作的撤销按钮
注: `字段为数组, 可以传值隐藏多个按钮`
*/
Hides?: Array;
}
/**
* CreateIntegrationDepartment请求参数结构体
*/
export interface CreateIntegrationDepartmentRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得组织架构管理权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 部门名称,最大长度为50个字符。
*/
DeptName: string;
/**
* 代理企业和员工的信息。 在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 电子签父部门ID。
注:`如果同时指定了ParentDeptId与ParentDeptOpenId参数,系统将优先使用ParentDeptId。当二者都未指定时,创建的新部门将自动填充至根节点部门下。`
*/
ParentDeptId?: string;
/**
* 第三方平台中父部门ID。
注:`如果同时指定了ParentDeptId与ParentDeptOpenId参数,系统将优先使用ParentDeptId。当二者都未指定时,创建的新部门将自动填充至根节点部门下。`
*/
ParentDeptOpenId?: string;
/**
* 客户系统部门ID,最大长度为64个字符。
*/
DeptOpenId?: string;
/**
* 排序号,支持设置的数值范围为1~30000。同一父部门下,排序号越大,部门顺序越靠前。
*/
OrderNo?: number;
}
/**
* DescribeUserVerifyStatus请求参数结构体
*/
export interface DescribeUserVerifyStatusRequest {
/**
* 用户信息
*/
Operator: UserInfo;
/**
* 姓名
*/
Name: string;
/**
* 证件号码,应符合以下规则
- 中国大陆居民身份证号码应为18位字符串,由数字和大写字母X组成(如存在X,请大写)。
- 中国港澳居民来往内地通行证号码共11位。第1位为字母,“H”字头签发给中国香港居民,“M”字头签发给中国澳门居民;第2位至第11位为数字。
- 中国港澳台居民居住证号码编码规则与中国大陆身份证相同,应为18位字符串。
*/
IdCardNumber: string;
/**
* 证件类型,支持以下类型
- ID_CARD : 中国大陆居民身份证 (默认值)
- HONGKONG_AND_MACAO : 中国港澳居民来往内地通行证
- HONGKONG_MACAO_AND_TAIWAN : 中国港澳台居民居住证(格式同中国大陆居民身份证)
*/
IdCardType: string;
}
/**
* 授权用户
*/
export interface AuthorizedUser {
/**
* 电子签系统中的用户id
*/
UserId?: string;
}
/**
* 视频核身意图配置,可指定问答模式或者点头模式的语音文本。
注: `视频认证为白名单功能,使用前请联系对接的客户经理沟通。`
*/
export interface Intention {
/**
* 视频认证类型,支持以下类型
注: `视频认证为白名单功能,使用前请联系对接的客户经理沟通。`
*/
IntentionType?: number;
/**
* 意愿核身语音问答模式(即语音播报+语音回答)使用的文案,包括:系统语音播报的文本、需要核验的标准文本。支持传入1~10轮问答,最多为10轮。
注:`选择问答模式时,此字段可不传,不传则使用默认语音文本:请问,您是否同意签署本协议?可语音回复“同意”或“不同意”。`
*/
IntentionQuestions?: Array;
/**
* 意愿核身(点头确认模式)使用的文案,若未使用意愿核身(点头确认模式),则该字段无需传入。支持传入1~10轮点头确认文本,最多支持10轮。
注:`选择点头模式时,此字段可不传,不传则使用默认语音文本:请问,您是否同意签署本协议?可点头同意。`
*/
IntentionActions?: Array;
/**
* 视频核身相关配置
*/
RuleIdConfig?: RuleIdConfig;
}
/**
* CreateFlowBlockchainEvidenceUrl返回参数结构体
*/
export interface CreateFlowBlockchainEvidenceUrlResponse {
/**
* 二维码图片下载链接,下载链接有效时间5分钟,请尽快下载保存。
*/
QrCode?: string;
/**
* 查看短链,可直接点击短链查看证书。
*/
Url?: string;
/**
* 二维码和短链的过期时间戳,过期时间默认为生成链接后7天。
*/
ExpiredOn?: number;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateDocument请求参数结构体
*/
export interface CreateDocumentRequest {
/**
* 本合同的发起人,点击查看合同发起人展示的位置
注:支持填入集团子公司经办人 userId代发合同。
*/
Operator: UserInfo;
/**
* 用户配置的合同模板ID,会基于此模板创建合同文档,为32位字符串。
[点击查看模板Id在控制台上的位置](https://qcloudimg.tencent-cloud.cn/raw/253071cc2f7becb063c7cf71b37b7861.png)
*/
TemplateId: string;
/**
* 合同流程ID,为32位字符串。
此接口的合同流程ID需要由[创建签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlow)接口创建得到。
*/
FlowId?: string;
/**
* 文件名列表,单个文件名最大长度200个字符,暂时仅支持单文件发起。设置后流程对应的文件名称当前设置的值。
*/
FileNames?: Array;
/**
* 电子文档的填写控件的填充内容。具体方式可以参考[FormField](https://qian.tencent.com/developers/companyApis/dataTypes/#formfield)结构体的定义。
- 支持自动签传递印章,可通过指定自动签控件id,指定印章id来完成
- 附件控件支持传入图片、文件资源id,并将内容合成到合同文件中。支持的文件类型有doc、docx、xls、xlsx、html、jpg、jpeg、png、bmp、txt、pdf。需要注意如果传入的资源类型都是图片类型,图片资源会放置在合同文件的末尾,如果传入的资源有非图片类型资源,会将资源放置在附件控件所在页面的下一页。
注:只有在控制台编辑模板时,归属给发起方的填写控件(如下图)才能在创建文档的时候进行内容填充。

*/
FormFields?: Array;
/**
* 是否为预览模式,取值如下:- **false**:非预览模式(默认),会产生合同流程并返回合同流程编号FlowId。
- **true**:预览模式,不产生合同流程,不返回合同流程编号FlowId,而是返回预览链接PreviewUrl,有效期为300秒,用于查看真实发起后合同的样子。 注意: 1.以预览模式创建的合同仅供查看,因此参与方无法进行签署操作;;2.以预览模式调用该接口返回的FlowId为临时Flowld,无法用于发起和拉取信息。
注: `当使用的模板中存在动态表格控件时,预览结果中没有动态表格的填写内容,动态表格合成完后会触发文档合成完成的回调通知`
*/
NeedPreview?: boolean;
/**
* 预览模式下产生的预览链接类型 - **0** :(默认) 文件流 ,点开后下载预览的合同PDF文件
- **1** :H5链接 ,点开后在浏览器中展示合同的样子。
注: `1.此参数在NeedPreview 为true时有效`
*/
PreviewType?: number;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 该字段已不再使用
*/
ClientToken?: string;
}
/**
* CreateContractReviewChecklistWebUrl请求参数结构体
*/
export interface CreateContractReviewChecklistWebUrlRequest {
/**
* 执行本接口操作的员工信息。使用此接口时,必须填写userId。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
}
/**
* CreateUserMobileChangeUrl请求参数结构体
*/
export interface CreateUserMobileChangeUrlRequest {
/**
* 执行本接口操作的员工信息。使用此接口时,必须填写userId。 支持填入集团子公司经办人 userId 代发合同。 注: 在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。
*/
Operator: UserInfo;
/**
* 代理企业和员工的信息。 在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 如果您要修改企业员工用户ID,传递此用户ID即可,其他参数(Name,UserAccountType,IdCardType,IdCardNumber)将被忽略。如果不传此用户ID,则会使用其他参数来进行链接生成。
[点击查看用户ID的获取方式](https://res.ess.tencent.cn/cdn/tsign-developer-center/assets/images/%E7%BB%84%E7%BB%87%E6%9E%B6%E6%9E%84-47eb7105dd300e6dc0c502fba22688ae.png)
*/
UserId?: string;
/**
* 要修改手机号用户的类型。
如果是员工类型,只能修改本方员工,而不能修改其他企业的员工。
如果是个人类型,可不指定用户身份,生成的是固定的链接,当前登录电子签小程序的用户可进行换绑。
*/
UserAccountType?: number;
/**
* 要修改手机号用户的姓名,请确保填写的姓名为对方的真实姓名,而非昵称等代名。
如果没有传递 userId且 userAccountType 是 0 或者没有传递, 此参数为必填项。
*/
Name?: string;
/**
* 要修改手机号用户的证件类型,
目前支持的账号类型如下:
- ID_CARD : (默认)中国大陆居民身份证
- HONGKONG_AND_MACAO : 港澳居民来往内地通行证
- HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同中国大陆居民身份证)
*/
IdCardType?: string;
/**
* 要修改手机号用户的身份证号码,应符合以下规则
- 中国大陆居民身份证号码应为18位字符串,由数字和大写字母X组成(如存在X,请大写)。
- 中国港澳居民来往内地通行证号码共11位。第1位为字母,“H”字头签发给中国香港居民,“M”字头签发给中国澳门居民;第2位至第11位为数字。
- 中国港澳台居民居住证号码编码规则与中国大陆身份证相同,应为18位字符串。
如果没有传递 userId且 userAccountType 是 0 或者没有传递, 此参数为必填项。
*/
IdCardNumber?: string;
/**
* 要跳转的链接类型
- HTTP:(默认)跳转电子签小程序的http_url,短信通知或者H5跳转适合此类型 ,此时返回长链 (默认类型)
- HTTP_SHORT_URL:跳转电子签小程序的http_url,短信通知或者H5跳转适合此类型,此时返回短链
- APP:第三方APP或小程序跳转电子签小程序的path, APP或者小程序跳转适合此类型
*/
Endpoint?: string;
/**
* 在用户完成实名认证后,其自定义数据将通过[手机号换绑回调](https://qian.tencent.com/developers/company/callback_types_staffs/#%E5%8D%81%E4%B8%89-%E4%B8%AA%E4%BA%BA%E5%91%98%E5%B7%A5%E6%89%8B%E6%9C%BA%E5%8F%B7%E4%BF%AE%E6%94%B9%E5%90%8E%E5%9B%9E%E8%B0%83)返回,以便用户确认其个人数据信息。请注意,自定义数据的字符长度上限为1000,且必须采用base64编码格式。
请注意:
此参数仅支持通过[获取c端用户实名链接](https://qian.tencent.com/developers/companyApis/users/CreateUserVerifyUrl)接口实名的用户生效。
*/
UserData?: string;
}
/**
* CreateEmbedWebUrl请求参数结构体
*/
export interface CreateEmbedWebUrlRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* WEB嵌入资源类型,支持以下类型
- CREATE_SEAL: 生成创建印章的嵌入页面
- CREATE_TEMPLATE:生成创建模板的嵌入页面
- MODIFY_TEMPLATE:生成编辑模板的嵌入页面
- CREATE_CONTRACT_DRAFT_COOPEDIT:生成创建起草合同的嵌入页面
- PREVIEW_TEMPLATE:生成预览模板的嵌入页面
- PREVIEW_SEAL_LIST:生成预览印章列表的嵌入页面
- PREVIEW_SEAL_DETAIL:生成预览印章详情的嵌入页面
- EXTEND_SERVICE:生成高级签署能力的嵌入页面
- PREVIEW_FLOW:生成预览合同的嵌入页面(支持移动端)
- PREVIEW_FLOW_DETAIL:生成查看合同详情的嵌入页面(仅支持PC端)
注意:
不同的嵌入类型,操作人需要的权限项不同(权限配置可参考[权限配置](https://qian.tencent.com/document/61355))。
| EmbedType | 权限 |
| CREATE_SEAL | 印章管理-添加印章 |
| CREATE_TEMPLATE | 模板管理-创建模板 |
| MODIFY_TEMPLATE | 模板管理-编辑模板 |
| CREATE_CONTRACT_DRAFT_COOPEDIT | 合同管理-起草合同 |
| PREVIEW_TEMPLATE | 拥有下面三种权限的一种就行
模板管理-查询模板(本企业全部模板)
模板管理-查询模板(本部门全部模板)
模板管理-查询模板(本人创建模板) |
| PREVIEW_SEAL_LIST | 印章管理 |
| PREVIEW_SEAL_DETAIL | 印章管理 |
| EXTEND_SERVICE | 无要求 |
| PREVIEW_FLOW | 是否是当前合同的参与方,或者发起方企业的法人、超管、合同管理员 |
| PREVIEW_FLOW_DETAIL | 是否是当前合同的参与方,或者发起方企业的法人、超管、合同管理员 |
*/
EmbedType: string;
/**
* WEB嵌入的业务资源ID
当EmbedType取值
- 为PREVIEW_SEAL_DETAIL,必填,取值为印章id。
- 为CREATE_TEMPLATE,非必填,取值为资源id。*资源Id获取可使用接口[上传文件](https://qian.tencent.com/developers/companyApis/templatesAndFiles/UploadFiles)*
- 为MODIFY_TEMPLATE,PREVIEW_TEMPLATE,必填,取值为模板id。
- 为CREATE_CONTRACT_DRAFT_COOPEDIT,非必填,取值为资源 id。*资源Id获取可使用接口[上传文件](https://qian.tencent.com/developers/companyApis/templatesAndFiles/UploadFiles)*
- 为PREVIEW_FLOW,PREVIEW_FLOW_DETAIL,必填,取值为合同id。
注意:
1. CREATE_TEMPLATE中的BusinessId仅支持PDF文件类型, 如果您的文件不是PDF, 请使用接口[创建文件转换任务
](https://qian.tencent.com/developers/companyApis/templatesAndFiles/CreateConvertTaskApi) 和[查询转换任务状态](https://qian.tencent.com/developers/companyApis/templatesAndFiles/GetTaskResultApi) 来进行转换成PDF资源。
2. CREATE_CONTRACT_DRAFT_COOPEDIT中的BusinessId仅支持DOC 和 DOCX 的文件,并且大小不能超过 10M。
*/
BusinessId?: string;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 抄送方信息
*/
Reviewer?: ReviewerInfo;
/**
* 个性化参数,用于控制页面展示内容
*/
Option?: EmbedUrlOption;
/**
* - 目前仅支持EmbedType=CREATE_TEMPLATE时传入
- 指定后,创建,编辑,删除模板时,回调都会携带该userData
- 支持的格式:json字符串的BASE64编码字符串
- 示例:
- json字符串:{"ComeFrom":"xxx"},BASE64编码:eyJDb21lRnJvbSI6Inh4eCJ9
- eyJDb21lRnJvbSI6Inh4eCJ9,为符合要求的userData数据格式
*/
UserData?: string;
}
/**
* CreateFlowGroupByFiles返回参数结构体
*/
export interface CreateFlowGroupByFilesResponse {
/**
* 合同(流程)组的合同组Id
*/
FlowGroupId?: string;
/**
* 合同(流程)组中子合同列表.
*/
FlowIds?: Array;
/**
* 合同组签署方信息。
*/
Approvers?: Array;
/**
* 发起审批流id,仅在发起时指定FlowGroupOptions.FlowGroupNeedWorkflow=true时返回
*/
WorkflowInstanceId?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DeleteIntegrationRoleUsers请求参数结构体
*/
export interface DeleteIntegrationRoleUsersRequest {
/**
* 执行本接口操作的员工信息。 注: 在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。
*/
Operator: UserInfo;
/**
* 角色id,可以通过DescribeIntegrationRoles接口获取角色信息
*/
RoleId: string;
/**
* 用户信息,最多 200 个用户,并且 UserId 和 OpenId 二选一,其他字段不需要传
*/
Users: Array;
/**
* 代理企业和员工的信息。 在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
}
/**
* CreateFlowSignUrl请求参数结构体
*/
export interface CreateFlowSignUrlRequest {
/**
* 合同流程ID为32位字符串。
您可以登录腾讯电子签控制台,在 "合同" -> "合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。[点击查看FlowId在控制台中的位置](https://qcloudimg.tencent-cloud.cn/raw/0a83015166cfe1cb043d14f9ec4bd75e.png)。
*/
FlowId: string;
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator?: UserInfo;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 流程签署人列表中,结构体的ApproverName、ApproverMobile和ApproverType为必传字段。如果是企业签署人,还需传递OrganizationName。
此结构体和CreateFlow发起接口参与方结构体复用,除了上述参数外,可传递的参数有:
1. RecipientId: 发起合同会返回,可以直接用于指定需要生成链接的签署方。
2. ApproverSignTypes: 指定签署方签署时候的认证方式,仅此链接生效。
3. SignTypeSelector: 可以指定签署方签署合同的认证校验方式的选择模式。
4. Intention: 指定H5签署视频核身的意图配置,仅视频签署需要使用。
注:
1. 签署人只能使用手写签名、时间类型、印章类型、签批类型的签署控件和内容填写控件,其他类型的签署控件暂时不支持。
2. 生成发起方预览链接时,该字段(FlowApproverInfos)可以传空或者不传。
*/
FlowApproverInfos?: Array;
/**
* 用于指定进入视频签署的限制次数,次数取值范围:1 - 10,不设置则默认为5次,仅视频签署时生效。
*/
VideoVerifyTimesLimit?: number;
/**
* 机构信息,暂未开放
* @deprecated
*/
Organization?: OrganizationInfo;
/**
* 签署完之后的H5页面的跳转链接,最大长度1000个字符。链接类型请参考 跳转电子签H5
*/
JumpUrl?: string;
/**
* 链接类型支持以下指定类型:
- 0: 签署链接(默认值),进入后可以填写或签署合同。
- 1 : 预览链接,进入后可以预览合同当前的样子。
注:
1. 当指定链接类型为1时,链接为预览链接,打开链接后无法进行签署操作,仅支持预览和查看当前合同状态。
2. 如需生成发起方预览链接,则签署方信息应传空,即FlowApproverInfos传空或者不传。
*/
UrlType?: number;
}
/**
* CreateIntegrationEmployees返回参数结构体
*/
export interface CreateIntegrationEmployeesResponse {
/**
* 创建员工的结果。包含创建成功的数据与创建失败数据。
*/
CreateEmployeeResult?: CreateStaffResult;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* ExportContractReviewResult请求参数结构体
*/
export interface ExportContractReviewResultRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 合同审查任务ID
*/
TaskId: string;
/**
* 导出文件类型。1 = 带风险批注文件; 2 = 审查结果&摘要(.xIsx); 3 = 不带批注文件
*/
FileType: number;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
}
/**
* CreateModifyAdminAuthorizationUrl请求参数结构体
*/
export interface CreateModifyAdminAuthorizationUrlRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 企业认证流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)得到
*/
AuthorizationId?: string;
/**
* 要跳转的链接类型- **HTTP**:跳转电子签小程序的http_url, 短信通知或者H5跳转适合此类型 ,此时返回长链 (默认类型)
- **HTTP_SHORT_URL**:跳转电子签小程序的http_url, 短信通知或者H5跳转适合此类型,此时返回短链
- **APP**: 第三方APP或小程序跳转电子签小程序的path, APP或者小程序跳转适合此类型
- **PC**: 跳转电子签web 端控制台的链接。
*/
Endpoint?: string;
}
/**
* 合同参与者信息。
*/
export interface ApproverInfo {
/**
* 在指定签署方时,可选择企业B端或个人C端等不同的参与者类型,可选类型如下:
**0**:企业
**1**:个人
**3**:企业静默签署
注:`类型为3(企业静默签署)时,此接口会默认完成该签署方的签署。静默签署仅进行盖章操作,不能自动签名。`
**7**: 个人自动签署,适用于个人自动签场景。
注: `个人自动签场景为白名单功能,使用前请联系对接的客户经理沟通。`
*/
ApproverType: number;
/**
* 签署方经办人的姓名。
经办人的姓名将用于身份认证和电子签名,请确保填写的姓名为签署方的真实姓名,而非昵称等代名。
*/
ApproverName?: string;
/**
* 签署方经办人手机号码, 支持中国大陆手机号11位数字(无需加+86前缀或其他字符)。
请确认手机号所有方为此合同签署方。
*/
ApproverMobile?: string;
/**
* 组织机构名称。
请确认该名称与企业营业执照中注册的名称一致。
如果名称中包含英文括号(),请使用中文括号()代替。
如果签署方是企业签署方(approverType = 0 或者 approverType = 3), 则企业名称必填。
*/
OrganizationName?: string;
/**
* 【在用文件发起合同场景下才有效,模板发起场景下需要在模板中配置】合同中的该名签署方的签署控件列表,列表中可支持下列多种签署控件,控件的详细定义参考开发者中心的Component结构体

*/
SignComponents?: Array;
/**
* 签署方经办人的证件类型,支持以下类型,样式可以参考常见个人证件类型介绍
- 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;
/**
* 通知签署方经办人的方式, 有以下途径:
- **sms** : (默认)短信
- **none** : 不通知
注意:
`如果使用的是通过文件发起合同(CreateFlowByFiles),NotifyType必须 是 sms 才会发送短信`
*/
NotifyType?: string;
/**
* 收据场景设置签署人角色类型, 可以设置如下类型:
- **1** :收款人
- **2** :开具人
- **3** :见证人
注: `收据场景为白名单功能,使用前请联系对接的客户经理沟通。`
*/
ApproverRole?: number;
/**
* 可以自定义签署人角色名:收款人、开具人、见证人等,长度不能超过20,只能由中文、字母、数字和下划线组成。
注: `如果是用模板发起, 优先使用此处上传的, 如果不传则用模板的配置的`
*/
ApproverRoleName?: string;
/**
* 【已不再使用】签署意愿确认渠道,默认为WEIXINAPP:人脸识别
注: 该字段已不再使用, 请用ApproverSignTypes签署人签署合同时的认证方式代替, 新客户可请用ApproverSignTypes来设置
*/
VerifyChannel?: Array;
/**
* 签署方在签署合同之前,需要强制阅读合同的时长,可指定为3秒至300秒之间的任意值。
若未指定阅读时间,则会按照合同页数大小计算阅读时间,计算规则如下:
- 合同页数少于等于2页,阅读时间为3秒;
- 合同页数为3到5页,阅读时间为5秒;
- 合同页数大于等于6页,阅读时间为10秒。
*/
PreReadTime?: number;
/**
* 签署人userId,仅支持本企业的员工userid, 可在控制台组织管理处获得
注:
如果传进来的UserId已经实名, 则忽略ApproverName,ApproverIdCardType,ApproverIdCardNumber,ApproverMobile这四个入参(会用此UserId实名的身份证和登录的手机号覆盖)
*/
UserId?: string;
/**
* 在企微场景下使用,需设置参数为**WEWORKAPP**,以表明合同来源于企微。
*/
ApproverSource?: string;
/**
* 在企业微信场景下,表明该合同流程为或签,其最大长度为64位字符串。
所有参与或签的人员均需具备该标识。
注意,在合同中,不同的或签参与人必须保证其CustomApproverTag唯一。
如果或签签署人为本方企业微信参与人,则需要指定ApproverSource参数为WEWORKAPP。
*/
CustomApproverTag?: string;
/**
* 可以控制签署方在签署合同时能否进行某些操作,例如拒签、转交他人等。
详细操作可以参考开发者中心的ApproverOption结构体。
*/
ApproverOption?: ApproverOption;
/**
* 【在用文件发起合同场景下才有效,模板发起场景下需要在模板中配置】指定个人签署方查看合同的校验方式,可以传值如下:
- **1** : (默认)人脸识别,人脸识别后才能合同内容
- **2** : 手机号验证, 用户手机号和参与方手机号(ApproverMobile)相同即可查看合同内容(当手写签名方式为OCR_ESIGN时,该校验方式无效,因为这种签名方式依赖实名认证)
注:
- 如果合同流程设置ApproverVerifyType查看合同的校验方式, 则忽略此签署人的查看合同的校验方式
- 此字段可传多个校验方式
*/
ApproverVerifyTypes?: Array;
/**
* 【在用文件发起合同场景下才有效,模板发起场景下需要在模板中配置】您可以指定签署方签署合同的认证校验方式,可传递以下值:
- **1**:人脸认证,需进行人脸识别成功后才能签署合同;
- **2**:签署密码,需输入与用户在腾讯电子签设置的密码一致才能校验成功进行合同签署;
- **3**:运营商三要素,需到运营商处比对手机号实名信息(名字、手机号、证件号)校验一致才能成功进行合同签署。(如果是港澳台客户,建议不要选择这个)
- **5**:设备指纹识别,需要对比手机机主预留的指纹信息,校验一致才能成功进行合同签署。(iOS系统暂不支持该校验方式)
- **6**:设备面容识别,需要对比手机机主预留的人脸信息,校验一致才能成功进行合同签署。(Android系统暂不支持该校验方式)
默认为:
1(人脸认证 ),2(签署密码),3(运营商三要素),5(设备指纹识别),6(设备面容识别)
注:
1. 用模板创建合同场景, 签署人的认证方式需要在配置模板的时候指定, 在创建合同重新指定无效
2. 运营商三要素认证方式对手机号运营商及前缀有限制,可以参考[运营商支持列表类](https://qian.tencent.com/developers/company/mobile_support)得到具体的支持说明
3. 校验方式不允许只包含设备指纹识别和设备面容识别,至少需要再增加一种其他校验方式。
4. 设备指纹识别和设备面容识别只支持小程序使用,其他端暂不支持。
*/
ApproverSignTypes?: Array;
/**
* 此签署人(员工或者个人)签署前,是否需要发起方企业审批,取值如下:
- **false**:(默认)不需要审批,直接签署。
- **true**:需要走审批流程。当到对应参与人签署时,会阻塞其签署操作,等待企业内部审批完成。
企业可以通过CreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果
- 如果企业通知腾讯电子签平台审核通过,签署方可继续签署动作。
- 如果企业通知腾讯电子签平台审核未通过,平台将继续阻塞签署方的签署动作,直到企业通知平台审核通过。
注:`此功能可用于与发起方企业内部的审批流程进行关联,支持手动、静默签署合同`

*/
ApproverNeedSignReview?: boolean;
/**
* 【在用文件发起合同场景下才有效】在调用[用PDF文件创建签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlowByFiles)创建合同时,如果设置了外层参数SignBeanTag=1(允许签署过程中添加签署控件),则可通过此参数明确规定合同所使用的签署控件类型(骑缝章、普通章法人章等)和具体的印章(印章ID或者印章类型)或签名方式。
注:`限制印章控件或骑缝章控件情况下,仅本企业签署方可以指定具体印章(通过传递ComponentValue,支持多个),他方企业或个人只支持限制控件类型。`
*/
AddSignComponentsLimits?: Array;
/**
* 签署须知:支持传入富文本,最长字数:500个中文字符
*/
SignInstructionContent?: string;
/**
* 签署人的签署截止时间,格式为Unix标准时间戳(秒)
注: `若不设置此参数,则默认使用合同的截止时间,此参数暂不支持合同组子合同`
*/
Deadline?: number;
/**
* 【在用文件发起合同场景下才有效,模板发起场景下需要在模板中配置】签署人在合同中的填写控件列表,列表中可支持下列多种填写控件,控件的详细定义参考开发者中心的Component结构体
- 单行文本控件
- 多行文本控件
- 勾选框控件
- 数字控件
- 图片控件
具体使用说明可参考[为签署方指定填写控件](https://qian.tencent.cn/developers/company/createFlowByFiles/#指定签署方填写控件)
注:`此参数仅在通过文件发起合同或者合同组时生效`

*/
Components?: Array;
/**
* 进入签署流程的限制,目前支持以下选项:
- 空值(默认) :无限制,可在任何场景进入签署流程。
- link :选择此选项后,将无法通过控制台或电子签小程序列表进入填写或签署操作,仅可预览合同。填写或签署流程只能通过短信或发起方提供的专用链接进行。
*/
SignEndpoints?: Array;
/**
* 快速注册相关信息
*/
RegisterInfo?: RegisterInfo;
/**
* 是否不保存联系人
默认 false 保存联系人 true 不保存联系人
设置这个参数为保存联系人的时候,他方企业签署人会被保存进发起人的联系人中。
联系人查看可登录[电子签控制台](https://test.qian.tencent.cn/console/) 进行查看。
如下图位置:

*/
NotSaveContact?: boolean;
}
/**
* 查询过滤条件
*/
export interface Filter {
/**
* 查询过滤条件的Key
*/
Key: string;
/**
* 查询过滤条件的Value列表
*/
Values: Array;
}
/**
* 创建合同,若对方签署人的企业信息还未在腾讯电子签注册。则在进行引导企业注册时控制企业填写信息的个性化参数。
具体可查看[视频](https://qian.tencent.com/developers/video/?menu=scene&id=6)
*/
export interface RegisterInfoOption {
/**
* 是否允许编辑企业注册时的法人姓名。
true:允许编辑
false:不允许编辑(默认值)
注意:
RegisterInfo 中的LegalName值不为空的时候,才可设置为不可编辑。
*/
LegalNameSame?: boolean;
/**
* 是否允许编辑企业注册时统一社会信用代码。
true:不允许编辑。
false:允许编辑(默认值)。
注意:
RegisterInfo 中的UnifiedSocialCreditCode值不为空的时候,才可设置为不可编辑。
*/
UnifiedSocialCreditCodeCNameSame?: boolean;
/**
* 是否允许编辑企业注册时的证照类型
true:不允许编辑。
false:允许编辑(默认值)。
注意:
RegisterInfo 中的OrganizationIdCardType值不为空的时候,才可设置为不可编辑。
*/
OrganizationIdCardTypeSame?: boolean;
}
/**
* 动态添加签署人的结果信息
*/
export interface DynamicFlowApproverResult {
/**
* 签署方角色编号,签署方角色编号是用于区分同一个流程中不同签署方的唯一标识。不同的流程会出现同样的签署方角色编号。
填写控件和签署控件都与特定的角色编号关联。
在进行新增签署方操作时,建议记录下该签署方的角色编号。后续可以拉取流程信息,用来判断该签署方的当前状态。
*/
RecipientId?: string;
/**
* 签署方唯一编号,一个全局唯一的标识符,不同的流程不会出现冲突。
可以使用签署方的唯一编号来生成签署链接(也可以通过RecipientId来生成签署链接)。
*/
SignId?: string;
/**
* 签署方当前状态,会出现下面的状态
2:待签署
3:已签署
4:已拒绝
5:已过期
6:已撤销
8:待填写
9:因为各种原因(签署人改名等)而终止
10:填写完成
15:已解除
19:转他人处理
*/
ApproverStatus?: number;
}
/**
* DeleteOrganizationAuthorizations请求参数结构体
*/
export interface DeleteOrganizationAuthorizationsRequest {
/**
* 执行本接口操作的员工信息, userId 必填。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 认证流Ids数组
认证流 Id 是指在企业认证过程中,当前操作人的认证流程的唯一标识。每个企业在认证过程中只能有一条认证流认证成功。这意味着在同一认证过程内,一个企业只能有一个认证流程处于成功状态,以确保认证的唯一性和有效性。
认证流 Id可以通过回调 [授权书认证审核结果回调](https://qian.tencent.com/developers/company/callback_types_staffs/#%E5%8D%81%E5%9B%9B-%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) 获取
注意:
如果传递了认证流Id,则下面的参数 超管二要素不会生效
*/
AuthorizationIds?: Array;
/**
* 认证人姓名,组织机构超管姓名。
在注册流程中,必须是超管本人进行操作。
*/
AdminName?: string;
/**
* 认证人手机号,组织机构超管手机号。 在注册流程中,必须是超管本人进行操作。
*/
AdminMobile?: string;
/**
* 代理企业和员工的信息。在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
}
/**
* CancelUserAutoSignEnableUrl请求参数结构体
*/
export interface CancelUserAutoSignEnableUrlRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 自动签使用的场景值, 可以选择的场景值如下:
- **E_PRESCRIPTION_AUTO_SIGN** : 电子处方场景
- **OTHER** : 通用场景
*/
SceneKey: string;
/**
* 预撤销链接的用户信息,包含姓名、证件类型、证件号码等信息。
*/
UserInfo: UserThreeFactor;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
}
/**
* DescribeUserVerifyStatus返回参数结构体
*/
export interface DescribeUserVerifyStatusResponse {
/**
* true:表示已实名
false:表示未实名
*/
VerifyStatus?: boolean;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 企业套餐余额情况
*/
export interface OrgBillSummary {
/**
* 套餐总数
*/
Total?: number;
/**
* 套餐使用数
*/
Used?: number;
/**
* 套餐剩余数
*/
Available?: number;
/**
* 套餐类型
对应关系如下:
- **CloudEnterprise**: 企业版合同
- **SingleSignature**: 单方签章
- **CloudProve**: 签署报告
- **CloudOnlineSign**: 腾讯会议在线签约
- **ChannelWeCard**: 微工卡
- **SignFlow**: 合同套餐
- **SignFace**: 签署意愿(人脸识别)
- **SignPassword**: 签署意愿(密码)
- **SignSMS**: 签署意愿(短信)
- **PersonalEssAuth**: 签署人实名(腾讯电子签认证)
- **PersonalThirdAuth**: 签署人实名(信任第三方认证)
- **OrgEssAuth**: 签署企业实名
- **FlowNotify**: 短信通知
- **AuthService**: 企业工商信息查询
*/
QuotaType?: string;
}
/**
* 子企业套餐使用情况
*/
export interface SubOrgBillSummary {
/**
* 子企业名称
*/
OrganizationName?: string;
/**
*
*/
Usage?: Array;
}
/**
* DescribeBillUsage请求参数结构体
*/
export interface DescribeBillUsageRequest {
/**
* 查询开始时间字符串,格式为yyyymmdd,时间跨度不能大于90天
*/
StartTime: string;
/**
* 查询结束时间字符串,格式为yyyymmdd,时间跨度不能大于90天
*/
EndTime: string;
/**
* 查询的套餐类型 (选填 )不传则查询所有套餐;目前支持:- **CloudEnterprise**: 企业版合同
- **SingleSignature**: 单方签章
- **CloudProve**: 签署报告
- **CloudOnlineSign**: 腾讯会议在线签约
- **ChannelWeCard**: 微工卡
- **SignFlow**: 合同套餐
- **SignFace**: 签署意愿(人脸识别)
- **SignPassword**: 签署意愿(密码)
- **SignSMS**: 签署意愿(短信)
- **PersonalEssAuth**: 签署人实名(腾讯电子签认证)
- **PersonalThirdAuth**: 签署人实名(信任第三方认证)
- **OrgEssAuth**: 签署企业实名
- **FlowNotify**: 短信通知
- **AuthService**: 企业工商信息查询
*/
QuotaType?: string;
/**
* 是否展示集团子企业的明细,默认否
*/
DisplaySubEnterprise?: boolean;
}
/**
* ModifyApplicationCallbackInfo请求参数结构体
*/
export interface ModifyApplicationCallbackInfoRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 操作类型:
1-新增
2-删除
*/
OperateType: number;
/**
* 企业应用回调信息
*/
CallbackInfo: CallbackInfo;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
}
/**
* DescribeContractDiffTaskWebUrl请求参数结构体
*/
export interface DescribeContractDiffTaskWebUrlRequest {
/**
* 执行本接口操作的员工信息。使用此接口时,必须填写userId。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 合同对比任务ID,该参数通过调用接口创建合同对比web页面获取。
*/
TaskId: string;
}
/**
* StartFlow请求参数结构体
*/
export interface StartFlowRequest {
/**
* 本合同的发起人,点击查看合同发起人展示的位置
*/
Operator: UserInfo;
/**
* 合同流程ID,为32位字符串。
此处需要传入[创建签署流程接口](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlow)得到的FlowId。
*/
FlowId: string;
/**
* 客户端Token,保持接口幂等性,最大长度64个字符
* @deprecated
*/
ClientToken?: string;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 若在创建签署流程时指定了关注人CcInfos,此参数可设定向关注人发送短信通知的类型:
- **0** :合同发起时通知通知对方来查看合同(默认)
- **1** : 签署完成后通知对方来查看合同
*/
CcNotifyType?: number;
}
/**
* 企业变更超管信息。
*/
export interface AdminChangeInvitationInfo {
/**
* 要变更的企业Id。
使用接口进行变更,所支持的企业有两种。
1. 集团主企业替子企业进行超管变更。
子企业的企业 Id 可在更多-组织管理-集团组织管理处获取。如图位置
2. 使用接口[创建企业认证链接](https://qian.tencent.com/developers/companyApis/organizations/CreateOrganizationAuthUrl) 创建的企业,企业 Id 可以从回调[企业引导企业实名认证后回调](https://qian.tencent.com/developers/company/callback_types_staffs#%E5%8D%81%E4%B8%80-%E4%BC%81%E4%B8%9A%E5%BC%95%E5%AF%BC%E4%BC%81%E4%B8%9A%E5%AE%9E%E5%90%8D%E8%AE%A4%E8%AF%81%E5%90%8E%E5%9B%9E%E8%B0%83)得到。
*/
ChangeAdminOrganizationId: string;
/**
* 组织机构要变更的超管姓名。
跟超管变更的操作人保持一致。
*/
NewAdminName: string;
/**
* 授权书(PNG或JPG或PDF) base64格式, 大小不超过8M 。
p.s. 如果上传授权书 ,需遵循以下条件
1. 超管的信息(超管姓名,超管手机号)必须为必填参数。
*/
AuthFiles: Array;
/**
* 组织机构要变更的超管手机号。
跟超管变更的操作人保持一致。
超管变更的手机号和超管变更的证件号,必须要传递一个。
*/
NewAdminMobile?: string;
/**
* 组织机构要变更的超管证件类型支持以下类型
- ID_CARD : 中国大陆居民身份证 (默认值)
- HONGKONG_AND_MACAO : 中国港澳居民来往内地通行证
- HONGKONG_MACAO_AND_TAIWAN : 中国港澳台居民居住证(格式同中国大陆居民身份证)
跟超管变更的操作人保持一致。
*/
NewAdminIdCardType?: string;
/**
* 组织机构新超管证件号。
跟超管变更的操作人保持一致。
超管变更的手机号和超管变更的证件号,必须要传递一个。
*/
NewAdminIdCardNumber?: string;
}
/**
* 签署人个性化能力信息
*/
export interface ApproverOption {
/**
* 签署方是否可以拒签
- **false** : ( 默认)可以拒签
- **true** :不可以拒签
*/
NoRefuse?: boolean;
/**
* 签署方是否可以转他人处理
- **false** : ( 默认)可以转他人处理
- **true** :不可以转他人处理
*/
NoTransfer?: boolean;
/**
* 允许编辑签署人信息(嵌入式使用) 默认true-可以编辑 false-不可以编辑
*/
CanEditApprover?: boolean;
/**
* 签署人信息补充类型,默认无需补充。
- **1** : 动态签署人(可发起合同后再补充签署人信息)注:`企业自动签不支持动态补充`
注:
1. `使用动态签署人能力前,需登录腾讯电子签控制台打开服务开关`
2. 此参数在嵌入式场景下无效。
*/
FillType?: number;
/**
* 签署人阅读合同限制参数
取值:
- LimitReadTimeAndBottom,阅读合同必须限制阅读时长并且必须阅读到底
- LimitReadTime,阅读合同仅限制阅读时长
- LimitBottom,阅读合同仅限制必须阅读到底
- NoReadTimeAndBottom,阅读合同不限制阅读时长且不限制阅读到底(白名单功能,请联系客户经理开白使用)
*/
FlowReadLimit?: string;
/**
* 禁止在签署过程中添加签署日期控件
前置条件:文件发起合同时,指定SignBeanTag=1(可以在签署过程中添加签署控件):
- 默认值:false,在开启:签署过程中添加签署控件时,添加签署控件会默认自带签署日期控件
- 可选值:true,在开启:签署过程中添加签署控件时,添加签署控件不会自带签署日期控件
*/
ForbidAddSignDate?: boolean;
}
/**
* DeleteIntegrationEmployees返回参数结构体
*/
export interface DeleteIntegrationEmployeesResponse {
/**
* 员工删除结果。包含成功数据与失败数据。
- **成功数据**:展示员工姓名、手机号与电子签平台UserId
- **失败数据**:展示员工电子签平台UserId、第三方平台OpenId和失败原因
*/
DeleteEmployeeResult?: DeleteStaffsResult;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DescribeContractReviewChecklistWebUrl请求参数结构体
*/
export interface DescribeContractReviewChecklistWebUrlRequest {
/**
* 执行本接口操作的员工信息。使用此接口时,必须填写userId。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 清单 id
*/
Id: string;
}
/**
* 权限树中的权限组
*/
export interface PermissionGroup {
/**
* 权限组名称
*/
GroupName?: string;
/**
* 权限组key
*/
GroupKey?: string;
/**
* 是否隐藏分组,0否1是
*/
Hide?: number;
/**
* 权限集合
*/
Permissions?: Array;
}
/**
* CreateFlowReminds请求参数结构体
*/
export interface CreateFlowRemindsRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 需执行催办的签署流程ID数组,最多包含100个。
*/
FlowIds: Array;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
}
/**
* DescribeSignFaceVideo返回参数结构体
*/
export interface DescribeSignFaceVideoResponse {
/**
* 核身视频结果。
*/
VideoData?: DetectInfoVideoData;
/**
* 意愿核身问答模式结果。若未使用该意愿核身功能,该字段返回值可以不处理。
*/
IntentionQuestionResult?: IntentionQuestionResult;
/**
* 意愿核身点头确认模式的结果信息,若未使用该意愿核身功能,该字段返回值可以不处理。
注意:此字段可能返回 null,表示取不到有效值。
*/
IntentionActionResult?: IntentionActionResult;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* VerifyPdf返回参数结构体
*/
export interface VerifyPdfResponse {
/**
* 验签结果代码,代码的含义如下:
- **1**:文件未被篡改,全部签名在腾讯电子签完成。
- **2**:文件未被篡改,部分签名在腾讯电子签完成。
- **3**:文件被篡改。
- **4**:异常:文件内没有签名域。
- **5**:异常:文件签名格式错误。
*/
VerifyResult?: number;
/**
* 验签结果详情,每个签名域对应的验签结果。状态值如下
- **1** :验签成功,在电子签签署
- **2** :验签成功,在其他平台签署
- **3** :验签失败
- **4** :pdf文件没有签名域
- **5** :文件签名格式错误
*/
PdfVerifyResults?: Array;
/**
* 验签序列号, 为11为数组组成的字符串
*/
VerifySerialNo?: string;
/**
* 合同文件MD5哈希值
*/
PdfResourceMd5?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 删除员工结果
*/
export interface DeleteStaffsResult {
/**
* 删除员工的成功数据
*/
SuccessEmployeeData?: Array;
/**
* 删除员工的失败数据
*/
FailedEmployeeData?: Array;
}
/**
* 合同组相关信息,指定合同组子合同和签署方的信息,用于补充动态签署人。
*/
export interface FlowGroupApproverInfo {
/**
* 合同流程ID。
*/
FlowId?: string;
/**
* 签署节点ID,用于生成动态签署人链接完成领取。注:`生成动态签署人补充链接时必传。`
*/
RecipientId?: string;
}
/**
* DescribeBatchOrganizationRegistrationUrls返回参数结构体
*/
export interface DescribeBatchOrganizationRegistrationUrlsResponse {
/**
* 企业批量注册链接信息
*/
OrganizationAuthUrls?: Array;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* ExportContractComparisonTask请求参数结构体
*/
export interface ExportContractComparisonTaskRequest {
/**
* 执行合同审查任务的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 合同对比任务ID,该参数通过调用接口CreateContractComparisonTask获取。
*/
TaskId: string;
/**
* 导出对比结果文件类型。
类型如下:
- **0**:【PDF】以新合同文件为基础,导出带有可视化对比点标注的PDF文件。
- **1**:【EXCEL】导出结构化的对比点明细表格,以列表形式罗列每一个差异点,包含改动位置、类型、标签及修改前后的完整内容。
*/
ExportType?: number;
/**
* 是否忽略,适用于PDF。
- **true**:导出文件标注去掉忽略项。
- **false**:导出文件包含所有对比点。
*/
Ignore?: boolean;
}
/**
* CreateInformationExtractionWebUrl请求参数结构体
*/
export interface CreateInformationExtractionWebUrlRequest {
/**
* 执行本接口操作的员工信息。使用此接口时,必须填写userId。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 需要提取的合同文件资源ID,可通过UploadFiles接口获取文件资源ID。
注:
- `word、pdf文件每个文件限制在10M以下`
- `png、jpg、jpeg文件每个限制在5M以下`
*/
ResourceIds?: Array;
/**
* 调用方自定义的个性化字段(可自定义此名称),并以base64方式编码,支持的最大数据大小为 1024长度。
在合同状态变更的回调信息等场景中,该字段的信息将原封不动地透传给贵方。回调的相关说明可参考开发者中心的[回调通知](https://qian.tencent.com/developers/company/callback_types_v2)模块。
*/
UserData?: string;
/**
* 个性化参数,用于控制页面展示内容
*/
Option?: WebUrlOption;
}
/**
* CreateRiskIdentificationTaskFeedback请求参数结构体
*/
export interface CreateRiskIdentificationTaskFeedbackRequest {
/**
* 执行合同审查任务的员工信息。
*/
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/DescribeContractReviewTask)获取(取Risks.RiskId值)。
- 反馈通过项结果。该参数通过调用接口[获取合同审查任务详情](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/DescribeContractReviewTask)获取(取ApprovedLists.RiskId值)
*/
RiskId?: string;
/**
* 反馈结果
- 1: 其他错误
- 2: 审查错误
- 3: 审查正确
*/
FeedbackResult?: number;
/**
* 审查反馈原因
*/
Reason?: string;
}
/**
* 解除协议的签署人,如不指定,默认使用原流程中的签署人。
`注意:不支持更换C端(个人身份类型)签署人,如果原流程中含有C端签署人,默认使用原流程中的该C端签署人。`
`注意:目前不支持替换C端(个人身份类型)签署人,但是可以指定C端签署人的签署方自定义控件别名,具体见参数ApproverSignRole描述。`
`注意:当指定C端签署人的签署方自定义控件别名不空时,除RelievedApproverReceiptId参数外,可以只参数ApproverSignRole。`
*/
export interface ReleasedApprover {
/**
* 签署人姓名,最大长度50个字。
*/
Name: string;
/**
* 签署人手机号。
*/
Mobile: string;
/**
* 要更换的原合同参与人RecipientId编号。(可通过接口DescribeFlowInfo查询签署人的RecipientId编号)
* @deprecated
*/
RelievedApproverReceiptId?: string;
/**
* 指定签署人类型,目前仅支持
- **ORGANIZATION**:企业(默认值)
- **ENTERPRISESERVER**:企业静默签
*/
ApproverType?: string;
/**
* 签署控件类型,支持自定义企业签署方的签署控件类型
- **SIGN_SEAL**:默认为印章控件类型(默认值)
- **SIGN_SIGNATURE**:手写签名控件类型
*/
ApproverSignComponentType?: string;
/**
* 参与方在合同中的角色是按照创建合同的时候来排序的,解除协议默认会将第一个参与人叫`甲方`,第二个叫`乙方`, 第三个叫`丙方`,以此类推。
如果需改动此参与人的角色名字,可用此字段指定,由汉字,英文字符,数字组成,最大20个字。

*/
ApproverSignRole?: string;
/**
* 印章Id,签署控件类型为印章时,用于指定本企业签署方在解除协议中使用那个印章进行签署
*/
ApproverSignSealId?: string;
/**
* 要更换的原合同参与人RecipientId编号。(可通过接口DescribeFlowInfo查询签署人的RecipientId编号)
*/
RelievedApproverRecipientId?: string;
}
/**
* DescribeUserFlowType请求参数结构体
*/
export interface DescribeUserFlowTypeRequest {
/**
* 执行本接口操作的员工信息。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
/**
* 代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
*/
Agent?: Agent;
/**
* 搜索过滤的条件,本字段允许您通过指定模板 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;
/**
* 查询绑定了模板的用户合同类型 - false(默认值),查询用户合同类型
- true,查询绑定了模板的用户合同类型
*/
QueryBindTemplate?: boolean;
}
/**
* DescribeContractReviewTaskListWebUrl请求参数结构体
*/
export interface DescribeContractReviewTaskListWebUrlRequest {
/**
* 执行本接口操作的员工信息。使用此接口时,必须填写userId。
注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
*/
Operator: UserInfo;
}
/**
* 合同流程的基础信息
*/
export interface FlowBrief {
/**
* 合同流程ID,为32位字符串。
*/
FlowId?: string;
/**
* 合同流程的名称。
*/
FlowName?: string;
/**
* 合同流程描述信息。
*/
FlowDescription?: string;
/**
* 合同流程的类别分类(如销售合同/入职合同等)。
该字段将被废弃,不建议使用。 请使用 UserFlowType。
*/
FlowType?: string;
/**
* 合同流程当前的签署状态, 会存在下列的状态值
- **0** : 未开启流程(合同中不存在填写环节)
- **1** : 待签署
- **2** : 部分签署
- **3** : 已拒签
- **4** : 已签署
- **5** : 已过期
- **6** : 已撤销
- **7** : 未开启流程(合同中存在填写环节)
- **8** : 等待填写
- **9** : 部分填写
- **10** : 已拒填
- **16** : 已失效(签署期间有签署人改名等原因导致)
- **21** : 已解除
*/
FlowStatus?: number;
/**
* 合同流程创建时间,格式为Unix标准时间戳(秒)。
*/
CreatedOn?: number;
/**
* 当合同流程状态为已拒签(即 FlowStatus=3)或已撤销(即 FlowStatus=6)时,此字段 FlowMessage 为拒签或撤销原因。
*/
FlowMessage?: string;
/**
* 合同流程发起方的员工编号, 即员工在腾讯电子签平台的唯一身份标识。
*/
Creator?: string;
/**
* 合同流程的签署截止时间,格式为Unix标准时间戳(秒)。
*/
Deadline?: number;
/**
* 用户合同的自定义分类。
自定义合同类型的位置,在下图所示地方:

*/
UserFlowType?: UserFlowType;
/**
* 发起模板时,使用的模板Id
*/
TemplateId?: string;
}
/**
* DescribeOrganizationGroupOrganizations返回参数结构体
*/
export interface DescribeOrganizationGroupOrganizationsResponse {
/**
* 符合查询条件的资源实例总数量。
*/
Total?: number;
/**
* 已授权待激活的子企业总数量
*/
JoinedTotal?: number;
/**
* 已加入的企业数量(废弃,请使用ActivatedTotal)
* @deprecated
*/
ActivedTotal?: number;
/**
* 如果入参Export为 true 时使用,表示导出Excel的url
*/
ExportUrl?: string;
/**
* 成员企业信息列表
*/
List?: Array;
/**
* 已加入的子企业总数量
*/
ActivatedTotal?: number;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 意愿核身语音问答模式(即语音播报+语音回答)使用的文案,包括:系统语音播报的文本、需要核验的标准文本。当前仅支持1轮问答。
*/
export interface IntentionQuestion {
/**
* 当选择语音问答模式时,系统自动播报的问题文本,最大长度为250个字符。
*/
Question?: string;
/**
* 当选择语音问答模式时,用于判断用户回答是否通过的标准答案列表,传入后可自动判断用户回答文本是否在标准文本列表中。
*/
Answers?: Array;
}