添加签署方自动盖章签署区
接口地址 /v1/signflows/{flowId}/signfields/autoSign
请求方式 POST
接口描述 向指定流程中创建签署区,每个签署区视为一个任务,系统会自动按照流程流转。 签署区的添加必须在签署文档添加之后, 签署区信息内部包含签署人、签署文档信息。 签署区创建完成,流程开启后,系统将自动完成“用户自动盖章签署区”的盖章。用户可全程无感完成本次签署。创建签署方自动盖章签署区前,需确定已完成账号静默签署授权 。
签署方自动盖章的合同不符合电子签名法中对可靠的要求,仅适用于对法律效力要求不高的场景,或由对接平台方自行校验真实身份和真实意愿。
请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 | ||
---|---|---|---|---|---|---|
signfields | 签署区列表数据 | body | true | array | ||
fileId | 文件file id | body | true | string | ||
authorizedAccountId | 签约主体账号标识, 将使用该主体账号对应的数字证书完成本次签署,如:当存在签署操作人代某机构签署时,需要传入该机构的账号id; | body | true | string | ||
order | 签署区顺序,默认1,且不小于1,顺序越小越先处理 | body | false | int32 | ||
posBean | 签署区位置信息, signType为1时, 页码和XY坐标不能为空, signType为2时, 页码和Y坐标不能为空 | true | 签署区位置数据 | |||
posPage | 页码信息,当签署区signType为2时, 页码可以'-'分割, 其他情况只能是数字 | body | true | string | ||
posX | x坐标,默认空 | body | false | float | ||
posY | y坐标 | body | true | float | ||
width | 签署区宽,默认印章宽度 | body | false | float | ||
signDateBeanType | 是否需要添加签署日期,0-禁止 1-必须 2-不限制,默认0 | body | false | int32 | ||
signDateBean | 签章日期信息 | body | false | SignDateBean | ||
fontSize | 签章日期字体大小,默认12 | body | false | int32 | ||
format | 签章日期格式,yyyy年MM月dd日 | body | false | string | ||
posPage | 页码信息,当signDateBeanType为1时,代表签署的印章必须展示签署日期,默认放在印章正下方,签署人可拖拽日期到当前页面的其他位置,如果发起方指定签署位置的同时,需要同时指定日期盖章位置,则需传入日期盖章页码(与印章页码相同),在传入X\Y坐标即可。 | body | false | int32 | ||
posX | x坐标,默认0 | body | false | float | ||
posY | y坐标,默认0 | body | false | float | ||
sealId | 印章id ,如不传,则采用账号下的默认印章 | body | false | string | ||
signType | 签署类型, 1-单页签署,2-骑缝签署,默认1 | body | false | int32 | ||
thirdOrderNo | 第三方业务流水号id,保证相同签署人、相同签约主体、相同签署顺序的任务,对应的第三方业务流水id唯一,默认空 | body | false | string |
请求示例
POST https://openapi.esign.cn/v1/signflows/{flowId}/signfields/autoSign
{
"signfields":[
{
"fileId":"fe7df2f477d649c18ebcfdfffeba253d",
"authorizedAccountId":"2c7de24aff3340f5b944ebac49545b8e",
"order":1,
"posBean":{
"posPage":"1",
"posX":158.72531,
"posY":431.05658
},
"sealId":"bcd7ffd9-5caf-4342-bd1c-02257229ccd5",
"signType":1
}
]
}
响应参数
参数名称 | 说明 | 类型 | |
---|---|---|---|
signfieldBeans | 签署区列表数据 | array | |
accountId | 用户ID | string | |
fileId | 文档ID | string | |
signfieldId | 签署区id | string |
响应示例
{
"code":0,
"data":{
"signfieldBeans":[
{
"accountId":"faea8237c61a4fdea864ee8d7621e14f",
"fileId":"fe7df2f477d649c18ebcfdfffeba253d",
"signfieldId":"b76b69d5b48d4f689cae997e42809ac4"
}
]
},
"message":"成功"
}
错误码
错误码 | 错误信息 | 错误原因 |
---|---|---|
1437511 | 文档不存在,fileId:XXX | 签署区里的fileId为空或fileId无效 |
1437306 | XXXX:签署页码超出文档页数 | 签署区的页码大于文档页数 |
1435002 | 未定义的signType | 签署类型无效, signType可支持4种值, 0-不限, 1-单页签署, 2-骑缝签, 4-关键字签署 |
未定义的actorIndentityType | 主体类型无效, 0-个人主体, 1- 机构主体 | |
缺少签署主体信息 | actorIndentityType为1场景下,authorizedAccountId值为空 | |
未定义的sealType | 印章类型无效, 0-手绘印章,1-模版印章,为空不限制 | |
缺少签署印章数据 | 签署区的assignedSeal值为true场景下, 印章数据为空 | |
位置信息为空 | 签署区的assignedPosbean值为true场景下, 签署坐标信息为空 | |
单页签署:必须指定正确的page、x、y | 单页签署没有指定页码和XY轴坐标 | |
关键字签署:必须指定keyword | 关键字签署的签署区关键字信息为空 | |
骑缝签署:必须指定y | 骑缝签的签署区没有指定y轴坐标 | |
骑缝签署:必须满足'-'分割 | 骑缝签的签署区指定的页码格式不对, 页码要以'-'分隔, 比如1-5 | |
签署区设置自动执行,没有指定印章 | 签署区的autoExecute值为true但是没有指定印章信息 | |
签署区设置自动执行,签署主体不允许为空 | 签署区的autoExecute值为true但是没有指定签署主体信息 | |
签署区设置自动执行,签署类型错误 | 签署区的autoExecute值为true但是指定的签署类型无效, 有效的签署类型为: 1-单页签署, 2-骑缝签, 4-关键字签署 |