首页 > 开放平台 > 诺税通saas > 发票库存
开放平台/发票库存/诺税通saas企业发票余量查询接口

诺税通saas企业发票余量查询接口

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

接口说明

企业发票库存查询接口: 都传入的时候,各参数优先级:分机号>机器编号>分机号+机器编号的联合查询>部门ID

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

请求地址

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

公共请求参数(消息头)

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

公共请求参数(消息体)

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

私有请求参数

参数名类型必填长度说明示例
departmentIdString是-部门id(不传分机号、机器编号时使用);部门和分机、机器编号等都不传时,返回税号下全部报税信息-
extensionNumsArray是100分机号列表(只传分机号时使用)1
machineCodeString是12机器编号单个查询(只传机器编号时使用)123456789012
extMachineCodePairsArray是1分机号+机器编号联合查询(只能传入一对分机号和机器编号),精确查询某设备时建议使用此种方式-
   └ extensionNumString是5分机号1
   └ machineCodeString是12机器编号123456789012

响应参数

参数名类型必填长度说明示例
codeString否-状态码E0000
describeString否-返回信息调用成功
resultArray否-具体库存信息-
   └ extensionNumberNumber否-分机号1
   └ machineCodeString否-机器编号-
   └ terminalNumberString否-终端号-
   └ invoiceLineString否-发票种类:p:电子增值税普通发票;c:增值税普通发票(纸票);s:增值税专用发票;e:收购发票(电子);f:收购发票(纸质);r:增值税普通发票(卷式);b:增值税电子专用发票;j:机动车销售统一发票;u:二手车销售统一发票p
   └ remainNumNumber否-200200
   └ typeCodeString否-发票代码-
   └ invoiceNumStartString否-起始发票号码-
   └ invoiceNumEndString否-终止发票号码-
   └ updateTimeString否-更新时间2019-08-16 15:39:28

请求报文示例

NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.OpeMplatform.getInvoiceStock"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
  \"extensionNums\": [
    \"1\"
  ],
  \"machineCode\": \"123456789012\",
  \"departmentId\": \"\",
  \"extMachineCodePairs\": [
    {
      \"machineCode\": \"123456789012\",
      \"extensionNum\": \"1\"
    }
  ]
}";
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":"E0000","describe":"调用成功","result":[
{"extensionNumber":0,
"terminalNumber":"",
"invoiceLine":"s",
"machineCode":"661513330644",
"remainNum":88,
"typeCode":"",
"invoiceNumStart":"20941908",
"invoiceNumEnd":"20942406",
"updateTime":"2021-09-09 12:05:49"},
{"extensionNumber":0,
"terminalNumber":"",
"invoiceLine":"c",
"machineCode":"661513330644",
"remainNum":11,
"typeCode":"",
"invoiceNumStart":"10405090",
"invoiceNumEnd":"10405109",
"updateTime":"2021-09-09 12:05:49"},
{"extensionNumber":0,
"terminalNumber":"",
"invoiceLine":"p",
"machineCode":"661513330644",
"remainNum":140,"typeCode":"",
"invoiceNumStart":"69989672",
"invoiceNumEnd":"69990060",
"updateTime":"2021-09-09 12:05:49"}]}

返回码说明

返回码说明处理建议
E9999分机号数量超过100,不⽀持查询
E0000调⽤成功
E1001企业资质没有配置,请联系诺诺⽹!
标签: 诺税通saas

申请试用

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