数据结构
Admin
企业超管信息
被如下接口引用:DescribeOrganizationGroupOrganizations。
名称 | 类型 | 描述 |
---|---|---|
Name | String | 超管名 注意:此字段可能返回 null,表示取不到有效值。 |
Mobile | String | 超管手机号,打码显示 示例值:138****1569 注意:此字段可能返回 null,表示取不到有效值。 |
Agent
代理相关应用信息,如集团主企业代子企业操作
被如下接口引用:BindEmployeeUserIdWithClientOpenId, CancelFlow, CancelMultiFlowSignQRCode, CancelUserAutoSignEnableUrl, CreateBatchCancelFlowUrl, CreateBatchInitOrganizationUrl, CreateBatchOrganizationAuthorizationUrl, CreateBatchOrganizationRegistrationTasks, CreateBatchQuickSignUrl, CreateBatchSignUrl, CreateConvertTaskApi, CreateDocument, CreateEmbedWebUrl, CreateEmployeeQualificationSealQrCode, CreateExtendedServiceAuthInfos, CreateFlow, CreateFlowApprovers, CreateFlowBlockchainEvidenceUrl, CreateFlowByFiles, CreateFlowEvidenceReport, CreateFlowGroupByFiles, CreateFlowGroupByTemplates, CreateFlowGroupSignReview, CreateFlowReminds, CreateFlowSignReview, CreateFlowSignUrl, CreateIntegrationDepartment, CreateIntegrationEmployees, CreateIntegrationRole, CreateIntegrationUserRoles, CreateLegalSealQrCode, CreateMultiFlowSignQRCode, CreateOrganizationBatchSignUrl, CreateOrganizationInfoChangeUrl, CreatePartnerAutoSignAuthUrl, CreatePersonAuthCertificateImage, CreatePrepareFlow, CreatePreparedPersonalEsign, CreateReleaseFlow, CreateSchemeUrl, CreateSeal, CreateSealPolicy, CreateUserAutoSignEnableUrl, CreateUserAutoSignSealUrl, CreateUserMobileChangeUrl, CreateWebThemeConfig, DeleteExtendedServiceAuthInfos, DeleteIntegrationDepartment, DeleteIntegrationEmployees, DeleteIntegrationRoleUsers, DeleteSealPolicies, DescribeBatchOrganizationRegistrationUrls, DescribeBillUsageDetail, DescribeCancelFlowsTask, DescribeExtendedServiceAuthDetail, DescribeExtendedServiceAuthInfos, DescribeFileUrls, DescribeFlowBriefs, DescribeFlowComponents, DescribeFlowEvidenceReport, DescribeFlowInfo, DescribeFlowTemplates, DescribeIntegrationDepartments, DescribeIntegrationEmployees, DescribeIntegrationRoles, DescribeOrganizationSeals, DescribePersonCertificate, DescribeSignFaceVideo, DescribeThirdPartyAuthCode, DescribeUserAutoSignStatus, DisableUserAutoSign, GetTaskResultApi, ModifyApplicationCallbackInfo, ModifyExtendedService, ModifyFlowDeadline, ModifyIntegrationDepartment, ModifyIntegrationRole, RenewAutoSignLicense, 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 | 否 | 签署方经办人的证件号码,应符合以下规则
示例值:350203180010069855 |
NotifyType | String | 否 | 通知签署方经办人的方式, 有以下途径:
注意: 如果使用的是通过文件发起合同(CreateFlowByFiles),NotifyType必须 是 sms 才会发送短信 示例值: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已经实名, 则忽略ApproverName,ApproverIdCardType,ApproverIdCardNumber,ApproverMobile这四个入参(会用此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(运营商三要素),5(设备指纹识别),6(设备面容识别) 注: 1. 用模板创建合同场景, 签署人的认证方式需要在配置模板的时候指定, 在创建合同重新指定无效 2. 运营商三要素认证方式对手机号运营商及前缀有限制,可以参考运营商支持列表类得到具体的支持说明 3. 校验方式不允许只包含设备指纹识别和设备面容识别,至少需要再增加一种其他校验方式。 4. 设备指纹识别和设备面容识别只支持小程序使用,其他端暂不支持。 示例值:[1,2,3] |
ApproverNeedSignReview | Boolean | 否 | 发起方企业的签署人进行签署操作前,是否需要企业内部走审批流程,取值如下:
企业可以通过CreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果
注: 此功能可用于与企业内部的审批流程进行关联,支持手动、静默签署合同 |
AddSignComponentsLimits | Array of ComponentLimit | 否 | 用PDF文件创建签署流程时,如果设置了外层参数SignBeanTag=1(允许签署过程中添加签署控件),则可通过此参数明确规定合同所使用的签署控件类型(骑缝章、普通章法人章等)和具体的印章(印章ID或者印章类型)或签名方式。 注: 限制印章控件或骑缝章控件情况下,仅本企业签署方可以指定具体印章(通过传递ComponentValue,支持多个),他方企业或个人只支持限制控件类型。 |
SignInstructionContent | String | 否 | 签署须知:支持传入富文本,最长字数:500个中文字符 |
Deadline | Integer | 否 | 签署人的签署截止时间,格式为Unix标准时间戳(秒) 注: 若不设置此参数,则默认使用合同的截止时间,此参数暂不支持合同组子合同 示例值:1705977064 |
Components | Array of Component | 否 | 签署人在合同中的填写控件列表,列表中可支持下列多种填写控件,控件的详细定义参考开发者中心的Component结构体
具体使用说明可参考为签署方指定填写控件 注: 此参数仅在通过文件发起合同或者合同组时生效 |
ApproverItem
签署方信息,发起合同后可获取到对应的签署方信息,如角色ID,角色名称
被如下接口引用:CreateDocument, CreateFlowByFiles, CreateFlowGroupByFiles, CreateFlowGroupByTemplates。
名称 | 类型 | 描述 |
---|---|---|
SignId | String | 签署方唯一编号 注意:此字段可能返回 null,表示取不到有效值。 |
RecipientId | String | 签署方角色编号 注意:此字段可能返回 null,表示取不到有效值。 |
ApproverRoleName | String | 签署方角色名称 注意:此字段可能返回 null,表示取不到有效值。 |
ApproverOption
签署人个性化能力信息
被如下接口引用:CreateBatchQuickSignUrl, CreateFlow, CreateFlowByFiles, CreateFlowGroupByFiles, CreateFlowGroupByTemplates, CreateFlowSignUrl, CreatePrepareFlow。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
NoRefuse | Boolean | 否 | 签署方是否可以拒签
示例值:true |
NoTransfer | Boolean | 否 | 签署方是否可以转他人处理
示例值:true |
CanEditApprover | Boolean | 否 | 允许编辑签署人信息(嵌入式使用) 默认true-可以编辑 false-不可以编辑 示例值:true |
FillType | Integer | 否 | 签署人信息补充类型,默认无需补充。
注: 使用动态签署人能力前,需登陆腾讯电子签控制台打开服务开关 |
FlowReadLimit | String | 否 | 签署人阅读合同限制参数 取值:
|
ApproverRestriction
指定签署人限制项
被如下接口引用:CreateMultiFlowSignQRCode。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
Name | String | 否 | 指定签署人名字 示例值:张三 |
Mobile | String | 否 | 指定签署人手机号,11位数字 示例值:13000000000 |
IdCardType | String | 否 | 指定签署人证件类型,ID_CARD-身份证 示例值:ID_CARD |
IdCardNumber | String | 否 | 指定签署人证件号码,字母大写 示例值:4500000000000000000 |
AuthInfoDetail
企业扩展服务授权列表详情
被如下接口引用:DescribeExtendedServiceAuthDetail。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
Type | String | 否 | 扩展服务类型,和入参一致 注意:此字段可能返回 null,表示取不到有效值。 |
Name | String | 否 | 扩展服务名称 注意:此字段可能返回 null,表示取不到有效值。 |
HasAuthUserList | Array of HasAuthUser | 否 | 授权员工列表 注意:此字段可能返回 null,表示取不到有效值。 |
HasAuthOrganizationList | Array of HasAuthOrganization | 否 | 授权企业列表(企业自动签时,该字段有值) 注意:此字段可能返回 null,表示取不到有效值。 |
AuthUserTotal | Integer | 否 | 授权员工列表总数 注意:此字段可能返回 null,表示取不到有效值。 |
AuthOrganizationTotal | Integer | 否 | 授权企业列表总数 注意:此字段可能返回 null,表示取不到有效值。 |
AuthRecord
企业认证信息
被如下接口引用:DescribeOrganizationAuthStatus。
名称 | 类型 | 描述 |
---|---|---|
OperatorName | String | 经办人姓名。 示例值:典*谦 |
OperatorMobile | String | 经办人手机号。 示例值:132****0000 |
AuthType | Integer | 认证授权方式:
示例值:1 |
AuditStatus | Integer | 企业认证授权书审核状态:
示例值:1 |
AuthorizedUser
授权用户
被如下接口引用:DescribeOrganizationSeals。
名称 | 类型 | 描述 |
---|---|---|
UserId | String | 电子签系统中的用户id |
AutoSignConfig
自动签开启、签署相关配置
被如下接口引用:CreateUserAutoSignEnableUrl。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
UserInfo | UserThreeFactor | 是 | 自动签开通个人用户信息, 包括名字,身份证等 |
CertInfoCallback | Boolean | 否 | 是否回调证书信息:
|
UserDefineSeal | Boolean | 否 | 是否支持用户自定义签名印章:
|
SealImgCallback | Boolean | 否 | 回调中是否需要自动签将要使用的印章(签名) 图片的 base64:
|
VerifyChannels | Array of String | 否 | 开通时候的身份验证方式, 取值为:
注:
|
LicenseType | Integer | 否 | 设置用户开通自动签时是否绑定个人自动签账号许可。
|
JumpUrl | String | 否 | 开通成功后前端页面跳转的url,此字段的用法场景请联系客户经理确认。 注: 仅支持H5开通场景 , 跳转链接仅支持 https:// , qianapp:// 开头 跳转场景:
成功结果返回: 若贵方需要在跳转回时通过链接query参数提示开通成功,JumpUrl中的query应携带如下参数: appendResult=qian 。这样腾讯电子签H5会在跳转回的url后面会添加query参数提示贵方签署成功,例如: qianapp://YOUR_CUSTOM_URL?action=sign&result=success&from=tencent_ess |
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 以表示处理正常。 示例值:https://tsign.tencent.com/callback |
CallbackKey | String | 否 | 回调加密key,用于回调消息加解密。 示例值:8DD3B29CE10D469D8978393074A767FD |
CallbackToken | String | 否 | 回调验签token,用于回调通知校验。 示例值:5AF866900CA34D1A95382C48C678A085 |
Caller
此结构体 (Caller) 用于描述调用方属性。
被如下接口引用:UploadFiles。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
OperatorId | String | 否 | 经办人的用户ID,同UserId 示例值:88fb0c591044be771f60aa382cc5ed0e |
CancelFailureFlow
撤销失败的流程信息
被如下接口引用:DescribeCancelFlowsTask。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
FlowId | String | 否 | 合同流程ID,为32位字符串。 |
Reason | String | 否 | 撤销失败原因 |
CcInfo
抄送信息
被如下接口引用:CreateFlow, CreateFlowByFiles, CreatePrepareFlow。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
Mobile | String | 否 | 被抄送方手机号码, 支持国内手机号11位数字(无需加+86前缀或其他字符)。 请确认手机号所有方为此业务通知方。 示例值:13200000000 |
Name | String | 否 | 被抄送方姓名。 抄送方的姓名将用于身份认证,请确保填写的姓名为抄送方的真实姓名,而非昵称等代名。 示例值:典子谦 |
CcType | Integer | 否 | 被抄送方类型, 可设置以下类型:
示例值:1 |
CcPermission | Integer | 否 | 被抄送方权限, 可设置如下权限:
示例值:1 |
NotifyType | String | 否 | 通知签署方经办人的方式, 有以下途径:
示例值:sms |
Component
此结构体 (Component) 用于描述控件属性。
在通过文件发起合同时,对应的component有三种定位方式
- 绝对定位方式 (可以通过 PDF坐标计算助手计算控件的坐标)
- 表单域(FIELD)定位方式
- 关键字(KEYWORD)定位方式,使用关键字定位时,请确保PDF原始文件内是关键字以文字形式保存在PDF文件中,不支持对图片内文字进行关键字查找
被如下接口引用:CreateBatchQuickSignUrl, CreateFlow, CreateFlowByFiles, CreateFlowGroupByFiles, CreateFlowGroupByTemplates, CreateFlowSignUrl, CreatePrepareFlow, DescribeFlowTemplates。
名称 | 类型 | 必选 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
ComponentType | String | 是 | 如果是Component填写控件类型,则可选的字段为:
如果是SignComponent签署控件类型, 需要根据签署人的类型可选的字段为 企业方
个人方
注: 表单域的控件不能作为印章和签名控件 示例值:SIGN_SEAL | ||||||||||||||||||||||||||||||||||||||||||||
ComponentHeight | Float | 是 | 在绝对定位方式和关键字定位方式下,指定控件的高度, 控件高度是指控件在PDF文件中的高度,单位为pt(点)。 | ||||||||||||||||||||||||||||||||||||||||||||
ComponentWidth | Float | 是 | 在绝对定位方式和关键字定位方式下,指定控件宽度,控件宽度是指控件在PDF文件中的宽度,单位为pt(点)。 | ||||||||||||||||||||||||||||||||||||||||||||
ComponentPage | Integer | 是 | 在绝对定位方式方式下,指定控件所在PDF文件上的页码 在使用文件发起的情况下,绝对定位方式的填写控件和签署控件支持使用负数来指定控件在PDF文件上的页码,使用负数时,页码从最后一页开始。例如:ComponentPage设置为-1,即代表在PDF文件的最后一页,以此类推。 注: 1. 页码编号是从1开始编号的。 2. 页面编号不能超过PDF文件的页码总数。如果指定的页码超过了PDF文件的页码总数,在填写和签署时会出现错误,导致无法正常进行操作。 | ||||||||||||||||||||||||||||||||||||||||||||
ComponentPosX | Float | 是 | 在绝对定位方式和关键字定位方式下,可以指定控件横向位置的位置,单位为pt(点)。 | ||||||||||||||||||||||||||||||||||||||||||||
ComponentPosY | Float | 是 | 在绝对定位方式和关键字定位方式下,可以指定控件纵向位置的位置,单位为pt(点)。 | ||||||||||||||||||||||||||||||||||||||||||||
FileIndex | Integer | 是 | 【暂未使用】控件所属文件的序号(取值为:0-N)。 目前单文件的情况下,值一直为0 示例值:0 | ||||||||||||||||||||||||||||||||||||||||||||
GenerateMode | String | 否 | 控件生成的方式:
| ||||||||||||||||||||||||||||||||||||||||||||
ComponentId | String | 否 | 控件唯一ID。 在绝对定位方式方式下,ComponentId为控件的ID,长度不能超过30,只能由中文、字母、数字和下划线组成,可以在后续的操作中使用该名称来引用控件。 在关键字定位方式下,ComponentId不仅为控件的ID,也是关键字整词。此方式下可以通过"^"来决定是否使用关键字整词匹配能力。 例: - 如传入的关键字"^甲方签署^",则会在PDF文件中有且仅有"甲方签署"关键字的地方(前后不能有其他字符)进行对应操作。 - 如传入的关键字为"甲方签署",则PDF文件中每个出现关键字的位置(前后可以有其他字符)都会执行相应操作。 注: 控件ID可以在一个PDF中不可重复 点击查看ComponentId在模板编辑页面的位置 | ||||||||||||||||||||||||||||||||||||||||||||
ComponentName | String | 否 | 在绝对定位方式方式下,ComponentName为控件名,长度不能超过20,只能由中文、字母、数字和下划线组成,可以在后续的操作中使用该名称来引用控件。 在表单域定位方式下,ComponentName不仅为控件名,也是表单域名称。 注: 控件名可以在一个PDF中可以重复 点击查看ComponentName在模板页面的位置 示例值:price | ||||||||||||||||||||||||||||||||||||||||||||
ComponentRequired | Boolean | 否 | 如果是填写控件,ComponentRequired表示在填写页面此控件是否必填
如果是签署控件,签批控件中签署意见等可以不填写, 其他签署控件不受此字段影响 | ||||||||||||||||||||||||||||||||||||||||||||
ComponentRecipientId | String | 否 | 在通过接口拉取控件信息场景下,为出参参数,此控件归属的参与方的角色ID角色(即RecipientId),发起合同时候不要填写此字段留空即可 | ||||||||||||||||||||||||||||||||||||||||||||
ComponentExtra | String | 否 | 在所有的定位方式下,控件的扩展参数,为JSON格式,不同类型的控件会有部分非通用参数。 ComponentType为TEXT、MULTI_LINE_TEXT时,支持以下参数:
参数样例: {"FontColor":"255,0,0","FontSize":12} ComponentType为DATE时,支持以下参数:
参数样例: {"FontColor":"255,0,0","FontSize":12} ComponentType为WATERMARK时,支持以下参数:
参数样例: "{\"Font\":\"黑体\",\"FontSize\":20,\"Opacity\":0.1,\"Density\":2,\"SubType\":\"PERSON_INFO_WATERMARK\"}" ComponentType为FILL_IMAGE时,支持以下参数:
ComponentType为SIGN_SIGNATURE类型时,可以通过ComponentTypeLimit参数控制签名方式
参考样例: {"ComponentTypeLimit": ["SYSTEM_ESIGN"]} 印章的对应关系参考下图 ComponentType为SIGN_SEAL 或者 SIGN_PAGING_SEAL类型时,可以通过ComponentTypeLimit参数控制签署方签署时要使用的印章类型,支持指定以下印章类型
参考样例: {\"ComponentTypeLimit\":[\"PERSONNEL\",\"FINANCE\"]} 表示改印章签署区,客户需使用人事专用章或财务专用章盖章签署。ComponentType为SIGN_DATE时,支持以下参数:
如果extra参数为空,默认为”yyyy年m月d日”格式的居中日期 特别地,如果extra中Format字段为空或无法被识别,则extra参数会被当作默认值处理(Font,FontSize,Gaps和FontAlign都不会起效) 参数样例: "{"Format":"yyyy m d","FontSize":12,"Gaps":"2,2", "FontAlign":"Right"}" ComponentType为SIGN_SEAL类型时,支持以下参数:
参数样例: "{"PageRanges":[{"BeginPage":1,"EndPage":-1}]}" 关键字模式下支持关键字找不到的情况下不进行报错的设置
场景说明:如果使用关键字进行定位,但是指定的PDF文件中又没有设置的关键字时,发起合同会进行关键字是否存在的校验,如果关键字不存在,会进行报错返回。如果不希望进行报错,可以设置"IgnoreKeywordError"来忽略错误。请注意,如果关键字签署控件对应的签署方在整个PDF文件中一个签署控件都没有,还是会触发报错逻辑。 参数样例: "{"IgnoreKeywordError":1}" | ||||||||||||||||||||||||||||||||||||||||||||
IsFormType | Boolean | 否 | 在通过接口拉取控件信息场景下,为出参参数,此控件是否通过表单域定位方式生成,默认false-不是,发起合同时候不要填写此字段留空即可 | ||||||||||||||||||||||||||||||||||||||||||||
ComponentValue | String | 否 | 控件填充vaule,ComponentType和传入值类型对应关系:
控件值约束说明:
注: 部分特殊控件需要在控制台配置模板形式创建 | ||||||||||||||||||||||||||||||||||||||||||||
OffsetX | Float | 否 | 如果控件是关键字定位方式,可以对关键字定位出来的区域进行横坐标方向的调整,单位为pt(点)。例如,如果关键字定位出来的区域偏左或偏右,可以通过调整横坐标方向的参数来使控件位置更加准确。 注意: 向左调整设置为负数, 向右调整设置成正数 注意:此字段可能返回 null,表示取不到有效值。 | ||||||||||||||||||||||||||||||||||||||||||||
OffsetY | Float | 否 | 如果控件是关键字定位方式,可以对关键字定位出来的区域进行纵坐标方向的调整,单位为pt(点)。例如,如果关键字定位出来的区域偏上或偏下,可以通过调整纵坐标方向的参数来使控件位置更加准确。 注意: 向上调整设置为负数, 向下调整设置成正数 注意:此字段可能返回 null,表示取不到有效值。 | ||||||||||||||||||||||||||||||||||||||||||||
KeywordOrder | String | 否 | 如果控件是关键字定位方式,指定关键字排序规则时,可以选择Positive或Reverse两种排序方式。
在指定KeywordIndexes时,如果使用Positive排序方式,0代表在PDF内查找内容时,查找到的第一个关键字;如果使用Reverse排序方式,0代表在PDF内查找内容时,查找到的最后一个关键字。 示例值:Positive\Reverse | ||||||||||||||||||||||||||||||||||||||||||||
KeywordPage | Integer | 否 | 如果控件是关键字定位方式,在KeywordPage中指定关键字页码时,将只会在该页码中查找关键字,非该页码的关键字将不会查询出来。如果不设置查找所有页面中的关键字。 | ||||||||||||||||||||||||||||||||||||||||||||
RelativeLocation | String | 否 | 如果控件是关键字定位方式,关键字生成的区域的对齐方式, 可以设置下面的值
示例:如果设置Middle的关键字盖章,则印章的中心会和关键字的中心重合,如果设置Below,则印章在关键字的正下方 | ||||||||||||||||||||||||||||||||||||||||||||
KeywordIndexes | Array of Integer | 否 | 如果控件是关键字定位方式,关键字索引是指在PDF文件中存在多个相同的关键字时,通过索引指定使用哪一个关键字作为最后的结果。可以通过指定多个索引来同时使用多个关键字。例如,[0,2]表示使用PDF文件内第1个和第3个关键字位置作为最后的结果。 注意:关键字索引是从0开始计数的 | ||||||||||||||||||||||||||||||||||||||||||||
LockComponentValue | Boolean | 否 | web嵌入发起合同场景下, 是否锁定填写和签署控件值不允许嵌入页面进行编辑
注意:此字段可能返回 null,表示取不到有效值。 | ||||||||||||||||||||||||||||||||||||||||||||
ForbidMoveAndDelete | Boolean | 否 | web嵌入发起合同场景下,是否禁止移动和删除填写和签署控件
注意:此字段可能返回 null,表示取不到有效值。 | ||||||||||||||||||||||||||||||||||||||||||||
ComponentDateFontSize | Integer | 否 | 【暂未使用】日期签署控件的字号,默认为 12 | ||||||||||||||||||||||||||||||||||||||||||||
ChannelComponentId | String | 否 | 【暂未使用】第三方应用集成平台模板控件 ID 标识 | ||||||||||||||||||||||||||||||||||||||||||||
ChannelComponentSource | Integer | 否 | 【暂未使用】第三方应用集成中子客企业控件来源。
|
ComponentLimit
签署控件的类型和范围限制条件,用于控制文件发起后签署人拖拽签署区时可使用的控件类型和具体的印章或签名方式。
被如下接口引用:CreateFlowByFiles, CreateFlowGroupByFiles, CreateFlowGroupByTemplates。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
ComponentType | String | 是 | 控件类型,支持以下类型
|
ComponentValue | Array of String | 否 | 签署控件类型的值(可选),用与限制签署时印章或者签名的选择范围 1.当ComponentType 是 SIGN_SEAL 或者 SIGN_PAGING_SEAL 时可传入企业印章Id(支持多个)或者以下印章类型
注: 限制印章控件或骑缝章控件情况下,仅本企业签署方可以指定具体印章(通过传递ComponentValue,支持多个),他方企业签署人只能限制类型.若同时指定了印章类型和印章Id,以印章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字符 示例值:"" |
ForbidAddApprover | Boolean | 否 | 禁止添加签署方,若为true则在发起流程的可嵌入页面隐藏“添加签署人按钮” |
ForbidEditFlowProperties | Boolean | 否 | 禁止设置设置签署流程属性 (顺序、合同签署认证方式等),若为true则在发起流程的可嵌入页面隐藏签署流程设置面板 |
HideComponentTypes | Array of String | 否 | 在发起流程的可嵌入页面要隐藏的控件列表,和 ShowComponentTypes 参数 只能二选一使用,具体的控件类型如下
|
ShowComponentTypes | Array of String | 否 | 在发起流程的可嵌入页面要显示的控件列表,和 HideComponentTypes 参数 只能二选一使用,具体的控件类型如下
|
ResultPageConfig | Array of CreateResultPageConfig | 否 | 发起流程的可嵌入页面结果页配置 |
CreateResultPageConfig
发起流程的可嵌入页面操作结果页配置
被如下接口引用:CreatePrepareFlow。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
Type | Integer | 是 |
|
Title | String | 是 | 结果页标题,不超过50字 |
Description | String | 否 | 结果页描述,不超过200字 |
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 | 否 | 部门名称。 示例值:测试部门 |
DetectInfoVideoData
视频认证结果
被如下接口引用:DescribeSignFaceVideo。
名称 | 类型 | 描述 |
---|---|---|
LiveNessVideo | String | 活体视频的base64编码,mp4格式 注: 需进行base64解码获取活体视频文件 注意:此字段可能返回 null,表示取不到有效值。 |
EmbedUrlOption
个性化参数
被如下接口引用:CreateEmbedWebUrl。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
ShowFlowDetailComponent | Boolean | 否 | 合同详情预览,允许展示控件信息
示例值:true |
ShowTemplateComponent | Boolean | 否 | 模板预览,允许展示模板控件信息
示例值:true |
ExtendAuthInfo
扩展服务开通和授权的详细信息
被如下接口引用:DescribeExtendedServiceAuthInfos。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
Type | String | 否 | 扩展服务的类型,可能是以下值:
示例值:BATCH_SIGN |
Name | String | 否 | 扩展服务的名称 示例值:批量签署 |
Status | String | 否 | 扩展服务的开通状态:
示例值: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 | 否 | 补充企业签署人员工手机号 示例值:18800000000 |
OrganizationName | String | 否 | 补充企业动态签署人时,需要指定对应企业名称 |
ApproverIdCardType | String | 否 | 签署方经办人的证件类型,支持以下类型
注: 1.其他证件类型为白名单功能,使用前请联系对接的客户经理沟通。 2.补充个人签署方时,若该用户已在电子签完成实名则可通过指定姓名和证件类型、证件号码完成补充。 示例值:ID_CARD |
ApproverIdCardNumber | String | 否 | 签署方经办人的证件号码,应符合以下规则
注: 补充个人签署方时,若该用户已在电子签完成实名则可通过指定姓名和证件类型、证件号码完成补充。 |
FlowId | String | 否 | 合同流程ID,补充合同组子合同动态签署人时必传。 示例值:yDwFmUUckpstqfvzUE1h3jo1f3cqjkGm |
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 | 签署短链接。 注意: 1. 该链接有效期为30分钟,同时需要注意保密,不要外泄给无关用户。 2. 该链接不支持小程序嵌入,仅支持移动端浏览器打开。 3. 生成的链路后面不能再增加参数(会出现覆盖链接中已有参数导致错误) 示例值:https://essurl.cn/M**XE |
ApproverType | Integer | 签署人类型。 - 1: 个人 示例值:1 |
ApproverName | String | 签署人姓名。 示例值:典子谦 |
ApproverMobile | String | 签署人手机号。 示例值:13200000000 |
LongUrl | String | 签署长链接。 注意: 1. 该链接有效期为30分钟,同时需要注意保密,不要外泄给无关用户。 2. 该链接不支持小程序嵌入,仅支持移动端浏览器打开。 3. 生成的链路后面不能再增加参数(会出现覆盖链接中已有参数导致错误) 示例值: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 |
FlowBatchApproverInfo
批量签署合同相关信息,指定批量签署合同和签署方的信息,用于补充动态签署人。
被如下接口引用:CreateBatchQuickSignUrl, CreateBatchSignUrl。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
FlowId | String | 否 | 合同流程ID。 示例值:yDwFmUUckpstqfvzUE1h3jo1f3cqjkGm |
RecipientId | String | 否 | 签署节点ID,用于生成动态签署人链接完成领取。注:生成动态签署人补充链接时必传。 |
FlowBatchUrlInfo
批量签署合同相关信息,指定批量签署合同和签署方的信息,用于补充动态签署人。
被如下接口引用:CreateBatchQuickSignUrl, CreateBatchSignUrl。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
FlowBatchApproverInfos | Array of FlowBatchApproverInfo | 否 | 批量签署合同和签署方的信息,用于补充动态签署人。 |
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端等不同的参与者类型,可选类型如下:
示例值: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秒至300秒之间的任意值。 若未指定阅读时间,则会按照合同页数大小计算阅读时间,计算规则如下:
|
UserId | String | 否 | 签署人userId,仅支持本企业的员工userid, 可在控制台组织管理处获得 注: 如果传进来的UserId已经实名, 则忽略ApproverName,ApproverIdCardType,ApproverIdCardNumber,ApproverMobile这四个入参(会用此UserId实名的身份证和登录的手机号覆盖) |
Required | Boolean | 否 | 字段已经废弃,当前只支持true,默认为true |
ApproverSource | String | 否 | 在企微场景下使用,需设置参数为WEWORKAPP,以表明合同来源于企微。 |
CustomApproverTag | String | 否 | 在企业微信场景下,表明该合同流程为或签,其最大长度为64位字符串。 所有参与或签的人员均需具备该标识。 注意,在合同中,不同的或签参与人必须保证其CustomApproverTag唯一。 如果或签签署人为本方企业微信参与人,则需要指定ApproverSource参数为WEWORKAPP。 |
RegisterInfo | RegisterInfo | 否 | 已经废弃, 快速注册相关信息 |
ApproverOption | ApproverOption | 否 | 签署人个性化能力值,如是否可以转发他人处理、是否可以拒签、是否为动态补充签署人等功能开关。 |
SignId | String | 否 | 签署人的签署ID
|
ApproverNeedSignReview | Boolean | 否 | 发起方企业的签署人进行签署操作前,是否需要企业内部走审批流程,取值如下:
企业可以通过CreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果
注: 此功能可用于与企业内部的审批流程进行关联,支持手动、静默签署合同 |
SignComponents | Array of Component | 否 | 签署人签署控件, 此参数仅针对文件发起(CreateFlowByFiles)生效 合同中的签署控件列表,列表中可支持下列多种签署控件,控件的详细定义参考开发者中心的Component结构体
此参数仅针对文件发起设置生效,模板发起合同签署流程, 请以模板配置为主 |
Components | Array of Component | 否 | 签署人填写控件 此参数仅针对文件发起(CreateFlowByFiles)生效 合同中的填写控件列表,列表中可支持下列多种填写控件,控件的详细定义参考开发者中心的Component结构体
此参数仅针对文件发起设置生效,模板发起合同签署流程, 请以模板配置为主 |
ComponentLimitType | Array of String | 否 | 当签署方控件类型为 SIGN_SIGNATURE 时,可以指定签署方签名方式。如果不指定,签署人可以使用所有的签名类型,可指定的签名类型包括:
各种签名的样式可以参考下图: |
ApproverVerifyTypes | Array of Integer | 否 | 指定个人签署方查看合同的校验方式,可以传值如下:
注:
此参数仅针对文件发起设置生效,模板发起合同签署流程, 请以模板配置为主 . 示例值:[1,2] |
ApproverSignTypes | Array of Integer | 否 | 您可以指定签署方签署合同的认证校验方式,可传递以下值:
注:
注: 此参数仅针对文件发起设置生效,模板发起合同签署流程, 请以模板配置为主 示例值:[1,2] |
SignTypeSelector | Integer | 否 | 生成H5签署链接时,您可以指定签署方签署合同的认证校验方式的选择模式,可传递一下值:
注: 不指定该值时,默认为签署方自行选择。 示例值:0 |
Deadline | Integer | 否 | 签署人的签署截止时间,格式为Unix标准时间戳(秒), 超过此时间未签署的合同变成已过期状态,不能在继续签署 注: 若不设置此参数,则默认使用合同的截止时间,此参数暂不支持合同组子合同 示例值:1604912664 |
Intention | Intention | 否 | 只有在生成H5签署链接的情形下( 如调用获取H5签署链接、获取H5批量签署链接等接口),该配置才会生效。 您可以指定H5签署视频核身的意图配置,选择问答模式或点头模式的语音文本。 注意: 1. 视频认证为白名单功能,使用前请联系对接的客户经理沟通。 2. 使用视频认证时,生成H5签署链接必须将签署认证方式指定为人脸(即ApproverSignTypes设置成人脸签署)。 3. 签署完成后,可以通过查询签署认证人脸视频获取到当时的视频。 |
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 |
FlowGroupApproverInfo
合同组相关信息,指定合同组子合同和签署方的信息,用于补充动态签署人。
被如下接口引用:CreateSchemeUrl。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
FlowId | String | 否 | 合同流程ID。 示例值:yDwFmUUckpstqfvzUE1h3jo1f3cqjkGm |
RecipientId | String | 否 | 签署节点ID,用于生成动态签署人链接完成领取。注:生成动态签署人补充链接时必传。 |
FlowGroupApprovers
合同组签署方信息
被如下接口引用:CreateFlowGroupByFiles, CreateFlowGroupByTemplates。
名称 | 类型 | 描述 |
---|---|---|
FlowId | String | 合同流程ID 注意:此字段可能返回 null,表示取不到有效值。 示例值:yDwFmUUckpstqfvzUE1h3jo1f3cqjkGm |
Approvers | Array of ApproverItem | 签署方信息,包含合同ID和角色ID用于定位RecipientId。 注意:此字段可能返回 null,表示取不到有效值。 |
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 |
FlowDisplayType | Integer | 否 | 在短信通知、填写、签署流程中,若标题、按钮、合同详情等地方存在“合同”字样时,可根据此配置指定文案,可选文案如下:
示例值:1 |
FlowGroupOptions
此结构体(FlowGroupOptions)描述的是合同组的个性化配置,支持控制是否发送短信、未实名个人签署方查看合同组时是否需要实名认证(仅在合同组文件发起配置时生效)
被如下接口引用:CreateFlowGroupByFiles, CreateFlowGroupByTemplates。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
ApproverVerifyType | String | 否 | 签署人校验方式,支持以下类型
参数说明:此参数仅在合同组文件发起有效,可选人脸识别或手机号验证两种方式,若选择后者,未实名个人签署方在签署合同时,无需经过实名认证和意愿确认两次人脸识别,该能力仅适用于个人签署方。 |
SelfOrganizationApproverNotifyType | String | 否 | 发起合同(流程)组本方企业经办人通知方式 签署通知类型,支持以下类型
|
OtherApproverNotifyType | String | 否 | 发起合同(流程)组他方经办人通知方式 签署通知类型,支持以下类型
|
FlowGroupUrlInfo
合同组相关信息,指定合同组子合同和签署方的信息,用于补充动态签署人。
被如下接口引用:CreateSchemeUrl。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
FlowGroupApproverInfos | Array of FlowGroupApproverInfo | 否 | 合同组子合同和签署方的信息,用于补充动态签署人。 |
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; 支持的文件类型包括doc、docx、xls、xlsx、html、jpg、jpeg、png、bmp、txt、pdf
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" 或者 "0xFFFFFF"; bold : 是否加粗, true : 加粗 false: 不加粗; align: 对其方式, 支持 LEFT / RIGHT / CENTER
被如下接口引用:CreateDocument。
名称 | 类型 | 必选 | 描述 | ||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
ComponentValue | String | 是 | 控件填充vaule,ComponentType和传入值类型对应关系:
控件值约束说明:
示例值:ComponentValue | ||||||||||||||||||||||||||||||||||||||||||
ComponentId | String | 否 | 控件id,和ComponentName选择一项传入即可 点击查看在模板中找到控件ID的方式 示例值: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,表示取不到有效值。 |
HasAuthOrganization
授权企业列表(目前仅用于“企业自动签 -> 合作企业授权”)
被如下接口引用:DescribeExtendedServiceAuthDetail。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
OrganizationId | String | 否 | 授权企业id 注意:此字段可能返回 null,表示取不到有效值。 |
OrganizationName | String | 否 | 授权企业名称 注意:此字段可能返回 null,表示取不到有效值。 |
AuthorizedOrganizationId | String | 否 | 被授权企业id 注意:此字段可能返回 null,表示取不到有效值。 |
AuthorizedOrganizationName | String | 否 | 被授权企业名称 注意:此字段可能返回 null,表示取不到有效值。 |
TemplateId | String | 否 | 授权模板id(仅当授权方式为模板授权时有值) 注意:此字段可能返回 null,表示取不到有效值。 |
TemplateName | String | 否 | 授权模板名称(仅当授权方式为模板授权时有值) 注意:此字段可能返回 null,表示取不到有效值。 |
AuthorizeTime | Integer | 否 | 授权时间,格式为时间戳,单位s 注意:此字段可能返回 null,表示取不到有效值。 |
HasAuthUser
被授权的用户信息
被如下接口引用:DescribeExtendedServiceAuthDetail, 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 |
Intention
视频核身意图配置,可指定问答模式或者点头模式的语音文本。
注: 视频认证为白名单功能,使用前请联系对接的客户经理沟通。
被如下接口引用:CreateBatchQuickSignUrl, CreateFlow, CreateFlowSignUrl, CreatePrepareFlow。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
IntentionType | Integer | 否 | 视频认证类型,支持以下类型
注: 视频认证为白名单功能,使用前请联系对接的客户经理沟通。 示例值:1 |
IntentionQuestions | Array of IntentionQuestion | 否 | 意愿核身语音问答模式(即语音播报+语音回答)使用的文案,包括:系统语音播报的文本、需要核验的标准文本。当前仅支持1轮问答。 注: 选择问答模式时,此字段可不传,不传则使用默认语音文本:请问,您是否同意签署本协议?可语音回复“同意”或“不同意”。 |
IntentionActions | Array of IntentionAction | 否 | 意愿核身(点头确认模式)使用的文案,若未使用意愿核身(点头确认模式),则该字段无需传入。当前仅支持一个提示文本。 注: 选择点头模式时,此字段可不传,不传则使用默认语音文本:请问,您是否同意签署本协议?可点头同意。 |
IntentionAction
意愿核身(点头确认模式)使用的文案,若未使用意愿核身(点头确认模式),则该字段无需传入。当前仅支持一个提示文本。
被如下接口引用:CreateBatchQuickSignUrl, CreateFlow, CreateFlowSignUrl, CreatePrepareFlow。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
Text | String | 否 | 点头确认模式下,系统语音播报使用的问题文本,问题最大长度为150个字符。 示例值:请问您本次业务是本人自愿办理吗?如是,请点头确认。 |
IntentionActionResult
意愿核身点头确认模式结果
被如下接口引用:DescribeSignFaceVideo。
名称 | 类型 | 描述 |
---|---|---|
Details | Array of IntentionActionResultDetail | 意愿核身结果详细数据,与每段点头确认过程一一对应 注意:此字段可能返回 null,表示取不到有效值。 |
IntentionActionResultDetail
意愿核身点头确认模式结果详细数据
被如下接口引用:DescribeSignFaceVideo。
名称 | 类型 | 描述 |
---|---|---|
Video | String | 视频base64编码(其中包含全程提示文本和点头音频,mp4格式) 注意:此字段可能返回 null,表示取不到有效值。 |
IntentionQuestion
意愿核身语音问答模式(即语音播报+语音回答)使用的文案,包括:系统语音播报的文本、需要核验的标准文本。当前仅支持1轮问答。
被如下接口引用:CreateBatchQuickSignUrl, CreateFlow, CreateFlowSignUrl, CreatePrepareFlow。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
Question | String | 否 | 当选择语音问答模式时,系统自动播报的问题文本,最大长度为150个字符。 示例值:请问您本次业务是本人自愿办理吗?如是,请回复“我同意”。 |
Answers | Array of String | 否 | 当选择语音问答模式时,用于判断用户回答是否通过的标准答案列表,传入后可自动判断用户回答文本是否在标准文本列表中。 示例值:“同意”,“我同意”,“确认”,“我确认” |
IntentionQuestionResult
意愿核身问答模式结果。若未使用该意愿核身功能,该字段返回值可以不处理。
被如下接口引用:DescribeSignFaceVideo。
名称 | 类型 | 描述 |
---|---|---|
Video | String | 视频base64(其中包含全程问题和回答音频,mp4格式) 注: 需进行base64解码获取视频文件 注意:此字段可能返回 null,表示取不到有效值。 |
ResultCode | Array of String | 和答案匹配结果列表 注意:此字段可能返回 null,表示取不到有效值。 |
AsrResult | Array of String | 回答问题语音识别结果列表 注意:此字段可能返回 null,表示取不到有效值。 |
NeedReviewApproverInfo
需要进行签署审核的签署人信息
被如下接口引用:CreateFlowGroupSignReview。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
ApproverType | String | 是 | 签署方经办人的类型,支持以下类型
|
ApproverName | String | 是 | 签署方经办人的姓名。 经办人的姓名将用于身份认证和电子签名,请确保填写的姓名为签署方的真实姓名,而非昵称等代名。 |
ApproverMobile | String | 否 | 签署方经办人手机号码, 支持国内手机号11位数字(无需加+86前缀或其他字符)。 请确认手机号所有方为此合同签署方。 |
ApproverIdCardType | String | 否 | 签署方经办人的证件类型,支持以下类型
注: 其他证件类型为白名单功能,使用前请联系对接的客户经理沟通。 示例值:ID_CARD |
ApproverIdCardNumber | String | 否 | 签署方经办人的证件号码,应符合以下规则
|
OrganizationName | String | 否 | 组织机构名称。 请确认该名称与企业营业执照中注册的名称一致。 如果名称中包含英文括号(),请使用中文括号()代替。 如果签署方是企业签署方(approverType = 0 或者 approverType = 3), 则企业名称必填。 |
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,表示取不到有效值。 |
OrgBillSummary
企业套餐余额情况
被如下接口引用:DescribeBillUsage。
名称 | 类型 | 描述 |
---|---|---|
Total | Integer | 套餐总数 示例值:100 |
Used | Integer | 套餐使用数 示例值:10 |
Available | Integer | 套餐剩余数 示例值:10 |
QuotaType | String | 套餐类型 对应关系如下:
示例值:CloudEnterprise |
OrganizationAuthUrl
企业批量注册链接信息
被如下接口引用:DescribeBatchOrganizationRegistrationUrls。
名称 | 类型 | 描述 | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
AuthUrl | String | 企业批量注册链接,根据Endpoint的不同设置,返回不同的链接地址。失效时间:7天 跳转链接, 链接的有效期根据企业,员工状态和终端等有区别, 可以参考下表
注: 1.创建的链接应避免被转义,如:&被转义为\u0026;如使用Postman请求后,请选择响应类型为 JSON,否则链接将被转义 | ||||||||||||
ErrorMessage | String | 企业批量注册的错误信息,例如:企业三要素不通过 | ||||||||||||
SubTaskId | String | 企业批量注册的唯一 Id, 此 Id 可以用在创建企业批量认证链接-单链接。 示例值:yDCHoUU08m4mnpUxHGGHPv9FScKQsvHb |
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 | 否 | 签署人进行合同签署时的认证方式,支持的类型如下:
|
NoTransfer | Boolean | 否 | 签署方是否可以转他人处理
|
RecipientComponentInfo
参与方填写控件信息
被如下接口引用:DescribeFlowComponents。
名称 | 类型 | 描述 |
---|---|---|
RecipientId | String | 签署方经办人在合同流程中的参与方ID,与控件绑定,是控件的归属方 注意:此字段可能返回 null,表示取不到有效值。 |
RecipientFillStatus | String | 参与方填写状态
注意:此字段可能返回 null,表示取不到有效值。 |
IsPromoter | Boolean | 是否为发起方
注意:此字段可能返回 null,表示取不到有效值。 |
Components | Array of FilledComponent | 改参与方填写控件信息列表 注意:此字段可能返回 null,表示取不到有效值。 |
RegisterInfo
发起流程快速注册相关信息
被如下接口引用:CreateBatchQuickSignUrl, CreateFlow, CreateFlowSignUrl, CreatePrepareFlow。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
LegalName | String | 是 | 法人姓名 注意:此字段可能返回 null,表示取不到有效值。 |
UnifiedSocialCreditCode | String | 否 | 社会统一信用代码 注意:此字段可能返回 null,表示取不到有效值。 |
RegistrationOrganizationInfo
企业认证信息参数, 需要保证这些参数跟营业执照中的信息一致。
被如下接口引用:CreateBatchOrganizationRegistrationTasks。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
OrganizationName | String | 是 | 组织机构名称。 请确认该名称与企业营业执照中注册的名称一致。 如果名称中包含英文括号(),请使用中文括号()代替。 |
UniformSocialCreditCode | String | 是 | 组织机构企业统一社会信用代码。 请确认该企业统一社会信用代码与企业营业执照中注册的统一社会信用代码一致。 |
LegalName | String | 是 | 组织机构法人的姓名。 请确认该企业统一社会信用代码与企业营业执照中注册的法人姓名一致。 |
Address | String | 是 | 组织机构企业注册地址。 请确认该企业注册地址与企业营业执照中注册的地址一致。 示例值:深圳市南山区高新区科技中一路腾讯大厦35层 |
AdminName | String | 否 | 组织机构超管姓名。 在注册流程中,必须是超管本人进行操作。 如果法人做为超管管理组织机构,超管姓名就是法人姓名 如果入参中传递超管授权书PowerOfAttorneys,则此参数为必填参数。 |
AdminMobile | String | 否 | 组织机构超管手机号。 在注册流程中,这个手机号必须跟操作人在电子签注册的个人手机号一致。 如果入参中传递超管授权书PowerOfAttorneys,则此参数为必填参数 |
AuthorizationTypes | Array of Integer | 否 | 可选的此企业允许的授权方式, 可以设置的方式有: 1:上传授权书 2:法人授权超管 5:授权书+对公打款 注: 1. 当前仅支持一种认证方式 2. 如果当前的企业类型是政府/事业单位, 则只支持上传授权书+对公打款 3. 如果当前操作人是法人,则是法人认证 |
AdminIdCardNumber | String | 否 | 认证人身份证号,如果入参中传递超管授权书PowerOfAttorneys,则此参数为必填参数 |
AdminIdCardType | String | 否 | 认证人证件类型 支持以下类型
|
BusinessLicense | String | 否 | 营业执照正面照(PNG或JPG) base64格式, 大小不超过5M |
PowerOfAttorneys | Array of String | 否 | 授权书(PNG或JPG或PDF) base64格式, 大小不超过8M 。 p.s. 如果上传授权书 ,需遵循以下条件 1. 超管的信息(超管姓名,超管身份证,超管手机号)必须为必填参数。 2. 超管的个人身份必须在电子签已经实名。 2. 认证方式AuthorizationTypes必须只能是上传授权书方式 示例值:超管授权书 |
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个字。 示例值:供应商 |
ApproverSignSealId | String | 否 | 印章Id,签署控件类型为印章时,用于指定本企业签署方在解除协议中使用那个印章进行签署 |
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,表示取不到有效值。 示例值:业务员 |
SubOrgBillSummary
子企业套餐使用情况
被如下接口引用:DescribeBillUsage。
名称 | 类型 | 描述 |
---|---|---|
OrganizationName | String | 子企业名称 示例值:公司A |
Usage | Array of SubOrgBillUsage | 示例值: |
SubOrgBillUsage
集团子企业使用集团主企业的套餐使用情况
被如下接口引用:DescribeBillUsage。
名称 | 类型 | 描述 |
---|---|---|
Used | Integer | 套餐使用数 示例值:10 |
QuotaType | String | 套餐类型 对应关系如下:
示例值:CloudEnterprise |
SuccessCreateStaffData
创建/修改员工成功返回的信息 现在支持saas/企微/H5端进行加入。
被如下接口引用:CreateIntegrationEmployees。
名称 | 类型 | 描述 | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
DisplayName | String | 员工名 | |||||||||||||||
Mobile | String | 员工手机号 | |||||||||||||||
UserId | String | 员工在电子签平台的id | |||||||||||||||
Note | String | 提示,当创建已存在未实名用户时,该字段有值 注意:此字段可能返回 null,表示取不到有效值。 | |||||||||||||||
WeworkOpenId | String | 传入的企微账号id | |||||||||||||||
Url | String | 员工邀请返回链接 根据入参的 InvitationNotifyType 和 Endpoint 返回链接
|
SuccessDeleteStaffData
删除员工的成功数据
被如下接口引用:DeleteIntegrationEmployees。
名称 | 类型 | 描述 |
---|---|---|
DisplayName | String | 员工名 |
Mobile | String | 员工手机号 |
UserId | String | 员工在电子签平台的id |
SuccessUpdateStaffData
更新员工信息成功返回的数据信息, 仅支持未实名的用户进行更新 会通过短信、企微消息或者H5Url 链接 如果是通过H5邀请加入的方式,会返回H5 链接
被如下接口引用:UpdateIntegrationEmployees。
名称 | 类型 | 描述 |
---|---|---|
DisplayName | String | 传入的用户名称 |
Mobile | String | 传入的手机号,没有打码 |
UserId | String | 员工在腾讯电子签平台的唯一身份标识,为32位字符串。 可登录腾讯电子签控制台,在 "更多能力"->"组织管理" 中查看某位员工的UserId(在页面中展示为用户ID)。 |
Url | String | H5端员工实名链接 只有入参 InvitationNotifyType = H5的时候才会进行返回。 |
TemplateInfo
此结构体 (TemplateInfo) 用于描述模板的信息。
模板组成
一个模板通常会包含以下结构信息
- 模板基本信息
- 发起方参与信息Promoter、签署参与方 Recipients,后者会在模板发起合同时用于指定参与方
- 填写控件 Components
- 签署控件 SignComponents
- 生成模板的文件基础信息 FileInfos
被如下接口引用:DescribeFlowTemplates。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
TemplateId | String | 否 | 模板ID,模板的唯一标识 示例值:yDSLKUUckpoqt3vzUP7DfuSBwaJfz7M1 |
TemplateName | String | 否 | 模板的名字 示例值:西红柿采购模板 |
Recipients | Array of Recipient | 否 | 此模块需要签署的各个参与方的角色列表。RecipientId标识每个参与方角色对应的唯一标识符,用于确定此角色的信息。 点击查看在模板中配置的签署参与方角色列表的样子 |
Components | Array of Component | 否 | 模板的填充控件列表 点击查看在模板中配置的填充控件的样子 |
SignComponents | Array of Component | 否 | 此模板中的签署控件列表 点击查看在模板中配置的签署控件的样子 |
Description | String | 否 | 模板描述信息 示例值:2023年西红柿采购模板 |
DocumentResourceIds | Array of String | 否 | 此模板的资源ID |
FileInfos | Array of FileInfo | 否 | 生成模板的文件基础信息 |
AttachmentResourceIds | Array of String | 否 | 此模板里边附件的资源ID |
SignOrder | Array of Integer | 否 | 签署人参与签署的顺序,可以分为以下两种方式: 无序:不限定签署人的签署顺序,签署人可以在任何时间签署。此种方式值为 :{-1} 有序:通过序列数字标识签署顺序,从0开始编码,数字越大签署顺序越靠后,签署人按照指定的顺序依次签署。此种方式值为: {0,1,2,3………} 示例值:1 |
Status | Integer | 否 | 此模板的状态可以分为以下几种: -1:不可用状态。 0:草稿态,即模板正在编辑或未发布状态。 1:正式态,只有正式态的模板才可以发起合同。 |
Creator | String | 否 | 模板的创建者信息,用户的名字 注: 是创建者的名字,而非创建者的用户ID 示例值:张三 |
CreatedOn | Integer | 否 | 模板创建的时间戳,格式为Unix标准时间戳(秒) |
Promoter | Recipient | 否 | 此模板创建方角色信息。 点击查看在模板中配置的创建方角色的样子 |
TemplateType | Integer | 否 | 模板类型可以分为以下两种: 1:带有本企业自动签署的模板,即签署过程无需签署人手动操作,系统自动完成签署。 3:普通模板,即签署人需要手动进行签署操作。 |
Available | Integer | 否 | 模板可用状态可以分为以下两种: 1:(默认)启用状态,即模板可以正常使用。 2:停用状态,即模板暂时无法使用。 可到控制台启停模板 |
OrganizationId | String | 否 | 创建模板的企业ID,电子签的机构ID |
CreatorId | String | 否 | 模板创建人用户ID |
PreviewUrl | String | 否 | 模板的H5预览链接,有效期5分钟。 可以通过浏览器打开此链接预览模板,或者嵌入到iframe中预览模板。 注意:此字段可能返回 null,表示取不到有效值。 示例值:https://embed.beta.qian.tencent.cn/document-url-preview?channel=PROXYCHANNEL&scene=SINGLEPAGE&code=yDSxNUUckptbbq64UEly7FaCkhsBlSLj&codeType=QUICK&businessType=TEMPLATE&businessId=yDSLVUUckpo3pub6UE5dPdv8pkDsrbEn&channel=PROXYCHANNEL |
UserFlowType | UserFlowType | 否 | 用户自定义合同类型。 返回配置模板的时候选择的合同类型。点击查看配置的位置 自定义合同类型配置的地方如链接图所示。点击查看自定义合同类型管理的位置 注意:此字段可能返回 null,表示取不到有效值。 |
TemplateVersion | String | 否 | 模板版本的编号,旨在标识其独特的版本信息,通常呈现为一串字符串,由日期和递增的数字组成 注意:此字段可能返回 null,表示取不到有效值。 示例值:20240205005 |
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 |
UserFlowType
用户自定义合同类型, 自定义合同类型的管理可以点击查看在控制台位置的截图
被如下接口引用:DescribeFlowTemplates。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
UserFlowTypeId | String | 否 | 合同类型ID 注意:此字段可能返回 null,表示取不到有效值。 示例值:yDCNsUUg9tk6n6UtJrNd1S1ueFygJh9D |
Name | String | 否 | 合同类型名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:分销合同 |
Description | String | 否 | 合同类型说明 注意:此字段可能返回 null,表示取不到有效值。 示例值:由主承销人、国际协调人和全体承销商签署的旨在明确承销团成员间权利义务关系的协议 |
UserInfo
用户信息
被如下接口引用:BindEmployeeUserIdWithClientOpenId, CancelFlow, CancelMultiFlowSignQRCode, CancelUserAutoSignEnableUrl, CreateBatchCancelFlowUrl, CreateBatchInitOrganizationUrl, CreateBatchOrganizationAuthorizationUrl, CreateBatchOrganizationRegistrationTasks, CreateBatchQuickSignUrl, CreateBatchSignUrl, CreateConvertTaskApi, CreateDocument, CreateEmbedWebUrl, CreateEmployeeQualificationSealQrCode, CreateExtendedServiceAuthInfos, CreateFlow, CreateFlowApprovers, CreateFlowBlockchainEvidenceUrl, CreateFlowByFiles, CreateFlowEvidenceReport, CreateFlowGroupByFiles, CreateFlowGroupByTemplates, CreateFlowGroupSignReview, CreateFlowReminds, CreateFlowSignReview, CreateFlowSignUrl, CreateIntegrationDepartment, CreateIntegrationEmployees, CreateIntegrationRole, CreateIntegrationSubOrganizationActiveRecord, CreateIntegrationUserRoles, CreateLegalSealQrCode, CreateMultiFlowSignQRCode, CreateOrganizationAuthUrl, CreateOrganizationBatchSignUrl, CreateOrganizationGroupInvitationLink, CreateOrganizationInfoChangeUrl, CreatePartnerAutoSignAuthUrl, CreatePersonAuthCertificateImage, CreatePrepareFlow, CreatePreparedPersonalEsign, CreateReleaseFlow, CreateSchemeUrl, CreateSeal, CreateSealPolicy, CreateUserAutoSignEnableUrl, CreateUserAutoSignSealUrl, CreateUserMobileChangeUrl, CreateUserVerifyUrl, CreateWebThemeConfig, DeleteExtendedServiceAuthInfos, DeleteIntegrationDepartment, DeleteIntegrationEmployees, DeleteIntegrationRoleUsers, DeleteSealPolicies, DescribeBatchOrganizationRegistrationUrls, DescribeCancelFlowsTask, DescribeExtendedServiceAuthDetail, DescribeExtendedServiceAuthInfos, DescribeFileUrls, DescribeFlowBriefs, DescribeFlowComponents, DescribeFlowEvidenceReport, DescribeFlowInfo, DescribeFlowTemplates, DescribeIntegrationDepartments, DescribeIntegrationEmployees, DescribeIntegrationRoles, DescribeOrganizationAuthStatus, DescribeOrganizationGroupOrganizations, DescribeOrganizationSeals, DescribePersonCertificate, DescribeSignFaceVideo, DescribeThirdPartyAuthCode, DescribeUserAutoSignStatus, DescribeUserVerifyStatus, DisableUserAutoSign, GetTaskResultApi, ModifyApplicationCallbackInfo, ModifyExtendedService, ModifyFlowDeadline, ModifyIntegrationDepartment, ModifyIntegrationRole, RenewAutoSignLicense, StartFlow, UnbindEmployeeUserIdWithClientOpenId, UpdateIntegrationEmployees, VerifyPdf。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
UserId | String | 否 | 用户在平台的编号 |
UserThreeFactor
用户的三要素:姓名,证件号,证件类型
被如下接口引用:CancelUserAutoSignEnableUrl, CreateUserAutoSignEnableUrl, CreateUserAutoSignSealUrl, DescribePersonCertificate, DescribeUserAutoSignStatus, DisableUserAutoSign, RenewAutoSignLicense。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
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 |