数据结构
Admin
企业超管信息
被如下接口引用:DescribeOrganizationGroupOrganizations。
名称 | 类型 | 描述 |
---|---|---|
Name | String | 超管名 注意:此字段可能返回 null,表示取不到有效值。 |
Mobile | String | 超管手机号,打码显示 示例值:138****1569 注意:此字段可能返回 null,表示取不到有效值。 |
Agent
代理相关应用信息,如集团主企业代子企业操作
被如下接口引用:BindEmployeeUserIdWithClientOpenId, CancelFlow, CancelMultiFlowSignQRCode, CancelUserAutoSignEnableUrl, CreateBatchCancelFlowUrl, CreateBatchQuickSignUrl, CreateBatchSignUrl, CreateConvertTaskApi, CreateDocument, CreateEmbedWebUrl, CreateExtendedServiceAuthInfos, CreateFlow, CreateFlowApprovers, CreateFlowByFiles, CreateFlowEvidenceReport, CreateFlowGroupByFiles, CreateFlowGroupByTemplates, CreateFlowReminds, CreateFlowSignReview, CreateFlowSignUrl, CreateIntegrationDepartment, CreateIntegrationEmployees, CreateIntegrationRole, CreateIntegrationUserRoles, CreateMultiFlowSignQRCode, CreateOrganizationBatchSignUrl, CreateOrganizationInfoChangeUrl, CreatePersonAuthCertificateImage, CreatePrepareFlow, CreatePreparedPersonalEsign, CreateReleaseFlow, CreateSchemeUrl, CreateSeal, CreateSealPolicy, CreateUserAutoSignEnableUrl, CreateUserAutoSignSealUrl, CreateWebThemeConfig, DeleteExtendedServiceAuthInfos, DeleteIntegrationDepartment, DeleteIntegrationEmployees, DeleteIntegrationRoleUsers, DeleteSealPolicies, DescribeBillUsageDetail, DescribeExtendedServiceAuthInfos, DescribeFileUrls, DescribeFlowBriefs, DescribeFlowComponents, DescribeFlowEvidenceReport, DescribeFlowInfo, DescribeFlowTemplates, DescribeIntegrationDepartments, DescribeIntegrationEmployees, DescribeIntegrationRoles, DescribeOrganizationSeals, DescribePersonCertificate, DescribeThirdPartyAuthCode, DescribeUserAutoSignStatus, DisableUserAutoSign, GetTaskResultApi, ModifyApplicationCallbackInfo, ModifyIntegrationDepartment, ModifyIntegrationRole, StartFlow, UnbindEmployeeUserIdWithClientOpenId, UpdateIntegrationEmployees, UploadFiles, VerifyPdf。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
ProxyOrganizationId | String | 否 | 被代理机构在电子签平台的机构编号,集团代理下场景必传 |
ApproverComponentLimitType
签署方在使用个人印章签署控件(SIGN_SIGNATURE) 时可使用的签署方式
被如下接口引用:CreateMultiFlowSignQRCode。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
RecipientId | String | 是 | 签署方经办人在模板中配置的参与方ID,与控件绑定,是控件的归属方,ID为32位字符串。 |
Values | Array of String | 是 | 签署方经办人控件类型是个人印章签署控件(SIGN_SIGNATURE) 时,可选的签名方式,可多选 签名方式:
|
ApproverInfo
合同参与者信息。
被如下接口引用:CreateFlowByFiles, CreateFlowGroupByFiles, CreateFlowGroupByTemplates。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
ApproverType | Integer | 是 | 在指定签署方时,可选择企业B端或个人C端等不同的参与者类型,可选类型如下: 0:企业 1:个人 3:企业静默签署 注: 类型为3(企业静默签署)时,此接口会默认完成该签署方的签署。静默签署仅进行盖章操作,不能自动签名。 7: 个人自动签署,适用于个人自动签场景。 注: 个人自动签场景为白名单功能,使用前请联系对接的客户经理沟通。 |
ApproverName | String | 是 | 签署方经办人的姓名。 经办人的姓名将用于身份认证和电子签名,请确保填写的姓名为签署方的真实姓名,而非昵称等代名。 |
ApproverMobile | String | 是 | 签署方经办人手机号码, 支持国内手机号11位数字(无需加+86前缀或其他字符)。 请确认手机号所有方为此合同签署方。 |
OrganizationName | String | 否 | 组织机构名称。 请确认该名称与企业营业执照中注册的名称一致。 如果名称中包含英文括号(),请使用中文括号()代替。 如果签署方是企业签署方(approverType = 0 或者 approverType = 3), 则企业名称必填。 |
SignComponents | Array of Component | 否 | 合同中的签署控件列表,列表中可支持下列多种签署控件,控件的详细定义参考开发者中心的Component结构体
|
ApproverIdCardType | String | 否 | 签署方经办人的证件类型,支持以下类型
注: 其他证件类型为白名单功能,使用前请联系对接的客户经理沟通。 示例值:ID_CARD |
ApproverIdCardNumber | String | 否 | 签署方经办人的证件号码,应符合以下规则
示例值:xxx |
NotifyType | String | 否 | 通知签署方经办人的方式, 有以下途径:
示例值:sms |
ApproverRole | Integer | 否 | 收据场景设置签署人角色类型, 可以设置如下**类型**:
注: 收据场景为白名单功能,使用前请联系对接的客户经理沟通。 示例值:1 |
ApproverRoleName | String | 否 | 可以自定义签署人角色名:收款人、开具人、见证人等,长度不能超过20,只能由中文、字母、数字和下划线组成。 注: 如果是用模板发起, 优先使用此处上传的, 如果不传则用模板的配置的 示例值:收款人 |
VerifyChannel | Array of String | 否 | 签署意愿确认渠道,默认为WEIXINAPP:人脸识别 注: 将要废弃, 用ApproverSignTypes签署人签署合同时的认证方式代替, 新客户可请用ApproverSignTypes来设置 示例值:["WEIXINAPP"] |
PreReadTime | Integer | 否 | 签署方在签署合同之前,需要强制阅读合同的时长,可指定为3秒至300秒之间的任意值。 若未指定阅读时间,则会按照合同页数大小计算阅读时间,计算规则如下:
示例值:3 |
UserId | String | 否 | 签署人userId,仅支持本企业的员工userid, 可在控制台组织管理处获得 注: 若传此字段 则以userid的信息为主,会覆盖传递过来的签署人基本信息, 包括姓名,手机号,证件类型等信息 |
ApproverSource | String | 否 | 在企微场景下使用,需设置参数为WEWORKAPP,以表明合同来源于企微。 |
CustomApproverTag | String | 否 | 在企业微信场景下,表明该合同流程为或签,其最大长度为64位字符串。 所有参与或签的人员均需具备该标识。 注意,在合同中,不同的或签参与人必须保证其CustomApproverTag唯一。 如果或签签署人为本方企业微信参与人,则需要指定ApproverSource参数为WEWORKAPP。 |
ApproverOption | ApproverOption | 否 | 可以控制签署方在签署合同时能否进行某些操作,例如拒签、转交他人等。 详细操作可以参考开发者中心的ApproverOption结构体。 |
ApproverVerifyTypes | Array of Integer | 否 | 指定个人签署方查看合同的校验方式,可以传值如下:
注:
示例值:[1,2] |
ApproverSignTypes | Array of Integer | 否 | 您可以指定签署方签署合同的认证校验方式,可传递以下值:
注: 1. 默认情况下,认证校验方式为人脸认证和签署密码两种形式 2. 您可以传递多种值,表示可用多种认证校验方式 3. 运营商三要素认证方式对手机号运营商及前缀有限制,可以参考运营商支持列表类得到具体的支持说明 示例值:[1,2,3] |
ApproverNeedSignReview | Boolean | 否 | 发起方企业的签署人进行签署操作前,是否需要企业内部走审批流程,取值如下:
企业可以通过CreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果
注: 此功能可用于与企业内部的审批流程进行关联,支持手动、静默签署合同 |
AddSignComponentsLimits | Array of ComponentLimit | 否 | 用PDF文件创建签署流程时,如果设置了外层参数SignBeanTag=1(允许签署过程中添加签署控件),则可通过此参数明确规定合同所使用的签署控件类型(骑缝章、普通章法人章等)和具体的印章(印章ID)或签名方式。 注: 限制印章控件或骑缝章控件情况下,仅本企业签署方可以指定具体印章(通过传递ComponentValue,支持多个),他方企业或个人只支持限制控件类型。 |
SignInstructionContent | String | 否 | 签署须知:支持传入富文本,最长字数:500个中文字符 |
ApproverItem
签署方信息,发起合同后可获取到对应的签署方信息,如角色ID,角色名称
被如下接口引用:CreateDocument, CreateFlowByFiles。
名称 | 类型 | 描述 |
---|---|---|
SignId | String | 签署方唯一编号 注意:此字段可能返回 null,表示取不到有效值。 |
RecipientId | String | 签署方角色编号 注意:此字段可能返回 null,表示取不到有效值。 |
ApproverRoleName | String | 签署方角色名称 注意:此字段可能返回 null,表示取不到有效值。 |
ApproverOption
签署人个性化能力信息
被如下接口引用:CreateBatchQuickSignUrl, CreateFlow, CreateFlowByFiles, CreateFlowGroupByFiles, CreateFlowGroupByTemplates, CreateFlowSignUrl, CreatePrepareFlow。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
NoRefuse | Boolean | 否 | 签署方是否可以拒签
示例值:true |
NoTransfer | Boolean | 否 | 签署方是否可以转他人处理
示例值:true |
FillType | Integer | 否 | 签署人信息补充类型,默认无需补充。
|
FlowReadLimit | String | 否 | 签署人阅读合同限制参数 取值:
|
ApproverRestriction
指定签署人限制项
被如下接口引用:CreateMultiFlowSignQRCode。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
Name | String | 否 | 指定签署人名字 示例值:张三 |
Mobile | String | 否 | 指定签署人手机号,11位数字 示例值:13000000000 |
IdCardType | String | 否 | 指定签署人证件类型,ID_CARD-身份证 示例值:ID_CARD |
IdCardNumber | String | 否 | 指定签署人证件号码,字母大写 示例值:4500000000000000000 |
AuthorizedUser
授权用户
被如下接口引用:DescribeOrganizationSeals。
名称 | 类型 | 描述 |
---|---|---|
UserId | String | 电子签系统中的用户id |
AutoSignConfig
自动签开启、签署相关配置
被如下接口引用:CreateUserAutoSignEnableUrl。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
UserInfo | UserThreeFactor | 是 | 自动签开通个人用户信息, 包括名字,身份证等 |
CertInfoCallback | Boolean | 否 | 是否回调证书信息:
|
UserDefineSeal | Boolean | 否 | 是否支持用户自定义签名印章:
|
SealImgCallback | Boolean | 否 | 回调中是否需要自动签将要使用的印章(签名) 图片的 base64:
|
VerifyChannels | Array of String | 否 | 开通时候的身份验证方式, 取值为:
注:
|
LicenseType | Integer | 否 | 设置用户开通自动签时是否绑定个人自动签账号许可。
|
BillUsageDetail
用户计费使用情况详情
被如下接口引用:DescribeBillUsageDetail。
名称 | 类型 | 描述 |
---|---|---|
FlowId | String | 合同流程ID,为32位字符串。 可登录腾讯电子签控制台,在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。 示例值:yDwFdUUckps**uzcbXwoXbRF6ja3 |
OperatorName | String | 合同经办人名称 如果有多个经办人用分号隔开。 示例值:典子谦 |
CreateOrganizationName | String | 发起方组织机构名称 示例值:典子谦示例企业 |
FlowName | String | 合同流程的名称。 示例值:典子谦示例合同 |
Status | Integer | 当前合同状态,如下是状态码对应的状态。
示例值:4 |
QuotaType | String | 查询的套餐类型 对应关系如下:
示例值:CloudEnterprise |
UseCount | Integer | 合同使用量 注: 如果消耗类型是撤销返还,此值为负值代表返还的合同数量 示例值:1 |
CostTime | Integer | 消耗的时间戳,格式为Unix标准时间戳(秒)。 示例值:1680162193 |
QuotaName | String | 消耗的套餐名称 示例值:企业版运营礼包 |
CostType | Integer | 消耗类型 1.扣费 2.撤销返还 示例值:1 |
Remark | String | 备注 示例值:空 |
CallbackInfo
企业应用回调信息
被如下接口引用:ModifyApplicationCallbackInfo。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
CallbackUrl | String | 是 | 回调url,。请确保回调地址能够接收并处理 HTTP POST 请求,并返回状态码 200 以表示处理正常。 示例值:http://123.com |
CallbackKey | String | 否 | 回调加密key,用于回调消息加解密。 示例值:xxxxx |
CallbackToken | String | 否 | 回调验签token,用于回调通知校验。 示例值:xxxxx |
Caller
此结构体 (Caller) 用于描述调用方属性。
被如下接口引用:UploadFiles。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
OperatorId | String | 否 | 经办人的用户ID,同UserId 示例值:88fb0c591044be771f60aa382cc5ed0e |
CcInfo
抄送信息
被如下接口引用:CreateFlow, CreateFlowByFiles。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
Mobile | String | 否 | 被抄送方手机号码, 支持国内手机号11位数字(无需加+86前缀或其他字符)。 请确认手机号所有方为此业务通知方。 示例值:xxx |
Name | String | 否 | 被抄送方姓名。 抄送方的姓名将用于身份认证,请确保填写的姓名为抄送方的真实姓名,而非昵称等代名。 示例值:李白 |
CcType | Integer | 否 | 被抄送方类型, 可设置以下类型:
示例值:1 |
CcPermission | Integer | 否 | 被抄送方权限, 可设置如下权限:
示例值:1 |
NotifyType | String | 否 | 通知签署方经办人的方式, 有以下途径:
示例值:sms |
Component
此结构体 (Component) 用于描述控件属性。
在通过文件发起合同时,对应的component有三种定位方式
- 绝对定位方式
- 表单域(FIELD)定位方式
- 关键字(KEYWORD)定位方式,使用关键字定位时,请确保PDF原始文件内是关键字以文字形式保存在PDF文件中,不支持对图片内文字进行关键字查找 可以参考官网说明 https://cloud.tencent.com/document/product/1323/78346#component-.E4.B8.89.E7.A7.8D.E5.AE.9A.E4.BD.8D.E6.96.B9.E5.BC.8F.E8.AF.B4.E6.98.8E
被如下接口引用:CreateBatchQuickSignUrl, CreateFlow, CreateFlowByFiles, CreateFlowGroupByFiles, CreateFlowGroupByTemplates, CreateFlowSignUrl, CreatePrepareFlow, DescribeFlowTemplates。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
ComponentType | String | 是 | 如果是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日字符串; DISTRICT - 省市区行政区控件,ComponentValue填写省市区行政区字符串内容; 如果是SignComponent签署控件类型,则可选的字段为 SIGN_SEAL - 签署印章控件; SIGN_DATE - 签署日期控件; SIGN_SIGNATURE - 用户签名控件; SIGN_PERSONAL_SEAL - 个人签署印章控件(使用文件发起暂不支持此类型); SIGN_PAGING_SEAL - 骑缝章;若文件发起,需要对应填充ComponentPosY、ComponentWidth、ComponentHeight SIGN_OPINION - 签署意见控件,用户需要根据配置的签署意见内容,完成对意见内容的确认; SIGN_LEGAL_PERSON_SEAL - 企业法定代表人控件。 表单域的控件不能作为印章和签名控件 |
FileIndex | Integer | 是 | 控件所属文件的序号(取值为:0-N)。 目前单文件的情况下,值是0 |
ComponentHeight | Float | 是 | 参数控件高度,单位pt |
ComponentWidth | Float | 是 | 参数控件宽度,单位pt |
ComponentPage | Integer | 是 | 参数控件所在页码,取值为:1-N |
ComponentPosX | Float | 是 | 参数控件X位置,单位pt |
ComponentPosY | Float | 是 | 参数控件Y位置,单位pt |
ComponentId | String | 否 | 控件唯一ID。 或使用文件发起合同时用于GenerateMode==KEYWORD 指定关键字 |
ComponentName | String | 否 | 控件名。 或使用文件发起合同时用于GenerateMode==FIELD 指定表单域名称 |
ComponentRequired | Boolean | 否 | 是否必选,默认为false-非必选 |
ComponentRecipientId | String | 否 | 控件关联的参与方ID,对应Recipient结构体中的RecipientId |
ComponentExtra | String | 否 | 扩展参数: 为JSON格式。 不同类型的控件会有部分非通用参数 ComponentType为TEXT、MULTI_LINE_TEXT时,支持以下参数: 1 Font:目前只支持黑体、宋体 2 FontSize: 范围12-72 3 FontAlign: Left/Right/Center,左对齐/居中/右对齐 4 FontColor:字符串类型,格式为RGB颜色数字 参数样例:{\"FontColor\":\"255,0,0\",\"FontSize\":12} ComponentType为FILL_IMAGE时,支持以下参数: NotMakeImageCenter:bool。是否设置图片居中。false:居中(默认)。 true: 不居中 FillMethod: int. 填充方式。0-铺满(默认);1-等比例缩放 ComponentType为SIGN_SIGNATURE类型可以控制签署方式 {“ComponentTypeLimit”: [“xxx”]} xxx可以为: HANDWRITE – 手写签名 OCR_ESIGN -- AI智能识别手写签名 ESIGN -- 个人印章类型 SYSTEM_ESIGN -- 系统签名(该类型可以在用户签署时根据用户姓名一键生成一个签名来进行签署) 如:{“ComponentTypeLimit”: [“SYSTEM_ESIGN”]} ComponentType为SIGN_DATE时,支持以下参数: 1 Font:字符串类型目前只支持"黑体"、"宋体",如果不填默认为"黑体" 2 FontSize: 数字类型,范围6-72,默认值为12 3 FontAlign: 字符串类型,可取Left/Right/Center,对应左对齐/居中/右对齐 4 Format: 字符串类型,日期格式,必须是以下五种之一 “yyyy m d”,”yyyy年m月d日”,”yyyy/m/d”,”yyyy-m-d”,”yyyy.m.d”。 5 Gaps:: 字符串类型,仅在Format为“yyyy m d”时起作用,格式为用逗号分开的两个整数,例如”2,2”,两个数字分别是日期格式的前后两个空隙中的空格个数 如果extra参数为空,默认为”yyyy年m月d日”格式的居中日期 特别地,如果extra中Format字段为空或无法被识别,则extra参数会被当作默认值处理(Font,FontSize,Gaps和FontAlign都不会起效) 参数样例: "ComponentExtra": "{"Format":“yyyy m d”,"FontSize":12,"Gaps":"2,2", "FontAlign":"Right"}" ComponentType为SIGN_SEAL类型时,支持以下参数: 1.PageRanges:PageRange的数组,通过PageRanges属性设置该印章在PDF所有页面上盖章(适用于标书在所有页面盖章的情况) 参数样例: "ComponentExtra":"{"PageRange":[{"BeginPage":1,"EndPage":-1}]}" |
IsFormType | Boolean | 否 | 是否是表单域类型,默认false-不是 注意:此字段可能返回 null,表示取不到有效值。 |
ComponentValue | String | 否 | 控件填充vaule,ComponentType和传入值类型对应关系: TEXT - 文本内容 MULTILINE_TEXT - 文本内容 CHECK_BOX - true/false FILL_IMAGE、ATTACHMENT - 附件的FileId,需要通过UploadFiles接口上传获取 SELECTOR - 选项值 DYNAMIC_TABLE - 传入json格式的表格内容,具体见数据结构FlowInfo:https://cloud.tencent.com/document/api/1420/61525#FlowInfo DATE - 默认是格式化为xxxx年xx月xx日 SIGN_SEAL - 印章ID,于控制台查询获取 SIGN_PAGING_SEAL - 可以指定印章ID,于控制台查询获取 控件值约束说明: 企业全称控件: 约束:企业名称中文字符中文括号 检查正则表达式:/^[\u3400-\u4dbf\u4e00-\u9fa5()]+$/ 统一社会信用代码控件: 检查正则表达式:/^[A-Z0-9]{1,18}$/ 法人名称控件: 约束:最大50个字符,2到25个汉字或者1到50个字母 检查正则表达式:/^([\u3400-\u4dbf\u4e00-\u9fa5.·]{2,25}|[a-zA-Z·,\s-]{1,50})$/ 签署意见控件: 约束:签署意见最大长度为50字符 签署人手机号控件: 约束:国内手机号 13,14,15,16,17,18,19号段长度11位 签署人身份证控件: 约束:合法的身份证号码检查 控件名称: 约束:控件名称最大长度为20字符 单行文本控件: 约束:只允许输入中文,英文,数字,中英文标点符号 多行文本控件: 约束:只允许输入中文,英文,数字,中英文标点符号 勾选框控件: 约束:选择填字符串true,不选填字符串false 选择器控件: 约束:同单行文本控件约束,填写选择值中的字符串 数字控件: 约束:请输入有效的数字(可带小数点) 检查正则表达式:/^(-|+)?\d+(.\d+)?$/ 日期控件: 约束:格式:yyyy年mm月dd日 附件控件: 约束:JPG或PNG图片,上传数量限制,1到6个,最大6个附件 图片控件: 约束:JPG或PNG图片,填写上传的图片资源ID 邮箱控件: 约束:请输入有效的邮箱地址, w3c标准 检查正则表达式:/^([A-Za-z0-9-.!#$%&])+@([A-Za-z0-9_-.])+.([A-Za-z]{2,4})$/ 参考:https://emailregex.com/ 地址控件: 同单行文本控件约束 省市区控件: 同单行文本控件约束 性别控件: 同单行文本控件约束,填写选择值中的字符串 学历控件: 同单行文本控件约束,填写选择值中的字符串 |
GenerateMode | String | 否 | 控件生成的方式: NORMAL - 普通控件 FIELD - 表单域 KEYWORD - 关键字(设置关键字时,请确保PDF原始文件内是关键字以文字形式保存在PDF文件中,不支持对图片内文字进行关键字查找) |
ComponentDateFontSize | Integer | 否 | 日期签署控件的字号,默认为 12 |
ChannelComponentId | String | 否 | 第三方应用集成平台模板控件 ID 标识 |
OffsetX | Float | 否 | 指定关键字时横坐标偏移量,单位pt 注意:此字段可能返回 null,表示取不到有效值。 |
OffsetY | Float | 否 | 指定关键字时纵坐标偏移量,单位pt 注意:此字段可能返回 null,表示取不到有效值。 |
ChannelComponentSource | Integer | 否 | 第三方应用集成中子客企业控件来源。 0-平台指定; 1-用户自定义 |
KeywordOrder | String | 否 | 指定关键字排序规则,Positive-正序,Reverse-倒序。 传入Positive时会根据关键字在PDF文件内的顺序进行排列。在指定KeywordIndexes时,0代表在PDF内查找内容时,查找到的第一个关键字。 传入Reverse时会根据关键字在PDF文件内的反序进行排列。在指定KeywordIndexes时,0代表在PDF内查找内容时,查找到的最后一个关键字。 示例值:Positive\Reverse |
KeywordPage | Integer | 否 | 指定关键字页码。 指定页码后,将只在指定的页码内查找关键字,非该页码的关键字将不会查询出来 |
RelativeLocation | String | 否 | 关键字位置模式, Middle-居中, Below-正下方, Right-正右方, LowerRight-右上角, UpperRight-右下角。 示例:如果设置Middle的关键字盖章,则印章的中心会和关键字的中心重合,如果设置Below,则印章在关键字的正下方 |
KeywordIndexes | Array of Integer | 否 | 关键字索引。 如果一个关键字在PDF文件中存在多个,可以通过关键字索引指定使用第几个关键字作为最后的结果,可指定多个索引。 示例:[0,2],说明使用PDF文件内第1个和第3个关键字位置。 |
LockComponentValue | Boolean | 否 | 是否锁定控件值不允许编辑(嵌入式发起使用) 默认false:不锁定控件值,允许在页面编辑控件值 注意:此字段可能返回 null,表示取不到有效值。 |
ForbidMoveAndDelete | Boolean | 否 | 是否禁止移动和删除控件 默认false,不禁止移动和删除控件 注意:此字段可能返回 null,表示取不到有效值。 |
ComponentLimit
签署控件的类型和范围限制条件,用于控制文件发起后签署人拖拽签署区时可使用的控件类型和具体的印章或签名方式。
被如下接口引用:CreateFlowByFiles, CreateFlowGroupByFiles, CreateFlowGroupByTemplates。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
ComponentType | String | 是 | 控件类型,支持以下类型
|
ComponentValue | Array of String | 否 | 签署控件类型的值(可选),用与限制签署时印章或者签名的选择范围 1.当ComponentType 是 SIGN_SEAL 或者 SIGN_PAGING_SEAL 时可传入企业印章Id(支持多个) 2.当ComponentType 是 SIGN_SIGNATURE 时可传入以下类型(支持多个)
3.当ComponentType 是 SIGN_LEGAL_PERSON_SEAL 时无需传递此参数。 |
CreateFlowOption
创建合同个性化参数
被如下接口引用:CreatePrepareFlow。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
CanEditFlow | Boolean | 否 | 是否允许修改发起合同时确认弹窗的合同信息(合同名称、合同类型、签署截止时间),若不允许编辑,则表单字段将被禁止输入。 true:允许编辑 false:不允许编辑(默认值) 示例值:true |
CanEditFormField | Boolean | 否 | 是否允许编辑模板控件 true:允许编辑模板控件信息 false:不允许编辑模板控件信息(默认值) 示例值:true |
HideShowFlowName | Boolean | 否 | 发起页面隐藏合同名称展示 true:发起页面隐藏合同名称展示 false:发起页面不隐藏合同名称展示(默认值) 示例值:true |
HideShowFlowType | Boolean | 否 | 发起页面隐藏合同类型展示 true:发起页面隐藏合同类型展示 false:发起页面不隐藏合同类型展示(默认值) 示例值:true |
HideShowDeadline | Boolean | 否 | 发起页面隐藏合同截止日期展示 true:发起页面隐藏合同截止日期展示 false:发起页面不隐藏合同截止日期展示(默认值) 示例值:true |
CanSkipAddApprover | Boolean | 否 | 发起页面允许跳过添加签署人环节 true:发起页面允许跳过添加签署人环节 false:发起页面不允许跳过添加签署人环节(默认值) 示例值:true |
SkipUploadFile | Boolean | 否 | 文件发起页面跳过文件上传步骤 true:文件发起页面跳过文件上传步骤 false:文件发起页面不跳过文件上传步骤(默认值) 示例值:true |
ForbidEditFillComponent | Boolean | 否 | 禁止编辑填写控件 true:禁止编辑填写控件 false:允许编辑填写控件(默认值) 示例值:true |
CustomCreateFlowDescription | String | 否 | 定制化发起合同弹窗的描述信息,描述信息最长500字符 示例值:"" |
CreateStaffResult
创建员工的结果
被如下接口引用:CreateIntegrationEmployees。
名称 | 类型 | 描述 |
---|---|---|
SuccessEmployeeData | Array of SuccessCreateStaffData | 创建员工的成功列表 注意:此字段可能返回 null,表示取不到有效值。 |
FailedEmployeeData | Array of FailedCreateStaffData | 创建员工的失败列表 注意:此字段可能返回 null,表示取不到有效值。 |
DeleteStaffsResult
删除员工结果
被如下接口引用:DeleteIntegrationEmployees。
名称 | 类型 | 描述 |
---|---|---|
SuccessEmployeeData | Array of SuccessDeleteStaffData | 删除员工的成功数据 注意:此字段可能返回 null,表示取不到有效值。 |
FailedEmployeeData | Array of FailedDeleteStaffData | 删除员工的失败数据 注意:此字段可能返回 null,表示取不到有效值。 |
Department
集成版员工部门信息。
被如下接口引用:CreateIntegrationEmployees, DeleteIntegrationEmployees, DescribeIntegrationEmployees, UpdateIntegrationEmployees。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
DepartmentId | String | 否 | 部门ID。 示例值:dp**155f2 |
DepartmentName | String | 否 | 部门名称。 示例值:测试部门 |
EmbedUrlOption
个性化参数
被如下接口引用:CreateEmbedWebUrl。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
ShowFlowDetailComponent | Boolean | 否 | 合同详情预览,允许展示控件信息 true:允许在合同详情页展示控件 false:不允许在合同详情页展示控件 默认false,合同详情页不展示控件 示例值:true |
ShowTemplateComponent | Boolean | 否 | 模板预览,允许展示模板控件信息 true:允许在模板预览页展示控件 false:不允许在模板预览页展示控件 默认false,模板预览页不展示控件 示例值:true |
ExtendAuthInfo
扩展服务开通和授权的详细信息
被如下接口引用:DescribeExtendedServiceAuthInfos。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
Type | String | 否 | 扩展服务的类型,可能是以下值:
示例值:BATCH_SIGN |
Name | String | 否 | 扩展服务的名称 示例值:批量签署 |
Status | String | 否 | 扩展服务的开通状态: ENABLE:开通 DISABLE:未开通 示例值:ENABLE |
OperatorUserId | String | 否 | 操作扩展服务的操作人UserId,员工在腾讯电子签平台的唯一身份标识,为32位字符串。 注意:此字段可能返回 null,表示取不到有效值。 示例值:yDR****CLU |
OperateOn | Integer | 否 | 扩展服务的操作时间,格式为Unix标准时间戳(秒)。 注意:此字段可能返回 null,表示取不到有效值。 示例值:1693557098 |
HasAuthUserList | Array of HasAuthUser | 否 | 该扩展服务若可以授权,此参数对应授权人员的列表 注意:此字段可能返回 null,表示取不到有效值。 |
FailedCreateRoleData
绑定角色失败信息
被如下接口引用:CreateIntegrationUserRoles。
名称 | 类型 | 描述 |
---|---|---|
UserId | String | 用户userId 注意:此字段可能返回 null,表示取不到有效值。 |
RoleIds | Array of String | 角色id列表 注意:此字段可能返回 null,表示取不到有效值。 |
FailedCreateStaffData
创建员工的失败数据
被如下接口引用:CreateIntegrationEmployees。
名称 | 类型 | 描述 |
---|---|---|
DisplayName | String | 员工名 |
Mobile | String | 员工手机号 |
WeworkOpenId | String | 传入的企微账号id |
Reason | String | 失败原因 |
FailedDeleteStaffData
删除员工失败数据
被如下接口引用:DeleteIntegrationEmployees。
名称 | 类型 | 描述 |
---|---|---|
UserId | String | 员工在电子签的userId 注意:此字段可能返回 null,表示取不到有效值。 |
OpenId | String | 员工在第三方平台的openId 注意:此字段可能返回 null,表示取不到有效值。 |
Reason | String | 失败原因 |
FailedUpdateStaffData
更新员工信息失败返回的数据信息
被如下接口引用:UpdateIntegrationEmployees。
名称 | 类型 | 描述 |
---|---|---|
DisplayName | String | 用户传入的名称 |
Mobile | String | 用户传入的手机号,明文展示 |
Reason | String | 失败原因 |
UserId | String | 员工在腾讯电子签平台的唯一身份标识,为32位字符串。 可登录腾讯电子签控制台,在 "更多能力"->"组织管理" 中查看某位员工的UserId(在页面中展示为用户ID)。 |
OpenId | String | 员工在第三方平台的openId |
FileInfo
模板中文件的信息结构
被如下接口引用:DescribeFlowTemplates。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
FileId | String | 否 | 文件ID |
FileName | String | 否 | 文件名 |
FileSize | Integer | 否 | 文件大小,单位为Byte |
CreatedOn | Integer | 否 | 文件上传时间,格式为Unix标准时间戳(秒) |
FileUrl
下载文件的URL信息
被如下接口引用:DescribeFileUrls。
名称 | 类型 | 描述 |
---|---|---|
Url | String | 下载文件的URL,有效期为输入的UrlTtl,默认5分钟 |
Option | String | 下载文件的附加信息。如果是pdf文件,会返回pdf文件每页的有效高宽 注意:此字段可能返回 null,表示取不到有效值。 |
FillApproverInfo
补充签署人信息
- RecipientId 必须指定
- 通过企业微信自定义账号ID补充签署人时,ApproverSource 和 CustomUserId 必填,ApproverSource取值:WEWORKAPP
- 通过二要素(姓名/手机号)补充签署人时,ApproverName 和 ApproverMobile 必填,ApproverSource设置为空
被如下接口引用:CreateFlowApprovers。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
RecipientId | String | 是 | 签署方经办人在模板中配置的参与方ID,与控件绑定,是控件的归属方,ID为32位字符串。 模板发起合同时,该参数为必填项。 文件发起合同是,该参数无需传值。 如果开发者后序用合同模板发起合同,建议保存此值,在用合同模板发起合同中需此值绑定对应的签署经办人 。 示例值:yDwhSUUckp3lqxlpUu6Ni3SvjJPoxxxx |
ApproverSource | String | 否 | 签署人来源 WEWORKAPP: 企业微信 仅【企微或签】时指定WEWORKAPP 示例值:WEWORKAPP |
CustomUserId | String | 否 | 企业微信UserId 当ApproverSource为WEWORKAPP的企微或签场景下,必须指企业自有应用获取企业微信的UserId 示例值:zhangsan |
ApproverName | String | 否 | 补充企业签署人员工姓名 示例值:张三 |
ApproverMobile | String | 否 | 补充企业签署人员工手机号 示例值:188xxxxxxxx |
OrganizationName | String | 否 | 补充企业动态签署人时,需要指定对应企业名称 |
FillError
批量补充签署人时,补充失败的报错说明
被如下接口引用:CreateFlowApprovers。
名称 | 类型 | 描述 |
---|---|---|
RecipientId | String | 为签署方经办人在签署合同中的参与方ID,与控件绑定,是控件的归属方,ID为32位字符串。与入参中补充的签署人角色ID对应,批量补充部分失败返回对应的错误信息。 注意:此字段可能返回 null,表示取不到有效值。 |
ErrMessage | String | 补充失败错误说明 注意:此字段可能返回 null,表示取不到有效值。 |
FilledComponent
文档内的填充控件返回结构体,返回控件的基本信息和填写内容值
被如下接口引用:DescribeFlowComponents。
名称 | 类型 | 描述 |
---|---|---|
ComponentId | String | 控件Id 注意:此字段可能返回 null,表示取不到有效值。 |
ComponentName | String | 控件名称 注意:此字段可能返回 null,表示取不到有效值。 |
ComponentFillStatus | String | 控件填写状态;0-未填写;1-已填写 注意:此字段可能返回 null,表示取不到有效值。 |
ComponentValue | String | 控件填写内容 注意:此字段可能返回 null,表示取不到有效值。 |
ComponentRecipientId | String | 控件所属参与方Id 注意:此字段可能返回 null,表示取不到有效值。 |
ImageUrl | String | 图片填充控件下载链接,如果是图片填充控件时,这里返回图片的下载链接。 注意:此字段可能返回 null,表示取不到有效值。 |
Filter
查询过滤条件
被如下接口引用:DescribeFlowTemplates, DescribeIntegrationEmployees, DescribeIntegrationRoles。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
Key | String | 是 | 查询过滤条件的Key |
Values | Array of String | 是 | 查询过滤条件的Value列表 |
FlowApproverDetail
签署人详情信息
被如下接口引用:DescribeFlowInfo。
名称 | 类型 | 描述 |
---|---|---|
ApproveMessage | String | 签署时的相关信息 注意:此字段可能返回 null,表示取不到有效值。 |
ApproveName | String | 签署方姓名 |
ApproveStatus | Integer | 签署方的签署状态 0:还没有发起 1:流程中 没有开始处理 2:待签署 3:已签署 4:已拒绝 5:已过期 6:已撤销 7:还没有预发起 8:待填写 9:因为各种原因而终止 10:填写完成 15:已解除 19:转他人处理 |
ReceiptId | String | 模板配置中的参与方ID,与控件绑定 |
CustomUserId | String | 客户自定义的用户ID 注意:此字段可能返回 null,表示取不到有效值。 |
Mobile | String | 签署人手机号 |
SignOrder | Integer | 签署顺序,如果是有序签署,签署顺序从小到大 |
ApproveTime | Integer | 签署人签署时间,时间戳,单位秒 |
ApproveType | String | 签署方类型,ORGANIZATION-企业员工,PERSON-个人,ENTERPRISESERVER-企业静默签 注意:此字段可能返回 null,表示取不到有效值。 |
ApproverSource | String | 签署方侧用户来源,如WEWORKAPP-企业微信等 注意:此字段可能返回 null,表示取不到有效值。 |
CustomApproverTag | String | 客户自定义签署方标识 注意:此字段可能返回 null,表示取不到有效值。 |
OrganizationId | String | 签署方企业Id 注意:此字段可能返回 null,表示取不到有效值。 |
OrganizationName | String | 签署方企业名称 注意:此字段可能返回 null,表示取不到有效值。 |
SignId | String | 签署参与人在本流程中的编号ID(每个流程不同),可用此ID来定位签署参与人在本流程的签署节点,也可用于后续创建签署链接等操作。 注意:此字段可能返回 null,表示取不到有效值。 示例值:yDw**y0S |
ApproverRoleName | String | 自定义签署人角色 注意:此字段可能返回 null,表示取不到有效值。 |
FlowApproverUrlInfo
签署链接信息。
被如下接口引用:CreateBatchQuickSignUrl, CreateFlowSignUrl。
名称 | 类型 | 描述 |
---|---|---|
SignUrl | String | 签署短链接。 注意: - 该链接有效期为30分钟,同时需要注意保密,不要外泄给无关用户。 - 该链接不支持小程序嵌入,仅支持移动端浏览器打开。 注意:此字段可能返回 null,表示取不到有效值。 示例值:https://essurl.cn/M**XE |
ApproverType | Integer | 签署人类型。 - 1: 个人 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
ApproverName | String | 签署人姓名。 注意:此字段可能返回 null,表示取不到有效值。 示例值:典子谦 |
ApproverMobile | String | 签署人手机号。 注意:此字段可能返回 null,表示取不到有效值。 示例值:13200000000 |
LongUrl | String | 签署长链接。 注意: - 该链接有效期为30分钟,同时需要注意保密,不要外泄给无关用户。 - 该链接不支持小程序嵌入,仅支持移动端浏览器打开。 注意:此字段可能返回 null,表示取不到有效值。 示例值:https://quick.qian.tencent.cn/home?ApproverIdCardNumber=MioqK**Kio2&ApproverMobile=MTkx**%3D&ApproverName=%25E**2A&ApproverType=1&Code=yDS**w3u2Mg8q&CodeType=QUICK&FlowId=yDSLVUU**MszDy&ShowHeader=1&shortKey=yDwq5U**GlG1c&token=M**XE |
FlowBrief
合同流程的基础信息
被如下接口引用:DescribeFlowBriefs。
名称 | 类型 | 描述 |
---|---|---|
FlowId | String | 合同流程ID,为32位字符串。 示例值:yDRCLUUgygq2xun5UuO4zjEwg0vjoimj |
FlowName | String | 合同流程的名称。 示例值:测试合同-1 |
FlowDescription | String | 合同流程描述信息。 注意:此字段可能返回 null,表示取不到有效值。 示例值:测试流程的描述信息 |
FlowType | String | 合同流程的类别分类(如销售合同/入职合同等)。 示例值:入职合同 |
FlowStatus | Integer | 合同流程当前的签署状态, 会存在下列的状态值
注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
CreatedOn | Integer | 合同流程创建时间,格式为Unix标准时间戳(秒)。 注意:此字段可能返回 null,表示取不到有效值。 示例值:1604910798 |
FlowMessage | String | 当合同流程状态为已拒签(即 FlowStatus=3)或已撤销(即 FlowStatus=6)时,此字段 FlowMessage 为拒签或撤销原因。 注意:此字段可能返回 null,表示取不到有效值。 示例值:因合同中的预付款金额错误所以撤销此合同 |
Creator | String | 合同流程发起方的员工编号, 即员工在腾讯电子签平台的唯一身份标识。 注意:此字段可能返回 null,表示取不到有效值。 示例值:yDxVwUyKQWho8CUuO4zjEyQOAgwvr4Zy |
Deadline | Integer | 合同流程的签署截止时间,格式为Unix标准时间戳(秒)。 注意:此字段可能返回 null,表示取不到有效值。 示例值:1606910798 |
FlowCreateApprover
创建流程的签署方信息
被如下接口引用:CreateBatchQuickSignUrl, CreateFlow, CreateFlowSignUrl, CreatePrepareFlow。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
ApproverType | Integer | 是 | 在指定签署方时,可选择企业B端或个人C端等不同的参与者类型,可选类型如下: 0:企业 1:个人 3:企业静默签署 注:类型为3(企业静默签署)时,此接口会默认完成该签署方的签署。静默签署仅进行盖章操作,不能自动签名。 7: 个人自动签署,适用于个人自动签场景。 注: 个人自动签场景为白名单功能,使用前请联系对接的客户经理沟通。 示例值:1 |
OrganizationName | String | 否 | 组织机构名称。 请确认该名称与企业营业执照中注册的名称一致。 如果名称中包含英文括号(),请使用中文括号()代替。 注: 当approverType=0(企业签署方) 或 approverType=3(企业静默签署)时,必须指定 |
ApproverName | String | 否 | 签署方经办人的姓名。 经办人的姓名将用于身份认证和电子签名,请确保填写的姓名为签署方的真实姓名,而非昵称等代名。 在未指定签署人电子签UserId情况下,为必填参数 |
ApproverMobile | String | 否 | 签署方经办人手机号码, 支持国内手机号11位数字(无需加+86前缀或其他字符)。 请确认手机号所有方为此合同签署方。 在未指定签署人电子签UserId情况下,为必填参数 |
ApproverIdCardType | String | 否 | 证件类型,支持以下类型
示例值:ID_CARD |
ApproverIdCardNumber | String | 否 | 证件号码,应符合以下规则
示例值:620000198802020000 |
RecipientId | String | 否 | 签署方经办人在模板中配置的参与方ID,与控件绑定,是控件的归属方,ID为32位字符串。 模板发起合同时,该参数为必填项。 文件发起合同时,该参数无需传值。 如果开发者后续用合同模板发起合同,建议保存此值,在用合同模板发起合同中需此值绑定对应的签署经办人 。 |
VerifyChannel | Array of String | 否 | 签署意愿确认渠道,默认为WEIXINAPP:人脸识别 注: 将要废弃, 用ApproverSignTypes签署人签署合同时的认证方式代替, 新客户可请用ApproverSignTypes来设置 示例值:["WEIXINAPP"] |
NotifyType | String | 否 | 通知签署方经办人的方式, 有以下途径:
注: 发起方也是签署方时不给此签署方发送短信 |
IsFullText | Boolean | 否 | 合同强制需要阅读全文,无需传此参数 |
PreReadTime | Integer | 否 | 合同的强制预览时间:3~300s,未指定则按合同页数计算 |
UserId | String | 否 | 签署人userId,仅支持本企业的员工userid, 可在控制台组织管理处获得 注: 若传此字段 则以userid的信息为主,会覆盖传递过来的签署人基本信息, 包括姓名,手机号,证件类型等信息 |
Required | Boolean | 否 | 字段已经废弃,当前只支持true,默认为true |
ApproverSource | String | 否 | 在企微场景下使用,需设置参数为WEWORKAPP,以表明合同来源于企微。 |
CustomApproverTag | String | 否 | 在企业微信场景下,表明该合同流程为或签,其最大长度为64位字符串。 所有参与或签的人员均需具备该标识。 注意,在合同中,不同的或签参与人必须保证其CustomApproverTag唯一。 如果或签签署人为本方企业微信参与人,则需要指定ApproverSource参数为WEWORKAPP。 |
RegisterInfo | RegisterInfo | 否 | 已经废弃, 快速注册相关信息 |
ApproverOption | ApproverOption | 否 | 签署人个性化能力值,如是否可以转发他人处理、是否可以拒签、是否为动态补充签署人等功能开关。 |
SignId | String | 否 | 签署ID - 发起流程时系统自动补充 - 创建签署链接时,可以通过查询详情接口获得签署人的SignId,然后可传入此值为该签署人创建签署链接,无需再传姓名、手机号、证件号等其他信息 |
ApproverNeedSignReview | Boolean | 否 | 发起方企业的签署人进行签署操作前,是否需要企业内部走审批流程,取值如下:
企业可以通过CreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果
注: 此功能可用于与企业内部的审批流程进行关联,支持手动、静默签署合同 |
SignComponents | Array of Component | 否 | 签署人签署控件, 此参数仅针对文件发起(CreateFlowByFiles)生效 合同中的签署控件列表,列表中可支持下列多种签署控件,控件的详细定义参考开发者中心的Component结构体
此参数仅针对文件发起设置生效,模板发起合同签署流程, 请以模板配置为主 |
Components | Array of Component | 否 | 签署人填写控件 此参数仅针对文件发起(CreateFlowByFiles)生效 合同中的填写控件列表,列表中可支持下列多种填写控件,控件的详细定义参考开发者中心的Component结构体
此参数仅针对文件发起设置生效,模板发起合同签署流程, 请以模板配置为主 |
ComponentLimitType | Array of String | 否 | 签署方控件类型为 SIGN_SIGNATURE时,可以指定签署方签名方式 HANDWRITE – 手写签名 OCR_ESIGN -- AI智能识别手写签名 ESIGN -- 个人印章类型 SYSTEM_ESIGN -- 系统签名(该类型可以在用户签署时根据用户姓名一键生成一个签名来进行签署) |
ApproverVerifyTypes | Array of Integer | 否 | 指定个人签署方查看合同的校验方式,可以传值如下:
注:
此参数仅针对文件发起设置生效,模板发起合同签署流程, 请以模板配置为主 . 示例值:[1,2] |
ApproverSignTypes | Array of Integer | 否 | 您可以指定签署方签署合同的认证校验方式,可传递以下值:
注:
注: 此参数仅针对文件发起设置生效,模板发起合同签署流程, 请以模板配置为主 示例值:[1,2] |
FlowDetailInfo
此结构体(FlowDetailInfo)描述的是合同(流程)的详细信息
被如下接口引用:DescribeFlowInfo。
名称 | 类型 | 描述 |
---|---|---|
FlowId | String | 合同流程ID,为32位字符串。 示例值:yDRCLUUgygq2xun5UuO4zjEwg0vjoimj |
FlowName | String | 合同流程的名称(可自定义此名称),长度不能超过200,只能由中文、字母、数字和下划线组成。 示例值:购买50吨西瓜的采购合同 |
FlowType | String | 合同流程的类别分类(如销售合同/入职合同等)。 注意:此字段可能返回 null,表示取不到有效值。 示例值:入职合同 |
FlowStatus | Integer | 合同流程当前的签署状态, 会存在下列的状态值
示例值:1 |
FlowMessage | String | 当合同流程状态为已拒签(即 FlowStatus=3)或已撤销(即 FlowStatus=6)时,此字段 FlowMessage 为拒签或撤销原因。 注意:此字段可能返回 null,表示取不到有效值。 示例值:因合同中的预付款金额错误所以撤销此合同 |
FlowDescription | String | 合同流程描述信息。 注意:此字段可能返回 null,表示取不到有效值。 示例值:测试流程的描述信息 |
CreatedOn | Integer | 合同流程的创建时间戳,格式为Unix标准时间戳(秒)。 示例值:1606910798 |
FlowApproverInfos | Array of FlowApproverDetail | 合同流程的签署方数组 |
CcInfos | Array of FlowApproverDetail | 合同流程的关注方信息数组 |
Creator | String | 合同流程发起方的员工编号, 即员工在腾讯电子签平台的唯一身份标识。 注意:此字段可能返回 null,表示取不到有效值。 示例值:yDxVwUyKQWho8CUuO4zjEyQOAgwvr4Zy |
FlowGroupInfo
此结构体(FlowGroupInfo)描述的是合同组(流程组)的单个合同(流程)信息
被如下接口引用:CreateFlowGroupByFiles, CreateFlowGroupByTemplates。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
FlowName | String | 是 | 合同流程的名称(可自定义此名称),长度不能超过200,只能由中文、字母、数字和下划线组成。 该名称还将用于合同签署完成后的下载文件名。 |
Approvers | Array of ApproverInfo | 是 | 签署流程参与者信息,最大限制50方 注意 approver中的顺序需要和模板中的顺序保持一致, 否则会导致模板中配置的信息无效。 |
FileIds | Array of String | 否 | 文件资源ID,通过多文件上传UploadFiles接口获得,为32位字符串。 建议开发者保存此资源ID,后续创建合同或创建合同流程需此资源ID。 |
TemplateId | String | 否 | 合同模板ID,为32位字符串。 建议开发者保存此模板ID,后续用此模板发起合同流程需要此参数。 可登录腾讯电子签控制台,在 "模板"->"模板中心"->"列表展示设置"选中模板 ID 中查看某个模板的TemplateId(在页面中展示为模板ID)。 |
FlowType | String | 否 | 签署流程的类型(如销售合同/入职合同等),最大长度200个字符 示例值:劳务合同 |
FlowDescription | String | 否 | 签署流程描述,最大长度1000个字符 |
Deadline | Integer | 否 | 签署流程的签署截止时间。 值为unix时间戳,精确到秒,不传默认为当前时间一年后 示例值:1604912664 |
UserData | String | 否 | 调用方自定义的个性化字段(可自定义此字段的值),并以base64方式编码,支持的最大数据大小为 20480长度。 在合同状态变更的回调信息等场景中,该字段的信息将原封不动地透传给贵方。 回调的相关说明可参考开发者中心的回调通知模块。 |
Unordered | Boolean | 否 | 发送类型: true:无序签 false:有序签 注:默认为false(有序签),请和模板中的配置保持一致 示例值:true |
Components | Array of Component | 否 | 模板或者合同中的填写控件列表,列表中可支持下列多种填写控件,控件的详细定义参考开发者中心的Component结构体
|
NeedSignReview | Boolean | 否 | 发起方企业的签署人进行签署操作是否需要企业内部审批。使用此功能需要发起方企业有参与签署。 若设置为true,审核结果需通过接口 CreateFlowSignReview 通知电子签,审核通过后,发起方企业签署人方可进行签署操作,否则会阻塞其签署操作。 注:企业可以通过此功能与企业内部的审批流程进行关联,支持手动、静默签署合同。 示例值:true |
AutoSignScene | String | 否 | 个人自动签场景。发起自动签署时,需设置对应自动签署场景,目前仅支持场景:处方单-E_PRESCRIPTION_AUTO_SIGN 示例值:E_PRESCRIPTION_AUTO_SIGN |
FlowGroupOptions
此结构体(FlowGroupOptions)描述的是合同组的个性化配置,支持控制是否发送短信、未实名个人签署方查看合同组时是否需要实名认证(仅在合同组文件发起配置时生效)
被如下接口引用:CreateFlowGroupByFiles, CreateFlowGroupByTemplates。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
ApproverVerifyType | String | 否 | 签署人校验方式,支持以下类型
参数说明:此参数仅在合同组文件发起有效,可选人脸识别或手机号验证两种方式,若选择后者,未实名个人签署方在签署合同时,无需经过实名认证和意愿确认两次人脸识别,该能力仅适用于个人签署方。 |
SelfOrganizationApproverNotifyType | String | 否 | 发起合同(流程)组本方企业经办人通知方式 签署通知类型,支持以下类型
|
OtherApproverNotifyType | String | 否 | 发起合同(流程)组他方经办人通知方式 签署通知类型,支持以下类型
|
FormField
电子文档的控件填充信息。按照控件类型进行相应的填充。
当控件的 ComponentType=‘SIGN_SEAL'时,FormField.ComponentValue填入印章id。
- 可用于指定自动签模板未设置自动签印章时,可由接口传入自动签印章
- 若指定的控件上已设置ComponentValue,那以已经设置的ComponentValue为准
FormField输入示例:
{
"ComponentId": "componentId1",
"ComponentValue": "sealId(印章id)"
}
当控件的 ComponentType='TEXT'时,FormField.ComponentValue填入文本内容
FormField输入示例:
{
"ComponentId": "componentId1",
"ComponentValue": "文本内容"
}
当控件的 ComponentType='MULTI_LINE_TEXT'时,FormField.ComponentValue填入文本内容,支持自动换行。
FormField输入示例:
{
"ComponentId": "componentId1",
"ComponentValue": "多行文本内容"
}
当控件的 ComponentType='CHECK_BOX'时,FormField.ComponentValue填入true或false文本
FormField输入示例:
{
"ComponentId": "componentId1",
"ComponentValue": "true"
}
当控件的 ComponentType='FILL_IMAGE'时,FormField.ComponentValue填入图片的资源ID
FormField输入示例:
{
"ComponentId": "componentId1",
"ComponentValue": "yDwhsxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
当控件的 ComponentType='ATTACHMENT'时,FormField.ComponentValue填入附件图片的资源ID列表,以逗号分隔,单个附件控件最多支持6个资源ID;
FormField输入示例:
{
"ComponentId": "componentId1",
"ComponentValue": "yDwhsxxxxxxxxxxxxxxxxxxxxxxxxxx1,yDwhsxxxxxxxxxxxxxxxxxxxxxxxxxx2,yDwhsxxxxxxxxxxxxxxxxxxxxxxxxxx3"
}
当控件的 ComponentType='SELECTOR'时,FormField.ComponentValue填入选择的选项内容;
FormField输入示例:
{
"ComponentId": "componentId1",
"ComponentValue": "选择的内容"
}
当控件的 ComponentType='DATE'时,FormField.ComponentValue填入日期内容;
FormField输入示例:
{
"ComponentId": "componentId1",
"ComponentValue": "2023年01月01日"
}
当控件的 ComponentType='DISTRICT'时,FormField.ComponentValue填入省市区内容;
FormField输入示例:
{
"ComponentId": "componentId1",
"ComponentValue": "广东省深圳市福田区"
}
【数据表格传参说明】 当控件的 ComponentType='DYNAMIC_TABLE'时,FormField.ComponentValue需要传递json格式的字符串参数,用于确定表头&填充数据表格(支持内容的单元格合并) 输入示例1:
{
"headers":[
{
"content":"head1"
},
{
"content":"head2"
},
{
"content":"head3"
}
],
"rowCount":3,
"body":{
"cells":[
{
"rowStart":1,
"rowEnd":1,
"columnStart":1,
"columnEnd":1,
"content":"123"
},
{
"rowStart":2,
"rowEnd":3,
"columnStart":1,
"columnEnd":2,
"content":"456"
},
{
"rowStart":3,
"rowEnd":3,
"columnStart":3,
"columnEnd":3,
"content":"789"
}
]
}
}
输入示例2(表格表头宽度比例配置):
{
"headers":[
{
"content":"head1",
"widthPercent": 30
},
{
"content":"head2",
"widthPercent": 30
},
{
"content":"head3",
"widthPercent": 40
}
],
"rowCount":3,
"body":{
"cells":[
{
"rowStart":1,
"rowEnd":1,
"columnStart":1,
"columnEnd":1,
"content":"123"
},
{
"rowStart":2,
"rowEnd":3,
"columnStart":1,
"columnEnd":2,
"content":"456"
},
{
"rowStart":3,
"rowEnd":3,
"columnStart":3,
"columnEnd":3,
"content":"789"
}
]
}
}
输入示例3(表格设置字体加粗颜色):
{
"headers":[
{
"content":"head1"
},
{
"content":"head2"
},
{
"content":"head3"
}
],
"rowCount":3,
"body":{
"cells":[
{
"rowStart":1,
"rowEnd":1,
"columnStart":1,
"columnEnd":1,
"content":"123",
"style": "{"color": "#b50000", "fontSize": 12,"bold": true,"align": "CENTER"}"
},
{
"rowStart":2,
"rowEnd":3,
"columnStart":1,
"columnEnd":2,
"content":"456",
"style": {"color": "#b50000", "fontSize": 12,"bold": true,"align": "LEFT"}"
},
{
"rowStart":3,
"rowEnd":3,
"columnStart":3,
"columnEnd":3,
"content":"789",
"style": {"color": "#b500bf", "fontSize": 12,"bold": false,"align": "RIGHT"}
}
]
}
}
表格参数说明
名称 | 类型 | 描述 |
---|---|---|
headers | Array | 表头:不超过10列,不支持单元格合并,字数不超过100 |
rowCount | Integer | 表格内容最大行数 |
cells.N.rowStart | Integer | 单元格坐标:行起始index |
cells.N.rowEnd | Integer | 单元格坐标:行结束index |
cells.N.columnStart | Integer | 单元格坐标:列起始index |
cells.N.columnEnd | Integer | 单元格坐标:列结束index |
cells.N.content | String | 单元格内容,字数不超过100 |
cells.N.style | String | 单元格字体风格配置 ,风格配置的json字符串 如: {"font":"黑体","fontSize":12,"color":"FFFFFF","bold":true,"align":"CENTER"} |
表格参数headers说明 widthPercent Integer 表头单元格列占总表头的比例,例如1:30表示 此列占表头的30%,不填写时列宽度平均拆分;例如2:总2列,某一列填写40,剩余列可以为空,按照60计算。;例如3:总3列,某一列填写30,剩余2列可以为空,分别为(100-30)/2=35
content String 表头单元格内容,字数不超过100
style String 为字体风格设置 风格支持: font : 目前支持 黑体、宋体; fontSize: 6-72; color:000000-FFFFFF 字符串形如: "FFFFFF"; bold : 是否加粗, true : 加粗 false: 不加粗; align: 对其方式, 支持 LEFT / RIGHT / CENTER
被如下接口引用:CreateDocument。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
ComponentValue | String | 是 | 控件填充vaule,ComponentType和传入值类型对应关系: TEXT - 文本内容 MULTI_LINE_TEXT - 文本内容 CHECK_BOX - true/false FILL_IMAGE、ATTACHMENT - 附件的FileId,需要通过UploadFiles接口上传获取 SELECTOR - 选项值 DYNAMIC_TABLE - 传入json格式的表格内容,具体见数据结构FlowInfo:https://cloud.tencent.com/document/api/1420/61525#FlowInfo 示例值:ComponentValue |
ComponentId | String | 否 | 控件id,和ComponentName选择一项传入即可 示例值:componentId |
ComponentName | String | 否 | 控件名字,最大长度不超过30字符,和ComponentId选择一项传入即可 示例值:ComponentName |
GroupOrganization
成员企业信息
被如下接口引用:DescribeOrganizationGroupOrganizations。
名称 | 类型 | 描述 |
---|---|---|
Name | String | 成员企业名 注意:此字段可能返回 null,表示取不到有效值。 |
Alias | String | 成员企业别名 注意:此字段可能返回 null,表示取不到有效值。 |
OrganizationId | String | 成员企业id,为 32 位字符串,可在电子签PC 控制台,企业设置->企业电子签账号 获取 注意:此字段可能返回 null,表示取不到有效值。 |
UpdateTime | Integer | 记录更新时间, unix时间戳,单位秒 注意:此字段可能返回 null,表示取不到有效值。 |
Status | Integer | 成员企业加入集团的当前状态
注意:此字段可能返回 null,表示取不到有效值。 |
IsMainOrganization | Boolean | 是否为集团主企业 注意:此字段可能返回 null,表示取不到有效值。 |
IdCardNumber | String | 企业社会信用代码 注意:此字段可能返回 null,表示取不到有效值。 |
AdminInfo | Admin | 企业超管信息 注意:此字段可能返回 null,表示取不到有效值。 |
License | String | 企业许可证Id,此字段暂时不需要关注 注意:此字段可能返回 null,表示取不到有效值。 |
LicenseExpireTime | Integer | 企业许可证过期时间,unix时间戳,单位秒 注意:此字段可能返回 null,表示取不到有效值。 |
JoinTime | Integer | 成员企业加入集团时间,unix时间戳,单位秒 注意:此字段可能返回 null,表示取不到有效值。 |
FlowEngineEnable | Boolean | 是否使用自建审批流引擎(即不是企微审批流引擎)
注意:此字段可能返回 null,表示取不到有效值。 |
HasAuthUser
被授权的用户信息
被如下接口引用:DescribeExtendedServiceAuthInfos。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
UserId | String | 否 | 员工在腾讯电子签平台的唯一身份标识,为32位字符串。 注意:此字段可能返回 null,表示取不到有效值。 |
BelongTo | String | 否 | 当前员工的归属情况,可能值是: MainOrg:在集团企业的场景下,返回此值代表是归属主企业 CurrentOrg:在普通企业场景下返回此值;或者在集团企业的场景下,返回此值代表归属子企业 注意:此字段可能返回 null,表示取不到有效值。 |
MainOrganizationId | String | 否 | 集团主企业id,当前企业为集团子企业时,该字段有值 注意:此字段可能返回 null,表示取不到有效值。 |
IntegrateRole
企业角色数据信息
被如下接口引用:DescribeIntegrationRoles。
名称 | 类型 | 描述 |
---|---|---|
RoleId | String | 角色id 注意:此字段可能返回 null,表示取不到有效值。 |
RoleName | String | 角色名 注意:此字段可能返回 null,表示取不到有效值。 |
RoleStatus | Integer | 角色状态,1-启用,2-禁用 注意:此字段可能返回 null,表示取不到有效值。 |
IsGroupRole | Boolean | 是否是集团角色,true-是,false-否 注意:此字段可能返回 null,表示取不到有效值。 |
SubOrgIdList | Array of String | 管辖的子企业列表 注意:此字段可能返回 null,表示取不到有效值。 |
PermissionGroups | Array of PermissionGroup | 权限树 注意:此字段可能返回 null,表示取不到有效值。 |
IntegrationDepartment
部门信息
被如下接口引用:DescribeIntegrationDepartments。
名称 | 类型 | 描述 |
---|---|---|
DeptId | String | 部门ID。 注意:此字段可能返回 null,表示取不到有效值。 示例值:dp**155f2 |
DeptName | String | 部门名。 注意:此字段可能返回 null,表示取不到有效值。 示例值:测试部门 |
ParentDeptId | String | 父部门ID 注意:此字段可能返回 null,表示取不到有效值。 示例值:yD**m1221 |
DeptOpenId | String | 客户系统部门ID 注意:此字段可能返回 null,表示取不到有效值。 示例值:dept_open_1 |
OrderNo | Integer | 序列号。 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
OccupiedSeal
持有的电子印章信息
被如下接口引用:DescribeOrganizationSeals。
名称 | 类型 | 描述 |
---|---|---|
SealId | String | 电子印章编号 |
SealName | String | 电子印章名称 |
CreateOn | Integer | 电子印章授权时间戳,单位秒 |
Creator | String | 电子印章授权人的UserId |
SealPolicyId | String | 电子印章策略Id |
SealStatus | String | 印章状态,有以下六种:CHECKING(审核中)SUCCESS(已启用)FAIL(审核拒绝)CHECKING-SADM(待超管审核)DISABLE(已停用)STOPPED(已终止) |
FailReason | String | 审核失败原因 注意:此字段可能返回 null,表示取不到有效值。 |
Url | String | 印章图片url,5分钟内有效 |
SealType | String | 印章类型,OFFICIAL-企业公章, CONTRACT-合同专用章,ORGANIZATIONSEAL-企业印章(本地上传印章类型),LEGAL_PERSON_SEAL-法人印章 |
IsAllTime | Boolean | 用印申请是否为永久授权,true-是,false-否 |
AuthorizedUsers | Array of AuthorizedUser | 授权人列表 注意:此字段可能返回 null,表示取不到有效值。 |
PdfVerifyResult
合同文件验签单个结果结构体
被如下接口引用:VerifyPdf。
名称 | 类型 | 描述 |
---|---|---|
VerifyResult | Integer | 验签结果。0-签名域未签名;1-验签成功; 3-验签失败;4-未找到签名域:文件内没有签名域;5-签名值格式不正确。 |
SignPlatform | String | 签署平台 如果文件是在腾讯电子签平台签署,则为腾讯电子签, 如果文件不在腾讯电子签平台签署,则为其他平台。 |
SignerName | String | 申请证书的主体的名字 如果是在腾讯电子签平台签署, 则对应的主体的名字个数如下 企业: ESS@企业名称@编码 个人: ESS@个人姓名@证件号@808854 如果在其他平台签署的, 主体的名字参考其他平台的说明 |
SignTime | Integer | 签署时间的Unix时间戳,单位毫秒 |
SignAlgorithm | String | 证书签名算法, 如SHA1withRSA等算法 |
CertSn | String | CA供应商下发给用户的证书编号 注意: 腾讯电子签接入多家CA供应商以提供容灾能力,不同CA下发的证书编号区别较大,但基本都是由数字和字母组成,长度在200以下 。 |
CertNotBefore | Integer | 证书起始时间的Unix时间戳,单位毫秒 |
CertNotAfter | Integer | 证书过期时间的时间戳,单位毫秒 |
ComponentPosX | Float | 签名域横坐标,单位px |
ComponentPosY | Float | 签名域纵坐标,单位px |
ComponentWidth | Float | 签名域宽度,单位px |
ComponentHeight | Float | 签名域高度,单位px |
ComponentPage | Integer | 签名域所在页码,1~N |
Permission
权限树节点权限
被如下接口引用:CreateIntegrationRole, ModifyIntegrationRole。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
Name | String | 否 | 权限名称 注意:此字段可能返回 null,表示取不到有效值。 |
Key | String | 否 | 权限key 注意:此字段可能返回 null,表示取不到有效值。 |
Type | Integer | 否 | 权限类型 1前端,2后端 注意:此字段可能返回 null,表示取不到有效值。 |
Hide | Integer | 否 | 是否隐藏 注意:此字段可能返回 null,表示取不到有效值。 |
DataLabel | Integer | 否 | 数据权限标签 1:表示根节点,2:表示叶子结点 注意:此字段可能返回 null,表示取不到有效值。 |
DataType | Integer | 否 | 数据权限独有,1:关联其他模块鉴权,2:表示关联自己模块鉴权 注意:此字段可能返回 null,表示取不到有效值。 |
DataRange | Integer | 否 | 数据权限独有,表示数据范围,1:全公司,2:部门及下级部门,3:自己 注意:此字段可能返回 null,表示取不到有效值。 |
DataTo | String | 否 | 关联权限, 表示这个功能权限要受哪个数据权限管控 注意:此字段可能返回 null,表示取不到有效值。 |
ParentKey | String | 否 | 父级权限key 注意:此字段可能返回 null,表示取不到有效值。 |
IsChecked | Boolean | 否 | 是否选中 注意:此字段可能返回 null,表示取不到有效值。 |
Children | Array of Permission | 否 | 子权限集合 注意:此字段可能返回 null,表示取不到有效值。 |
PermissionGroup
权限树中的权限组
被如下接口引用:CreateIntegrationRole, DescribeIntegrationRoles, ModifyIntegrationRole。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
GroupName | String | 否 | 权限组名称 注意:此字段可能返回 null,表示取不到有效值。 |
GroupKey | String | 否 | 权限组key 注意:此字段可能返回 null,表示取不到有效值。 |
Hide | Integer | 否 | 是否隐藏分组,0否1是 注意:此字段可能返回 null,表示取不到有效值。 |
Permissions | Array of Permission | 否 | 权限集合 注意:此字段可能返回 null,表示取不到有效值。 |
Recipient
流程中参与方的信息结构
被如下接口引用:DescribeFlowTemplates。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
RecipientId | String | 否 | 签署参与者ID,唯一标识 |
RecipientType | String | 否 | 参与者类型。 默认为空。 ENTERPRISE-企业; INDIVIDUAL-个人; PROMOTER-发起方 示例值:ENTERPRISE |
Description | String | 否 | 描述信息 |
RoleName | String | 否 | 角色名称 |
RequireValidation | Boolean | 否 | 是否需要验证, 默认为false-不需要验证 |
RequireSign | Boolean | 否 | 是否需要签署, 默认为true-需要签署 |
RoutingOrder | Integer | 否 | 此参与方添加的顺序,从0~N |
RequireDelivery | Boolean | 否 | 是否需要发送, 默认为true-需要发送 |
String | 否 | 邮箱地址 | |
Mobile | String | 否 | 电话号码 |
UserId | String | 否 | 关联的用户ID,电子签系统的用户ID |
DeliveryMethod | String | 否 | 发送方式,默认为EMAIL。 EMAIL-邮件; MOBILE-手机短信; WECHAT-微信通知 示例值:EMAIL |
RecipientExtra | String | 否 | 参与方的一些附属信息,json格式 |
ApproverVerifyTypes | Array of Integer | 否 | 签署人查看合同校验方式, 支持的类型如下:
|
ApproverSignTypes | Array of Integer | 否 | 签署人进行合同签署时的认证方式,支持的类型如下:
|
RecipientComponentInfo
参与方填写控件信息
被如下接口引用:DescribeFlowComponents。
名称 | 类型 | 描述 |
---|---|---|
RecipientId | String | 参与方Id 注意:此字段可能返回 null,表示取不到有效值。 |
RecipientFillStatus | String | 参与方填写状态
注意:此字段可能返回 null,表示取不到有效值。 |
IsPromoter | Boolean | 是否为发起方
注意:此字段可能返回 null,表示取不到有效值。 |
Components | Array of FilledComponent | 填写控件列表 注意:此字段可能返回 null,表示取不到有效值。 |
RegisterInfo
发起流程快速注册相关信息
被如下接口引用:CreateBatchQuickSignUrl, CreateFlow, CreateFlowSignUrl, CreatePrepareFlow。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
LegalName | String | 是 | 法人姓名 |
UnifiedSocialCreditCode | String | 否 | 社会统一信用代码 |
ReleasedApprover
解除协议的签署人,如不指定,默认使用原流程中的签署人。
注意:不支持更换C端(个人身份类型)签署人,如果原流程中含有C端签署人,默认使用原流程中的该C端签署人。
注意:目前不支持替换C端(个人身份类型)签署人,但是可以指定C端签署人的签署方自定义控件别名,具体见参数ApproverSignRole描述。
注意:当指定C端签署人的签署方自定义控件别名不空时,除RelievedApproverReceiptId参数外,可以只参数ApproverSignRole。
被如下接口引用:CreateReleaseFlow。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
Name | String | 是 | 签署人姓名,最大长度50个字。 示例值:典子谦 |
Mobile | String | 是 | 签署人手机号。 示例值:13200000000 |
RelievedApproverReceiptId | String | 是 | 要更换的原合同参与人RecipientId编号。(可通过接口DescribeFlowInfo查询签署人的RecipientId编号) |
ApproverType | String | 否 | 指定签署人类型,目前仅支持
示例值:ORGANIZATION |
ApproverSignComponentType | String | 否 | 签署控件类型,支持自定义企业签署方的签署控件类型
|
ApproverSignRole | String | 否 | 参与方在合同中的角色是按照创建合同的时候来排序的,解除协议默认会将第一个参与人叫甲方 ,第二个叫乙方 , 第三个叫丙方 ,以此类推。如果需改动此参与人的角色名字,可用此字段指定,由汉字,英文字符,数字组成,最大20个字。 示例值:供应商 |
RelieveInfo
解除协议文档中内容信息,包括但不限于:解除理由、解除后仍然有效的条款-保留条款、原合同事项处理-费用结算、原合同事项处理-其他事项、其他约定等。
被如下接口引用:CreateReleaseFlow。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
Reason | String | 是 | 解除理由,长度不能超过200,只能由中文、字母、数字、中文标点和英文标点组成(不支持表情)。 |
RemainInForceItem | String | 否 | 解除后仍然有效的条款,保留条款,长度不能超过200,只能由中文、字母、数字、中文标点和英文标点组成(不支持表情)。 |
OriginalExpenseSettlement | String | 否 | 原合同事项处理-费用结算,长度不能超过200,只能由中文、字母、数字、中文标点和英文标点组成(不支持表情)。 |
OriginalOtherSettlement | String | 否 | 原合同事项处理-其他事项,长度不能超过200,只能由中文、字母、数字、中文标点和英文标点组成(不支持表情)。 |
OtherDeals | String | 否 | 其他约定,长度不能超过200,只能由中文、字母、数字、中文标点和英文标点组成(不支持表情)。 |
RemindFlowRecords
催办接口返回的详细信息。
被如下接口引用:CreateFlowReminds。
名称 | 类型 | 描述 |
---|---|---|
CanRemind | Boolean | 合同流程是否可以催办: true - 可以,false - 不可以。 若无法催办,将返回RemindMessage以解释原因。 示例值:true |
FlowId | String | 合同流程ID,为32位字符串。 示例值:yDwxxxxxxxW72Qaxm |
RemindMessage | String | 在合同流程无法催办的情况下,系统将返回RemindMessage以阐述原因。 示例值:"" |
ReviewerInfo
关注方信息
被如下接口引用:CreateEmbedWebUrl。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
Name | String | 否 | 姓名 |
Mobile | String | 否 | 手机号 |
SealInfo
模板中指定的印章信息
被如下接口引用:DescribeFlowTemplates。
名称 | 类型 | 描述 |
---|---|---|
SealId | String | 印章ID 注意:此字段可能返回 null,表示取不到有效值。 |
SealType | String | 印章类型。LEGAL_PERSON_SEAL: 法定代表人章; ORGANIZATIONSEAL:企业印章; OFFICIAL:企业公章; CONTRACT:合同专用章 注意:此字段可能返回 null,表示取不到有效值。 |
SealName | String | 印章名称 注意:此字段可能返回 null,表示取不到有效值。 |
SignQrCode
签署二维码的基本信息,用于创建二维码,用户可扫描该二维码进行签署操作。
被如下接口引用:CreateMultiFlowSignQRCode。
名称 | 类型 | 描述 |
---|---|---|
QrCodeId | String | 二维码ID,为32位字符串。 示例值:yDRS*Swc |
QrCodeUrl | String | 二维码URL,可通过转换二维码的工具或代码组件将此URL转化为二维码,以便用户扫描进行流程签署。 示例值:https://xxxx |
ExpiredTime | Integer | 二维码的有截止时间,格式为Unix标准时间戳(秒)。 一旦超过二维码的有效期限,该二维码将自动失效。 示例值:1693814798 |
SignUrl
流程签署二维码的签署信息,适用于客户系统整合二维码功能。 通过链接,用户可直接访问电子签名小程序并签署合同。
被如下接口引用:CreateMultiFlowSignQRCode。
名称 | 类型 | 描述 |
---|---|---|
AppSignUrl | String | 跳转至电子签名小程序签署的链接地址。 适用于客户端APP及小程序直接唤起电子签名小程序。 示例值:pages/guide?from=default&where=mini&autoJumpBack=true&to=CHANNEL_CONTRACT_COVER&xxx |
EffectiveTime | String | 签署链接有效时间,格式类似"2022-08-05 15:55:01" 示例值:2022-08-05 15:55:01 |
HttpSignUrl | String | 跳转至电子签名小程序签署的链接地址,格式类似于https://essurl.cn/xxx。 打开此链接将会展示H5中间页面,随后唤起电子签名小程序以进行合同签署。 示例值:https://res.ess.tencent.cn/cdn/h5-activity/jump-mp.html?where=mini&from=MSG&to=CHANNEL_CONTRACT_COVER&xxx |
Staff
企业员工信息。
被如下接口引用:CreateIntegrationEmployees, DeleteIntegrationEmployees, DescribeIntegrationEmployees, UpdateIntegrationEmployees。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
UserId | String | 否 | 员工在腾讯电子签平台的唯一身份标识,为32位字符串。 注: 创建和更新场景无需填写。 示例值:yDRCLUUgygq2xun5UuO4zjEwg0vjoimj |
DisplayName | String | 否 | 显示的用户名/昵称。 示例值:张三 |
Mobile | String | 否 | 用户手机号码, 支持国内手机号11位数字(无需加+86前缀或其他字符)。 示例值:13200000000 |
String | 否 | 用户邮箱。 注意:此字段可能返回 null,表示取不到有效值。 示例值:testtest@tencent.com | |
OpenId | String | 否 | 用户在第三方平台ID。 注: 如需在此接口提醒员工实名,该参数不传。 注意:此字段可能返回 null,表示取不到有效值。 示例值:open_user1 |
Roles | Array of StaffRole | 否 | 员工角色信息。 注: 创建和更新场景无需填写。 注意:此字段可能返回 null,表示取不到有效值。 |
Department | Department | 否 | 员工部门信息。 注意:此字段可能返回 null,表示取不到有效值。 |
Verified | Boolean | 否 | 员工是否实名。 注: 创建和更新场景无需填写。 示例值:false |
CreatedOn | Integer | 否 | 员工创建时间戳,单位秒。 注: 创建和更新场景无需填写。 示例值:1691563315 |
VerifiedOn | Integer | 否 | 员工实名时间戳,单位秒。 注: 创建和更新场景无需填写。 注意:此字段可能返回 null,表示取不到有效值。 示例值:1691563315 |
QuiteJob | Integer | 否 | 员工是否离职:
注: 创建和更新场景无需填写。 注意:此字段可能返回 null,表示取不到有效值。 示例值:0 |
ReceiveUserId | String | 否 | 员工离职交接人用户ID。 注: 创建和更新场景无需填写。 示例值:yDxVwUyKQWho8CUuO4zjEyQOAgwvr4Zy |
ReceiveOpenId | String | 否 | 员工离职交接人用户OpenId。 注: 创建和更新场景无需填写。 示例值:open_user2 |
WeworkOpenId | String | 否 | 企业微信用户账号ID。 注: 仅企微类型的企业创建员工接口支持该字段。 注意:此字段可能返回 null,表示取不到有效值。 示例值:wework_open1 |
StaffRole
集成版企业角色信息。
被如下接口引用:CreateIntegrationEmployees, DeleteIntegrationEmployees, DescribeIntegrationEmployees, UpdateIntegrationEmployees。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
RoleId | String | 否 | 角色ID。 注意:此字段可能返回 null,表示取不到有效值。 示例值:4dff1**10b |
RoleName | String | 否 | 角色名称。 注意:此字段可能返回 null,表示取不到有效值。 示例值:业务员 |
SuccessCreateStaffData
创建员工的成功数据
被如下接口引用:CreateIntegrationEmployees。
名称 | 类型 | 描述 |
---|---|---|
DisplayName | String | 员工名 |
Mobile | String | 员工手机号 |
UserId | String | 员工在电子签平台的id |
Note | String | 提示,当创建已存在未实名用户时,该字段有值 注意:此字段可能返回 null,表示取不到有效值。 |
WeworkOpenId | String | 传入的企微账号id |
SuccessDeleteStaffData
删除员工的成功数据
被如下接口引用:DeleteIntegrationEmployees。
名称 | 类型 | 描述 |
---|---|---|
DisplayName | String | 员工名 |
Mobile | String | 员工手机号 |
UserId | String | 员工在电子签平台的id |
SuccessUpdateStaffData
更新员工信息成功返回的数据信息
被如下接口引用:UpdateIntegrationEmployees。
名称 | 类型 | 描述 |
---|---|---|
DisplayName | String | 传入的用户名称 |
Mobile | String | 传入的手机号,没有打码 |
UserId | String | 员工在腾讯电子签平台的唯一身份标识,为32位字符串。 可登录腾讯电子签控制台,在 "更多能力"->"组织管理" 中查看某位员工的UserId(在页面中展示为用户ID)。 |
TemplateInfo
此结构体 (TemplateInfo) 用于描述模板的信息。
模板组成
一个模板通常会包含以下结构信息
- 模板基本信息
- 发起方参与信息Promoter、签署参与方 Recipients,后者会在模板发起合同时用于指定参与方
- 填写控件 Components
- 签署控件 SignComponents
- 生成模板的文件基础信息 FileInfos
被如下接口引用:DescribeFlowTemplates。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
TemplateId | String | 否 | 模板ID,模板的唯一标识 |
TemplateName | String | 否 | 模板名 |
Description | String | 否 | 模板描述信息 |
DocumentResourceIds | Array of String | 否 | 模板关联的资源ID列表 |
FileInfos | Array of FileInfo | 否 | 生成模板的文件基础信息 |
AttachmentResourceIds | Array of String | 否 | 附件关联的资源ID |
SignOrder | Array of Integer | 否 | 签署顺序 无序 -1 有序为序列数字 0,1,2 |
Recipients | Array of Recipient | 否 | 模板中的签署参与方列表 |
Components | Array of Component | 否 | 模板的填充控件列表 |
SignComponents | Array of Component | 否 | 模板中的签署控件列表 |
Status | Integer | 否 | 模板状态 -1:不可用 0:草稿态 1:正式态,可以正常使用 |
Creator | String | 否 | 模板的创建者信息,电子签系统用户ID |
CreatedOn | Integer | 否 | 模板创建的时间戳,格式为Unix标准时间戳(秒) |
Promoter | Recipient | 否 | 发起方参与信息Promoter |
TemplateType | Integer | 否 | 模板类型: 1 静默签, 3 普通模板 |
Available | Integer | 否 | 模板可用状态: 1 启用(默认) 2 停用 |
OrganizationId | String | 否 | 创建模板的企业ID,电子签的机构ID |
PreviewUrl | String | 否 | 模板预览链接,有效时间5分钟 注意:此字段可能返回 null,表示取不到有效值。 |
TemplateVersion | String | 否 | 模板版本。默认为空时,全数字字符,初始版本为yyyyMMdd001。 注意:此字段可能返回 null,表示取不到有效值。 |
Published | Boolean | 否 | 模板是否已发布: true-已发布 false-未发布 注意:此字段可能返回 null,表示取不到有效值。 |
ShareTemplateId | String | 否 | 分享来源的模板ID。用在集团账号子企业模板里 注意:此字段可能返回 null,表示取不到有效值。 |
TemplateSeals | Array of SealInfo | 否 | 模板内部指定的印章列表 注意:此字段可能返回 null,表示取不到有效值。 |
UploadFile
此结构体 (UploadFile) 用于描述多文件上传的文件信息。
被如下接口引用:UploadFiles。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
FileBody | String | 是 | Base64编码后的文件内容 |
FileName | String | 否 | 文件名,最大长度不超过200字符 示例值:test.pdf |
UserInfo
用户信息
被如下接口引用:BindEmployeeUserIdWithClientOpenId, CancelFlow, CancelMultiFlowSignQRCode, CancelUserAutoSignEnableUrl, CreateBatchCancelFlowUrl, CreateBatchQuickSignUrl, CreateBatchSignUrl, CreateConvertTaskApi, CreateDocument, CreateEmbedWebUrl, CreateExtendedServiceAuthInfos, CreateFlow, CreateFlowApprovers, CreateFlowByFiles, CreateFlowEvidenceReport, CreateFlowGroupByFiles, CreateFlowGroupByTemplates, CreateFlowReminds, CreateFlowSignReview, CreateFlowSignUrl, CreateIntegrationDepartment, CreateIntegrationEmployees, CreateIntegrationRole, CreateIntegrationUserRoles, CreateMultiFlowSignQRCode, CreateOrganizationBatchSignUrl, CreateOrganizationInfoChangeUrl, CreatePersonAuthCertificateImage, CreatePrepareFlow, CreatePreparedPersonalEsign, CreateReleaseFlow, CreateSchemeUrl, CreateSeal, CreateSealPolicy, CreateUserAutoSignEnableUrl, CreateUserAutoSignSealUrl, CreateWebThemeConfig, DeleteExtendedServiceAuthInfos, DeleteIntegrationDepartment, DeleteIntegrationEmployees, DeleteIntegrationRoleUsers, DeleteSealPolicies, DescribeExtendedServiceAuthInfos, DescribeFileUrls, DescribeFlowBriefs, DescribeFlowComponents, DescribeFlowEvidenceReport, DescribeFlowInfo, DescribeFlowTemplates, DescribeIntegrationDepartments, DescribeIntegrationEmployees, DescribeIntegrationRoles, DescribeOrganizationGroupOrganizations, DescribeOrganizationSeals, DescribePersonCertificate, DescribeThirdPartyAuthCode, DescribeUserAutoSignStatus, DisableUserAutoSign, GetTaskResultApi, ModifyApplicationCallbackInfo, ModifyIntegrationDepartment, ModifyIntegrationRole, StartFlow, UnbindEmployeeUserIdWithClientOpenId, UpdateIntegrationEmployees, VerifyPdf。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
UserId | String | 否 | 用户在平台的编号 |
UserThreeFactor
用户的三要素:姓名,证件号,证件类型
被如下接口引用:CancelUserAutoSignEnableUrl, CreateUserAutoSignEnableUrl, CreateUserAutoSignSealUrl, DescribePersonCertificate, DescribeUserAutoSignStatus, DisableUserAutoSign。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
Name | String | 是 | 签署方经办人的姓名。 经办人的姓名将用于身份认证和电子签名,请确保填写的姓名为签署方的真实姓名,而非昵称等代名。 示例值:小明 |
IdCardType | String | 是 | 证件类型,支持以下类型
示例值:ID_CARD |
IdCardNumber | String | 是 | 证件号码,应符合以下规则
示例值:610*1X |
WebThemeConfig
页面主题配置
被如下接口引用:CreateWebThemeConfig。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
DisplaySignBrandLogo | Boolean | 否 | 是否显示页面底部电子签logo,取值如下:
示例值:true |
WebEmbedThemeColor | String | 否 | 主题颜色: 支持十六进制颜色值以及RGB格式颜色值,例如:#D54941,rgb(213, 73, 65) 示例值:#D54941 |