接口说明
开通了诺税通saas资质的企业可以通过该接口,同步税局未勾选和已勾选及统计表信息(含增值税发票、退税发票、海关缴款书、代扣代缴完税凭证)。
API 方法名:nuonuo.OpeMplatform.synchronizeInvoiceData 版本:V2.0
请求地址
| 环境 | 请求地址 |
|---|
| 正式环境 | https://sdk.nuonuo.com/open/v1/services |
| 沙箱环境 | https://sandbox.nuonuocs.cn/open/v1/services |
公共请求参数(消息头)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| Content-type | String | 否 | - | MIME类型【消息头】 | - |
公共请求参数(消息体)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| senid | String | 否 | - | 唯一标识,由企业自己生成32位随机码【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| wgx | Object | 是 | - | 未勾选同步(抵扣) | 91330106MA2AYNWD8M |
| └ kprqq | String | 否 | - | 开票日期起 | 2023-01-01 |
| └ kprqz | String | 否 | - | 开票日期止 | 2023-03-01 |
| ygx | Object | 是 | - | 已勾选同步(抵扣) | - |
| └ ssq | String | 否 | - | 所属期 | - |
| dktj | Object | 是 | - | 抵扣统计表 | - |
| └ ssq | String | 否 | - | 所属期 | 202206 |
| jksWgx | Object | 是 | - | 缴款书未勾选同步 | - |
| └ tfrqq | String | 否 | - | 填发日期起 | 2023-05-01 |
| └ tfrqz | String | 否 | - | 填发日期止 | 2023-06-22 |
| jksYgx | Object | 是 | - | 缴款书已勾选同步 | - |
| └ ssq | String | 否 | - | 所属期 | - |
| jksCj | Object | 是 | - | 缴款书采集同步 | - |
| └ tfrqq | String | 否 | - | 填发日期起 | - |
| └ tfrqz | String | 否 | - | 填发日期起 | - |
| wspzWgx | Object | 是 | - | 完税凭证未勾选同步(抵扣) | - |
| └ kprqq | String | 否 | - | 开票日期起 | - |
| └ kprqz | String | 否 | - | 开票日期止 | - |
| wspzYgx | Object | 是 | - | 完税凭证已勾选同步(抵扣) | - |
| └ ssq | String | 否 | - | 所属期 | - |
| oilGj | Object | 是 | - | 成品油购进同步 | - |
| └ kprqq | String | 否 | - | 开票日期起 | - |
| └ kprqz | String | 否 | - | 开票日期起 | - |
| oilMx | Object | 是 | - | 成品油明细同步 | - |
| └ czrqq | String | 否 | - | 选择操作日期起 | - |
| └ czrqz | String | 否 | - | 选择操作日期起 | - |
| tswgx | Object | 是 | - | 未勾选同步(退税) | - |
| └ kprqq | String | 否 | - | 开票日期起 | - |
| └ kprqz | String | 否 | - | 开票日期止 | - |
| tsygx | Object | 是 | - | 已勾选同步(退税) | - |
| └ ssq | String | 否 | - | 当前月份 | - |
| tsqr | Object | 是 | - | 退税已确认 | - |
| └ ssq | String | 否 | - | 所属月份 | - |
| tstj | Object | 是 | - | 退税统计表 | - |
| └ ssq | String | 否 | - | 所属月份 | - |
| wdq | Object | 是 | - | 未到期同步(发票) | - |
| └ kprqq | String | 否 | - | 开票日期起 | - |
| └ kprqz | String | 否 | - | 开票日期止 | - |
| eleAccount | String | 是 | - | 数电平台登录账号 | - |
| role | Number | 是 | - | 数电平台登录身份 1-开票员 2-办税员 3-管理员 4-财务负责人 5-法定代表人 | 1 |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| count | Number | 否 | - | 剩余同步次数 | 5 |
| taskNo | String | 否 | - | 任务号 | 14fefa333a2541aeb92433958a175a5f |
请求报文示例
NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.OpeMplatform.synchronizeInvoiceData"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
\"wspzYgx\": {
\"ssq\": \"\"
},
\"jksYgx\": {
\"ssq\": \"\"
},
\"tstj\": {
\"ssq\": \"\"
},
\"role\": 1,
\"wdq\": {
\"kprqq\": \"\",
\"kprqz\": \"\"
},
\"wspzWgx\": {
\"kprqq\": \"\",
\"kprqz\": \"\"
},
\"wgx\": {
\"kprqq\": \"2023-01-01\",
\"kprqz\": \"2023-03-01\"
},
\"ygx\": {
\"ssq\": \"\"
},
\"jksWgx\": {
\"tfrqq\": \"2023-05-01\",
\"tfrqz\": \"2023-06-22\"
},
\"oilMx\": {
\"czrqq\": \"\",
\"czrqz\": \"\"
},
\"jksCj\": {
\"tfrqq\": \"\",
\"tfrqz\": \"\"
},
\"tswgx\": {
\"kprqq\": \"\",
\"kprqz\": \"\"
},
\"dktj\": {
\"ssq\": \"202206\"
},
\"tsygx\": {
\"ssq\": \"\"
},
\"eleAccount\": \"\",
\"tsqr\": {
\"ssq\": \"\"
},
\"oilGj\": {
\"kprqq\": \"\",
\"kprqz\": \"\"
}
}";
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 | 所属期不存在或今日未同步 | 检查今日设备是否启动或同步所属期 |
E3000 | 请确认设备是否在线 | 检查设备是否在线 |
E3003 | 进项企业资质地区未配置 | 联系管理员配置地区 |
E3004 | 进项企业资质地区映射不对 | 联系管理员查看地区是否配置正确 |
E3005 | 进项企业资质证书密码未配置 | 联系管理员配置配置证书密码 |
E5012 | 所属期今日未同步 | 同步所属期 |
E7001 | 请检查企业资质是否存在并启用 | 联系管理员开通电子发票资质 |
E9999-01 | 请先配置客户端进项登陆信息 | 联系管理员确定进项勾选账号信息是否完整 |
E9999-02 | 今日未连接到认证服务器 | 检查客户端是否启动 |