一、业务说明

签署合同时使用的接口

二.字段说明：

请求报文

1.contractBody字段：

包括head和业务数据节点 signContract
a.head节点见电子协议联调说明(二、接口约定中-5. 报文参数-请求参数-head(头信息)详细)
b.业务数据节点 signContract：

请求 signContract节点字段

参数	约束	最大长度	说明	备注
contractNo	NOT NULL	30	合同编号	创建合同返回的合同编号
signInfo			签署合同信息	JSON 详细见子节点

请求 signInfo节点字段

参数	约束	最大长度	说明	备注
userId	NOT NULL	32	用户 ID	开户时返回的用户 ID，如果用户 ID 为平台的 ID，那么后面 4项不会用到
authorizationTime	当 userId为平台 ID时，此三项不校验，其余情况都校验	14	授权时间	客户平台将采集到的用户输入验证码的时间发送给电子协议系统，格式：yyyyMMddHHmmss
location	当 userId为平台 ID时，此三项不校验，其余情况都校验	100	授权地点	客户平台将采集到的用户 IP 或所在地发送给电子协议系统
projectCode	当 userId为平台 ID时，此三项不校验，其余情况都校验	32	项目编号	如果确定代签，必须保证代签的用户已经对该项目进行了授权
isCheckProjectCode		1	是否检查项目编号	0：不检查；1：检查；默认为0，需要校验项目编号的时候传送
signLocation	NOT NULL	200	签名域的标	签值客户平台签署域为：Signature_plat；签署人可以签多个，以“;”分割
imageData			签名图片	自定义签名图片，优先级高
sealId		32	印章 ID	添加印章返回的印章 ID，不传时为默认印章
sealColor		1	签章颜色	1：红色；2：蓝色；3：黑色；默认为 1

返回报文

1.contractBody字段：包括head和业务数据节点signContract
a.head节点见电子协议联调说明(二、接口约定中-5. 报文参数-请求参数-head(头信息)详细)
b.业务数据节点 signContract：

返回 signContract 节点字段

参数	约束	最大长度	说明	备注
contractNo	NOT NULL	30	合同编号
signInfo			签署信息	JSON 格式，详细见子节点

返回 signInfo 节点字段

参数	约束	最大长度	说明	备注
userId	NOT NULL	32	用户	ID
authorizationTime	NOT NULL	14	授权时间
location	NOT NULL	100	授权地点
signLocation	NOT NULL	200	签名域的标签值
projectCode	NOT NULL	32	项目编号

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

示例

{
    "contractBody": "{\"head\":{\"txTime\":\"20221027154025\",\"retCode\":\"60000000\",\"retMessage\":\"OK\"},\"signContract\":{\"contractNo\":\"QT20230427000007029\",\"signInfo\":{\"userId\":\"8D4CFF34AB1D289EE05311016B0A9A8A\",\"authorizationTime\":\"20221027154025\",\"location\":\"154.8.143.104\",\"signLocation\":\"s1;s2\",\"isCheckProjectCode\":0,\"certType\":1,\"isAddSignTime\":0,\"signTimes\":2},\"isSendNotice\":1}}",
    "resultCode": "00",
    "sign": "427ACB01D3640CEEFD8CA7845059581C"
}

签署合同3206