接口说明
开通了诺税通saas资质的企业可以通过该接口查询对应所属期的统计表信息。
API 方法名:nuonuo.OpeMplatform.obtainDeductionStatisThir 版本:V2.0
请求地址
| 环境 | 请求地址 |
|---|
| 正式环境 | https://sdk.nuonuo.com/open/v1/services |
| 沙箱环境 | https://sandbox.nuonuocs.cn/open/v1/services |
公共请求参数(消息头)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| Content-type | String | 否 | - | MIME类型【消息头】 | - |
公共请求参数(消息体)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| senid | String | 否 | - | 唯一标识,由企业自己生成32位随机码【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| ssq | String | 否 | - | 查询的所属期 | 202305 |
| type | String | 是 | - | 统计表类型 1-抵扣正常 2-抵扣异常 3-退税正常 5-全电平台统计表 不传默认查询抵扣正常 | 1 |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| result | Object | 否 | - | | - |
| └ data | Array | 否 | - | 综合服务平台统计表 | - |
| └ data | Array | 否 | - | 发票明细 | - |
| └ fs | String | 否 | - | 份数 | 22 |
| └ se | String | 否 | - | 税额 | 40219.68 |
| └ label | String | 否 | - | 抵扣/不抵扣 | 抵扣 |
| └ je | String | 否 | - | 金额 | 318805.9 |
| └ lx | String | 否 | - | 发票统计类型 | 增值税专用发票 |
| └ tjwcsj | String | 否 | - | 统计完成时间--新老统计表均返回 | 2019-08-29 08:10:00 |
| └ ssq | String | 否 | - | 所属期--新老统计表均返回 | 201908 |
| └ cx | String | 否 | - | 撤销标记,y-允许,n-不允许--新老统计表均返回 | y |
| └ zt | String | 否 | - | 状态标记,done 完成,doing正在统计,will 未统计,signed 签名完成--新老统计表均返回 | done |
| └ status | String | 否 | - | 具体状态标记,01-未申请统计,02-申请统计中, 03-统计完成, 04-签名中, 05-签名完成, 06-已统计撤销统计中, 07-已签名撤销统计中 08-申请统计失败, 09-确认签名失败, 10-已统计撤销统计失败,11-已签名撤销统计失败 | 03 |
| └ failReason | String | 否 | - | 统计签名失败原因 | 失败原因是... |
| └ sign | String | 否 | - | 签名标记,y-允许签名 n-不允许签名--新老统计表均返回 | n |
| └ sqtjsj | String | 否 | - | 申请统计时间--新老统计表均返回 | 2019-08-29 08:06:12 |
| └ sq | String | 否 | - | 申请统计标记,y-允许,n-不允许--新老统计表均返回 | n |
| └ tjsjstr | String | 否 | - | 确认签名参数--新老统计表均返回 | 01=22=318805.9=40219.68;03=0=0=0;14=0=0=0;99=22=318805.9=40219.68; |
| └ qrqmsj | String | 否 | - | 确认签名时间--新老统计表均返回 | - |
| └ datadata | Array | 否 | - | 全电平台统计表 | - |
| └ dktjxx | Array | 否 | - | 抵扣类勾选统计结果 | - |
| └ fplx | String | 否 | - | 发票类型 | 增值税专用发票 |
| └ hjfs | String | 否 | - | 合计份数 | 1184 |
| └ sehj | String | 否 | - | 有效抵扣税额合计 | 23788132.17 |
| └ ckznxzmfs | String | 否 | - | 出口转内销证明份数 | 0 |
| └ ckznxsehj | String | 否 | - | 出口转内销有效税额抵扣合计 | 0 |
| └ qtfpfs | String | 否 | - | 其他发票份数 | 1184 |
| └ qtyxdksehj | String | 否 | - | 其他发票有效税额抵扣合计 | 23788132.17 |
| └ ncptjxx | Array | 否 | - | 农产品加计勾选统计结果 | - |
| └ fplx | String | 否 | - | 发票类型 | 增值税专用发票 |
| └ zsfpfs | String | 否 | - | 正数发票份数 | 0 |
| └ zsyxdksehj | String | 否 | - | 正数发票抵扣税额合计 | 0 |
| └ fsfpfs | String | 否 | - | 负数发票份数 | 0 |
| └ fsyxdksehj | String | 否 | - | 负数发票抵扣税额合计 | 0 |
| └ jxdkhz | Array | 否 | - | 增值税申报进项抵扣汇总 | - |
| └ fplx | String | 否 | - | 进项抵扣类型 | 本期认证相符的增值税专用发票(第2行) |
| └ hjfs | String | 否 | - | 合计份数 | 2148 |
| └ hjje | String | 否 | - | 合计金额 | 183991865.03 |
| └ sehj | String | 否 | - | 合计税额 | 23792816.88 |
请求报文示例
NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.OpeMplatform.obtainDeductionStatisThir"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
\"ssq\": \"202305\",
\"type\": \"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);
返回码说明
| 返回码 | 说明 | 处理建议 |
|---|
E2055 | 请先登录认证服务器 | 检查客户端是否启动 |
E5001 | 当前所属期抵扣统计任务正在执行中... | 等待查询统计任务完成 |
E5004 | 当前所属期未申请抵扣统计 | 执行申请统计 |
E7001 | 请检查企业资质是否存在并启用 | 找到管理员开通资质 |
E9999-01 | 请先配置客户端进项勾选信息 | 找管理员确定进项勾选账号信息是否完整 |
E9999-02 | 未找到进项分机号 | 启动支持进项勾选的客户端 |
E9999-03 | 今日未连接到认证服务器 | 检查客户端是否启动 |
E9999-04 | 所属期不能为空 | 传入所属期 |