本文是对【获取企业授权链接接口】的说明指引,分别从集成方和集成方系统用户的视角来说明。
该接口的适用场景有4个:
应用系统需访问企业用户的资源信息,如获取企业实名信息,获取企业下印章、签署任务、签署文档等数据,必须得到对应企业授权(主要)
应用系统需以企业名义发起合同签署,必须得到企业授权(主要)
应用系统需让企业提前完成实名认证(次要)
应用系统想获取企业在法大大平台的唯一标识openCorpId,将系统中的clientCorpId关联openCorpId,便于后续业务维护(次要)
集成方视角:
企业授权是企业主体把其在法大大的数据资源和权限授权给集成方应用系统,只有得到相应的授权后,集成方的应用系统才可以通过接口来使用企业主体的法大大数据。
集成方业务如涉及到上面4个场景,则需要接入获取企业授权链接接口,否则无需接入该接口获取企业授权。
获取企业授权链接接口返回的是法大大提供的内嵌页面(EUI),整个授权流程都在法大大页面上完成。
集成方集成步骤参考:
步骤一、根据具体业务流程设置开通电子签的触发入口(调用获取企业授权接口)
步骤二、根据具体情况传参,不同入参决定后续授权流程的不同
接口入参corpIdentInfo可预填企业需要在授权页填入的企业信息包含(企业名称、企业组织类型、企业唯一代码、法定代表人姓名、营业执照的图片、)。例如:集成系统本身已经收集了企业的基本信息,此时可以通过接口入参带入到授权页,为了保持数据的一致性也可以通过参数corpNonEditableInfo设置在授权页不允许用户修改带入的信息。
接口入参corpIdentMethod可指定企业实名认证方式(法人认证、代理人认证)
接口入参authScopes可设置本次授权的范围(
ident_info: 授权允许获取企业身份信息
seal_info: 授权允许获取企业的印章相关资源
organization: 授权允许获取企业的组织数据
template: 授权允许获取企业的模板数据,应用可使用其模板为任意用户发起签署任务
signtask_init: 授权允许代表企业发起签署
signtask_info: 授权允许获取企业的签署任务
signtask_file:授权允许获取企业的签署文件)接口入参oprIdentInfo可预填经办人需要在授权页实名认证时填入的个人信息,如经办人已认证可忽略次参数,包含(经办人真实姓名、经办人证件类型、经办人证件号、经办人个人手机号、经办人个人银行账户号,经办人实名认证方式(人脸识别认证、实名手机号三要素认证、个人银行卡四要素认证))
接口地址:获取企业授权链接接口
步骤三、设置重定向地址(可选)
接口入参redirectUrl可设置页面重定向地址,通常在完成授权流程后按照集成方的业务流程重定向到指定的页面,并在链接上带入授权结果信息。
重定向url示例:https://xxx.xxx.com/xxx/xxx(集成方系统页面地址)?signature=db9efa24a6889fc12505f50f5963469c144fe662e483686adffbdf2d09b633cf&authResult=success&clientCorpId=corp0000001&openCorpId=488ea2857b1c446c9b59dc5bdcf60a78&authScope=ident_info,signtask_init,signtask_info,template,signtask_file,seal_info,organization×tamp=1685418053000(法大大附加的授权结果信息)
步骤四、接收企业用户授权事件回调(推荐)
推荐使用事件回调(异步)的方式拿到企业授权结果,虽然步骤三重定向地址也会带上授权结果,但是由于是通过前端浏览器页面的方式所以很容易会被干扰导致拿不到授权结果。
详细内容可查看:企业用户授权事件
集成方系统用户视角:
集成方用户使用步骤参考:
步骤一、用户通过入口进入开通电子签页面
示例图
步骤二、检查开通页信息是否正确
查看授权信息-完全是由集成系统控制,在开通电子签页面不可修改。
检查企业信息-可在页面输入,也可由集成系统带入。
确认经办人信息手机号/邮箱
注:若之前有在法大大平台注册过的,可填入经办人在法大大平台的登陆帐号。
步骤三、确认信息无误后点击【立即开通】
通过【企业名称】判断该企业是否已在法大大平台做过注册或认证、是否已经在集成应用系统开通了电子签。具体判断流程如下图所示:
注:已在法大大平台认证过的企业,建议经办人填企业超管的法大大帐号,可直接完成授权。
经办人手机号/邮箱未在法大大平台认证过,需要走法大大个人实名认证流程,具体流程如下图所示:
注:也可以在法大大SaaS平台(https://cloud.fadada.com)完成经办人帐号的个人实名认证,认证信息在法大大平台是通用的。
经办人已在法大大认证过,但企业未在法大大平台认证过,需要走法大大企业认证流程,如下图所示:
步骤四、开通成功重定向回集成系统,由集成系统判断下一步操作。
点击确认后会跳转回集成系统的指定页面,继续进行业务操作。
企业授权EUI页面流程图:
