接口说明
诺税通企业可通过该接口查询上月第一天到当前时间申请下载的记录
API 方法名:nuonuo.OpeMplatform.queryDownload 版本: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 | 是 | - | 可以不传 | - |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| code | String | 否 | - | | E0000 |
| describe | String | 否 | - | | 调用成功 |
| result | Array | 否 | - | | - |
| └ applyTime | String | 否 | - | 申请时间 | 2020-01-19 09:00:00 |
| └ startTime | String | 否 | - | 下载开始时间 | 2020-01-01 |
| └ endTime | String | 否 | - | 下载结束时间 | 2020-01-18 |
| └ type | Number | 否 | - | 申请下载发票类型 1-进项 2-销项 | 1 |
| └ source | Number | 否 | - | 来源 1-自动下载,2-手动下载 | 2 |
| └ invoiceLine | String | 否 | - | 申请下载发票种类 01:增值税专用发票,03:机动车发票,04:增值税普通发票,08:增值税电子专用发票,10:增值税电子普通发票,11:增值税普通发票(卷式),14:道路通行费电子普通发票,15:二手车销售统一发票,81:电子发票(增值税专用发票),82:电子发票(普通发票),83:机动车销售电子统一发票,84:二手车销售电子统一发票,85:纸质发票(增值税专用发票),86:纸质发票(普通发票),87:数电机动车发票(纸质),88 :数电二手车发票(纸质)51:数电铁路票,61:数电航空票 | 01 |
| └ taxnum | String | 否 | - | 税号 | 1111111111111111 |
| └ taskNo | String | 否 | - | 任务号 | 20e5bdfa358f452a8376ea406d329285 |
| └ dealState | Number | 否 | - | 处理进度(1-处理中,2-处理失败,3-处理成功,4-部分成功) | 2 |
| └ failReason | String | 否 | - | 处理失败原因 | 申请时间已过期 |
| └ totalCount | Number | 否 | - | 同批次申请的所有发票种类数 | 7 |
| └ sucCount | Number | 否 | - | 同批次申请处理成功的发票种类数 | 3 |
| └ invoiceCount | Number | 否 | - | 所有票种下载成功的发票数 | 112 |
| └ invoiceBatch | String | 否 | - | 开票月份批次 | 2020年04月第1批 |
| └ updateTime | String | 否 | - | 下载记录更新时间 | 2020-04-23 14:01:02 |
请求报文示例
NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.OpeMplatform.queryDownload"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
\"taxnum\": \"\"
}";
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);
返回码说明
| 返回码 | 说明 | 处理建议 |
|---|
E0000 | 成功 | |
E7001 | 请检查企业资质是否存在并启用 | 联系管理员开通电子发票资质 |