tencentcloud-sdk-nodejs
Version:
1,682 lines (1,597 loc) • 404 kB
TypeScript
/**
* SyncProxyOrganization返回参数结构体
*/
export interface SyncProxyOrganizationResponse {
/**
* 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 批量签署合同相关信息，指定批量签署合同和签署方的信息，用于补充动态签署人。
*/
export interface FlowBatchUrlInfo {
/**
* 批量签署合同和签署方的信息，用于补充动态签署人。
*/
FlowBatchApproverInfos?: Array<FlowBatchApproverInfo>;
}
/**
* ChannelCreateConvertTaskApi返回参数结构体
*/
export interface ChannelCreateConvertTaskApiResponse {
/**
* 接口返回的文件转换任务Id，可以调用接口<a href="https://qian.tencent.com/developers/partnerApis/files/ChannelGetTaskResultApi" target="_blank">查询转换任务状态</a>获取转换任务的状态和转换后的文件资源Id。
*/
TaskId?: string;
/**
* 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* ChannelCreateFlowReminds返回参数结构体
*/
export interface ChannelCreateFlowRemindsResponse {
/**
* 合同催办结果的详细信息列表。
*/
RemindFlowRecords?: Array<RemindFlowRecords>;
/**
* 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 此结构体 (Component) 用于描述控件属性。
在通过文件发起合同时，对应的component有三种定位方式
1. 绝对定位方式 （可以通过 [PDF坐标计算助手](https://qian.tencent.com/developers/tools/template-editor)计算控件的坐标）
2. 表单域(FIELD)定位方式
3. 关键字(KEYWORD)定位方式，使用关键字定位时，请确保PDF原始文件内是关键字以文字形式保存在PDF文件中，不支持对图片内文字进行关键字查找
*/
export interface Component {
/**
* 控件唯一ID。
**在绝对定位方式方式下**，ComponentId为控件的ID，长度不能超过30，只能由中文、字母、数字和下划线组成，可以在后续的操作中使用该名称来引用控件。
**在关键字定位方式下**，ComponentId不仅为控件的ID，也是关键字整词。此方式下可以通过"^"来决定是否使用关键字整词匹配能力。
例：
- 如传入的关键字<font color="red">"^甲方签署^"</font >，则会在PDF文件中有且仅有"甲方签署"关键字的地方（<font color="red">前后不能有其他字符</font >）进行对应操作。
- 如传入的关键字为<font color="red">"甲方签署</font >"，则PDF文件中每个出现关键字的位置（<font color="red">前后可以有其他字符</font >）都会执行相应操作。
注：`控件ID可以在一个PDF中不可重复`
<a href="https://qcloudimg.tencent-cloud.cn/raw/93178569d07b4d7dbbe0967ae679e35c.png" target="_blank">点击查看ComponentId在模板页面的位置</a>
*/
ComponentId?: string;
/**
* **如果是Component填写控件类型，则可选的字段为**：
<ul><li> <b>TEXT</b> : 普通文本控件，输入文本字符串；</li>
<li> <b>MULTI_LINE_TEXT</b> : 多行文本控件，输入文本字符串；</li>
<li> <b>CHECK_BOX</b> : 勾选框控件，若选中填写ComponentValue 填写 true或者 false 字符串；</li>
<li> <b>FILL_IMAGE</b> : 图片控件，ComponentValue 填写图片的资源 ID；</li>
<li> <b>DYNAMIC_TABLE</b> : 动态表格控件；</li>
<li> <b>ATTACHMENT</b> : 附件控件,ComponentValue 填写附件图片的资源 ID列表，以逗号分隔；</li>
<li> <b>SELECTOR</b> : 选择器控件，ComponentValue填写选择的字符串内容；</li>
<li> <b>DATE</b> : 日期控件；默认是格式化为xxxx年xx月xx日字符串；</li>
<li> <b>DISTRICT</b> : 省市区行政区控件，ComponentValue填写省市区行政区字符串内容；</li></ul>
**如果是SignComponent签署控件类型，
需要根据签署人的类型可选的字段为**
* 企业方
<ul><li> <b>SIGN_SEAL</b> : 签署印章控件；</li>
<li> <b>SIGN_DATE</b> : 签署日期控件；</li>
<li> <b>SIGN_SIGNATURE</b> : 用户签名控件；</li>
<li> <b>SIGN_PAGING_SEAL</b> : 骑缝章；若文件发起，需要对应填充ComponentPosY、ComponentWidth、ComponentHeight</li>
<li> <b>SIGN_OPINION</b> : 签署意见控件，用户需要根据配置的签署意见内容，完成对意见内容的确认；</li>
<li> <b>SIGN_VIRTUAL_COMBINATION</b> : 签批控件。内部最多组合4个特定控件（SIGN_SIGNATURE，SIGN_DATA,SIGN_MULTI_LINE_TEXT,SIGN_SELECTOR），本身不填充任何文字内容</li>
<li> <b>SIGN_MULTI_LINE_TEXT</b> : 多行文本，<font color="red">仅可用在签批控件内部作为组合控件，单独无法使用</font>，常用作批注附言</li>
<li> <b>SIGN_SELECTOR</b> : 选择器，<font color="red">仅可用在签批控件内部作为组合控件，单独无法使用</font>，常用作审批意见的选择</li>
<li> <b>SIGN_LEGAL_PERSON_SEAL</b> : 企业法定代表人控件。</li></ul>
* 个人方
<ul><li> <b>SIGN_DATE</b> : 签署日期控件；</li>
<li> <b>SIGN_SIGNATURE</b> : 用户签名控件；</li>
<li> <b>SIGN_OPINION</b> : 签署意见控件，用户需要根据配置的签署意见内容，完成对意见内容的确认；</li>
<li> <b>SIGN_VIRTUAL_COMBINATION</b> : 签批控件。内部包含最多4个特定控件（SIGN_SIGNATURE，SIGN_DATA,SIGN_MULTI_LINE_TEXT,SIGN_SELECTOR），本身不填充任何文字内容</li>
<li> <b>SIGN_MULTI_LINE_TEXT</b> : 多行文本，<font color="red">仅可用在签批控件内部作为组合控件，单独无法使用</font>，常用作批注附言</li>
<li> <b>SIGN_SELECTOR</b> : 选择器，<font color="red">仅可用在签批控件内部作为组合控件，单独无法使用</font>，常用作审批意见的选择</li>
</ul>
注：` 表单域的控件不能作为印章和签名控件`
*/
ComponentType?: string;
/**
* **在绝对定位方式方式下**，ComponentName为控件名，长度不能超过20，只能由中文、字母、数字和下划线组成，可以在后续的操作中使用该名称来引用控件。
**在表单域定位方式下**，ComponentName不仅为控件名，也是表单域名称。
注：`控件名可以在一个PDF中可以重复`
<a href="https://qcloudimg.tencent-cloud.cn/raw/93178569d07b4d7dbbe0967ae679e35c.png" target="_blank">点击查看ComponentName在模板页面的位置</a>
*/
ComponentName?: string;
/**
* 如果是<b>填写控件</b>，ComponentRequired表示在填写页面此控件是否必填
<ul><li>false（默认）：可以不填写</li>
<li>true ：必须填写此填写控件</li></ul>
如果是<b>签署控件</b>，签批控件中签署意见等可以不填写， 其他签署控件不受此字段影响
*/
ComponentRequired?: boolean;
/**
* **在通过接口拉取控件信息场景下**，为出参参数，此控件归属的参与方的角色ID角色（即RecipientId），**发起合同时候不要填写此字段留空即可**
*/
ComponentRecipientId?: string;
/**
* <font color="red">【暂未使用】</font>控件所属文件的序号（取值为：0-N）。 目前单文件的情况下，值一直为0
*/
FileIndex?: number;
/**
* 控件生成的方式：
<ul><li> <b>NORMAL</b> : 绝对定位控件</li>
<li> <b>FIELD</b> : 表单域</li>
<li> <b>KEYWORD</b> : 关键字（设置关键字时，请确保PDF原始文件内是关键字以文字形式保存在PDF文件中，不支持对图片内文字进行关键字查找）</li></ul>
*/
GenerateMode?: string;
/**
* **在绝对定位方式和关键字定位方式下**，指定控件宽度，控件宽度是指控件在PDF文件中的宽度，单位为pt（点）。
*/
ComponentWidth?: number;
/**
* **在绝对定位方式和关键字定位方式下**，指定控件的高度， 控件高度是指控件在PDF文件中的高度，单位为pt（点）。
*/
ComponentHeight?: number;
/**
* **在绝对定位方式方式下**，指定控件所在PDF文件上的页码
**在使用文件发起的情况下**，绝对定位方式的填写控件和签署控件支持使用负数来指定控件在PDF文件上的页码，使用负数时，页码从最后一页开始。例如：ComponentPage设置为-1，即代表在PDF文件的最后一页，以此类推。
注：
1. 页码编号是从<font color="red">1</font>开始编号的。
2. <font color="red">页面编号不能超过PDF文件的页码总数</font>。如果指定的页码超过了PDF文件的页码总数，在填写和签署时会出现错误，导致无法正常进行操作。
*/
ComponentPage?: number;
/**
* **在绝对定位方式和关键字定位方式下**，可以指定控件横向位置的位置，单位为pt（点）。
*/
ComponentPosX?: number;
/**
* **在绝对定位方式和关键字定位方式下**，可以指定控件纵向位置的位置，单位为pt（点）。
*/
ComponentPosY?: number;
/**
* **在所有的定位方式下**，控件的扩展参数，为<font color="red">JSON格式</font>，不同类型的控件会有部分非通用参数。
<font color="red">ComponentType为TEXT、MULTI_LINE_TEXT时</font>，支持以下参数：
<ul><li> <b>Font</b>：目前只支持黑体、宋体、仿宋</li>
<li> <b>FontSize</b>： 范围6 :72</li>
<li> <b>FontAlign</b>： Left/Right/Center，左对齐/居中/右对齐</li>
<li> <b>FontColor</b>：字符串类型，格式为RGB颜色数字</li></ul>
<b>参数样例</b>：`{"FontColor":"255,0,0","FontSize":12}`
<font color="red">ComponentType为DATE时</font>，支持以下参数：
<ul><li> <b>Font</b>：目前只支持黑体、宋体、仿宋</li>
<li> <b>FontSize</b>： 范围6 :72</li></ul>
<b>参数样例</b>：`{"FontColor":"255,0,0","FontSize":12}`
<font color="red">ComponentType为FILL_IMAGE时</font>，支持以下参数：
<ul><li> <b>NotMakeImageCenter</b>：bool。是否设置图片居中。false：居中（默认）。 true : 不居中</li>
<li> <b>FillMethod</b> : int. 填充方式。0-铺满（默认）；1-等比例缩放</li></ul>
<font color="red">ComponentType为SIGN_SIGNATURE类型时</font>，可以**ComponentTypeLimit**参数控制签署方式
<ul><li> <b>HANDWRITE</b> : 需要实时手写的手写签名</li>
<li> <b>HANDWRITTEN_ESIGN</b> : 长效手写签名， 是使用保存到个人中心的印章列表的手写签名(并且包含HANDWRITE)</li>
<li> <b>OCR_ESIGN</b> : AI智能识别手写签名</li>
<li> <b>ESIGN</b> : 个人印章类型</li>
<li> <b>SYSTEM_ESIGN</b> : 系统签名（该类型可以在用户签署时根据用户姓名一键生成一个签名来进行签署）</li>
<li> <b>IMG_ESIGN</b> : 图片印章(该类型支持用户在签署将上传的PNG格式的图片作为签名)</li></ul>
<b>参考样例</b>：`{"ComponentTypeLimit": ["SYSTEM_ESIGN"]}`
印章的对应关系参考下图
<br><br>
<font color="red">ComponentType为SIGN_SEAL 或者 SIGN_PAGING_SEAL类型时</font>，可以通过**ComponentTypeLimit**参数控制签署方签署时要使用的印章类型，支持指定以下印章类型
<ul><li> <b>OFFICIAL</b> : 企业公章</li>
<li> <b>CONTRACT</b> : 合同专用章</li>
<li> <b>FINANCE</b> : 财务专用章</li>
<li> <b>PERSONNEL</b> : 人事专用章</li>
<li> <b>OTHER</b> : 其他</li>
</ul>
<b>参考样例</b>：`{\"ComponentTypeLimit\":[\"PERSONNEL\",\"FINANCE\"]}` 表示改印章签署区,客户需使用人事专用章或财务专用章盖章签署。<br><br>
<font color="red">ComponentType为SIGN_DATE时</font>，支持以下参数：
<ul><li> <b>Font</b> :字符串类型目前只支持"黑体"、"宋体"、仿宋，如果不填默认为"黑体"</li>
<li> <b>FontSize</b> : 数字类型，范围6-72，默认值为12</li>
<li> <b>FontAlign</b> : 字符串类型，可取Left/Right/Center，对应左对齐/居中/右对齐</li>
<li> <b>Format</b> : 字符串类型，日期格式，必须是以下五种之一 “yyyy m d”，”yyyy年m月d日”，”yyyy/m/d”，”yyyy-m-d”，”yyyy.m.d”。</li>
<li> <b>Gaps</b> : 字符串类型，仅在Format为“yyyy m d”时起作用，格式为用逗号分开的两个整数，例如”2,2”，两个数字分别是日期格式的前后两个空隙中的空格个数</li></ul>
如果extra参数为空，默认为”yyyy年m月d日”格式的居中日期
特别地，如果extra中Format字段为空或无法被识别，则extra参数会被当作默认值处理（Font，FontSize，Gaps和FontAlign都不会起效）
<b>参数样例</b>： ` "{"Format":"yyyy m d","FontSize":12,"Gaps":"2,2", "FontAlign":"Right"}"`
<font color="red">ComponentType为SIGN_SEAL、SIGN_SIGNATURE类型时</font>，支持以下参数：
<ul><li> <b>PageRanges</b> :PageRange的数组，通过PageRanges属性设置该印章在PDF所有页面上盖章（适用于标书在所有页面盖章的情况）</li></ul>
<b>参数样例</b>：` "{"PageRanges":[{"BeginPage":1,"EndPage":-1}]}"`
<font color="red">签署印章旋转功能，当ComponentType为SIGN_SIGNATURE、SIGN_DATE、SIGN_SEAL时</font>，可以通过以下参数设置签署图片的旋转角度：
<ul><li> <b>Rotate</b>：旋转角度，支持范围：-360：360，为正整数时，为顺时针旋转；为负整数时，为逆时针旋转。</li>
<li> <b>RotateRelation</b>：旋转关联控件，用于指定关联旋转的控件。例如：让印章控件和签署日期控件按照印章控件为中心旋转（此时，设置印章控件的RotateRelation为日期控件的ComponentId，设置日期签署控件的RotateRelation为印章控件的ComponentId）。</li></ul>
<b>参数样例</b>：`{"Rotate":-30,"RotateRelation":"Component_Id1"}`
<font color="red">签署印章透明度功能设置，</font>当ComponentType为SIGN_SIGNATURE、SIGN_SEAL、SIGN_PAGING_SEAL、SIGN_LEGAL_PERSON_SEAL时，可以通过以下参数设置签署印章的透明度：
<ul><li> <b>Opacity</b>：印章透明度，支持范围：0-1，0.7表示70%的透明度，1表示无透明度</li></ul>
<b>参数样例</b>：`{"Opacity":0.7}`
<font color="red">签署印章大小功能设置，</font>当ComponentType为SIGN_SEAL、SIGN_PAGING_SEAL、SIGN_LEGAL_PERSON_SEAL时，可以通过以下参数设置签署时按照实际印章的大小进行签署，如果印章没有设置大小，那么默认会是4.2cm的印章大小：
<ul><li> <b>UseSealSize</b>：使用印章设置的大小盖章，true表示使用印章设置的大小盖章，false表示使用签署控件的大小进行盖章；不传则为false</li></ul>
<b>参数样例</b>：`{"UseSealSize":true}`
<font color="red">关键字模式下支持关键字找不到的情况下不进行报错的设置</font>
<ul><li> <b>IgnoreKeywordError</b> :1-关键字查找不到时不进行报错</li></ul>
场景说明：如果使用关键字进行定位，但是指定的PDF文件中又没有设置的关键字时，发起合同会进行关键字是否存在的校验，如果关键字不存在，会进行报错返回。如果不希望进行报错，可以设置"IgnoreKeywordError"来忽略错误。请注意，如果关键字签署控件对应的签署方在整个PDF文件中一个签署控件都没有，还是会触发报错逻辑。
<b>参数样例</b>：` "{"IgnoreKeywordError":1}"`
<font color="red">ComponentType为SIGN_VIRTUAL_COMBINATION时</font>，支持以下参数：
<ul>
<li><b>Children:</b> 绝对定位模式下，用来指定此签批控件的组合子控件 </li>
<b>参数样例</b>：<br>`{"Children":["ComponentId_29","ComponentId_27","ComponentId_28","ComponentId_30"]}`
<li><b>ChildrenComponents:</b> 关键字定位模式下，用来指定此签批控件的组合子控件 </li>
ChildrenComponent结构体定义:
<table border="1"> <thead> <tr> <th>字段名称</th> <th>类型</th> <th>描述</th> </tr> </thead> <tbody> <tr> <td>ComponentType</td> <td>string</td> <td>子控件类型-可选值:SIGN_SIGNATURE,SIGN_DATE,SIGN_SELECTOR,SIGN_MULTI_LINE_TEXT</td> </tr> <tr> <td>ComponentName</td> <td>string</td> <td>子控件名称</td> </tr> <tr> <td>Placeholder</td> <td>string</td> <td>子控件提示语</td> </tr> <tr> <td>ComponentOffsetX</td> <td>float</td> <td>控件偏移位置X（相对于父控件（签批控件的ComponentX））</td> </tr> <tr> <td>ComponentOffsetY</td> <td>float</td> <td>控件偏移位置Y 相对于父控件（签批控件的ComponentY））</td> </tr> <tr> <td>ComponentWidth</td> <td>float</td> <td>控件宽</td> </tr> <tr> <td>ComponentHeight</td> <td>float</td> <td>控件高</td> </tr> <tr> <td>ComponentExtra</td> <td>string</td> <td>控件的附属信息，根据ComponentType设置</td> </tr> </tbody> </table>
<b>参数样例</b>：
<pre>
{
"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": ""
}
]
}</pre>
</ul>
*/
ComponentExtra?: string;
/**
* 控件填充vaule，ComponentType和传入值类型对应关系：
<ul><li> <b>TEXT</b> : 文本内容</li>
<li> <b>MULTI_LINE_TEXT</b> : 文本内容， 可以用 \n 来控制换行位置</li>
<li> <b>CHECK_BOX</b> : true/false</li>
<li> <b>FILL_IMAGE、ATTACHMENT</b> : 附件的FileId，需要通过UploadFiles接口上传获取</li>
<li> <b>SELECTOR</b> : 选项值</li>
<li> <b>DYNAMIC_TABLE</b> - 传入json格式的表格内容，详见说明：[数据表格](https://qian.tencent.com/developers/company/dynamic_table)</li>
<li> <b>DATE</b> : 格式化：xxxx年xx月xx日（例如：2024年05月28日）</li>
<li> <b>SIGN_SEAL</b> : 印章ID，于控制台查询获取，[点击查看在控制上的位置](https://qcloudimg.tencent-cloud.cn/raw/cd403a5b949fce197fd9e88bb6db1517.png)</li>
<li> <b>SIGN_PAGING_SEAL</b> : 可以指定印章ID，于控制台查询获取，[点击查看在控制上的位置](https://qcloudimg.tencent-cloud.cn/raw/cd403a5b949fce197fd9e88bb6db1517.png)</li></ul>
<b>控件值约束说明</b>：
<table> <thead> <tr> <th>特殊控件</th> <th>填写约束</th> </tr> </thead> <tbody> <tr> <td>企业全称控件</td> <td>企业名称中文字符中文括号</td> </tr> <tr> <td>统一社会信用代码控件</td> <td>企业注册的统一社会信用代码</td> </tr> <tr> <td>法人名称控件</td> <td>最大50个字符，2到25个汉字或者1到50个字母</td> </tr> <tr> <td>签署意见控件</td> <td>签署意见最大长度为50字符</td> </tr> <tr> <td>签署人手机号控件</td> <td>国内手机号 13,14,15,16,17,18,19号段长度11位</td> </tr> <tr> <td>签署人身份证控件</td> <td>合法的身份证号码检查</td> </tr> <tr> <td>控件名称</td> <td>控件名称最大长度为20字符，不支持表情</td> </tr> <tr> <td>单行文本控件</td> <td>只允许输入中文，英文，数字，中英文标点符号，不支持表情</td> </tr> <tr> <td>多行文本控件</td> <td>只允许输入中文，英文，数字，中英文标点符号，不支持表情</td> </tr> <tr> <td>勾选框控件</td> <td>选择填字符串true，不选填字符串false</td> </tr> <tr> <td>选择器控件</td> <td>同单行文本控件约束，填写选择值中的字符串</td> </tr> <tr> <td>数字控件</td> <td>请输入有效的数字(可带小数点)</td> </tr> <tr> <td>日期控件</td> <td>格式：yyyy年mm月dd日</td> </tr> <tr> <td>附件控件</td> <td>JPG或PNG图片，上传数量限制，1到6个，最大6个附件，填写上传的资源ID</td> </tr> <tr> <td>图片控件</td> <td>JPG或PNG图片，填写上传的图片资源ID</td> </tr> <tr> <td>邮箱控件</td> <td>有效的邮箱地址, w3c标准</td> </tr> <tr> <td>地址控件</td> <td>只允许输入中文，英文，数字，中英文标点符号，不支持表情</td> </tr> <tr> <td>省市区控件</td> <td>只允许输入中文，英文，数字，中英文标点符号，不支持表情</td> </tr> <tr> <td>性别控件</td> <td>选择值中的字符串</td> </tr> <tr> <td>学历控件</td> <td>选择值中的字符串</td> </tr><tr> <td>水印控件</td> <td>水印控件设置为CUSTOM_WATERMARK类型时的水印内容</td> </tr> </tbody> </table>
注： `部分特殊控件需要在控制台配置模板形式创建`
*/
ComponentValue?: string;
/**
* <font color="red">【暂未使用】</font>日期签署控件的字号，默认为 12
*/
ComponentDateFontSize?: number;
/**
* <font color="red">【暂未使用】</font>控件归属的文档的ID， **发起合同时候不要填写此字段留空即可**
*/
DocumentId?: string;
/**
* <font color="red">【暂未使用】</font>控件描述，用户自定义，不影响合同发起流程
*/
ComponentDescription?: string;
/**
* **如果控件是关键字定位方式**，可以对关键字定位出来的区域进行横坐标方向的调整，单位为pt（点）。例如，如果关键字定位出来的区域偏左或偏右，可以通过调整横坐标方向的参数来使控件位置更加准确。
注意： `向左调整设置为负数， 向右调整设置成正数`
*/
OffsetX?: number;
/**
* **如果控件是关键字定位方式**，可以对关键字定位出来的区域进行纵坐标方向的调整，单位为pt（点）。例如，如果关键字定位出来的区域偏上或偏下，可以通过调整纵坐标方向的参数来使控件位置更加准确。
注意： `向上调整设置为负数， 向下调整设置成正数`
*/
OffsetY?: number;
/**
* <font color="red">【暂未使用】</font>第三方应用集成平台模板控件 ID 标识
*/
ChannelComponentId?: string;
/**
* **如果控件是关键字定位方式**，指定关键字排序规则时，可以选择Positive或Reverse两种排序方式。
<ul><li> <b>Positive</b> :表示正序，即根据关键字在PDF文件内的顺序进行排列</li>
<li> <b>Reverse</b> :表示倒序，即根据关键字在PDF文件内的反序进行排列</li></ul>
在指定KeywordIndexes时，如果使用Positive排序方式，0代表在PDF内查找内容时，查找到的第一个关键字；如果使用Reverse排序方式，0代表在PDF内查找内容时，查找到的最后一个关键字。
*/
KeywordOrder?: string;
/**
* **如果控件是关键字定位方式**，在KeywordPage中指定关键字页码时，将只会在该页码中查找关键字，非该页码的关键字将不会查询出来。如果不设置查找所有页面中的关键字。
*/
KeywordPage?: number;
/**
* **如果控件是关键字定位方式**，关键字生成的区域的对齐方式， 可以设置下面的值
<ul><li> <b>Middle</b> :居中</li>
<li> <b>Below</b> :正下方</li>
<li> <b>Right</b> :正右方</li>
<li> <b>LowerRight</b> :右下角</li>
<li> <b>UpperRight</b> :右上角。</li></ul>
示例：如果设置Middle的关键字盖章，则印章的中心会和关键字的中心重合，如果设置Below，则印章在关键字的正下方
*/
RelativeLocation?: string;
/**
* **如果控件是关键字定位方式**，关键字索引是指在PDF文件中存在多个相同的关键字时，通过索引指定使用哪一个关键字作为最后的结果。可以通过指定多个索引来同时使用多个关键字。例如，[0,2]表示使用PDF文件内第1个和第3个关键字位置作为最后的结果。
注意：关键字索引是从0开始计数的
*/
KeywordIndexes?: Array<number | bigint>;
/**
* 填写控件在腾讯电子签小程序填写界面展示的提示信息，例如，在身份证号码填写控件中，提示信息可以设置成“请输入18位身份证号码”。
注：`签署控件设置此字段无效`
*/
Placeholder?: string;
/**
* **web嵌入发起合同场景下**， 是否锁定填写和签署控件值不允许嵌入页面进行编辑
<ul><li>false（默认）：不锁定控件值，允许在页面编辑控件值</li>
<li>true：锁定控件值，在页面编辑控件值</li></ul>
*/
LockComponentValue?: boolean;
/**
* **web嵌入发起合同场景下**，是否禁止移动和删除填写和签署控件
<ul><li> <b>false（默认）</b> :不禁止移动和删除控件</li>
<li> <b>true</b> : 可以移动和删除控件</li></ul>
*/
ForbidMoveAndDelete?: boolean;
}
/**
* DescribeUserFlowType返回参数结构体
*/
export interface DescribeUserFlowTypeResponse {
/**
* 查询到的所有用户合同类型列表
*/
AllUserFlowTypes?: Array<TemplateUserFlowType>;
/**
* 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* ChannelDeleteSealPolicies请求参数结构体
*/
export interface ChannelDeleteSealPoliciesRequest {
/**
* 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
*/
Agent: Agent;
/**
* 操作的印章ID
*/
SealId: string;
/**
* 需要删除授权的用户ID数组，可以传入电子签系统用户ID或OpenId。
注:
1. `填写OpenId时，系统会通过组织+渠道+OpenId查询得到对应的UserId进行授权取消操作`
*/
UserIds: Array<string>;
/**
* 组织机构信息，不用传
* @deprecated
*/
Organization?: OrganizationInfo;
/**
* 操作人（用户）信息，不用传
* @deprecated
*/
Operator?: UserInfo;
}
/**
* ChannelBatchCancelFlows返回参数结构体
*/
export interface ChannelBatchCancelFlowsResponse {
/**
* 签署流程批量撤销失败原因，错误信息与流程Id一一对应，成功为"", 失败则对应失败原因
注: `如果全部撤销成功, 此数组为空数组`
*/
FailMessages?: Array<string>;
/**
* 批量撤销任务编号，为32位字符串，可用于[查询批量撤销合同结果](https://qian.tencent.com/developers/partnerApis/operateFlows/DescribeCancelFlowsTask) 或关联[批量撤销任务结果回调](https://qian.tencent.com/developers/partner/callback_types_contracts_sign#%E4%B9%9D-%E6%89%B9%E9%87%8F%E6%92%A4%E9%94%80%E7%BB%93%E6%9E%9C%E5%9B%9E%E8%B0%83)
*/
TaskId?: string;
/**
* 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 企业批量注册链接信息
*/
export interface OrganizationAuthUrl {
/**
* 跳转链接, 链接的有效期根据企业,员工状态和终端等有区别, 可以参考下表
<table> <thead> <tr> <th>子客企业状态</th> <th>子客企业员工状态</th> <th>Endpoint</th> <th>链接有效期限</th> </tr> </thead> <tbody> <tr> <td>企业未激活</td> <td>员工未认证</td> <td>PC</td> <td>5分钟</td> </tr> <tr> <td>企业未激活</td> <td>员工未认证</td> <td>CHANNEL/SHORT_URL/APP</td> <td>一年</td> </tr> <tr> <td>企业已激活</td> <td>员工未认证</td> <td>PC</td> <td>5分钟</td> </tr> <tr> <td>企业已激活</td> <td>员工未认证</td> <td>CHANNEL/SHORT_URL/APP</td> <td>一年</td> </tr> <tr> <td>企业已激活</td> <td>员工已认证</td> <td>PC</td> <td>5分钟</td> </tr> <tr> <td>企业已激活</td> <td>员工已认证</td> <td>CHANNEL/SHORT_URL/APP</td> <td>一年</td> </tr> </tbody> </table>
注：
`1.链接仅单次有效，每次登录需要需要重新创建新的链接`
`2.创建的链接应避免被转义，如：&被转义为\u0026；如使用Postman请求后，请选择响应类型为 JSON，否则链接将被转义`
*/
AuthUrl?: string;
/**
* 企业批量注册的错误信息，例如：企业三要素不通过
*/
ErrorMessage?: string;
}
/**
* 合同组相关信息，指定合同组子合同和签署方的信息，用于补充动态签署人。
*/
export interface FlowGroupUrlInfo {
/**
* 合同组子合同和签署方的信息，用于补充动态签署人。
*/
FlowGroupApproverInfos?: Array<FlowGroupApproverInfo>;
}
/**
* ChannelDescribeSignFaceVideo请求参数结构体
*/
export interface ChannelDescribeSignFaceVideoRequest {
/**
* 合同流程ID，为32位字符串。
建议开发者妥善保存此流程ID，以便于顺利进行后续操作。
可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
*/
FlowId: string;
/**
* 签署参与人在本流程中的编号ID(每个流程不同)，可用此ID来定位签署参与人在本流程的签署节点，也可用于后续创建签署链接等操作。
*/
SignId: string;
/**
* 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
此接口下面信息必填。
<ul>
<li>渠道应用标识: Agent.AppId</li>
<li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
<li>第三方平台子客企业中的员工标识: Agent. ProxyOperator.OpenId</li>
</ul>
第三方平台子客企业和员工必须已经经过实名认证
*/
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 {
/**
* 是否允许修改签署人信息
*/
CanEditApprover?: boolean;
}
/**
* DescribeCancelFlowsTask返回参数结构体
*/
export interface DescribeCancelFlowsTaskResponse {
/**
* 批量撤销任务编号，为32位字符串。
*/
TaskId?: string;
/**
* 任务状态，需要关注的状态<ul><li>**PROCESSING** - 任务执行中</li><li>**END** - 任务处理完成</li><li>**TIMEOUT** 任务超时未处理完成，用户未在批量撤销链接有效期内操作</li></ul>
*/
TaskStatus?: string;
/**
* 批量撤销成功的签署流程编号
*/
SuccessFlowIds?: Array<string>;
/**
* 批量撤销失败的签署流程信息
*/
FailureFlows?: Array<CancelFailureFlow>;
/**
* 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateEmployeeQualificationSealQrCode返回参数结构体
*/
export interface CreateEmployeeQualificationSealQrCodeResponse {
/**
* 二维码图片的Base64 注: `此二维码的有效时间为7天，过期后需要重新生成新的二维码图片`
*/
QrcodeBase64?: string;
/**
* 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* ChannelCreateFlowGroupByTemplates返回参数结构体
*/
export interface ChannelCreateFlowGroupByTemplatesResponse {
/**
* 合同组ID，为32位字符串。
建议开发者妥善保存此合同组ID，以便于顺利进行后续操作。
*/
FlowGroupId?: string;
/**
* 合同组中每个合同流程ID，每个ID均为32位字符串。
注:
`此数组的顺序和入参中的FlowInfos顺序一致`
*/
FlowIds?: Array<string>;
/**
* 复杂文档合成任务（如，包含动态表格的预览任务）的任务信息数组；
如果文档需要异步合成，此字段会返回该异步任务的任务信息，后续可以通过ChannelGetTaskResultApi接口查询任务详情；
*/
TaskInfos?: Array<TaskInfo>;
/**
* 合同组签署方信息
*/
Approvers?: Array<FlowGroupApprovers>;
/**
* 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* ChannelCreateFlowSignReview请求参数结构体
*/
export interface ChannelCreateFlowSignReviewRequest {
/**
* 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
此接口下面信息必填。
<ul>
<li>渠道应用标识: Agent.AppId</li>
<li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
<li>第三方平台子客企业中的员工标识: Agent. ProxyOperator.OpenId</li>
</ul>
第三方平台子客企业和员工必须已经经过实名认证
*/
Agent: Agent;
/**
* 合同流程ID，为32位字符串。
*/
FlowId: string;
/**
* 企业内部审核结果
<ul><li>PASS: 审核通过（流程可以继续签署或者发起）</li>
<li>REJECT: 审核拒绝（流程状态不变，可以继续调用审核接口通过审核）</li>
<li>SIGN_REJECT:拒签(流程终止，流程状态变为拒签状态)</li></ul>
*/
ReviewType: string;
/**
* 审核结果原因
<ul><li>字符串长度不超过200</li>
<li>当ReviewType 是拒绝（REJECT） 时此字段必填。</li>
<li>当ReviewType 是拒绝（SIGN_REJECT） 时此字段必填。</li></ul>
*/
ReviewMessage?: string;
/**
* 审核节点的签署人标志，用于指定当前审核的签署方。
<font color= "red">注意：以下情况必须传递RecipientId</font>
<ul><li> **发起签署流程时，指定签署人需要审批（即签署人需要审批
<a href="https://qian.tencent.com/developers/partnerApis/dataTypes#flowapproverinfo" target="_blank">ApproverNeedSignReview</a>为true），则必须指定RecipientId**</li><li>**如果签署审核节点是个人， 此参数必填**。</li></ul>
*/
RecipientId?: string;
/**
* 流程审核操作类型，取值如下：
<ul><li>**SignReview**：（默认）签署审核</li>
<li>**CreateReview**：发起审核</li>
<li>注意：`该字段不传或者为空，则默认为SignReview签署审核，走签署审核流程`</li></ul>
*/
OperateType?: string;
}
/**
* 授权出错信息
*/
export interface AuthFailMessage {
/**
* 第三方平台子客企业的唯一标识，长度不能超过64，只能由字母和数字组成。开发者可自定义此字段的值，并需要保存此 ID 以便进行后续操作。
一个第三方平台子客企业主体与子客企业 ProxyOrganizationOpenId 是一一对应的，不可更改，不可重复使用。例如，可以使用企业名称的哈希值，或者社会统一信用代码的哈希值，或者随机哈希值。
*/
ProxyOrganizationOpenId?: string;
/**
* 错误信息
*/
Message?: string;
}
/**
* CreateFlowForwards请求参数结构体
*/
export interface CreateFlowForwardsRequest {
/**
* 合同对应参与方需要修改的目标经办人对应的OpenId。
注意：`需要保证目标经办人已经加入企业且已实名`
*/
TargetOpenId: string;
/**
* 企业签署方的合同及对应签署方
*/
FlowForwardInfos: Array<FlowForwardInfo>;
/**
* 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。此接口下面信息必填。<ul><li>渠道应用标识: Agent.AppId</li><li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li><li>第三方平台子客企业中的员工标识: Agent. ProxyOperator.OpenId</li></ul>第三方平台子客企业和员工必须已经经过实名认证
*/
Agent: Agent;
}
/**
* DescribeFlowDetailInfo请求参数结构体
*/
export interface DescribeFlowDetailInfoRequest {
/**
* 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
此接口下面信息必填。
<ul>
<li>渠道应用标识: Agent.AppId</li>
<li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
<li>第三方平台子客企业中的员工标识: Agent. ProxyOperator.OpenId</li>
</ul>
第三方平台子客企业和员工必须已经经过实名认证
*/
Agent: Agent;
/**
* 需要查询的流程ID列表，最多可传入100个ID。
如果要查询合同组的信息，则不需要传入此参数，只需传入 FlowGroupId 参数即可。
*/
FlowIds?: Array<string>;
/**
* 需要查询的流程组ID，如果传入此参数，则会忽略 FlowIds 参数。
合同组由<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByTemplates" target="_blank">通过多模板创建合同组签署流程</a>和<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByFiles" target="_blank">通过多文件创建合同组签署流程</a>等接口创建。
*/
FlowGroupId?: string;
/**
* 暂未开放
* @deprecated
*/
Operator?: UserInfo;
}
/**
* ChannelCancelFlow返回参数结构体
*/
export interface ChannelCancelFlowResponse {
/**
* 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* ModifyExtendedService请求参数结构体
*/
export interface ModifyExtendedServiceRequest {
/**
* 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
此接口下面信息必填。
<ul>
<li>渠道应用标识: Agent.AppId</li>
<li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
<li>第三方平台子客企业中的员工标识: Agent.ProxyOperator.OpenId</li>
</ul>
第三方平台子客企业和员工必须已经过实名认证
*/
Agent: Agent;
/**
* 扩展服务类型
<ul>
<li>AUTO_SIGN 企业自动签（自动签署）</li>
<li> OVERSEA_SIGN 企业与港澳台居民签署合同</li>
<li> MOBILE_CHECK_APPROVER 使用手机号验证签署方身份</li>
<li> DOWNLOAD_FLOW 授权渠道下载合同 </li>
<li>AGE_LIMIT_EXPANSION 拓宽签署方年龄限制</li>
<li>HIDE_OPERATOR_DISPLAY 隐藏合同经办人姓名</li>
</ul>
*/
ServiceType: string;
/**
* 操作类型
<ul>
<li>OPEN : 开通</li>
<li>CLOSE : 关闭</li>
</ul>
*/
Operate: string;
/**
* 链接跳转类型，支持以下类型
<ul>
<li>WEIXINAPP : 短链直接跳转到电子签小程序 (默认值)</li>
<li>APP : 第三方APP或小程序跳转电子签小程序</li>
<li>WEIXIN_QRCODE_URL：直接跳转至电子签小程序的二维码链接，无需通过中转页。<font color="red">您需要自行将其转换为二维码，使用微信扫码后可直接进入。请注意，直接点击链接是无效的。</font></li>
</ul>
*/
Endpoint?: string;
}
/**
* DescribeResourceUrlsByFlows请求参数结构体
*/
export interface DescribeResourceUrlsByFlowsRequest {
/**
* 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
此接口下面信息必填。
<ul>
<li>渠道应用标识: Agent.AppId</li>
<li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
<li>第三方平台子客企业中的员工标识: Agent.ProxyOperator.OpenId</li>
</ul>
第三方平台子客企业和员工必须已经经过实名认证
*/
Agent: Agent;
/**
* 需要下载的合同流程的ID, 至少需要1个, 做多50个
*/
FlowIds?: Array<string>;
/**
* 操作者的信息，不用传
* @deprecated
*/
Operator?: UserInfo;
}
/**
* 意愿核身问答模式结果。若未使用该意愿核身功能，该字段返回值可以不处理。
*/
export interface IntentionQuestionResult {
/**
* 视频base64（其中包含全程问题和回答音频，mp4格式）
注：`需进行base64解码获取视频文件`
*/
Video?: string;
/**
* 和答案匹配结果列表
*/
ResultCode?: Array<string>;
/**
* 回答问题语音识别结果列表
*/
AsrResult?: Array<string>;
}
/**
* 企业扩展服务授权列表详情
*/
export interface AuthInfoDetail {
/**
* 扩展服务类型，和入参一致
*/
Type?: string;
/**
* 扩展服务名称
*/
Name?: string;
/**
* 授权员工列表
*/
HasAuthUserList?: Array<HasAuthUser>;
/**
* 授权企业列表（企业自动签时，该字段有值）
*/
HasAuthOrganizationList?: Array<HasAuthOrganization>;
/**
* 授权员工列表总数
*/
AuthUserTotal?: number;
/**
* 授权企业列表总数
*/
AuthOrganizationTotal?: number;
}
/**
* CreateChannelOrganizationInfoChangeUrl返回参数结构体
*/
export interface CreateChannelOrganizationInfoChangeUrlResponse {
/**
* 创建的企业信息变更链接。需要在移动端打开，会跳转到微信腾讯电子签小程序进行更换。
*/
Url?: string;
/**
* 链接过期时间。链接7天有效。
*/
ExpiredTime?: number;
/**
* 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 催办接口返回的详细信息。
*/
export interface RemindFlowRecords {
/**
* 合同流程是否可以催办： true - 可以，false - 不可以。 若无法催办，将返回RemindMessage以解释原因。
*/
CanRemind?: boolean;
/**
* 合同流程ID，为32位字符串。
*/
FlowId?: string;
/**
* 在合同流程无法催办的情况下，系统将返回RemindMessage以阐述原因。
*/
RemindMessage?: string;
}
/**
* ChannelCreateFlowSignUrl返回参数结构体
*/
export interface ChannelCreateFlowSignUrlResponse {
/**
* 签署人签署链接信息
*/
FlowApproverUrlInfos?: Array<FlowApproverUrlInfo>;
/**
* 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 被授权的用户信息
*/
export interface HasAuthUser {
/**
* 第三方应用平台自定义，对应第三方平台子客企业员工的唯一标识。
*/
OpenId?: string;
}
/**
* ChannelCreateBatchSignUrl返回参数结构体
*/
export interface ChannelCreateBatchSignUrlResponse {
/**
* 批量签署链接，以短链形式返回，短链的有效期参考回参中的 ExpiredTime。
注:
1. 非小程序和APP集成使用
2. <font color="red">生成的链路后面不能再增加参数</font>（会出现覆盖链接中已有参数导致错误）
*/
SignUrl?: string;
/**
* 链接过期时间以 Unix 时间戳格式表示，从生成链接时间起，往后7天有效期。过期后短链将失效，无法打开。
*/
ExpiredTime?: number;
/**
* 从客户小程序或者客户APP跳转至腾讯电子签小程序进行批量签署的跳转路径
注:
1. 小程序和APP集成使用
2. <font color="red">生成的链路后面不能再增加参数</font>（会出现覆盖链接中已有参数导致错误）
*/
MiniAppPath?: string;
/**
* 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* ChannelCreatePrepareFlow返回参数结构体
*/
export interface ChannelCreatePrepareFlowResponse {
/**
* 发起的合同嵌入链接， 可以直接点击进入进行合同发起， 有效期为5分钟
*/
PrepareFlowUrl?: string;
/**
* 合同发起后预览链接， 注意此时合同并未发起，仅只是展示效果， 有效期为5分钟
*/
PreviewFlowUrl?: string;
/**
* 发起的合同临时Id， 只有当点击进入链接，成功发起合同后， 此Id才有效
*/
FlowId?: 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;
/**
* 描述模板可见性更改的结果。
<ul>
<li>all-success: 全部成功</li>
<li>part-success: 部分成功,失败的会在FailMessageList中展示</li>
<li>fail:全部失败, 失败的会在FailMessageList中展示</li>
</ul>
*/
OperateResult?: string;
/**
* 模板可见范围:
**all**: 所有本第三方应用合作企业可见
**part**: 指定的本第三方应用合作企业
*/
AuthTag?: string;
/**
* 第三方平台子客企业标识列表
*/
ProxyOrganizationOpenIds?: Array<string>;
/**
* 操作失败信息数组
*/
FailMessageList?: Array<AuthFailMessage>;
/**
* 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* ChannelCreateDynamicFlowApprover返回参数结构体
*/
export interface ChannelCreateDynamicFlowApproverResponse {
/**
* 动态合同补充结果列表
*/
DynamicFlowResultList?: Array<DynamicFlowResult>;
/**
* 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 合同组中每个子合同的发起信息
*/
export interface FlowFileInfo {
/**
* 签署文件资源Id列表，目前仅支持单个文件
*/
FileIds: Array<string>;
/**
* 签署流程名称，长度不超过200个字符
*/
FlowName: string;
/**
* 签署流程签约方列表，最多不超过5个参与方
*/
FlowApprovers: Array<FlowApproverInfo>;
/**
* 签署流程截止时间，十位数时间戳，最大值为33162419560，即3020年
*/
Deadline?: number;
/**
* 签署流程的描述，长度不超过1000个字符
*/
FlowDescription?: string;
/**
* 签署流程的类型，长度不超过255个字符
*/
FlowType?: string;
/**
* 已废弃，请使用【应用号配置】中的回调地址统一接收消息
* @deprecated
*/
CallbackUrl?: string;
/**
* 第三方应用的业务信息，最大长度1000个字符。
*/
CustomerData?: string;
/**
* 合同签署顺序类型(无序签,顺序签)，默认为false，即有序签署
*/
Unordered?: boolean;
/**
* 签署文件中的发起方的填写控件，需要在发起的时候进行填充
*/
Components?: Array<Component>;
/**
* 合同显示的页卡模板，说明：只支持{合同名称}, {发起方企业}, {发起方姓名}, {签署方N企业}, {签署方N姓名}，且N不能超过签署人的数量，N从1开始
*/
CustomShowMap?: string;
/**
* 本企业(发起方企业)是否需要签署审批
*/
NeedSignReview?: boolean;
/**
* 在短信通知、填写、签署流程中，若标题、按钮、合同详情等地方存在“合同”字样时，可根据此配置指定文案，可选文案如下： <ul><li> <b>0</b> :合同（默认值）</li> <li> <b>1</b> :文件</li> <li> <b>2</b> :协议</li><li> <b>3</b> :文书</li></ul>效果如下:
*/
FlowDisplayType?: number;
}
/**
* 创建合同个性化参数
*/
export interface CreateFlowOption {
/**
* 是否允许修改合同信息，
**true**：可以
**false**：（默认）不可以
*/
CanEditFlow?: boolean;
/**
* 是否允许发起合同弹窗隐藏合同名称
**true**：允许
**false**：（默认）不允许
*/
HideShowFlowName?: boolean;
/**
* 是否允许发起合同弹窗隐藏合同类型，
**true**：允许
**false**：（默认）不允许
*/
HideShowFlowType?: boolean;
/**
* 是否允许发起合同弹窗隐藏合同到期时间
**true**：允许
**false**：（默认）不允许
*/
HideShowDeadline?: boolean;
/**
* 是否允许发起合同步骤跳过指定签署方步骤
**true**：允许
**false**：（默认）不允许
*/
CanSkipAddApprover?: boolean;
/**
* 是否可以编辑签署人包括新增，修改，删除
<ul><li>（默认） false -可以编辑签署人</li> <li> true - 禁止编辑签署人</li></ul>
注意：如果设置参数为 true， 则 参数签署人 [FlowApproverList](https://qian.tencent.com/developers/partnerApis/embedPages/ChannelCreatePrepareFlow) 不能为空
*/
ForbidEditApprover?: boolean;
/**
* 定制化发起合同弹窗的描述信息，长度不能超过500，只能由中文、字母、数字和标点组成。
*/
CustomCreateFlowDescription?: string;
/**
* 禁止编辑填写控件
**true**：禁止编辑填写控件
**false**：（默认）允许编辑填写控件
*/
ForbidEditFillComponent?: boolean;
/**
* 跳过上传文件步骤
**true**：跳过
**false**：（默认）不跳过，需要传ResourceId
*/
SkipUploadFile?: boolean;
/**
* 签署控件的配置信息，用在嵌入式发起的页面配置，包括
- 签署控件 是否默认展示日期.
*/
SignComponentConfig?: SignComponentConfig;
}
/**
* ChannelCreateRole请求参数结构体
*/
export interface ChannelCreateRoleRequest {
/**
* 角色名称，最大长度为20个字符，仅限中文、字母、数字和下划线组成。
*/
Name: string;
/**
* 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
此接口下面信息必填。
<ul>
<li>渠道应用标识: Agent.AppId</li>
<li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
<li>第三方平台子客企业中的员工标识: Agent. ProxyOperator.OpenId</li>
</ul>
第三方平台子客企业和员工必须已经经过实名认证
*/
Agent: Agent;
/**
* 角色描述，最大长度为50个字符
*/
Description?: string;
/**
* 权限树，权限树内容 PermissionGroups 可参考接口 ChannelDescribeRoles 的输出
*/
PermissionGroups?: Array<PermissionGroup>;
}
/**
* CreateOrganizationAuthFile返回参数结构体
*/
export interface CreateOrganizationAuthFileResponse {
/**
* 授权书链接，有效期5分钟。
*/
FileUrl?: string;
/**
* 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 基础流程信息
*/
export interface BaseFlowInfo {
/**
* 合同流程的名称（可自定义此名称），长度不能超过200，只能由中文、字母、数字和下划线组成。
*/
FlowName: string;
/**
* 合同流程的签署截止时间，格式为Unix标准时间戳（秒），如果在签署截止时间前未完成签署，则合同状态会变为已过期，导致合同作废。
*/
Deadline: number;
/**
* 合同流程的类别分类（可自定义名称，如销售合同/入职合同等），最大长度为200个字符，仅限中文、字母、数字和下划线组成。
*/
FlowType?: string;
/**
* 合同流程描述信息(可自定义此描述)，最大长度1000个字符。
*/
FlowDescription?: string;
/**
* 合同流程的签署顺序类型：
**false**：(默认)有序签署, 本合同多个参与人需要依次签署
**true**：无序签署, 本合同多个参与人没有先后签署限制
*/
Unordered?: boolean;
/**
* 是否打开智能添加填写区(默认开启，打开:"OPEN" 关闭："CLOSE")
*/
IntelligentStatus?: string;
/**
* 填写控件内容， 填写的控制的ID-填写的内容对列表
*/
FormFields?: Array<FormField>;
/**
* 发起方企业的签署人进行签署操作前，是否需要企业内部走审批流程，取值如下：
<ul><li> **false**：（默认）不需要审批，直接签署。</li>
<li> **true**：需要走审批流程。当到对应参与人签署时，会阻塞其签署操作，等待企业内部审批完成。</li></ul>
企业可以通过CreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果
<ul><li> 如果企业通知腾讯电子签平台审核通过，签署方可继续签署动作。</li>
<li> 如果企业通知腾讯电子签平台审核未通过，平台将继续阻塞签署方的签署动作，直到企业通知平台审核通过。</li></ul>
注：`此功能可用于与企业内部的审批流程进行关联，支持手动、静默签署合同`
*/
NeedSignReview?: boolean;
/**
* 调用方自定义的个性化字段(可自定义此名称)，并以base64方式编码，支持的最大数据大小为1000长度。
在合同状态变更的回调信息等场景中，该字段的信息将原封不动地透传给贵方。回调的相关说明可参考开发者中心的回调通知模块。
*/
UserData?: string;
/**
* 合同流程的抄送人列表，最多可支持50个抄送人，抄送人可查看合同内容及签署进度，但无需参与合同签署。
注
1. 抄送人名单中可以包括自然人以及本企业的员工（本企业员工必须已经完成认证并加入企业）。
2. 请确保抄送人列表中的成员不与任何签署人重复。
*/
CcInfos?: Array<CcInfo>;
/**
* 发起方企业的签署人进行发起操作是否需要企业内部审批。使用此功能需要发起方企业有参与签署。
若设置为true，发起审核结果需通过接口 [提交企业签署流程审批结果](https://qian.tencent.com/developers/partnerApis/operateFlows/ChannelCreateFlowSignReview)通知电子签，审核通过后，发起方企业签署人方可进行发起操作，否则会阻塞其发起操作。
*/
NeedCreateReview?: boolean;
/**
* 填写控件：文件发起使用
*/
Components?: Array<Component>;
/**
* 在短信通知、填写、签署流程中，若标题、按钮、合同详情等地方存在“合同”字样时，可根据此配置指定文案，可选文案如下： <ul><li> <b>0</b> :合同（默认值）</li> <li> <b>1</b> :文件</li> <li> <b>2</b> :协议</li><li> <b>3</b> :文书</li></ul>效果如下:
*/
FlowDisplayType?: number;
}
/**
* 解除协议的签署人，如不指定，默认使用待解除流程(原流程)中的签署人。</br>
`注意`:
- 不支持更换C端(个人身份类型)签署人，如果原流程中含有C端签署人，默认使用原流程中的该签署人。
- 目前不支持替换C端(个人身份类型)签署人，但是可以指定C端签署人的签署方自定义控件别名，具体见参数ApproverSignRole描述。
- 当指定C端签署人的签署方自定义控件别名不空时，除参数ApproverNumber外，可以只传参数ApproverSignRole。
如果需要指定B端(企业身份类型)签署人，其中ReleasedApprover需要传递的参数如下：
(`ApproverNumber`, `ReleasedApproverRecipientId`这两个二选一), `OrganizationName`, `ApproverType`必传。</br>
对于其他身份标识：
- **子客企业指定经办人**：OpenId必传，OrganizationOpenId必传；
- **非子客企业经办人**：Name、Mobile必传。
*/
export interface ReleasedApprover {
/**
* 签署人在原合同签署人列表中的顺序序号(从0开始，按顺序依次递增)。
可以通过<a href="https://qian.tencent.com/developers/partnerApis/flows/DescribeFlowDetailInfo" target="_blank">DescribeFlowDetailInfo</a>接口查看原流程中的签署人列表。
*/
ApproverNumber: number;
/**
* 指定签署人类型，目前支持
<ul><li> **ORGANIZATION**：企业(默认值)</li>
<li> **ENTERPRISESERVER**：企业静默签</li></ul>
*/
ApproverType: string;
/**
* 签署人在原合同中的RecipientId，可以通过<a href="https://qian.tencent.com/developers/partnerApis/flows/DescribeFlowDetailInfo" target="_blank">DescribeFlowDetailInfo</a>接口查看原流程中的签署人信息，可参考返回结构体<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#flowapproverdetail" target="_blank">FlowApproverDetail</a>中的RecipientId。
**注意**：当指定了此参数后，ApproverNumber即失效，会以本参数作为原合同参与人的选取。与ApproverNumber二选一。
*/
ReleasedApproverRecipientId?: string;
/**
* 签署人姓名，最大长度50个字。
*/
Name?: string;
/**
* 签署方经办人的证件类型，支持以下类型
<ul><li>ID_CARD : 中国大陆居民身份证(默认值)</li>
<li>HONGKONG_AND_MACAO : 中国港澳居民来往内地通行证</li>
<li>HONGKONG_MACAO_AND_TAIWAN : 中国港澳台居民居住证(格式同中国大陆居民身份证)</li></ul>
*/
IdCardType?: string;
/**
* 证件号码，应符合以下规则
<ul><li>中国大陆居民身份证号码应为18位字符串，由数字和大写字母X组成(如存在X，请大写)。</li>
<li>中国港澳居民来往内地通行证号码共11位。第1位为字母，“H”字头签发给中国香港居民，“M”字头签发给中国澳门居民；第2位至第11位为数字。
</li>
<li>中国港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。</li></ul>
*/
IdCardNumber?: string;
/**
* 签署人手机号。
*/
Mobile?: string;
/**
* 组织机构名称。
请确认该名称与企业营业执照中注册的名称一致。
如果名称中包含英文括号()，请使用中文括号（）代替。
如果签署方是企业签署方(approverType = 0 或者 approverType = 3)， 则企业名称必填。
*/
OrganizationName?: string;
/**
* 第三方平台子客企业的唯一标识，定义Agent中的ProxyOrganizationOpenId一样, 可以参考<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#agent" target="_blank">Agent结构体</a>。
<font color="red">当为子客企业指定经办人时，此OrganizationOpenId必传。</font>
*/
OrganizationOpenId?: string;
/**
* 第三方平台子客企业员工的唯一标识，长度不能超过64，只能由字母和数字组成。
<font color="red">当签署方为同一第三方平台下的员工时，此OpenId必传。</font>
*/
OpenId?: string;
/**
* 签署控件类型，支持自定义企业签署方的签署控件类型
<ul><li> **SIGN_SEAL**：默认为印章控件类型(默认值)</li>
<li> **SIGN_SIGNATURE**：手写签名控件类型</li></ul>
*/
ApproverSignComponentType?: string;
/**
* 参与方在合同中的角色是按照创建合同的时候来排序的，解除协议默认会将第一个参与人叫`甲方`,第二个叫`乙方`, 第三个叫`丙方`，以此类推。
如果需改动此参与人的角色名字，可用此字段指定，由汉字,英文字符,数字组成，最大20个字。
*/
ApproverSignRole?: string;
/**
* 印章Id，签署控件类型为印章时，用于指定本企业签署方在解除协议中使用那个印章进行签署
*/
ApproverSignSealId?: string;
}
/**
* CreateConsoleLoginUrl返回参数结构体
*/
export interface CreateConsoleLoginUrlResponse {
/**
* 跳转链接, 链接的有效期根据企业,员工状态和终端等有区别, 可以参考下表
<table> <thead> <tr> <th>子客企业状态</th> <th>子客企业员工状态</th> <th>Endpoint</th> <th>链接有效期限</th> </tr> </thead> <tbody> <tr> <td>企业未激活</td> <td>员工未认证</td> <td>PC/PC_SHORT_URL</td> <td>5分钟</td> </tr> <tr> <td>企业未激活</td> <td>员工未认证</td> <td>CHANNEL/APP/H5/SHORT_H5/WEIXIN_QRCODE_URL</td> <td>30天</td> </tr> <tr> <td>企业已激活</td> <td>员工未认证</td> <td>PC/PC_SHORT_URL</td> <td>5分钟</td> </tr> <tr> <td>企业已激活</td> <td>员工未认证</td> <td>CHANNEL/APP/H5/SHORT_H5/WEIXIN_QRCODE_URL</td> <td>30天</td> </tr> <tr> <td>企业已激活</td> <td>员工已认证</td> <td>PC</td> <td>5分钟</td> </tr> <tr> <td>企业已激活</td> <td>员工已认证</td> <td>CHANNEL/APP/H5/SHORT_H5/WEIXIN_QRCODE_URL</td> <td>30天</td> </tr> </tbody> </table>
注：
1. <font color="red">链接仅单次有效</font>，每次登录需要需要重新创建新的链接
2. 创建的链接应避免被转义，如：&被转义为\u0026；如使用Postman请求后，请选择响应类型为 JSON，否则链接将被转义
3. <font color="red">生成的链路后面不能再增加参数</font>（会出现覆盖链接中已有参数导致错误）
*/
ConsoleUrl?: string;
/**
* 子客企业是否已开通腾讯电子签，
<ul><li> **true** :已经开通腾讯电子签</li>
<li> **false** :还未开通腾讯电子签</li></ul>
注：`企业是否实名根据传参Agent.ProxyOrganizationOpenId进行判断，非企业名称或者社会信用代码`
*/
IsActivated?: boolean;
/**
* 当前经办人是否已认证并加入功能
<ul><li> **true** : 已经认证加入公司</li>
<li> **false** : 还未认证加入公司</li></ul>
注意：**员工是否实名是根据Agent.ProxyOperator.OpenId判断，非经办人姓名**
*/
ProxyOperatorIsVerified?: boolean;
/**
* 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* ChannelDeleteRoleUsers请求参数结构体
*/
export interface ChannelDeleteRoleUsersRequest {
/**
* 代理信息此接口Agent.ProxyOrganizationOpenId、Agent. ProxyOperator.OpenId、Agent.AppId 必填。
*/
Agent: Agent;
/**
* 角色Id（非超管或法人角色Id）
*/
RoleId: string;
/**
* 电子签用户ID列表，与OpenIds参数二选一,优先UserIds参数，最多两百
*/
UserIds?: Array<string>;
/**
* 操作人信息
* @deprecated
*/
Operator?: UserInfo;
/**
* 客户系统用户ID列表，与UserIds参数二选一,优先UserIds参数，最多两百
*/
OpenIds?: Array<string>;
}
/**
* ChannelCreateUserRoles返回参数结构体
*/
export interface ChannelCreateUserRolesResponse {
/**
* 绑定失败的用户角色列表
*/
FailedCreateRoleData?: Array<FailedCreateRoleData>;
/**
* 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* SyncProxyOrganization请求参数结构体
*/
export interface SyncProxyOrganizationRequest {
/**
* 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
此接口下面信息必填。
<ul>
<li>渠道应用标识: Agent.AppId</li>
<li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
</ul>
*/
Agent: Agent;
/**
* 第三方平台子客企业名称，请确认该名称与企业营业执照中注册的名称一致。
注: `如果名称中包含英文括号()，请使用中文括号（）代替。`
*/
ProxyOrganizationName: string;
/**
* 营业执照正面照(PNG或JPG) base64格式, 大小不超过5M
*/
BusinessLicense?: string;
/**
* 第三方平台子客企业统一社会信用代码，最大长度200个字符
*/
UniformSocialCreditCode?: string;
/**
* 第三方平台子客企业法定代表人的名字
*/
ProxyLegalName?: string;
/**
* 暂未开放
* @deprecated
*/
Operator?: UserInfo;
/**
* 第三方平台子客企业法定代表人的证件类型，支持以下类型
<ul><li>ID_CARD : 中国大陆居民身份证 (默认值)</li></ul>
注: `现在仅支持ID_CARD中国大陆居民身份证类型`
*/
ProxyLegalIdCardType?: string;
/**
* 第三方平台子客企业法定代表人的证件号码, 应符合以下规则
<ul><li>中国大陆居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。</li></ul>
*/
ProxyLegalIdCardNumber?: string;
/**
* 第三方平台子客企业详细住所，最大长度500个字符
注：`需要符合省市区详情的格式例如： XX省XX市XX区街道具体地址`
*/
ProxyAddress?: string;
}
/**
* ChannelCreatePrepareFlow请求参数结构体
*/
export interface ChannelCreatePrepareFlowRequest {
/**
* 资源类型，取值有：
<ul><li> **1**：模板</li>
<li> **2**：文件（默认值）</li></ul>
*/
ResourceType: number;
/**
* 要创建的合同信息
*/
FlowInfo: BaseFlowInfo;
/**
* 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
此接口下面信息必填。
<ul>
<li>渠道应用标识: Agent.AppId</li>
<li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
<li>第三方平台子客企业中的员工标识: Agent. ProxyOperator.OpenId</li>
</ul>
第三方平台子客企业和员工必须已经经过实名认证
*/
Agent?: Agent;
/**
* 资源id，与ResourceType相对应，取值范围：
<ul>
<li>文件Id（通过UploadFiles获取文件资源Id）</li>
<li>模板Id（通过控制台创建模板后获取模板Id）</li>
</ul>
注意：需要同时设置 ResourceType 参数指定资源类型
*/
ResourceId?: string;
/**
* 合同流程配置信息，用于配置发起合同时定制化如是否允许修改，某些按钮的隐藏等逻辑
*/
FlowOption?: CreateFlowOption;
/**
* 合同签署人信息
*/
FlowApproverList?: Array<CommonFlowApprover>;
/**
* 合同Id：用于通过一个已发起的合同快速生成一个发起流程web链接
注: `该参数必须是一个待发起审核的合同id，并且还未审核通过`
*/
FlowId?: string;
/**
* 该参数不可用，请通过获取 web 可嵌入接口获取合同流程预览 URL
* @deprecated
*/
NeedPreview?: boolean;
/**
* 企业机构信息，不用传
* @deprecated
*/
Organization?: OrganizationInfo;
/**
* 操作人（用户）信息，不用传
* @deprecated
*/
Operator?: UserInfo;
/**
* <font color="red">此参数已经废弃，请使用 CreateFlowOption 里面的 SignComponentConfig</font>
签署控件的配置信息，用在嵌入式发起的页面配置，包括
- 签署控件 是否默认展示日期.
* @deprecated
*/
SignComponentConfig?: SignComponentConfig;
}
/**
* ChannelCreateFlowSignUrl请求参数结构体
*/
export interface ChannelCreateFlowSignUrlRequest {
/**
* 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
此接口下面信息必填。
<ul>
<li>渠道应用标识: Agent.AppId</li>
<li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
<li>第三方平台子客企业中的员工标识: Agent. ProxyOperator.OpenId</li>
</ul>
第三方平台子客企业和员工必须已经经过实名认证
*/
Agent: Agent;
/**
* 合同流程ID，为32位字符串。
建议开发者妥善保存此流程ID，以便于顺利进行后续操作。
可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
*/
FlowId: string;
/**
* 流程签署人列表，其中结构体的ApproverType必传。
若为个人签署方或saas企业签署方，则Name，Mobile必传。OrganizationName 传对应企业名称。
若为子客企业签署方则需传OpenId、OrganizationOpenId，其他可不传。
此结构体和发起接口参与方结构体复用，除了上述参数外，可传递的参数有：
1. RecipientId: 发起合同会返回，可以直接用于指定需要生成链接的签署方。
2. ApproverSignTypes: 指定签署方签署时候的认证方式，仅此链接生效。
3. SignTypeSelector: 可以指定签署方签署合同的认证校验方式的选择模式。
4. Intention: 指定H5签署视频核身的意图配置，仅视频签署需要使用。
注:
`1. 签署人只能有手写签名、时间类型、印章类型、签批类型的签署控件和内容填写控件，其他类型的签署控件暂时未支持。`
`2. 生成发起方预览链接时，该字段（FlowApproverInfos）传空或者不传`
*/
FlowApproverInfos?: Array<FlowApproverInfo>;
/**
* 用户信息，暂未开放
* @deprecated
*/
Operator?: UserInfo;
/**
* 机构信息，暂未开放
* @deprecated
*/
Organization?: OrganizationInfo;
/**
* 签署完之后的H5页面的跳转链接，最大长度1000个字符。链接类型请参考 <a href="https://qian.tencent.com/developers/company/openqianh5" target="_blank">跳转电子签H5</a>
*/
JumpUrl?: string;
/**
* 链接类型，支持指定以下类型
<ul><li>0 : 签署链接 (默认值)</li>
<li>1 : 预览链接</li></ul>
注:
`1. 当指定链接类型为1时，链接为预览链接，打开链接无法签署仅支持预览以及查看当前合同状态。`
`2. 如需生成发起方预览链接，则签署方信息传空，即FlowApproverInfos传空或者不传。`
*/
UrlType?: number;
}
/**
* ChannelCreateSealPolicy返回参数结构体
*/
export interface ChannelCreateSealPolicyResponse {
/**
* 最终授权成功的电子签系统用户ID数组。其他的跳过的是已经授权了的。
请求参数填写OpenId时，返回授权成功的 Openid。
*/
UserIds?: Array<string>;
/**
* 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* OperateTemplate请求参数结构体
*/
export interface OperateTemplateRequest {
/**
* 关于渠道应用的相关信