第三方应用
应用号是什么？
应用号是您企业账号下每款应用的唯一标识符，用于快速标记您企业下的各款应用。 当您在腾讯电子签创建企业后，可通过申请应用号的方式对您企业下的若干款应用进行标记，以区分企业下不同应用之间的数据及请求。各应用号之间的数据相互隔离。
一. 报错“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）。
十三. 法人 OpenID 生成与变更机制说明
在腾讯电子签第三方集成场景下，法人的 openid 存在系统临时生成与业务绑定替换两个阶段。本节旨在梳理法人 OpenID 的生成逻辑、替换流程及相关回调通知机制，以便技术团队与业务方明确交互逻辑。 OpenID 的生成与替换机制如下：
阶段一：未加入 / 邀请认证阶段（系统临时 OpenID）
- 触发场景：当企业发起法人认证或邀请法人时，若法人尚未真实加入企业，系统无法获取业务侧定义的真实用户标识。
- 生成逻辑：腾讯电子签系统会自动为该法人生成一个临时格式的
openid。 - 标识特征：前缀为
legalPersonOpenId_，后接系统随机字符串及时间戳（例如：legalPersonOpenId_obL444555666777888999111Z_1633882838）。 - 回调体现：在企业开通等相关通知回调中，返回的法人标识即为此类临时
openid。
阶段二：真实加入 / 变更阶段（业务自定义 OpenID）
- 触发场景：当法人通过调用 CreateConsoleLoginUrl 接口生成控制台链接，并完成登录/加入流程时。
- 替换逻辑：系统会将阶段一生成的临时
openid替换为业务方在接口请求中指定的真实 OpenID。 - 回调体现：系统会触发 LegalPersonChangeOpenId回调通知，告知业务侧老的临时 OpenID 已被成功替换为新的业务 OpenID。