【线下】发起企业授权书签署任务

更新时间:2025-04-07 11:51:10

接口描述

当企业用户需要委托平台方(应用ID所属的开发者企业)进行自动盖章时,通过该接口发起企业的线下授权任务,并获取授权书的原文件进行线下授权签署盖章(在获取到的文件下方委托方旁边的位置加盖授权方企业公章)。

接口地址

点击下述蓝色字体{host}可跳转至API请求域名说明文档

https://{host}/v1/signAuthApi/offline

请求方式

POST

请求数据格式

application/json; charset=UTF-8

请求参数

参数名称

参数位置

参数类型

必选

参数说明

accountId

Body

string

机构账号ID(创建机构签署账号接口返回的orgId)

transactorAccountId

Body

string

签署授权书的经办人个人账号ID(创建个人签署账号接口返回的accountId)

注意:

  • 请传入能为企业操作盖章人员的账号
  • 需联系e签宝技术人员开启配置项后才可使用

realnameFlowId

Body

string

经办人实名认证流程ID(30分钟有效)

注意:需联系e签宝技术人员开启配置项后才可使用

validDate

Body

Long

授权有效期截止时间(截止到当日23:59:59)

注意:

  • yyyy年MM月dd日形式
  • 截止时间会显示到授权协议内
  • 建议授权时间最长不超过3年

notifyUrl

Body

string

回调通知地址,点击跳转 企业授权结果异步回调通知

将授权签署结果通知平台

响应参数

展开全部参数参数名称

参数类型

必选

参数说明

code

int32

业务码,0表示成功,非0表示异常。

message

string

业务信息

请根据 code 来判断错误情况,不应该依赖 message 匹配,因为 message 可能会调整。

data(点击“+”展开详情)

object

业务数据

authId

string

授权流程ID

fileUrl

string

授权书原文件下载地址(有效期为60分钟,请在60分钟内尽快完成下载。如果链接超时未获取到文件,需要重新发起新的授权流程获取新的下载地址)

请求示例  

{
    "accountId": "e803760********af605b3a973",
    "sealScope": "合同专用章",
    "fileType": "全部协议",
    "validDate": "20260221",
    "notifyUrl": "http://notify.com.cn/callback/XXXXX"
}

响应示例

{
    "code": 0,
    "message": "成功",
    "data": {
        "authId": "738dad702*****e950af6b2a",
        "fileUrl": "https://esignoss.esign.cn/1111564182/f9204edc-f06c-4a72-9d8e-a1581c47d332/%E7%94%B5%E5%AD%90%E7%AD%BE%E7%AB%A0%E7%94%B3%E8%AF%B7%E5%8F%8A%E8%B0%83%E7%94%A8%E6%8E%88%E6%9D%83%E5%87%BD.pdf?Expires=3482691804&OSSAccessKeyId=LTAI4G23YViiKnxTC28ygQzF&Signature=%2Bwe32vsMmzv9pg3ytUdLeGBUGio%3D"
    }
}


我要纠错