接口说明
商家平台可以调用该接口根据模版发起电子合同,发起合同之前请先在诺诺平台完成合同模版制作--》导出模版字段信息。(正式地址: hetong.nuonuo.com 沙箱地址: hetongtest2.nntest.cn)。 调用合同接口次数大于5000次,价格面议,请联系商务400-700-8892。
API 方法名:nuonuo.eleConShortcutSign.createContract 版本:V2.0
请求地址
| 环境 | 请求地址 |
|---|
| 正式环境 | https://sdk.nuonuo.com/open/v1/services |
| 沙箱环境 | https://sandbox.nuonuocs.cn/open/v1/services |
公共请求参数(消息头)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| Content-type | String | 否 | - | MIME类型【消息头】 | - |
公共请求参数(消息体)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| senid | String | 否 | - | 唯一标识,由企业自己生成32位随机码【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| application | String | 否 | - | 应用名称 | applicaiton001 |
| originatorType | Number | 否 | - | 用户类型。 0:个人 1:企业 | 1 |
| originatorAccountId | String | 否 | - | 发起人账户id | 860af3b991ec4d629f30188f85c939f2 |
| originatorPartId | String | 否 | - | 发起人主体id | 123af3b991ec4d629f30188f85c9332 |
| fileName | String | 是 | - | 文件名称 | 文件名称 |
| templateId | Number | 否 | - | 合同模板id | 1 |
| templateOriginType | Number | 是 | - | 合同模板来源。 0:saas模版 1:快捷签模版,不填默认saas模版 | 1 |
| version | Number | 否 | - | 合同模板版本号 | 1 |
| fieldList | Array | 是 | - | 模版字段数组。如果模板中设置了文本框/日期框/单选框/复选框字段,并且设置了必须输入,那么该字段不能为空。 | - |
| └ fieldId | Number | 否 | - | 字段id | 10158 |
| └ content | String | 是 | - | 文本框或日期框填写的内容,若为日期框,则日期格式为yyyy-MM-dd | 模版内容 |
| └ options | Array | 是 | - | 单、复选框选项选中的内容,字符串组成的数组 | ["杭州","宁波"] |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| code | String | 否 | - | | H200 |
| describe | String | 否 | - | | 成功 |
| result | String | 否 | - | 合同文件id | 3232288381-3a4532e492a54a7cadd1282939267216 |
请求报文示例
NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.eleConShortcutSign.createContract"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
\"originatorAccountId\": \"860af3b991ec4d629f30188f85c939f2\",
\"fileName\": \"文件名称\",
\"application\": \"applicaiton001\",
\"templateOriginType\": 1,
\"templateId\": 1,
\"version\": 1,
\"fieldList\": [
{
\"options\": [
\"[\\"杭州\\"\",
\"\\"宁波\\"]\"
],
\"content\": \"模版内容\",
\"fieldId\": 10158
}
],
\"originatorType\": 1,
\"originatorPartId\": \"123af3b991ec4d629f30188f85c9332\"
}";
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":"3232288381-3a4532e492a54a7cadd1282939267216"
}
返回码说明
| 返回码 | 说明 | 处理建议 |
|---|
H200 | 成功 | |
H99999 | 请求异常或服务器异常 | |
H88888 | 参数异常 | |