首页 > 开放平台 > 诺税通saas > 发票管理
开放平台/发票管理/诺税通saas发票列表查询接口

诺税通saas发票列表查询接口

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

接口说明

通过时间段筛选企业发票列表

API 方法名:nuonuo.OpeMplatform.queryInvoiceList 版本:V2.0

请求地址

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

公共请求参数(消息头)

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

公共请求参数(消息体)

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

私有请求参数

参数名类型必填长度说明示例
taxnumString否35企业税号339901999999212
requestTypeString否2请求类型,默认是0;0为按照发票添加时间查询,1为按照开票时间查询,2为按照发票状态更新时间查询1
startTimeString否20时间起始值。格式:yyyy-MM-dd HH:mm:ss2019-03-04 00:00:00
endTimeString否20时间结束值。起始时间和结束时间间隔不能大于10天,格式:yyyy-MM-dd HH:mm:ss 时间区间前闭后开2019-03-09 00:00:00
pageNoString否10当前页2
pageSizeString否10每页条数20

响应参数

参数名类型必填长度说明示例
codeString否-符合条件的数据数量E0000
describeString否-调用成功
resultObject否--
   └ totalCountNumber否-发票数2
   └ invoicesArray否--
      └ serialNoString否-发票请求流水号19030412532501000030
      └ sellerTaxNoString否-企业税号339901999999142
      └ orderNoString否-订单编号20190304125304253604
      └ statusString否-发票状态: 2 :开票完成( 最终状 态),其他状态分别为: 20:开票中; 21:开票成功签章中;22:开票失败;24: 开票成功签章失败;3:发票已作废 31: 发票作废中 备注:22、24状态时,无需再查询,请确认开票失败原因以及签章失败原因;3、31只针对纸票 注:请以该状态码区分发票状态21
      └ invoiceCodeString否-发票代码131880930142
      └ invoiceNoString否-发票号码18783058
      └ exTaxAmountNumber否-不含税金额1.00
      └ taxAmountNumber否-合计税额0.02
      └ payerNameString否-购方名称浙江诺诺网络科技有限公司
      └ buyerTaxNoString否-购方税号-
      └ invoiceKindString否-发票种类,包含:增值税电子普通发票、增值税普通发票、专用发票(电子)、增值税专用发票、收购发票(电子)、收购发票(纸质)、增值税普通发票(卷式)、机动车销售统一发票、二手车销售统一发票、电子发票(增值税专用发票)、电子发票(普通发票)、全电纸质发票(增值税专用发票)、全电纸质发票(普通发票); 备注:电子发票(增值税专用发票)即 数电专票(电子),电子发票(普通发票)即 数电普票(电子)增值税电子普通发票
      └ addTimeString否-创建时间2019-03-04 00:00:00
      └ invoiceTimeString否-开票时间2019-03-04 00:00:00
      └ checkCodeString否-校验码76476333544219129887

请求报文示例

NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.OpeMplatform.queryInvoiceList"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
  \"requestType\": \"1\",
  \"pageNo\": \"2\",
  \"pageSize\": \"20\",
  \"taxnum\": \"339901999999212\",
  \"startTime\": \"2019-03-04 00:00:00\",
  \"endTime\": \"2019-03-09 00:00:00\"
}";
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);

返回码说明

返回码说明处理建议
0000查询成功
1001税号不能为空
1002时间不能为空且格式只能是 yyyy-MM-dd HH:mm:ss
1003起始时间不能为空
1004终止时间不能为空
1005起始时间不能大于终止时间且时间间隔不能超过 10 天
1006查询类型只能为 0 和 1
1007符合条件数据量太大(最大支持 1000 条),请缩小时间范围
1009系统繁忙,请稍后再试
标签: 诺税通saas

申请试用

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