接口说明
已开通诺税通saas资质:获取进项未勾选和已勾选发票列表(含增值税发票和海关缴款书)
API 方法名:nuonuo.OpeMplatform.queryInvChecklist 版本:V2.0
请求地址
| 环境 | 请求地址 |
|---|
| 正式环境 | https://sdk.nuonuo.com/open/v1/services |
| 沙箱环境 | https://sandbox.nuonuocs.cn/open/v1/services |
公共请求参数(消息头)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| Content-type | String | 否 | - | MIME类型【消息头】 | - |
公共请求参数(消息体)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| senid | String | 否 | - | 唯一标识,由企业自己生成32位随机码【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| utimeEnd | String | 是 | - | 更新日期止(可用于同步) PS:更新时间2者要么全传,最大间隔时间为一年;要么都不传 | - |
| utimeStart | String | 否 | - | 更新日期起(可用于同步) | - |
| invoiceInfo | Array | 是 | - | | - |
| └ invoiceNumber | String | 是 | - | | - |
| └ invoiceCode | String | 是 | - | 若是数电票,则invoiceCode需传空 | - |
| jksbz | Number | 是 | - | 缴款书标志0-仅发票 1-发票和缴款书 2-发票和缴款书和代扣代缴完税凭证 不传默认0 | 0 |
| managementStatus | Array | 是 | - | 0正常, 1非正常(异常凭证), 2 疑似非正常 | 0 |
| kprqz | String | 是 | - | 开票日期止yyyy-mm-dd | 2023-07-30 |
| ssq | String | 是 | - | 所属期 | - |
| checkStatus | Number | 是 | - | 勾选状态:0-未勾选1-已勾选 -1-采集缴款书,不能勾选 | 1 |
| size | Number | 是 | - | 一页条数,默认50条,最大200 | 200 |
| page | Number | 是 | - | 当前页码,默认1 | 1 |
| kprqq | String | 是 | - | 开票日期起yyyy-mm-dd | 2023-07-01 |
| invoiceLine | Array | 是 | - | 01:增值税专用发票 02:货运专用发票 03:机动车销售发票 04:增值税普通发票 08:电子专用发票 10:增值税电子普通发票 14:通行费电子发票 17:海关缴款书 18:全电专票 19:全电普票 20:全电纸票(专票) 21:全电纸票(普票) 32:代扣代缴完税凭证 51:数铁路 61:数航空 83:数电机动车 87:数电机动车(纸质)99:未知 不传,默认查询全部类型 | 18 |
| invoiceStatus | Array | 是 | - | 发票状态 1:正常 2:红冲 3:作废 4:失控 5:异常 6:认证异常 7:红字发票待确认 8:已部分冲红 9:已全部冲红不传,默认查询全部状态 | - |
| deductibleMode | Number | 是 | - | 抵扣模式 1抵扣 2不抵扣 5退税 | 1 |
| sids | Array | 是 | - | | - |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| code | String | 否 | - | | E0000 |
| describe | String | 否 | - | | 调用成功 |
| result | Object | 否 | - | | - |
| └ total | Number | 否 | - | 总条数 | 100 |
| └ syncTime | String | 否 | - | 数据最新同步时间 | 2020-01-01 00:00:00 |
| └ data | Array | 否 | - | 发票列表List | - |
| └ sid | String | 否 | - | 发票id | 0ad046a4f6634b888397570ca2ccb1a9 |
| └ taxnum | String | 否 | - | 税号 | 1111111111111111 |
| └ salerName | String | 否 | - | 销方名称 | XXX名称 |
| └ salerTaxnum | String | 否 | - | 销方税号 | 销方税号 |
| └ taskNo | String | 否 | - | | - |
| └ dealStatus | String | 否 | - | 勾选处理标志 0:未处理, 1:已处理(处理成功), 2: 已处理(处理失败) | 0 |
| └ invoiceCode | String | 否 | - | 发票代码 | 131880930142 |
| └ invoiceNumber | String | 否 | - | 发票号码 | 18907646 |
| └ elecInvoiceNumber | String | 否 | - | 数电票号码 | - |
| └ invoiceTime | String | 否 | - | 开票时间 | 2020-01-01 |
| └ invoiceLine | String | 否 | - | 01:增值税专用发票 02:货运专用发票 03:机动车销售发票 04:增值税普通发票 08:电子专用发票 10:增值税电子普通发票 14:通行费电子发票 17:海关缴款书 18:全电专票 19:全电普票 20:全电纸票(专票) 21:全电纸票(普票) 32:代扣代缴完税凭证 99:未知 | 01 |
| └ invoiceStatus | String | 否 | - | 1:正常 2:红冲 3:作废 4:失控5:异常6:认证异常 7:红字发票待确认 8:已部分冲红9:已全部冲红 | 1 |
| └ deductiblePeriod | String | 否 | - | 勾选属期 | 202001 |
| └ ycPeriod | String | 否 | - | 异常所属期 | - |
| └ yclx | String | 否 | - | 异常类型 | - |
| └ checkDate | String | 否 | - | 勾选日期 | 2020-01-01 00:00:00 |
| └ checkStatus | String | 否 | - | 勾选状态:0-未勾选1-已勾选, -1-采集缴款书,不能勾选 | 1 |
| └ confirmDate | String | 否 | - | 确认日期 | 2020-01-01 00:00:00 |
| └ confirmStatus | String | 否 | - | 确认状态:0-未确认1-已确认 | 1 |
| └ checkingStatus | String | 否 | - | 10勾选中11取消勾选中12 确认中 | - |
| └ deductibleMode | String | 否 | - | 抵扣模式:1抵扣, 2不抵扣5退税 | 1 |
| └ unDeductibleReason | Array | 否 | - | 不抵扣原因1用于非应税项目,2用于免税项目,3用于集体福利或者个人消费,4遭受非正常损失,5其他 | 1, null |
| └ totalAmount | String | 否 | - | 订单总价[计算] | 15.2 |
| └ excludeTaxAmount | String | 否 | - | 不含税金额(金额) | 15 |
| └ totalTax | String | 否 | - | 税额 | 0.2 |
| └ validTax | String | 否 | - | 有效税额 | 0.2 |
| └ jksbz | Number | 否 | - | 0-发票 1-海关缴款书 | 0 |
| └ recordTime | String | 否 | - | 录入时间 | - |
| └ auditResult | String | 否 | - | 稽核结果 -1-待处理,0-稽核中,1-相符,2-不符,3-缺联,4-重号 5-历史相符 6-处理失败 | - |
| └ managementStatus | String | 否 | - | 0正常, 1非正常 | 0 |
| └ redLockFlag | String | 否 | - | 红字锁定标志 0-未锁定,1-已锁定 | - |
| └ domesticSalesNo | String | 否 | - | 转内销证明编号 | - |
| └ checkApplyStatus | String | 否 | - | 核对申请状态0:审核中 1:已申请 2:审核退回 3:未申请 | - |
| └ checkResult | String | 否 | - | 核查结果 | - |
| └ xxly | String | 否 | - | 扫描认证、系统推送、不予退税 | 系统推送 |
| └ respMsg | String | 否 | - | 失败返回信息 | - |
| └ utime | String | 否 | - | 本系统更新时间(数据变动更新时间也会变更) | 2020-01-01 00:00:00 |
请求报文示例
NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.OpeMplatform.queryInvChecklist"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
\"utimeEnd\": \"\",
\"invoiceInfo\": [
{
\"invoiceNumber\": \"\",
\"invoiceCode\": \"\"
}
],
\"jksbz\": 0,
\"managementStatus\": [
\"0\"
],
\"kprqz\": \"2023-07-30\",
\"ssq\": \"\",
\"sids\": [],
\"checkStatus\": 1,
\"size\": 200,
\"kprqq\": \"2023-07-01\",
\"utimeStart\": \"\",
\"invoiceLine\": [
\"18\"
],
\"page\": 1,
\"invoiceStatus\": [],
\"deductibleMode\": 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":{
"total":100,
"syncTime":"2020-01-01 00:00:00",
"data":[{
"sid":"0ad046a4f6634b888397570ca2ccb1a9",
"taxnum":"1111111111111111",
"salerName":"XXX名称",
"salerTaxnum":"销方名称",
"taskNo": "",
"dealStatus": "0",
"invoiceCode":"131880930142",
"invoiceNumber":"18907646",
"invoiceTime":"2020-01-01",
"invoiceLine":"01",
"invoiceStatus":"1",
"deductiblePeriod":"202001",
"ycPeriod":"",
"yclx":"",
"checkDate":"2020-01-01 00:00:00",
"checkStatus":"1",
"confirmDate":"2020-01-01 00:00:00",
"confirmStatus":"1",
"checkingStatus":"",
"deductibleMode":"1",
"unDeductibleReason":"1",
"unDeductibleReason":null,
"totalAmount":"15.2",
"excludeTaxAmount":"15",
"totalTax":"0.2",
"validTax":"0.2",
"jksbz": 0,
"recordTime": null,
"auditResult": null,
"managementStatus":"0",
"redLockFlag": null,
"domesticSalesNo": null,
"checkApplyStatus": null,
"checkResult": null,
"xxly":"系统推送",
"respMsg":null,
"utime":"2020-01-01 00:00:00"
}
]
}
}
返回码说明
| 返回码 | 说明 | 处理建议 |
|---|
E7001 | 请检查企业资质是否存在并启用 | 找到管理员开通资质 |
E9999-01 | 开票日期格式错误 | |
E9999-02 | 开票日期起不能大于止 | |
E9999-043 | 更新日期不能只传一个 | |
E9999-04 | 更新日期起不能大于止 | |
E9999-05 | 更新日期起止不能超过1年 | |
E9999-06 | 分页大小不能超过200 | |