接口说明
企业发票库存查询接口: 都传入的时候,各参数优先级:分机号>机器编号>分机号+机器编号的联合查询>部门ID
API 方法名:nuonuo.OpeMplatform.getInvoiceStock 版本:V2.0
请求地址
| 环境 | 请求地址 |
|---|
| 正式环境 | https://sdk.nuonuo.com/open/v1/services |
| 沙箱环境 | https://sandbox.nuonuocs.cn/open/v1/services |
公共请求参数(消息头)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| Content-type | String | 否 | - | MIME类型【消息头】 | - |
公共请求参数(消息体)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| senid | String | 否 | - | 唯一标识,由企业自己生成32位随机码【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| departmentId | String | 是 | - | 部门id(不传分机号、机器编号时使用);部门和分机、机器编号等都不传时,返回税号下全部报税信息 | - |
| extensionNums | Array | 是 | 100 | 分机号列表(只传分机号时使用) | 1 |
| machineCode | String | 是 | 12 | 机器编号单个查询(只传机器编号时使用) | 123456789012 |
| extMachineCodePairs | Array | 是 | 1 | 分机号+机器编号联合查询(只能传入一对分机号和机器编号),精确查询某设备时建议使用此种方式 | - |
| └ extensionNum | String | 是 | 5 | 分机号 | 1 |
| └ machineCode | String | 是 | 12 | 机器编号 | 123456789012 |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| code | String | 否 | - | 状态码 | E0000 |
| describe | String | 否 | - | 返回信息 | 调用成功 |
| result | Array | 否 | - | 具体库存信息 | - |
| └ extensionNumber | Number | 否 | - | 分机号 | 1 |
| └ machineCode | String | 否 | - | 机器编号 | - |
| └ terminalNumber | String | 否 | - | 终端号 | - |
| └ invoiceLine | String | 否 | - | 发票种类:p:电子增值税普通发票;c:增值税普通发票(纸票);s:增值税专用发票;e:收购发票(电子);f:收购发票(纸质);r:增值税普通发票(卷式);b:增值税电子专用发票;j:机动车销售统一发票;u:二手车销售统一发票 | p |
| └ remainNum | Number | 否 | - | 200 | 200 |
| └ typeCode | String | 否 | - | 发票代码 | - |
| └ invoiceNumStart | String | 否 | - | 起始发票号码 | - |
| └ invoiceNumEnd | String | 否 | - | 终止发票号码 | - |
| └ updateTime | String | 否 | - | 更新时间 | 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 | 企业资质没有配置,请联系诺诺⽹! | |