跨企业授权

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

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

接口描述

当委托单位需要将企业印章授权给外部企业时，接口可用于获取《电子印章跨企业委托使用授权书》的签署链接。委托机构通过授权书签署链接完成签署，并进行意愿认证即代表印章授权成功，开发者同时将接收到印章授权生效的回调通知。

注意事项：

跨企业印章签署的文件所展示的对应签名信息，印章样式和数字证书均为授权企业（委托机构）所有。
适用场景：集团分总企业、关联合作企业等。

仅支持企业印章跨企业授权，“法人章”不支持跨企业授权。
接口返回的授权书签署链接，需开发者在应用系统内自行集成通知委托机构来签署（如果授权委托人账号绑定了联系方式，也会有e签宝默认的短信/邮件通知委托人来签署）。
点击这里了解更多印章跨企业授权说明。

接口地址&请求方法

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

请求方法：POST

请求头格式

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

请求参数

展开全部参数参数名称		参数类型	必选	参数位置	参数说明
orgId		string	是	body	机构账号ID（委托机构，企业印章的拥有者）【注】用户在e签宝注册实名后才有账号ID，账号ID获取方式请使用【查询机构认证信息】接口通过组织机构名称/组织机构证件号进行查询
sealId		string	是	body	授权印章ID（企业印章编号）
transactorPsnId		string	是	body	授权操作人账号ID（委托机构的法定代表人或企业管理员个人账号ID）【注】：法定代表人或企业管理员个人账号ID可通过【查询企业成员列表】接口获取。
authorizedOrgInfo（点击“+”展开详情）		object	是	body	被授权机构信息（受托机构）
	orgName	string	是	body	被授权机构名称
	orgIDCardNum	string	是	body	被授权机构证件号【注】统一社会信用代码或工商注册号
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	否	业务数据
	authorizationSignShortUrl	string	否	授权书签署url短链（有效期180天）
	authorizationSignUrl	string	否	授权书签署url长链（永久有效）
	sealAuthBizId	string	否	授权业务流程编号（建议开发者妥善保存业务流程编号）

请求示例

{
    "orgId": "0c5bd49**648bfbf",
    "effectiveTime": 1636525541000,
    "expireTime": 1668061541000,
    "transactorPsnId":"c7e00294**41e7",
    "authorizedOrgInfo":{
        "orgName":"这是一个受托企业的名称",
        "orgIDCardNum":"91330108******1222"
    },
    "sealId": "02590082-xx-xx-xx-2138db4d7b73",
    "redirectUrl": "https://www.xx.cn/"
}

响应示例

{
  "message": "成功",
  "code": 0,
  "data": {
    "sealAuthBizId": "7327fd33-xx-xx-xx-494f313340aa",
    "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/MkgR***cT0"
  }
}

错误码

点击查看错误码