第三方应用
应用号是什么?
应用号是您企业账号下每款应用的唯一标识符,用于快速标记您企业下的各款应用。 当您在腾讯电子签创建企业后,可通过申请应用号的方式对您企业下的若干款应用进行标记,以区分企业下不同应用之间的数据及请求。各应用号之间的数据相互隔离。
报错“Agent.ProxyOperator.OpenId指定的这个子企业员工未完成注册”
第三方应用集成的所有接口都需要已认证的子客企业员工发起,具体认证流程请参见接入前必读和子客入住小节。
报错“Agent.ProxyOrganizationOpenId指定的这个子企业还没有完成认证,无法完成此操作”
第三方应用集成的所有接口都需要已认证的子客企业员工发起,具体认证流程请参见接入前必读和子客入住小节。
认证报错“用户不匹配。该链接已被XX占用并发起认证流程,您无法继续使用该链接进行认证”
出现以下报错是由于XX已经在认证中了,此时再把认证链接给到其他人,则会报错。

解决方式:
- 方式1:让XX继续走认证流程。
- 方式2:如果要换人认证,需要更换
Agent.ProxyOperator.OpenId
,重新生成认证链接 。
如何修改子客企业的OpenId?
子客企业的OpenId无法修改,除非注销企业后重新认证。子客企业员工的OpenId也无法修改,除非让员工离职后重新加入。
同一个人可以同时加入一个应用下的两个子客企业吗?
可以。但在认证时需要定义不同的ProxyOperator.Openld
。
报错“渠道应用号和此渠道子客不具有授权关系,请确认参数或授权关系后重试”
报错是指传参中的子客企业(Agent.ProxyOrganizationOpenId
)未在所传应用号(AppId
) 下认证。
员工加入报错“该身份证号已完成实名认证并加入渠道企业”
例如张三已经加入到了子客企业A,openId为openId1
,此时张三又以OpenId2
为标识再次走加入子客A的流程,则会报以下错误:

如果想更改张三在子客A中的openId,需要离职再重新加入。
子客员工无权下载合同是怎么回事?
子客员工在小程序中下载合同报以下权限错误,是由于其角色(默认业务员)不具备下载权限:

此时需要给对应员工分配业务管理员权限:
报错“参数错误,企业经办人 OpenId 已经在其他企业实名,或者是用模板发起合同时模板配置的渠道子客签署的角色传递了其他企业签署方”
在调用模板创建签署流程接口时报此错误,很可能是在平台企业的「应用模板库」中配置模板时指定错了签署方,请参考下图检查:
配置模板时找不到数据表格控件?
在平台企业的「应用模板库管理」中配置带有数据表格的模板时,需要先在「应用模板控件管理」中添加数据表格控件:
报错“参数错误,指定的应用号不存在”
常见原因是,指定的AppId
传入了正式(测试)环境的AppId,而接口请求到了测试(正式)环境。
联调环境地址:
环境 | 地址 | 说明 |
---|---|---|
文件服务的EndPoint | file.test.ess.tencent.cn | UploadFiles接口使用 |
通用接口请求EndPoint | essbasic.test.ess.tencent.cn | 除UploadFiles外其他接口使用 |
线上环境地址:
环境 | 地址 | 说明 |
---|---|---|
文件服务的EndPoint | file.ess.tencent.cn | UploadFiles接口使用 |
通用接口请求EndPoint | essbasic.tencentcloudapi.com | 除UploadFiles外其他接口使用 |
报错“被授权企业未认证”
在调用创建企业自动签授权链接接口时如果报此错误,请检查接口中的AuthorizedOrganizationId
字段是否传入的是企业ID(非企业OpenId)。