接口说明
获取当前企业所有进项发票列表
API 方法名:nuonuo.OpeMplatform.queryInvoicePoollist 版本:V2.0
请求地址
| 环境 | 请求地址 |
|---|
| 正式环境 | https://sdk.nuonuo.com/open/v1/services |
| 沙箱环境 | https://sandbox.nuonuocs.cn/open/v1/services |
公共请求参数(消息头)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| Content-type | String | 否 | - | MIME类型【消息头】 | - |
公共请求参数(消息体)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| senid | String | 否 | - | 唯一标识,由企业自己生成32位随机码【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| updateTimeStart | String | 是 | - | 更新时间起(起止必须一起) | - |
| updateTimeEnd | String | 是 | - | 更新时间止 | - |
| invoiceTimeStart | String | 是 | - | 开票时间起(起止必须一起) | 2022-07-29 |
| invoiceTimeEnd | String | 是 | - | 开票时间止 | 2022-10-29 |
| level | Number | 是 | - | 0-不精确(没有明细) 1-精确(含明细) | 1 |
| pageSize | Number | 是 | - | 每页数据量,须大于等于1,小于等于50。未传入发票代码号码的情况,需要传入该值 | 10 |
| payerTaxNum | String | 否 | - | 付款方税号(购方税号) | 91330106MA2AYNWD8M |
| invoiceCode | String | 是 | - | 发票代码(数电票为空。如果传了代码号码,则只会根据代码号码和税号查询发票)) | - |
| invoiceNumber | String | 是 | - | 发票号码(如果传了代码号码,则只会根据代码号码和税号查询发票) | - |
| elecInvoiceNumber | String | 是 | - | 数电号码(如果传了代码号码,则只会根据代码号码和税号查询发票) | - |
| payeeName | String | 是 | - | 销方企业名称(开票方名称) | - |
| totalAmount | String | 是 | - | 含税总金额 | - |
| sellerTaxNo | String | 是 | - | 销方税号 | - |
| checkedStatus | Number | 是 | - | 查验状态:0未查验,1已查验 | 1 |
| phoneNumber | String | 是 | - | 归集人手机号 | - |
| pageNo | Number | 是 | - | 分页页码,须大于等于1。未传入发票代码号码的情况,需要传入该值 | 1 |
| reimbursementStatus | Number | 是 | - | 报销状态:1未报销,2已报销 | 1 |
| signStatus | Number | 是 | - | 签收状态默认全部:0.未签收,1.已签收 | 1 |
| invoiceLine | String | 是 | - | 发票种类: p:普通发票(电子) c:普通发票(纸质) s:专用发票(纸质) b:专用发票(电子) e:收购发票(电子) f:收购发票(纸质) r:普通发票(卷式) t:增值税电子通行费发票 j:机动车销售统一发票 u二手车发票 ,bs-电子发票(增值税专用发票),pc-电子发票(增值税普通发票),hk数电票(航空),tl(数电铁路票),dj:数电机动车发票(电子) ,sj:数电机动车发票(纸质),du:数电二手车发票(电子) ,su:数电二手车发票(纸质) | - |
| invoiceStatus | Array | 是 | - | 发票状态(1:正常 2:红冲 3:作废 4:失控 5:异常 6:认证异常 7:红字待确认 8:已部分冲红 9:已全部冲红)。不传,默认查询全部状态 | 1 |
| enterAccountStatus | String | 是 | - | 01 未入账、02 已入账-企业所得税税前扣除、03 已入账-企业所得税不扣除、06 撤销入账 | - |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| result | Object | 否 | - | | E0000 |
| └ invoices | Array | 否 | - | | 调用成功 |
| └ checkedInvoiceStatus | Number | 否 | - | 查验状态(0:未查验 1:正常 2:冲红 3:被作废 4:缺少查验字段 5:查验异常 6:查验失败 7:查无此票) | 1 |
| └ invoiceTime | String | 否 | - | 开票时间 | 2022-07-01 00:00:00 |
| └ backupUrl | String | 否 | - | 查验的ofd转换为pfd得地址 | - |
| └ managementStatus | String | 否 | - | 发票风险等级 0-正常 1-异常凭证 2-疑点发票 | 0 |
| └ level | Number | 否 | - | 精确等级(0:没有明细 1:有明细) | 1 |
| └ enterAccountStatus | String | 否 | - | 税局入账状态(01未入账 02已入账-企业所得税税前扣除 03已入账-企业所得税不扣除 06-入账撤销) | - |
| └ enterAccountDealStatus | String | 否 | - | 入账中处理状态(1 已入账-企业所得税税前扣除中 2 已入账-企业所得税不扣除中 3 入账撤销中) | - |
| └ enterAccountTime | String | 否 | - | 入账时间 yyyy-MM-dd | - |
| └ enterAccountFailReason | String | 否 | - | 提交/变更入账失败原因 | - |
| └ pictureUrl | String | 否 | - | 发票图片地址 | - |
| └ exTaxAmount | Number | 否 | - | 不含税总金额 | 28301.89 |
| └ updateTime | String | 否 | - | 更新时间 | 2022-07-28 21:29:37 |
| └ invoiceCode | String | 否 | - | 发票代码 | 3300211130 |
| └ totalAmount | Number | 否 | - | 含税总金额 | 30000.0 |
| └ sellerTaxNo | String | 否 | - | 销方税号 | 91330183MA27YQ2306 |
| └ pdfUrl | String | 否 | - | 版式文件地址,pdf或ofd或上传的文件jpg等 | - |
| └ voucherUrl | String | 否 | - | 凭证地址 | https://inv.jss.com.cn/group3/M00/06/1C/wKj6y2LBhMWIPcRNAABEyhstM8kAAHTLwIo2gsAAETi535.ofd |
| └ xmlUrl | String | 否 | - | 数电发票xml源文件地址 | - |
| └ checkTime | String | 否 | - | 查验时间 | 2022-07-02 19:00:26 |
| └ sellerTaxName | String | 否 | - | 销方名称 | 杭州钜辰会计师事务所(普通合伙) |
| └ reimbursementStatus | Number | 否 | - | 报销状态:1未报销,2已报销 | 1 |
| └ reimbursementDate | String | 否 | - | 最新的报销时间格式为:yyyy-MM-dd HH:mm:ss | - |
| └ reimbursementName | String | 否 | - | 报销人名称 | - |
| └ checkedInvoiceStatusNew | Number | 否 | - | 0:未查验 4:缺少查验字段 5:查验异常 6:查验失败 7:查无此票 8:查验成功 | 8 |
| └ signStatus | Number | 否 | - | 签收状态:0.未签收,1.已签收 | - |
| └ signTime | String | 否 | - | 签收时间格式为:yyyy-MM-dd HH:mm:ss | - |
| └ signUserName | String | 否 | - | 签收人名称 | - |
| └ payerName | String | 否 | - | 购方名称 | 浙江诺诺网络科技有限公司 |
| └ invoiceType | Number | 否 | - | 发票类型(1:蓝票,2:红票) | 1 |
| └ generalType | Number | 否 | - | 计算抵扣种类 1.农产品 2.税控类 3.国内旅客运输服务 99.其他 | - |
| └ invoiceLine | String | 否 | - | 发票种类: p:普通发票(电子) c:普通发票(纸质) s:专用发票(纸质) b:专用发票(电子) e:收购发票(电子) f:收购发票(纸质) r:普通发票(卷式) t:增值税电子通行费发票 j:机动车销售统一发票 u二手车发票 ,bs-电子发票(增值税专用发票),pc-电子发票(增值税普通发票),hk数电票(航空),tl(数电铁路票),dj:数电机动车发票(电子) ,sj:数电机动车发票(纸质),du:数电二手车发票(电子) ,su:数电二手车发票(纸质) | s |
| └ invoiceNo | String | 否 | - | 发票号码 | 57350708 |
| └ taxAmount | Number | 否 | - | 税额 | 1698.11 |
| └ invoiceStatus | String | 否 | - | 发票状态(1:正常 2:红冲 3:作废 4:失控 5:异常 6:认证异常 7:红字待确认 8:已部分冲红 9:已全部冲红) | 1 |
| └ payerTaxNo | String | 否 | - | 购方税号 | 91330106MA2AYNWD8M |
| └ specialInvoiceType | String | 否 | - | 特定业务类型01:成品油发票,02:稀土发票,03:机动车,04:货物运输服务发票,05:不动产销售服务发票,06:不动产经营租赁服务,07:代收车船税,08:通行费,09:旅客运输服务发票,10:医疗服务(住院)发票,11:医疗服务(门诊)发票,12:自产农产品销售发票,13:拖拉机和联合收割机发票,15:二手车,16:农产品收购发票,17:光伏收购发票,18:卷烟发票,19:出口发票,20:农产品,21:铁路电子客票,22:航空运输电子客票行程单,31:建安发票,32:房地产销售发票,103:建筑服务 | - |
| └ totalCount | Number | 否 | - | 总量 | 175 |
| code | String | 否 | - | | E0000 |
| success | String | 否 | - | | true |
| describe | String | 否 | - | | 调用成功 |
请求报文示例
NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.OpeMplatform.queryInvoicePoollist"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
\"elecInvoiceNumber\": \"\",
\"enterAccountStatus\": \"\",
\"updateTimeEnd\": \"\",
\"invoiceTimeEnd\": \"2022-10-29\",
\"level\": 1,
\"signStatus\": 1,
\"pageSize\": 10,
\"updateTimeStart\": \"\",
\"payerTaxNum\": \"91330106MA2AYNWD8M\",
\"invoiceCode\": \"\",
\"invoiceTimeStart\": \"2022-07-29\",
\"payeeName\": \"\",
\"totalAmount\": \"\",
\"sellerTaxNo\": \"\",
\"checkedStatus\": 1,
\"phoneNumber\": \"\",
\"pageNo\": 1,
\"reimbursementStatus\": 1,
\"invoiceNumber\": \"\",
\"invoiceLine\": \"\",
\"invoiceStatus\": [
\"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);
响应报文示例
{
"result": {
"invoices": [
{
"checkedInvoiceStatus": 1,
"invoiceTime": "2022-07-01 00:00:00",
"backupUrl": "",
"managementStatus": "0",
"level": 1,
"pictureUrl": "",
"exTaxAmount": 28301.89,
"updateTime": "2022-07-28 21:29:37",
"invoiceCode": "3300211130",
"totalAmount": 30000.0,
"sellerTaxNo": "91330183MA27YQ2306",
"pdfUrl": "",
"voucherUrl": "https://inv.jss.com.cn/group3/M00/06/1C/wKj6y2LBhMWIPcRNAABEyhstM8kAAHTLwIo2gsAAETi535.ofd",
"checkTime": "2022-07-02 19:00:26",
"sellerTaxName": "杭州钜辰会计师事务所(普通合伙)",
"reimbursementStatus": 1,
"checkedInvoiceStatusNew": 8,
"payerName": "浙江诺诺网络科技有限公司",
"invoiceType": 1,
"invoiceLine": "s",
"invoiceNo": "57350708",
"taxAmount": 1698.11,
"invoiceStatus": "1",
"payerTaxNo": "91330106MA2AYNWD8M"
}
],
"totalCount": 175
},
"code": "E0000",
"success": true,
"describe": "调用成功"
}
返回码说明