通过文件发起合同 - 签盾开放平台-电子签约服务

合同发起接口

上传文件发起合同需进行以下2步

（1）步骤一：通过【上传文件】接口或者【基于模板生成文件】接口生成合同源文件，生成的文件可重复使用

（2）步骤二：通过合同文件发起合同

注意

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

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

若签署场景需要签署人无感，且无须签署人授权，在签署人无感知情况下完成签署，可使用无感签署（申请开放），无感签能力需要申请开放

发起合同时若未指定签署位置，通过获取合同签署链接接口获取签署链接进行页面签署时，所有合同文件都必须进行落章

可能出现的错误码

错误码	错误信息	解决办法
500	服务繁忙,请重试.	联系客服
400	参数错误.	参数与接口文档进行核对
oc_10011	用户未认证	进行认证
oc_30005	上传文件格式不支持	更换支持发起合同以及附件格式的文件
oc_30006	文件处理失败	重新发起，或联系客服
oc_40001	签署截止时间不能超过12个月	检查参数
oc_40002	签署截止时间不能小于当前时间	检查参数
oc_40003	签署方不可重复	检查参数
oc_40014	合同doc文件不能重复	检查参数
oc_40016	签署位置不能重复	检查参数
oc_40020	单页合同文件不能进行骑缝签章	检查参数
oc_40027	同一签署方不能同时配置静默签和普通签署	检查参数

请求参数

Body 参数application/json

示例

{
    "signFileType": "PDF",
    "docs": [
        {
            "fileId": "1",
            "fileCode": "FC_20260901111459acXBPucFMbqLzLx",
            "fileOrder": 1,
            "fileName": "1.pdf"
        }
    ],
    "attachmentFiles": null,
    "signFlowInitiator": {
        "accountId": "ltc-cs"
    },
    "signers": [
        {
            "accountId": "zzq-cs",
            "seqNo": 1,
            "signFields": [
                {
                    "fileCode": "FC_20260901111459acXBPucFMbqLzLx",
                    "signFieldStyle": 1,
                    "dateFormat": "YYYY-MM-DD",
                    "signFieldPosition": {
                        "positionPage": 1,
                        "positionX":200,
                        "positionY": 200
                    }
                }
            ],
            "authConfig": {
                "willingnessAuthModes": [
                    "CODE_SMS",
                    "PSN_FACE"
                ]
            }
        }
    ],
    "signFlowConfigs": {
        "flowConfig": {
            "contractName": "测试合同",
            "seqSigning": false
        }
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": "string",
    "msg": "string",
    "result": {
        "contractId": "string",
        "businessCode": "string",
        "autoSignMsg": "string",
        "  signersInfos": [
            {
                "accountId": "string",
                "seqNo": 0
            }
        ]
    },
    "success": true,
    "logKey": "string",
    "ts": "string"
}