企业批量认证及初始化
在某些情形下(比如集团业务),购买电子签的企业(下文称平台企业)可能还需要组织和引导其他关联企业认证电子签,并进行一些必要的企业初始化操作。如果有大量关联企业,可以通过本文介绍的批量认证及初始化方式进行操作。
企业批量认证及初始化操作的关键在于可以用同一个人只需要1-2次扫脸即可完成多个企业的认证及初始化,避免了指导多个关联企业不同超管去操作。大致流程如下:
注意:以上流程各环节之间没有耦合,可独立进行,可批量初始化的功能点也可以选择性的操作。批量变更超管能力待发布。
企业批量认证
1. 准备工作
进行批量认证前,需要提前准备待认证企业的如下材料:
- 企业名称
- 统一社会信用代码
- 法人姓名
- 企业住所
- 超管姓名
- 超管手机号
- 超管授权书
其中,「企业名称」、「统一社会信用代码」、「法人姓名」必须和营业执照上内容相同,「企业住所」可以简化到省市, 「超管」即此次进行批量认证的操作人(所有企业同一个人),批量认证成功后此人会成为所有企业的超管, 「超管授权书」模板从这里下载 (如果这批企业的法人是同一个人,且此次批量认证由法人本人操作,「超管授权书」可忽略)。
注意:
1. 以上材料需认真准备,批量认证失败的企业暂时只能单个进行处理。
2. 超管授权书填写参见填写说明, 需要注意的是批量认证下载的是一个空白模板,[填写说明]中针对单个企业认证,下载的是一个已经自动填充部分内容的模板, 这部分内容在批量认证的空白模板中需要手写填入,并确保填入的正确性。
2. 创建企业批量认证链接
调用创建企业批量认证链接接口, 传入步骤1中准备的信息。示例:
{
"Operator":{
"UserId": "yD****************************hZ" // 平台企业超管
},
"RegistrationOrganizations":[
{
"OrganizationName":"批量认证企业1", // 企业名称
"UniformSocialCreditCode":"91****************", // 统一社会信用代码
"LegalName":"张三", // 法人姓名
"Address":"北京市", // 企业住所
"AdminName":"王刚", // 超管姓名,所有企业传同一个人
"AdminMobile":"186********", // 超管手机号,所有企业传同一手机号
"AuthorizationTypes":[1], // 非法人认证必传[1]
"PowerOfAttorneys":["/9j/4A5IWWEAgABA*********"] // 超管授权书Base64编码
},
{
"OrganizationName":"批量认证企业2",
"UniformSocialCreditCode":"91****************",
"LegalName":"李四",
"Address":"广东省深圳市",
"AdminName":"王刚",
"AdminMobile":"186********",
"AuthorizationTypes":[1],
"PowerOfAttorneys":["/9j/4AAQSkZJRgABA*********"]
},
{
"OrganizationName":"批量认证企业3",
"UniformSocialCreditCode":"91****************",
"LegalName":"王五",
"Address":"陕西省西安市",
"AdminName":"王刚",
"AdminMobile":"186********",
"AuthorizationTypes":[1],
"PowerOfAttorneys":["/9j/2GKQjsKMqTkAD*********"]
}
]
}
注意:如果这批企业的法人是同一个人,且此次批量认证由法人本人操作,则LegalName
和AdminName
相同,AuthorizationTypes
字段传[2],PowerOfAttorneys
不传。
返回示例:
{
"Response": {
"ErrorMessages": [],
"RequestId": "64d6f78b-****-****-****-0de375df0b24",
"TaskId": "yDCHcUUckpbq*********jR8sIE3ZRi2"
}
}
3. 查询企业批量认证链接
调用查询企业批量认证链接,
传入上一步返回的TaskId
。这个步骤有以下三个作用:
- 批量认证前的预检查。比如从下面示例的回包中可知,有一个企业的工商信息填写错了。遇到这种情况可检查步骤2中的传值,修改后从步骤2开始重新走流程;
- 获取
SubTaskId
,后续生成批量认证单链接时用来筛选本次批量认证的企业。(注意:如无此需求,可忽略返回的SubTaskId
参数) - 实际上在步骤2中可以针对不同企业传入不同的超管,在这一步中将各企业的
AuthUrl
给到其超管,分别做各自的企业认证。(注意:如无此需求,可忽略返回的AuthUrl
参数)
调用示例:
{
"Operator":{
"UserId": "yD****************************hZ"
},
"TaskId": "yDCHcUUckpbq*********jR8sIE3ZRi2" // 步骤2返回
}
返回示例:
{
"Response": {
"OrganizationAuthUrls": [
{
"AuthUrl": "https://beta.qian.tencent.cn/console/batch-register?urlAuthToken=yDCHc*******99j2UiYiimy8H9ZPq2gn&orgName=批量认证企业1",
"ErrorMessage": "",
"SubTaskId": "yDCHcUUckpbq99jjUiYiimEMpQg52nrK"
},
{
"AuthUrl": "https://beta.qian.tencent.cn/console/batch-register?urlAuthToken=yDCHc*******9sosUyg7ejREiej6SGBj&orgName=批量认证企业2",
"ErrorMessage": "",
"SubTaskId": "yDCHcUUckpbq99j8UiYiimwQ0cSNJzN4"
},
{
"AuthUrl": "",
"ErrorMessage": "三要素校验失败: rpc error: code = Internal desc = 工商库未能查询到企业信息,请核实信息或切换为上传营业执照认证。",
"SubTaskId": "yDCHcUUckpbq99jhUiYiimCW64F0m6OF"
}
],
"RequestId": "e831c85e-f9e8-4fe7-b5ea-f1da2b647d42",
"TaskId": ""
}
}
4. 生成企业批量认证单链接
调用创建企业批量认证链接-单链接接口。
传入和步骤2中相同的超管信息(AdminName
、AdminMobile
),会自动匹配出此超管当前存在的批量认证任务。示例:
{
"Operator":{
"UserId": "yD****************************hZ"
},
"Endpoint": "HTTP_SHORT_URL", // 跳转电子签小程序的http_url
"AdminName":"王刚",
"AdminMobile":"186********"
}
注意:由于步骤2中CreateBatchOrganizationRegistrationTasks接口有上限10个的数量限制, 可以多次调用之后再来生成批量认证单链接(上限500个企业)。比如有80个企业,可以步骤2分批调用八次后再来生成单链接,直接可以匹配出80个企业。
返回示例:
{
"Response": {
"AuthUrl": "https://test.essurl.cn/rvpNUBH***", // 最终用来批量认证的链接
"ErrorMessages": [],
"ExpireTime": 1724853830,
"RequestId": "20c8265d-f046-4c09-946f-f5283114d07b"
}
}
注意:若返回报错"当前没有需要创建的任务",着重检查两点,一是步骤2和步骤4中超管信息是否一致,二是步骤2中传入的企业工商信息是否正确,可以通过步骤3预检查。
5. 超管进行批量认证
将步骤4中生成的认证单链接给到传入的超管(比如以上示例中给到"王刚"),超管打开链接做批量认证(演示视频)。授权书批量提交成功后,会由腾讯电子签专员进行审核, 各企业的审核结果会通过回调进行通知。 (如果是法人操作批量认证,无需授权书直接扫脸即可,演示视频。)
特别强调:超管一旦打开批量认证链接,匹配到的待认证企业则创建了各自的认证流,如果批量认证未完成(比如超管授权书被拒),已创建的认证流仍然存在。 目前无法通过本文步骤2重新提交信息覆盖已存在的认证流,只能通过下图所示对未认证成功的企业进行单个处理。
企业批量初始化
如果有一批企业是通过平台企业引导创建的, 且这批企业的超管(或法人)都是张三,平台企业还可以通过批量操作企业初始化接口对这批企业生成一个批量初始化的链接, 然后继续由张三通过此链接进入小程序,对这批企业进行批量创建印章、加入集团、开通自动签的操作。
1. 创建企业批量初始化链接
调用示例:
{
"Operator":{
"UserId": "yD****************************hZ" // 平台企业超管
},
"OperateTypes": ["CREATE_SEAL","AUTH_JOIN_ORGANIZATION_GROUP","OPEN_AUTO_SIGN"], // 初始化操作列表,无需关注传入顺序会自动调整
"OrganizationIds":["yD****************************Og","yD****************************Ec","yD****************************lW"] // 待初始化企业列表,具有相同的超管或法人
}
其中,初始化操作列表可在[创建印章、加入集团、开通自动签]中根据需要任意组合传入,但实际操作步骤会在初始化流程中自动调整,比如:
- 只传入了
AUTH_JOIN_ORGANIZATION_GROUP
(加入集团),但传入的部分企业还没有印章,会在流程中给这部分企业先批量创建印章; - 只传入了
["CREATE_SEAL","OPEN_AUTO_SIGN"]
(创建印章+开通自动签),但传入的部分企业还不是「高级版」,不具备开通自动签的能力,这部分企业开通自动签会失败。 (注:如果还传入了AUTH_JOIN_ORGANIZATION_GROUP
,加入集团后子企业自动升级为高级版)
2. 超管进行批量初始化
将步骤1返回的链接给到张三(这批企业的超管或法人),张三会进入小程序进行批量初始化操作(演示视频):