一、业务说明

用户在客户平台上查看合同基础信息，客户平台向电子协议系统发出对指定电子合同进行查询的命令。

二.字段说明：

请求报文

1.contractBody字段：

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

请求 contract节点字段

参数	约束	最大长度	说明	备注
contractNo	NOT NULL	30	合同编号

返回报文

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

返回 contract节点字段

参数	约束	最大长度	说明	备注
contractNo	NOT NULL	30	合同编号
contractTypeCode	NOT NULL	10	合同类型	详见电子协议-附录-码(2.合同类型
contractName	NOT NULL	100	合同名称
contractState	NOT NULL	1	合同状态	详见电子协议-附录-码(4.合同状态
createTime	NOT NULL	14	创建合同时间	格式：yyyyMMddHHmmss
expiredDate	NOT NULL	8	合同签署截止时间	针对不代签而用户自行去电子协议系统签署的用户。系统默认为 30 天。格式：yyyyMMdd
signatories			签署信息	JSON 详细见子节点

返回 signatories节点字段

参数	约束	最大长度	说明	备注
userName	NOT NULL	150	签署人名称
identTypeCode	NOT NULL	1	签署人证件类型编码
identNo	NOT NULL	80	签署人证件号码
signmentState	NOT NULL	1	签署状态	详见电子协议-附录-码(3.签署状态
signTime	NOT NULL	14	签署时间	用户在合同上数字签名的时间
refuseReason		150	拒绝原因	只有当用户自己到电子协议系统上签署时可以对合同进行拒绝

请求参数

Body 参数application/x-www-form-urlencoded

termId

string

必需

电子协议系统分配的终端号

示例值:

TE101901

tradeTrace

string

必需

请求流水，唯一，不包括特殊字符

示例值:

z9KnSjwY9xyvVgoIRjK9

contractBody

string

请求的报文内容

必需

示例值:

{"head":{"txTime":"20211221093154"},"contract":{"contractNo":"QT20230427000007029"},"notSendPwd":"1"}

merId

string

必需

电子协议系统分配的商户号

示例值:

MER021322101901

txCode

string

请求类型

必需

示例值:

3210

version

string

必需

版本默认 “1.0”

示例值:

1.0

channelId

string

必需

电子协议系统分配的机构号

示例值:

616161622101901

sign

string

必需

请求的签名，是对 POST 请求参数的签名

示例值:

392DB56B7A9957964FBB5A731E512096

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

resultCode

enum<string>

应答码

必需

应答码

<= 2 字符

枚举值:

00010306253031429698A094

resultMsg

string

应答描述

可选

应答描述

contractBody

string

应答的报文

可选

应答的报文

sign

string

请求的签名，是对 POST 应答参数的签名

可选

请求的签名，是对 POST 应答参数的签名

示例

{
    "contractBody": "{\"head\":{\"txTime\":\"20211221093154\",\"retCode\":\"60000000\",\"retMessage\":\"OK\"},\"contract\":{\"contractNo\":\"QT20230427000007029\",\"contractTypeCode\":\"QT\",\"contractName\":\"特约商户（两方）受理支付业务协议\",\"contractState\":1,\"createTime\":\"20230427153548\",\"expiredDate\":\"20230527\",\"fileId\":\"cee48595-a401-49d3-981a-4f4f22858849\",\"signatories\":[{\"userId\":\"8D4CFF34AB1D289EE05311016B0A9A8A\",\"userName\":\"某公司\",\"identTypeCode\":\"8\",\"identNo\":\"110101111111117\",\"signmentState\":1,\"signTimes\":2,\"signTime\":20230427155050}]}}",
    "resultCode": "00",
    "sign": "4BC58E298D973B045A58BB17A2782DBF"
}

合同查询3210

一、业务说明

二.字段说明：

请求报文

1.contractBody字段：

返回报文

请求参数

示例代码

返回响应