接口说明
开发者使用该接口能够通过企业名称模糊查询到企业全称、六位开票代码,同时此接口可配合「开票代码查询名称及税号接口」一起调用,从而获取企业名称、税号、是否支持极速开票等信息。
API 方法名:nuonuo.speedBilling.prefixQuery 版本:V2.0
请求地址
| 环境 | 请求地址 |
|---|
| 正式环境 | https://sdk.nuonuo.com/open/v1/services |
| 沙箱环境 | https://sandbox.nuonuocs.cn/open/v1/services |
公共请求参数(消息头)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| Content-type | String | 是 | - | MIME类型【消息头】 | - |
| X-Nuonuo-Sign | String | 是 | - | 签名(编码格式请使用UTF-8)【消息头】 | - |
| accessToken | String | 是 | - | 授权码【消息头】 | - |
| userTax | String | 否 | - | 授权商户的税号(自用型应用非必填,第三方应用必填)【消息头】 | - |
| method | String | 是 | - | 请求api对应的方法名称【消息头】 | nuonuo.speedBilling.prefixQuery |
公共请求参数(消息体)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| senid | String | 是 | - | 唯一标识,由企业自己生成32位随机码【消息体】 | - |
| nonce | String | 是 | - | 8位随机正整数【消息体】 | - |
| timestamp | String | 是 | - | 时间戳(当前时间的秒数)【消息体】 | - |
| appkey | String | 是 | - | 平台分配给应用的appKey【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| q | String | 是 | 50 | 企业名称(不少于3位) | 浙江诺诺 |
响应参数
| 参数名 | 类型 | 长度 | 说明 | 示例 |
|---|
| code | String | - | 6位开票代码 | NUONUO |
| name | String | - | 企业全称 | 浙江诺诺网络科技有限公司 |
| name_length | Number | - | 企业名称长度(搜索结果按照企业名称长度排序,相同长度随机排序) | 12 |
请求示例
NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.speedBilling.prefixQuery"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
\"q\": \"浙江诺诺\"
}";
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": "S0000",
"describe": "请求成功",
"result": [{
"code": "NUONUO",
"name": "浙江诺诺网络科技有限公司",
"name_length": 12
}]
}
返回码说明
| 返回码 | 返回描述 | 解决方案 |
|---|
S0201 | 数据查询失败 | 检查后台服务是否正常 |
S0101 | 参数为空或不符合规范 | 检查请求参数是否填写完整或规范 |
S0107 | 未查询到数据 | 检查输入的企业名称 |