无感签署（申请开放） - 签盾开放平台-电子签约服务

签署人对发起后的合同进行签署。相较于普通签署方式，此接口无需进行意愿认证（即用户无感知）

注意

无感签需申请后才开放

通过查询签署方信息接口，可获取合同签署方信息

一次签署任务所用印章必须属于同一个签署人

每次签署会导致合同fileCode变化，如使用fileCode调用签署，具体fileCode信息请通过提示2的方式获取

签署坐标相关详见印章指定位置

若此业务场景不满足，签署场景需要签署人相对无感，且需要签署人授权，则可以使用静默签，若需要使用静默签，详见静默签使用说明

可能出现的错误码

错误码	错误信息	解决办法
500	服务繁忙,请重试.	联系客服
400	参数错误.	参数与接口文档进行核对
oc_10011	用户未认证	用户认证
oc_20006	无效印章	检查印章信息
oc_20007	印章信息解析失败	检查印章信息或联系客服
oc_40005	签署记录不存在或状态异常	检查签署人状态
oc_40006	合同不存在或状态异常	检查合同状态
oc_40007	合同正在签署中，请稍后重试	稍后重试
oc_40008	时间戳证书签发失败	联系客服
oc_40011	文件签署失败	联系客服
oc_40013	合同签署已截止	检查合同信息
oc_40015	未找到关联签署文件	参数检查
oc_40016	签署位置不能重复	参数检查
oc_40017	签署区域与设置签署区域不同	参数检查
oc_40020	单页合同文件不能进行骑缝签章	参数检查
oc_40021	应用未开启无感签，请联系签盾管理员开启	联系客服
oc_40029	意愿认证方式错误	重新进行意愿认证

请求参数

Body 参数application/json

contractId

string

合同id

可选

contractId和businessCode二选一

businessCode

string

第三方签署流程业务id

可选

contractId和businessCode二选一。注：需在发起时指定

accountId

string

签署方accountId

必需

签署方accountId

signFields

array [object {6}]

签署区域配置

必需

一次签署任务所用印章必须属于同一个签署人

fileCode

string

签署文件Code

可选

指定文档签署时，fileCode与fileld二选一，两者都不填则签署全部文档。签署后doc对应fileCode会变化，需通过查询签署方信息接口查询最新fileCode，不建议使用

fileId

string

集成方自定义文件编号

可选

指定文档签署时，fileCode与fileld二选一，两者都不填则签署全部文档。需发起时指定，与发起时doc对应一致，不会发生变化，建议使用

sealId

number

印章id

必需

dateFormat

enum<string>

日期格式

可选

若发起时指定了日期格式，最终签署时以发起时为准，发起时未指定，以签署时为准

枚举值:

YYYY年MM月DD日YYYY/MM/DDYYYY-MM-DD

signFieldStyle

enum<integer>

签章区样式

可选

若发起时指定了签章样式，需和发起时保持一致

枚举值:

signFieldPosition

object

签署坐标位置

必需

左上角为坐标原点。注：若发起时指定了签章位置，需和发起时保持一致

示例

{
    "contractId": "1867386328003383296",
    "signFields": [
        {
            "fileCode": "FC_20241212171254RkztvLleUICgRSe",
            "sealId": 100000007,
            "dateFormat": "YYYY年MM月DD日",
            "signFieldStyle": 1,
            "signFieldPosition": {
                "positionPage": 1,
                "positionX": 200,
                "positionY": 400
            }
        },
        {
            "fileCode": "FC_20241212171254RkztuileUICgRPd",
            "sealId": 100000008,
            "dateFormat": "YYYY-MM-DD",
            "signFieldStyle": 2,
            "signFieldPosition": {
                "positionPage": 0,
                "positionX": 0,
                "positionY": 300
            }
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

string

请求返回code

必需

msg

string

请求返回msg

必需

result

object

必需

contractId

number

合同id

可选

根据入参返回

businessCode

string

第三方签署流程业务id

可选

根据入参返回

success

boolean

是否成功

必需

logKey

string

日志key

必需

number

时间戳

必需

示例

{
    "code": "string",
    "msg": "string",
    "result": {
        "contractId": 0,
        "businessCode": "string"
    },
    "success": true,
    "logKey": "string",
    "ts": 0
}