首页 > 开放平台 > 诺税通saas > 抬头查询
开放平台/抬头查询/诺税通saas关键字查询名称及开票代码接口

诺税通saas关键字查询名称及开票代码接口

2026-10-22 更新 阅读 版本 v1.0

接口说明

开发者使用该接口能够通过企业名称模糊查询到企业全称、六位开票代码,同时此接口可配合「开票代码查询名称及税号接口」一起调用,从而获取企业名称、税号、是否支持极速开票等信息。

API 方法名:nuonuo.speedBilling.prefixQuery 版本:V2.0

请求地址

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

公共请求参数(消息头)

参数名类型必填长度说明示例
Content-typeString是-MIME类型【消息头】-
X-Nuonuo-SignString是-签名(编码格式请使用UTF-8)【消息头】-
accessTokenString是-授权码【消息头】-
userTaxString否-授权商户的税号(自用型应用非必填,第三方应用必填)【消息头】-
methodString是-请求api对应的方法名称【消息头】nuonuo.speedBilling.prefixQuery

公共请求参数(消息体)

参数名类型必填长度说明示例
senidString是-唯一标识,由企业自己生成32位随机码【消息体】-
nonceString是-8位随机正整数【消息体】-
timestampString是-时间戳(当前时间的秒数)【消息体】-
appkeyString是-平台分配给应用的appKey【消息体】-

私有请求参数

参数名类型必填长度说明示例
qString是50企业名称(不少于3位)浙江诺诺

响应参数

参数名类型长度说明示例
codeString-6位开票代码NUONUO
nameString-企业全称浙江诺诺网络科技有限公司
name_lengthNumber-企业名称长度(搜索结果按照企业名称长度排序,相同长度随机排序)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未查询到数据检查输入的企业名称
标签:

申请试用

请留下您的联系方式,我们将在一个工作日内与您联系