跳到主要内容

数据结构

Admin

企业超管信息

被如下接口引用:DescribeOrganizationGroupOrganizations。

名称类型描述
NameString超管名
注意:此字段可能返回 null,表示取不到有效值。
MobileString超管手机号,打码显示
示例值:138****1569

注意:此字段可能返回 null,表示取不到有效值。

Agent

代理相关应用信息,如集团主企业代子企业操作

被如下接口引用:BindEmployeeUserIdWithClientOpenId, CancelFlow, CancelMultiFlowSignQRCode, CancelUserAutoSignEnableUrl, CreateBatchCancelFlowUrl, CreateBatchSignUrl, CreateConvertTaskApi, CreateDocument, CreateEmbedWebUrl, CreateFlow, CreateFlowApprovers, CreateFlowByFiles, CreateFlowEvidenceReport, CreateFlowGroupByFiles, CreateFlowGroupByTemplates, CreateFlowReminds, CreateFlowSignReview, CreateFlowSignUrl, CreateIntegrationDepartment, CreateIntegrationEmployees, CreateIntegrationRole, CreateIntegrationUserRoles, CreateMultiFlowSignQRCode, CreateOrganizationBatchSignUrl, CreateOrganizationInfoChangeUrl, CreatePersonAuthCertificateImage, CreatePrepareFlow, CreatePreparedPersonalEsign, CreateReleaseFlow, CreateSchemeUrl, CreateSeal, CreateSealPolicy, CreateUserAutoSignEnableUrl, CreateWebThemeConfig, DeleteIntegrationDepartment, DeleteIntegrationEmployees, DeleteIntegrationRoleUsers, DeleteSealPolicies, DescribeExtendedServiceAuthInfos, DescribeFileUrls, DescribeFlowBriefs, DescribeFlowComponents, DescribeFlowEvidenceReport, DescribeFlowInfo, DescribeFlowTemplates, DescribeIntegrationDepartments, DescribeIntegrationEmployees, DescribeIntegrationRoles, DescribeOrganizationSeals, DescribePersonCertificate, DescribeThirdPartyAuthCode, DescribeUserAutoSignStatus, DisableUserAutoSign, GetTaskResultApi, ModifyApplicationCallbackInfo, ModifyIntegrationDepartment, ModifyIntegrationRole, StartFlow, UnbindEmployeeUserIdWithClientOpenId, UpdateIntegrationEmployees, UploadFiles, VerifyPdf。

名称类型必选描述
ProxyOrganizationIdString被代理机构在电子签平台的机构编号,集团代理下场景必传

ApproverComponentLimitType

签署方在使用个人印章签署控件(SIGN_SIGNATURE) 时可使用的签署方式

被如下接口引用:CreateMultiFlowSignQRCode。

名称类型必选描述
RecipientIdString签署方经办人在模板中配置的参与方ID,与控件绑定,是控件的归属方,ID为32位字符串。
ValuesArray of String签署方经办人控件类型是个人印章签署控件(SIGN_SIGNATURE) 时,可选的签名方式,可多选

签名方式:

  • HANDWRITE-手写签名
  • ESIGN-个人印章类型
  • OCR_ESIGN-AI智能识别手写签名
  • SYSTEM_ESIGN-系统签名

ApproverInfo

参与者信息。

被如下接口引用:CreateFlowByFiles, CreateFlowGroupByFiles, CreateFlowGroupByTemplates。

名称类型必选描述
ApproverTypeInteger在指定签署方时,可选择企业B端或个人C端等不同的参与者类型,可选类型如下:
0:企业
1:个人
3:企业静默签署
注:类型为3(企业静默签署)时,此接口会默认完成该签署方的签署。静默签署仅进行盖章操作,不能自动签名。
7: 个人自动签署,适用于个人自动签场景。
注: 个人自动签场景为白名单功能,使用前请联系对接的客户经理沟通。
ApproverNameString签署方经办人的姓名。
经办人的姓名将用于身份认证和电子签名,请确保填写的姓名为签署方的真实姓名,而非昵称等代名。
ApproverMobileString签署方经办人手机号码, 支持国内手机号11位数字(无需加+86前缀或其他字符)。
请确认手机号所有方为此合同签署方。
OrganizationNameString组织机构名称。
请确认该名称与企业营业执照中注册的名称一致。
如果名称中包含英文括号(),请使用中文括号()代替。
如果签署方是企业签署方(approverType = 0 或者 approverType = 3), 则企业名称必填。
SignComponentsArray of Component合同中的签署控件列表,列表中可支持下列多种签署控件,控件的详细定义参考开发者中心的Component结构体
  • 个人签名/印章
  • 企业印章
  • 骑缝章等签署控件
ApproverIdCardTypeString签署方经办人的证件类型,支持以下类型
  • ID_CARD 居民身份证 (默认值)
  • HONGKONG_AND_MACAO 港澳居民来往内地通行证
  • HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证(格式同居民身份证)
  • OTHER_CARD_TYPE 其他证件


注: 其他证件类型为白名单功能,使用前请联系对接的客户经理沟通。
示例值:ID_CARD
ApproverIdCardNumberString签署方经办人的证件号码,应符合以下规则
  • 居民身份证号码应为18位字符串,由数字和大写字母X组成(如存在X,请大写)。
  • 港澳居民来往内地通行证号码应为9位字符串,第1位为“C”,第2位为英文字母(但“I”、“O”除外),后7位为阿拉伯数字。
  • 港澳台居民居住证号码编码规则与中国大陆身份证相同,应为18位字符串。

示例值:xxx
NotifyTypeString通知签署方经办人的方式, 有以下途径:
  • sms : (默认)短信
  • none : 不通知

示例值:sms
ApproverRoleInteger收据场景设置签署人角色类型, 可以设置如下**类型**:
  • 1 :收款人
  • 2 :开具人
  • 3 :见证人

注: 收据场景为白名单功能,使用前请联系对接的客户经理沟通。
示例值:1
ApproverRoleNameString自定义签署人角色名:收款人、开具人、见证人
示例值:string
VerifyChannelArray of String签署意愿确认渠道,默认为WEIXINAPP:人脸识别

注: 将要废弃, 用ApproverSignTypes签署人签署合同时的认证方式代替, 新客户可请用ApproverSignTypes来设置
示例值:["WEIXINAPP"]
PreReadTimeInteger签署方在签署合同之前,需要强制阅读合同的时长,可指定为3秒至300秒之间的任意值。

若未指定阅读时间,则会按照合同页数大小计算阅读时间,计算规则如下:
  • 合同页数少于等于2页,阅读时间为3秒;
  • 合同页数为3到5页,阅读时间为5秒;
  • 合同页数大于等于6页,阅读时间为10秒。

示例值:3
UserIdString签署人userId,仅支持本企业的员工userid, 可在控制台组织管理处获得

注: 若传此字段 则以userid的信息为主,会覆盖传递过来的签署人基本信息, 包括姓名,手机号,证件类型等信息
ApproverSourceString在企微场景下使用,需设置参数为WEWORKAPP,以表明合同来源于企微。
CustomApproverTagString在企业微信场景下,表明该合同流程为或签,其最大长度为64位字符串。
所有参与或签的人员均需具备该标识。
注意,在合同中,不同的或签参与人必须保证其CustomApproverTag唯一。
如果或签签署人为本方企业微信参与人,则需要指定ApproverSource参数为WEWORKAPP。
ApproverOptionApproverOption可以控制签署方在签署合同时能否进行某些操作,例如拒签、转交他人等。
详细操作可以参考开发者中心的ApproverOption结构体。
ApproverVerifyTypesArray of Integer指定个人签署方查看合同的校验方式,可以传值如下:
  • 1 : (默认)人脸识别,人脸识别后才能合同内容
  • 2 : 手机号验证, 用户手机号和参与方手机号(ApproverMobile)相同即可查看合同内容(当手写签名方式为OCR_ESIGN时,该校验方式无效,因为这种签名方式依赖实名认证)

注:
  • 如果合同流程设置ApproverVerifyType查看合同的校验方式, 则忽略此签署人的查看合同的校验方式
  • 此字段不可传多个校验方式

示例值:[1,2]
ApproverSignTypesArray of Integer您可以指定签署方签署合同的认证校验方式,可传递以下值:
  • 1:人脸认证,需进行人脸识别成功后才能签署合同;
  • 2:签署密码,需输入与用户在腾讯电子签设置的密码一致才能校验成功进行合同签署;
  • 3:运营商三要素,需到运营商处比对手机号实名信息(名字、手机号、证件号)校验一致才能成功进行合同签署。

注:
  • 默认情况下,认证校验方式为人脸认证和签署密码两种形式;
  • 您可以传递多种值,表示可用多种认证校验方式。

示例值:[1,2,3]
ApproverNeedSignReviewBoolean发起方企业的签署人进行签署操作前,是否需要企业内部走审批流程,取值如下:
  • false:(默认)不需要审批,直接签署。
  • true:需要走审批流程。当到对应参与人签署时,会阻塞其签署操作,等待企业内部审批完成。

企业可以通过CreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果
  • 如果企业通知腾讯电子签平台审核通过,签署方可继续签署动作。
  • 如果企业通知腾讯电子签平台审核未通过,平台将继续阻塞签署方的签署动作,直到企业通知平台审核通过。


注:此功能可用于与企业内部的审批流程进行关联,支持手动、静默签署合同
AddSignComponentsLimitsArray of ComponentLimit用PDF文件创建签署流程时,如果设置了外层参数SignBeanTag=1(允许签署过程中添加签署控件),则可通过此参数明确规定合同所使用的签署控件类型(骑缝章、普通章法人章等)和具体的印章(印章ID)或签名方式。

注:限制印章控件或骑缝章控件情况下,仅本企业签署方可以指定具体印章(通过传递ComponentValue,支持多个),他方企业或个人只支持限制控件类型。

ApproverItem

签署方信息,发起合同后可获取到对应的签署方信息,如角色ID,角色名称

被如下接口引用:CreateDocument, CreateFlowByFiles。

名称类型描述
SignIdString签署方唯一编号
注意:此字段可能返回 null,表示取不到有效值。
RecipientIdString签署方角色编号
注意:此字段可能返回 null,表示取不到有效值。
ApproverRoleNameString签署方角色名称
注意:此字段可能返回 null,表示取不到有效值。

ApproverOption

签署人个性化能力信息

被如下接口引用:CreateFlow, CreateFlowByFiles, CreateFlowGroupByFiles, CreateFlowGroupByTemplates, CreateFlowSignUrl, CreatePrepareFlow。

名称类型必选描述
NoRefuseBoolean签署方是否可以拒签

  • false : ( 默认)可以拒签
  • true :不可以拒签

示例值:true
NoTransferBoolean签署方是否可以转他人处理

  • false : ( 默认)可以转他人处理
  • true :不可以转他人处理

示例值:true
FillTypeInteger签署人信息补充类型,默认无需补充。

  • 1 : ( 动态签署人(可发起合同后再补充签署人信息)

ApproverRestriction

指定签署人限制项

被如下接口引用:CreateMultiFlowSignQRCode。

名称类型必选描述
NameString指定签署人名字
示例值:张三
MobileString指定签署人手机号,11位数字
示例值:13000000000
IdCardTypeString指定签署人证件类型,ID_CARD-身份证
示例值:ID_CARD
IdCardNumberString指定签署人证件号码,字母大写
示例值:4500000000000000000

AuthorizedUser

授权用户

被如下接口引用:DescribeOrganizationSeals。

名称类型描述
UserIdString电子签系统中的用户id

AutoSignConfig

自动签开启、签署相关配置

被如下接口引用:CreateUserAutoSignEnableUrl。

名称类型必选描述
UserInfoUserThreeFactor自动签开通个人用户信息, 包括名字,身份证等
CertInfoCallbackBoolean是否回调证书信息:
  • false: 不需要(默认)
  • true:需要
UserDefineSealBoolean是否支持用户自定义签名印章:
  • false: 不能自己定义(默认)
  • true: 可以自己定义
SealImgCallbackBoolean回调中是否需要自动签将要使用的印章(签名) 图片的 base64:
  • false: 不需要(默认)
  • true: 需要
VerifyChannelsArray of String开通时候的身份验证方式, 取值为:
  • WEIXINAPP : 微信人脸识别
  • INSIGHT : 慧眼人脸认别
  • TELECOM : 运营商三要素验证

注:
  • 如果是小程序开通链接,支持传 WEIXINAPP / TELECOM。为空默认 WEIXINAPP
  • 如果是 H5 开通链接,支持传 INSIGHT / TELECOM。为空默认 INSIGHT
LicenseTypeInteger设置用户开通自动签时是否绑定个人自动签账号许可。

  • 0: (默认) 使用个人自动签账号许可进行开通,个人自动签账号许可有效期1年,注: 不可解绑释放更换他人

CallbackInfo

企业应用回调信息

被如下接口引用:ModifyApplicationCallbackInfo。

名称类型必选描述
CallbackUrlString回调url,。请确保回调地址能够接收并处理 HTTP POST 请求,并返回状态码 200 以表示处理正常。
示例值:http://123.com
CallbackKeyString回调加密key,用于回调消息加解密。
示例值:xxxxx
CallbackTokenString回调验签token,用于回调通知校验。
示例值:xxxxx

Caller

此结构体 (Caller) 用于描述调用方属性。

被如下接口引用:UploadFiles。

名称类型必选描述
OperatorIdString经办人的用户ID,同UserId
示例值:88fb0c591044be771f60aa382cc5ed0e

CcInfo

抄送信息

被如下接口引用:CreateFlow, CreateFlowByFiles。

名称类型必选描述
MobileString被抄送方手机号码, 支持国内手机号11位数字(无需加+86前缀或其他字符)。
请确认手机号所有方为此业务通知方。
示例值:xxx
NameString被抄送方姓名。
抄送方的姓名将用于身份认证,请确保填写的姓名为抄送方的真实姓名,而非昵称等代名。
示例值:李白
CcTypeInteger被抄送方类型, 可设置以下类型:
  • 0 :个人抄送方
  • 1 :企业员工抄送方

示例值:1
CcPermissionInteger被抄送方权限, 可设置如下权限:
  • 0 :可查看合同内容
  • 1 :可查看合同内容也可下载原文

示例值:1
NotifyTypeString通知签署方经办人的方式, 有以下途径:
  • sms : (默认)短信
  • none : 不通知

示例值:sms

Component

模板/流程中控件信息,可以是填充控件或签署控件

被如下接口引用:CreateFlow, CreateFlowByFiles, CreateFlowGroupByFiles, CreateFlowGroupByTemplates, CreateFlowSignUrl, CreatePrepareFlow, DescribeFlowTemplates。

名称类型必选描述
ComponentTypeString如果是Component填写控件类型,则可选的字段为:
TEXT - 普通文本控件,输入文本字符串;
MULTI_LINE_TEXT - 多行文本控件,输入文本字符串;
CHECK_BOX - 勾选框控件,若选中填写ComponentValue 填写 true或者 false 字符串;
FILL_IMAGE - 图片控件,ComponentValue 填写图片的资源 ID;
DYNAMIC_TABLE - 动态表格控件;
ATTACHMENT - 附件控件,ComponentValue 填写附件图片的资源 ID列表,以逗号分隔;
SELECTOR - 选择器控件,ComponentValue填写选择的字符串内容;
DATE - 日期控件;默认是格式化为xxxx年xx月xx日字符串;
DISTRICT - 省市区行政区控件,ComponentValue填写省市区行政区字符串内容;

如果是SignComponent签署控件类型,则可选的字段为
SIGN_SEAL - 签署印章控件;
SIGN_DATE - 签署日期控件;
SIGN_SIGNATURE - 用户签名控件;
SIGN_PERSONAL_SEAL - 个人签署印章控件(使用文件发起暂不支持此类型);
SIGN_PAGING_SEAL - 骑缝章;若文件发起,需要对应填充ComponentPosY、ComponentWidth、ComponentHeight
SIGN_OPINION - 签署意见控件,用户需要根据配置的签署意见内容,完成对意见内容的确认;
SIGN_LEGAL_PERSON_SEAL - 企业法定代表人控件。

表单域的控件不能作为印章和签名控件
FileIndexInteger控件所属文件的序号(取值为:0-N)。
目前单文件的情况下,值是0
ComponentHeightFloat参数控件高度,单位pt
ComponentWidthFloat参数控件宽度,单位pt
ComponentPageInteger参数控件所在页码,取值为:1-N
ComponentPosXFloat参数控件X位置,单位pt
ComponentPosYFloat参数控件Y位置,单位pt
ComponentIdString控件唯一ID。
或使用文件发起合同时用于GenerateMode==KEYWORD 指定关键字
ComponentNameString控件名。
或使用文件发起合同时用于GenerateMode==FIELD 指定表单域名称
ComponentRequiredBoolean是否必选,默认为false-非必选
ComponentRecipientIdString控件关联的参与方ID,对应Recipient结构体中的RecipientId
ComponentExtraString扩展参数:
为JSON格式。

ComponentType为FILL_IMAGE时,支持以下参数:
NotMakeImageCenter:bool。是否设置图片居中。false:居中(默认)。 true: 不居中
FillMethod: int. 填充方式。0-铺满(默认);1-等比例缩放

ComponentType为SIGN_SIGNATURE类型可以控制签署方式
{“ComponentTypeLimit”: [“xxx”]}
xxx可以为:
HANDWRITE – 手写签名
OCR_ESIGN -- AI智能识别手写签名
ESIGN -- 个人印章类型
SYSTEM_ESIGN -- 系统签名(该类型可以在用户签署时根据用户姓名一键生成一个签名来进行签署)
如:{“ComponentTypeLimit”: [“SYSTEM_ESIGN”]}

ComponentType为SIGN_DATE时,支持以下参数:
1 Font:字符串类型目前只支持"黑体"、"宋体",如果不填默认为"黑体"
2 FontSize: 数字类型,范围6-72,默认值为12
3 FontAlign: 字符串类型,可取Left/Right/Center,对应左对齐/居中/右对齐
4 Format: 字符串类型,日期格式,必须是以下五种之一 “yyyy m d”,”yyyy年m月d日”,”yyyy/m/d”,”yyyy-m-d”,”yyyy.m.d”。
5 Gaps:: 字符串类型,仅在Format为“yyyy m d”时起作用,格式为用逗号分开的两个整数,例如”2,2”,两个数字分别是日期格式的前后两个空隙中的空格个数
如果extra参数为空,默认为”yyyy年m月d日”格式的居中日期
特别地,如果extra中Format字段为空或无法被识别,则extra参数会被当作默认值处理(Font,FontSize,Gaps和FontAlign都不会起效)
参数样例: "ComponentExtra": "{\"Format\":“yyyy m d”,\"FontSize\":12,\"Gaps\":\"2,2\", \"FontAlign\":\"Right\"}"

ComponentType为SIGN_SEAL类型时,支持以下参数:
1.PageRanges:PageRange的数组,通过PageRanges属性设置该印章在PDF所有页面上盖章(适用于标书在所有页面盖章的情况)
参数样例:"ComponentExtra":"{\"PageRanges\":[{\"BeginPage\":1,\"EndPage\":-1}]}"
IsFormTypeBoolean是否是表单域类型,默认false-不是
注意:此字段可能返回 null,表示取不到有效值。
ComponentValueString控件填充vaule,ComponentType和传入值类型对应关系:
TEXT - 文本内容
MULTILINE_TEXT - 文本内容
CHECK_BOX - true/false
FILL_IMAGE、ATTACHMENT - 附件的FileId,需要通过UploadFiles接口上传获取
SELECTOR - 选项值
DYNAMIC_TABLE - 传入json格式的表格内容,具体见数据结构FlowInfo:https://cloud.tencent.com/document/api/1420/61525#FlowInfo
DATE - 默认是格式化为xxxx年xx月xx日
SIGN_SEAL - 印章ID,于控制台查询获取
SIGN_PAGING_SEAL - 可以指定印章ID,于控制台查询获取

控件值约束说明:
企业全称控件:
约束:企业名称中文字符中文括号
检查正则表达式:/^[\u3400-\u4dbf\u4e00-\u9fa5()]+$/

统一社会信用代码控件:
检查正则表达式:/^[A-Z0-9]{1,18}$/

法人名称控件:
约束:最大50个字符,2到25个汉字或者1到50个字母
检查正则表达式:/^([\u3400-\u4dbf\u4e00-\u9fa5.·]{2,25}|[a-zA-Z·,\s-]{1,50})$/

签署意见控件:
约束:签署意见最大长度为50字符

签署人手机号控件:
约束:国内手机号 13,14,15,16,17,18,19号段长度11位

签署人身份证控件:
约束:合法的身份证号码检查

控件名称:
约束:控件名称最大长度为20字符

单行文本控件:
约束:只允许输入中文,英文,数字,中英文标点符号

多行文本控件:
约束:只允许输入中文,英文,数字,中英文标点符号

勾选框控件:
约束:选择填字符串true,不选填字符串false

选择器控件:
约束:同单行文本控件约束,填写选择值中的字符串

数字控件:
约束:请输入有效的数字(可带小数点)
检查正则表达式:/^(-|+)?\d+(.\d+)?$/

日期控件:
约束:格式:yyyy年mm月dd日

附件控件:
约束:JPG或PNG图片,上传数量限制,1到6个,最大6个附件

图片控件:
约束:JPG或PNG图片,填写上传的图片资源ID

邮箱控件:
约束:请输入有效的邮箱地址, w3c标准
检查正则表达式:/^([A-Za-z0-9
-.!#$%&])+@([A-Za-z0-9_-.])+.([A-Za-z]{2,4})$/
参考:https://emailregex.com/

地址控件:
同单行文本控件约束

省市区控件:
同单行文本控件约束

性别控件:
同单行文本控件约束,填写选择值中的字符串

学历控件:
同单行文本控件约束,填写选择值中的字符串
GenerateModeStringNORMAL 正常模式,使用坐标制定签署控件位置
FIELD 表单域,需使用ComponentName指定表单域名称
KEYWORD 关键字,使用ComponentId指定关键字
ComponentDateFontSizeInteger日期签署控件的字号,默认为 12
ChannelComponentIdString第三方应用集成平台模板控件 ID 标识
OffsetXFloat指定关键字时横坐标偏移量,单位pt
注意:此字段可能返回 null,表示取不到有效值。
OffsetYFloat指定关键字时纵坐标偏移量,单位pt
注意:此字段可能返回 null,表示取不到有效值。
ChannelComponentSourceInteger第三方应用集成中子客企业控件来源。
0-平台指定;
1-用户自定义
KeywordOrderString指定关键字排序规则,Positive-正序,Reverse-倒序。
传入Positive时会根据关键字在PDF文件内的顺序进行排列。在指定KeywordIndexes时,0代表在PDF内查找内容时,查找到的第一个关键字。
传入Reverse时会根据关键字在PDF文件内的反序进行排列。在指定KeywordIndexes时,0代表在PDF内查找内容时,查找到的最后一个关键字。
示例值:Positive\Reverse
KeywordPageInteger指定关键字页码。
指定页码后,将只在指定的页码内查找关键字,非该页码的关键字将不会查询出来
RelativeLocationString关键字位置模式,
Middle-居中,
Below-正下方,
Right-正右方,
LowerRight-右上角,
UpperRight-右下角。
示例:如果设置Middle的关键字盖章,则印章的中心会和关键字的中心重合,如果设置Below,则印章在关键字的正下方
KeywordIndexesArray of Integer关键字索引。
如果一个关键字在PDF文件中存在多个,可以通过关键字索引指定使用第几个关键字作为最后的结果,可指定多个索引。
示例:[0,2],说明使用PDF文件内第1个和第3个关键字位置。
LockComponentValueBoolean是否锁定控件值不允许编辑(嵌入式发起使用)

默认false:不锁定控件值,允许在页面编辑控件值
注意:此字段可能返回 null,表示取不到有效值。
ForbidMoveAndDeleteBoolean是否禁止移动和删除控件

默认false,不禁止移动和删除控件
注意:此字段可能返回 null,表示取不到有效值。

ComponentLimit

签署控件的类型和范围限制条件,用于控制文件发起后签署人拖拽签署区时可使用的控件类型和具体的印章或签名方式。

被如下接口引用:CreateFlowByFiles, CreateFlowGroupByFiles, CreateFlowGroupByTemplates。

名称类型必选描述
ComponentTypeString控件类型,支持以下类型
  • SIGN_SEAL : 印章控件
  • SIGN_PAGING_SEAL : 骑缝章控件
  • SIGN_LEGAL_PERSON_SEAL : 企业法定代表人控件
  • SIGN_SIGNATURE : 用户签名控件
ComponentValueArray of String签署控件类型的值(可选),用与限制签署时印章或者签名的选择范围

1.当ComponentType 是 SIGN_SEAL 或者 SIGN_PAGING_SEAL 时可传入企业印章Id(支持多个)

2.当ComponentType 是 SIGN_SIGNATURE 时可传入以下类型(支持多个)

  • HANDWRITE : 手写签名
  • OCR_ESIGN : OCR印章(智慧手写签名)
  • ESIGN : 个人印章
  • SYSTEM_ESIGN : 系统印章


3.当ComponentType 是 SIGN_LEGAL_PERSON_SEAL 时无需传递此参数。

CreateFlowOption

创建合同个性化参数

被如下接口引用:CreatePrepareFlow。

名称类型必选描述
CanEditFlowBoolean是否允许修改发起合同时确认弹窗的合同信息(合同名称、合同类型、签署截止时间),若不允许编辑,则表单字段将被禁止输入。

true:允许编辑
false:不允许编辑(默认值)

示例值:true
CanEditFormFieldBoolean是否允许编辑模板控件

true:允许编辑模板控件信息

false:不允许编辑模板控件信息(默认值)


示例值:true
HideShowFlowNameBoolean发起页面隐藏合同名称展示

true:发起页面隐藏合同名称展示

false:发起页面不隐藏合同名称展示(默认值)


示例值:true
HideShowFlowTypeBoolean发起页面隐藏合同类型展示

true:发起页面隐藏合同类型展示

false:发起页面不隐藏合同类型展示(默认值)



示例值:true
HideShowDeadlineBoolean发起页面隐藏合同截止日期展示

true:发起页面隐藏合同截止日期展示

false:发起页面不隐藏合同截止日期展示(默认值)


示例值:true
CanSkipAddApproverBoolean发起页面允许跳过添加签署人环节

true:发起页面允许跳过添加签署人环节

false:发起页面不允许跳过添加签署人环节(默认值)



示例值:true
SkipUploadFileBoolean文件发起页面跳过文件上传步骤

true:文件发起页面跳过文件上传步骤

false:文件发起页面不跳过文件上传步骤(默认值)


示例值:true
ForbidEditFillComponentBoolean禁止编辑填写控件

true:禁止编辑填写控件

false:允许编辑填写控件(默认值)


示例值:true
CustomCreateFlowDescriptionString定制化发起合同弹窗的描述信息,描述信息最长500字符

示例值:""

CreateStaffResult

创建员工的结果

被如下接口引用:CreateIntegrationEmployees。

名称类型描述
SuccessEmployeeDataArray of SuccessCreateStaffData创建员工的成功列表
注意:此字段可能返回 null,表示取不到有效值。
FailedEmployeeDataArray of FailedCreateStaffData创建员工的失败列表
注意:此字段可能返回 null,表示取不到有效值。

DeleteStaffsResult

删除员工结果

被如下接口引用:DeleteIntegrationEmployees。

名称类型描述
SuccessEmployeeDataArray of SuccessDeleteStaffData删除员工的成功数据
注意:此字段可能返回 null,表示取不到有效值。
FailedEmployeeDataArray of FailedDeleteStaffData删除员工的失败数据
注意:此字段可能返回 null,表示取不到有效值。

Department

集成版员工部门信息。

被如下接口引用:CreateIntegrationEmployees, DeleteIntegrationEmployees, DescribeIntegrationEmployees, UpdateIntegrationEmployees。

名称类型必选描述
DepartmentIdString部门ID。
示例值:dp**155f2
DepartmentNameString部门名称。
示例值:测试部门

EmbedUrlOption

个性化参数

被如下接口引用:CreateEmbedWebUrl。

名称类型必选描述
ShowFlowDetailComponentBoolean合同详情预览,允许展示控件信息

true:允许在合同详情页展示控件

false:不允许在合同详情页展示控件

默认false,合同详情页不展示控件
示例值:true
ShowTemplateComponentBoolean模板预览,允许展示模板控件信息

true:允许在模板预览页展示控件

false:不允许在模板预览页展示控件

默认false,模板预览页不展示控件
示例值:true

ExtendAuthInfo

扩展服务开通和授权的详细信息

被如下接口引用:DescribeExtendedServiceAuthInfos。

名称类型必选描述
TypeString扩展服务的类型,可能是以下值:
  • OPEN_SERVER_SIGN:企业静默签署
  • OVERSEA_SIGN:企业与港澳台居民签署合同
  • MOBILE_CHECK_APPROVER:使用手机号验证签署方身份
  • PAGING_SEAL:骑缝章
  • BATCH_SIGN:批量签署

示例值:BATCH_SIGN
NameString扩展服务的名称
示例值:批量签署
StatusString扩展服务的开通状态:
ENABLE:开通
DISABLE:未开通
示例值:ENABLE
OperatorUserIdString操作扩展服务的操作人UserId,员工在腾讯电子签平台的唯一身份标识,为32位字符串。
注意:此字段可能返回 null,表示取不到有效值。
示例值:yDR****CLU
OperateOnInteger扩展服务的操作时间,格式为Unix标准时间戳(秒)。
注意:此字段可能返回 null,表示取不到有效值。
示例值:1693557098
HasAuthUserListArray of HasAuthUser该扩展服务若可以授权,此参数对应授权人员的列表
注意:此字段可能返回 null,表示取不到有效值。

FailedCreateRoleData

绑定角色失败信息

被如下接口引用:CreateIntegrationUserRoles。

名称类型描述
UserIdString用户userId
注意:此字段可能返回 null,表示取不到有效值。
RoleIdsArray of String角色id列表
注意:此字段可能返回 null,表示取不到有效值。

FailedCreateStaffData

创建员工的失败数据

被如下接口引用:CreateIntegrationEmployees。

名称类型描述
DisplayNameString员工名
MobileString员工手机号
WeworkOpenIdString传入的企微账号id
ReasonString失败原因

FailedDeleteStaffData

删除员工失败数据

被如下接口引用:DeleteIntegrationEmployees。

名称类型描述
UserIdString员工在电子签的userId
注意:此字段可能返回 null,表示取不到有效值。
OpenIdString员工在第三方平台的openId
注意:此字段可能返回 null,表示取不到有效值。
ReasonString失败原因

FailedUpdateStaffData

更新员工信息失败返回的数据信息

被如下接口引用:UpdateIntegrationEmployees。

名称类型描述
DisplayNameString用户传入的名称
MobileString用户传入的手机号,明文展示
ReasonString失败原因
UserIdString员工在腾讯电子签平台的唯一身份标识,为32位字符串。
可登录腾讯电子签控制台,在 "更多能力"->"组织管理" 中查看某位员工的UserId(在页面中展示为用户ID)。
OpenIdString员工在第三方平台的openId

FileInfo

模板中文件的信息结构

被如下接口引用:DescribeFlowTemplates。

名称类型必选描述
FileIdString文件ID
FileNameString文件名
FileSizeInteger文件大小,单位为Byte
CreatedOnInteger文件上传时间,格式为Unix标准时间戳(秒)

FileUrl

下载文件的URL信息

被如下接口引用:DescribeFileUrls。

名称类型描述
UrlString下载文件的URL,有效期为输入的UrlTtl,默认5分钟
OptionString下载文件的附加信息。如果是pdf文件,会返回pdf文件每页的有效高宽
注意:此字段可能返回 null,表示取不到有效值。

FillApproverInfo

补充签署人信息

  • RecipientId 必须指定
  • 通过企业微信自定义账号ID补充签署人时,ApproverSource 和 CustomUserId 必填,ApproverSource取值:WEWORKAPP
  • 通过二要素(姓名/手机号)补充签署人时,ApproverName 和 ApproverMobile 必填,ApproverSource设置为空

被如下接口引用:CreateFlowApprovers。

名称类型必选描述
RecipientIdString签署方经办人在模板中配置的参与方ID,与控件绑定,是控件的归属方,ID为32位字符串。
模板发起合同时,该参数为必填项。
文件发起合同是,该参数无需传值。
如果开发者后序用合同模板发起合同,建议保存此值,在用合同模板发起合同中需此值绑定对应的签署经办人 。
示例值:yDwhSUUckp3lqxlpUu6Ni3SvjJPoxxxx
ApproverSourceString签署人来源
WEWORKAPP: 企业微信

仅【企微或签】时指定WEWORKAPP
示例值:WEWORKAPP
CustomUserIdString企业微信UserId

当ApproverSource为WEWORKAPP的企微或签场景下,必须指企业自有应用获取企业微信的UserId
示例值:zhangsan
ApproverNameString补充企业签署人员工姓名
示例值:张三
ApproverMobileString补充企业签署人员工手机号
示例值:188xxxxxxxx
OrganizationNameString补充企业动态签署人时,需要指定对应企业名称

FilledComponent

文档内的填充控件返回结构体,返回控件的基本信息和填写内容值

被如下接口引用:DescribeFlowComponents。

名称类型描述
ComponentIdString控件Id
注意:此字段可能返回 null,表示取不到有效值。
ComponentNameString控件名称
注意:此字段可能返回 null,表示取不到有效值。
ComponentFillStatusString控件填写状态;0-未填写;1-已填写
注意:此字段可能返回 null,表示取不到有效值。
ComponentValueString控件填写内容
注意:此字段可能返回 null,表示取不到有效值。
ComponentRecipientIdString控件所属参与方Id
注意:此字段可能返回 null,表示取不到有效值。
ImageUrlString图片填充控件下载链接,如果是图片填充控件时,这里返回图片的下载链接。
注意:此字段可能返回 null,表示取不到有效值。

Filter

查询过滤条件

被如下接口引用:DescribeFlowTemplates, DescribeIntegrationEmployees, DescribeIntegrationRoles。

名称类型必选描述
KeyString查询过滤条件的Key
ValuesArray of String查询过滤条件的Value列表

FlowApproverDetail

签署人详情信息

被如下接口引用:DescribeFlowInfo。

名称类型描述
ApproveMessageString签署时的相关信息
注意:此字段可能返回 null,表示取不到有效值。
ApproveNameString签署方姓名
ApproveStatusInteger签署方的签署状态
0:还没有发起
1:流程中 没有开始处理
2:待签署
3:已签署
4:已拒绝
5:已过期
6:已撤销
7:还没有预发起
8:待填写
9:因为各种原因而终止
10:填写完成
15:已解除
19:转他人处理
ReceiptIdString模板配置中的参与方ID,与控件绑定
CustomUserIdString客户自定义的用户ID
注意:此字段可能返回 null,表示取不到有效值。
MobileString签署人手机号
SignOrderInteger签署顺序,如果是有序签署,签署顺序从小到大
ApproveTimeInteger签署人签署时间,时间戳,单位秒
ApproveTypeString签署方类型,ORGANIZATION-企业员工,PERSON-个人,ENTERPRISESERVER-企业静默签
注意:此字段可能返回 null,表示取不到有效值。
ApproverSourceString签署方侧用户来源,如WEWORKAPP-企业微信等
注意:此字段可能返回 null,表示取不到有效值。
CustomApproverTagString客户自定义签署方标识
注意:此字段可能返回 null,表示取不到有效值。
OrganizationIdString签署方企业Id
注意:此字段可能返回 null,表示取不到有效值。
OrganizationNameString签署方企业名称
注意:此字段可能返回 null,表示取不到有效值。
SignIdString签署参与人在本流程中的编号ID(每个流程不同),可用此ID来定位签署参与人在本流程的签署节点,也可用于后续创建签署链接等操作。
注意:此字段可能返回 null,表示取不到有效值。
示例值:yDw**y0S
ApproverRoleNameString自定义签署人角色
注意:此字段可能返回 null,表示取不到有效值。

FlowApproverUrlInfo

签署链接信息

被如下接口引用:CreateFlowSignUrl。

名称类型描述
SignUrlString签署链接(短链形式呈现)。请注意保密,不要将其外泄给无关用户。
注: 注意该链接有效期为30分钟
注意:此字段可能返回 null,表示取不到有效值。
示例值:https://essurl.cn/bR8**HA
ApproverTypeInteger签署参与人类型
  • 1 :个人参与方


注: 现在仅支持个人参与方
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
ApproverNameString签署人姓名
注意:此字段可能返回 null,表示取不到有效值。
示例值:典子谦
ApproverMobileString签署人手机号
注意:此字段可能返回 null,表示取不到有效值。
示例值:13200000000
LongUrlString签署链接(长链形式呈现)。请注意保密,不要将其外泄给无关用户。
注: 注意该链接有效期为30分钟
注意:此字段可能返回 null,表示取不到有效值。
示例值:https://quick.test.qian.tencent.cn/home?ApproverIdCardNumber=Mi**Kio2&ApproverMobile=MTk***NjA%3D&ApproverName=%25**A&ApproverType=1&Code=yDwJCUUck****V2R5K&CodeType=QUICK&FlowId=yDwF**1f3cqjkGm&ShowHeader=1&shortKey=yDwq5**M5GlG1c&token=bR8**HA

FlowBrief

合同流程的基础信息

被如下接口引用:DescribeFlowBriefs。

名称类型描述
FlowIdString合同流程ID,为32位字符串。
示例值:yDRCLUUgygq2xun5UuO4zjEwg0vjoimj
FlowNameString合同流程的名称。
示例值:测试合同-1
FlowDescriptionString合同流程描述信息。
注意:此字段可能返回 null,表示取不到有效值。
示例值:测试流程的描述信息
FlowTypeString合同流程的类别分类(如销售合同/入职合同等)。
示例值:入职合同
FlowStatusInteger合同流程当前的签署状态, 会存在下列的状态值
  • 0 : 未开启流程(合同中不存在填写环节)
  • 1 : 待签署
  • 2 : 部分签署
  • 3 : 已拒签
  • 4 : 已签署
  • 5 : 已过期
  • 6 : 已撤销
  • 7 : 未开启流程(合同中存在填写环节)
  • 8 : 等待填写
  • 9 : 部分填写
  • 10 : 已拒填
  • 21 : 已解除

注意:此字段可能返回 null,表示取不到有效值。
示例值:1
CreatedOnInteger合同流程创建时间,格式为Unix标准时间戳(秒)。
注意:此字段可能返回 null,表示取不到有效值。
示例值:1604910798
FlowMessageString当合同流程状态为已拒签(即 FlowStatus=3)或已撤销(即 FlowStatus=6)时,此字段 FlowMessage 为拒签或撤销原因。
注意:此字段可能返回 null,表示取不到有效值。
示例值:因合同中的预付款金额错误所以撤销此合同
CreatorString合同流程发起方的员工编号, 即员工在腾讯电子签平台的唯一身份标识。
注意:此字段可能返回 null,表示取不到有效值。
示例值:yDxVwUyKQWho8CUuO4zjEyQOAgwvr4Zy
DeadlineInteger合同流程的签署截止时间,格式为Unix标准时间戳(秒)。
注意:此字段可能返回 null,表示取不到有效值。
示例值:1606910798

FlowCreateApprover

创建流程的签署方信息

被如下接口引用:CreateFlow, CreateFlowSignUrl, CreatePrepareFlow。

名称类型必选描述
ApproverTypeInteger在指定签署方时,可选择企业B端或个人C端等不同的参与者类型,可选类型如下:
0:企业
1:个人
3:企业静默签署
注:类型为3(企业静默签署)时,此接口会默认完成该签署方的签署。静默签署仅进行盖章操作,不能自动签名。
7: 个人自动签署,适用于个人自动签场景。
注: 个人自动签场景为白名单功能,使用前请联系对接的客户经理沟通。
示例值:1
OrganizationNameString组织机构名称。
请确认该名称与企业营业执照中注册的名称一致。
如果名称中包含英文括号(),请使用中文括号()代替。

注: 当approverType=0(企业签署方) 或 approverType=3(企业静默签署)时,必须指定

ApproverNameString签署方经办人的姓名。
经办人的姓名将用于身份认证和电子签名,请确保填写的姓名为签署方的真实姓名,而非昵称等代名。

在未指定签署人电子签UserId情况下,为必填参数
ApproverMobileString签署方经办人手机号码, 支持国内手机号11位数字(无需加+86前缀或其他字符)。
请确认手机号所有方为此合同签署方。

在未指定签署人电子签UserId情况下,为必填参数
ApproverIdCardTypeString证件类型,支持以下类型
  • ID_CARD : 居民身份证 (默认值)
  • HONGKONG_AND_MACAO : 港澳居民来往内地通行证
  • HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证)

示例值:ID_CARD
ApproverIdCardNumberString证件号码,应符合以下规则
  • 居民身份证号码应为18位字符串,由数字和大写字母X组成(如存在X,请大写)。
  • 港澳居民来往内地通行证号码应为9位字符串,第1位为“C”,第2位为英文字母(但“I”、“O”除外),后7位为阿拉伯数字。
  • 港澳台居民居住证号码编码规则与中国大陆身份证相同,应为18位字符串。

示例值:620000198802020000
RecipientIdString签署方经办人在模板中配置的参与方ID,与控件绑定,是控件的归属方,ID为32位字符串。
模板发起合同时,该参数为必填项。
文件发起合同是,该参数无需传值。
如果开发者后续用合同模板发起合同,建议保存此值,在用合同模板发起合同中需此值绑定对应的签署经办人 。
VerifyChannelArray of String签署意愿确认渠道,默认为WEIXINAPP:人脸识别

注: 将要废弃, 用ApproverSignTypes签署人签署合同时的认证方式代替, 新客户可请用ApproverSignTypes来设置
示例值:["WEIXINAPP"]
NotifyTypeString通知签署方经办人的方式, 有以下途径:
  • sms : (默认)短信
  • none : 不通知


注: 发起方也是签署方时不给此签署方发送短信
IsFullTextBoolean合同强制需要阅读全文,无需传此参数
PreReadTimeInteger合同的强制预览时间:3~300s,未指定则按合同页数计算
UserIdString签署人userId,仅支持本企业的员工userid, 可在控制台组织管理处获得

注: 若传此字段 则以userid的信息为主,会覆盖传递过来的签署人基本信息, 包括姓名,手机号,证件类型等信息
RequiredBoolean字段已经废弃,当前只支持true,默认为true
ApproverSourceString在企微场景下使用,需设置参数为WEWORKAPP,以表明合同来源于企微。
CustomApproverTagString在企业微信场景下,表明该合同流程为或签,其最大长度为64位字符串。
所有参与或签的人员均需具备该标识。
注意,在合同中,不同的或签参与人必须保证其CustomApproverTag唯一。
如果或签签署人为本方企业微信参与人,则需要指定ApproverSource参数为WEWORKAPP。
RegisterInfoRegisterInfo已经废弃, 快速注册相关信息
ApproverOptionApproverOption签署人个性化能力值,如是否可以转发他人处理、是否可以拒签等功能开关。
SignIdString签署ID
- 发起流程时系统自动补充
- 创建签署链接时,可以通过查询详情接口获得签署人的SignId,然后可传入此值为该签署人创建签署链接,无需再传姓名、手机号、证件号等其他信息
ApproverNeedSignReviewBoolean发起方企业的签署人进行签署操作前,是否需要企业内部走审批流程,取值如下:
  • false:(默认)不需要审批,直接签署。
  • true:需要走审批流程。当到对应参与人签署时,会阻塞其签署操作,等待企业内部审批完成。

企业可以通过CreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果
  • 如果企业通知腾讯电子签平台审核通过,签署方可继续签署动作。
  • 如果企业通知腾讯电子签平台审核未通过,平台将继续阻塞签署方的签署动作,直到企业通知平台审核通过。


注:此功能可用于与企业内部的审批流程进行关联,支持手动、静默签署合同
SignComponentsArray of Component签署人签署控件, 此参数仅针对文件发起(CreateFlowByFiles)生效

合同中的签署控件列表,列表中可支持下列多种签署控件,控件的详细定义参考开发者中心的Component结构体
  • 个人签名/印章
  • 企业印章
  • 骑缝章等签署控件


此参数仅针对文件发起设置生效,模板发起合同签署流程, 请以模板配置为主
ComponentsArray of Component签署人填写控件 此参数仅针对文件发起(CreateFlowByFiles)生效

合同中的填写控件列表,列表中可支持下列多种填写控件,控件的详细定义参考开发者中心的Component结构体
  • 单行文本控件
  • 多行文本控件
  • 勾选框控件
  • 数字控件
  • 图片控件
  • 动态表格等填写控件


此参数仅针对文件发起设置生效,模板发起合同签署流程, 请以模板配置为主
ComponentLimitTypeArray of String签署方控件类型为 SIGN_SIGNATURE时,可以指定签署方签名方式
HANDWRITE – 手写签名
OCR_ESIGN -- AI智能识别手写签名
ESIGN -- 个人印章类型
SYSTEM_ESIGN -- 系统签名(该类型可以在用户签署时根据用户姓名一键生成一个签名来进行签署)
ApproverVerifyTypesArray of Integer指定个人签署方查看合同的校验方式,可以传值如下:
  • 1 : (默认)人脸识别,人脸识别后才能合同内容
  • 2 : 手机号验证, 用户手机号和参与方手机号(ApproverMobile)相同即可查看合同内容(当手写签名方式为OCR_ESIGN时,该校验方式无效,因为这种签名方式依赖实名认证)

注:
  • 如果合同流程设置ApproverVerifyType查看合同的校验方式, 则忽略此签署人的查看合同的校验方式
  • 此字段不可传多个校验方式


此参数仅针对文件发起设置生效,模板发起合同签署流程, 请以模板配置为主

.
示例值:[1,2]
ApproverSignTypesArray of Integer您可以指定签署方签署合同的认证校验方式,可传递以下值:
  • 1:人脸认证,需进行人脸识别成功后才能签署合同;
  • 2:签署密码,需输入与用户在腾讯电子签设置的密码一致才能校验成功进行合同签署;
  • 3:运营商三要素,需到运营商处比对手机号实名信息(名字、手机号、证件号)校验一致才能成功进行合同签署。

注:
  • 默认情况下,认证校验方式为人脸认证和签署密码两种形式;
  • 您可以传递多种值,表示可用多种认证校验方式。


注:
此参数仅针对文件发起设置生效,模板发起合同签署流程, 请以模板配置为主
示例值:[1,2]

FlowDetailInfo

此结构体(FlowDetailInfo)描述的是合同(流程)的详细信息

被如下接口引用:DescribeFlowInfo。

名称类型描述
FlowIdString合同流程ID,为32位字符串。
示例值:yDRCLUUgygq2xun5UuO4zjEwg0vjoimj
FlowNameString合同流程的名称(可自定义此名称),长度不能超过200,只能由中文、字母、数字和下划线组成。
示例值:测试合同-1
FlowTypeString合同流程的类别分类(如销售合同/入职合同等)。
注意:此字段可能返回 null,表示取不到有效值。
示例值:入职合同
FlowStatusInteger合同流程当前的签署状态, 会存在下列的状态值
  • 0 : 未开启流程(合同中不存在填写环节)
  • 1 : 待签署
  • 2 : 部分签署
  • 3 : 已拒签
  • 4 : 已签署
  • 5 : 已过期
  • 6 : 已撤销
  • 7 : 未开启流程(合同中存在填写环节)
  • 8 : 等待填写
  • 9 : 部分填写
  • 10 : 已拒填
  • 21 : 已解除

示例值:1
FlowMessageString当合同流程状态为已拒签(即 FlowStatus=3)或已撤销(即 FlowStatus=6)时,此字段 FlowMessage 为拒签或撤销原因。
注意:此字段可能返回 null,表示取不到有效值。
示例值:因合同中的预付款金额错误所以撤销此合同
FlowDescriptionString合同流程描述信息。
注意:此字段可能返回 null,表示取不到有效值。
示例值:测试流程的描述信息
CreatedOnInteger合同流程的创建时间戳,格式为Unix标准时间戳(秒)。
示例值:1606910798
FlowApproverInfosArray of FlowApproverDetail合同流程的签署方数组
CcInfosArray of FlowApproverDetail合同流程的关注方信息数组
CreatorString合同流程发起方的员工编号, 即员工在腾讯电子签平台的唯一身份标识。
注意:此字段可能返回 null,表示取不到有效值。
示例值:yDxVwUyKQWho8CUuO4zjEyQOAgwvr4Zy

FlowGroupInfo

此结构体(FlowGroupInfo)描述的是合同组(流程组)的单个合同(流程)信息

被如下接口引用:CreateFlowGroupByFiles, CreateFlowGroupByTemplates。

名称类型必选描述
FlowNameString合同流程的名称(可自定义此名称),长度不能超过200,只能由中文、字母、数字和下划线组成。
该名称还将用于合同签署完成后的下载文件名。
ApproversArray of ApproverInfo签署流程参与者信息,最大限制50方
注意 approver中的顺序需要和模板中的顺序保持一致, 否则会导致模板中配置的信息无效。
FileIdsArray of String文件资源ID,通过多文件上传UploadFiles接口获得,为32位字符串。
建议开发者保存此资源ID,后续创建合同或创建合同流程需此资源ID。
TemplateIdString合同模板ID,为32位字符串。
建议开发者保存此模板ID,后续用此模板发起合同流程需要此参数。
可登录腾讯电子签控制台,在 "模板"->"模板中心"->"列表展示设置"选中模板 ID 中查看某个模板的TemplateId(在页面中展示为模板ID)。
FlowTypeString签署流程的类型(如销售合同/入职合同等),最大长度200个字符
示例值:劳务合同
FlowDescriptionString签署流程描述,最大长度1000个字符
DeadlineInteger签署流程的签署截止时间。

值为unix时间戳,精确到秒,不传默认为当前时间一年后
示例值:1604912664
UserDataString调用方自定义的个性化字段(可自定义此字段的值),并以base64方式编码,支持的最大数据大小为 20480长度。
在合同状态变更的回调信息等场景中,该字段的信息将原封不动地透传给贵方。
回调的相关说明可参考开发者中心的回调通知模块。
UnorderedBoolean发送类型:
true:无序签
false:有序签
注:默认为false(有序签),请和模板中的配置保持一致
示例值:true
ComponentsArray of Component模板或者合同中的填写控件列表,列表中可支持下列多种填写控件,控件的详细定义参考开发者中心的Component结构体
  • 单行文本控件
  • 多行文本控件
  • 勾选框控件
  • 数字控件
  • 图片控件
  • 动态表格等填写控件
NeedSignReviewBoolean发起方企业的签署人进行签署操作是否需要企业内部审批。使用此功能需要发起方企业有参与签署。
若设置为true,审核结果需通过接口 CreateFlowSignReview 通知电子签,审核通过后,发起方企业签署人方可进行签署操作,否则会阻塞其签署操作。

注:企业可以通过此功能与企业内部的审批流程进行关联,支持手动、静默签署合同。
示例值:true
AutoSignSceneString个人自动签场景。发起自动签署时,需设置对应自动签署场景,目前仅支持场景:处方单-E_PRESCRIPTION_AUTO_SIGN
示例值:E_PRESCRIPTION_AUTO_SIGN

FlowGroupOptions

此结构体(FlowGroupOptions)描述的是合同组的个性化配置,支持控制是否发送短信、未实名个人签署方查看合同组时是否需要实名认证(仅在合同组文件发起配置时生效)

被如下接口引用:CreateFlowGroupByFiles, CreateFlowGroupByTemplates。

名称类型必选描述
ApproverVerifyTypeString签署人校验方式,支持以下类型
  • VerifyCheck : 人脸识别 (默认值)
  • MobileCheck : 手机号验证

参数说明:此参数仅在合同组文件发起有效,可选人脸识别或手机号验证两种方式,若选择后者,未实名个人签署方在签署合同时,无需经过实名认证和意愿确认两次人脸识别,该能力仅适用于个人签署方。
SelfOrganizationApproverNotifyTypeString发起合同(流程)组本方企业经办人通知方式
签署通知类型,支持以下类型
  • sms : 短信 (默认值)
  • none : 不通知
OtherApproverNotifyTypeString发起合同(流程)组他方经办人通知方式
签署通知类型,支持以下类型
  • sms : 短信 (默认值)
  • none : 不通知

FormField

电子文档的控件填充信息。按照控件类型进行相应的填充。

当控件的 ComponentType='TEXT'时,FormField.ComponentValue填入文本内容

FormFiled输入示例:
{
"ComponentId": "componentId1",
"ComponentValue": "文本内容"
}

当控件的 ComponentType='MULTI_LINE_TEXT'时,FormField.ComponentValue填入文本内容,支持自动换行。

FormFiled输入示例:
{
"ComponentId": "componentId1",
"ComponentValue": "多行文本内容"
}

当控件的 ComponentType='CHECK_BOX'时,FormField.ComponentValue填入true或false文本

FormFiled输入示例:
{
"ComponentId": "componentId1",
"ComponentValue": "true"
}

当控件的 ComponentType='FILL_IMAGE'时,FormField.ComponentValue填入图片的资源ID

FormFiled输入示例:
{
"ComponentId": "componentId1",
"ComponentValue": "yDwhsxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

当控件的 ComponentType='ATTACHMENT'时,FormField.ComponentValue填入附件图片的资源ID列表,以逗号分隔,单个附件控件最多支持6个资源ID;

FormFiled输入示例:
{
"ComponentId": "componentId1",
"ComponentValue": "yDwhsxxxxxxxxxxxxxxxxxxxxxxxxxx1,yDwhsxxxxxxxxxxxxxxxxxxxxxxxxxx2,yDwhsxxxxxxxxxxxxxxxxxxxxxxxxxx3"
}

当控件的 ComponentType='SELECTOR'时,FormField.ComponentValue填入选择的选项内容;

FormFiled输入示例:
{
"ComponentId": "componentId1",
"ComponentValue": "选择的内容"
}

当控件的 ComponentType='DATE'时,FormField.ComponentValue填入日期内容;

FormFiled输入示例:
{
"ComponentId": "componentId1",
"ComponentValue": "2023年01月01日"
}

当控件的 ComponentType='DISTRICT'时,FormField.ComponentValue填入省市区内容;

FormFiled输入示例:
{
"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"
}
]
}
}

表格参数说明

名称类型描述
headersArray表头:不超过10列,不支持单元格合并,字数不超过100
rowCountInteger表格内容最大行数
cells.N.rowStartInteger单元格坐标:行起始index
cells.N.rowEndInteger单元格坐标:行结束index
cells.N.columnStartInteger单元格坐标:列起始index
cells.N.columnEndInteger单元格坐标:列结束index
cells.N.contentString单元格内容,字数不超过100

表格参数headers说明 widthPercent Integer 表头单元格列占总表头的比例,例如1:30表示 此列占表头的30%,不填写时列宽度平均拆分;例如2:总2列,某一列填写40,剩余列可以为空,按照60计算。;例如3:总3列,某一列填写30,剩余2列可以为空,分别为(100-30)/2=35 content String 表头单元格内容,字数不超过100

被如下接口引用:CreateDocument。

名称类型必选描述
ComponentValueString控件填充vaule,ComponentType和传入值类型对应关系:
TEXT - 文本内容
MULTI_LINE_TEXT - 文本内容
CHECK_BOX - true/false
FILL_IMAGE、ATTACHMENT - 附件的FileId,需要通过UploadFiles接口上传获取
SELECTOR - 选项值
DYNAMIC_TABLE - 传入json格式的表格内容,具体见数据结构FlowInfo:https://cloud.tencent.com/document/api/1420/61525#FlowInfo
示例值:ComponentValue
ComponentIdString控件id,和ComponentName选择一项传入即可
示例值:componentId
ComponentNameString控件名字,最大长度不超过30字符,和ComponentId选择一项传入即可
示例值:ComponentName

GroupOrganization

成员企业信息

被如下接口引用:DescribeOrganizationGroupOrganizations。

名称类型描述
NameString成员企业名
注意:此字段可能返回 null,表示取不到有效值。
AliasString成员企业别名
注意:此字段可能返回 null,表示取不到有效值。
OrganizationIdString成员企业id,为 32 位字符串,可在电子签PC 控制台,企业设置->企业电子签账号 获取
注意:此字段可能返回 null,表示取不到有效值。
UpdateTimeInteger记录更新时间, unix时间戳,单位秒
注意:此字段可能返回 null,表示取不到有效值。
StatusInteger成员企业加入集团的当前状态
  • 1:待授权
  • 2:已授权待激活
  • 3:拒绝授权
  • 4:已解除
  • 5:已加入



注意:此字段可能返回 null,表示取不到有效值。
IsMainOrganizationBoolean是否为集团主企业
注意:此字段可能返回 null,表示取不到有效值。
IdCardNumberString企业社会信用代码
注意:此字段可能返回 null,表示取不到有效值。
AdminInfoAdmin企业超管信息
注意:此字段可能返回 null,表示取不到有效值。
LicenseString企业许可证Id,此字段暂时不需要关注
注意:此字段可能返回 null,表示取不到有效值。
LicenseExpireTimeInteger企业许可证过期时间,unix时间戳,单位秒
注意:此字段可能返回 null,表示取不到有效值。
JoinTimeInteger成员企业加入集团时间,unix时间戳,单位秒
注意:此字段可能返回 null,表示取不到有效值。
FlowEngineEnableBoolean是否使用自建审批流引擎(即不是企微审批流引擎)
  • true:是
  • false:否

注意:此字段可能返回 null,表示取不到有效值。

HasAuthUser

被授权的用户信息

被如下接口引用:DescribeExtendedServiceAuthInfos。

名称类型必选描述
UserIdString员工在腾讯电子签平台的唯一身份标识,为32位字符串。
注意:此字段可能返回 null,表示取不到有效值。
BelongToString当前员工的归属情况,可能值是:
MainOrg:在集团企业的场景下,返回此值代表是归属主企业
CurrentOrg:在普通企业场景下返回此值;或者在集团企业的场景下,返回此值代表归属子企业
注意:此字段可能返回 null,表示取不到有效值。

IntegrateRole

企业角色数据信息

被如下接口引用:DescribeIntegrationRoles。

名称类型描述
RoleIdString角色id
注意:此字段可能返回 null,表示取不到有效值。
RoleNameString角色名
注意:此字段可能返回 null,表示取不到有效值。
RoleStatusInteger角色状态,1-启用,2-禁用
注意:此字段可能返回 null,表示取不到有效值。
IsGroupRoleBoolean是否是集团角色,true-是,false-否
注意:此字段可能返回 null,表示取不到有效值。
SubOrgIdListArray of String管辖的子企业列表
注意:此字段可能返回 null,表示取不到有效值。
PermissionGroupsArray of PermissionGroup权限树
注意:此字段可能返回 null,表示取不到有效值。

IntegrationDepartment

部门信息

被如下接口引用:DescribeIntegrationDepartments。

名称类型描述
DeptIdString部门ID。
注意:此字段可能返回 null,表示取不到有效值。
示例值:dp**155f2
DeptNameString部门名。
注意:此字段可能返回 null,表示取不到有效值。
示例值:测试部门
ParentDeptIdString父部门ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:yD**m1221
DeptOpenIdString客户系统部门ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:dept_open_1
OrderNoInteger序列号。
注意:此字段可能返回 null,表示取不到有效值。
示例值:1

OccupiedSeal

持有的电子印章信息

被如下接口引用:DescribeOrganizationSeals。

名称类型描述
SealIdString电子印章编号
SealNameString电子印章名称
CreateOnInteger电子印章授权时间戳,单位秒
CreatorString电子印章授权人的UserId
SealPolicyIdString电子印章策略Id
SealStatusString印章状态,有以下六种:CHECKING(审核中)SUCCESS(已启用)FAIL(审核拒绝)CHECKING-SADM(待超管审核)DISABLE(已停用)STOPPED(已终止)
FailReasonString审核失败原因
注意:此字段可能返回 null,表示取不到有效值。
UrlString印章图片url,5分钟内有效
SealTypeString印章类型,OFFICIAL-企业公章, CONTRACT-合同专用章,ORGANIZATIONSEAL-企业印章(本地上传印章类型),LEGAL_PERSON_SEAL-法人印章
IsAllTimeBoolean用印申请是否为永久授权,true-是,false-否
AuthorizedUsersArray of AuthorizedUser授权人列表
注意:此字段可能返回 null,表示取不到有效值。

PdfVerifyResult

合同文件验签单个结果结构体

被如下接口引用:VerifyPdf。

名称类型描述
VerifyResultInteger验签结果。0-签名域未签名;1-验签成功; 3-验签失败;4-未找到签名域:文件内没有签名域;5-签名值格式不正确。
SignPlatformString签署平台,如果文件是在腾讯电子签平台签署,则返回腾讯电子签,如果文件不在腾讯电子签平台签署,则返回其他平台。
SignerNameString签署人名称
SignTimeInteger签署时间戳,单位秒
SignAlgorithmString签名算法
CertSnString签名证书序列号
CertNotBeforeInteger证书起始时间戳,单位毫秒
CertNotAfterInteger证书过期时间戳,单位毫秒
ComponentPosXFloat签名域横坐标,单位pt
ComponentPosYFloat签名域纵坐标,单位pt
ComponentWidthFloat签名域宽度,单位pt
ComponentHeightFloat签名域高度,单位pt
ComponentPageInteger签名域所在页码,1~N

Permission

权限树节点权限

被如下接口引用:CreateIntegrationRole, ModifyIntegrationRole。

名称类型必选描述
NameString权限名称
注意:此字段可能返回 null,表示取不到有效值。
KeyString权限key
注意:此字段可能返回 null,表示取不到有效值。
TypeInteger权限类型 1前端,2后端
注意:此字段可能返回 null,表示取不到有效值。
HideInteger是否隐藏
注意:此字段可能返回 null,表示取不到有效值。
DataLabelInteger数据权限标签 1:表示根节点,2:表示叶子结点
注意:此字段可能返回 null,表示取不到有效值。
DataTypeInteger数据权限独有,1:关联其他模块鉴权,2:表示关联自己模块鉴权
注意:此字段可能返回 null,表示取不到有效值。
DataRangeInteger数据权限独有,表示数据范围,1:全公司,2:部门及下级部门,3:自己
注意:此字段可能返回 null,表示取不到有效值。
DataToString关联权限, 表示这个功能权限要受哪个数据权限管控
注意:此字段可能返回 null,表示取不到有效值。
ParentKeyString父级权限key
注意:此字段可能返回 null,表示取不到有效值。
IsCheckedBoolean是否选中
注意:此字段可能返回 null,表示取不到有效值。
ChildrenArray of Permission子权限集合
注意:此字段可能返回 null,表示取不到有效值。

PermissionGroup

权限树中的权限组

被如下接口引用:CreateIntegrationRole, DescribeIntegrationRoles, ModifyIntegrationRole。

名称类型必选描述
GroupNameString权限组名称
注意:此字段可能返回 null,表示取不到有效值。
GroupKeyString权限组key
注意:此字段可能返回 null,表示取不到有效值。
HideInteger是否隐藏分组,0否1是
注意:此字段可能返回 null,表示取不到有效值。
PermissionsArray of Permission权限集合
注意:此字段可能返回 null,表示取不到有效值。

Recipient

流程中参与方的信息结构

被如下接口引用:DescribeFlowTemplates。

名称类型必选描述
RecipientIdString签署参与者ID,唯一标识
RecipientTypeString参与者类型。
默认为空。
ENTERPRISE-企业;
INDIVIDUAL-个人;
PROMOTER-发起方
示例值:ENTERPRISE
DescriptionString描述信息
RoleNameString角色名称
RequireValidationBoolean是否需要验证,
默认为false-不需要验证
RequireSignBoolean是否需要签署,
默认为true-需要签署
RoutingOrderInteger此参与方添加的顺序,从0~N
RequireDeliveryBoolean是否需要发送,
默认为true-需要发送
EmailString邮箱地址
MobileString电话号码
UserIdString关联的用户ID,电子签系统的用户ID
DeliveryMethodString发送方式,默认为EMAIL。
EMAIL-邮件;
MOBILE-手机短信;
WECHAT-微信通知
示例值:EMAIL
RecipientExtraString参与方的一些附属信息,json格式

RecipientComponentInfo

参与方填写控件信息

被如下接口引用:DescribeFlowComponents。

名称类型描述
RecipientIdString参与方Id
注意:此字段可能返回 null,表示取不到有效值。
RecipientFillStatusString参与方填写状态
  • 0-未填写
  • 1-已填写

注意:此字段可能返回 null,表示取不到有效值。
IsPromoterBoolean是否为发起方
  • true-发起方
  • false-参与方

注意:此字段可能返回 null,表示取不到有效值。
ComponentsArray of FilledComponent填写控件列表
注意:此字段可能返回 null,表示取不到有效值。

RegisterInfo

发起流程快速注册相关信息

被如下接口引用:CreateFlow, CreateFlowSignUrl, CreatePrepareFlow。

名称类型必选描述
LegalNameString法人姓名
UnifiedSocialCreditCodeString社会统一信用代码

ReleasedApprover

解除协议的签署人,如不指定,默认使用原流程中的签署人。
注意:不支持更换C端(个人身份类型)签署人,如果原流程中含有C端签署人,默认使用原流程中的该C端签署人。
注意:目前不支持替换C端(个人身份类型)签署人,但是可以指定C端签署人的签署方自定义控件别名,具体见参数ApproverSignRole描述。
注意:当指定C端签署人的签署方自定义控件别名不空时,除RelievedApproverReceiptId参数外,可以只参数ApproverSignRole。

被如下接口引用:CreateReleaseFlow。

名称类型必选描述
NameString签署人姓名,最大长度50个字。

示例值:典子谦
MobileString签署人手机号。
示例值:13200000000
RelievedApproverReceiptIdString要更换的原合同参与人RecipientId编号。(可通过接口DescribeFlowInfo查询签署人的RecipientId编号)
ApproverTypeString指定签署人类型,目前仅支持
  • ORGANIZATION:企业(默认值)
  • ENTERPRISESERVER:企业静默签

示例值:ORGANIZATION
ApproverSignComponentTypeString签署控件类型,支持自定义企业签署方的签署控件类型
  • SIGN_SEAL:默认为印章控件类型(默认值)
  • SIGN_SIGNATURE:手写签名控件类型
ApproverSignRoleString参与方在合同中的角色是按照创建合同的时候来排序的,解除协议默认会将第一个参与人叫甲方,第二个叫乙方, 第三个叫丙方,以此类推。

如果需改动此参与人的角色名字,可用此字段指定,由汉字,英文字符,数字组成,最大20个字。

示例值:供应商

RelieveInfo

解除协议文档中内容信息,包括但不限于:解除理由、解除后仍然有效的条款-保留条款、原合同事项处理-费用结算、原合同事项处理-其他事项、其他约定等。

被如下接口引用:CreateReleaseFlow。

名称类型必选描述
ReasonString解除理由,长度不能超过200,只能由中文、字母、数字、中文标点和英文标点组成(不支持表情)。
RemainInForceItemString解除后仍然有效的条款,保留条款,长度不能超过200,只能由中文、字母、数字、中文标点和英文标点组成(不支持表情)。
OriginalExpenseSettlementString原合同事项处理-费用结算,长度不能超过200,只能由中文、字母、数字、中文标点和英文标点组成(不支持表情)。
OriginalOtherSettlementString原合同事项处理-其他事项,长度不能超过200,只能由中文、字母、数字、中文标点和英文标点组成(不支持表情)。
OtherDealsString其他约定,长度不能超过200,只能由中文、字母、数字、中文标点和英文标点组成(不支持表情)。

RemindFlowRecords

催办接口返回的详细信息。

被如下接口引用:CreateFlowReminds。

名称类型描述
CanRemindBoolean合同流程是否可以催办:
true - 可以,false - 不可以。
若无法催办,将返回RemindMessage以解释原因。
示例值:true
FlowIdString合同流程ID,为32位字符串。
示例值:yDwxxxxxxxW72Qaxm
RemindMessageString在合同流程无法催办的情况下,系统将返回RemindMessage以阐述原因。
示例值:""

ReviewerInfo

关注方信息

被如下接口引用:CreateEmbedWebUrl。

名称类型必选描述
NameString姓名
MobileString手机号

SealInfo

模板中指定的印章信息

被如下接口引用:DescribeFlowTemplates。

名称类型描述
SealIdString印章ID
注意:此字段可能返回 null,表示取不到有效值。
SealTypeString印章类型。LEGAL_PERSON_SEAL: 法定代表人章;
ORGANIZATIONSEAL:企业印章;
OFFICIAL:企业公章;
CONTRACT:合同专用章
注意:此字段可能返回 null,表示取不到有效值。
SealNameString印章名称
注意:此字段可能返回 null,表示取不到有效值。

SignQrCode

签署二维码的基本信息,用于创建二维码,用户可扫描该二维码进行签署操作。

被如下接口引用:CreateMultiFlowSignQRCode。

名称类型描述
QrCodeIdString二维码ID,为32位字符串。
示例值:yDRS*Swc
QrCodeUrlString二维码URL,可通过转换二维码的工具或代码组件将此URL转化为二维码,以便用户扫描进行流程签署。
示例值:https://xxxx
ExpiredTimeInteger二维码的有截止时间,格式为Unix标准时间戳(秒)。
一旦超过二维码的有效期限,该二维码将自动失效。
示例值:1693814798

SignUrl

流程签署二维码的签署信息,适用于客户系统整合二维码功能。 通过链接,用户可直接访问电子签名小程序并签署合同。

被如下接口引用:CreateMultiFlowSignQRCode。

名称类型描述
AppSignUrlString跳转至电子签名小程序签署的链接地址。
适用于客户端APP及小程序直接唤起电子签名小程序。
示例值:pages/guide?from=default&where=mini&autoJumpBack=true&to=CHANNEL_CONTRACT_COVER&xxx
EffectiveTimeString签署链接有效时间,格式类似"2022-08-05 15:55:01"
示例值:2022-08-05 15:55:01
HttpSignUrlString跳转至电子签名小程序签署的链接地址,格式类似于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。

名称类型必选描述
UserIdString员工在腾讯电子签平台的唯一身份标识,为32位字符串。
注:创建和更新场景无需填写。
示例值:yDRCLUUgygq2xun5UuO4zjEwg0vjoimj
DisplayNameString显示的用户名/昵称。
示例值:张三
MobileString用户手机号码, 支持国内手机号11位数字(无需加+86前缀或其他字符)。
示例值:13200000000
EmailString用户邮箱。
注意:此字段可能返回 null,表示取不到有效值。
示例值:testtest@tencent.com
OpenIdString用户在第三方平台ID。
注:如需在此接口提醒员工实名,该参数不传。
注意:此字段可能返回 null,表示取不到有效值。
示例值:open_user1
RolesArray of StaffRole员工角色信息。
注:创建和更新场景无需填写。
注意:此字段可能返回 null,表示取不到有效值。
DepartmentDepartment员工部门信息。
注意:此字段可能返回 null,表示取不到有效值。
VerifiedBoolean员工是否实名。
注:创建和更新场景无需填写。
示例值:false
CreatedOnInteger员工创建时间戳,单位秒。
注:创建和更新场景无需填写。
示例值:1691563315
VerifiedOnInteger员工实名时间戳,单位秒。
注:创建和更新场景无需填写。
注意:此字段可能返回 null,表示取不到有效值。
示例值:1691563315
QuiteJobInteger员工是否离职:
  • 0:未离职
  • 1:离职

注:创建和更新场景无需填写。
注意:此字段可能返回 null,表示取不到有效值。
示例值:0
ReceiveUserIdString员工离职交接人用户ID。
注:创建和更新场景无需填写。
示例值:yDxVwUyKQWho8CUuO4zjEyQOAgwvr4Zy
ReceiveOpenIdString员工离职交接人用户OpenId。
注:创建和更新场景无需填写。
示例值:open_user2
WeworkOpenIdString企业微信用户账号ID。
注:仅企微类型的企业创建员工接口支持该字段。
注意:此字段可能返回 null,表示取不到有效值。
示例值:wework_open1

StaffRole

集成版企业角色信息。

被如下接口引用:CreateIntegrationEmployees, DeleteIntegrationEmployees, DescribeIntegrationEmployees, UpdateIntegrationEmployees。

名称类型必选描述
RoleIdString角色ID。
注意:此字段可能返回 null,表示取不到有效值。
示例值:4dff1**10b
RoleNameString角色名称。
注意:此字段可能返回 null,表示取不到有效值。
示例值:业务员

SuccessCreateStaffData

创建员工的成功数据

被如下接口引用:CreateIntegrationEmployees。

名称类型描述
DisplayNameString员工名
MobileString员工手机号
UserIdString员工在电子签平台的id
NoteString提示,当创建已存在未实名用户时,该字段有值
注意:此字段可能返回 null,表示取不到有效值。
WeworkOpenIdString传入的企微账号id

SuccessDeleteStaffData

删除员工的成功数据

被如下接口引用:DeleteIntegrationEmployees。

名称类型描述
DisplayNameString员工名
MobileString员工手机号
UserIdString员工在电子签平台的id

SuccessUpdateStaffData

更新员工信息成功返回的数据信息

被如下接口引用:UpdateIntegrationEmployees。

名称类型描述
DisplayNameString传入的用户名称
MobileString传入的手机号,没有打码
UserIdString员工在腾讯电子签平台的唯一身份标识,为32位字符串。
可登录腾讯电子签控制台,在 "更多能力"->"组织管理" 中查看某位员工的UserId(在页面中展示为用户ID)。

TemplateInfo

此结构体 (TemplateInfo) 用于描述模板的信息。

模板组成

一个模板通常会包含以下结构信息

  • 模板基本信息
  • 发起方参与信息Promoter、签署参与方 Recipients,后者会在模板发起合同时用于指定参与方
  • 填写控件 Components
  • 签署控件 SignComponents
  • 生成模板的文件基础信息 FileInfos

被如下接口引用:DescribeFlowTemplates。

名称类型必选描述
TemplateIdString模板ID,模板的唯一标识
TemplateNameString模板名
DescriptionString模板描述信息
DocumentResourceIdsArray of String模板关联的资源ID列表
FileInfosArray of FileInfo生成模板的文件基础信息
AttachmentResourceIdsArray of String附件关联的资源ID
SignOrderArray of Integer签署顺序
无序 -1
有序为序列数字 0,1,2
RecipientsArray of Recipient模板中的签署参与方列表
ComponentsArray of Component模板的填充控件列表
SignComponentsArray of Component模板中的签署控件列表
StatusInteger模板状态
-1:不可用
0:草稿态
1:正式态,可以正常使用
CreatorString模板的创建者信息,电子签系统用户ID
CreatedOnInteger模板创建的时间戳,格式为Unix标准时间戳(秒)
PromoterRecipient发起方参与信息Promoter
TemplateTypeInteger模板类型:
1 静默签,
3 普通模板
AvailableInteger模板可用状态:
1 启用(默认)
2 停用
OrganizationIdString创建模板的企业ID,电子签的机构ID
PreviewUrlString模板预览链接,有效时间5分钟
注意:此字段可能返回 null,表示取不到有效值。
TemplateVersionString模板版本。默认为空时,全数字字符,初始版本为yyyyMMdd001。
注意:此字段可能返回 null,表示取不到有效值。
PublishedBoolean模板是否已发布:
true-已发布
false-未发布
注意:此字段可能返回 null,表示取不到有效值。
TemplateSealsArray of SealInfo模板内部指定的印章列表
注意:此字段可能返回 null,表示取不到有效值。

UploadFile

此结构体 (UploadFile) 用于描述多文件上传的文件信息。

被如下接口引用:UploadFiles。

名称类型必选描述
FileBodyStringBase64编码后的文件内容
FileNameString文件名,最大长度不超过200字符
示例值:test.pdf

UserInfo

用户信息

被如下接口引用:BindEmployeeUserIdWithClientOpenId, CancelFlow, CancelMultiFlowSignQRCode, CancelUserAutoSignEnableUrl, CreateBatchCancelFlowUrl, CreateBatchSignUrl, CreateConvertTaskApi, CreateDocument, CreateEmbedWebUrl, CreateFlow, CreateFlowApprovers, CreateFlowByFiles, CreateFlowEvidenceReport, CreateFlowGroupByFiles, CreateFlowGroupByTemplates, CreateFlowReminds, CreateFlowSignReview, CreateFlowSignUrl, CreateIntegrationDepartment, CreateIntegrationEmployees, CreateIntegrationRole, CreateIntegrationUserRoles, CreateMultiFlowSignQRCode, CreateOrganizationBatchSignUrl, CreateOrganizationInfoChangeUrl, CreatePersonAuthCertificateImage, CreatePrepareFlow, CreatePreparedPersonalEsign, CreateReleaseFlow, CreateSchemeUrl, CreateSeal, CreateSealPolicy, CreateUserAutoSignEnableUrl, CreateWebThemeConfig, DeleteIntegrationDepartment, DeleteIntegrationEmployees, DeleteIntegrationRoleUsers, DeleteSealPolicies, DescribeExtendedServiceAuthInfos, DescribeFileUrls, DescribeFlowBriefs, DescribeFlowComponents, DescribeFlowEvidenceReport, DescribeFlowInfo, DescribeFlowTemplates, DescribeIntegrationDepartments, DescribeIntegrationEmployees, DescribeIntegrationRoles, DescribeOrganizationGroupOrganizations, DescribeOrganizationSeals, DescribePersonCertificate, DescribeThirdPartyAuthCode, DescribeUserAutoSignStatus, DisableUserAutoSign, GetTaskResultApi, ModifyApplicationCallbackInfo, ModifyIntegrationDepartment, ModifyIntegrationRole, StartFlow, UnbindEmployeeUserIdWithClientOpenId, UpdateIntegrationEmployees, VerifyPdf。

名称类型必选描述
UserIdString用户在平台的编号

UserThreeFactor

用户的三要素:姓名,证件号,证件类型

被如下接口引用:CancelUserAutoSignEnableUrl, CreateUserAutoSignEnableUrl, DescribePersonCertificate, DescribeUserAutoSignStatus, DisableUserAutoSign。

名称类型必选描述
NameString签署方经办人的姓名。
经办人的姓名将用于身份认证和电子签名,请确保填写的姓名为签署方的真实姓名,而非昵称等代名。
示例值:小明
IdCardTypeString证件类型,支持以下类型
  • ID_CARD : 居民身份证 (默认值)
  • HONGKONG_AND_MACAO : 港澳居民来往内地通行证
  • HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证)

示例值:ID_CARD
IdCardNumberString证件号码,应符合以下规则
  • 居民身份证号码应为18位字符串,由数字和大写字母X组成(如存在X,请大写)。
  • 港澳居民来往内地通行证号码应为9位字符串,第1位为“C”,第2位为英文字母(但“I”、“O”除外),后7位为阿拉伯数字。
  • 港澳台居民居住证号码编码规则与中国大陆身份证相同,应为18位字符串。

示例值:610*1X

WebThemeConfig

页面主题配置

被如下接口引用:CreateWebThemeConfig。

名称类型必选描述
DisplaySignBrandLogoBoolean是否显示页面底部电子签logo,取值如下:
  • true:页面底部显示电子签logo
  • false:页面底部不显示电子签logo(默认)

示例值:true
WebEmbedThemeColorString主题颜色:
支持十六进制颜色值以及RGB格式颜色值,例如:#D54941,rgb(213, 73, 65)


示例值:#D54941