跨企业印章授权

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

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

接口描述

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

注意事项：

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

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

接口地址&请求方法

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

请求方法：POST

请求头格式

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

请求参数

展开全部参数参数名称		参数类型	必选	参数位置	参数说明
orgId		string	是	body	机构账号ID（委托机构，企业印章的拥有者）【注】用户在e签宝注册实名后才有账号ID，账号ID获取方式请使用【查询机构认证信息】接口通过组织机构名称/组织机构证件号进行查询
sealIds		list	是	body	授权印章ID列表（授权企业印章编号，包含法定代表人印章）
sealId		string	否	body	授权印章ID（旧版）【注】自2024年11月19日起，支持一次授权多个印章，开发者可直接指定上方参数（sealIds）进行一个或者多个印章进行授权，无需再传入本参数（sealId）
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。
authorizedType		int32	否	body	授权印章使用对象，默认：0 0 - 被授权企业的管理员/法人（不限被授权方企业下的开发者应用ID） 1 - 被授权企业下的应用（仅限被授权企业下的某个指定应用ID使用，必须配合applicationsId字段使用）
applicationsId		string	否	body	被授权企业下的开发者应用ID（appId），默认不限被授权方企业下的应用ID。（authorizedType为1时该参数必传）
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长链（永久有效）
	sealAuthBizIds（点击“+”展开详情）				array	否	授权业务流程编号列表（建议开发者妥善保存业务流程编号）
		sealId			string	否	授权印章ID
sealAuthBizId			string	否	授权印章对应的业务流程编号
sealAuthBizId				string	否	授权业务流程编号（旧版）【注】自2024年11月19日起，支持一次授权多个印章，所以授权业务流程编号拓展成数组类型，开发者可以忽略此字段，直接看上方sealAuthBizIds字段

请求示例

{
    "orgId": "0c5bd49**648bfbf",
    "sealIds": [
        "0ff52476-1111-448e-9260-466f5b4b1b04"
    ],
    "transactorPsnId": "c7e00294**41e7",
    "effectiveTime": 1636525541000,
    "expireTime": 1668061541000,
    "authorizedOrgInfo": {
        "orgName": "这是一个受托企业的名称",
        "orgIDCardNum": "91330108******1222"
    },
    "redirectUrl": "https://www.xx.cn/"
}

响应示例

{
    "message": "成功",
    "code": 0,
    "data": {
        "sealAuthBizId": "565149b2-1111-4c5c-91fb-5e6e4e59db21",
        "sealAuthBizIds": [
            {
                "sealId": "0ff52476-1111-448e-9260-466f5b4b1b04",
                "sealAuthBizId": "565149b2-1111-4c5c-91fb-5e6e4e59db21"
            }
        ],
        "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"
    }
}

错误码

点击查看错误码