public class ApproverInfo extends AbstractModel
skipSign
Constructor and Description |
---|
ApproverInfo() |
ApproverInfo(ApproverInfo source)
NOTE: Any ambiguous key set via .set("AnyKey", "value") will be a shallow copy,
and any explicit key, i.e Foo, set via .setFoo("value") will be a deep copy.
|
Modifier and Type | Method and Description |
---|---|
String |
getApproverIdCardNumber()
Get 签署方经办人的证件号码,应符合以下规则
居民身份证号码应为18位字符串,由数字和大写字母X组成(如存在X,请大写)。
港澳居民来往内地通行证号码应为9位字符串,第1位为“C”,第2位为英文字母(但“I”、“O”除外),后7位为阿拉伯数字。
港澳台居民居住证号码编码规则与中国大陆身份证相同,应为18位字符串。
|
String |
getApproverIdCardType()
Get 签署方经办人的证件类型,支持以下类型
ID_CARD 居民身份证 (默认值)
HONGKONG_AND_MACAO 港澳居民来往内地通行证
HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证(格式同居民身份证)
OTHER_CARD_TYPE 其他证件
注: `其他证件类型为白名单功能,使用前请联系对接的客户经理沟通。`
|
String |
getApproverMobile()
Get 本企业的签署方经办人的员工UserId
可登录腾讯电子签控制台,在 "更多能力"->"组织管理" 中查看某位员工的UserId(在页面中展示为用户ID)。
注: `若传该字段,则签署方经办人的其他信息(如签署方经办人的姓名、证件号码、手机号码等)将被忽略。`
|
String |
getApproverName()
Get 签署方经办人的姓名。
经办人的姓名将用于身份认证和电子签名,请确保填写的姓名为签署方的真实姓名,而非昵称等代名。
|
Boolean |
getApproverNeedSignReview()
Get 发起方企业的签署人进行签署操作前,是否需要企业内部走审批流程,取值如下:
**false**:(默认)不需要审批,直接签署。
**true**:需要走审批流程。当到对应参与人签署时,会阻塞其签署操作,等待企业内部审批完成。
企业可以通过CreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果
如果企业通知腾讯电子签平台审核通过,签署方可继续签署动作。
如果企业通知腾讯电子签平台审核未通过,平台将继续阻塞签署方的签署动作,直到企业通知平台审核通过。
注:`此功能可用于与企业内部的审批流程进行关联,支持手动、静默签署合同`
|
ApproverOption |
getApproverOption()
Get 可以控制签署方在签署合同时能否进行某些操作,例如拒签、转交他人等。
详细操作可以参考开发者中心的ApproverOption结构体。
|
Long |
getApproverRole()
Get 收据场景设置签署人角色类型, 可以设置如下****类型****:
**1** :收款人
**2** :开具人
**3** :见证人
注: `收据场景为白名单功能,使用前请联系对接的客户经理沟通。`
|
Long[] |
getApproverSignTypes()
Get 您可以指定签署方签署合同的认证校验方式,可传递以下值:
**1**:人脸认证,需进行人脸识别成功后才能签署合同;
**2**:签署密码,需输入与用户在腾讯电子签设置的密码一致才能校验成功进行合同签署;
**3**:运营商三要素,需到运营商处比对手机号实名信息(名字、手机号、证件号)校验一致才能成功进行合同签署。
注:
默认情况下,认证校验方式为人脸认证和签署密码两种形式;
您可以传递多种值,表示可用多种认证校验方式。
|
String |
getApproverSource()
Get 在企微场景下使用,需设置参数为**WEWORKAPP**,以表明合同来源于企微。
|
Long |
getApproverType()
Get 在指定签署方时,可选择企业B端或个人C端等不同的参与者类型,可选类型如下:
0**:企业
1**:个人
3**:企业静默签署
注:`类型为3(企业静默签署)时,此接口会默认完成该签署方的签署。静默签署仅进行盖章操作,不能自动签名。`
7**: 个人自动签署,适用于个人自动签场景。
注: `个人自动签场景为白名单功能,使用前请联系对接的客户经理沟通。`
|
Long[] |
getApproverVerifyTypes()
Get 指定个人签署方查看合同的校验方式,可以传值如下:
**1** : (默认)人脸识别,人脸识别后才能合同内容
**2** : 手机号验证, 用户手机号和参与方手机号(ApproverMobile)相同即可查看合同内容(当手写签名方式为OCR_ESIGN时,该校验方式无效,因为这种签名方式依赖实名认证)
注:
如果合同流程设置ApproverVerifyType查看合同的校验方式, 则忽略此签署人的查看合同的校验方式
此字段不可传多个校验方式
|
String |
getCustomApproverTag()
Get 在企业微信场景下,表明该合同流程为或签,其最大长度为64位字符串。
所有参与或签的人员均需具备该标识。
注意,在合同中,不同的或签参与人必须保证其CustomApproverTag唯一。
如果或签签署人为本方企业微信参与人,则需要指定ApproverSource参数为WEWORKAPP。
|
String |
getNotifyType()
Get 通知签署方经办人的方式, 有以下途径:
**sms** : (默认)短信
**none** : 不通知
|
String |
getOrganizationName()
Get 组织机构名称。
请确认该名称与企业营业执照中注册的名称一致。
如果名称中包含英文括号(),请使用中文括号()代替。
如果签署方是企业签署方(approverType = 0 或者 approverType = 3), 则企业名称必填。
|
Long |
getPreReadTime()
Get 签署方在签署合同之前,需要强制阅读合同的时长,可指定为3秒至300秒之间的任意值。
若未指定阅读时间,则会按照合同页数大小计算阅读时间,计算规则如下:
合同页数少于等于2页,阅读时间为3秒;
合同页数为3到5页,阅读时间为5秒;
合同页数大于等于6页,阅读时间为10秒。
|
Component[] |
getSignComponents()
Get 合同中的签署控件列表,列表中可支持下列多种签署控件,控件的详细定义参考开发者中心的Component结构体
个人签名/印章
企业印章
骑缝章等签署控件
|
String |
getUserId()
Get 签署人userId,仅支持本企业的员工userid, 可在控制台组织管理处获得
注: `若传此字段 则以userid的信息为主,会覆盖传递过来的签署人基本信息, 包括姓名,手机号,证件类型等信息`
|
String[] |
getVerifyChannel()
Get 签署意愿确认渠道,默认为WEIXINAPP:人脸识别
注: 将要废弃, 用ApproverSignTypes签署人签署合同时的认证方式代替, 新客户可请用ApproverSignTypes来设置
|
void |
setApproverIdCardNumber(String ApproverIdCardNumber)
Set 签署方经办人的证件号码,应符合以下规则
居民身份证号码应为18位字符串,由数字和大写字母X组成(如存在X,请大写)。
港澳居民来往内地通行证号码应为9位字符串,第1位为“C”,第2位为英文字母(但“I”、“O”除外),后7位为阿拉伯数字。
港澳台居民居住证号码编码规则与中国大陆身份证相同,应为18位字符串。
|
void |
setApproverIdCardType(String ApproverIdCardType)
Set 签署方经办人的证件类型,支持以下类型
ID_CARD 居民身份证 (默认值)
HONGKONG_AND_MACAO 港澳居民来往内地通行证
HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证(格式同居民身份证)
OTHER_CARD_TYPE 其他证件
注: `其他证件类型为白名单功能,使用前请联系对接的客户经理沟通。`
|
void |
setApproverMobile(String ApproverMobile)
Set 本企业的签署方经办人的员工UserId
可登录腾讯电子签控制台,在 "更多能力"->"组织管理" 中查看某位员工的UserId(在页面中展示为用户ID)。
注: `若传该字段,则签署方经办人的其他信息(如签署方经办人的姓名、证件号码、手机号码等)将被忽略。`
|
void |
setApproverName(String ApproverName)
Set 签署方经办人的姓名。
经办人的姓名将用于身份认证和电子签名,请确保填写的姓名为签署方的真实姓名,而非昵称等代名。
|
void |
setApproverNeedSignReview(Boolean ApproverNeedSignReview)
Set 发起方企业的签署人进行签署操作前,是否需要企业内部走审批流程,取值如下:
**false**:(默认)不需要审批,直接签署。
**true**:需要走审批流程。当到对应参与人签署时,会阻塞其签署操作,等待企业内部审批完成。
企业可以通过CreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果
如果企业通知腾讯电子签平台审核通过,签署方可继续签署动作。
如果企业通知腾讯电子签平台审核未通过,平台将继续阻塞签署方的签署动作,直到企业通知平台审核通过。
注:`此功能可用于与企业内部的审批流程进行关联,支持手动、静默签署合同`
|
void |
setApproverOption(ApproverOption ApproverOption)
Set 可以控制签署方在签署合同时能否进行某些操作,例如拒签、转交他人等。
详细操作可以参考开发者中心的ApproverOption结构体。
|
void |
setApproverRole(Long ApproverRole)
Set 收据场景设置签署人角色类型, 可以设置如下****类型****:
**1** :收款人
**2** :开具人
**3** :见证人
注: `收据场景为白名单功能,使用前请联系对接的客户经理沟通。`
|
void |
setApproverSignTypes(Long[] ApproverSignTypes)
Set 您可以指定签署方签署合同的认证校验方式,可传递以下值:
**1**:人脸认证,需进行人脸识别成功后才能签署合同;
**2**:签署密码,需输入与用户在腾讯电子签设置的密码一致才能校验成功进行合同签署;
**3**:运营商三要素,需到运营商处比对手机号实名信息(名字、手机号、证件号)校验一致才能成功进行合同签署。
注:
默认情况下,认证校验方式为人脸认证和签署密码两种形式;
您可以传递多种值,表示可用多种认证校验方式。
|
void |
setApproverSource(String ApproverSource)
Set 在企微场景下使用,需设置参数为**WEWORKAPP**,以表明合同来源于企微。
|
void |
setApproverType(Long ApproverType)
Set 在指定签署方时,可选择企业B端或个人C端等不同的参与者类型,可选类型如下:
0**:企业
1**:个人
3**:企业静默签署
注:`类型为3(企业静默签署)时,此接口会默认完成该签署方的签署。静默签署仅进行盖章操作,不能自动签名。`
7**: 个人自动签署,适用于个人自动签场景。
注: `个人自动签场景为白名单功能,使用前请联系对接的客户经理沟通。`
|
void |
setApproverVerifyTypes(Long[] ApproverVerifyTypes)
Set 指定个人签署方查看合同的校验方式,可以传值如下:
**1** : (默认)人脸识别,人脸识别后才能合同内容
**2** : 手机号验证, 用户手机号和参与方手机号(ApproverMobile)相同即可查看合同内容(当手写签名方式为OCR_ESIGN时,该校验方式无效,因为这种签名方式依赖实名认证)
注:
如果合同流程设置ApproverVerifyType查看合同的校验方式, 则忽略此签署人的查看合同的校验方式
此字段不可传多个校验方式
|
void |
setCustomApproverTag(String CustomApproverTag)
Set 在企业微信场景下,表明该合同流程为或签,其最大长度为64位字符串。
所有参与或签的人员均需具备该标识。
注意,在合同中,不同的或签参与人必须保证其CustomApproverTag唯一。
如果或签签署人为本方企业微信参与人,则需要指定ApproverSource参数为WEWORKAPP。
|
void |
setNotifyType(String NotifyType)
Set 通知签署方经办人的方式, 有以下途径:
**sms** : (默认)短信
**none** : 不通知
|
void |
setOrganizationName(String OrganizationName)
Set 组织机构名称。
请确认该名称与企业营业执照中注册的名称一致。
如果名称中包含英文括号(),请使用中文括号()代替。
如果签署方是企业签署方(approverType = 0 或者 approverType = 3), 则企业名称必填。
|
void |
setPreReadTime(Long PreReadTime)
Set 签署方在签署合同之前,需要强制阅读合同的时长,可指定为3秒至300秒之间的任意值。
若未指定阅读时间,则会按照合同页数大小计算阅读时间,计算规则如下:
合同页数少于等于2页,阅读时间为3秒;
合同页数为3到5页,阅读时间为5秒;
合同页数大于等于6页,阅读时间为10秒。
|
void |
setSignComponents(Component[] SignComponents)
Set 合同中的签署控件列表,列表中可支持下列多种签署控件,控件的详细定义参考开发者中心的Component结构体
个人签名/印章
企业印章
骑缝章等签署控件
|
void |
setUserId(String UserId)
Set 签署人userId,仅支持本企业的员工userid, 可在控制台组织管理处获得
注: `若传此字段 则以userid的信息为主,会覆盖传递过来的签署人基本信息, 包括姓名,手机号,证件类型等信息`
|
void |
setVerifyChannel(String[] VerifyChannel)
Set 签署意愿确认渠道,默认为WEIXINAPP:人脸识别
注: 将要废弃, 用ApproverSignTypes签署人签署合同时的认证方式代替, 新客户可请用ApproverSignTypes来设置
|
void |
toMap(HashMap<String,String> map,
String prefix)
Internal implementation, normal users should not use it.
|
any, fromJsonString, getBinaryParams, getMultipartRequestParams, getSkipSign, set, setParamArrayObj, setParamArraySimple, setParamObj, setParamSimple, setSkipSign, toJsonString
public ApproverInfo()
public ApproverInfo(ApproverInfo source)
public Long getApproverType()
public void setApproverType(Long ApproverType)
ApproverType
- 在指定签署方时,可选择企业B端或个人C端等不同的参与者类型,可选类型如下:
0**:企业
1**:个人
3**:企业静默签署
注:`类型为3(企业静默签署)时,此接口会默认完成该签署方的签署。静默签署仅进行盖章操作,不能自动签名。`
7**: 个人自动签署,适用于个人自动签场景。
注: `个人自动签场景为白名单功能,使用前请联系对接的客户经理沟通。`public String getApproverName()
public void setApproverName(String ApproverName)
ApproverName
- 签署方经办人的姓名。
经办人的姓名将用于身份认证和电子签名,请确保填写的姓名为签署方的真实姓名,而非昵称等代名。public String getApproverMobile()
public void setApproverMobile(String ApproverMobile)
ApproverMobile
- 本企业的签署方经办人的员工UserId
可登录腾讯电子签控制台,在 "更多能力"->"组织管理" 中查看某位员工的UserId(在页面中展示为用户ID)。
注: `若传该字段,则签署方经办人的其他信息(如签署方经办人的姓名、证件号码、手机号码等)将被忽略。`public String getOrganizationName()
public void setOrganizationName(String OrganizationName)
OrganizationName
- 组织机构名称。
请确认该名称与企业营业执照中注册的名称一致。
如果名称中包含英文括号(),请使用中文括号()代替。
如果签署方是企业签署方(approverType = 0 或者 approverType = 3), 则企业名称必填。public Component[] getSignComponents()
public void setSignComponents(Component[] SignComponents)
SignComponents
- 合同中的签署控件列表,列表中可支持下列多种签署控件,控件的详细定义参考开发者中心的Component结构体
public String getApproverIdCardType()
public void setApproverIdCardType(String ApproverIdCardType)
ApproverIdCardType
- 签署方经办人的证件类型,支持以下类型
public String getApproverIdCardNumber()
public void setApproverIdCardNumber(String ApproverIdCardNumber)
ApproverIdCardNumber
- 签署方经办人的证件号码,应符合以下规则
public String getNotifyType()
public void setNotifyType(String NotifyType)
NotifyType
- 通知签署方经办人的方式, 有以下途径:
public Long getApproverRole()
public void setApproverRole(Long ApproverRole)
ApproverRole
- 收据场景设置签署人角色类型, 可以设置如下****类型****:
public String[] getVerifyChannel()
public void setVerifyChannel(String[] VerifyChannel)
VerifyChannel
- 签署意愿确认渠道,默认为WEIXINAPP:人脸识别
注: 将要废弃, 用ApproverSignTypes签署人签署合同时的认证方式代替, 新客户可请用ApproverSignTypes来设置public Long getPreReadTime()
public void setPreReadTime(Long PreReadTime)
PreReadTime
- 签署方在签署合同之前,需要强制阅读合同的时长,可指定为3秒至300秒之间的任意值。
若未指定阅读时间,则会按照合同页数大小计算阅读时间,计算规则如下:
public String getUserId()
public void setUserId(String UserId)
UserId
- 签署人userId,仅支持本企业的员工userid, 可在控制台组织管理处获得
注: `若传此字段 则以userid的信息为主,会覆盖传递过来的签署人基本信息, 包括姓名,手机号,证件类型等信息`public String getApproverSource()
public void setApproverSource(String ApproverSource)
ApproverSource
- 在企微场景下使用,需设置参数为**WEWORKAPP**,以表明合同来源于企微。public String getCustomApproverTag()
public void setCustomApproverTag(String CustomApproverTag)
CustomApproverTag
- 在企业微信场景下,表明该合同流程为或签,其最大长度为64位字符串。
所有参与或签的人员均需具备该标识。
注意,在合同中,不同的或签参与人必须保证其CustomApproverTag唯一。
如果或签签署人为本方企业微信参与人,则需要指定ApproverSource参数为WEWORKAPP。public ApproverOption getApproverOption()
public void setApproverOption(ApproverOption ApproverOption)
ApproverOption
- 可以控制签署方在签署合同时能否进行某些操作,例如拒签、转交他人等。
详细操作可以参考开发者中心的ApproverOption结构体。public Long[] getApproverVerifyTypes()
public void setApproverVerifyTypes(Long[] ApproverVerifyTypes)
ApproverVerifyTypes
- 指定个人签署方查看合同的校验方式,可以传值如下:
public Long[] getApproverSignTypes()
public void setApproverSignTypes(Long[] ApproverSignTypes)
ApproverSignTypes
- 您可以指定签署方签署合同的认证校验方式,可传递以下值:
public Boolean getApproverNeedSignReview()
public void setApproverNeedSignReview(Boolean ApproverNeedSignReview)
ApproverNeedSignReview
- 发起方企业的签署人进行签署操作前,是否需要企业内部走审批流程,取值如下:
Copyright © 2023. All rights reserved.