首页 > 开放平台 > 诺税通saas > 进项管理
开放平台/进项管理/nst勾选发票查询

nst勾选发票查询

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

接口说明

已开通诺税通saas资质:获取进项未勾选和已勾选发票列表(含增值税发票和海关缴款书)

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

请求地址

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

公共请求参数(消息头)

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

公共请求参数(消息体)

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

私有请求参数

参数名类型必填长度说明示例
utimeEndString是-更新日期止(可用于同步) PS:更新时间2者要么全传,最大间隔时间为一年;要么都不传-
utimeStartString否-更新日期起(可用于同步)-
invoiceInfoArray是--
   └ invoiceNumberString是--
   └ invoiceCodeString是-若是数电票,则invoiceCode需传空-
jksbzNumber是-缴款书标志0-仅发票 1-发票和缴款书 2-发票和缴款书和代扣代缴完税凭证 不传默认00
managementStatusArray是-0正常, 1非正常(异常凭证), 2 疑似非正常0
kprqzString是-开票日期止yyyy-mm-dd2023-07-30
ssqString是-所属期-
checkStatusNumber是-勾选状态:0-未勾选1-已勾选 -1-采集缴款书,不能勾选1
sizeNumber是-一页条数,默认50条,最大200200
pageNumber是-当前页码,默认11
kprqqString是-开票日期起yyyy-mm-dd2023-07-01
invoiceLineArray是-01:增值税专用发票 02:货运专用发票 03:机动车销售发票 04:增值税普通发票 08:电子专用发票 10:增值税电子普通发票 14:通行费电子发票 17:海关缴款书 18:全电专票 19:全电普票 20:全电纸票(专票) 21:全电纸票(普票) 32:代扣代缴完税凭证 51:数铁路 61:数航空 83:数电机动车 87:数电机动车(纸质)99:未知 不传,默认查询全部类型18
invoiceStatusArray是-发票状态 1:正常 2:红冲 3:作废 4:失控 5:异常 6:认证异常 7:红字发票待确认 8:已部分冲红 9:已全部冲红不传,默认查询全部状态-
deductibleModeNumber是-抵扣模式 1抵扣 2不抵扣 5退税1
sidsArray是--

响应参数

参数名类型必填长度说明示例
codeString否-E0000
describeString否-调用成功
resultObject否--
   └ totalNumber否-总条数100
   └ syncTimeString否-数据最新同步时间2020-01-01 00:00:00
   └ dataArray否-发票列表List-
      └ sidString否-发票id0ad046a4f6634b888397570ca2ccb1a9
      └ taxnumString否-税号1111111111111111
      └ salerNameString否-销方名称XXX名称
      └ salerTaxnumString否-销方税号销方税号
      └ taskNoString否--
      └ dealStatusString否-勾选处理标志 0:未处理, 1:已处理(处理成功), 2: 已处理(处理失败)0
      └ invoiceCodeString否-发票代码131880930142
      └ invoiceNumberString否-发票号码18907646
      └ elecInvoiceNumberString否-数电票号码-
      └ invoiceTimeString否-开票时间2020-01-01
      └ invoiceLineString否-01:增值税专用发票 02:货运专用发票 03:机动车销售发票 04:增值税普通发票 08:电子专用发票 10:增值税电子普通发票 14:通行费电子发票 17:海关缴款书 18:全电专票 19:全电普票 20:全电纸票(专票) 21:全电纸票(普票) 32:代扣代缴完税凭证 99:未知01
      └ invoiceStatusString否-1:正常 2:红冲 3:作废 4:失控5:异常6:认证异常 7:红字发票待确认 8:已部分冲红9:已全部冲红1
      └ deductiblePeriodString否-勾选属期202001
      └ ycPeriodString否-异常所属期-
      └ yclxString否-异常类型-
      └ checkDateString否-勾选日期2020-01-01 00:00:00
      └ checkStatusString否-勾选状态:0-未勾选1-已勾选, -1-采集缴款书,不能勾选1
      └ confirmDateString否-确认日期2020-01-01 00:00:00
      └ confirmStatusString否-确认状态:0-未确认1-已确认1
      └ checkingStatusString否-10勾选中11取消勾选中12 确认中-
      └ deductibleModeString否-抵扣模式:1抵扣, 2不抵扣5退税1
      └ unDeductibleReasonArray否-不抵扣原因1用于非应税项目,2用于免税项目,3用于集体福利或者个人消费,4遭受非正常损失,5其他1, null
      └ totalAmountString否-订单总价[计算]15.2
      └ excludeTaxAmountString否-不含税金额(金额)15
      └ totalTaxString否-税额0.2
      └ validTaxString否-有效税额0.2
      └ jksbzNumber否-0-发票 1-海关缴款书0
      └ recordTimeString否-录入时间-
      └ auditResultString否-稽核结果 -1-待处理,0-稽核中,1-相符,2-不符,3-缺联,4-重号 5-历史相符 6-处理失败-
      └ managementStatusString否-0正常, 1非正常0
      └ redLockFlagString否-红字锁定标志 0-未锁定,1-已锁定-
      └ domesticSalesNoString否-转内销证明编号-
      └ checkApplyStatusString否-核对申请状态0:审核中 1:已申请 2:审核退回 3:未申请-
      └ checkResultString否-核查结果-
      └ xxlyString否-扫描认证、系统推送、不予退税系统推送
      └ respMsgString否-失败返回信息-
      └ utimeString否-本系统更新时间(数据变动更新时间也会变更)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
标签: 开放平台
上一篇:nst手工采集缴款书
下一篇:nst发票勾选

申请试用

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