数据结构

Agent

应用相关信息

被如下接口引用：ChannelBatchCancelFlows, ChannelCancelFlow, ChannelCancelMultiFlowSignQRCode, ChannelCreateBatchCancelFlowUrl, ChannelCreateBoundFlows, ChannelCreateConvertTaskApi, ChannelCreateEmbedWebUrl, ChannelCreateFlowByFiles, ChannelCreateFlowGroupByFiles, ChannelCreateFlowReminds, ChannelCreateFlowSignReview, ChannelCreateFlowSignUrl, ChannelCreateMultiFlowSignQRCode, ChannelCreatePrepareFlow, ChannelCreateReleaseFlow, ChannelCreateSealPolicy, ChannelCreateUserRoles, ChannelDeleteRoleUsers, ChannelDeleteSealPolicies, ChannelDescribeEmployees, ChannelDescribeOrganizationSeals, ChannelDescribeRoles, ChannelGetTaskResultApi, ChannelUpdateSealStatus, ChannelVerifyPdf, CreateChannelFlowEvidenceReport, CreateConsoleLoginUrl, CreateFlowsByTemplates, CreateSealByImage, CreateSignUrls, DescribeChannelFlowEvidenceReport, DescribeExtendedServiceAuthInfo, DescribeFlowDetailInfo, DescribeResourceUrlsByFlows, DescribeTemplates, DescribeUsage, GetDownloadFlowUrl, ModifyExtendedService, OperateChannelTemplate, PrepareFlows, SyncProxyOrganization, SyncProxyOrganizationOperators, UploadFiles。

名称	类型	必选	描述
AppId	String	是	应用的唯一标识。不同的业务系统可以采用不同的AppId，不同AppId下的数据是隔离的。可以由控制台开发者中心-应用集成自主生成。
ProxyOrganizationOpenId	String	否	第三方应用平台自定义，对应第三方平台子客企业的唯一标识。一个第三方平台子客企业主体与子客企业ProxyOrganizationOpenId是一一对应的，不可更改，不可重复使用。（例如，可以使用企业名称的hash值，或者社会统一信用代码的hash值，或者随机hash值，需要第三方应用平台保存），最大64位字符串
ProxyOperator	UserInfo	否	第三方平台子客企业中的员工/经办人，通过第三方应用平台进入电子签完成实名、且被赋予相关权限后，可以参与到企业资源的管理或签署流程中。
ProxyAppId	String	否	在第三方平台子客企业开通电子签后，会生成唯一的子客应用Id（ProxyAppId）用于代理调用时的鉴权，在子客开通的回调中获取。
ProxyOrganizationId	String	否	内部参数，暂未开放使用

ApproverOption

签署人个性化能力信息

被如下接口引用：ChannelCreateFlowByFiles, ChannelCreateFlowSignUrl。

名称	类型	必选	描述
HideOneKeySign	Boolean	否	是否隐藏一键签署 false-不隐藏,默认 true-隐藏

ApproverRestriction

指定签署人限制项

被如下接口引用：ChannelCreateMultiFlowSignQRCode。

名称	类型	必选	描述
Name	String	否	指定签署人名字
Mobile	String	否	指定签署人手机号
IdCardType	String	否	指定签署人证件类型
IdCardNumber	String	否	指定签署人证件号码

AuthFailMessage

授权出错信息

被如下接口引用：OperateChannelTemplate。

名称	类型	描述
ProxyOrganizationOpenId	String	合作企业Id
Message	String	出错信息

AuthorizedUser

授权用户

被如下接口引用：ChannelDescribeOrganizationSeals。

名称	类型	描述
OpenId	String	用户openid

BaseFlowInfo

基础流程信息

被如下接口引用：ChannelCreatePrepareFlow。

名称	类型	必选	描述
FlowName	String	是	合同流程名称
FlowType	String	是	合同流程类型
FlowDescription	String	是	合同流程描述信息
Deadline	Integer	是	合同流程截止时间，unix时间戳
Unordered	Boolean	否	是否顺序签署(true:无序签,false:顺序签)
IntelligentStatus	String	否	打开智能添加填写区(默认开启，打开:"OPEN" 关闭："CLOSE")
FormFields	Array of FormField	否	填写控件内容
NeedSignReview	Boolean	否	本企业(发起方企业)是否需要签署审批，true：开启本企业签署审批
UserData	String	否	用户流程自定义数据参数
CcInfos	Array of CcInfo	否	抄送人信息
NeedCreateReview	Boolean	否	是否需要发起前审核，当指定NeedCreateReview=true，则发起后，需要使用接口：ChannelCreateFlowSignReview，来完成发起前审核，审核通过后，可以继续查看，签署合同

CcInfo

抄送信息

被如下接口引用：ChannelCreateFlowByFiles, ChannelCreatePrepareFlow, CreateFlowsByTemplates, PrepareFlows。

名称	类型	必选	描述
Mobile	String	否	被抄送人手机号，大陆11位手机号
Name	String	否	被抄送人姓名
CcType	Integer	否	被抄送人类型 0--个人. 1--员工
CcPermission	Integer	否	被抄送人权限 0--可查看 1--可查看也可下载

ChannelRole

渠道角色信息

被如下接口引用：ChannelDescribeRoles。

名称	类型	描述
RoleId	String	角色id 注意：此字段可能返回 null，表示取不到有效值。
RoleName	String	角色名注意：此字段可能返回 null，表示取不到有效值。
RoleStatus	Integer	角色状态：1-启用；2-禁用注意：此字段可能返回 null，表示取不到有效值。

CommonApproverOption

签署人配置信息

被如下接口引用：ChannelCreatePrepareFlow。

名称	类型	必选	描述
CanEditApprover	Boolean	否	是否允许修改签署人信息

CommonFlowApprover

通用签署人信息

被如下接口引用：ChannelCreatePrepareFlow。

名称	类型	必选	描述
NotChannelOrganization	Boolean	是	指定当前签署人为第三方应用集成子客，默认false：当前签署人为第三方应用集成子客，true：当前签署人为saas企业用户
ApproverType	Integer	否	签署人类型,目前支持：0-企业签署人，1-个人签署人，3-企业静默签署人
OrganizationId	String	否	企业id
OrganizationOpenId	String	否	企业OpenId，第三方应用集成非静默签子客企业签署人发起合同毕传
OrganizationName	String	否	企业名称，第三方应用集成非静默签子客企业签署人必传，saas企业签署人必传
UserId	String	否	用户id
OpenId	String	否	用户openId，第三方应用集成非静默签子客企业签署人必传
ApproverName	String	否	签署人名称，saas企业签署人，个人签署人必传
ApproverMobile	String	否	签署人手机号，saas企业签署人，个人签署人必传
RecipientId	String	否	签署人Id，使用模板发起是，对应模板配置中的签署人RecipientId 注意：模板发起时该字段必填
PreReadTime	Integer	否	签署前置条件：阅读时长限制，不传默认10s,最大300s，最小3s
IsFullText	Boolean	否	签署前置条件：阅读全文限制
NotifyType	String	否	通知类型：SMS（短信） NONE（不做通知）, 不传默认SMS
ApproverOption	CommonApproverOption	否	签署人配置

Component

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

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

绝对定位方式
表单域(FIELD)定位方式
关键字(KEYWORD)定位方式可以参考官网说明 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

被如下接口引用：ChannelCreateFlowByFiles, ChannelCreateFlowSignUrl, DescribeTemplates。

名称	类型	必选	描述
ComponentId	String	否	控件编号 CreateFlowByTemplates发起合同时优先以ComponentId（不为空）填充；否则以ComponentName填充注：当GenerateMode=3时，通过"^"来决定是否使用关键字整词匹配能力。例：当GenerateMode=3时，如果传入关键字"^甲方签署^"，则会在PDF文件中有且仅有"甲方签署"关键字的地方进行对应操作。如传入的关键字为"甲方签署"，则PDF文件中每个出现关键字的位置都会执行相应操作。创建控件时，此值为空查询时返回完整结构
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 - 企业法定代表人控件。表单域的控件不能作为印章和签名控件
ComponentName	String	否	控件简称，不能超过30个字符
ComponentRequired	Boolean	否	定义控件是否为必填项，默认为false
ComponentRecipientId	String	否	控件关联的签署方id
FileIndex	Integer	否	控件所属文件的序号 (文档中文件的排列序号，从0开始)
GenerateMode	String	否	控件生成的方式： NORMAL - 普通控件 FIELD - 表单域 KEYWORD - 关键字
ComponentWidth	Float	否	参数控件宽度，默认100，单位px 表单域和关键字转换控件不用填
ComponentHeight	Float	否	参数控件高度，默认100，单位px 表单域和关键字转换控件不用填
ComponentPage	Integer	否	参数控件所在页码，从1开始
ComponentPosX	Float	否	参数控件X位置，单位px
ComponentPosY	Float	否	参数控件Y位置，单位px
ComponentExtra	String	否	参数控件样式，json格式表述不同类型的控件会有部分非通用参数 TEXT/MULTI_LINE_TEXT控件可以指定 1 Font：目前只支持黑体、宋体 2 FontSize：范围12-72 3 FontAlign： Left/Right/Center，左对齐/居中/右对齐例如：{"FontSize":12} ComponentType为FILL_IMAGE时，支持以下参数： NotMakeImageCenter：bool。是否设置图片居中。false：居中（默认）。 true: 不居中 FillMethod: int. 填充方式。0-铺满（默认）；1-等比例缩放 ComponentType为SIGN_SIGNATURE类型可以控制签署方式 {“ComponentTypeLimit”: [“xxx”]} xxx可以为： HANDWRITE – 手写签名 BORDERLESS_ESIGN – 自动生成无边框腾讯体 OCR_ESIGN -- AI智能识别手写签名 ESIGN -- 个人印章类型 SYSTEM_ESIGN -- 系统签名（该类型可以在用户签署时根据用户姓名一键生成一个签名来进行签署）如：{“ComponentTypeLimit”: [“BORDERLESS_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\"}",
ComponentValue	String	否	控件填充vaule，ComponentType和传入值类型对应关系： TEXT - 文本内容 MULTILINE_TEXT - 文本内容 CHECK_BOX - true/false FILL_IMAGE、ATTACHMENT - 附件的FileId，需要通过UploadFiles接口上传获取 SELECTOR - 选项值 DATE - 默认是格式化为xxxx年xx月xx日 DYNAMIC_TABLE - 传入json格式的表格内容，具体见数据结构FlowInfo：https://cloud.tencent.com/document/api/1420/61525#FlowInfo 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/ 地址控件：同单行文本控件约束省市区控件：同单行文本控件约束性别控件：同单行文本控件约束，填写选择值中的字符串学历控件：同单行文本控件约束，填写选择值中的字符串
ComponentDateFontSize	Integer	否	日期签署控件的字号，默认为 12 签署区日期控件会转换成图片格式并带存证，需要通过字体决定图片大小
DocumentId	String	否	控件所属文档的Id, 模块相关接口为空值
ComponentDescription	String	否	控件描述，不能超过30个字符
OffsetX	Float	否	指定关键字时横坐标偏移量，单位pt
OffsetY	Float	否	指定关键字时纵坐标偏移量，单位pt
ChannelComponentId	String	否	平台企业控件ID。如果不为空，属于平台企业预设控件；
KeywordOrder	String	否	指定关键字排序规则，Positive-正序，Reverse-倒序。传入Positive时会根据关键字在PDF文件内的顺序进行排列。在指定KeywordIndexes时，0代表在PDF内查找内容时，查找到的第一个关键字。传入Reverse时会根据关键字在PDF文件内的反序进行排列。在指定KeywordIndexes时，0代表在PDF内查找内容时，查找到的最后一个关键字。
KeywordPage	Integer	否	指定关键字页码，可选参数，指定页码后，将只在指定的页码内查找关键字，非该页码的关键字将不会查询出来
RelativeLocation	String	否	关键字位置模式，Middle-居中，Below-正下方，Right-正右方，LowerRight-右上角，UpperRight-右下角。示例：如果设置Middle的关键字盖章，则印章的中心会和关键字的中心重合，如果设置Below，则印章在关键字的正下方
KeywordIndexes	Array of Integer	否	关键字索引，可选参数，如果一个关键字在PDF文件中存在多个，可以通过关键字索引指定使用第几个关键字作为最后的结果，可指定多个索引。示例[0,2]，说明使用PDF文件内第1个和第3个关键字位置。
Placeholder	String	否	填写提示的内容注意：此字段可能返回 null，表示取不到有效值。

CreateFlowOption

创建合同配置信息

被如下接口引用：ChannelCreatePrepareFlow。

名称	类型	必选	描述
CanEditFlow	Boolean	否	是否允许修改合同信息

Department

第三方应用集成员工部门信息

被如下接口引用：ChannelDescribeEmployees。

名称	类型	描述
DepartmentId	String	部门id 注意：此字段可能返回 null，表示取不到有效值。
DepartmentName	String	部门名称注意：此字段可能返回 null，表示取不到有效值。

DownloadFlowInfo

签署流程下载信息

被如下接口引用：GetDownloadFlowUrl。

名称	类型	必选	描述
FileName	String	是	文件夹名称
FlowIdList	Array of String	是	签署流程的标识数组

ExtentServiceAuthInfo

企业扩展服务授权信息

被如下接口引用：DescribeExtendedServiceAuthInfo。

名称	类型	描述
Type	String	扩展服务类型 AUTO_SIGN 企业静默签（自动签署） OVERSEA_SIGN 企业与港澳台居民*签署合同 MOBILE_CHECK_APPROVER 使用手机号验证签署方身份 PAGING_SEAL 骑缝章 DOWNLOAD_FLOW 授权渠道下载合同
Name	String	扩展服务名称
Status	String	服务状态 ENABLE 开启 DISABLE 关闭
OperatorOpenId	String	最近操作人openid（经办人openid）注意：此字段可能返回 null，表示取不到有效值。
OperateOn	Integer	最近操作时间注意：此字段可能返回 null，表示取不到有效值。

FailedCreateRoleData

绑定失败的用户角色信息

被如下接口引用：ChannelCreateUserRoles。

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

Filter

此结构体 (Filter) 用于描述查询过滤条件。

被如下接口引用：ChannelDescribeEmployees, ChannelDescribeRoles。

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

FlowApproverDetail

签署人的流程信息明细

被如下接口引用：DescribeFlowDetailInfo。

名称	类型	描述
ReceiptId	String	模板配置时候的签署人id,与控件绑定
ProxyOrganizationOpenId	String	平台企业的第三方id 注意：此字段可能返回 null，表示取不到有效值。
ProxyOperatorOpenId	String	平台企业操作人的第三方id
ProxyOrganizationName	String	平台企业名称
Mobile	String	签署人手机号
SignOrder	Integer	签署人签署顺序
ApproveName	String	签署人姓名注意：此字段可能返回 null，表示取不到有效值。
ApproveStatus	String	当前签署人的状态, 状态如下 PENDING 流程等待中 FILLPENDING 待填写状态 FILLACCEPT 参与人已经填写 FILLREJECT 参与人解决填写 WAITPICKUP 待签收 ACCEPT 签收 REJECT 拒签 DEADLINE 过期没有处理 CANCEL 取消 FORWARD 已经转他人处理 STOP 流程因为其他原因终止 RELIEVED 已经解除注意：此字段可能返回 null，表示取不到有效值。
ApproveMessage	String	签署人信息注意：此字段可能返回 null，表示取不到有效值。
ApproveTime	Integer	签署人签署时间
ApproveType	String	参与者类型 (ORGANIZATION企业/PERSON个人) 注意：此字段可能返回 null，表示取不到有效值。

FlowApproverInfo

创建签署流程签署人入参。

其中签署方FlowApproverInfo需要传递的参数非单C、单B、B2C合同，ApproverType、RecipientId（模板发起合同时）必传，建议都传。其他身份标识 1-个人：Name、Mobile必传 2-第三方平台子客企业指定经办人：OpenId必传，OrgName必传、OrgOpenId必传； 3-第三方平台子客企业不指定经办人：OrgName必传、OrgOpenId必传； 4-非第三方平台子客企业：Name、Mobile必传，OrgName必传，且NotChannelOrganization=True。

RecipientId参数：从DescribeTemplates接口中，可以得到模板下的签署方Recipient列表，根据模板自定义的Rolename在此结构体中确定其RecipientId

被如下接口引用：ChannelCreateFlowByFiles, ChannelCreateFlowGroupByFiles, ChannelCreateFlowSignUrl, CreateFlowsByTemplates, PrepareFlows。

名称	类型	必选	描述
Name	String	否	签署人姓名，最大长度50个字符
IdCardType	String	否	签署人身份证件类型 1.ID_CARD 居民身份证 2.HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证 3.HONGKONG_AND_MACAO 港澳居民来往内地通行证
IdCardNumber	String	否	签署人证件号
Mobile	String	否	签署人手机号，脱敏显示。大陆手机号为11位，暂不支持海外手机号。
OrganizationName	String	否	企业签署方工商营业执照上的企业名称，签署方为非发起方企业场景下必传，最大长度64个字符；
NotChannelOrganization	Boolean	否	指定签署人非第三方平台子客企业下员工，在ApproverType为ORGANIZATION时指定。默认为false，即签署人位于同一个第三方平台应用号下；默认为false，即签署人位于同一个第三方应用号下；
OpenId	String	否	用户侧第三方id，最大长度64个字符当签署方为同一第三方平台下的员工时，该字段若不指定，则发起【待领取】的流程
OrganizationOpenId	String	否	企业签署方在同一第三方平台应用下的其他合作企业OpenId，签署方为非发起方企业场景下必传，最大长度64个字符；
ApproverType	String	否	签署人类型 PERSON-个人/自然人； PERSON_AUTO_SIGN-个人自动签（定制化场景下使用）； ORGANIZATION-企业（企业签署方或模板发起时的企业静默签）； ENTERPRISESERVER-企业静默签（文件发起时的企业静默签字）。
RecipientId	String	否	签署流程签署人在模板中对应的签署人Id；在非单方签署、以及非B2C签署的场景下必传，用于指定当前签署方在签署流程中的位置；
Deadline	Integer	否	签署截止时间，默认一年
CallbackUrl	String	否	签署完回调url，最大长度1000个字符
SignComponents	Array of Component	否	使用PDF文件直接发起合同时，签署人指定的签署控件
ComponentLimitType	Array of String	否	个人签署方指定签署控件类型，目前支持：OCR_ESIGN -AI智慧手写签名 HANDWRITE -手写签名
PreReadTime	Integer	否	合同的强制预览时间：3~300s，未指定则按合同页数计算
JumpUrl	String	否	签署完前端跳转的url，暂未使用
ApproverOption	ApproverOption	否	签署人个性化能力值
ApproverNeedSignReview	Boolean	否	当前签署方进行签署操作是否需要企业内部审批，true 则为需要
ApproverVerifyTypes	Array of Integer	否	签署人查看合同时认证方式, 1-实名查看 2-短信验证码查看(企业签署方不支持该方式) 如果不传默认为1 查看合同的认证方式 Flow层级的优先于approver层级的
ApproverSignTypes	Array of Integer	否	签署人签署合同时的认证方式 1-人脸认证 2-签署密码 3-运营商三要素(默认为1,2)

FlowApproverUrlInfo

签署人签署链接信息

被如下接口引用：ChannelCreateFlowSignUrl。

名称	类型	描述
SignUrl	String	签署链接。注意该链接有效期为30分钟，同时需要注意保密，不要外泄给无关用户。
ApproverType	String	签署人类型 PERSON-个人
Name	String	签署人姓名
Mobile	String	签署人手机号
LongUrl	String	签署长链接。注意该链接有效期为30分钟，同时需要注意保密，不要外泄给无关用户。注意：此字段可能返回 null，表示取不到有效值。

FlowDetailInfo

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

被如下接口引用：DescribeFlowDetailInfo。

名称	类型	描述
FlowId	String	合同(流程)的Id
FlowName	String	合同(流程)的名字
FlowType	String	合同(流程)的类型
FlowStatus	String	合同(流程)的状态, 状态如下 INIT 还没发起 PART 部分签署 REJECT 拒签 ALL 全部签署 DEADLINE 流签 CANCEL 取消 RELIEVED 解除
FlowMessage	String	合同(流程)的信息
CreateOn	Integer	合同(流程)的创建时间戳
DeadLine	Integer	合同(流程)的签署截止时间戳
CustomData	String	用户自定义数据
FlowApproverInfos	Array of FlowApproverDetail	合同(流程)的签署人数组
CcInfos	Array of FlowApproverDetail	合同(流程)关注方信息列表
NeedCreateReview	Boolean	是否需要发起前审批，当NeedCreateReview为true，表明当前流程是需要发起前审核的合同，可能无法进行查看，签署操作，需要等审核完成后，才可以继续后续流程

FlowFileInfo

合同组中每个子合同的发起信息

被如下接口引用：ChannelCreateFlowGroupByFiles。

名称	类型	必选	描述
FileIds	Array of String	是	签署文件资源Id列表，目前仅支持单个文件
FlowName	String	是	签署流程名称，长度不超过200个字符
FlowApprovers	Array of FlowApproverInfo	是	签署流程签约方列表，最多不超过5个参与方
Deadline	Integer	否	签署流程截止时间，十位数时间戳，最大值为33162419560，即3020年
FlowDescription	String	否	签署流程的描述，长度不超过1000个字符
FlowType	String	否	签署流程的类型，长度不超过255个字符
CallbackUrl	String	否	签署流程回调地址，长度不超过255个字符
CustomerData	String	否	第三方应用的业务信息，最大长度1000个字符。发起自动签署时，需设置对应自动签署场景，目前仅支持场景：处方单-E_PRESCRIPTION_AUTO_SIGN
Unordered	Boolean	否	合同签署顺序类型(无序签,顺序签)，默认为false，即有序签署
CustomShowMap	String	否	合同显示的页卡模板，说明：只支持{合同名称}, {发起方企业}, {发起方姓名}, {签署方N企业}, {签署方N姓名}，且N不能超过签署人的数量，N从1开始
NeedSignReview	Boolean	否	本企业(发起方企业)是否需要签署审批

FlowInfo

此结构体 (FlowInfo) 用于描述签署流程信息。

【数据表格传参说明】当模板的 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"
            }
        ]
    }
}

表格参数说明

名称	类型	描述
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

表格参数headers说明

名称	类型	描述
widthPercent	Integer	表头单元格列占总表头的比例，例如1：30表示此列占表头的30%，不填写时列宽度平均拆分；例如2：总2列，某一列填写40，剩余列可以为空，按照60计算。；例如3：总3列，某一列填写30，剩余2列可以为空，分别为(100-30)/2=35
content	String	表头单元格内容，字数不超过100

被如下接口引用：CreateFlowsByTemplates, PrepareFlows。

名称	类型	必选	描述
FlowName	String	是	合同名字，最大长度200个字符
Deadline	Integer	是	签署截止时间戳，超过有效签署时间则该签署流程失败，默认一年
TemplateId	String	否	模板ID
FlowApprovers	Array of FlowApproverInfo	否	多个签署人信息，最大支持50个签署方
FormFields	Array of FormField	否	表单K-V对列表
CallbackUrl	String	否	回调地址，最大长度1000个字符
FlowType	String	否	合同类型，如：1. “劳务”；2. “销售”；3. “租赁”；4. “其他”，最大长度200个字符
FlowDescription	String	否	合同描述，最大长度1000个字符
CustomerData	String	否	第三方应用平台的业务信息，最大长度1000个字符。
CustomShowMap	String	否	合同显示的页卡模板，说明：只支持{合同名称}, {发起方企业}, {发起方姓名}, {签署方N企业}, {签署方N姓名}，且N不能超过签署人的数量，N从1开始
CcInfos	Array of CcInfo	否	被抄送人的信息列表，抄送功能暂不开放
NeedSignReview	Boolean	否	发起方企业的签署人进行签署操作是否需要企业内部审批。若设置为true,审核结果需通过接口 ChannelCreateFlowSignReview 通知电子签，审核通过后，发起方企业签署人方可进行签署操作，否则会阻塞其签署操作。注：企业可以通过此功能与企业内部的审批流程进行关联，支持手动、静默签署合同。
CcNotifyType	Integer	否	给关注人发送短信通知的类型，0-合同发起时通知 1-签署完成后通知
AutoSignScene	String	否	个人自动签场景。发起自动签署时，需设置对应自动签署场景，目前仅支持场景：处方单-E_PRESCRIPTION_AUTO_SIGN

FlowResourceUrlInfo

流程对应资源链接信息

被如下接口引用：DescribeResourceUrlsByFlows。

名称	类型	描述
FlowId	String	流程对应Id 注意：此字段可能返回 null，表示取不到有效值。
ResourceUrlInfos	Array of ResourceUrlInfo	流程对应资源链接信息数组注意：此字段可能返回 null，表示取不到有效值。

FormField

此结构 (FormField) 用于描述内容控件填充结构。

被如下接口引用：ChannelCreatePrepareFlow, CreateFlowsByTemplates, PrepareFlows。

名称	类型	必选	描述
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
ComponentId	String	否	表单域或控件的ID，跟ComponentName二选一，不能全为空； CreateFlowsByTemplates 接口不使用此字段。注意：此字段可能返回 null，表示取不到有效值。
ComponentName	String	否	控件的名字，跟ComponentId二选一，不能全为空注意：此字段可能返回 null，表示取不到有效值。

OccupiedSeal

持有的电子印章信息

被如下接口引用：ChannelDescribeOrganizationSeals。

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

OrganizationInfo

机构信息

被如下接口引用：ChannelCreateConvertTaskApi, ChannelCreateFlowSignUrl, ChannelCreatePrepareFlow, ChannelCreateReleaseFlow, ChannelCreateSealPolicy, ChannelDeleteSealPolicies, ChannelGetTaskResultApi。

名称	类型	必选	描述
OrganizationOpenId	String	是	用户在渠道的机构编号
ClientIp	String	是	用户真实的IP
ProxyIp	String	是	机构的代理IP
OrganizationId	String	否	机构在平台的编号
Channel	String	否	用户渠道

PdfVerifyResult

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

被如下接口引用：ChannelVerifyPdf。

名称	类型	描述
VerifyResult	Integer	验签结果。0-签名域未签名；1-验签成功； 3-验签失败；4-未找到签名域：文件内没有签名域；5-签名值格式不正确。
SignPlatform	String	签署平台，如果文件是在腾讯电子签平台签署，则返回腾讯电子签，如果文件不在腾讯电子签平台签署，则返回其他平台。
SignerName	String	签署人名称
SignTime	Integer	签署时间
SignAlgorithm	String	签名算法
CertSn	String	签名证书序列号
CertNotBefore	Integer	证书起始时间
CertNotAfter	Integer	证书过期时间
SignType	Integer	签名类型
ComponentPosX	Float	签名域横坐标
ComponentPosY	Float	签名域纵坐标
ComponentWidth	Float	签名域宽度
ComponentHeight	Float	签名域高度
ComponentPage	Integer	签名域所在页码

ProxyOrganizationOperator

合作企业经办人列表信息

被如下接口引用：SyncProxyOrganizationOperators。

名称	类型	必选	描述
Id	String	是	对应Agent-ProxyOperator-OpenId。第三方应用平台自定义，对子客企业员的唯一标识。一个OpenId在一个子客企业内唯一对应一个真实员工，不可在其他子客企业内重复使用。（例如，可以使用经办人企业名+员工身份证的hash值，需要第三方应用平台保存），最大64位字符串
Name	String	否	经办人姓名，最大长度50个字符
IdCardType	String	否	经办人身份证件类型 1.ID_CARD 居民身份证 2.HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证 3.HONGKONG_AND_MACAO 港澳居民来往内地通行证
IdCardNumber	String	否	经办人证件号
Mobile	String	否	经办人手机号，大陆手机号输入11位，暂不支持海外手机号。
DefaultRole	String	否	默认角色，值为以下三个对应的英文：业务管理员：admin 经办人：channel-normal-operator 业务员：channel-sales-man

Recipient

签署参与者信息

被如下接口引用：DescribeTemplates。

名称	类型	必选	描述
RecipientId	String	否	签署人唯一标识
RecipientType	String	否	参与者类型。默认为空。ENTERPRISE-企业；INDIVIDUAL-个人；PROMOTER-发起方
Description	String	否	描述
RoleName	String	否	签署方备注信息
RequireValidation	Boolean	否	是否需要校验
RequireSign	Boolean	否	是否必须填写
SignType	Integer	否	签署类型
RoutingOrder	Integer	否	签署顺序：数字越小优先级越高
IsPromoter	Boolean	否	是否是发起方

ReleasedApprover

解除协议的签署人，如不指定，默认使用待解除流程（即原流程）中的签署人。注意：不支持更换C端（个人身份类型）签署人，如果原流程中含有C端签署人，默认使用原流程中的该签署人。

如果需要指定B端（机构身份类型）签署人，其中ReleasedApprover需要传递的参数如下： ApproverNumber, OrganizationName, ApproverType必传。对于其他身份标识

子客企业指定经办人：OpenId必传，OrganizationOpenId必传；
非子客企业：Name、Mobile必传。

被如下接口引用：ChannelCreateReleaseFlow。

名称	类型	必选	描述
OrganizationName	String	是	企业签署方工商营业执照上的企业名称，签署方为非发起方企业场景下必传，最大长度64个字符
ApproverNumber	Integer	是	签署人在原流程中的签署人列表中的顺序序号（从0开始，按顺序依次递增），如果不清楚原流程中的签署人列表，可以通过DescribeFlows接口查看
ApproverType	String	是	签署人类型，目前仅支持 ORGANIZATION-企业
Name	String	否	签署人姓名，最大长度50个字符
IdCardType	String	否	签署人身份证件类型 1.ID_CARD 居民身份证 2.HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证 3.HONGKONG_AND_MACAO 港澳居民来往内地通行证
IdCardNumber	String	否	签署人证件号
Mobile	String	否	签署人手机号，脱敏显示。大陆手机号为11位，暂不支持海外手机号
OrganizationOpenId	String	否	企业签署方在同一第三方应用下的其他合作企业OpenId，签署方为非发起方企业场景下必传，最大长度64个字符
OpenId	String	否	用户侧第三方id，最大长度64个字符当签署方为同一第三方应用下的员工时，该字必传

RelieveInfo

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

被如下接口引用：ChannelCreateReleaseFlow。

名称	类型	必选	描述
Reason	String	是	解除理由，最大支持200个字
RemainInForceItem	String	否	解除后仍然有效的条款，保留条款，最大支持200个字
OriginalExpenseSettlement	String	否	原合同事项处理-费用结算，最大支持200个字
OriginalOtherSettlement	String	否	原合同事项处理-其他事项，最大支持200个字
OtherDeals	String	否	其他约定，最大支持200个字

RemindFlowRecords

催办接口返回详细信息

被如下接口引用：ChannelCreateFlowReminds。

名称	类型	描述
CanRemind	Boolean	是否能够催办
FlowId	String	合同id
RemindMessage	String	催办详情

ResourceUrlInfo

资源链接信息

被如下接口引用：DescribeResourceUrlsByFlows。

名称	类型	描述
Url	String	资源链接地址，过期时间5分钟注意：此字段可能返回 null，表示取不到有效值。
Name	String	资源名称注意：此字段可能返回 null，表示取不到有效值。
Type	String	资源类型注意：此字段可能返回 null，表示取不到有效值。

SignQrCode

一码多扫签署二维码对象

被如下接口引用：ChannelCreateMultiFlowSignQRCode。

名称	类型	描述
QrCodeId	String	二维码id
QrCodeUrl	String	二维码url
ExpiredTime	Integer	二维码过期时间

SignUrl

一码多扫签署二维码签署信息

被如下接口引用：ChannelCreateMultiFlowSignQRCode。

名称	类型	描述
AppSignUrl	String	小程序签署链接
EffectiveTime	String	签署链接有效时间
HttpSignUrl	String	移动端签署链接

SignUrlInfo

签署链接内容

被如下接口引用：CreateSignUrls。

名称	类型	描述
SignUrl	String	签署链接，过期时间为30天注意：此字段可能返回 null，表示取不到有效值。
Deadline	Integer	合同过期时间注意：此字段可能返回 null，表示取不到有效值。
SignOrder	Integer	当流程为顺序签署此参数有效时，数字越小优先级越高，暂不支持并行签署可选注意：此字段可能返回 null，表示取不到有效值。
SignId	String	签署人编号注意：此字段可能返回 null，表示取不到有效值。
CustomUserId	String	自定义用户编号注意：此字段可能返回 null，表示取不到有效值。
Name	String	用户姓名注意：此字段可能返回 null，表示取不到有效值。
Mobile	String	用户手机号码注意：此字段可能返回 null，表示取不到有效值。
OrganizationName	String	签署参与者机构名字注意：此字段可能返回 null，表示取不到有效值。
ApproverType	String	参与者类型: ORGANIZATION 企业经办人 PERSON 自然人注意：此字段可能返回 null，表示取不到有效值。
IdCardNumber	String	经办人身份证号注意：此字段可能返回 null，表示取不到有效值。
FlowId	String	签署链接对应流程Id 注意：此字段可能返回 null，表示取不到有效值。
OpenId	String	企业经办人用户在渠道的编号注意：此字段可能返回 null，表示取不到有效值。
FlowGroupId	String	合同组签署链接对应的合同组id 注意：此字段可能返回 null，表示取不到有效值。

Staff

企业员工信息

被如下接口引用：ChannelDescribeEmployees。

名称	类型	描述
UserId	String	员工在电子签平台的id
DisplayName	String	显示的员工名
Mobile	String	员工手机号
Email	String	员工邮箱注意：此字段可能返回 null，表示取不到有效值。
OpenId	String	员工在第三方平台id 注意：此字段可能返回 null，表示取不到有效值。
Roles	Array of StaffRole	员工角色注意：此字段可能返回 null，表示取不到有效值。
Department	Department	员工部门注意：此字段可能返回 null，表示取不到有效值。
Verified	Boolean	员工是否实名
CreatedOn	Integer	员工创建时间戳
VerifiedOn	Integer	员工实名时间戳
QuiteJob	Integer	员工是否离职：0-未离职，1-离职

StaffRole

第三方应用集成员工角色信息

被如下接口引用：ChannelDescribeEmployees。

名称	类型	描述
RoleId	String	角色id 注意：此字段可能返回 null，表示取不到有效值。
RoleName	String	角色名称注意：此字段可能返回 null，表示取不到有效值。

SyncFailReason

同步经办人失败原因

被如下接口引用：SyncProxyOrganizationOperators。

名称	类型	描述
Id	String	经办人Id
Message	String	失败原因例如：Id不符合规范、证件号码不合法等注意：此字段可能返回 null，表示取不到有效值。

TaskInfo

复杂文档合成任务的任务信息

被如下接口引用：CreateFlowsByTemplates。

名称	类型	描述
TaskId	String	合成任务Id，可以通过 ChannelGetTaskResultApi 接口获取任务信息注意：此字段可能返回 null，表示取不到有效值。
TaskStatus	String	任务状态：READY - 任务已完成；NOTREADY - 任务未完成；注意：此字段可能返回 null，表示取不到有效值。

TemplateInfo

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

被如下接口引用：DescribeTemplates。

名称	类型	描述
TemplateId	String	模板ID
TemplateName	String	模板名字
Description	String	模板描述信息
Components	Array of Component	模板控件信息结构
Recipients	Array of Recipient	模板中的流程参与人信息
SignComponents	Array of Component	签署区模板信息结构
TemplateType	Integer	模板类型：1-静默签；3-普通模板
IsPromoter	Boolean	是否是发起人 ,已弃用
Creator	String	模板的创建者信息
CreatedOn	Integer	模板创建的时间戳（精确到秒）
PreviewUrl	String	模板的H5预览链接,可以通过浏览器打开此链接预览模板，或者嵌入到iframe中预览模板。注意：此字段可能返回 null，表示取不到有效值。
PdfUrl	String	第三方应用集成-模板PDF文件链接注意：此字段可能返回 null，表示取不到有效值。
ChannelTemplateId	String	关联的平台企业模板ID
ChannelTemplateName	String	关联的平台企业模板名称注意：此字段可能返回 null，表示取不到有效值。
ChannelAutoSave	Integer	0-需要子客企业手动领取平台企业的模板(默认); 1-平台自动设置子客模板注意：此字段可能返回 null，表示取不到有效值。
TemplateVersion	String	模板版本，全数字字符。默认为空，初始版本为yyyyMMdd001。注意：此字段可能返回 null，表示取不到有效值。
Available	Integer	模板可用状态，取值：1启用（默认），2停用注意：此字段可能返回 null，表示取不到有效值。

UploadFile

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

被如下接口引用：UploadFiles。

名称	类型	必选	描述
FileBody	String	是	Base64编码后的文件内容
FileName	String	否	文件名

UsageDetail

用量明细

被如下接口引用：DescribeUsage。

名称	类型	描述
ProxyOrganizationOpenId	String	子客企业唯一标识
ProxyOrganizationName	String	子客企业名注意：此字段可能返回 null，表示取不到有效值。
Date	Date	日期，当需要汇总数据时日期为空注意：此字段可能返回 null，表示取不到有效值。
Usage	Integer	消耗数量
Cancel	Integer	撤回数量注意：此字段可能返回 null，表示取不到有效值。
FlowChannel	String	消耗渠道注意：此字段可能返回 null，表示取不到有效值。

UserInfo

接口调用者信息

名称	类型	必选	描述
OpenId	String	否	第三方应用平台自定义，对应第三方平台子客企业员的唯一标识。一个OpenId在一个子客企业内唯一对应一个真实员工，不可在其他子客企业内重复使用。（例如，可以使用经办人企业名+员工身份证的hash值，需要第三方应用平台保存），最大64位字符串
Channel	String	否	内部参数，暂未开放使用
CustomUserId	String	否	内部参数，暂未开放使用
ClientIp	String	否	内部参数，暂未开放使用
ProxyIp	String	否	内部参数，暂未开放使用

Agent​

ApproverOption​

ApproverRestriction​

AuthFailMessage​

AuthorizedUser​

BaseFlowInfo​

CcInfo​

ChannelRole​

CommonApproverOption​

CommonFlowApprover​

Component​

CreateFlowOption​

Department​

DownloadFlowInfo​

ExtentServiceAuthInfo​

FailedCreateRoleData​

Filter​

FlowApproverDetail​

FlowApproverInfo​

FlowApproverUrlInfo​

FlowDetailInfo​

FlowFileInfo​

FlowInfo​

FlowResourceUrlInfo​

FormField​

OccupiedSeal​

OrganizationInfo​

PdfVerifyResult​

ProxyOrganizationOperator​

Recipient​

ReleasedApprover​

RelieveInfo​

RemindFlowRecords​

ResourceUrlInfo​

SignQrCode​

SignUrl​

SignUrlInfo​

Staff​

StaffRole​

SyncFailReason​

TaskInfo​

TemplateInfo​

UploadFile​

UsageDetail​

UserInfo​

Agent

ApproverOption

ApproverRestriction

AuthFailMessage

AuthorizedUser

BaseFlowInfo

CcInfo

ChannelRole

CommonApproverOption

CommonFlowApprover

Component

CreateFlowOption

Department

DownloadFlowInfo

ExtentServiceAuthInfo

FailedCreateRoleData

Filter

FlowApproverDetail

FlowApproverInfo

FlowApproverUrlInfo

FlowDetailInfo

FlowFileInfo

FlowInfo

FlowResourceUrlInfo

FormField

OccupiedSeal

OrganizationInfo

PdfVerifyResult

ProxyOrganizationOperator

Recipient

ReleasedApprover

RelieveInfo

RemindFlowRecords

ResourceUrlInfo

SignQrCode

SignUrl

SignUrlInfo

Staff

StaffRole

SyncFailReason

TaskInfo

TemplateInfo

UploadFile

UsageDetail

UserInfo