首页 > 开放平台 > 诺税通saas > 进项管理
开放平台/进项管理/nst发票勾选

nst发票勾选

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

接口说明

诺税通saas资质用户:商家平台调用该接口,将需要的发票发送勾选。(单次支持最多100张发票,同一税号不可同时操作,当期所属期)。

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

请求地址

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

公共请求参数(消息头)

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

公共请求参数(消息体)

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

私有请求参数

参数名类型必填长度说明示例
jksbzString是-缴款书标志0-勾选发票 1-勾选缴款书 2-代扣代缴完税凭证。不传默认00
gxUserNameString是20勾选人名称-
invDataArray否-发票数据列表(最多100张发 票)-
   └ unDeductibleReasonString是-不抵扣原因 1用于非应税项目,2用于免税项目,3用于集体福利或者个人消费,4遭受非正常损失,5其他5
   └ unDeductibleOtherReasonString是-全电平台不抵扣原因为其他时具体原因测试
   └ invoiceCodeString是12发票代码-
   └ invoiceNumString是-发票号码或缴款书号码或完税凭证号23332000000040162207
   └ salerTaxnumString是-被扣缴人识别号(仅当发票流水号为空且jksbz=2时必填)-
   └ sidString是-发票流水号(默认传了流水号以流水号勾选,如果流水号为空则使用代码号码或缴款书号码勾选,都为空则不进行勾选)-
deductibleModeString是-1:抵扣勾选(默认) -1:取消抵扣勾选 4:不抵扣勾选 -4:取消不抵扣勾选 5:退税勾选 -5:取消退税勾选4
eleAccountString是-数电平台登录账号-
roleNumber是-数电平台登录身份 1-开票员 2-办税员 3-管理员 4-财务负责人 5-法定代表人1

响应参数

参数名类型必填长度说明示例
codeString否-E5008
describeString否-当前已申请统计,若需勾选,请先撤销统计
resultString否--
successString否-false

请求报文示例

NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.OpeMplatform.invoiceCheckListNew"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
  \"jksbz\": \"0\",
  \"gxUserName\": \"\",
  \"role\": 1,
  \"eleAccount\": \"\",
  \"invData\": [
    {
      \"unDeductibleReason\": \"5\",
      \"salerTaxnum\": \"\",
      \"unDeductibleOtherReason\": \"测试\",
      \"invoiceCode\": \"\",
      \"invoiceNum\": \"23332000000040162207\",
      \"sid\": \"\"
    }
  ],
  \"deductibleMode\": \"4\"
}";
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" : "E5008", "describe" : "当前已申请统计,若需勾选,请先撤销统计", "result" : null, "success" : false }

返回码说明

返回码说明处理建议
E0000成功检查今日设备是否启动或同步所属期
E3000请确认设备是否在线
E3003进项企业资质地区未配置
E3004进项企业资质地区映射不对
E3005进项企业资质证书密码未配置
E6001上个任务正在处理中,请稍后再试等待3分钟,后再操作
E6002任务推送失败,请联系管理员
E7001请检查企业资质是否存在并启用
E8000发票不存在检查发票流水号
E8001已勾选发票不允许重复勾选
E8002处于勾选(取消勾选)流程中发票不允许操作等待操作中发票完成
E8003开票时间不在勾选所属期范围内检查开票时间大于勾选截止日期的发票
E8004有效税额不能大于税额
E8005发票状态或管理状态异常不能提交发票状态为不正常或管理状态不正常的发票
E8006非已勾选发票不允许发起取消勾选未勾选发票不能取消勾选
E8007不能操作已存在历史所属期发票剔除历史已确认的发票
E8008抵扣勾选(不抵扣勾选)发票不允许取消不抵扣(抵扣)勾选检查抵扣发票模式
E9999请先配置客户端进项勾选信息找管理员确定进项勾选账号信息是否完整
标签: 开放平台
上一篇:nst勾选发票查询
下一篇:nst获取所属期

申请试用

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