签署合同3206
开发中
测试环境
https://api-test.eycard.cn:9443
测试环境
https://api-test.eycard.cn:9443
POST
https://api-test.eycard.cn:9443
最后修改时间：2023-05-29 08:21:49
责任人：未设置
一、业务说明
签署合同时使用的接口
二.字段说明：
请求报文
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 | 项目编号 |
请求参数
Body 参数application/x-www-form-urlencoded
termId
string
必需
示例值:
TE101901
tradeTrace
string
必需
示例值:
z9KnSjwY9xyvVgoIRjK9
contractBody
string
请求的报文内容
示例值:
{"head":{"txTime":"20190102235959"},"note":{"checkCode":"123456","randomCode":"10"},"createContract": {"templateId":"1","isSign":0,"signInfos":[{"userId":"6327987D3B854A3A9F4A198426084F02","authorization Time":"20190214171200","location":"192.168.116.25","signLocation":"Signature1","projectCode":"002","i sProxySign":1}]," textValueInfo ":{"text19":"孙一 ","text18":"10000","text15":"30000","text3":"16","text14":"叁萬元整","text4":"孙一 ","text17":"10000","text1":"2019","text16":"10000","text2":"3","text7":"壹萬","text8":"壹萬元整 ","text5":"222321199112050001","text6":"成都","text9":"10000","text10":"壹萬元整 ","text11":"10000","text21":"001","text12":"壹萬元整","text13":"10000","text20":"成都支行"}}}
merId
string
必需
示例值:
MER021322101901
txCode
string
请求类型
示例值:
3206
version
string
必需
示例值:
1.0
channelId
string
必需
示例值:
616161622101901
sign
string
必需
示例值:
392DB56B7A9957964FBB5A731E512096