接口说明
商家平台可以调用该接口动态获取在电子合同平台生成的合同的详细信息。
API 方法名:nuonuo.electronicContract.contractQuery 版本:V2.0
请求地址
| 环境 | 请求地址 |
|---|
| 正式环境 | https://sdk.nuonuo.com/open/v1/services |
| 沙箱环境 | https://sandbox.nuonuocs.cn/open/v1/services |
公共请求参数(消息头)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| Content-type | String | 否 | - | MIME类型【消息头】 | - |
公共请求参数(消息体)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| senid | String | 否 | - | 唯一标识,由企业自己生成32位随机码【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| contractNo | String | 否 | 35 | 合同编号 | 2019071516290406658031914 |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| contractNo | String | 否 | - | 合同编号 | 2019071516290406658031914 |
| contractName | String | 否 | - | 合同名称 | 电子合同接口测试新 |
| contractFileName | String | 否 | - | 合同文件名称 | 电子合同接口测试新.pdf |
| status | Number | 否 | - | 合同状态:1签署中,2已完成,3已过期,4已作废5作废中 | 2 |
| createTime | String | 否 | - | 合同创建时间 | 2019-07-15 16:29:04 |
| signatoryEndTime | String | 否 | - | 合同签署截止时间 | 2099-12-31 23:59:59 (包含2099-12-31) |
| expiryDate | String | 否 | - | 到期日期 | 2020-02-02 00:00:00 |
| contractSignType | Number | 否 | - | 签订方式 0:电子合同 1:纸质归档 | 0 |
| signatoryCompleteTime | String | 否 | - | 签署完成时间 | 2019-07-15 16:32:23 |
| originatorId | String | 否 | - | 合同发起方Id | 3e63b8e839d548a39f2ef637e6656572 |
| originatorEnterpriseName | String | 否 | - | 合同发起企业名称 | 深圳市大疆创新科技有限公司A |
| originatorEnterpriseNum | String | 否 | - | 合同发起企业税号 | 914403007954257496 |
| originatorPhone | String | 否 | - | 合同发起方手机号 | 13575757111 |
| contractSignAOs | Array | 否 | - | 参与方信息 | 如下 |
| └ signatoryEnterpriseName | String | 否 | - | 签署企业名称 | 电子合同测试企业账号1 |
| └ signatoryEnterpriseNum | String | 否 | - | 签署企业税号 | 67864352090000090670 |
| └ signatoryPhone | String | 否 | - | 签署人手机号(若不签署则为空) | 17033340702 |
| └ signatoryStatus | Number | 否 | - | 签署状态:1签署中,2已完成 | 2 |
| └ signatoryTime | String | 否 | - | 合同签署时间 | 2019-07-05 17:14:36 |
| └ receiverPhone | String | 否 | - | 接收方手机号 | 17034567457 |
| carbonCopyAOs | Array | 否 | - | 抄送人信息 | 如下 |
| └ ccUserName | String | 否 | - | 抄送人姓名 | 张三 |
| └ ccUserPhone | String | 否 | - | 抄送人手机号 | 17033347999 |
| └ ccUserEnterpriseNum | String | 否 | - | 指定抄送人所在的企业 | 67864352090000090670 |
请求报文示例
NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.electronicContract.contractQuery"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
\"contractNo\": \"2019071516290406658031914\"
}";
String url = "https://sdk.nuonuo.com/open/v1/services"; // SDK请求地址
String senid = UUID.randomUUID().toString().replace("-", ""); // 唯一标识,32位随机码,无需修改,保持默认即可
String result = sdk.sendPostSyncRequest(url, senid, appKey, appSecret, token, taxnum, method, content);
System.out.println(result);
响应报文示例
{
"code": "H200",
"describe": "成功",
"result": {
"contractNo": "2019071516290406658031914",
"contractName": "电子合同接口测试新",
"contractFileName": "电子合同接口测试新.pdf",
"status": 2,
"createTime": "2019-07-15 16:29:04",
"signatoryEndTime": "2099-12-31 23:59:59",
"signatoryCompleteTime": "2019-07-15 16:32:23",
"originatorId": "3e63b8e839d548a39f2ef637e6656572",
"originatorEnterpriseNum": "914403007954257496",
"originatorEnterpriseName": "深圳市大疆创新科技有限公司A",
"originatorPhone": "13575757111",
"carbonCopyAOs": [{
"ccUserName": "张三",
"ccUserPhone": "17033347999",
"ccUserEnterpriseNum": "67864352090000090670"
}],
"contractSignAOs": [{
"signatoryEnterpriseName": "电子合同测试企业账号1",
"signatoryEnterpriseNum": "67864352090000090670",
"signatoryPhone": "17033340702",
"signatoryStatus": 2,
"signatoryTime": "2019-07-15 16:32:23",
"receiverPhone": "17034567457"
},
{
"signatoryEnterpriseName": "深圳市大疆创新科技有限公司A",
"signatoryEnterpriseNum": "914403007954257496",
"signatoryPhone": null,
"signatoryStatus": 2,
"signatoryTime": "2019-07-15 16:29:04",
"receiverPhone": "17034567480"
}
]
}
}
返回码说明
| 返回码 | 说明 | 处理建议 |
|---|
H10101 | 参数缺失 | 请检查接口入参 |
H10104 | 找不到相应的合同 | 请检查合同编号 |
H10105 | 所属企业不在合同的签署方中,没有权限获取该合同的相关信息 | 请联系诺诺网运营 |
H10106 | 系统出错 | 请稍后重试 |
H10107 | 合同编号最长不能超过35位 | 请检查合同编号 |
H10112 | 合同编号缺失 | 请检查接口入参 |