内部成员印章授权

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

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

接口描述

（企业法定代表人/企业管理员）将企业印章授予内部成员相关权限，需要签署《电子印章授权书》或做印章授权意愿认证，接口用于印章授权的操作链接。

注意事项：

被授权的成员须确保已加入到印章所属企业组织下，点击前往“企业成员服务API”添加成员。
当需要签署《电子印章授权书》时，开发者应用系统中可以集成该接口返回的授权书签署链接或使用e签宝自带的短信通知（前提是操作人账号有手机号绑定），企业管理员或法定代表人查看及签署。
当需要做印章授权意愿认证时，没有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和applicationsIds必须二选一传值（不能同时传或者同时不传）
	templateIds	list	否	body	授权的企业模板编号列表（模板编号或ALL），不传就是不限模板具体的模板编号 ALL - 授权机构账号下全部模板【注】（1）当授权全部企业成员（authorizedPsnIds传ALL）时，模板编号不能同时传ALL；（2）模板编号的数量最多支持传入10个。（模板编号可以登录e签宝官网复制）
	applicationsIds	list	否	body	授权的开发者应用ID列表（appId），不传就是不限应用ID 【注】使用场景：当前授权的印章人员只能在特定的某个/某些企业的平台使用时，需传入平台的开发者应用ID
autoSign		boolean	是	body	印章是否设置自动落章，默认值 false true - 设置自动落章（设置自动落章仅限《流程模板签署服务API》和《e签宝官网模板发起签署》使用） 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。
authConfirmMethod		int32	否	body	授权确认方式，默认：1（签署授权书授权） 0 - 意愿认证授权（直接跳转企业管理员/法定代表人刷脸页面，管理员/法定代表人刷脸完成即授权完成） 1 - 签署授权书授权（获取企业管理员/法定代表人加盖企业公章和个人章的签署页面，授权书盖章签署完成即授权完成）
redirectUrl		string	否	body	授权操作完成后跳转开发者指定的重定向跳转地址（符合http、https协议地址）
appScheme		string	否	body	开发者的app-Scheme地址，授权时进行支付宝刷脸意愿认证后（支付宝刷脸需要跳到支付宝app），可以根据Scheme地址跳回开发者自身app。

响应参数

展开全部参数参数名称				参数类型	必选	参数说明
code				int32	是	业务码，0表示成功，非0表示异常。
message				string	否	业务信息请根据 code 来判断错误情况，不应该依赖 message匹配，因为 message 可能会调整。
data（点击“+”展开详情）				object	否	业务数据
	sealAuthBizIds			array	否	授权业务流程编号列表（建议开发者本地保存业务流程编号）当授权多位成员、多个模板或者多个开发者应用ID时，每位成员、每个模板或者每个开发者应用ID对应一个业务流程编号；当授权全部企业成员或者全部模板时（ALL），只会返回一个业务流程编号；
	sealAuthBizInfos（点击“+”展开详情）			array	否	授权业务流程详细信息
		authorizedPsnId		string	否	被授权成员被授权人账号ID / ALL（全部企业成员）
		sealAuthBizId		string	否	授权人对应的业务流程编号当授权多个模板或者多个开发者应用ID时，可以调用《查询对内部成员授权详情》接口查询模板/应用与业务流程编号的对应关系
	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

内部成员印章授权

接口描述

接口地址&请求方法

请求头格式

请求参数

响应参数

请求示例

响应示例

错误码