接口说明
查询采集海关缴款书信息
API 方法名：nuonuo.OpeMplatform.queryCollectCustomInvoice 版本：V2.0
请求地址
| 环境 | 请求地址 |
|---|
| 正式环境 | https://sdk.nuonuo.com/open/v1/services |
| 沙箱环境 | https://sandbox.nuonuocs.cn/open/v1/services |
公共请求参数（消息头）
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| Content-type | String | 否 | - | MIME类型【消息头】 | - |
公共请求参数（消息体）
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| senid | String | 否 | - | 唯一标识，由企业自己生成32位随机码【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| kprqq | String | 是 | - | 缴款书填发日期起 | 2020-02-01 |
| kprqz | String | 是 | - | 缴款书填发日期止 | 2020-02-02 |
| sids | Array | 是 | - | 数组，发票流水号集合。 | [“1”,“2”] |
| invoiceNumber | String | 是 | - | 缴款书号码 | - |
| invoiceInfo | Array | 是 | - | 批量发票信息查询（最多100张发票） | - |
| └ invoiceNumber | String | 是 | - | 缴款书号码 | - |
| utimeStart | String | 是 | - | 更新日期起（可用于同步） | 2020-02-01 |
| utimeEnd | String | 是 | - | 更新日期止（可用于同步） PS:更新时间2者要么全传，最大间隔时间为一年；要么都不传 | 2020-02-02 |
| page | Number | 是 | - | 当前页码，默认1 | 1 |
| size | Number | 是 | - | 一页条数，默认50条，最大200 | 50 |
| businessType | Number | 是 | - | 调用业务来源(内网调用接口使用，开放平台不需要配置) 1-进项 2-销项 3-云代账 4-云代账 | 1 |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| total | Number | 否 | - | 总条数 | 100 |
| data | Object | 否 | - | 发票列表List | - |
| └ sid | String | 否 | - | 发票流水号 | 0ad046a4f6634b888397570ca2ccb1a9 |
| └ taxnum | String | 否 | - | 税号 | 1111 |
| └ dealStatus | String | 否 | - | 勾选处理标志 0 未处理 1 已处理2已处理(处理失败) 默认为1 | 0 |
| └ invoiceNumber | String | 否 | - | 缴款书号码 | - |
| └ invoiceTime | String | 否 | - | 填发日期 | 2020-01-01 |
| └ invoiceLine | String | 否 | - | 17:海关缴款书 | 17 |
| └ checkStatus | String | 否 | - | 勾选状态 -1-采集缴款书,不能勾选 | -1 |
| └ totalTax | String | 否 | - | 税款金额 | 0.2 |
| └ validTax | String | 否 | - | 有效税额 | 0.2 |
| └ jksbz | Number | 否 | - | 1-海关缴款书 | 1 |
| └ recordTime | String | 否 | - | 录入时间 | 2020-01-01 |
| └ auditResult | Number | 否 | - | 稽核结果 -1-待处理，0-稽核中，1-相符，2-不符，3-缺联，4-重号 5-历史相符 6-处理失败 7-滞留 8-核查重号 | - |
| └ managementStatus | String | 否 | - | 0正常, 1非正常(异常凭证), 2 疑似非正常 默认正常 | 0 |
| └ checkApplyStatus | Number | 否 | - | 核对申请状态0:审核中 1:已申请 2:审核退回 3:未申请 | - |
| └ checkResult | 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.queryCollectCustomInvoice"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
\"sids\": [
\"[“1”\",
\"“2”]\"
],
\"utimeEnd\": \"2020-02-02\",
\"invoiceInfo\": [
{
\"invoiceNumber\": \"\"
}
],
\"size\": 50,
\"kprqq\": \"2020-02-01\",
\"utimeStart\": \"2020-02-01\",
\"invoiceNumber\": \"\",
\"page\": 1,
\"businessType\": 1,
\"kprqz\": \"2020-02-02\"
}";
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": 2,
"syncTime": null,
"data": [
{
"sid": "21073015411799000815",
"taxnum": "91330106MA2AYNWD8M",
"dealStatus": "1",
"invoiceNumber": "415820181006707777-L01",
"invoiceTime": "2018-10-23",
"invoiceLine": "17",
"checkStatus": "-1",
"totalTax": "7504.14",
"validTax": "7504.14",
"jksbz": 1,
"recordTime": "2021-07-30",
"auditResult": 6,
"managementStatus": "0",
"checkApplyStatus": null,
"checkResult": null,
"respMsg": "局端系统：此张海关缴款书第一联已采集，请重新录入",
"utime": "2023-10-23 14:40:00"
}
]
}
}
返回码说明
| 返回码 | 说明 | 处理建议 |
|---|
E7001 | 请检查企业资质是否存在并启用 | 找到管理员开通资质 |
E9999 | 开票日期格式错误；开票日期起不能大于止；更新日期不能只传一个；更新日期起不能大于止；更新日期起止不能超过1年；分页大小不能超过200 | 修改开票日期格式；修改开票日期止时间大于开始时间；检查更新时间是否都不为空；修改更新日期止时间大于开始时间；修改更新日期止时间间隔大小；分页大小改为200以下 |
