添加签署方自动盖章签署区

接口地址 /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-关键字签署

results matching ""

    No results matching ""