内部成员授权

必须确保企业用户已授予平台appId获取其印章资源管理和发起签署的权限，点击查看如何授权

manage_org_seal - 授权允许获取企业/组织用户的印章的查询、新增、编辑、授权、删除权限
org_initiate_sign - 授权允许代表企业/组织用户发起合同签署以及查询合同签署详情

接口描述

（企业法定代表人/企业管理员）将企业印章授予内部成员相关权限，并签署《电子印章授权书》，接口用于获取授权书的签署链接。

注意事项：

被授权的成员须确保已加入到印章所属企业组织下，点击前往“企业成员服务API”添加成员。
开发者应用系统中可以集成该接口返回的授权书签署链接或使用e签宝自带的短信通知（前提是操作人账号有手机号绑定），企业管理员或法定代表人查看及签署。
授权操作人必须为该企业成员，否则无法发起，建议授权操作人为当前企业管理员或法定代表人。
开发者可参考印章授权生效通知来接收印章授权生效的回调通知。
点击这里了解更多企业印章内部授权说明。

接口地址&请求方法

接口地址：https://{host}/v3/seals/org-seals/internal-auth

请求方法：POST

请求头格式

具体请求头参数，请查看公共请求头格式。

请求参数

展开全部参数参数名称		参数类型	必选	参数位置	参数说明
orgId		string	是	body	机构账号ID 【注】用户在e签宝注册实名后才有账号ID，账号ID获取方式请使用【查询机构认证信息】接口通过组织机构名称/组织机构证件号进行查询
sealId		string	是	body	授权印章ID（企业印章编号）【注】通过接口获取企业印章ID：查询企业内部印章
authorizedPsnIds		list	是	body	指定被授权成员（账号ID或ALL）被授权人账号ID列表（最多授权10个成员） ALL - 授权全部企业成员【注】传ALL时，sealRole印章角色只能指定印章使用员
sealRole		string	是	body	指定印章角色，点击了解印章角色介绍 SEAL_USER - 印章使用员（印章使用权限） SEAL_EXAMINER - 印章审批员（印章使用权限+用印审批权限）
transactorPsnId		string	是	body	授权操作人账号ID 【注】建议传入企业管理员或法定代表人的个人账号ID。若传入普通企业成员账号ID，则默认会向企业管理员发送授权书签署通知。
sealAuthScope		object	是	body	授权印章使用范围
	templateIds	list	是	body	授权范围列表（模板编号或ALL）当授权全部企业成员（authorizedPsnIds传ALL）时，授权范围不能同时传ALL；模板编号的数量最多支持传入10个。（模板编号可以登录e签宝官网复制）
autoSign		boolean	是	body	印章是否设置自动落章，默认值 false true - 设置自动落章，false - 不设置自动落章【注】（1）设置自动落章必须授权全部企业成员，并且指定具体的模板编号。（2）设置自动落章后，使用对应的模板发起签署的文件无需经办人手动签署，可自动加盖。（3）同一个模板只能授权对应企业下某一个印章自动落章，不允许多个印章自动落章。
effectiveTime		int64	是	body	授权生效时间（Unix时间戳格式，单位：毫秒）
expireTime		int64	是	body	授权失效时间（Unix时间戳格式，单位：毫秒）【注】（1）授权有效期最长不可超过3年。（2）授权实际失效时间是以天为单位，例如：指定时间戳对应的时间为：2023-02-01 11:20:47，实际失效时间为：2023-02-01 23:59:59。
redirectUrl		string	否	body	授权书签署完成后重定向跳转地址（符合http、https协议地址）
appScheme		string	否	body	签署授权书时进行支付宝刷脸意愿认证后，可以跳回开发者app。

响应参数

展开全部参数参数名称				参数类型	必选	参数说明
code				int32	是	业务码，0表示成功，非0表示异常。
message				string	否	业务信息请根据 code 来判断错误情况，不应该依赖 message匹配，因为 message 可能会调整。
data（点击“+”展开详情）				object	否	业务数据
	sealAuthBizIds			array	否	授权业务流程编号列表（建议开发者本地保存业务流程编号）当授权多位成员时，每位成员对应一个业务流程编号；当授权全部企业成员时，只会返回一个业务流程编号；
	sealAuthBizInfos（点击“+”展开详情）			array	否	授权业务流程详细信息
		authorizedPsnId		string	否	被授权成员被授权人账号ID / ALL（全部企业成员）
		sealAuthBizId		string	否	授权人对应的业务流程编号
	authorizationSignShortUrl			string	否	授权书签署短链接（有效期180天）
authorizationSignUrl			string	否	授权书签署长链接（永久有效）
sealAuthorizeType			int	否	授权操作人的企业成员角色 1 - 管理员、法定代表人 2 - 普通成员

请求示例

{
    "orgId":"0c5bd49***48bfbf",
    "sealId":"02590082-xx-xx-xx-2138db4d7b73",
    "effectiveTime":1636525541000,
    "expireTime":1668061541000,
    "transactorPsnId":"c7e0029***10541e7",
    "authorizedPsnIds":["7ffcae***f0a8f6","00371e8***c21ed09"],
    "sealAuthScope":{
        "templateIds":["ALL"]
    },
    "sealRole":"SEAL_EXAMINER",
    "redirectUrl":"https://www.xxx.cn/"
}

响应示例

{
  "message": "成功",
  "code": 0,
  "data": {
    "sealAuthBizIds": [
      "b3eb3d0a-xx-xx-xx-bbda4ee40e07",
      "9089bd2e-xx-xx-xx-d94510e860e7"
    ],
    "sealAuthBizInfos": [
      {
        "authorizedPsnId": "626629******299f1d8c1d",
        "sealAuthBizId": "b3eb3d0a-xx-xx-xx-bbda4ee40e07"
      },
      {
        "authorizedPsnId": "0e04b427******0957c21e96",
        "sealAuthBizId": "9089bd2e-xx-xx-xx-d94510e860e7"
      }
    ],

    "authorizationSignUrl": "https://h5.esign.cn/mesign/guide?context=Nksbcxa&flowId=0d46****89889dce16966b8&organ=true&appId=5****5&linkSource=1&bizType=1&tsign_source_type=SIGN_LINK_XUANYUAN&tsign_source_detail=1vGqUyZBm8k4aIosgUEaAJ40lsE7AJ7F9iSLvM9qrkC28h11ZZUbSoIipVsi%2BtbjwrVJo2n0cjgeEFrWTVKT8mOocb7oM8s2EIx3JuKOt16arLi98Q0TRUjf3JROLf08nYE2XOMSuPrevLzSmwsVj1GKu4v0VKzqOOcpKoj%2BeAuhvQL6l1mXSrTXXZ0kmK5bXfbgH%2F2tW0rbfa3iyzlHvb%2FCYLKwiQ5xvOEghorX0i2eypB%2Frf",
    "authorizationSignShortUrl": "https://t.esign.cn/BP9a***rg7cw",
    "sealAuthorizeType": 2
  }
}

错误码

点击查看错误码

印章服务API

内部成员授权

接口描述

接口地址&请求方法

请求头格式

请求参数

响应参数

请求示例

响应示例

错误码