合同发起接口

2026-09-24 更新阅读版本 v1.0

接口说明

商家平台可以调用该接口发起电子合同，发起合同之前必须先在诺诺平台完成实名认证。（正式认证地址: hetong.nuonuo.com 沙箱认证地址: hetongtest2.nntest.cn)。调用合同接口次数大于5000次，价格面议，请联系商务400-700-8892。

API 方法名：nuonuo.electronicContract.contractInitiation　版本：V2.0

请求地址

环境	请求地址
正式环境	`https://sdk.nuonuo.com/open/v1/services`
沙箱环境	`https://sandbox.nuonuocs.cn/open/v1/services`

公共请求参数（消息头）

参数名	类型	必填	长度	说明	示例
Content-type	String	否	-	MIME类型【消息头】	-

公共请求参数（消息体）

参数名	类型	必填	长度	说明	示例
senid	String	否	-	唯一标识，由企业自己生成32位随机码【消息体】	-

私有请求参数

参数名	类型	必填	长度	说明	示例
contract	Object	否	-	合同基本信息	如下
└ contractName	String	否	80	合同名称	房屋租赁合同
└ contractFileName	String	否	200	合同文件名称，合同名称里格式要和文件base64里的格式保持一致	房屋租赁合同.pdf
└ contractFile	String	否	-	合同文件内容	合同文件Base64编码
└ notifyUrl	String	是	-	回调地址。当合同状态变化时，电子合同平台将会以post方式回调接口告知合同状态变化，通知格式为{"changeTime":"2019-12-18 20:39:02","contractNo":"123","status":1}，并将json字符串放在请求体中。接入用户收到回调结果后需返回200的code码确认收到消息（格式为{“code”:200}），回调失败后，在合同状态没有再次变化的前提下，每间隔5分钟重新回调一次，最多回调5次。	http://www.baidu.com
└ orderNo	String	是	36	合同自定义编号，不传时默认与合同系统编号相同	a1234
└ signatoryEndTime	String	是	-	签章截止时间,不传或者大于2099-12-31 23:59:59视为永久	2019/7/1 12:00
originator	Object	否	-	发起方信息	如下
└ originatorPhone	String	否	11	发起方手机号	17000000000
└ signFlag	Number	否	-	是否签署：0-不签署 1-签署	1
└ autoSignFlag	Number	是	-	签章类型，0：手动签章，1：自动签章。不传默认为0手动签章。当signFlag为1，即签章的时候，该字段才生效。	1
└ signatoryPage	Number	是	-	自动签章方，签章页数（自动签署必传）	1
└ signatoryCoordinateX	String	是	-	自动签章方签章的X坐标，为印章左下角距离盖章页左边界的像素值，不能小于0（自动签署必传，定位到要求的位置请反复测试校准）	100
└ signatoryCoordinateY	String	是	-	自动签章方签章的Y坐标，为印章左下角距离盖章页下边界的像素值，不能小于0（自动签署必传，定位到要求的位置请反复测试校准）	200
└ signatoryList	Array	是	-	自动签章方多页自动签章；填写了多页盖章，则忽略单页盖章（signatoryPage、signatoryCoordinateX、signatoryCoordinateY）	如下
└ charterId	String	是	-	自动盖章，印章ID；选择自动盖章印章ID没有传值时，加盖默认印章	-
└ signatoryCoordinateX	String	是	-	自动签章方签章的X坐标，为印章左下角距离盖章页左边界的像素值，不能小于0，签章类型选0时生效（自动签署必传，定位到要求的位置请反复测试校准）	100
└ signatoryCoordinateY	String	是	-	自动签章方签章的Y坐标，为印章左下角距离盖章页左边界的像素值，不能小于0（自动签署必传，定位到要求的位置请反复测试校准）	200
└ signatoryPageList	Array	是	-	签署的页数，签章类型选0时生效	[1,2]
└ stampType	Number	是	-	盖章类型：0：单页章，1：骑缝章，默认0单页章	0
receivers	Array	是	10	签署方信息，发起方不签署时必传	如下
└ signType	Number	否	-	签署类型，0：个人签署 1：企业签署	1
└ receiverName	String	否	50	签署方名字（企业：2-50字符，个人：2-19字符）	杭州爱信诺航天信息公司
└ receiverNumber	String	是	20	签署方企业税号，signType=1时必传（长度：10、15-20字符）	3301111112
└ receiverPhone	String	否	11	签署方手机号	17000000000
└ signPositionList	Array	是	-	指定签署位置	如下
└ signatoryCoordinateX	String	是	-	签章的X坐标	100
└ signatoryCoordinateY	String	是	-	签章的Y坐标	100
└ signatoryPageList	Array	是	-	签署的页数	[1]
contractCarbonCopies	Array	是	10	抄送人信息	如下
└ ccType	Number	是	-	抄送人类型 0：个人 1：企业，默认为1	1
└ ccUserName	String	否	19	抄送人名字（长度2-19字符）	zs
└ ccUserPhone	String	否	11	抄送人手机号	17000000000
└ ccUserEnterpriseName	String	是	50	抄送人所在企业名称（长度2-50字符）	浙江诺诺网络科技有限公司
└ ccUserEnterpriseNum	String	是	20	抄送人所在企业税号，ccType=1时必传（长度：10、15-20字符）	330111111222812003
certifyViewType	Number	是	-	抄送方是否需要认证才能查看：0认证查看，1无需认证查看，默认0	0

响应参数

参数名	类型	必填	长度	说明	示例
contractNo	String	否	-	合同编号	2019070920522599812927980
contractFileId	String	否	-	合同文件id	2887648642-774327cb23344e8dbe0a846675c61002
createTime	String	否	-	创建时间	2021-09-27 15:04:48

请求报文示例

NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.electronicContract.contractInitiation"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
  \"receivers\": [
    {
      \"receiverNumber\": \"3301111112\",
      \"receiverPhone\": \"17000000000\",
      \"receiverName\": \"杭州爱信诺航天信息公司\",
      \"signType\": 1,
      \"signPositionList\": [
        {
          \"signatoryPageList\": [
            \"[1]\"
          ],
          \"signatoryCoordinateY\": \"100\",
          \"signatoryCoordinateX\": \"100\"
        }
      ]
    }
  ],
  \"contract\": {
    \"orderNo\": \"a1234\",
    \"signatoryEndTime\": \"2019/7/1 12:00\",
    \"notifyUrl\": \"http://www.baidu.com\",
    \"contractName\": \"房屋租赁合同\",
    \"contractFileName\": \"房屋租赁合同.pdf\",
    \"contractFile\": \"合同文件Base64编码\"
  },
  \"certifyViewType\": 0,
  \"originator\": {
    \"signFlag\": 1,
    \"autoSignFlag\": 1,
    \"originatorPhone\": \"17000000000\",
    \"signatoryCoordinateY\": \"200\",
    \"signatoryCoordinateX\": \"100\",
    \"signatoryPage\": 1,
    \"signatoryList\": [
      {
        \"signatoryPageList\": [
          \"[1\",
          \"2]\"
        ],
        \"signatoryCoordinateY\": \"200\",
        \"signatoryCoordinateX\": \"100\",
        \"stampType\": 0,
        \"charterId\": \"\"
      }
    ]
  },
  \"contractCarbonCopies\": [
    {
      \"ccType\": 1,
      \"ccUserName\": \"zs\",
      \"ccUserEnterpriseName\": \"浙江诺诺网络科技有限公司\",
      \"ccUserPhone\": \"17000000000\",
      \"ccUserEnterpriseNum\": \"330111111222812003\"
    }
  ]
}";
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": "2019072216530830410741171"
	}
}

返回码说明

返回码	说明	处理建议
`H10106`	系统出错	查看原因解决或联系系统管理员
`H10107`	参数有误说明	请检查接口入参

标签：电子合同

已经是第一篇

下一篇：使用模板发起合同