首页 > 开放平台 > 诺税通saas > 进项管理
开放平台/进项管理/nst同步勾选/退税发票和海关缴款书

nst同步勾选/退税发票和海关缴款书

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

接口说明

开通了诺税通saas资质的企业可以通过该接口,同步税局未勾选和已勾选及统计表信息(含增值税发票、退税发票、海关缴款书、代扣代缴完税凭证)。

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

请求地址

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

公共请求参数(消息头)

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

公共请求参数(消息体)

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

私有请求参数

参数名类型必填长度说明示例
wgxObject是-未勾选同步(抵扣)91330106MA2AYNWD8M
   └ kprqqString否-开票日期起2023-01-01
   └ kprqzString否-开票日期止2023-03-01
ygxObject是-已勾选同步(抵扣)-
   └ ssqString否-所属期-
dktjObject是-抵扣统计表-
   └ ssqString否-所属期202206
jksWgxObject是-缴款书未勾选同步-
   └ tfrqqString否-填发日期起2023-05-01
   └ tfrqzString否-填发日期止2023-06-22
jksYgxObject是-缴款书已勾选同步-
   └ ssqString否-所属期-
jksCjObject是-缴款书采集同步-
   └ tfrqqString否-填发日期起-
   └ tfrqzString否-填发日期起-
wspzWgxObject是-完税凭证未勾选同步(抵扣)-
   └ kprqqString否-开票日期起-
   └ kprqzString否-开票日期止-
wspzYgxObject是-完税凭证已勾选同步(抵扣)-
   └ ssqString否-所属期-
oilGjObject是-成品油购进同步-
   └ kprqqString否-开票日期起-
   └ kprqzString否-开票日期起-
oilMxObject是-成品油明细同步-
   └ czrqqString否-选择操作日期起-
   └ czrqzString否-选择操作日期起-
tswgxObject是-未勾选同步(退税)-
   └ kprqqString否-开票日期起-
   └ kprqzString否-开票日期止-
tsygxObject是-已勾选同步(退税)-
   └ ssqString否-当前月份-
tsqrObject是-退税已确认-
   └ ssqString否-所属月份-
tstjObject是-退税统计表-
   └ ssqString否-所属月份-
wdqObject是-未到期同步(发票)-
   └ kprqqString否-开票日期起-
   └ kprqzString否-开票日期止-
eleAccountString是-数电平台登录账号-
roleNumber是-数电平台登录身份 1-开票员 2-办税员 3-管理员 4-财务负责人 5-法定代表人1

响应参数

参数名类型必填长度说明示例
countNumber否-剩余同步次数5
taskNoString否-任务号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今日未连接到认证服务器检查客户端是否启动
标签: 开放平台

申请试用

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