合同发起

错误码	错误描述
31400	合同唯一编号已存在
31401	签约文件docId：{docId}数据不存在
31402	附件fileId：{fileId}数据不存在
31403	签署截止日期：{expireDate}不能小于当前日期
31404	不能重复添加签约人
31405	签约方account：{account}数据不存在
31406	印章编号sealNo：{sealNo}不属于账号account：{account}
31407	授权签署账号authSignAccount：{authSignAccount}数据不存在
31408	未查询到印章{sealNo}与授权签署账号{authSignAccount}的有效授权记录
31409	签署控件类型错误，个人不支持骑缝签，企业不支持个人签章
31410	关联的签约文件不存在
31411	签署顺序类型为有序签署时，签署顺序signerOrder不能存在相同的值
31423	骑缝签不支持关键字签署，signPositionType应该设置为坐标方式
31424	未查询到签约方{account}与授权签署账号{authSignAccount}的有效授权记录
31425	签约文档顺序docOrder不能存在相同的值

请求参数

Header 参数

Body 参数application/json

示例

{
    "contractNo": "360000200407113620",
    "contractName": "劳动合同",
    "expireDate": "2028-09-02",
    "signDocumentList": [
        {
            "docType":"UPLOAD",
            "docId": "72207745886821305421",
            "docOrder": 1
        }
    ],
    "annexList": [
        {
            "fileId": "72207745886821305421"
        }
    ],
    "signOrderType": "NO_ORDER",
    "signerList": [
        {
            "account": "72207745886821305421",
            "sealNo": "72207745886821305421",
            "authSignAccount": "72207745886821305421",
            "authSignMode": 1,
            "signerOrder": 1,
            "isNotice": 0,
            "noticeWay": "18681826577",
            "positionParamList": [
                {
                    "controlType": "SEAL",
                    "signPositionType": "POSITION",
                    "relationDocList": [
                       "72207745886821305421"
                    ],
                    "pageConfig": "1,3-5",
                    "controlWidth": "120",
                    "controlHeight": "120",
                    "offsetX": "0",
                    "offsetY": "0"
                },
                {
                    "controlType": "SEAL",
                    "signPositionType": "KEYWORD",
                    "relationDocList": [
                        "72207745886821305421"
                    ],
                    "keyword": "甲方（盖章）",
                    "keywordType": "ALL",
                    "controlWidth": "120",
                    "controlHeight": "120",
                    "offsetX": "20",
                    "offsetY": "0"
                }
            ],
            "confirmType": [
                "CAPTCHA","PASSWORD"
            ],
            "bizId": "370000197401058277"
        }
        
    ],
    "controlChangeFlag": "NECESSARY_AND_ADD",
    "callbackPage": "http://dqffzqhfl.bt/ncgnfsxu",
    "contractCallbackUrl": "http://jpibwhkto.asia/vdkny"
}

请求示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://test-tool.kaifangqian.com/kaifangqian/openAPI/V1/contract/send' \
--header 'appId: 000001' \
--header 'sign: {{sign}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "contractNo": "360000200407113620",
    "contractName": "劳动合同",
    "expireDate": "2028-09-02",
    "signDocumentList": [
        {
            "docType":"UPLOAD",
            "docId": "72207745886821305421",
            "docOrder": 1
        }
    ],
    "annexList": [
        {
            "fileId": "72207745886821305421"
        }
    ],
    "signOrderType": "NO_ORDER",
    "signerList": [
        {
            "account": "72207745886821305421",
            "sealNo": "72207745886821305421",
            "authSignAccount": "72207745886821305421",
            "authSignMode": 1,
            "signerOrder": 1,
            "isNotice": 0,
            "noticeWay": "18681826577",
            "positionParamList": [
                {
                    "controlType": "SEAL",
                    "signPositionType": "POSITION",
                    "relationDocList": [
                       "72207745886821305421"
                    ],
                    "pageConfig": "1,3-5",
                    "controlWidth": "120",
                    "controlHeight": "120",
                    "offsetX": "0",
                    "offsetY": "0"
                },
                {
                    "controlType": "SEAL",
                    "signPositionType": "KEYWORD",
                    "relationDocList": [
                        "72207745886821305421"
                    ],
                    "keyword": "甲方（盖章）",
                    "keywordType": "ALL",
                    "controlWidth": "120",
                    "controlHeight": "120",
                    "offsetX": "20",
                    "offsetY": "0"
                }
            ],
            "confirmType": [
                "CAPTCHA","PASSWORD"
            ],
            "bizId": "370000197401058277"
        }
        
    ],
    "controlChangeFlag": "NECESSARY_AND_ADD",
    "callbackPage": "http://dqffzqhfl.bt/ncgnfsxu",
    "contractCallbackUrl": "http://jpibwhkto.asia/vdkny"
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "code": 0,
    "message": "string",
    "result": {
        "contractNo": "string",
        "contractName": "string",
        "contractStatus": "string",
        "signOrderType": "string",
        "controlChangeFlag": "string",
        "expireDate": "string",
        "previewUrl": "string",
        "remark": "string",
        "signUserList": [
            {
                "account": "string",
                "signUrl": "string",
                "signerOrder": 0,
                "userType": 0,
                "name": "string",
                "companyName": "string",
                "sealNo": "string",
                "signType": 0,
                "signStatus": "string",
                "signatureType": "string",
                "confirmType": "string",
                "signFinishedTime": "string",
                "bizId": "string"
            }
        ]
    },
    "timestamp": 0
}

错误码说明#

请求参数

请求示例代码

返回响应

错误码说明