数据结构

Admin

企业超管信息

被如下接口引用：DescribeOrganizationGroupOrganizations。

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

Agent

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

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

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

ApproverComponentLimitType

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

被如下接口引用：CreateMultiFlowSignQRCode。

名称	类型	必选	描述
RecipientId	String	是	签署方经办人在模板中配置的参与方ID，与控件绑定，是控件的归属方，ID为32位字符串。
Values	Array of String	是	签署方经办人控件类型是个人印章签署控件（SIGN_SIGNATURE）时，可选的签名方式，可多选签名方式： HANDWRITE-手写签名 ESIGN-个人印章类型 OCR_ESIGN-AI智能识别手写签名 SYSTEM_ESIGN-系统签名

ApproverInfo

合同参与者信息。

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

名称	类型	必选	描述
ApproverType	Integer	是	在指定签署方时，可选择企业B端或个人C端等不同的参与者类型，可选类型如下: 0：企业 1：个人 3：企业静默签署注：`类型为3（企业静默签署）时，此接口会默认完成该签署方的签署。静默签署仅进行盖章操作，不能自动签名。` 7: 个人自动签署，适用于个人自动签场景。注: `个人自动签场景为白名单功能，使用前请联系对接的客户经理沟通。`
ApproverName	String	是	签署方经办人的姓名。经办人的姓名将用于身份认证和电子签名，请确保填写的姓名为签署方的真实姓名，而非昵称等代名。
ApproverMobile	String	是	签署方经办人手机号码，支持国内手机号11位数字(无需加+86前缀或其他字符)。请确认手机号所有方为此合同签署方。
OrganizationName	String	否	组织机构名称。请确认该名称与企业营业执照中注册的名称一致。如果名称中包含英文括号()，请使用中文括号（）代替。如果签署方是企业签署方(approverType = 0 或者 approverType = 3)，则企业名称必填。
SignComponents	Array of Component	否	合同中的签署控件列表，列表中可支持下列多种签署控件,控件的详细定义参考开发者中心的Component结构体个人签名/印章企业印章骑缝章等签署控件
ApproverIdCardType	String	否	签署方经办人的证件类型，支持以下类型 ID_CARD 居民身份证 (默认值) HONGKONG_AND_MACAO 港澳居民来往内地通行证 HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证(格式同居民身份证) OTHER_CARD_TYPE 其他证件注: `其他证件类型为白名单功能，使用前请联系对接的客户经理沟通。` 示例值：ID_CARD
ApproverIdCardNumber	String	否	签署方经办人的证件号码，应符合以下规则居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。港澳居民来往内地通行证号码应为9位字符串，第1位为“C”，第2位为英文字母（但“I”、“O”除外），后7位为阿拉伯数字。港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。示例值：xxx
NotifyType	String	否	通知签署方经办人的方式, 有以下途径: sms : (默认)短信 none : 不通知示例值：sms
ApproverRole	Integer	否	收据场景设置签署人角色类型, 可以设置如下**类型**: 1 :收款人 2 :开具人 3 :见证人注: `收据场景为白名单功能，使用前请联系对接的客户经理沟通。` 示例值：1
ApproverRoleName	String	否	可以自定义签署人角色名：收款人、开具人、见证人等，长度不能超过20，只能由中文、字母、数字和下划线组成。注: `如果是用模板发起, 优先使用此处上传的, 如果不传则用模板的配置的` 示例值：收款人
VerifyChannel	Array of String	否	签署意愿确认渠道，默认为WEIXINAPP:人脸识别注: 将要废弃, 用ApproverSignTypes签署人签署合同时的认证方式代替, 新客户可请用ApproverSignTypes来设置示例值：["WEIXINAPP"]
PreReadTime	Integer	否	签署方在签署合同之前，需要强制阅读合同的时长，可指定为3秒至300秒之间的任意值。若未指定阅读时间，则会按照合同页数大小计算阅读时间，计算规则如下：合同页数少于等于2页，阅读时间为3秒；合同页数为3到5页，阅读时间为5秒；合同页数大于等于6页，阅读时间为10秒。示例值：3
UserId	String	否	签署人userId，仅支持本企业的员工userid，可在控制台组织管理处获得注: `若传此字段则以userid的信息为主，会覆盖传递过来的签署人基本信息，包括姓名，手机号，证件类型等信息`
ApproverSource	String	否	在企微场景下使用，需设置参数为WEWORKAPP，以表明合同来源于企微。
CustomApproverTag	String	否	在企业微信场景下，表明该合同流程为或签，其最大长度为64位字符串。所有参与或签的人员均需具备该标识。注意，在合同中，不同的或签参与人必须保证其CustomApproverTag唯一。如果或签签署人为本方企业微信参与人，则需要指定ApproverSource参数为WEWORKAPP。
ApproverOption	ApproverOption	否	可以控制签署方在签署合同时能否进行某些操作，例如拒签、转交他人等。详细操作可以参考开发者中心的ApproverOption结构体。
ApproverVerifyTypes	Array of Integer	否	指定个人签署方查看合同的校验方式,可以传值如下: 1 : （默认）人脸识别,人脸识别后才能合同内容 2 : 手机号验证, 用户手机号和参与方手机号(ApproverMobile)相同即可查看合同内容（当手写签名方式为OCR_ESIGN时，该校验方式无效，因为这种签名方式依赖实名认证）注: 如果合同流程设置ApproverVerifyType查看合同的校验方式, 则忽略此签署人的查看合同的校验方式此字段可传多个校验方式示例值：[1,2]
ApproverSignTypes	Array of Integer	否	您可以指定签署方签署合同的认证校验方式，可传递以下值： 1：人脸认证，需进行人脸识别成功后才能签署合同； 2：签署密码，需输入与用户在腾讯电子签设置的密码一致才能校验成功进行合同签署； 3：运营商三要素，需到运营商处比对手机号实名信息（名字、手机号、证件号）校验一致才能成功进行合同签署。注： 1. 默认情况下，认证校验方式为人脸认证和签署密码两种形式 2. 您可以传递多种值，表示可用多种认证校验方式 3. 运营商三要素认证方式对手机号运营商及前缀有限制,可以参考运营商支持列表类得到具体的支持说明示例值：[1,2,3]
ApproverNeedSignReview	Boolean	否	发起方企业的签署人进行签署操作前，是否需要企业内部走审批流程，取值如下： false：（默认）不需要审批，直接签署。 true：需要走审批流程。当到对应参与人签署时，会阻塞其签署操作，等待企业内部审批完成。企业可以通过CreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果如果企业通知腾讯电子签平台审核通过，签署方可继续签署动作。如果企业通知腾讯电子签平台审核未通过，平台将继续阻塞签署方的签署动作，直到企业通知平台审核通过。注：`此功能可用于与企业内部的审批流程进行关联，支持手动、静默签署合同`
AddSignComponentsLimits	Array of ComponentLimit	否	用PDF文件创建签署流程时,如果设置了外层参数SignBeanTag=1(允许签署过程中添加签署控件),则可通过此参数明确规定合同所使用的签署控件类型（骑缝章、普通章法人章等）和具体的印章（印章ID）或签名方式。注：`限制印章控件或骑缝章控件情况下,仅本企业签署方可以指定具体印章（通过传递ComponentValue,支持多个），他方企业或个人只支持限制控件类型。`
SignInstructionContent	String	否	签署须知：支持传入富文本，最长字数：500个中文字符

ApproverItem

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

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

名称	类型	描述
SignId	String	签署方唯一编号注意：此字段可能返回 null，表示取不到有效值。
RecipientId	String	签署方角色编号注意：此字段可能返回 null，表示取不到有效值。
ApproverRoleName	String	签署方角色名称注意：此字段可能返回 null，表示取不到有效值。

ApproverOption

签署人个性化能力信息

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

名称	类型	必选	描述
NoRefuse	Boolean	否	签署方是否可以拒签 false : ( 默认)可以拒签 true :不可以拒签示例值：true
NoTransfer	Boolean	否	签署方是否可以转他人处理 false : ( 默认)可以转他人处理 true :不可以转他人处理示例值：true
FillType	Integer	否	签署人信息补充类型，默认无需补充。 1 : ( 动态签署人（可发起合同后再补充签署人信息）注：`企业自动签不支持动态补充`
FlowReadLimit	String	否	签署人阅读合同限制参数取值： LimitReadTimeAndBottom，阅读合同必须限制阅读时长并且必须阅读到底 LimitReadTime，阅读合同仅限制阅读时长 LimitBottom，阅读合同仅限制必须阅读到底 NoReadTimeAndBottom，阅读合同不限制阅读时长且不限制阅读到底（白名单功能，请联系客户经理开白使用）

ApproverRestriction

指定签署人限制项

被如下接口引用：CreateMultiFlowSignQRCode。

名称	类型	必选	描述
Name	String	否	指定签署人名字示例值：张三
Mobile	String	否	指定签署人手机号，11位数字示例值：13000000000
IdCardType	String	否	指定签署人证件类型，ID_CARD-身份证示例值：ID_CARD
IdCardNumber	String	否	指定签署人证件号码，字母大写示例值：4500000000000000000

AuthorizedUser

授权用户

被如下接口引用：DescribeOrganizationSeals。

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

AutoSignConfig

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

被如下接口引用：CreateUserAutoSignEnableUrl。

名称	类型	必选	描述
UserInfo	UserThreeFactor	是	自动签开通个人用户信息, 包括名字,身份证等
CertInfoCallback	Boolean	否	是否回调证书信息: false: 不需要(默认) true:需要
UserDefineSeal	Boolean	否	是否支持用户自定义签名印章: false: 不能自己定义(默认) true: 可以自己定义
SealImgCallback	Boolean	否	回调中是否需要自动签将要使用的印章(签名) 图片的 base64: false: 不需要(默认) true: 需要
VerifyChannels	Array of String	否	开通时候的身份验证方式, 取值为： WEIXINAPP : 微信人脸识别 INSIGHT : 慧眼人脸认别 TELECOM : 运营商三要素验证注：如果是小程序开通链接，支持传 WEIXINAPP / TELECOM。为空默认 WEIXINAPP 如果是 H5 开通链接，支持传 INSIGHT / TELECOM。为空默认 INSIGHT
LicenseType	Integer	否	设置用户开通自动签时是否绑定个人自动签账号许可。 0: (默认) 使用个人自动签账号许可进行开通，个人自动签账号许可有效期1年，注: `不可解绑释放更换他人` 1: 不绑定自动签账号许可开通，后续使用合同份额进行合同发起

BillUsageDetail

用户计费使用情况详情

被如下接口引用：DescribeBillUsageDetail。

名称	类型	描述
FlowId	String	合同流程ID，为32位字符串。可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。示例值：yDwFdUUckps**uzcbXwoXbRF6ja3
OperatorName	String	合同经办人名称如果有多个经办人用分号隔开。示例值：典子谦
CreateOrganizationName	String	发起方组织机构名称示例值：典子谦示例企业
FlowName	String	合同流程的名称。示例值：典子谦示例合同
Status	Integer	当前合同状态,如下是状态码对应的状态。 0: 还没有发起 1: 等待签署 2: 部分签署 3: 拒签 4: 已签署 5: 已过期 6: 已撤销 7: 还没有预发起 8: 等待填写 9: 部分填写 10: 拒填 11: 已解除示例值：4
QuotaType	String	查询的套餐类型对应关系如下: CloudEnterprise: 企业版合同 SingleSignature: 单方签章 CloudProve: 签署报告 CloudOnlineSign: 腾讯会议在线签约 ChannelWeCard: 微工卡 SignFlow: 合同套餐 SignFace: 签署意愿（人脸识别） SignPassword: 签署意愿（密码） SignSMS: 签署意愿（短信） PersonalEssAuth: 签署人实名（腾讯电子签认证） PersonalThirdAuth: 签署人实名（信任第三方认证） OrgEssAuth: 签署企业实名 FlowNotify: 短信通知 AuthService: 企业工商信息查询示例值：CloudEnterprise
UseCount	Integer	合同使用量注: `如果消耗类型是撤销返还，此值为负值代表返还的合同数量` 示例值：1
CostTime	Integer	消耗的时间戳，格式为Unix标准时间戳（秒）。示例值：1680162193
QuotaName	String	消耗的套餐名称示例值：企业版运营礼包
CostType	Integer	消耗类型 1.扣费 2.撤销返还示例值：1
Remark	String	备注示例值：空

CallbackInfo

企业应用回调信息

被如下接口引用：ModifyApplicationCallbackInfo。

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

Caller

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

被如下接口引用：UploadFiles。

名称	类型	必选	描述
OperatorId	String	否	经办人的用户ID，同UserId 示例值：88fb0c591044be771f60aa382cc5ed0e

CcInfo

抄送信息

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

名称	类型	必选	描述
Mobile	String	否	被抄送方手机号码，支持国内手机号11位数字(无需加+86前缀或其他字符)。请确认手机号所有方为此业务通知方。示例值：xxx
Name	String	否	被抄送方姓名。抄送方的姓名将用于身份认证，请确保填写的姓名为抄送方的真实姓名，而非昵称等代名。示例值：李白
CcType	Integer	否	被抄送方类型, 可设置以下类型: 0 :个人抄送方 1 :企业员工抄送方示例值：1
CcPermission	Integer	否	被抄送方权限, 可设置如下权限: 0 :可查看合同内容 1 :可查看合同内容也可下载原文示例值：1
NotifyType	String	否	通知签署方经办人的方式, 有以下途径: sms : (默认)短信 none : 不通知示例值：sms

Component

此结构体 (Component) 用于描述控件属性。

在通过文件发起合同时，对应的component有三种定位方式

绝对定位方式
表单域(FIELD)定位方式
关键字(KEYWORD)定位方式，使用关键字定位时，请确保PDF原始文件内是关键字以文字形式保存在PDF文件中，不支持对图片内文字进行关键字查找可以参考官网说明 https://cloud.tencent.com/document/product/1323/78346#component-.E4.B8.89.E7.A7.8D.E5.AE.9A.E4.BD.8D.E6.96.B9.E5.BC.8F.E8.AF.B4.E6.98.8E

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

名称	类型	必选	描述
ComponentType	String	是	如果是Component填写控件类型，则可选的字段为： TEXT - 普通文本控件，输入文本字符串； MULTI_LINE_TEXT - 多行文本控件，输入文本字符串； CHECK_BOX - 勾选框控件，若选中填写ComponentValue 填写 true或者 false 字符串； FILL_IMAGE - 图片控件，ComponentValue 填写图片的资源 ID； DYNAMIC_TABLE - 动态表格控件； ATTACHMENT - 附件控件,ComponentValue 填写附件图片的资源 ID列表，以逗号分隔； SELECTOR - 选择器控件，ComponentValue填写选择的字符串内容； DATE - 日期控件；默认是格式化为xxxx年xx月xx日字符串； DISTRICT - 省市区行政区控件，ComponentValue填写省市区行政区字符串内容；如果是SignComponent签署控件类型，则可选的字段为 SIGN_SEAL - 签署印章控件； SIGN_DATE - 签署日期控件； SIGN_SIGNATURE - 用户签名控件； SIGN_PERSONAL_SEAL - 个人签署印章控件（使用文件发起暂不支持此类型）； SIGN_PAGING_SEAL - 骑缝章；若文件发起，需要对应填充ComponentPosY、ComponentWidth、ComponentHeight SIGN_OPINION - 签署意见控件，用户需要根据配置的签署意见内容，完成对意见内容的确认； SIGN_LEGAL_PERSON_SEAL - 企业法定代表人控件。表单域的控件不能作为印章和签名控件
FileIndex	Integer	是	控件所属文件的序号（取值为：0-N）。目前单文件的情况下，值是0
ComponentHeight	Float	是	参数控件高度，单位pt
ComponentWidth	Float	是	参数控件宽度，单位pt
ComponentPage	Integer	是	参数控件所在页码，取值为：1-N
ComponentPosX	Float	是	参数控件X位置，单位pt
ComponentPosY	Float	是	参数控件Y位置，单位pt
ComponentId	String	否	控件唯一ID。或使用文件发起合同时用于GenerateMode==KEYWORD 指定关键字
ComponentName	String	否	控件名。或使用文件发起合同时用于GenerateMode==FIELD 指定表单域名称
ComponentRequired	Boolean	否	是否必选，默认为false-非必选
ComponentRecipientId	String	否	控件关联的参与方ID，对应Recipient结构体中的RecipientId
ComponentExtra	String	否	扩展参数：为JSON格式。不同类型的控件会有部分非通用参数 ComponentType为TEXT、MULTI_LINE_TEXT时，支持以下参数： 1 Font：目前只支持黑体、宋体 2 FontSize：范围12-72 3 FontAlign： Left/Right/Center，左对齐/居中/右对齐 4 FontColor：字符串类型，格式为RGB颜色数字参数样例：{\"FontColor\":\"255,0,0\",\"FontSize\":12} ComponentType为FILL_IMAGE时，支持以下参数： NotMakeImageCenter：bool。是否设置图片居中。false：居中（默认）。 true: 不居中 FillMethod: int. 填充方式。0-铺满（默认）；1-等比例缩放 ComponentType为SIGN_SIGNATURE类型可以控制签署方式 {“ComponentTypeLimit”: [“xxx”]} xxx可以为： HANDWRITE – 手写签名 OCR_ESIGN -- AI智能识别手写签名 ESIGN -- 个人印章类型 SYSTEM_ESIGN -- 系统签名（该类型可以在用户签署时根据用户姓名一键生成一个签名来进行签署）如：{“ComponentTypeLimit”: [“SYSTEM_ESIGN”]} ComponentType为SIGN_DATE时，支持以下参数： 1 Font：字符串类型目前只支持"黑体"、"宋体"，如果不填默认为"黑体" 2 FontSize：数字类型，范围6-72，默认值为12 3 FontAlign：字符串类型，可取Left/Right/Center，对应左对齐/居中/右对齐 4 Format：字符串类型，日期格式，必须是以下五种之一 “yyyy m d”，”yyyy年m月d日”，”yyyy/m/d”，”yyyy-m-d”，”yyyy.m.d”。 5 Gaps:：字符串类型，仅在Format为“yyyy m d”时起作用，格式为用逗号分开的两个整数，例如”2,2”，两个数字分别是日期格式的前后两个空隙中的空格个数如果extra参数为空，默认为”yyyy年m月d日”格式的居中日期特别地，如果extra中Format字段为空或无法被识别，则extra参数会被当作默认值处理（Font，FontSize，Gaps和FontAlign都不会起效）参数样例： "ComponentExtra": "{"Format":“yyyy m d”,"FontSize":12,"Gaps":"2,2", "FontAlign":"Right"}" ComponentType为SIGN_SEAL类型时，支持以下参数： 1.PageRanges：PageRange的数组，通过PageRanges属性设置该印章在PDF所有页面上盖章（适用于标书在所有页面盖章的情况）参数样例： "ComponentExtra":"{"PageRange":[{"BeginPage":1,"EndPage":-1}]}"
IsFormType	Boolean	否	是否是表单域类型，默认false-不是注意：此字段可能返回 null，表示取不到有效值。
ComponentValue	String	否	控件填充vaule，ComponentType和传入值类型对应关系： TEXT - 文本内容 MULTILINE_TEXT - 文本内容 CHECK_BOX - true/false FILL_IMAGE、ATTACHMENT - 附件的FileId，需要通过UploadFiles接口上传获取 SELECTOR - 选项值 DYNAMIC_TABLE - 传入json格式的表格内容，具体见数据结构FlowInfo：https://cloud.tencent.com/document/api/1420/61525#FlowInfo DATE - 默认是格式化为xxxx年xx月xx日 SIGN_SEAL - 印章ID，于控制台查询获取 SIGN_PAGING_SEAL - 可以指定印章ID，于控制台查询获取控件值约束说明：企业全称控件：约束：企业名称中文字符中文括号检查正则表达式：/^[\u3400-\u4dbf\u4e00-\u9fa5（）]+$/ 统一社会信用代码控件：检查正则表达式：/^[A-Z0-9]{1,18}$/ 法人名称控件：约束：最大50个字符，2到25个汉字或者1到50个字母检查正则表达式：/^([\u3400-\u4dbf\u4e00-\u9fa5.·]{2,25}\|[a-zA-Z·,\s-]{1,50})$/ 签署意见控件：约束：签署意见最大长度为50字符签署人手机号控件：约束：国内手机号 13,14,15,16,17,18,19号段长度11位签署人身份证控件：约束：合法的身份证号码检查控件名称：约束：控件名称最大长度为20字符单行文本控件：约束：只允许输入中文，英文，数字，中英文标点符号多行文本控件：约束：只允许输入中文，英文，数字，中英文标点符号勾选框控件：约束：选择填字符串true，不选填字符串false 选择器控件：约束：同单行文本控件约束，填写选择值中的字符串数字控件：约束：请输入有效的数字(可带小数点) 检查正则表达式：/^(-\|+)?\d+(.\d+)?$/ 日期控件：约束：格式：yyyy年mm月dd日附件控件：约束：JPG或PNG图片，上传数量限制，1到6个，最大6个附件图片控件：约束：JPG或PNG图片，填写上传的图片资源ID 邮箱控件：约束：请输入有效的邮箱地址, w3c标准检查正则表达式：/^([A-Za-z0-9-.!#$%&])+@([A-Za-z0-9_-.])+.([A-Za-z]{2,4})$/ 参考：https://emailregex.com/ 地址控件：同单行文本控件约束省市区控件：同单行文本控件约束性别控件：同单行文本控件约束，填写选择值中的字符串学历控件：同单行文本控件约束，填写选择值中的字符串
GenerateMode	String	否	控件生成的方式： NORMAL - 普通控件 FIELD - 表单域 KEYWORD - 关键字（设置关键字时，请确保PDF原始文件内是关键字以文字形式保存在PDF文件中，不支持对图片内文字进行关键字查找）
ComponentDateFontSize	Integer	否	日期签署控件的字号，默认为 12
ChannelComponentId	String	否	第三方应用集成平台模板控件 ID 标识
OffsetX	Float	否	指定关键字时横坐标偏移量，单位pt 注意：此字段可能返回 null，表示取不到有效值。
OffsetY	Float	否	指定关键字时纵坐标偏移量，单位pt 注意：此字段可能返回 null，表示取不到有效值。
ChannelComponentSource	Integer	否	第三方应用集成中子客企业控件来源。 0-平台指定； 1-用户自定义
KeywordOrder	String	否	指定关键字排序规则，Positive-正序，Reverse-倒序。传入Positive时会根据关键字在PDF文件内的顺序进行排列。在指定KeywordIndexes时，0代表在PDF内查找内容时，查找到的第一个关键字。传入Reverse时会根据关键字在PDF文件内的反序进行排列。在指定KeywordIndexes时，0代表在PDF内查找内容时，查找到的最后一个关键字。示例值：Positive\Reverse
KeywordPage	Integer	否	指定关键字页码。指定页码后，将只在指定的页码内查找关键字，非该页码的关键字将不会查询出来
RelativeLocation	String	否	关键字位置模式， Middle-居中， Below-正下方， Right-正右方， LowerRight-右上角， UpperRight-右下角。示例：如果设置Middle的关键字盖章，则印章的中心会和关键字的中心重合，如果设置Below，则印章在关键字的正下方
KeywordIndexes	Array of Integer	否	关键字索引。如果一个关键字在PDF文件中存在多个，可以通过关键字索引指定使用第几个关键字作为最后的结果，可指定多个索引。示例：[0,2]，说明使用PDF文件内第1个和第3个关键字位置。
LockComponentValue	Boolean	否	是否锁定控件值不允许编辑（嵌入式发起使用）默认false：不锁定控件值，允许在页面编辑控件值注意：此字段可能返回 null，表示取不到有效值。
ForbidMoveAndDelete	Boolean	否	是否禁止移动和删除控件默认false，不禁止移动和删除控件注意：此字段可能返回 null，表示取不到有效值。

ComponentLimit

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

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

名称	类型	必选	描述
ComponentType	String	是	控件类型，支持以下类型 SIGN_SEAL : 印章控件 SIGN_PAGING_SEAL : 骑缝章控件 SIGN_LEGAL_PERSON_SEAL : 企业法定代表人控件 SIGN_SIGNATURE : 用户签名控件
ComponentValue	Array 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。

名称	类型	必选	描述
CanEditFlow	Boolean	否	是否允许修改发起合同时确认弹窗的合同信息（合同名称、合同类型、签署截止时间），若不允许编辑，则表单字段将被禁止输入。 true：允许编辑 false：不允许编辑（默认值）示例值：true
CanEditFormField	Boolean	否	是否允许编辑模板控件 true:允许编辑模板控件信息 false:不允许编辑模板控件信息（默认值）示例值：true
HideShowFlowName	Boolean	否	发起页面隐藏合同名称展示 true:发起页面隐藏合同名称展示 false:发起页面不隐藏合同名称展示（默认值）示例值：true
HideShowFlowType	Boolean	否	发起页面隐藏合同类型展示 true:发起页面隐藏合同类型展示 false:发起页面不隐藏合同类型展示（默认值）示例值：true
HideShowDeadline	Boolean	否	发起页面隐藏合同截止日期展示 true:发起页面隐藏合同截止日期展示 false:发起页面不隐藏合同截止日期展示（默认值）示例值：true
CanSkipAddApprover	Boolean	否	发起页面允许跳过添加签署人环节 true:发起页面允许跳过添加签署人环节 false:发起页面不允许跳过添加签署人环节（默认值）示例值：true
SkipUploadFile	Boolean	否	文件发起页面跳过文件上传步骤 true:文件发起页面跳过文件上传步骤 false:文件发起页面不跳过文件上传步骤（默认值）示例值：true
ForbidEditFillComponent	Boolean	否	禁止编辑填写控件 true:禁止编辑填写控件 false:允许编辑填写控件（默认值）示例值：true
CustomCreateFlowDescription	String	否	定制化发起合同弹窗的描述信息，描述信息最长500字符示例值：""

CreateStaffResult

创建员工的结果

被如下接口引用：CreateIntegrationEmployees。

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

DeleteStaffsResult

删除员工结果

被如下接口引用：DeleteIntegrationEmployees。

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

Department

集成版员工部门信息。

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

名称	类型	必选	描述
DepartmentId	String	否	部门ID。示例值：dp**155f2
DepartmentName	String	否	部门名称。示例值：测试部门

EmbedUrlOption

个性化参数

被如下接口引用：CreateEmbedWebUrl。

名称	类型	必选	描述
ShowFlowDetailComponent	Boolean	否	合同详情预览，允许展示控件信息 true：允许在合同详情页展示控件 false：不允许在合同详情页展示控件默认false，合同详情页不展示控件示例值：true
ShowTemplateComponent	Boolean	否	模板预览，允许展示模板控件信息 true：允许在模板预览页展示控件 false：不允许在模板预览页展示控件默认false，模板预览页不展示控件示例值：true

ExtendAuthInfo

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

被如下接口引用：DescribeExtendedServiceAuthInfos。

名称	类型	必选	描述
Type	String	否	扩展服务的类型，可能是以下值： OPEN_SERVER_SIGN：企业静默签署 OVERSEA_SIGN：企业与港澳台居民签署合同 MOBILE_CHECK_APPROVER：使用手机号验证签署方身份 PAGING_SEAL：骑缝章 BATCH_SIGN：批量签署示例值：BATCH_SIGN
Name	String	否	扩展服务的名称示例值：批量签署
Status	String	否	扩展服务的开通状态： ENABLE：开通 DISABLE：未开通示例值：ENABLE
OperatorUserId	String	否	操作扩展服务的操作人UserId，员工在腾讯电子签平台的唯一身份标识，为32位字符串。注意：此字段可能返回 null，表示取不到有效值。示例值：yDR****CLU
OperateOn	Integer	否	扩展服务的操作时间，格式为Unix标准时间戳（秒）。注意：此字段可能返回 null，表示取不到有效值。示例值：1693557098
HasAuthUserList	Array of HasAuthUser	否	该扩展服务若可以授权，此参数对应授权人员的列表注意：此字段可能返回 null，表示取不到有效值。

FailedCreateRoleData

绑定角色失败信息

被如下接口引用：CreateIntegrationUserRoles。

名称	类型	描述
UserId	String	用户userId 注意：此字段可能返回 null，表示取不到有效值。
RoleIds	Array of String	角色id列表注意：此字段可能返回 null，表示取不到有效值。

FailedCreateStaffData

创建员工的失败数据

被如下接口引用：CreateIntegrationEmployees。

名称	类型	描述
DisplayName	String	员工名
Mobile	String	员工手机号
WeworkOpenId	String	传入的企微账号id
Reason	String	失败原因

FailedDeleteStaffData

删除员工失败数据

被如下接口引用：DeleteIntegrationEmployees。

名称	类型	描述
UserId	String	员工在电子签的userId 注意：此字段可能返回 null，表示取不到有效值。
OpenId	String	员工在第三方平台的openId 注意：此字段可能返回 null，表示取不到有效值。
Reason	String	失败原因

FailedUpdateStaffData

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

被如下接口引用：UpdateIntegrationEmployees。

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

FileInfo

模板中文件的信息结构

被如下接口引用：DescribeFlowTemplates。

名称	类型	必选	描述
FileId	String	否	文件ID
FileName	String	否	文件名
FileSize	Integer	否	文件大小，单位为Byte
CreatedOn	Integer	否	文件上传时间，格式为Unix标准时间戳（秒）

FileUrl

下载文件的URL信息

被如下接口引用：DescribeFileUrls。

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

FillApproverInfo

补充签署人信息

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

被如下接口引用：CreateFlowApprovers。

名称	类型	必选	描述
RecipientId	String	是	签署方经办人在模板中配置的参与方ID，与控件绑定，是控件的归属方，ID为32位字符串。模板发起合同时，该参数为必填项。文件发起合同是，该参数无需传值。如果开发者后序用合同模板发起合同，建议保存此值，在用合同模板发起合同中需此值绑定对应的签署经办人。示例值：yDwhSUUckp3lqxlpUu6Ni3SvjJPoxxxx
ApproverSource	String	否	签署人来源 WEWORKAPP: 企业微信仅【企微或签】时指定WEWORKAPP 示例值：WEWORKAPP
CustomUserId	String	否	企业微信UserId 当ApproverSource为WEWORKAPP的企微或签场景下，必须指企业自有应用获取企业微信的UserId 示例值：zhangsan
ApproverName	String	否	补充企业签署人员工姓名示例值：张三
ApproverMobile	String	否	补充企业签署人员工手机号示例值：188xxxxxxxx
OrganizationName	String	否	补充企业动态签署人时，需要指定对应企业名称

FillError

批量补充签署人时，补充失败的报错说明

被如下接口引用：CreateFlowApprovers。

名称	类型	描述
RecipientId	String	为签署方经办人在签署合同中的参与方ID，与控件绑定，是控件的归属方，ID为32位字符串。与入参中补充的签署人角色ID对应，批量补充部分失败返回对应的错误信息。注意：此字段可能返回 null，表示取不到有效值。
ErrMessage	String	补充失败错误说明注意：此字段可能返回 null，表示取不到有效值。

FilledComponent

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

被如下接口引用：DescribeFlowComponents。

名称	类型	描述
ComponentId	String	控件Id 注意：此字段可能返回 null，表示取不到有效值。
ComponentName	String	控件名称注意：此字段可能返回 null，表示取不到有效值。
ComponentFillStatus	String	控件填写状态；0-未填写；1-已填写注意：此字段可能返回 null，表示取不到有效值。
ComponentValue	String	控件填写内容注意：此字段可能返回 null，表示取不到有效值。
ComponentRecipientId	String	控件所属参与方Id 注意：此字段可能返回 null，表示取不到有效值。
ImageUrl	String	图片填充控件下载链接，如果是图片填充控件时，这里返回图片的下载链接。注意：此字段可能返回 null，表示取不到有效值。

Filter

查询过滤条件

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

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

FlowApproverDetail

签署人详情信息

被如下接口引用：DescribeFlowInfo。

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

FlowApproverUrlInfo

签署链接信息。

被如下接口引用：CreateBatchQuickSignUrl, CreateFlowSignUrl。

名称	类型	描述
SignUrl	String	签署短链接。注意: - 该链接有效期为30分钟，同时需要注意保密，不要外泄给无关用户。 - 该链接不支持小程序嵌入，仅支持移动端浏览器打开。注意：此字段可能返回 null，表示取不到有效值。示例值：https://essurl.cn/M**XE
ApproverType	Integer	签署人类型。 - 1: 个人注意：此字段可能返回 null，表示取不到有效值。示例值：1
ApproverName	String	签署人姓名。注意：此字段可能返回 null，表示取不到有效值。示例值：典子谦
ApproverMobile	String	签署人手机号。注意：此字段可能返回 null，表示取不到有效值。示例值：13200000000
LongUrl	String	签署长链接。注意: - 该链接有效期为30分钟，同时需要注意保密，不要外泄给无关用户。 - 该链接不支持小程序嵌入，仅支持移动端浏览器打开。注意：此字段可能返回 null，表示取不到有效值。示例值：https://quick.qian.tencent.cn/home?ApproverIdCardNumber=MioqKKio2&ApproverMobile=MTkx%3D&ApproverName=%25E2A&ApproverType=1&Code=yDSw3u2Mg8q&CodeType=QUICK&FlowId=yDSLVUUMszDy&ShowHeader=1&shortKey=yDwq5UGlG1c&token=M**XE

FlowBrief

合同流程的基础信息

被如下接口引用：DescribeFlowBriefs。

名称	类型	描述
FlowId	String	合同流程ID，为32位字符串。示例值：yDRCLUUgygq2xun5UuO4zjEwg0vjoimj
FlowName	String	合同流程的名称。示例值：测试合同-1
FlowDescription	String	合同流程描述信息。注意：此字段可能返回 null，表示取不到有效值。示例值：测试流程的描述信息
FlowType	String	合同流程的类别分类（如销售合同/入职合同等）。示例值：入职合同
FlowStatus	Integer	合同流程当前的签署状态, 会存在下列的状态值 0 : 未开启流程(合同中不存在填写环节) 1 : 待签署 2 : 部分签署 3 : 已拒签 4 : 已签署 5 : 已过期 6 : 已撤销 7 : 未开启流程(合同中存在填写环节) 8 : 等待填写 9 : 部分填写 10 : 已拒填 21 : 已解除注意：此字段可能返回 null，表示取不到有效值。示例值：1
CreatedOn	Integer	合同流程创建时间，格式为Unix标准时间戳（秒）。注意：此字段可能返回 null，表示取不到有效值。示例值：1604910798
FlowMessage	String	当合同流程状态为已拒签（即 FlowStatus=3）或已撤销（即 FlowStatus=6）时，此字段 FlowMessage 为拒签或撤销原因。注意：此字段可能返回 null，表示取不到有效值。示例值：因合同中的预付款金额错误所以撤销此合同
Creator	String	合同流程发起方的员工编号, 即员工在腾讯电子签平台的唯一身份标识。注意：此字段可能返回 null，表示取不到有效值。示例值：yDxVwUyKQWho8CUuO4zjEyQOAgwvr4Zy
Deadline	Integer	合同流程的签署截止时间，格式为Unix标准时间戳（秒）。注意：此字段可能返回 null，表示取不到有效值。示例值：1606910798

FlowCreateApprover

创建流程的签署方信息

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

名称	类型	必选	描述
ApproverType	Integer	是	在指定签署方时，可选择企业B端或个人C端等不同的参与者类型，可选类型如下: 0：企业 1：个人 3：企业静默签署注：类型为3（企业静默签署）时，此接口会默认完成该签署方的签署。静默签署仅进行盖章操作，不能自动签名。 7: 个人自动签署，适用于个人自动签场景。注: 个人自动签场景为白名单功能，使用前请联系对接的客户经理沟通。示例值：1
OrganizationName	String	否	组织机构名称。请确认该名称与企业营业执照中注册的名称一致。如果名称中包含英文括号()，请使用中文括号（）代替。注: `当approverType=0(企业签署方) 或 approverType=3(企业静默签署)时，必须指定`
ApproverName	String	否	签署方经办人的姓名。经办人的姓名将用于身份认证和电子签名，请确保填写的姓名为签署方的真实姓名，而非昵称等代名。在未指定签署人电子签UserId情况下，为必填参数
ApproverMobile	String	否	签署方经办人手机号码，支持国内手机号11位数字(无需加+86前缀或其他字符)。请确认手机号所有方为此合同签署方。在未指定签署人电子签UserId情况下，为必填参数
ApproverIdCardType	String	否	证件类型，支持以下类型 ID_CARD : 居民身份证 (默认值) HONGKONG_AND_MACAO : 港澳居民来往内地通行证 HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证) 示例值：ID_CARD
ApproverIdCardNumber	String	否	证件号码，应符合以下规则居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。港澳居民来往内地通行证号码应为9位字符串，第1位为“C”，第2位为英文字母（但“I”、“O”除外），后7位为阿拉伯数字。港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。示例值：620000198802020000
RecipientId	String	否	签署方经办人在模板中配置的参与方ID，与控件绑定，是控件的归属方，ID为32位字符串。模板发起合同时，该参数为必填项。文件发起合同时，该参数无需传值。如果开发者后续用合同模板发起合同，建议保存此值，在用合同模板发起合同中需此值绑定对应的签署经办人。
VerifyChannel	Array of String	否	签署意愿确认渠道，默认为WEIXINAPP:人脸识别注: 将要废弃, 用ApproverSignTypes签署人签署合同时的认证方式代替, 新客户可请用ApproverSignTypes来设置示例值：["WEIXINAPP"]
NotifyType	String	否	通知签署方经办人的方式, 有以下途径: sms : (默认)短信 none : 不通知注: `发起方也是签署方时不给此签署方发送短信`
IsFullText	Boolean	否	合同强制需要阅读全文，无需传此参数
PreReadTime	Integer	否	合同的强制预览时间：3~300s，未指定则按合同页数计算
UserId	String	否	签署人userId，仅支持本企业的员工userid，可在控制台组织管理处获得注: `若传此字段则以userid的信息为主，会覆盖传递过来的签署人基本信息，包括姓名，手机号，证件类型等信息`
Required	Boolean	否	字段已经废弃，当前只支持true，默认为true
ApproverSource	String	否	在企微场景下使用，需设置参数为WEWORKAPP，以表明合同来源于企微。
CustomApproverTag	String	否	在企业微信场景下，表明该合同流程为或签，其最大长度为64位字符串。所有参与或签的人员均需具备该标识。注意，在合同中，不同的或签参与人必须保证其CustomApproverTag唯一。如果或签签署人为本方企业微信参与人，则需要指定ApproverSource参数为WEWORKAPP。
RegisterInfo	RegisterInfo	否	已经废弃, 快速注册相关信息
ApproverOption	ApproverOption	否	签署人个性化能力值，如是否可以转发他人处理、是否可以拒签、是否为动态补充签署人等功能开关。
SignId	String	否	签署ID - 发起流程时系统自动补充 - 创建签署链接时，可以通过查询详情接口获得签署人的SignId，然后可传入此值为该签署人创建签署链接，无需再传姓名、手机号、证件号等其他信息
ApproverNeedSignReview	Boolean	否	发起方企业的签署人进行签署操作前，是否需要企业内部走审批流程，取值如下： false：（默认）不需要审批，直接签署。 true：需要走审批流程。当到对应参与人签署时，会阻塞其签署操作，等待企业内部审批完成。企业可以通过CreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果如果企业通知腾讯电子签平台审核通过，签署方可继续签署动作。如果企业通知腾讯电子签平台审核未通过，平台将继续阻塞签署方的签署动作，直到企业通知平台审核通过。注：`此功能可用于与企业内部的审批流程进行关联，支持手动、静默签署合同`
SignComponents	Array of Component	否	签署人签署控件，此参数仅针对文件发起（CreateFlowByFiles）生效合同中的签署控件列表，列表中可支持下列多种签署控件,控件的详细定义参考开发者中心的Component结构体个人签名/印章企业印章骑缝章等签署控件 `此参数仅针对文件发起设置生效,模板发起合同签署流程, 请以模板配置为主`
Components	Array of Component	否	签署人填写控件此参数仅针对文件发起（CreateFlowByFiles）生效合同中的填写控件列表，列表中可支持下列多种填写控件，控件的详细定义参考开发者中心的Component结构体单行文本控件多行文本控件勾选框控件数字控件图片控件动态表格等填写控件 `此参数仅针对文件发起设置生效,模板发起合同签署流程, 请以模板配置为主`
ComponentLimitType	Array of String	否	签署方控件类型为 SIGN_SIGNATURE时，可以指定签署方签名方式 HANDWRITE – 手写签名 OCR_ESIGN -- AI智能识别手写签名 ESIGN -- 个人印章类型 SYSTEM_ESIGN -- 系统签名（该类型可以在用户签署时根据用户姓名一键生成一个签名来进行签署）
ApproverVerifyTypes	Array of Integer	否	指定个人签署方查看合同的校验方式,可以传值如下: 1 : （默认）人脸识别,人脸识别后才能合同内容 2 : 手机号验证, 用户手机号和参与方手机号(ApproverMobile)相同即可查看合同内容（当手写签名方式为OCR_ESIGN时，该校验方式无效，因为这种签名方式依赖实名认证）注: 如果合同流程设置ApproverVerifyType查看合同的校验方式, 则忽略此签署人的查看合同的校验方式此字段可传多个校验方式 `此参数仅针对文件发起设置生效,模板发起合同签署流程, 请以模板配置为主` . 示例值：[1,2]
ApproverSignTypes	Array of Integer	否	您可以指定签署方签署合同的认证校验方式，可传递以下值： 1：人脸认证，需进行人脸识别成功后才能签署合同； 2：签署密码，需输入与用户在腾讯电子签设置的密码一致才能校验成功进行合同签署； 3：运营商三要素，需到运营商处比对手机号实名信息（名字、手机号、证件号）校验一致才能成功进行合同签署。注：默认情况下，认证校验方式为人脸认证和签署密码两种形式；您可以传递多种值，表示可用多种认证校验方式。注: `此参数仅针对文件发起设置生效,模板发起合同签署流程, 请以模板配置为主` 示例值：[1,2]

FlowDetailInfo

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

被如下接口引用：DescribeFlowInfo。

名称	类型	描述
FlowId	String	合同流程ID，为32位字符串。示例值：yDRCLUUgygq2xun5UuO4zjEwg0vjoimj
FlowName	String	合同流程的名称（可自定义此名称），长度不能超过200，只能由中文、字母、数字和下划线组成。示例值：购买50吨西瓜的采购合同
FlowType	String	合同流程的类别分类（如销售合同/入职合同等）。注意：此字段可能返回 null，表示取不到有效值。示例值：入职合同
FlowStatus	Integer	合同流程当前的签署状态, 会存在下列的状态值 0 : 未开启流程(合同中不存在填写环节) 1 : 待签署 2 : 部分签署 3 : 已拒签 4 : 已签署 5 : 已过期 6 : 已撤销 7 : 未开启流程(合同中存在填写环节) 8 : 等待填写 9 : 部分填写 10 : 已拒填 21 : 已解除示例值：1
FlowMessage	String	当合同流程状态为已拒签（即 FlowStatus=3）或已撤销（即 FlowStatus=6）时，此字段 FlowMessage 为拒签或撤销原因。注意：此字段可能返回 null，表示取不到有效值。示例值：因合同中的预付款金额错误所以撤销此合同
FlowDescription	String	合同流程描述信息。注意：此字段可能返回 null，表示取不到有效值。示例值：测试流程的描述信息
CreatedOn	Integer	合同流程的创建时间戳，格式为Unix标准时间戳（秒）。示例值：1606910798
FlowApproverInfos	Array of FlowApproverDetail	合同流程的签署方数组
CcInfos	Array of FlowApproverDetail	合同流程的关注方信息数组
Creator	String	合同流程发起方的员工编号, 即员工在腾讯电子签平台的唯一身份标识。注意：此字段可能返回 null，表示取不到有效值。示例值：yDxVwUyKQWho8CUuO4zjEyQOAgwvr4Zy

FlowGroupInfo

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

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

名称	类型	必选	描述
FlowName	String	是	合同流程的名称（可自定义此名称），长度不能超过200，只能由中文、字母、数字和下划线组成。该名称还将用于合同签署完成后的下载文件名。
Approvers	Array of ApproverInfo	是	签署流程参与者信息，最大限制50方注意 approver中的顺序需要和模板中的顺序保持一致，否则会导致模板中配置的信息无效。
FileIds	Array of String	否	文件资源ID，通过多文件上传UploadFiles接口获得，为32位字符串。建议开发者保存此资源ID，后续创建合同或创建合同流程需此资源ID。
TemplateId	String	否	合同模板ID，为32位字符串。建议开发者保存此模板ID，后续用此模板发起合同流程需要此参数。可登录腾讯电子签控制台，在 "模板"->"模板中心"->"列表展示设置"选中模板 ID 中查看某个模板的TemplateId(在页面中展示为模板ID)。
FlowType	String	否	签署流程的类型(如销售合同/入职合同等)，最大长度200个字符示例值：劳务合同
FlowDescription	String	否	签署流程描述,最大长度1000个字符
Deadline	Integer	否	签署流程的签署截止时间。值为unix时间戳,精确到秒,不传默认为当前时间一年后示例值：1604912664
UserData	String	否	调用方自定义的个性化字段(可自定义此字段的值)，并以base64方式编码，支持的最大数据大小为 20480长度。在合同状态变更的回调信息等场景中，该字段的信息将原封不动地透传给贵方。回调的相关说明可参考开发者中心的回调通知模块。
Unordered	Boolean	否	发送类型： true：无序签 false：有序签注：默认为false（有序签），请和模板中的配置保持一致示例值：true
Components	Array of Component	否	模板或者合同中的填写控件列表，列表中可支持下列多种填写控件，控件的详细定义参考开发者中心的Component结构体单行文本控件多行文本控件勾选框控件数字控件图片控件动态表格等填写控件
NeedSignReview	Boolean	否	发起方企业的签署人进行签署操作是否需要企业内部审批。使用此功能需要发起方企业有参与签署。若设置为true，审核结果需通过接口 CreateFlowSignReview 通知电子签，审核通过后，发起方企业签署人方可进行签署操作，否则会阻塞其签署操作。注：企业可以通过此功能与企业内部的审批流程进行关联，支持手动、静默签署合同。示例值：true
AutoSignScene	String	否	个人自动签场景。发起自动签署时，需设置对应自动签署场景，目前仅支持场景：处方单-E_PRESCRIPTION_AUTO_SIGN 示例值：E_PRESCRIPTION_AUTO_SIGN

FlowGroupOptions

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

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

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

FormField

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

当控件的 ComponentType=‘SIGN_SEAL'时，FormField.ComponentValue填入印章id。

可用于指定自动签模板未设置自动签印章时，可由接口传入自动签印章
若指定的控件上已设置ComponentValue，那以已经设置的ComponentValue为准

FormField输入示例：
{
    "ComponentId": "componentId1",
    "ComponentValue": "sealId（印章id）"
}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

FormField输入示例：
{
    "ComponentId": "componentId1",
    "ComponentValue": "广东省深圳市福田区"
}

【数据表格传参说明】当控件的 ComponentType='DYNAMIC_TABLE'时，FormField.ComponentValue需要传递json格式的字符串参数，用于确定表头&填充数据表格（支持内容的单元格合并）输入示例1：

{
    "headers":[
        {
            "content":"head1"
        },
        {
            "content":"head2"
        },
        {
            "content":"head3"
        }
    ],
    "rowCount":3,
    "body":{
        "cells":[
            {
                "rowStart":1,
                "rowEnd":1,
                "columnStart":1,
                "columnEnd":1,
                "content":"123"
            },
            {
                "rowStart":2,
                "rowEnd":3,
                "columnStart":1,
                "columnEnd":2,
                "content":"456"
            },
            {
                "rowStart":3,
                "rowEnd":3,
                "columnStart":3,
                "columnEnd":3,
                "content":"789"
            }
        ]
    }
}

输入示例2（表格表头宽度比例配置）：

{
    "headers":[
        {
            "content":"head1",
            "widthPercent": 30
        },
        {
            "content":"head2",
            "widthPercent": 30
        },
        {
            "content":"head3",
            "widthPercent": 40
        }
    ],
    "rowCount":3,
    "body":{
        "cells":[
            {
                "rowStart":1,
                "rowEnd":1,
                "columnStart":1,
                "columnEnd":1,
                "content":"123"
            },
            {
                "rowStart":2,
                "rowEnd":3,
                "columnStart":1,
                "columnEnd":2,
                "content":"456"
            },
            {
                "rowStart":3,
                "rowEnd":3,
                "columnStart":3,
                "columnEnd":3,
                "content":"789"
            }
        ]
    }
}

输入示例3（表格设置字体加粗颜色）：

{
    "headers":[
        {
            "content":"head1"
        },
        {
            "content":"head2"
        },
        {
            "content":"head3"
        }
    ],
    "rowCount":3,
    "body":{
        "cells":[
            {
                "rowStart":1,
                "rowEnd":1,
                "columnStart":1,
                "columnEnd":1,
                "content":"123",
                "style": "{"color": "#b50000", "fontSize": 12,"bold": true,"align": "CENTER"}" 
            },
            {
                "rowStart":2,
                "rowEnd":3,
                "columnStart":1,
                "columnEnd":2,
                "content":"456",
                "style": {"color": "#b50000", "fontSize": 12,"bold": true,"align": "LEFT"}" 
            },
            {
                "rowStart":3,
                "rowEnd":3,
                "columnStart":3,
                "columnEnd":3,
                "content":"789",
                "style": {"color": "#b500bf", "fontSize": 12,"bold": false,"align": "RIGHT"}
            }
        ]
    }
}

表格参数说明

名称	类型	描述
headers	Array	表头：不超过10列，不支持单元格合并，字数不超过100
rowCount	Integer	表格内容最大行数
cells.N.rowStart	Integer	单元格坐标：行起始index
cells.N.rowEnd	Integer	单元格坐标：行结束index
cells.N.columnStart	Integer	单元格坐标：列起始index
cells.N.columnEnd	Integer	单元格坐标：列结束index
cells.N.content	String	单元格内容，字数不超过100
cells.N.style	String	单元格字体风格配置，风格配置的json字符串如： {"font":"黑体","fontSize":12,"color":"FFFFFF","bold":true,"align":"CENTER"}

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

content String 表头单元格内容，字数不超过100

style String 为字体风格设置风格支持： font : 目前支持黑体、宋体; fontSize： 6-72; color：000000-FFFFFF 字符串形如： "FFFFFF"; bold ：是否加粗， true ：加粗 false：不加粗; align: 对其方式，支持 LEFT / RIGHT / CENTER

被如下接口引用：CreateDocument。

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

GroupOrganization

成员企业信息

被如下接口引用：DescribeOrganizationGroupOrganizations。

名称	类型	描述
Name	String	成员企业名注意：此字段可能返回 null，表示取不到有效值。
Alias	String	成员企业别名注意：此字段可能返回 null，表示取不到有效值。
OrganizationId	String	成员企业id，为 32 位字符串，可在电子签PC 控制台，企业设置->企业电子签账号获取注意：此字段可能返回 null，表示取不到有效值。
UpdateTime	Integer	记录更新时间， unix时间戳，单位秒注意：此字段可能返回 null，表示取不到有效值。
Status	Integer	成员企业加入集团的当前状态 1：待授权 2：已授权待激活 3：拒绝授权 4：已解除 5：已加入注意：此字段可能返回 null，表示取不到有效值。
IsMainOrganization	Boolean	是否为集团主企业注意：此字段可能返回 null，表示取不到有效值。
IdCardNumber	String	企业社会信用代码注意：此字段可能返回 null，表示取不到有效值。
AdminInfo	Admin	企业超管信息注意：此字段可能返回 null，表示取不到有效值。
License	String	企业许可证Id，此字段暂时不需要关注注意：此字段可能返回 null，表示取不到有效值。
LicenseExpireTime	Integer	企业许可证过期时间，unix时间戳，单位秒注意：此字段可能返回 null，表示取不到有效值。
JoinTime	Integer	成员企业加入集团时间，unix时间戳，单位秒注意：此字段可能返回 null，表示取不到有效值。
FlowEngineEnable	Boolean	是否使用自建审批流引擎（即不是企微审批流引擎） true：是 false：否注意：此字段可能返回 null，表示取不到有效值。

HasAuthUser

被授权的用户信息

被如下接口引用：DescribeExtendedServiceAuthInfos。

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

IntegrateRole

企业角色数据信息

被如下接口引用：DescribeIntegrationRoles。

名称	类型	描述
RoleId	String	角色id 注意：此字段可能返回 null，表示取不到有效值。
RoleName	String	角色名注意：此字段可能返回 null，表示取不到有效值。
RoleStatus	Integer	角色状态，1-启用，2-禁用注意：此字段可能返回 null，表示取不到有效值。
IsGroupRole	Boolean	是否是集团角色，true-是，false-否注意：此字段可能返回 null，表示取不到有效值。
SubOrgIdList	Array of String	管辖的子企业列表注意：此字段可能返回 null，表示取不到有效值。
PermissionGroups	Array of PermissionGroup	权限树注意：此字段可能返回 null，表示取不到有效值。

IntegrationDepartment

部门信息

被如下接口引用：DescribeIntegrationDepartments。

名称	类型	描述
DeptId	String	部门ID。注意：此字段可能返回 null，表示取不到有效值。示例值：dp**155f2
DeptName	String	部门名。注意：此字段可能返回 null，表示取不到有效值。示例值：测试部门
ParentDeptId	String	父部门ID 注意：此字段可能返回 null，表示取不到有效值。示例值：yD**m1221
DeptOpenId	String	客户系统部门ID 注意：此字段可能返回 null，表示取不到有效值。示例值：dept_open_1
OrderNo	Integer	序列号。注意：此字段可能返回 null，表示取不到有效值。示例值：1

OccupiedSeal

持有的电子印章信息

被如下接口引用：DescribeOrganizationSeals。

名称	类型	描述
SealId	String	电子印章编号
SealName	String	电子印章名称
CreateOn	Integer	电子印章授权时间戳，单位秒
Creator	String	电子印章授权人的UserId
SealPolicyId	String	电子印章策略Id
SealStatus	String	印章状态，有以下六种：CHECKING（审核中）SUCCESS（已启用）FAIL（审核拒绝）CHECKING-SADM（待超管审核）DISABLE（已停用）STOPPED（已终止）
FailReason	String	审核失败原因注意：此字段可能返回 null，表示取不到有效值。
Url	String	印章图片url，5分钟内有效
SealType	String	印章类型,OFFICIAL-企业公章, CONTRACT-合同专用章,ORGANIZATIONSEAL-企业印章(本地上传印章类型),LEGAL_PERSON_SEAL-法人印章
IsAllTime	Boolean	用印申请是否为永久授权，true-是，false-否
AuthorizedUsers	Array of AuthorizedUser	授权人列表注意：此字段可能返回 null，表示取不到有效值。

PdfVerifyResult

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

被如下接口引用：VerifyPdf。

名称	类型	描述
VerifyResult	Integer	验签结果。0-签名域未签名；1-验签成功； 3-验签失败；4-未找到签名域：文件内没有签名域；5-签名值格式不正确。
SignPlatform	String	签署平台如果文件是在腾讯电子签平台签署，则为腾讯电子签，如果文件不在腾讯电子签平台签署，则为其他平台。
SignerName	String	申请证书的主体的名字如果是在腾讯电子签平台签署, 则对应的主体的名字个数如下企业: ESS@企业名称@编码个人: ESS@个人姓名@证件号@808854 如果在其他平台签署的, 主体的名字参考其他平台的说明
SignTime	Integer	签署时间的Unix时间戳，单位毫秒
SignAlgorithm	String	证书签名算法, 如SHA1withRSA等算法
CertSn	String	CA供应商下发给用户的证书编号注意：`腾讯电子签接入多家CA供应商以提供容灾能力，不同CA下发的证书编号区别较大，但基本都是由数字和字母组成，长度在200以下`。
CertNotBefore	Integer	证书起始时间的Unix时间戳，单位毫秒
CertNotAfter	Integer	证书过期时间的时间戳，单位毫秒
ComponentPosX	Float	签名域横坐标，单位px
ComponentPosY	Float	签名域纵坐标，单位px
ComponentWidth	Float	签名域宽度，单位px
ComponentHeight	Float	签名域高度，单位px
ComponentPage	Integer	签名域所在页码，1～N

Permission

权限树节点权限

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

名称	类型	必选	描述
Name	String	否	权限名称注意：此字段可能返回 null，表示取不到有效值。
Key	String	否	权限key 注意：此字段可能返回 null，表示取不到有效值。
Type	Integer	否	权限类型 1前端，2后端注意：此字段可能返回 null，表示取不到有效值。
Hide	Integer	否	是否隐藏注意：此字段可能返回 null，表示取不到有效值。
DataLabel	Integer	否	数据权限标签 1:表示根节点，2:表示叶子结点注意：此字段可能返回 null，表示取不到有效值。
DataType	Integer	否	数据权限独有，1:关联其他模块鉴权，2:表示关联自己模块鉴权注意：此字段可能返回 null，表示取不到有效值。
DataRange	Integer	否	数据权限独有，表示数据范围，1：全公司，2:部门及下级部门，3:自己注意：此字段可能返回 null，表示取不到有效值。
DataTo	String	否	关联权限, 表示这个功能权限要受哪个数据权限管控注意：此字段可能返回 null，表示取不到有效值。
ParentKey	String	否	父级权限key 注意：此字段可能返回 null，表示取不到有效值。
IsChecked	Boolean	否	是否选中注意：此字段可能返回 null，表示取不到有效值。
Children	Array of Permission	否	子权限集合注意：此字段可能返回 null，表示取不到有效值。

PermissionGroup

权限树中的权限组

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

名称	类型	必选	描述
GroupName	String	否	权限组名称注意：此字段可能返回 null，表示取不到有效值。
GroupKey	String	否	权限组key 注意：此字段可能返回 null，表示取不到有效值。
Hide	Integer	否	是否隐藏分组，0否1是注意：此字段可能返回 null，表示取不到有效值。
Permissions	Array of Permission	否	权限集合注意：此字段可能返回 null，表示取不到有效值。

Recipient

流程中参与方的信息结构

被如下接口引用：DescribeFlowTemplates。

名称	类型	必选	描述
RecipientId	String	否	签署参与者ID，唯一标识
RecipientType	String	否	参与者类型。默认为空。 ENTERPRISE-企业； INDIVIDUAL-个人； PROMOTER-发起方示例值：ENTERPRISE
Description	String	否	描述信息
RoleName	String	否	角色名称
RequireValidation	Boolean	否	是否需要验证，默认为false-不需要验证
RequireSign	Boolean	否	是否需要签署，默认为true-需要签署
RoutingOrder	Integer	否	此参与方添加的顺序，从0～N
RequireDelivery	Boolean	否	是否需要发送，默认为true-需要发送
Email	String	否	邮箱地址
Mobile	String	否	电话号码
UserId	String	否	关联的用户ID，电子签系统的用户ID
DeliveryMethod	String	否	发送方式，默认为EMAIL。 EMAIL-邮件； MOBILE-手机短信； WECHAT-微信通知示例值：EMAIL
RecipientExtra	String	否	参与方的一些附属信息，json格式
ApproverVerifyTypes	Array of Integer	否	签署人查看合同校验方式, 支持的类型如下: 1 :实名认证查看 2 :手机号校验查看
ApproverSignTypes	Array of Integer	否	签署人进行合同签署时的认证方式，支持的类型如下: 1 :人脸认证 2 :签署密码 3 :运营商三要素认证 4 :UKey认证

RecipientComponentInfo

参与方填写控件信息

被如下接口引用：DescribeFlowComponents。

名称	类型	描述
RecipientId	String	参与方Id 注意：此字段可能返回 null，表示取不到有效值。
RecipientFillStatus	String	参与方填写状态 0-未填写 1-已填写注意：此字段可能返回 null，表示取不到有效值。
IsPromoter	Boolean	是否为发起方 true-发起方 false-参与方注意：此字段可能返回 null，表示取不到有效值。
Components	Array of FilledComponent	填写控件列表注意：此字段可能返回 null，表示取不到有效值。

RegisterInfo

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

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

名称	类型	必选	描述
LegalName	String	是	法人姓名
UnifiedSocialCreditCode	String	否	社会统一信用代码

ReleasedApprover

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

被如下接口引用：CreateReleaseFlow。

名称	类型	必选	描述
Name	String	是	签署人姓名，最大长度50个字。示例值：典子谦
Mobile	String	是	签署人手机号。示例值：13200000000
RelievedApproverReceiptId	String	是	要更换的原合同参与人RecipientId编号。(可通过接口DescribeFlowInfo查询签署人的RecipientId编号)
ApproverType	String	否	指定签署人类型，目前仅支持 ORGANIZATION：企业（默认值） ENTERPRISESERVER：企业静默签示例值：ORGANIZATION
ApproverSignComponentType	String	否	签署控件类型，支持自定义企业签署方的签署控件类型 SIGN_SEAL：默认为印章控件类型（默认值） SIGN_SIGNATURE：手写签名控件类型
ApproverSignRole	String	否	参与方在合同中的角色是按照创建合同的时候来排序的，解除协议默认会将第一个参与人叫`甲方`,第二个叫`乙方`, 第三个叫`丙方`，以此类推。如果需改动此参与人的角色名字，可用此字段指定，由汉字,英文字符,数字组成，最大20个字。示例值：供应商

RelieveInfo

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

被如下接口引用：CreateReleaseFlow。

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

RemindFlowRecords

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

被如下接口引用：CreateFlowReminds。

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

ReviewerInfo

关注方信息

被如下接口引用：CreateEmbedWebUrl。

名称	类型	必选	描述
Name	String	否	姓名
Mobile	String	否	手机号

SealInfo

模板中指定的印章信息

被如下接口引用：DescribeFlowTemplates。

名称	类型	描述
SealId	String	印章ID 注意：此字段可能返回 null，表示取不到有效值。
SealType	String	印章类型。LEGAL_PERSON_SEAL: 法定代表人章； ORGANIZATIONSEAL：企业印章； OFFICIAL：企业公章； CONTRACT：合同专用章注意：此字段可能返回 null，表示取不到有效值。
SealName	String	印章名称注意：此字段可能返回 null，表示取不到有效值。

SignQrCode

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

被如下接口引用：CreateMultiFlowSignQRCode。

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

SignUrl

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

被如下接口引用：CreateMultiFlowSignQRCode。

名称	类型	描述
AppSignUrl	String	跳转至电子签名小程序签署的链接地址。适用于客户端APP及小程序直接唤起电子签名小程序。示例值：pages/guide?from=default&where=mini&autoJumpBack=true&to=CHANNEL_CONTRACT_COVER&xxx
EffectiveTime	String	签署链接有效时间，格式类似"2022-08-05 15:55:01" 示例值：2022-08-05 15:55:01
HttpSignUrl	String	跳转至电子签名小程序签署的链接地址，格式类似于https://essurl.cn/xxx。打开此链接将会展示H5中间页面，随后唤起电子签名小程序以进行合同签署。示例值：https://res.ess.tencent.cn/cdn/h5-activity/jump-mp.html?where=mini&from=MSG&to=CHANNEL_CONTRACT_COVER&xxx

Staff

企业员工信息。

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

名称	类型	必选	描述
UserId	String	否	员工在腾讯电子签平台的唯一身份标识，为32位字符串。注：`创建和更新场景无需填写。` 示例值：yDRCLUUgygq2xun5UuO4zjEwg0vjoimj
DisplayName	String	否	显示的用户名/昵称。示例值：张三
Mobile	String	否	用户手机号码，支持国内手机号11位数字(无需加+86前缀或其他字符)。示例值：13200000000
Email	String	否	用户邮箱。注意：此字段可能返回 null，表示取不到有效值。示例值：testtest@tencent.com
OpenId	String	否	用户在第三方平台ID。注：`如需在此接口提醒员工实名，该参数不传。` 注意：此字段可能返回 null，表示取不到有效值。示例值：open_user1
Roles	Array of StaffRole	否	员工角色信息。注：`创建和更新场景无需填写。` 注意：此字段可能返回 null，表示取不到有效值。
Department	Department	否	员工部门信息。注意：此字段可能返回 null，表示取不到有效值。
Verified	Boolean	否	员工是否实名。注：`创建和更新场景无需填写。` 示例值：false
CreatedOn	Integer	否	员工创建时间戳，单位秒。注：`创建和更新场景无需填写。` 示例值：1691563315
VerifiedOn	Integer	否	员工实名时间戳，单位秒。注：`创建和更新场景无需填写。` 注意：此字段可能返回 null，表示取不到有效值。示例值：1691563315
QuiteJob	Integer	否	员工是否离职： 0：未离职 1：离职注：`创建和更新场景无需填写。` 注意：此字段可能返回 null，表示取不到有效值。示例值：0
ReceiveUserId	String	否	员工离职交接人用户ID。注：`创建和更新场景无需填写。` 示例值：yDxVwUyKQWho8CUuO4zjEyQOAgwvr4Zy
ReceiveOpenId	String	否	员工离职交接人用户OpenId。注：`创建和更新场景无需填写。` 示例值：open_user2
WeworkOpenId	String	否	企业微信用户账号ID。注：`仅企微类型的企业创建员工接口支持该字段。` 注意：此字段可能返回 null，表示取不到有效值。示例值：wework_open1

StaffRole

集成版企业角色信息。

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

名称	类型	必选	描述
RoleId	String	否	角色ID。注意：此字段可能返回 null，表示取不到有效值。示例值：4dff1**10b
RoleName	String	否	角色名称。注意：此字段可能返回 null，表示取不到有效值。示例值：业务员

SuccessCreateStaffData

创建员工的成功数据

被如下接口引用：CreateIntegrationEmployees。

名称	类型	描述
DisplayName	String	员工名
Mobile	String	员工手机号
UserId	String	员工在电子签平台的id
Note	String	提示，当创建已存在未实名用户时，该字段有值注意：此字段可能返回 null，表示取不到有效值。
WeworkOpenId	String	传入的企微账号id

SuccessDeleteStaffData

删除员工的成功数据

被如下接口引用：DeleteIntegrationEmployees。

名称	类型	描述
DisplayName	String	员工名
Mobile	String	员工手机号
UserId	String	员工在电子签平台的id

SuccessUpdateStaffData

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

被如下接口引用：UpdateIntegrationEmployees。

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

TemplateInfo

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

模板组成
一个模板通常会包含以下结构信息
模板基本信息
发起方参与信息Promoter、签署参与方 Recipients，后者会在模板发起合同时用于指定参与方
填写控件 Components
签署控件 SignComponents
生成模板的文件基础信息 FileInfos

被如下接口引用：DescribeFlowTemplates。

名称	类型	必选	描述
TemplateId	String	否	模板ID，模板的唯一标识
TemplateName	String	否	模板名
Description	String	否	模板描述信息
DocumentResourceIds	Array of String	否	模板关联的资源ID列表
FileInfos	Array of FileInfo	否	生成模板的文件基础信息
AttachmentResourceIds	Array of String	否	附件关联的资源ID
SignOrder	Array of Integer	否	签署顺序无序 -1 有序为序列数字 0,1,2
Recipients	Array of Recipient	否	模板中的签署参与方列表
Components	Array of Component	否	模板的填充控件列表
SignComponents	Array of Component	否	模板中的签署控件列表
Status	Integer	否	模板状态 -1:不可用 0:草稿态 1:正式态，可以正常使用
Creator	String	否	模板的创建者信息，电子签系统用户ID
CreatedOn	Integer	否	模板创建的时间戳，格式为Unix标准时间戳（秒）
Promoter	Recipient	否	发起方参与信息Promoter
TemplateType	Integer	否	模板类型： 1 静默签, 3 普通模板
Available	Integer	否	模板可用状态： 1 启用（默认） 2 停用
OrganizationId	String	否	创建模板的企业ID，电子签的机构ID
PreviewUrl	String	否	模板预览链接，有效时间5分钟注意：此字段可能返回 null，表示取不到有效值。
TemplateVersion	String	否	模板版本。默认为空时，全数字字符，初始版本为yyyyMMdd001。注意：此字段可能返回 null，表示取不到有效值。
Published	Boolean	否	模板是否已发布： true-已发布 false-未发布注意：此字段可能返回 null，表示取不到有效值。
ShareTemplateId	String	否	分享来源的模板ID。用在集团账号子企业模板里注意：此字段可能返回 null，表示取不到有效值。
TemplateSeals	Array of SealInfo	否	模板内部指定的印章列表注意：此字段可能返回 null，表示取不到有效值。

UploadFile

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

被如下接口引用：UploadFiles。

名称	类型	必选	描述
FileBody	String	是	Base64编码后的文件内容
FileName	String	否	文件名，最大长度不超过200字符示例值：test.pdf

UserInfo

用户信息

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

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

UserThreeFactor

用户的三要素：姓名，证件号，证件类型

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

名称	类型	必选	描述
Name	String	是	签署方经办人的姓名。经办人的姓名将用于身份认证和电子签名，请确保填写的姓名为签署方的真实姓名，而非昵称等代名。示例值：小明
IdCardType	String	是	证件类型，支持以下类型 ID_CARD : 居民身份证 (默认值) HONGKONG_AND_MACAO : 港澳居民来往内地通行证 HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证) 示例值：ID_CARD
IdCardNumber	String	是	证件号码，应符合以下规则居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。港澳居民来往内地通行证号码应为9位字符串，第1位为“C”，第2位为英文字母（但“I”、“O”除外），后7位为阿拉伯数字。港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。示例值：610*1X

WebThemeConfig

页面主题配置

被如下接口引用：CreateWebThemeConfig。

名称	类型	必选	描述
DisplaySignBrandLogo	Boolean	否	是否显示页面底部电子签logo，取值如下： true：页面底部显示电子签logo false：页面底部不显示电子签logo（默认）示例值：true
WebEmbedThemeColor	String	否	主题颜色：支持十六进制颜色值以及RGB格式颜色值，例如：#D54941，rgb(213, 73, 65) 示例值：#D54941

Admin​

Agent​

ApproverComponentLimitType​

ApproverInfo​

ApproverItem​

ApproverOption​

ApproverRestriction​

AuthorizedUser​

AutoSignConfig​

BillUsageDetail​

CallbackInfo​

Caller​

CcInfo​

Component​

ComponentLimit​

CreateFlowOption​

CreateStaffResult​

DeleteStaffsResult​

Department​

EmbedUrlOption​

ExtendAuthInfo​

FailedCreateRoleData​

FailedCreateStaffData​

FailedDeleteStaffData​

FailedUpdateStaffData​

FileInfo​

FileUrl​

FillApproverInfo​

FillError​

FilledComponent​

Filter​

FlowApproverDetail​

FlowApproverUrlInfo​

FlowBrief​

FlowCreateApprover​

FlowDetailInfo​

FlowGroupInfo​

FlowGroupOptions​

FormField​

GroupOrganization​

HasAuthUser​

IntegrateRole​

IntegrationDepartment​

OccupiedSeal​

PdfVerifyResult​

Permission​

PermissionGroup​

Recipient​

RecipientComponentInfo​

RegisterInfo​

ReleasedApprover​

RelieveInfo​

RemindFlowRecords​

ReviewerInfo​

SealInfo​

SignQrCode​

SignUrl​

Staff​

StaffRole​

SuccessCreateStaffData​

SuccessDeleteStaffData​

SuccessUpdateStaffData​

TemplateInfo​

UploadFile​

UserInfo​

UserThreeFactor​

WebThemeConfig​

Admin

Agent

ApproverComponentLimitType

ApproverInfo

ApproverItem

ApproverOption

ApproverRestriction

AuthorizedUser

AutoSignConfig

BillUsageDetail

CallbackInfo

Caller

CcInfo

Component

ComponentLimit

CreateFlowOption

CreateStaffResult

DeleteStaffsResult

Department

EmbedUrlOption

ExtendAuthInfo

FailedCreateRoleData

FailedCreateStaffData

FailedDeleteStaffData

FailedUpdateStaffData

FileInfo

FileUrl

FillApproverInfo

FillError

FilledComponent

Filter

FlowApproverDetail

FlowApproverUrlInfo

FlowBrief

FlowCreateApprover

FlowDetailInfo

FlowGroupInfo

FlowGroupOptions

FormField

GroupOrganization

HasAuthUser

IntegrateRole

IntegrationDepartment

OccupiedSeal

PdfVerifyResult

Permission

PermissionGroup

Recipient

RecipientComponentInfo

RegisterInfo

ReleasedApprover

RelieveInfo

RemindFlowRecords

ReviewerInfo

SealInfo

SignQrCode

SignUrl

Staff

StaffRole

SuccessCreateStaffData

SuccessDeleteStaffData

SuccessUpdateStaffData

TemplateInfo

UploadFile

UserInfo

UserThreeFactor

WebThemeConfig