接口说明
第三方可通过该接口申请入驻诺诺发票以及创建工单
API 方法名:nuonuo.OpeMplatform.createNewWorkOrder 版本:V2.0
请求地址
| 环境 | 请求地址 |
|---|
| 正式环境 | https://sdk.nuonuo.com/open/v1/services |
| 沙箱环境 | https://sandbox.nuonuocs.cn/open/v1/services |
公共请求参数(消息头)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| Content-type | String | 否 | - | MIME类型【消息头】 | - |
公共请求参数(消息体)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| senid | String | 否 | - | 唯一标识,由企业自己生成32位随机码【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| version | String | 否 | - | 版本号,当前固定为:1.0 | 1.0 |
| appId | String | 否 | - | 授权来源身份id,由诺诺工单提供 | NN_MEITUAN |
| requestTime | String | 否 | - | 当前请求时间,格式为yyyyMMddHHmmss,时区UTC+8,只接收请求时间为服务端服务器时间前后30分钟内的报文 | 20200716135627 |
| requestId | String | 否 | - | 请求编码,UUID,要求24小时内唯一,重复则认为是相同的请求,不再重复处理 | 12f0d1c856f64b57a31fcfe5b8acae31 |
| data | Object | 否 | - | 工单数据 | - |
| └ templateNo | String | 否 | - | 工单模板编号,诺诺发票固定传值:81f25c1ee9474a9eb8c81897a9b1669e | 81f25c1ee9474a9eb8c81897a9b1669e |
| └ companyTaxNum | String | 否 | - | 商户企业税号 | 91330106MA2AYNWD8M |
| └ companyName | String | 否 | - | 商户企业名称 | 浙江诺诺网络科技有限公司 |
| └ businessCode | String | 否 | - | 业务线编号,诺诺发票固定传值:dzfp | dzfp |
| └ priorityLevel | String | 否 | - | 优先级(1:普通 2:紧急 0:低 3:非常紧急.) 固定传值:1 | 3 |
| └ source | String | 否 | - | 固定值为3 | 3 |
| └ customerWorkNo | String | 是 | - | 服务商业务工单编号 | mt00003 |
| └ stateNotifyUrl | String | 是 | - | 状态变更或者信息回调地址 | - |
| └ detailList | Array | 否 | - | 工单表单数据数组(不同的模板内容不一样,请参考对接时的模板内容调整) | - |
| └ attribute | String | 否 | - | 工单表单数据字段标识 | customerID |
| └ fieldValue | String | 否 | - | 工单表单数据字段值 | 美团 |
| └ customerName | String | 是 | - | 服务商名称 | - |
| └ customerTax | String | 是 | - | 服务商税号 | - |
| └ appkey | String | 是 | - | appkey | - |
| └ AutomaticAuthorization | String | 是 | - | 是否自动授权 | - |
| └ OrderNumber | String | 是 | - | 订单编号 | - |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| code | Number | 否 | - | 响应编码,等于200成功 | 200 |
| message | String | 否 | - | 响应描述 | 工单创建成功 |
| data | Object | 否 | - | 数据体 | - |
| └ workNo | String | 否 | - | 诺诺网工单编号 | WO_20200628135053977196753 |
| └ customerWorkNo | String | 否 | - | 第三方业务工单编号 | mt00003 |
| └ status | String | 否 | - | 工单状态(1:待处理 2:处理中 3:已完结 4:已撤销 5:已关闭 | 1 |
请求报文示例
NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.OpeMplatform.createNewWorkOrder"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
\"requestTime\": \"20200716135627\",
\"data\": {
\"templateNo\": \"81f25c1ee9474a9eb8c81897a9b1669e\",
\"companyTaxNum\": \"91330106MA2AYNWD8M\",
\"businessCode\": \"dzfp\",
\"priorityLevel\": \"3\",
\"customerWorkNo\": \"mt00003\",
\"companyName\": \"浙江诺诺网络科技有限公司\",
\"detailList\": [
{
\"appkey\": \"\",
\"OrderNumber\": \"\",
\"attribute\": \"customerID\",
\"fieldValue\": \"美团\",
\"customerTax\": \"\",
\"customerName\": \"\",
\"AutomaticAuthorization\": \"\"
}
],
\"stateNotifyUrl\": \"\",
\"source\": \"3\"
},
\"requestId\": \"12f0d1c856f64b57a31fcfe5b8acae31\",
\"appId\": \"NN_MEITUAN\",
\"version\": \"1.0\"
}";
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 | code 等于200为成功 | |