接口说明
通过时间段筛选企业发票列表
API 方法名:nuonuo.OpeMplatform.queryInvoiceList 版本:V2.0
请求地址
| 环境 | 请求地址 |
|---|
| 正式环境 | https://sdk.nuonuo.com/open/v1/services |
| 沙箱环境 | https://sandbox.nuonuocs.cn/open/v1/services |
公共请求参数(消息头)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| Content-type | String | 否 | - | MIME类型【消息头】 | - |
公共请求参数(消息体)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| senid | String | 否 | - | 唯一标识,由企业自己生成32位随机码【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| taxnum | String | 否 | 35 | 企业税号 | 339901999999212 |
| requestType | String | 否 | 2 | 请求类型,默认是0;0为按照发票添加时间查询,1为按照开票时间查询,2为按照发票状态更新时间查询 | 1 |
| startTime | String | 否 | 20 | 时间起始值。格式:yyyy-MM-dd HH:mm:ss | 2019-03-04 00:00:00 |
| endTime | String | 否 | 20 | 时间结束值。起始时间和结束时间间隔不能大于10天,格式:yyyy-MM-dd HH:mm:ss 时间区间前闭后开 | 2019-03-09 00:00:00 |
| pageNo | String | 否 | 10 | 当前页 | 2 |
| pageSize | String | 否 | 10 | 每页条数 | 20 |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| code | String | 否 | - | 符合条件的数据数量 | E0000 |
| describe | String | 否 | - | | 调用成功 |
| result | Object | 否 | - | | - |
| └ totalCount | Number | 否 | - | 发票数 | 2 |
| └ invoices | Array | 否 | - | | - |
| └ serialNo | String | 否 | - | 发票请求流水号 | 19030412532501000030 |
| └ sellerTaxNo | String | 否 | - | 企业税号 | 339901999999142 |
| └ orderNo | String | 否 | - | 订单编号 | 20190304125304253604 |
| └ status | String | 否 | - | 发票状态: 2 :开票完成( 最终状 态),其他状态分别为: 20:开票中; 21:开票成功签章中;22:开票失败;24: 开票成功签章失败;3:发票已作废 31: 发票作废中 备注:22、24状态时,无需再查询,请确认开票失败原因以及签章失败原因;3、31只针对纸票 注:请以该状态码区分发票状态 | 21 |
| └ invoiceCode | String | 否 | - | 发票代码 | 131880930142 |
| └ invoiceNo | String | 否 | - | 发票号码 | 18783058 |
| └ exTaxAmount | Number | 否 | - | 不含税金额 | 1.00 |
| └ taxAmount | Number | 否 | - | 合计税额 | 0.02 |
| └ payerName | String | 否 | - | 购方名称 | 浙江诺诺网络科技有限公司 |
| └ buyerTaxNo | String | 否 | - | 购方税号 | - |
| └ invoiceKind | String | 否 | - | 发票种类,包含:增值税电子普通发票、增值税普通发票、专用发票(电子)、增值税专用发票、收购发票(电子)、收购发票(纸质)、增值税普通发票(卷式)、机动车销售统一发票、二手车销售统一发票、电子发票(增值税专用发票)、电子发票(普通发票)、全电纸质发票(增值税专用发票)、全电纸质发票(普通发票); 备注:电子发票(增值税专用发票)即 数电专票(电子),电子发票(普通发票)即 数电普票(电子) | 增值税电子普通发票 |
| └ addTime | String | 否 | - | 创建时间 | 2019-03-04 00:00:00 |
| └ invoiceTime | String | 否 | - | 开票时间 | 2019-03-04 00:00:00 |
| └ checkCode | String | 否 | - | 校验码 | 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 | 系统繁忙,请稍后再试 | |