数据结构
Agent
应用相关信息, 整体应用的层级图如下
注:
不同的业务系统可以采用不同的应用,不同应用下的数据是隔离的, 应用A中的某个企业已经实名, 在应用B中此企业还需要重新认证
被如下接口引用:ChannelBatchCancelFlows, ChannelCancelFlow, ChannelCancelMultiFlowSignQRCode, ChannelCancelUserAutoSignEnableUrl, ChannelCreateBatchCancelFlowUrl, ChannelCreateBatchQuickSignUrl, ChannelCreateBatchSignUrl, ChannelCreateBoundFlows, ChannelCreateConvertTaskApi, ChannelCreateEmbedWebUrl, ChannelCreateFlowApprovers, ChannelCreateFlowByFiles, ChannelCreateFlowGroupByFiles, ChannelCreateFlowGroupByTemplates, ChannelCreateFlowReminds, ChannelCreateFlowSignReview, ChannelCreateFlowSignUrl, ChannelCreateMultiFlowSignQRCode, ChannelCreateOrganizationBatchSignUrl, ChannelCreateOrganizationModifyQrCode, ChannelCreatePrepareFlow, ChannelCreatePreparedPersonalEsign, ChannelCreateReleaseFlow, ChannelCreateRole, ChannelCreateSealPolicy, ChannelCreateUserAutoSignEnableUrl, ChannelCreateUserAutoSignSealUrl, ChannelCreateUserRoles, ChannelCreateWebThemeConfig, ChannelDeleteRole, ChannelDeleteRoleUsers, ChannelDeleteSealPolicies, ChannelDescribeAccountBillDetail, ChannelDescribeBillUsageDetail, ChannelDescribeEmployees, ChannelDescribeFlowComponents, ChannelDescribeOrganizationSeals, ChannelDescribeRoles, ChannelDescribeSignFaceVideo, ChannelDescribeUserAutoSignStatus, ChannelDisableUserAutoSign, ChannelGetTaskResultApi, ChannelModifyRole, ChannelRenewAutoSignLicense, ChannelUpdateSealStatus, ChannelVerifyPdf, CreateBatchInitOrganizationUrl, CreateBatchOrganizationRegistrationTasks, CreateChannelFlowEvidenceReport, CreateChannelOrganizationInfoChangeUrl, CreateChannelSubOrganizationActive, CreateCloseOrganizationUrl, CreateConsoleLoginUrl, CreateEmployeeQualificationSealQrCode, CreateFlowBlockchainEvidenceUrl, CreateFlowGroupSignReview, CreateFlowsByTemplates, CreateLegalSealQrCode, CreatePartnerAutoSignAuthUrl, CreatePersonAuthCertificateImage, CreateSealByImage, CreateSignUrls, DeleteOrganizationAuthorizations, DescribeBatchOrganizationRegistrationUrls, DescribeCancelFlowsTask, DescribeChannelFlowEvidenceReport, DescribeChannelOrganizations, DescribeChannelSealPolicyWorkflowUrl, DescribeExtendedServiceAuthDetail, DescribeExtendedServiceAuthInfo, DescribeFlowDetailInfo, DescribeResourceUrlsByFlows, DescribeTemplates, DescribeUsage, GetDownloadFlowUrl, ModifyExtendedService, ModifyFlowDeadline, OperateChannelTemplate, PrepareFlows, SyncProxyOrganization, SyncProxyOrganizationOperators, UploadFiles。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
AppId | String | 是 | 应用的唯一标识(由电子签平台自动生成)。不同的业务系统可以采用不同的AppId,不同AppId下的数据是隔离的。可以由控制台开发者中心-应用集成自主生成。位置如下: |
ProxyOrganizationOpenId | String | 否 | 第三方应用平台自定义,对应第三方平台子客企业的唯一标识。一个第三方平台子客企业主体与子客企业ProxyOrganizationOpenId是一一对应的,不可更改,不可重复使用。(例如,可以使用企业名称的hash值,或者社会统一信用代码的hash值,或者随机hash值,需要第三方应用平台保存),最大64位字符串 |
ProxyOperator | UserInfo | 否 | 第三方平台子客企业中的员工/经办人,通过第三方应用平台进入电子签完成实名、且被赋予相关权限后,可以参与到企业资源的管理或签署流程中。 |
ProxyAppId | String | 否 | 不用填写,在第三方平台子客企业开通电子签后,会生成唯一的子客应用Id(ProxyAppId)用于代理调用时的鉴权,在子客开通的回调中获取。 |
ApproverComponentLimitType
指定签署方经办人控件类型是个人印章签署控件(SIGN_SIGNATURE) 时,可选的签名方式。
被如下接口引用:ChannelCreateMultiFlowSignQRCode。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
RecipientId | String | 是 | 签署方经办人在模板中配置的参与方ID,与控件绑定,是控件的归属方,ID为32位字符串。 |
Values | Array of String | 否 | 签署方经办人控件类型是个人印章签署控件(SIGN_SIGNATURE) 时,可选的签名方式。 签名方式:
|
ApproverItem
签署方信息,发起合同后可获取到对应的签署方信息,如角色ID,角色名称
被如下接口引用:ChannelCreateFlowByFiles, ChannelCreateFlowGroupByFiles, ChannelCreateFlowGroupByTemplates, CreateFlowsByTemplates。
名称 | 类型 | 描述 |
---|---|---|
SignId | String | 签署方唯一编号 在动态补充签署人场景下,可以用此编号确定参与方 注意:此字段可能返回 null,表示取不到有效值。 |
RecipientId | String | 签署方角色编号 在动态补充签署人场景下,可以用此编号确定参与方 注意:此字段可能返回 null,表示取不到有效值。 |
ApproverRoleName | String | 签署方角色名称 注意:此字段可能返回 null,表示取不到有效值。 |
ApproverOption
签署人个性化能力信息
被如下接口引用:ChannelCreateBatchQuickSignUrl, ChannelCreateFlowByFiles, ChannelCreateFlowSignUrl。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
NoRefuse | Boolean | 否 | 是否可以拒签 默认false-可以拒签 true-不可以拒签 示例值:true |
NoTransfer | Boolean | 否 | 是否可以转发 默认false-可以转发 true-不可以转发 示例值:true |
HideOneKeySign | Boolean | 否 | 是否隐藏一键签署 默认false-不隐藏true-隐藏 示例值:true |
FillType | Integer | 否 | 签署人信息补充类型,默认无需补充。
注: 使用动态签署人能力前,需登陆腾讯电子签控制台打开服务开关 |
FlowReadLimit | String | 否 | 签署人阅读合同限制参数 取值:
|
ApproverRestriction
指定签署人限制项
被如下接口引用:ChannelCreateMultiFlowSignQRCode。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
Name | String | 否 | 指定签署人姓名 示例值:张三 |
Mobile | String | 否 | 指定签署人手机号,11位数字 示例值:13000000000 |
IdCardType | String | 否 | 指定签署人证件类型,ID_CARD-身份证,HONGKONG_AND_MACAO-港澳居民来往内地通行证,HONGKONG_MACAO_AND_TAIWAN-港澳台居民居住证 示例值:ID_CARD |
IdCardNumber | String | 否 | 指定签署人证件号码,其中字母大写 示例值:4500000000000000000 |
AuthFailMessage
授权出错信息
被如下接口引用:OperateChannelTemplate。
名称 | 类型 | 描述 |
---|---|---|
ProxyOrganizationOpenId | String | 第三方平台子客企业的唯一标识,长度不能超过64,只能由字母和数字组成。开发者可自定义此字段的值,并需要保存此 ID 以便进行后续操作。 一个第三方平台子客企业主体与子客企业 ProxyOrganizationOpenId 是一一对应的,不可更改,不可重复使用。例如,可以使用企业名称的哈希值,或者社会统一信用代码的哈希值,或者随机哈希值。 示例值:organization_open_id_xxxx |
Message | String | 错误信息 |
AuthInfoDetail
企业扩展服务授权列表详情
被如下接口引用:DescribeExtendedServiceAuthDetail。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
Type | String | 否 | 扩展服务类型,和入参一致 注意:此字段可能返回 null,表示取不到有效值。 |
Name | String | 否 | 扩展服务名称 注意:此字段可能返回 null,表示取不到有效值。 |
HasAuthUserList | Array of HasAuthUser | 否 | 授权员工列表 注意:此字段可能返回 null,表示取不到有效值。 |
HasAuthOrganizationList | Array of HasAuthOrganization | 否 | 授权企业列表(企业自动签时,该字段有值) 注意:此字段可能返回 null,表示取不到有效值。 |
AuthUserTotal | Integer | 否 | 授权员工列表总数 注意:此字段可能返回 null,表示取不到有效值。 |
AuthOrganizationTotal | Integer | 否 | 授权企业列表总数 注意:此字段可能返回 null,表示取不到有效值。 |
AuthorizedUser
授权用户
被如下接口引用:ChannelDescribeOrganizationSeals。
名称 | 类型 | 描述 |
---|---|---|
OpenId | String | 第三方应用平台的用户openid |
AutoSignConfig
自动签开启、签署相关配置
被如下接口引用:ChannelCreateUserAutoSignEnableUrl。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
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 |
BaseFlowInfo
基础流程信息
被如下接口引用:ChannelCreatePrepareFlow。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
FlowName | String | 是 | 合同流程的名称(可自定义此名称),长度不能超过200,只能由中文、字母、数字和下划线组成。 示例值:张三的入职合同 |
Deadline | Integer | 是 | 合同流程的签署截止时间,格式为Unix标准时间戳(秒),如果在签署截止时间前未完成签署,则合同状态会变为已过期,导致合同作废。 示例值:1604912664 |
FlowType | String | 否 | 合同流程的类别分类(可自定义名称,如销售合同/入职合同等),最大长度为200个字符,仅限中文、字母、数字和下划线组成。 示例值:销售合同 |
FlowDescription | String | 否 | 合同流程描述信息(可自定义此描述),最大长度1000个字符。 示例值:张三2023年的入职公司财务部的合同 |
Unordered | Boolean | 否 | 合同流程的签署顺序类型: false:(默认)有序签署, 本合同多个参与人需要依次签署 true:无序签署, 本合同多个参与人没有先后签署限制 示例值:true |
IntelligentStatus | String | 否 | 是否打开智能添加填写区(默认开启,打开:"OPEN" 关闭:"CLOSE") |
FormFields | Array of FormField | 否 | 填写控件内容, 填写的控制的ID-填写的内容对列表 |
NeedSignReview | Boolean | 否 | 发起方企业的签署人进行签署操作前,是否需要企业内部走审批流程,取值如下:
企业可以通过CreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果
注: 此功能可用于与企业内部的审批流程进行关联,支持手动、静默签署合同 |
UserData | String | 否 | 调用方自定义的个性化字段(可自定义此名称),并以base64方式编码,支持的最大数据大小为1000长度。 在合同状态变更的回调信息等场景中,该字段的信息将原封不动地透传给贵方。回调的相关说明可参考开发者中心的回调通知模块。 示例值:QmFzZTY05YaF5a65 |
CcInfos | Array of CcInfo | 否 | 合同流程的抄送人列表,最多可支持50个抄送人,抄送人可查看合同内容及签署进度,但无需参与合同签署。 |
NeedCreateReview | Boolean | 否 | 发起方企业的签署人进行发起操作是否需要企业内部审批。使用此功能需要发起方企业有参与签署。 若设置为true,发起审核结果需通过接口 提交企业签署流程审批结果通知电子签,审核通过后,发起方企业签署人方可进行发起操作,否则会阻塞其发起操作。 |
Components | Array of Component | 否 | 填写控件:文件发起使用 |
FlowDisplayType | Integer | 否 | 在短信通知、填写、签署流程中,若标题、按钮、合同详情等地方存在“合同”字样时,可根据此配置指定文案,可选文案如下:
示例值:1 |
CancelFailureFlow
撤销失败的流程信息
被如下接口引用:DescribeCancelFlowsTask。
名称 | 类型 | 描述 |
---|---|---|
FlowId | String | 签署流程编号,为32位字符串 |
Reason | String | 撤销失败原因 |
CcInfo
抄送信息
被如下接口引用:ChannelCreateFlowByFiles, ChannelCreateFlowGroupByTemplates, ChannelCreatePrepareFlow, CreateFlowsByTemplates, PrepareFlows。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
Mobile | String | 否 | 被抄送人手机号,大陆11位手机号 示例值:xxx |
Name | String | 否 | 被抄送人姓名 |
CcType | Integer | 否 | 被抄送人类型 0--个人. 1--员工 |
CcPermission | Integer | 否 | 被抄送人权限 0--可查看 1--可查看也可下载 |
ChannelBillUsageDetail
用户计费使用情况详情
被如下接口引用:ChannelDescribeBillUsageDetail。
名称 | 类型 | 描述 |
---|---|---|
FlowId | String | 合同流程ID,为32位字符串。 示例值:yDwFdUUckps**uzcbXwoXbRF6ja3 |
OperatorName | String | 合同经办人名称 如果有多个经办人用分号隔开。 示例值:典子谦;张三 |
CreateOrganizationName | String | 发起方组织机构名称 示例值:典子谦示例企业 |
FlowName | String | 合同流程的名称。 示例值:典子谦示例合同 |
FlowStatus | String | 合同流程当前的签署状态, 会存在下列的状态值
示例值:ALL |
QuotaType | String | 查询的套餐类型 对应关系如下:
示例值:CloudEnterprise |
UseCount | Integer | 合同使用量 注: 如果消耗类型是撤销返还,此值为负值代表返还的合同数量 示例值:1 |
CostTime | Integer | 消耗的时间戳,格式为Unix标准时间戳(秒)。 示例值:1680162193 |
QuotaName | String | 消耗的套餐名称 示例值:企业版运营礼包 |
CostType | Integer | 消耗类型 1.扣费 2.撤销返还 示例值:1 |
Remark | String | 备注 |
ChannelOrganizationInfo
渠道企业信息
被如下接口引用:DescribeChannelOrganizations。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
OrganizationId | String | 否 | 电子签平台给企业分配的ID(在不同应用下同一个企业会分配通用的ID) 示例值:yDRSRUUgygj6qnwfUuO4zjEwc193c2hH |
OrganizationOpenId | String | 否 | 第三方平台子客企业的唯一标识 示例值:n9527 |
OrganizationName | String | 否 | 第三方平台子客企业名称 示例值:典子谦示例企业 |
UnifiedSocialCreditCode | String | 否 | 企业的统一社会信用代码 |
LegalName | String | 否 | 企业法定代表人的姓名 示例值:典子谦 |
LegalOpenId | String | 否 | 企业法定代表人作为第三方平台子客企业员工的唯一标识 示例值:n9527 |
AdminName | String | 否 | 企业超级管理员的姓名 示例值:典子谦 |
AdminOpenId | String | 否 | 企业超级管理员作为第三方平台子客企业员工的唯一标识 示例值:n9527 |
AdminMobile | String | 否 | 企业超级管理员的手机号码 注: 手机号码脱敏(隐藏部分用*替代) 示例值:186****0000 |
AuthorizationStatus | String | 否 | 企业认证状态字段。值如下:
示例值:VERIFIED |
AuthorizationType | String | 否 | 企业认证方式字段。值如下:
示例值:AuthorizationLegalIdentity |
ActiveStatus | Integer | 否 | 子企业激活状态。值如下:
示例值:0 |
LicenseExpireTime | Integer | 否 | 账号过期时间,时间戳 |
ChannelRole
角色信息
被如下接口引用:ChannelDescribeRoles。
名称 | 类型 | 描述 |
---|---|---|
RoleId | String | 角色ID,为32位字符串 注意:此字段可能返回 null,表示取不到有效值。 示例值:69997f600a7c8e9accc71f4241a8a091 |
RoleName | String | 角色的名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:管理员角色 |
RoleStatus | Integer | 此角色状态 1: 已经启用 2: 已经禁用 |
PermissionGroups | Array of PermissionGroup | 此角色对应的权限列表 注意:此字段可能返回 null,表示取不到有效值。 |
CommonApproverOption
签署人配置信息
被如下接口引用:ChannelCreatePrepareFlow。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
CanEditApprover | Boolean | 否 | 是否允许修改签署人信息 |
CommonFlowApprover
通用签署人信息
被如下接口引用:ChannelCreatePrepareFlow。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
NotChannelOrganization | Boolean | 是 | 指定签署人非第三方平台子客企业下员工还是SaaS平台企业,在ApproverType为ORGANIZATION时指定。
示例值:true |
ApproverType | Integer | 否 | 在指定签署方时,可选择企业B端或个人C端等不同的参与者类型,可选类型如下: 0 :企业/企业员工(企业签署方或模板发起时的企业静默签) 1 :个人/自然人 3 :企业/企业员工自动签(他方企业自动签署或文件发起时的本方企业自动签) 注:类型为3(企业/企业员工自动签)时,此接口会默认完成该签署方的签署。静默签署仅进行盖章操作,不能自动签名。 使用自动签时,请确保企业已经开通自动签功能,开通方式:控制台 -> 企业设置 -> 扩展服务 -> 企业自动签。 使用文件发起自动签时使用前请联系对接的客户经理沟通。 示例值:1 |
OrganizationId | String | 否 | 电子签平台给企业生成的企业id 示例值:yDRSRUUgygj6qnwfUuO4zjEwc193c2hH |
OrganizationOpenId | String | 否 | 企业OpenId,第三方应用集成非静默签子客企业签署人发起合同必传 示例值:org_diziqian |
OrganizationName | String | 否 | 企业名称,第三方应用集成非静默签子客企业签署人必传,saas企业签署人必传 示例值:典子谦示例企业 |
UserId | String | 否 | 电子签平台给企业员工或者自热人生成的用户id 示例值:yDwFmUUckpstqfvzUE1h3jo1f3cqjkGm |
OpenId | String | 否 | 第三方平台子客企业员工的唯一标识 示例值:n9527 |
ApproverName | String | 否 | 签署方经办人的姓名。 经办人的姓名将用于身份认证和电子签名,请确保填写的姓名为签署方的真实姓名,而非昵称等代名。 示例值:典子谦 |
ApproverMobile | String | 否 | 签署人手机号,saas企业签署人,个人签署人必传 示例值:13888888888 |
ApproverIdCardType | String | 否 | 签署方经办人的证件类型,支持以下类型
注: 其他证件类型为白名单功能,使用前请联系对接的客户经理沟通。 示例值:ID_CARD |
ApproverIdCardNumber | String | 否 | 签署方经办人的证件号码,应符合以下规则
示例值:110101192008317114 |
RecipientId | String | 否 | 签署人Id,使用模板发起是,对应模板配置中的签署人RecipientId 注意:模板发起时该字段必填 示例值:yDRS4UUgygqdcjjdUuO4zjEC0osCOsHS |
PreReadTime | Integer | 否 | 签署前置条件:阅读时长限制,不传默认10s,最大300s,最小3s 示例值:5 |
IsFullText | Boolean | 否 | 签署前置条件:阅读全文限制 示例值:true |
NotifyType | String | 否 | 通知签署方经办人的方式, 有以下途径:
注: 签署方为第三方子客企业时会被置为NONE, 不会发短信通知 示例值:NONE |
ApproverOption | CommonApproverOption | 否 | 签署人配置,用于控制签署人相关属性 |
SignComponents | Array of Component | 否 | 使用PDF文件直接发起合同时,签署人指定的签署控件; 使用模板发起合同时,指定本企业印章签署控件的印章ID: 通过ComponentId或ComponenetName指定签署控件,ComponentValue为印章ID。 |
ApproverVerifyTypes | Array of Integer | 否 | 指定个人签署方查看合同的校验方式,可以传值如下:
注:
示例值:[1,2] |
ApproverSignTypes | Array of Integer | 否 | 签署人签署合同时的认证方式
默认为1(人脸认证 ),2(签署密码),3(运营商三要素),5(设备指纹识别),6(设备面容识别) 注: 1. 用模板创建合同场景, 签署人的认证方式需要在配置模板的时候指定, 在创建合同重新指定无效 2. 运营商三要素认证方式对手机号运营商及前缀有限制,可以参考运营商支持列表类得到具体的支持说明 3. 校验方式不允许只包含设备指纹识别和设备面容识别,至少需要再增加一种其他校验方式。 4. 设备指纹识别和设备面容识别只支持小程序使用,其他端暂不支持。 示例值:[1,2,3] |
Component
此结构体 (Component) 用于描述控件属性。
在通过文件发起合同时,对应的component有三种定位方式
- 绝对定位方式 (可以通过 PDF坐标计算助手计算控件的坐标)
- 表单域(FIELD)定位方式
- 关键字(KEYWORD)定位方式,使用关键字定位时,请确保PDF原始文件内是关键字以文字形式保存在PDF文件中,不支持对图片内文字进行关键字查找
被如下接口引用:ChannelCreateBatchQuickSignUrl, ChannelCreateFlowByFiles, ChannelCreateFlowGroupByFiles, ChannelCreateFlowSignUrl, ChannelCreatePrepareFlow, DescribeTemplates。
名称 | 类型 | 必选 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
ComponentId | String | 否 | 控件唯一ID。 在绝对定位方式方式下,ComponentId为控件的ID,长度不能超过30,只能由中文、字母、数字和下划线组成,可以在后续的操作中使用该名称来引用控件。 在关键字定位方式下,ComponentId不仅为控件的ID,也是关键字整词。此方式下可以通过"^"来决定是否使用关键字整词匹配能力。 例: - 如传入的关键字"^甲方签署^",则会在PDF文件中有且仅有"甲方签署"关键字的地方(前后不能有其他字符)进行对应操作。 - 如传入的关键字为"甲方签署",则PDF文件中每个出现关键字的位置(前后可以有其他字符)都会执行相应操作。 注: 控件ID可以在一个PDF中不可重复 点击查看ComponentId在模板页面的位置 示例值:ComponentId | ||||||||||||||||||||||||||||||||||||||||||||
ComponentType | String | 否 | 如果是Component填写控件类型,则可选的字段为:
如果是SignComponent签署控件类型, 需要根据签署人的类型可选的字段为 企业方
个人方
注: 表单域的控件不能作为印章和签名控件 示例值:SIGN_SEAL | ||||||||||||||||||||||||||||||||||||||||||||
ComponentName | String | 否 | 在绝对定位方式方式下,ComponentName为控件名,长度不能超过20,只能由中文、字母、数字和下划线组成,可以在后续的操作中使用该名称来引用控件。 在表单域定位方式下,ComponentName不仅为控件名,也是表单域名称。 注: 控件名可以在一个PDF中可以重复 点击查看ComponentName在模板页面的位置 示例值:ComponentName | ||||||||||||||||||||||||||||||||||||||||||||
ComponentRequired | Boolean | 否 | 如果是填写控件,ComponentRequired表示在填写页面此控件是否必填
如果是签署控件,签批控件中签署意见等可以不填写, 其他签署控件不受此字段影响 示例值:false | ||||||||||||||||||||||||||||||||||||||||||||
ComponentRecipientId | String | 否 | 在通过接口拉取控件信息场景下,为出参参数,此控件归属的参与方的角色ID角色(即RecipientId),发起合同时候不要填写此字段留空即可 示例值:ComponentRecipientId | ||||||||||||||||||||||||||||||||||||||||||||
FileIndex | Integer | 否 | 【暂未使用】控件所属文件的序号(取值为:0-N)。 目前单文件的情况下,值一直为0 示例值:0 | ||||||||||||||||||||||||||||||||||||||||||||
GenerateMode | String | 否 | 控件生成的方式:
示例值:NORMAL | ||||||||||||||||||||||||||||||||||||||||||||
ComponentWidth | Float | 否 | 在绝对定位方式和关键字定位方式下,指定控件宽度,控件宽度是指控件在PDF文件中的宽度,单位为pt(点)。 示例值:10 | ||||||||||||||||||||||||||||||||||||||||||||
ComponentHeight | Float | 否 | 在绝对定位方式和关键字定位方式下,指定控件的高度, 控件高度是指控件在PDF文件中的高度,单位为pt(点)。 示例值:10 | ||||||||||||||||||||||||||||||||||||||||||||
ComponentPage | Integer | 否 | 在绝对定位方式方式下,指定控件所在PDF文件上的页码 在使用文件发起的情况下,绝对定位方式的填写控件和签署控件支持使用负数来指定控件在PDF文件上的页码,使用负数时,页码从最后一页开始。例如:ComponentPage设置为-1,即代表在PDF文件的最后一页,以此类推。 注: 1. 页码编号是从1开始编号的。 2. 页面编号不能超过PDF文件的页码总数。如果指定的页码超过了PDF文件的页码总数,在填写和签署时会出现错误,导致无法正常进行操作。 示例值:1 | ||||||||||||||||||||||||||||||||||||||||||||
ComponentPosX | Float | 否 | 在绝对定位方式和关键字定位方式下,可以指定控件横向位置的位置,单位为pt(点)。 示例值:10 | ||||||||||||||||||||||||||||||||||||||||||||
ComponentPosY | Float | 否 | 在绝对定位方式和关键字定位方式下,可以指定控件纵向位置的位置,单位为pt(点)。 示例值:10 | ||||||||||||||||||||||||||||||||||||||||||||
ComponentExtra | String | 否 | 在所有的定位方式下,控件的扩展参数,为JSON格式,不同类型的控件会有部分非通用参数。 ComponentType为TEXT、MULTI_LINE_TEXT时,支持以下参数:
参数样例: {"FontColor":"255,0,0","FontSize":12} ComponentType为DATE时,支持以下参数:
参数样例: {"FontColor":"255,0,0","FontSize":12} 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}]}" 签署印章旋转功能,当ComponentType为SIGN_SIGNATURE、SIGN_DATE、SIGN_SEAL时,可以通过以下参数设置签署图片的旋转角度:
参数样例: {"Rotate":-30,"RotateRelation":"Component_Id1"} 关键字模式下支持关键字找不到的情况下不进行报错的设置
场景说明:如果使用关键字进行定位,但是指定的PDF文件中又没有设置的关键字时,发起合同会进行关键字是否存在的校验,如果关键字不存在,会进行报错返回。如果不希望进行报错,可以设置"IgnoreKeywordError"来忽略错误。请注意,如果关键字签署控件对应的签署方在整个PDF文件中一个签署控件都没有,还是会触发报错逻辑。 参数样例: "{"IgnoreKeywordError":1}" 示例值:ComponentExtra | ||||||||||||||||||||||||||||||||||||||||||||
ComponentValue | String | 否 | 控件填充vaule,ComponentType和传入值类型对应关系:
控件值约束说明:
注: 部分特殊控件需要在控制台配置模板形式创建 示例值:ComponentValue | ||||||||||||||||||||||||||||||||||||||||||||
ComponentDateFontSize | Integer | 否 | 【暂未使用】日期签署控件的字号,默认为 12 示例值:12 | ||||||||||||||||||||||||||||||||||||||||||||
DocumentId | String | 否 | 【暂未使用】控件归属的文档的ID, 发起合同时候不要填写此字段留空即可 示例值:c17bdf9c2a7bdcb32611f4d0200fee3d | ||||||||||||||||||||||||||||||||||||||||||||
ComponentDescription | String | 否 | 【暂未使用】控件描述,用户自定义,不影响合同发起流程 示例值:Desc | ||||||||||||||||||||||||||||||||||||||||||||
OffsetX | Float | 否 | 如果控件是关键字定位方式,可以对关键字定位出来的区域进行横坐标方向的调整,单位为pt(点)。例如,如果关键字定位出来的区域偏左或偏右,可以通过调整横坐标方向的参数来使控件位置更加准确。 注意: 向左调整设置为负数, 向右调整设置成正数 | ||||||||||||||||||||||||||||||||||||||||||||
OffsetY | Float | 否 | 如果控件是关键字定位方式,可以对关键字定位出来的区域进行纵坐标方向的调整,单位为pt(点)。例如,如果关键字定位出来的区域偏上或偏下,可以通过调整纵坐标方向的参数来使控件位置更加准确。 注意: 向上调整设置为负数, 向下调整设置成正数 | ||||||||||||||||||||||||||||||||||||||||||||
ChannelComponentId | String | 否 | 【暂未使用】第三方应用集成平台模板控件 ID 标识 | ||||||||||||||||||||||||||||||||||||||||||||
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开始计数的 | ||||||||||||||||||||||||||||||||||||||||||||
Placeholder | String | 否 | 填写控件在腾讯电子签小程序填写界面展示的提示信息,例如,在身份证号码填写控件中,提示信息可以设置成“请输入18位身份证号码”。 注: 签署控件设置此字段无效 注意:此字段可能返回 null,表示取不到有效值。 | ||||||||||||||||||||||||||||||||||||||||||||
LockComponentValue | Boolean | 否 | web嵌入发起合同场景下, 是否锁定填写和签署控件值不允许嵌入页面进行编辑
注意:此字段可能返回 null,表示取不到有效值。 | ||||||||||||||||||||||||||||||||||||||||||||
ForbidMoveAndDelete | Boolean | 否 | web嵌入发起合同场景下,是否禁止移动和删除填写和签署控件
注意:此字段可能返回 null,表示取不到有效值。 |
ComponentLimit
签署控件的类型和范围限制条件,用于控制文件发起后签署人拖拽签署区时可使用的控件类型和具体的印章或签名方式。
被如下接口引用:ChannelCreateBatchQuickSignUrl, ChannelCreateFlowByFiles, ChannelCreateFlowSignUrl。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
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
创建合同个性化参数
被如下接口引用:ChannelCreatePrepareFlow。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
CanEditFlow | Boolean | 否 | 是否允许修改合同信息, true:可以 false:(默认)不可以 示例值:true |
HideShowFlowName | Boolean | 否 | 是否允许发起合同弹窗隐藏合同名称 true:允许 false:(默认)不允许 示例值:false |
HideShowFlowType | Boolean | 否 | 是否允许发起合同弹窗隐藏合同类型, true:允许 false:(默认)不允许 示例值:true |
HideShowDeadline | Boolean | 否 | 是否允许发起合同弹窗隐藏合同到期时间 true:允许 false:(默认)不允许 示例值:true |
CanSkipAddApprover | Boolean | 否 | 是否允许发起合同步骤跳过指定签署方步骤 true:允许 false:(默认)不允许 示例值:false |
CustomCreateFlowDescription | String | 否 | 定制化发起合同弹窗的描述信息,长度不能超过500,只能由中文、字母、数字和标点组成。 示例值:本合同已经经过法务评估 |
ForbidEditFillComponent | Boolean | 否 | 禁止编辑填写控件 true:禁止编辑填写控件 false:(默认)允许编辑填写控件 示例值:false |
SkipUploadFile | Boolean | 否 | 跳过上传文件步骤 true:跳过 false:(默认)不跳过,需要传ResourceId 示例值:false |
DeleteOrganizationAuthorizationInfo
清理的企业认证流信息
被如下接口引用:DeleteOrganizationAuthorizations。
名称 | 类型 | 描述 |
---|---|---|
AuthorizationId | String | 认证流 Id 是指在企业认证过程中,当前操作人的认证流程的唯一标识。每个企业在认证过程中只能有一条认证流认证成功。这意味着在同一认证过程内,一个企业只能有一个认证流程处于成功状态,以确保认证的唯一性和有效性。 示例值:yDCHHUUckpbdaiqbUxJVsHWy99WG6kTY |
OrganizationName | String | 认证的企业名称 示例值:典子谦示例企业 |
OrganizationOpenId | String | 第三方平台子客企业的唯一标识,定义Agent中的ProxyOrganizationOpenId一样, 可以参考Agent结构体 示例值:org_dianziqian |
Errormessage | String | 清除认证流产生的错误信息 |
Department
第三方应用集成员工部门信息
被如下接口引用:ChannelDescribeEmployees。
名称 | 类型 | 描述 |
---|---|---|
DepartmentId | String | 部门id 注意:此字段可能返回 null,表示取不到有效值。 |
DepartmentName | String | 部门名称 注意:此字段可能返回 null,表示取不到有效值。 |
DetectInfoVideoData
视频认证结果
被如下接口引用:ChannelDescribeSignFaceVideo。
名称 | 类型 | 描述 |
---|---|---|
LiveNessVideo | String | 活体视频的base64编码,mp4格式 注: 需进行base64解码获取活体视频文件 注意:此字段可能返回 null,表示取不到有效值。 |
DownloadFlowInfo
签署流程下载信息
被如下接口引用:GetDownloadFlowUrl。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
FileName | String | 是 | 文件夹名称 示例值:测试合同文件夹 |
FlowIdList | Array of String | 是 | 签署流程的标识数组 示例值:["FlowId1","FlowId2"] |
EmbedUrlOption
创建嵌入式页面url个性化参数
被如下接口引用:ChannelCreateEmbedWebUrl。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
ShowFlowDetailComponent | Boolean | 否 | 合同详情预览,允许展示控件信息
示例值:true |
ShowTemplateComponent | Boolean | 否 | 模板预览,允许展示模板控件信息
示例值:true |
SkipUploadFile | String | 否 | 跳过上传文件,默认为false(展示上传文件页) - false: 展示上传文件页 - true: 不展示上传文件页 注意: 此参数仅针对EmbedType=CREATE_TEMPLATE(创建模板)有效, 示例值:true |
ExtentServiceAuthInfo
扩展服务开通和授权的详细信息
被如下接口引用:DescribeExtendedServiceAuthInfo。
名称 | 类型 | 描述 |
---|---|---|
Type | String | 扩展服务类型
示例值:AUTO_SIGN |
Name | String | 扩展服务名称 示例值:企业静默签(自动签署) |
Status | String | 扩展服务的开通状态 ENABLE:开通 DISABLE:未开通 示例值:DISABLE |
OperatorOpenId | String | 操作扩展服务的操作人第三方应用平台的用户openid 注意:此字段可能返回 null,表示取不到有效值。 |
OperateOn | Integer | 扩展服务的操作时间,格式为Unix标准时间戳(秒)。 注意:此字段可能返回 null,表示取不到有效值。 |
FailedCreateRoleData
绑定失败的用户角色信息
被如下接口引用:ChannelCreateUserRoles。
名称 | 类型 | 描述 |
---|---|---|
UserId | String | 用户userId 注意:此字段可能返回 null,表示取不到有效值。 |
RoleIds | Array of String | 角色RoleId列表 注意:此字段可能返回 null,表示取不到有效值。 |
FillApproverInfo
指定补充签署人信息
- RecipientId 必须指定
- 补充个人签署方时,若该用户已在电子签完成实名则可通过指定姓名和证件类型、证件号码完成补充
被如下接口引用:ChannelCreateFlowApprovers。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
RecipientId | String | 是 | 签署方经办人在模板中配置的参与方ID,与控件绑定,是控件的归属方,ID为32位字符串。 |
OpenId | String | 否 | 指定企业经办签署人OpenId |
ApproverName | String | 否 | 签署人姓名 |
ApproverMobile | String | 否 | 签署人手机号码 |
OrganizationName | String | 否 | 企业名称 |
OrganizationOpenId | String | 否 | 企业OpenId |
NotChannelOrganization | Boolean | 否 | 签署企业非渠道子客,默认为false,即表示同一渠道下的企业;如果为true,则目前表示接收方企业为SaaS企业, 为渠道子客时,OrganizationOpenId 必传 |
ApproverIdCardType | String | 否 | 签署方经办人的证件类型,支持以下类型
注: 1.其他证件类型为白名单功能,使用前请联系对接的客户经理沟通。 2.补充个人签署方时,若该用户已在电子签完成实名则可通过指定姓名和证件类型、证件号码完成补充。 示例值:ID_CARD |
ApproverIdCardNumber | String | 否 | 签署方经办人的证件号码,应符合以下规则
注: 补充个人签署方时,若该用户已在电子签完成实名则可通过指定姓名和证件类型、证件号码完成补充。 |
FlowId | String | 否 | 合同流程ID - 补充合同组子合同动态签署人时必传。 - 补充正常合同,请阅读:补充签署人接口接口使用说明 示例值:yDwFmUUckpstqfvzUE1h3jo1f3cqjkGm |
FillError
批量补充签署人时,补充失败的报错说明
被如下接口引用:ChannelCreateFlowApprovers。
名称 | 类型 | 描述 |
---|---|---|
RecipientId | String | 为签署方经办人在签署合同中的参与方ID,与控件绑定,是控件的归属方,ID为32位字符串。与入参中补充的签署人角色ID对应,批量补充部分失败返回对应的错误信息。 注意:此字段可能返回 null,表示取不到有效值。 |
ErrMessage | String | 补充失败错误说明 注意:此字段可能返回 null,表示取不到有效值。 |
FlowId | String | 合同流程ID,为32位字符串。 注意:此字段可能返回 null,表示取不到有效值。 |
FilledComponent
文档内的填充控件返回结构体,返回控件的基本信息和填写内容值
被如下接口引用:ChannelDescribeFlowComponents。
名称 | 类型 | 描述 |
---|---|---|
ComponentId | String | 填写控件ID 示例值:Component_1 |
ComponentName | String | 控件名称 示例值:商品价格 |
ComponentFillStatus | String | 此填写控件的填写状态 0 : 此填写控件未填写 1 : 此填写控件已填写 示例值:1 |
ComponentValue | String | 控件填写内容 示例值:100 |
ImageUrl | String | 图片填充控件下载链接,如果是图片填充控件时,这里返回图片的下载链接。 注: 链接不是永久链接, 默认有效期5分钟后, 到期后链接失效 示例值:https://file.test.ess.tencent.cn/bresource/resource/resource/0/0.JPG?hkey=ffe60eceb87e57f6d25 |
Filter
此结构体 (Filter) 用于描述查询过滤条件。
被如下接口引用:ChannelDescribeEmployees, ChannelDescribeRoles。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
Key | String | 是 | 查询过滤条件的Key |
Values | Array of String | 是 | 查询过滤条件的Value列表 |
FlowApproverDetail
签署人的流程信息明细
被如下接口引用:DescribeFlowDetailInfo。
名称 | 类型 | 描述 |
---|---|---|
ReceiptId | String | 模板配置时候的签署人角色ID(用PDF文件发起也可以指定,如果不指定则自动生成此角色ID), 所有的填写控件和签署控件都归属不同的角色 示例值:yDRS4UUgygqdcjjdUuO4zjEC0osCOsHS |
ProxyOrganizationOpenId | String | 第三方平台子客企业的唯一标识,定义Agent中的ProxyOrganizationOpenId一样, 可以参考Agent结构体 注意:此字段可能返回 null,表示取不到有效值。 示例值:org_dianziqian |
ProxyOperatorOpenId | String | 第三方平台子客企业员工的唯一标识 示例值:n9527 |
ProxyOrganizationName | String | 第三方平台子客企业名称,与企业营业执照中注册的名称一致。 示例值:典子谦示例企业 |
Mobile | String | 签署人手机号 示例值:13888888888 |
SignOrder | Integer | 签署顺序,如果是有序签署,签署顺序从小到大 |
ApproveName | String | 签署方经办人的姓名。 经办人的姓名将用于身份认证和电子签名,请确保填写的姓名为签署方的真实姓名,而非昵称等代名。 注意:此字段可能返回 null,表示取不到有效值。 示例值:典子谦 |
ApproveStatus | String | 当前签署人的状态, 状态如下
注意:此字段可能返回 null,表示取不到有效值。 示例值:ACCEPT |
ApproveMessage | String | 签署人拒签等情况的时候填写的原因 注意:此字段可能返回 null,表示取不到有效值。 |
ApproveTime | Integer | 签署人签署时间戳,单位秒 示例值:1689688460 |
ApproveType | String | 参与者类型
注意:此字段可能返回 null,表示取不到有效值。 示例值:PERSON |
ApproverRoleName | String | 自定义签署人的角色名, 如: 收款人、开具人、见证人等 注意:此字段可能返回 null,表示取不到有效值。 示例值:卖方 |
FlowApproverInfo
创建签署流程签署人入参。
各种场景传参说明:
场景编号 | 发起方类型 | 签署方类型 | 签署方传参说明 |
---|---|---|---|
场景一 | 第三方子企业A员工 | 第三方子企业A员工 |
|
场景二 | 第三方子企业A员工 | 第三方子企业B(不指定经办人走领取方式) |
|
场景三 | 第三方子企业A员工 | 第三方子企业B员工 |
|
场景四 | 第三方子企业A员工 | 个人/自然人 |
|
场景五 | 第三方子企业A员工 | SaaS平台企业员工 |
|
注1: 使用模板发起合同时,RecipientId(模板发起合同时)必传
RecipientId参数获取: 从DescribeFlowTemplates接口接口中,可以得到模板下的签署方Recipient列表,根据模板自定义的Rolename在此结构体中确定其RecipientId。
注2: 如果发起的是动态签署方(即ApproverOption.FillType指定为1),可以不指定具体签署人信息
, 动态签署方可以参考此文档
被如下接口引用:ChannelCreateBatchQuickSignUrl, ChannelCreateFlowByFiles, ChannelCreateFlowGroupByFiles, ChannelCreateFlowGroupByTemplates, ChannelCreateFlowSignUrl, CreateFlowsByTemplates, PrepareFlows。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
Name | String | 否 | 签署方经办人的姓名。 经办人的姓名将用于身份认证和电子签名,请确保填写的姓名为签署方的真实姓名,而非昵称等代名。 示例值:张三 |
IdCardType | String | 否 | 签署方经办人的证件类型,支持以下类型
注: 其他证件类型为白名单功能,使用前请联系对接的客户经理沟通。 示例值:ID_CARD |
IdCardNumber | String | 否 | 签署方经办人的证件号码,应符合以下规则
示例值:110101192008317114 |
Mobile | String | 否 | 签署方经办人手机号码, 支持国内手机号11位数字(无需加+86前缀或其他字符), 不支持海外手机号。 请确认手机号所有方为此合同签署方。 示例值:13888888888 |
OrganizationName | String | 否 | 组织机构名称。 请确认该名称与企业营业执照中注册的名称一致。 如果名称中包含英文括号(),请使用中文括号()代替。 示例值:典子谦示例企业 |
NotChannelOrganization | Boolean | 否 | 指定签署人非第三方平台子客企业下员工还是SaaS平台企业,在ApproverType为ORGANIZATION时指定。
示例值:false |
OpenId | String | 否 | 第三方平台子客企业员工的唯一标识,长度不能超过64,只能由字母和数字组成 当签署方为同一第三方平台下的员工时,该字段若不指定,则发起【待领取】的流程 注: 如果传进来的OpenId已经实名并且加入企业, 则忽略Name,IdCardType,IdCardNumber,Mobile这四个入参(会用此OpenId实名的身份证和登录的手机号覆盖) 示例值:userdianziqian |
OrganizationOpenId | String | 否 | 同应用下第三方平台子客企业的唯一标识,定义Agent中的ProxyOrganizationOpenId一样,签署方为非发起方企业场景下必传,最大长度64个字符 示例值:orgtencent |
ApproverType | String | 否 | 在指定签署方时,可选择企业B端或个人C端等不同的参与者类型,可选类型如下:
注: 1. 个人自动签场景(PERSON_AUTO_SIGN)为白名单功能, 使用前请联系对接的客户经理沟通。 2. 若要实现他方企业(同一应用下)自动签,需要满足3个条件:
示例值:PERSON |
RecipientId | String | 否 | 签署流程签署人在模板中对应的签署人Id;在非单方签署、以及非B2C签署的场景下必传,用于指定当前签署方在签署流程中的位置; 示例值:yDRS4UUgygqdcjjdUuO4zjEC0osCOsHS |
Deadline | Integer | 否 | 签署人的签署截止时间,格式为Unix标准时间戳(秒) 注: 若不设置此参数,则默认使用合同的截止时间,此参数暂不支持合同组子合同 示例值:1689688460 |
SignComponents | Array of Component | 否 | 使用PDF文件直接发起合同时,签署人指定的签署控件; 使用模板发起合同时,指定本企业印章签署控件的印章ID: 通过ComponentId或ComponenetName指定签署控件,ComponentValue为印章ID。 |
ComponentLimitType | Array of String | 否 | 当签署方控件类型为 SIGN_SIGNATURE 时,可以指定签署方签名方式。如果不指定,签署人可以使用所有的签名类型,可指定的签名类型包括:
各种签名的样式可以参考下图: 示例值:["OCR_ESIGN"] |
PreReadTime | Integer | 否 | 签署方在签署合同之前,需要强制阅读合同的时长,可指定为3秒至300秒之间的任意值。 若未指定阅读时间,则会按照合同页数大小计算阅读时间,计算规则如下:
示例值:3 |
JumpUrl | String | 否 | 签署完前端跳转的url,此字段的用法场景请联系客户经理确认 示例值:https://www.qq.com/success |
ApproverOption | ApproverOption | 否 | 可以控制签署方在签署合同时能否进行某些操作,例如拒签、转交他人、是否为动态补充签署人等。 详细操作可以参考开发者中心的ApproverOption结构体。 |
ApproverNeedSignReview | Boolean | 否 | 发起方企业的签署人进行签署操作前,是否需要企业内部走审批流程,取值如下:
企业可以通过ChannelCreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果
注: 此功能可用于与企业内部的审批流程进行关联,支持手动、静默签署合同 示例值:false |
ApproverVerifyTypes | Array of Integer | 否 | 指定个人签署方查看合同的校验方式,可以传值如下:
注:
示例值:[1,2] |
ApproverSignTypes | Array of Integer | 否 | 签署人签署合同时的认证方式
默认为1(人脸认证 ),2(签署密码),3(运营商三要素),5(设备指纹识别),6(设备面容识别) 注: 1. 用模板创建合同场景, 签署人的认证方式需要在配置模板的时候指定, 在创建合同重新指定无效 2. 运营商三要素认证方式对手机号运营商及前缀有限制,可以参考运营商支持列表类得到具体的支持说明 3. 校验方式不允许只包含设备指纹识别和设备面容识别,至少需要再增加一种其他校验方式。 4. 设备指纹识别和设备面容识别只支持小程序使用,其他端暂不支持。 示例值:[1,2,3] |
SignId | String | 否 | 签署ID - 发起流程时系统自动补充 - 创建签署链接时,可以通过查询详情接口获得签署人的SignId,然后可传入此值为该签署人创建签署链接,无需再传姓名、手机号、证件号等其他信息 |
NotifyType | String | 否 | 通知签署方经办人的方式, 有以下途径:
注: 签署方为第三方子客企业时会被置为NONE, 不会发短信通知 示例值:SMS |
AddSignComponentsLimits | Array of ComponentLimit | 否 | 通过文件创建签署流程时,如果设置了外层参数SignBeanTag=1(允许签署过程中添加签署控件),则可通过此参数明确规定合同所使用的签署控件类型(骑缝章、普通章法人章等)和具体的印章(印章ID,或者印章类型)或签名方式。 注: 限制印章控件或骑缝章控件情况下,仅本企业签署方可以指定具体印章(通过传递ComponentValue,支持多个),他方企业或个人只支持限制控件类型。 |
ApproverRoleName | String | 否 | 可以自定义签署人角色名:收款人、开具人、见证人等,长度不能超过20,只能由中文、字母、数字和下划线组成。 注: 如果是用模板发起, 优先使用此处上传的, 如果不传则用模板的配置的 |
SignTypeSelector | Integer | 否 | 生成H5签署链接时,您可以指定签署方签署合同的认证校验方式的选择模式,可传递一下值:
注: 不指定该值时,默认为签署方自行选择。 示例值:0 |
Components | Array of Component | 否 | 签署人在合同中的填写控件列表,列表中可支持下列多种填写控件,控件的详细定义参考开发者中心的Component结构体
具体使用说明可参考为签署方指定填写控件 注: 此参数仅在通过文件发起合同或者合同组时生效 |
Intention | Intention | 否 | 只有在生成H5签署链接的情形下( 如调用获取H5签署链接、获取H5批量签署链接等接口),该配置才会生效。 您可以指定H5签署视频核身的意图配置,选择问答模式或点头模式的语音文本。 注意: 1. 视频认证为白名单功能,使用前请联系对接的客户经理沟通。 2. 使用视频认证时,生成H5签署链接的时候必须将签署认证方式指定为人脸(即ApproverSignTypes设置成人脸签署)。 3. 签署完成后,可以通过查询签署认证人脸视频获取到当时的视频。 |
FlowApproverItem
签署方信息,如角色ID、角色名称等
被如下接口引用:CreateFlowsByTemplates。
名称 | 类型 | 描述 |
---|---|---|
FlowId | String | 合同编号 注意:此字段可能返回 null,表示取不到有效值。 |
Approvers | Array of ApproverItem | 签署方信息,如角色ID、角色名称等 注意:此字段可能返回 null,表示取不到有效值。 |
FlowApproverUrlInfo
签署人签署链接信息。
被如下接口引用:ChannelCreateBatchQuickSignUrl, ChannelCreateFlowSignUrl。
名称 | 类型 | 描述 |
---|---|---|
SignUrl | String | 签署短链接。 注意: 1. 该链接有效期为30分钟,同时需要注意保密,不要外泄给无关用户。 2. 该链接不支持小程序嵌入,仅支持移动端浏览器打开。 3. 生成的链路后面不能再增加参数(会出现覆盖链接中已有参数导致错误) 示例值:https://essurl.cn/M**XE |
ApproverType | String | 签署人类型。 - PERSON: 个人 示例值:PERSON |
Name | String | 签署人姓名。 示例值:典子谦 |
Mobile | String | 签署人手机号。 示例值:13200000000 |
LongUrl | String | 签署长链接。 注意: 1. 该链接有效期为30分钟,同时需要注意保密,不要外泄给无关用户。 2. 该链接不支持小程序嵌入,仅支持移动端浏览器打开。 3. 生成的链路后面不能再增加参数(会出现覆盖链接中已有参数导致错误) 注意:此字段可能返回 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" |
FlowBatchApproverInfo
批量签署合同相关信息,指定批量签署合同和签署方的信息,用于补充动态签署人。
被如下接口引用:ChannelCreateBatchQuickSignUrl, ChannelCreateBatchSignUrl。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
FlowId | String | 否 | 合同流程ID。 示例值:yDwFmUUckpstqfvzUE1h3jo1f3cqjkGm |
RecipientId | String | 否 | 签署节点ID,用于生成动态签署人链接完成领取。注:生成动态签署人补充链接时必传。 |
FlowBatchUrlInfo
批量签署合同相关信息,指定批量签署合同和签署方的信息,用于补充动态签署人。
被如下接口引用:ChannelCreateBatchQuickSignUrl, ChannelCreateBatchSignUrl。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
FlowBatchApproverInfos | Array of FlowBatchApproverInfo | 否 | 批量签署合同和签署方的信息,用于补充动态签署人。 |
FlowDetailInfo
此结构体(FlowDetailInfo)描述的是合同(流程)的详细信息
被如下接口引用:DescribeFlowDetailInfo。
名称 | 类型 | 描述 |
---|---|---|
FlowId | String | 合同流程ID,为32位字符串。 示例值:yDRCLUUgygq2xun5UuO4zjEwg0vjoimj |
FlowName | String | 合同流程的名称(可自定义此名称),长度不能超过200,只能由中文、字母、数字和下划线组成。 示例值:购买50吨西瓜的采购合同 |
FlowType | String | 合同流程的类别分类(如销售合同/入职合同等)。 示例值:入职合同 |
FlowStatus | String | 合同流程当前的签署状态, 会存在下列的状态值
|
FlowMessage | String | 当合同流程状态为已拒签(即 FlowStatus=REJECT)或已撤销(即 FlowStatus=CANCEL )时,此字段 FlowMessage 为拒签或撤销原因。 |
CreateOn | Integer | 合同流程的创建时间戳,格式为Unix标准时间戳(秒)。 示例值:1606910798 |
DeadLine | Integer | 签署流程的签署截止时间, 值为unix时间戳, 精确到秒。 示例值:1604912664 |
CustomData | String | 调用方自定义的个性化字段(可自定义此字段的值),并以base64方式编码,支持的最大数据大小为 1000长度。 在合同状态变更的回调信息等场景中,该字段的信息将原封不动地透传给贵方。 |
FlowApproverInfos | Array of FlowApproverDetail | 合同流程的签署方数组 |
CcInfos | Array of FlowApproverDetail | 合同流程的关注方信息数组 |
NeedCreateReview | Boolean | 是否需要发起前审批
示例值:false |
FlowFileInfo
合同组中每个子合同的发起信息
被如下接口引用:ChannelCreateFlowGroupByFiles。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
FileIds | Array of String | 是 | 签署文件资源Id列表,目前仅支持单个文件 示例值:["xxx"] |
FlowName | String | 是 | 签署流程名称,长度不超过200个字符 示例值:"xxx" |
FlowApprovers | Array of FlowApproverInfo | 是 | 签署流程签约方列表,最多不超过5个参与方 |
Deadline | Integer | 否 | 签署流程截止时间,十位数时间戳,最大值为33162419560,即3020年 示例值:1662110622 |
FlowDescription | String | 否 | 签署流程的描述,长度不超过1000个字符 示例值:"xxx" |
FlowType | String | 否 | 签署流程的类型,长度不超过255个字符 示例值:"xxx" |
CustomerData | String | 否 | 第三方应用的业务信息,最大长度1000个字符。发起自动签署时,需设置对应自动签署场景,目前仅支持场景:处方单-E_PRESCRIPTION_AUTO_SIGN 示例值:"xxx" |
Unordered | Boolean | 否 | 合同签署顺序类型(无序签,顺序签),默认为false,即有序签署 示例值:false |
Components | Array of Component | 否 | 签署文件中的发起方的填写控件,需要在发起的时候进行填充 |
CustomShowMap | String | 否 | 合同显示的页卡模板,说明:只支持{合同名称}, {发起方企业}, {发起方姓名}, {签署方N企业}, {签署方N姓名},且N不能超过签署人的数量,N从1开始 示例值:"xxx" |
NeedSignReview | Boolean | 否 | 本企业(发起方企业)是否需要签署审批 示例值:flase |
FlowDisplayType | Integer | 否 | 在短信通知、填写、签署流程中,若标题、按钮、合同详情等地方存在“合同”字样时,可根据此配置指定文案,可选文案如下:
示例值:1 |
FlowGroupApproverInfo
合同组相关信息,指定合同组子合同和签署方的信息,用于补充动态签署人。
被如下接口引用:CreateSignUrls。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
FlowId | String | 否 | 合同流程ID。 示例值:yDwFmUUckpstqfvzUE1h3jo1f3cqjkGm |
RecipientId | String | 否 | 签署节点ID,用于生成动态签署人链接完成领取。注:生成动态签署人补充链接时必传。 |
FlowGroupApprovers
合同组签署方信息
被如下接口引用:ChannelCreateFlowGroupByFiles, ChannelCreateFlowGroupByTemplates。
名称 | 类型 | 描述 |
---|---|---|
FlowId | String | 合同流程ID 注意:此字段可能返回 null,表示取不到有效值。 示例值:yDwFmUUckpstqfvzUE1h3jo1f3cqjkGm |
Approvers | Array of ApproverItem | 签署方信息,包含合同ID和角色ID用于定位RecipientId。 注意:此字段可能返回 null,表示取不到有效值。 |
FlowGroupOptions
合同组的配置项信息包括:在合同组签署过程中,是否需要对每个子合同进行独立的意愿确认。
被如下接口引用:ChannelCreateFlowGroupByFiles。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
SelfOrganizationApproverSignEach | Boolean | 否 | 发起方企业经办人(即签署人为发起方企业员工)是否需要对子合同进行独立的意愿确认
示例值:fasle |
OtherApproverSignEach | Boolean | 否 | 非发起方企业经办人(即:签署人为个人或者不为发起方企业的员工)是否需要对子合同进行独立的意愿确认
示例值:fasle |
FlowGroupUrlInfo
合同组相关信息,指定合同组子合同和签署方的信息,用于补充动态签署人。
被如下接口引用:CreateSignUrls。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
FlowGroupApproverInfos | Array of FlowGroupApproverInfo | 否 | 合同组子合同和签署方的信息,用于补充动态签署人。 |
FlowInfo
此结构体 (FlowInfo) 用于描述签署流程信息。
被如下接口引用:ChannelCreateFlowGroupByTemplates, CreateFlowsByTemplates, PrepareFlows。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
FlowName | String | 是 | 合同流程的名称(可自定义此名称),长度不能超过200,只能由中文、字母、数字和下划线组成。 示例值:张三的入职合同 |
Deadline | Integer | 是 | 合同流程的签署截止时间,格式为Unix标准时间戳(秒),如果未设置签署截止时间,则默认为合同流程创建后的365天时截止。 如果在签署截止时间前未完成签署,则合同状态会变为已过期,导致合同作废。 示例值:1604912664 示例值:1698827057 |
TemplateId | String | 否 | 用户配置的合同模板ID,会基于此模板创建合同文档,为32位字符串。 如果使用模板发起接口,此参数为必填。 可以通过生成子客登录链接登录企业控制台, 在企业模板中得到合同模板ID。 点击产看模板Id在控制台上的位置 示例值:yDRS4UUgygqdcj2tUuO4zjEEFuP35Swc |
FlowApprovers | Array of FlowApproverInfo | 否 | 合同流程的参与方列表,最多可支持50个参与方 注: 在发起流程时,需要保证 FlowApprovers中的顺序与模板定义顺序一致,否则会发起失败。 例如,如果模板中定义的第一个参与人是个人用户,第二个参与人是企业员工,则在 approver 中传参时,第一个也必须是个人用户,第二个参与人必须是企业员工。 点击查看模板参与人顺序定义位置 示例值:签署人信息 |
FormFields | Array of FormField | 否 | 发起方角色的填写控件的填充内容。 注:只有在控制台编辑模板时,归属给发起方的填写控件(如下图)才能在创建文档的时候进行内容填充。(白名单功能需要联系对接经理开通,否则模板编辑时无法将填写控件分配给发起方)。 示例值:表单K-V对列表 |
FlowType | String | 否 | 合同流程的类别分类(可自定义名称,如销售合同/入职合同等),最大长度为200个字符,仅限中文、字母、数字和下划线组成。 示例值:入职合同 |
FlowDescription | String | 否 | 合同流程描述信息(可自定义此描述),最大长度1000个字符。 示例值:张三2023年的入职公司财务部的合同 |
CustomerData | String | 否 | 调用方自定义的个性化字段(可自定义此名称),并以base64方式编码,支持的最大数据大小为1000长度。 在合同状态变更的回调信息等场景中,该字段的信息将原封不动地透传给贵方。回调的相关说明可参考开发者中心的回调通知模块。 示例值:QmFzZTY05YaF5a65 |
CustomShowMap | String | 否 | 您可以自定义腾讯电子签小程序合同列表页展示的合同内容模板,模板中支持以下变量:
其中,N表示签署方的编号,从1开始,不能超过签署人的数量。 例如,如果是腾讯公司张三发给李四名称为“租房合同”的合同,您可以将此字段设置为: 合同名称:{合同名称};发起方: {发起方企业}({发起方姓名});签署方:{签署方1姓名} ,则小程序中列表页展示此合同为以下样子合同名称:租房合同 发起方:腾讯公司(张三) 签署方:李四 示例值:合同名称:{合同名称};发起方: {发起方企业}的{发起方姓名}大佬!;净重: 100吨;品类: 铁矿石 |
CcInfos | Array of CcInfo | 否 | 合同流程的抄送人列表,最多可支持50个抄送人,抄送人可查看合同内容及签署进度,但无需参与合同签署。 示例值: |
NeedSignReview | Boolean | 否 | 发起方企业的签署人进行签署操作前,是否需要企业内部走审批流程,取值如下:
企业可以通过CreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果
注: 此功能可用于与企业内部的审批流程进行关联,支持手动、静默签署合同 示例值:true |
CcNotifyType | Integer | 否 | 若在创建签署流程时指定了关注人CcInfos,此参数可设定向关注人发送短信通知的类型:
示例值:0 |
AutoSignScene | String | 否 | 个人自动签名的使用场景包括以下, 个人自动签署(即ApproverType设置成个人自动签署时)业务此值必传:
注: 个人自动签名场景是白名单功能,使用前请与对接的客户经理联系沟通。 示例值:E_PRESCRIPTION_AUTO_SIGN |
FlowDisplayType | Integer | 否 | 在短信通知、填写、签署流程中,若标题、按钮、合同详情等地方存在“合同”字样时,可根据此配置指定文案,可选文案如下:
示例值:1 |
FlowResourceUrlInfo
流程对应资源链接信息
被如下接口引用:DescribeResourceUrlsByFlows。
名称 | 类型 | 描述 |
---|---|---|
FlowId | String | 合同流程的ID 注意:此字段可能返回 null,表示取不到有效值。 示例值:xxx |
ResourceUrlInfos | Array of ResourceUrlInfo | 对应的合同流程的PDF下载链接 注意:此字段可能返回 null,表示取不到有效值。 |
FormField
电子文档的控件填充信息。按照控件类型进行相应的填充。
当控件的 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" 或者 "0xFFFFFF"; bold : 是否加粗, true : 加粗 false: 不加粗; align: 对其方式, 支持 LEFT / RIGHT / CENTER
被如下接口引用:ChannelCreateFlowGroupByTemplates, ChannelCreatePrepareFlow, CreateFlowsByTemplates, PrepareFlows。
名称 | 类型 | 必选 | 描述 | ||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
ComponentValue | String | 是 | 控件填充值,ComponentType和传入值格式对应关系如下:
控件值约束说明:
示例值:Name | ||||||||||||||||||||||||||||||||||||||||||
ComponentId | String | 否 | 表单域或控件的ID,跟ComponentName二选一,不能全为空; CreateFlowsByTemplates 接口不使用此字段。 点击此处查看模板上控件ID的获取方式 注意:此字段可能返回 null,表示取不到有效值。 示例值:391963b9d3cb2de35dedc6eb0a60e535 | ||||||||||||||||||||||||||||||||||||||||||
ComponentName | String | 否 | 控件的名字,跟ComponentId二选一,不能全为空 点击此处查看模板上控件名字的获取方式 注意:此字段可能返回 null,表示取不到有效值。 示例值:住房地址 | ||||||||||||||||||||||||||||||||||||||||||
LockComponentValue | Boolean | 否 | 是否锁定模板控件值,锁定后无法修改(用于嵌入式发起合同),true-锁定,false-不锁定 注意:此字段可能返回 null,表示取不到有效值。 示例值:false |
HasAuthOrganization
授权企业列表(目前仅用于“企业自动签 -> 合作企业授权”)
被如下接口引用:DescribeExtendedServiceAuthDetail。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
OrganizationOpenId | String | 否 | 授权企业openid, 注意:此字段可能返回 null,表示取不到有效值。 |
OrganizationName | String | 否 | 授权企业名称 注意:此字段可能返回 null,表示取不到有效值。 |
AuthorizedOrganizationOpenId | String | 否 | 被授权企业openid, 注意:此字段可能返回 null,表示取不到有效值。 |
AuthorizedOrganizationName | String | 否 | 被授权企业名称 注意:此字段可能返回 null,表示取不到有效值。 |
AuthorizeTime | Integer | 否 | 授权时间,格式为时间戳,单位s 注意:此字段可能返回 null,表示取不到有效值。 |
HasAuthUser
被授权的用户信息
被如下接口引用:DescribeExtendedServiceAuthDetail。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
OpenId | String | 否 | 第三方应用平台自定义,对应第三方平台子客企业员工的唯一标识。 注意:此字段可能返回 null,表示取不到有效值。 |
Intention
视频核身意图配置,可指定问答模式或者点头模式的语音文本。
注: 视频认证为白名单功能,使用前请联系对接的客户经理沟通。
被如下接口引用:ChannelCreateBatchQuickSignUrl, ChannelCreateFlowByFiles, ChannelCreateFlowSignUrl。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
IntentionType | Integer | 否 | 视频认证类型,支持以下类型
注: 视频认证为白名单功能,使用前请联系对接的客户经理沟通。 示例值:1 |
IntentionQuestions | Array of IntentionQuestion | 否 | 意愿核身语音问答模式(即语音播报+语音回答)使用的文案,包括:系统语音播报的文本、需要核验的标准文本。当前仅支持1轮问答。 注: 选择问答模式时,此字段可不传,不传则使用默认语音文本:请问,您是否同意签署本协议?可语音回复“同意”或“不同意”。 |
IntentionActions | Array of IntentionAction | 否 | 意愿核身(点头确认模式)使用的文案,若未使用意愿核身(点头确认模式),则该字段无需传入。当前仅支持一个提示文本。 注: 选择点头模式时,此字段可不传,不传则使用默认语音文本:请问,您是否同意签署本协议?可点头同意。 |
IntentionAction
意愿核身(点头确认模式)使用的文案,若未使用意愿核身(点头确认模式),则该字段无需传入。当前仅支持一个提示文本。
被如下接口引用:ChannelCreateBatchQuickSignUrl, ChannelCreateFlowByFiles, ChannelCreateFlowSignUrl。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
Text | String | 否 | 点头确认模式下,系统语音播报使用的问题文本,问题最大长度为150个字符。 示例值:请问您本次业务是本人自愿办理吗?如是,请点头确认。 |
IntentionActionResult
意愿核身点头确认模式结果
被如下接口引用:ChannelDescribeSignFaceVideo。
名称 | 类型 | 描述 |
---|---|---|
Details | Array of IntentionActionResultDetail | 意愿核身结果详细数据,与每段点头确认过程一一对应 注意:此字段可能返回 null,表示取不到有效值。 |
IntentionActionResultDetail
意愿核身点头确认模式结果详细数据
被如下接口引用:ChannelDescribeSignFaceVideo。
名称 | 类型 | 描述 |
---|---|---|
Video | String | 视频base64编码(其中包含全程提示文本和点头音频,mp4格式) 注意:此字段可能返回 null,表示取不到有效值。 |
IntentionQuestion
意愿核身语音问答模式(即语音播报+语音回答)使用的文案,包括:系统语音播报的文本、需要核验的标准文本。当前仅支持1轮问答。
被如下接口引用:ChannelCreateBatchQuickSignUrl, ChannelCreateFlowByFiles, ChannelCreateFlowSignUrl。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
Question | String | 否 | 当选择语音问答模式时,系统自动播报的问题文本,最大长度为150个字符。 示例值:请问您本次业务是本人自愿办理吗?如是,请回复“我同意”。 |
Answers | Array of String | 否 | 当选择语音问答模式时,用于判断用户回答是否通过的标准答案列表,传入后可自动判断用户回答文本是否在标准文本列表中。 示例值:“同意”,“我同意”,“确认”,“我确认” |
IntentionQuestionResult
意愿核身问答模式结果。若未使用该意愿核身功能,该字段返回值可以不处理。
被如下接口引用:ChannelDescribeSignFaceVideo。
名称 | 类型 | 描述 |
---|---|---|
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 | 否 | 签署方经办人的证件号码,应符合以下规则
示例值:620000198802020000 |
OrganizationName | String | 否 | 组织机构名称。 请确认该名称与企业营业执照中注册的名称一致。 如果名称中包含英文括号(),请使用中文括号()代替。 如果签署方是企业签署方(approverType = 0 或者 approverType = 3), 则企业名称必填。 |
OccupiedSeal
持有的电子印章信息
被如下接口引用:ChannelDescribeOrganizationSeals。
名称 | 类型 | 描述 |
---|---|---|
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 | 电子印章类型 , 可选类型如下:
|
IsAllTime | Boolean | 用印申请是否为永久授权 |
AuthorizedUsers | Array of AuthorizedUser | 授权人列表 |
OrganizationAuthUrl
企业批量注册链接信息
被如下接口引用:DescribeBatchOrganizationRegistrationUrls。
名称 | 类型 | 描述 | ||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
AuthUrl | String | 跳转链接, 链接的有效期根据企业,员工状态和终端等有区别, 可以参考下表
注: 1.链接仅单次有效,每次登录需要需要重新创建新的链接 2.创建的链接应避免被转义,如:&被转义为\u0026;如使用Postman请求后,请选择响应类型为 JSON,否则链接将被转义 | ||||||||||||||||||||||||||||
ErrorMessage | String | 企业批量注册的错误信息,例如:企业三要素不通过 |
PdfVerifyResult
合同验签每个签署区的信息
被如下接口引用:ChannelVerifyPdf。
名称 | 类型 | 描述 |
---|---|---|
VerifyResult | Integer | 验签结果详情,每个签名域对应的验签结果。状态值如下
示例值:1 |
SignPlatform | String | 签署平台 如果文件是在腾讯电子签平台签署,则为腾讯电子签, 如果文件不在腾讯电子签平台签署,则为其他平台。 示例值:腾讯电子签 |
SignerName | String | 申请证书的主体的名字 如果是在腾讯电子签平台签署, 则对应的主体的名字个数如下 企业: ESS@企业名称@平台生成的数字编码 个人: ESS@个人姓名@证件号@平台生成的数字编码 如果在其他平台签署的, 主体的名字参考其他平台的说明 示例值:ESS@张三@37000019890303000X@808854 |
SignTime | Integer | 签署时间的Unix时间戳,单位毫秒 示例值:1699252071000 |
SignAlgorithm | String | 证书签名算法, 如SHA1withRSA等算法 示例值:SHA1withRSA |
CertSn | String | CA供应商下发给用户的证书编号 注意: 腾讯电子签接入多家CA供应商以提供容灾能力,不同CA下发的证书编号区别较大,但基本都是由数字和字母组成,长度在200以下 。示例值:6c8e2911fadf70ea |
CertNotBefore | Integer | 证书起始时间的Unix时间戳,单位毫秒 示例值:1681301253000 |
CertNotAfter | Integer | 证书过期时间的时间戳,单位毫秒 示例值:1712837253000 |
SignType | Integer | 签名类型, 保留字段, 现在全部为0 示例值:0 |
ComponentPosX | Float | 签名域横坐标,单位px 示例值:177.05 |
ComponentPosY | Float | 签名域纵坐标,单位px 示例值:90.25 |
ComponentWidth | Float | 签名域宽度,单位px 示例值:119 |
ComponentHeight | Float | 签名域高度,单位px 示例值:13.7 |
ComponentPage | Integer | 签名域所在页码,1~N 示例值:1 |
Permission
权限树节点权限
被如下接口引用:ChannelCreateRole, ChannelModifyRole。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
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
权限树中的权限组
被如下接口引用:ChannelCreateRole, ChannelDescribeRoles, ChannelModifyRole。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
GroupName | String | 否 | 权限组名称 注意:此字段可能返回 null,表示取不到有效值。 |
GroupKey | String | 否 | 权限组key 注意:此字段可能返回 null,表示取不到有效值。 |
Hide | Integer | 否 | 是否隐藏分组,0否1是 注意:此字段可能返回 null,表示取不到有效值。 |
Permissions | Array of Permission | 否 | 权限集合 注意:此字段可能返回 null,表示取不到有效值。 |
ProxyOrganizationOperator
同步的员工的信息
被如下接口引用:SyncProxyOrganizationOperators。
名称 | 类型 | 必选 | 描述 | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Id | String | 是 | 员工的唯一标识(即OpenId), 定义Agent中的OpenId一样, 可以参考Agent结构体 示例值:n9527 | ||||||||||||
Name | String | 否 | 员工的姓名,最大长度50个字符 员工的姓名将用于身份认证和电子签名,请确保填写的姓名为真实姓名,而非昵称等代名。 示例值:张三 | ||||||||||||
IdCardType | String | 否 | 签署方经办人的证件类型,支持以下类型
示例值:ID_CARD | ||||||||||||
IdCardNumber | String | 否 | 经办人证件号 | ||||||||||||
Mobile | String | 否 | 员工的手机号,支持国内手机号11位数字(无需加+86前缀或其他字符),不支持海外手机号。 示例值:1850000000 | ||||||||||||
DefaultRole | String | 否 | 预先分配员工的角色, 可以分配的角色如下:
示例值:channel-normal-operator |
Recipient
流程中签署方和填写方(如果有填写控件存证时)的信息
被如下接口引用:DescribeTemplates。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
RecipientId | String | 否 | 合同参与方的角色ID 示例值:ed68bc6904fbd4795b4658c480214e4e |
RecipientType | String | 否 | 参与者类型, 可以选择的类型如下:
示例值:ENTERPRISE |
Description | String | 否 | 合同参与方的角色描述,长度不能超过100,只能由中文、字母、数字和下划线组成。 |
RoleName | String | 否 | 合同参与方的角色名字,长度不能超过20,只能由中文、字母、数字和下划线组成。 示例值:卖方 |
RequireValidation | Boolean | 否 | 是否需要校验, true-是, false-否 示例值:true |
RequireSign | Boolean | 否 | 是否必须填写, true-是, false-否 示例值:true |
SignType | Integer | 否 | 内部字段,签署类型 示例值:0 |
RoutingOrder | Integer | 否 | 签署顺序:数字越小优先级越高 示例值:0 |
IsPromoter | Boolean | 否 | 是否是发起方, true-是 false-否 示例值:true |
ApproverVerifyTypes | Array of Integer | 否 | 签署人查看合同校验方式, 支持的类型如下:
示例值:[1,2] |
ApproverSignTypes | Array of Integer | 否 | 签署人进行合同签署时的认证方式,支持的类型如下:
示例值:[1,2,3] |
NoTransfer | Boolean | 否 | 签署方是否可以转他人处理
|
RecipientComponentInfo
参与方填写控件信息
被如下接口引用:ChannelDescribeFlowComponents。
名称 | 类型 | 描述 |
---|---|---|
RecipientId | String | 参与方的角色ID 示例值:yDRS4UUgygqdcj51UuO4zjEyWTmzsIAR |
RecipientFillStatus | String | 参与方填写状态
示例值:1 |
IsPromoter | Boolean | 此角色是否是发起方角色
注意:此字段可能返回 null,表示取不到有效值。 示例值:true |
Components | Array of FilledComponent | 此角色的填写控件列表 注意:此字段可能返回 null,表示取不到有效值。 |
RegistrationOrganizationInfo
企业认证信息参数, 需要保证这些参数跟营业执照中的信息一致。
被如下接口引用:CreateBatchOrganizationRegistrationTasks。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
OrganizationName | String | 是 | 组织机构名称。 请确认该名称与企业营业执照中注册的名称一致。 如果名称中包含英文括号(),请使用中文括号()代替。 |
OrganizationOpenId | String | 是 | 机构在贵司业务系统中的唯一标识,用于与腾讯电子签企业账号进行映射,确保在同一应用内不会出现重复。 该标识最大长度为64位字符串,仅支持包含26个英文字母和数字0-9的字符。 |
OpenId | String | 是 | 员工在贵司业务系统中的唯一身份标识,用于与腾讯电子签账号进行映射,确保在同一应用内不会出现重复。 该标识最大长度为64位字符串,仅支持包含26个英文字母和数字0-9的字符。 |
UniformSocialCreditCode | String | 是 | 组织机构企业统一社会信用代码。 请确认该企业统一社会信用代码与企业营业执照中注册的统一社会信用代码一致。 |
LegalName | String | 是 | 组织机构法人的姓名。 请确认该企业统一社会信用代码与企业营业执照中注册的法人姓名一致。 |
Address | String | 是 | 组织机构企业注册地址。 请确认该企业注册地址与企业营业执照中注册的地址一致。 示例值:深圳市南山区高新区科技中一路腾讯大厦35层 |
AdminName | String | 否 | 组织机构超管姓名。 在注册流程中,必须是超管本人进行操作。 如果法人作为超管管理组织机构,超管姓名就是法人姓名 |
AdminMobile | String | 否 | 组织机构超管手机号。 在注册流程中,这个手机号必须跟操作人在电子签注册的个人手机号一致。 |
AuthorizationTypes | Array of Integer | 否 | 可选的此企业允许的授权方式, 可以设置的方式有: 1:上传授权书 2:法人授权超管 5:授权书+对公打款 注: 1. 当前仅支持一种认证方式 2. 如果当前的企业类型是政府/事业单位, 则只支持上传授权书+对公打款 3. 如果当前操作人是法人,则是法人认证 |
AdminIdCardType | String | 否 | 经办人的证件类型,支持以下类型
|
AdminIdCardNumber | String | 否 | 经办人的证件号 |
BusinessLicense | String | 否 | 营业执照正面照(PNG或JPG) base64格式, 大小不超过5M |
PowerOfAttorneys | Array of String | 否 | 授权书(PNG或JPG或PDF) base64格式, 大小不超过8M 。 p.s. 如果上传授权书 ,需遵循以下条件 1. 超管的信息(超管姓名,超管身份证,超管手机号)必须为必填参数。 2. 超管的个人身份必须在电子签已经实名。 2. 认证方式AuthorizationTypes必须只能是上传授权书方式 |
AutoJumpUrl | String | 否 | 认证完之后的H5页面的跳转链接,最大长度1000个字符。链接类型请参考 跳转电子签H5 |
ReleasedApprover
解除协议的签署人,如不指定,默认使用待解除流程(原流程)中的签署人。
注意
:
- 不支持更换C端(个人身份类型)签署人,如果原流程中含有C端签署人,默认使用原流程中的该签署人。
- 目前不支持替换C端(个人身份类型)签署人,但是可以指定C端签署人的签署方自定义控件别名,具体见参数ApproverSignRole描述。
- 当指定C端签署人的签署方自定义控件别名不空时,除参数ApproverNumber外,可以只传参数ApproverSignRole。
如果需要指定B端(企业身份类型)签署人,其中ReleasedApprover需要传递的参数如下:
(ApproverNumber
, ReleasedApproverRecipientId
这两个二选一), OrganizationName
, ApproverType
必传。
对于其他身份标识:
- 子客企业指定经办人:OpenId必传,OrganizationOpenId必传;
- 非子客企业经办人:Name、Mobile必传。
被如下接口引用:ChannelCreateReleaseFlow。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
ApproverNumber | Integer | 是 | 签署人在原合同签署人列表中的顺序序号(从0开始,按顺序依次递增)。 可以通过DescribeFlowDetailInfo接口查看原流程中的签署人列表。 示例值:0 |
ApproverType | String | 是 | 指定签署人类型,目前支持
示例值:ORGANIZATION |
ReleasedApproverRecipientId | String | 否 | 签署人在原合同中的RecipientId,可以通过DescribeFlowDetailInfo接口查看原流程中的签署人信息,可参考返回结构体FlowApproverDetail中的RecipientId。 注意:当指定了此参数后,ApproverNumber即失效,会以本参数作为原合同参与人的选取。与ApproverNumber二选一。 示例值:yDCb7UUckpwm3x62UEXHVn8B2hB9q8hT |
Name | String | 否 | 签署人姓名,最大长度50个字。 示例值:典子谦 |
IdCardType | String | 否 | 签署方经办人的证件类型,支持以下类型
示例值:ID_CARD |
IdCardNumber | String | 否 | 证件号码,应符合以下规则
示例值:620000198802020000 |
Mobile | String | 否 | 签署人手机号。 示例值:13200000000 |
OrganizationName | String | 否 | 组织机构名称。 请确认该名称与企业营业执照中注册的名称一致。 如果名称中包含英文括号(),请使用中文括号()代替。 如果签署方是企业签署方(approverType = 0 或者 approverType = 3), 则企业名称必填。 示例值:典子谦示例企业 |
OrganizationOpenId | String | 否 | 第三方平台子客企业的唯一标识,定义Agent中的ProxyOrganizationOpenId一样, 可以参考Agent结构体。 当为子客企业指定经办人时,此OrganizationOpenId必传。 示例值:org_dianziqian |
OpenId | String | 否 | 第三方平台子客企业员工的唯一标识,长度不能超过64,只能由字母和数字组成。 当签署方为同一第三方平台下的员工时,此OpenId必传。 示例值:n9527 |
ApproverSignComponentType | String | 否 | 签署控件类型,支持自定义企业签署方的签署控件类型
|
ApproverSignRole | String | 否 | 参与方在合同中的角色是按照创建合同的时候来排序的,解除协议默认会将第一个参与人叫甲方 ,第二个叫乙方 , 第三个叫丙方 ,以此类推。如果需改动此参与人的角色名字,可用此字段指定,由汉字,英文字符,数字组成,最大20个字。 示例值:供应商 |
ApproverSignSealId | String | 否 | 印章Id,签署控件类型为印章时,用于指定本企业签署方在解除协议中使用那个印章进行签署 |
RelieveInfo
解除协议文档中内容信息,包括但不限于:解除理由、解除后仍然有效的条款-保留条款、原合同事项处理-费用结算、原合同事项处理-其他事项、其他约定等。
被如下接口引用:ChannelCreateReleaseFlow。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
Reason | String | 是 | 解除理由,最大支持200个字 示例值:xxx |
RemainInForceItem | String | 否 | 解除后仍然有效的条款,保留条款,最大支持200个字 示例值:xxx |
OriginalExpenseSettlement | String | 否 | 原合同事项处理-费用结算,最大支持200个字 示例值:xxx |
OriginalOtherSettlement | String | 否 | 原合同事项处理-其他事项,最大支持200个字 示例值:xxx |
OtherDeals | String | 否 | 其他约定,最大支持200个字 示例值:xxx |
RemindFlowRecords
催办接口返回的详细信息。
被如下接口引用:ChannelCreateFlowReminds。
名称 | 类型 | 描述 |
---|---|---|
CanRemind | Boolean | 合同流程是否可以催办: true - 可以,false - 不可以。 若无法催办,将返回RemindMessage以解释原因。 示例值:true |
FlowId | String | 合同流程ID,为32位字符串。 示例值:yDwxxxxxxxW72Qaxm |
RemindMessage | String | 在合同流程无法催办的情况下,系统将返回RemindMessage以阐述原因。 示例值:"" |
ResourceUrlInfo
资源链接信息
被如下接口引用:DescribeResourceUrlsByFlows。
名称 | 类型 | 描述 |
---|---|---|
Url | String | 资源链接地址,过期时间5分钟 注意:此字段可能返回 null,表示取不到有效值。 示例值:https://file.test.ess.tencent.cn/file/FLOW/yDwi8UUckpo5fz9cUqI6nGwcuTvt9YSh/0/0.PDF?hkey=70b***99 |
Name | String | 资源名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:合同250151025185515.pdf |
Type | String | 资源类型 注意:此字段可能返回 null,表示取不到有效值。 示例值:PDF |
SignQrCode
签署二维码的基本信息,用于创建二维码,用户可扫描该二维码进行签署操作。
被如下接口引用:ChannelCreateMultiFlowSignQRCode。
名称 | 类型 | 描述 |
---|---|---|
QrCodeId | String | 二维码ID,为32位字符串。 注: 需要保留此二维码ID, 用于后序通过取消一码多扫二维码关闭这个二维码的签署功能。 示例值:PDSLZUUckpooi1ltUxCsD3RSTG9BEWhR |
QrCodeUrl | String | 二维码URL,可通过转换二维码的工具或代码组件将此URL转化为二维码,以便用户扫描进行流程签署。 示例值:https://dyn.test.ess.tencent.cn/imgs/multiSignQrCodes/QrCode/yDSLZUUckpoourf9UE6T6Qd1aK59.png |
ExpiredTime | Integer | 二维码的有截止时间,格式为Unix标准时间戳(秒),可以通过入参的QrEffectiveDay来设置有效期,默认为7天有效期。 一旦超过二维码的有效期限,该二维码将自动失效。 示例值:1693814798 |
SignUrl
流程签署二维码的签署信息,适用于客户系统整合二维码功能。 通过链接,用户可直接访问电子签名小程序并签署合同。
被如下接口引用:ChannelCreateMultiFlowSignQRCode。
名称 | 类型 | 描述 |
---|---|---|
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 |
SignUrlInfo
签署链接内容
被如下接口引用:CreateSignUrls。
名称 | 类型 | 描述 |
---|---|---|
SignUrl | String | 签署链接,过期时间为90天 注:生成的链路后面不能再增加参数(会出现覆盖链接中已有参数导致错误) 注意:此字段可能返回 null,表示取不到有效值。 示例值:https://essurl.cn/hJi85U8ewE |
Deadline | Integer | 合同过期时间戳,单位秒 注意:此字段可能返回 null,表示取不到有效值。 示例值:1706254213 |
SignOrder | Integer | 当流程为顺序签署此参数有效时,数字越小优先级越高,暂不支持并行签署 可选 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
SignId | String | 签署人编号 注意:此字段可能返回 null,表示取不到有效值。 示例值:yDwiBUUckpo27hodUuLiduRyFBtECOgN |
Name | String | 用户姓名 注意:此字段可能返回 null,表示取不到有效值。 示例值:张三 |
Mobile | String | 用户手机号码 注意:此字段可能返回 null,表示取不到有效值。 示例值:18888888888 |
OrganizationName | String | 签署参与者机构名字 注意:此字段可能返回 null,表示取不到有效值。 示例值:张三示例企业 |
ApproverType | String | 参与者类型, 类型如下: ORGANIZATION:企业经办人 PERSON: 自然人 注意:此字段可能返回 null,表示取不到有效值。 示例值:ORGANIZATION |
IdCardNumber | String | 经办人身份证号 注意:此字段可能返回 null,表示取不到有效值。 |
FlowId | String | 签署链接对应流程Id 注意:此字段可能返回 null,表示取不到有效值。 示例值:yDwFmUUckpstqfvzUE1h3jo1f3cqjkGm |
OpenId | String | 企业经办人 用户在渠道的编号 注意:此字段可能返回 null,表示取不到有效值。 示例值:n9527 |
FlowGroupId | String | 合同组签署链接对应的合同组id 注意:此字段可能返回 null,表示取不到有效值。 示例值:yDRS4UUgygqdcj5pUuO4zjEu602GFIe6 |
SignQrcodeUrl | String | 二维码,在生成动态签署人跳转封面页链接时返回 注意:此字段可能返回 null,表示取不到有效值。 示例值:https://file.test.ess.tencent.cn/bresource/resource/resource/0/0.JPG?hkey=5d**2f0db15e6b |
Staff
企业员工信息
被如下接口引用:ChannelDescribeEmployees。
名称 | 类型 | 描述 |
---|---|---|
UserId | String | 员工在电子签平台的用户ID |
DisplayName | String | 显示的员工名 注意:2024-07-08 及之后创建的应用号,该字段返回的是打码信息 |
Mobile | String | 员工手机号 注意:2024-07-08 及之后创建的应用号,该字段返回的是打码信息 |
String | 员工邮箱 注意:此字段可能返回 null,表示取不到有效值。 | |
OpenId | String | 员工在第三方应用平台的用户ID 注意:此字段可能返回 null,表示取不到有效值。 |
Roles | Array of StaffRole | 员工角色 注意:此字段可能返回 null,表示取不到有效值。 |
Department | Department | 员工部门 注意:此字段可能返回 null,表示取不到有效值。 |
Verified | Boolean | 员工是否实名 |
CreatedOn | Integer | 员工创建时间戳,单位秒 |
VerifiedOn | Integer | 员工实名时间戳,单位秒 |
QuiteJob | Integer | 员工是否离职:0-未离职,1-离职 |
StaffRole
第三方应用集成员工角色信息
被如下接口引用:ChannelDescribeEmployees。
名称 | 类型 | 描述 |
---|---|---|
RoleId | String | 角色id 注意:此字段可能返回 null,表示取不到有效值。 |
RoleName | String | 角色名称 注意:此字段可能返回 null,表示取不到有效值。 |
SyncFailReason
同步员工失败原因
被如下接口引用:SyncProxyOrganizationOperators。
名称 | 类型 | 描述 |
---|---|---|
Id | String | 企业员工标识(即OpenId) 示例值:n9725 |
Message | String | 新增员工或者员工离职失败原因, 可能存证ID不符合规范、证件号码不合法等原因 注意:此字段可能返回 null,表示取不到有效值。 示例值:Id不符合规范 |
TaskInfo
复杂文档合成任务的任务信息
被如下接口引用:ChannelCreateFlowGroupByTemplates, CreateFlowsByTemplates。
名称 | 类型 | 描述 |
---|---|---|
TaskId | String | 合成任务Id,可以通过 ChannelGetTaskResultApi 接口获取任务信息 注意:此字段可能返回 null,表示取不到有效值。 示例值:"xxx" |
TaskStatus | String | 任务状态:READY - 任务已完成;NOTREADY - 任务未完成; 注意:此字段可能返回 null,表示取不到有效值。 示例值:NOTREADY |
TemplateInfo
此结构体 (TemplateInfo) 用于描述模板的信息。
模板组成
一个模板通常会包含以下结构信息
- 模板基本信息
- 签署参与方 Recipients,在模板发起合同时用于指定参与方
- 填写控件 Components
- 签署控件 SignComponents
被如下接口引用:DescribeTemplates。
名称 | 类型 | 描述 |
---|---|---|
TemplateId | String | 模板ID,模板的唯一标识 示例值:yDSLKUUckpoqt3vzUP7DfuSBwaJfz7M1 |
TemplateName | String | 模板名 示例值:西红柿采购模板 |
Description | String | 模板描述信息 示例值:2023年西红柿采购模板 |
Components | Array of Component | 模板的填充控件列表 |
Recipients | Array of Recipient | 此模块需要签署的各个参与方的角色列表。RecipientId标识每个参与方角色对应的唯一标识符,用于确定此角色的信息。 |
SignComponents | Array of Component | 此模板中的签署控件列表 |
TemplateType | Integer | 模板类型:1-静默签;3-普通模板 示例值:3 |
Creator | String | 模板的创建者名字 示例值:张三 |
CreatedOn | Integer | 模板创建的时间戳,格式为Unix标准时间戳(秒) 示例值:1699259970 |
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 |
PdfUrl | String | 第三方应用集成-模板PDF文件链接,有效期5分钟。 请求参数WithPdfUrl=true时返回 (此功能开放需要联系客户经理)。 注意:此字段可能返回 null,表示取不到有效值。 |
ChannelTemplateId | String | 本模板关联的第三方应用平台企业模板ID 示例值:yDSLKUUckpoqcjljUyzyvt7xDAq3564r |
ChannelTemplateName | String | 本模板关联的三方应用平台平台企业模板名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:西红柿采购模板 |
ChannelAutoSave | Integer | 0-需要子客企业手动领取平台企业的模板(默认); 1-平台自动设置子客模板 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
TemplateVersion | String | 模板版本,由全数字字符组成。 默认为空,模板版本号由日期和序号组成,初始版本为yyyyMMdd001,yyyyMMdd002表示第二个版本,以此类推。 注意:此字段可能返回 null,表示取不到有效值。 示例值:20231106004 |
Available | Integer | 模板可用状态的取值通常为以下两种:
注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
UploadFile
此结构体 (UploadFile) 用于描述多文件上传的文件信息。
被如下接口引用:UploadFiles。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
FileBody | String | 是 | Base64编码后的文件内容 |
FileName | String | 否 | 文件名,最大长度不超过200字符 |
UsageDetail
用量明细
被如下接口引用:DescribeUsage。
名称 | 类型 | 描述 |
---|---|---|
ProxyOrganizationOpenId | String | 子客企业标识 |
ProxyOrganizationName | String | 子客企业名 注意:此字段可能返回 null,表示取不到有效值。 |
Date | Date | 对应的消耗日期, 如果是汇总数据则为1970-01-01 注意:此字段可能返回 null,表示取不到有效值。 示例值:2021-08-31 |
Usage | Integer | 消耗合同数量 示例值:50 |
Cancel | Integer | 撤回合同数量 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
FlowChannel | String | 消耗渠道 注意:此字段可能返回 null,表示取不到有效值。 示例值:企业版 |
UserInfo
接口调用的员工信息
被如下接口引用:ChannelBatchCancelFlows, ChannelCancelFlow, ChannelCancelMultiFlowSignQRCode, ChannelCancelUserAutoSignEnableUrl, ChannelCreateBatchCancelFlowUrl, ChannelCreateBatchQuickSignUrl, ChannelCreateBatchSignUrl, ChannelCreateBoundFlows, ChannelCreateConvertTaskApi, ChannelCreateEmbedWebUrl, ChannelCreateFlowApprovers, ChannelCreateFlowByFiles, ChannelCreateFlowGroupByFiles, ChannelCreateFlowGroupByTemplates, ChannelCreateFlowReminds, ChannelCreateFlowSignReview, ChannelCreateFlowSignUrl, ChannelCreateMultiFlowSignQRCode, ChannelCreateOrganizationBatchSignUrl, ChannelCreateOrganizationModifyQrCode, ChannelCreatePrepareFlow, ChannelCreatePreparedPersonalEsign, ChannelCreateReleaseFlow, ChannelCreateRole, ChannelCreateSealPolicy, ChannelCreateUserAutoSignEnableUrl, ChannelCreateUserAutoSignSealUrl, ChannelCreateUserRoles, ChannelCreateWebThemeConfig, ChannelDeleteRole, ChannelDeleteRoleUsers, ChannelDeleteSealPolicies, ChannelDescribeAccountBillDetail, ChannelDescribeBillUsageDetail, ChannelDescribeEmployees, ChannelDescribeFlowComponents, ChannelDescribeOrganizationSeals, ChannelDescribeRoles, ChannelDescribeSignFaceVideo, ChannelDescribeUserAutoSignStatus, ChannelDisableUserAutoSign, ChannelGetTaskResultApi, ChannelModifyRole, ChannelRenewAutoSignLicense, ChannelUpdateSealStatus, ChannelVerifyPdf, CreateBatchInitOrganizationUrl, CreateBatchOrganizationRegistrationTasks, CreateChannelFlowEvidenceReport, CreateChannelOrganizationInfoChangeUrl, CreateChannelSubOrganizationActive, CreateCloseOrganizationUrl, CreateConsoleLoginUrl, CreateEmployeeQualificationSealQrCode, CreateFlowBlockchainEvidenceUrl, CreateFlowGroupSignReview, CreateFlowsByTemplates, CreateLegalSealQrCode, CreatePartnerAutoSignAuthUrl, CreatePersonAuthCertificateImage, CreateSealByImage, CreateSignUrls, DeleteOrganizationAuthorizations, DescribeBatchOrganizationRegistrationUrls, DescribeCancelFlowsTask, DescribeChannelFlowEvidenceReport, DescribeChannelOrganizations, DescribeChannelSealPolicyWorkflowUrl, DescribeExtendedServiceAuthDetail, DescribeExtendedServiceAuthInfo, DescribeFlowDetailInfo, DescribeResourceUrlsByFlows, DescribeTemplates, DescribeUsage, GetDownloadFlowUrl, ModifyExtendedService, ModifyFlowDeadline, OperateChannelTemplate, PrepareFlows, SyncProxyOrganization, SyncProxyOrganizationOperators, UploadFiles。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
OpenId | String | 否 | 第三方应用平台自定义,对应第三方平台子客企业员工的唯一标识。 注意: 1. OpenId在子客企业对应一个真实员工,本应用唯一, 不可重复使用,最大64位字符串 2. 可使用用户在贵方企业系统中的Userid或者hash值作为子客企业的员工OpenId 3. 员工加入企业后, 可以通过生成子客登录链接登录子客控制台后, 在组织架构模块查看员工们的OpenId, 样式如下图 |
UserThreeFactor
用户的三要素:姓名,证件号,证件类型
被如下接口引用:ChannelCancelUserAutoSignEnableUrl, ChannelCreateUserAutoSignEnableUrl, ChannelCreateUserAutoSignSealUrl, ChannelDescribeUserAutoSignStatus, ChannelDisableUserAutoSign, ChannelRenewAutoSignLicense。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
Name | String | 是 | 签署方经办人的姓名。 经办人的姓名将用于身份认证和电子签名,请确保填写的姓名为签署方的真实姓名,而非昵称等代名。 示例值:小明 |
IdCardType | String | 是 | 证件类型,支持以下类型
示例值:ID_CARD |
IdCardNumber | String | 是 | 证件号码,应符合以下规则
示例值:620000198802020000 |
WebThemeConfig
主题配置
被如下接口引用:ChannelCreateWebThemeConfig。
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
DisplaySignBrandLogo | Boolean | 否 | 是否显示页面底部电子签logo,取值如下:
示例值:true |
WebEmbedThemeColor | String | 否 | 主题颜色: 支持十六进制颜色值以及RGB格式颜色值,例如:#D54941,rgb(213, 73, 65) 示例值:#D54941 |
AuthenticateBackground | String | 否 | 企业认证页背景图(base64图片) |
HideAuthenticateNavigationBar | Boolean | 否 | 隐藏企业认证页面导航栏,取值如下:
示例值:true |
HideAuthenticateTopLogo | Boolean | 否 | 隐藏企业认证顶部logo,取值如下:
示例值:true |