签署个人签名

POST

/resrun-paas/kaifangqian/openAPI/V2/contract/sign/personal/proxy

签署人已经将个人签名授权给了对接方企业以及对应业务线，且授权有效时，可调用此接口完成个人签名的自动签署。

登录开放签系统，进入到个人身份下，在用户中心中进行签名授权配置，如下：

请求参数

Header 参数

sign

string

签名值，不校验

必需

默认值:

123456

Body 参数application/json

appAuthToken

string

应用授权凭证

必需

应用授权凭证

uniqueCode

string

流水号

必需

不重复的流水号，随机生成即可，无状态，仅为了标识某笔请求，方便排查问题

contractId

string

合同id

必需

合同id，发起签署接口返回

signatureSubjectType

string

个人签名主体类型

必需

两种类型：
（1）个人用户签署方，即个人接收方；
（2）企业签署方下的个人签字节点，企业签署方是指发起方企业，不包含接收方企业，个人签名节点是指企业内部除“企业签章”之外的所有的其他签署节点类型，包括经办人签字、法人签字、个人签字；

PERSON-个人用户签署方；

EMPLOYEE-企业签署方下的个人签字节点

signer

object

签署人

必需

签署人

name

string

姓名

可选

姓名

contactType

string

联系类型

必需

联系类型：MOBILE（手机号），EMAIL（邮箱）暂时仅支持MOBILE

contact

string

联系方式

必需

联系方式：手机号、邮箱，暂时仅支持手机号

positionParamList

array [object {11}]

签署位置

必需

指定签署位置
若传值，则在合同发起时指定的签署位置的基础上进行追加；
若不传值，则以合同发起时指定的签署位置进行签署。

controlType

string

签署控件类型

必需

签署控件类型：

个人签章-SIGNATURE；

签署日期-SIGN_DATE；

signDateFormat

string

签署时间格式

可选

当签署控件类型为“签署日期”时生效。
签署时间格式：

YEAR_MONTH_DAY格式为yyyy年MM月dd日；

LINE格式为yyyy-MM-dd；

BACK_SLASH格式为yyyy/MM/dd；
默认值：YEAR_MONTH_DAY

signPositionType

string

签署位置设置方式

必需

签署位置设置方式：
坐标-POSITION；
关键字-KEYWORD；

relationDocList

array [object {2}]

关联文档列表

可选

pageConfig

string

页码

可选

当签署位置设置方式为“POSITION”时生效。
签署控件坐标所属页码，规则如下：
全部页：ALL；
偶数页：EVEN_NUMBER；
奇数页：ODD_NUMBER；
指定页码：1,2,7-10

keyword

string

关键字

可选

当签署位置设置方式为“KEYWORD”时生效。
如“甲方盖章处”

keywordType

string

关键字索引

可选

当签署位置设置方式为“KEYWORD”时生效。
1代表第1个关键字，
0代表所有关键字，
-1代表倒数第1个关键字；
默认为1

controlWidth

string

签章位置宽度

可选

设置签署位置的宽度，防止用户在文件添加的签章过大或过小；
在72dpi的分辨率下，A4竖版文件的宽高为595（像素），842（像素）；
取值范围10-120
企业签章、骑缝章宽度默认值为120；
个人签名宽度默认值为112；
签署日期宽度默认值为120；

controlHeight

string

签章位置高度

可选

设置签署位置的高度，防止用户在文件添加的签章过大或过小；
在72dpi的分辨率下，A4竖版文件的宽高为595（像素），842（像素）；
取值范围10-120
企业签章、骑缝章高度默认值为120；
个人签名高度默认值为52；
签署日期高度默认值为30；

offsetX

string

横坐标-偏移量占比/关键字-偏移量

可选

（1）当签署位置设置方式为“POSITION”时，该值为横坐标-偏移量占比。
规则：以文件当前页左上角为基准，当前签署位置横坐标占当前文件页面宽度的比例，范围为【0～1】，当超出页面宽度时，默认签署到页面最右侧；
（2）当签署位置设置方式为“KEYWORD”时，该值为关键字-偏移量。
规则：在关键字位置上的水平方向偏移量，其中正数表示往右偏移；
（3）默认值为0

offsetY

string

纵坐标-偏移量占比/关键字-偏移量

可选

（1）当签署位置设置方式为“POSITION”时，该值为纵坐标-偏移量占比。
规则：以文件当前页左上角为基准，当前签署位置纵坐标占当前文件页面高度的比例，范围为【0～1】，当超出页面高度时，默认签署到页面最下方；
（2）当签署位置设置方式为“KEYWORD”时，该值为关键字-偏移量。
规则：在关键字位置上的垂直方向偏移量，其中正数表示往下偏移；
（3）默认值为0

示例

{
    "appAuthToken": "string",
    "uniqueCode": "string",
    "contractId": "string",
    "signatureSubjectType": "string",
    "signer": {
        "name": "string",
        "contactType": "string",
        "contact": "string"
    },
    "positionParamList": [
        {
            "controlType": "string",
            "signDateFormat": "string",
            "signPositionType": "string",
            "relationDocList": [
                {
                    "docType": "string",
                    "docId": "string"
                }
            ],
            "pageConfig": "string",
            "keyword": "string",
            "keywordType": "string",
            "controlWidth": "string",
            "controlHeight": "string",
            "offsetX": "string",
            "offsetY": "string"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://home.kaifangqian.com/resrun-paas/kaifangqian/openAPI/V2/contract/sign/personal/proxy' \
--header 'sign;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appAuthToken": "string",
    "uniqueCode": "string",
    "contractId": "string",
    "signatureSubjectType": "string",
    "signer": {
        "name": "string",
        "contactType": "string",
        "contact": "string"
    },
    "positionParamList": [
        {
            "controlType": "string",
            "signDateFormat": "string",
            "signPositionType": "string",
            "relationDocList": [
                {
                    "docType": "string",
                    "docId": "string"
                }
            ],
            "pageConfig": "string",
            "keyword": "string",
            "keywordType": "string",
            "controlWidth": "string",
            "controlHeight": "string",
            "offsetX": "string",
            "offsetY": "string"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

code

integer

返回码

必需

10000成功，其他参见附录

message

string

返回描述

必需

返回描述，不可用于流程控制

result

object

返回的结果数据

可选

timestamp

integer

时间戳

可选

时间戳

示例

{
    "code": 0,
    "message": "string",
    "result": {},
    "timestamp": 0
}

下载签约文件

获取业务线列表