接口说明
诺税通saas资质用户:商家平台调用该接口,将需要的发票发送勾选。(单次支持最多100张发票,同一税号不可同时操作,当期所属期)。
API 方法名:nuonuo.OpeMplatform.invoiceCheckListNew 版本:V2.0
请求地址
| 环境 | 请求地址 |
|---|
| 正式环境 | https://sdk.nuonuo.com/open/v1/services |
| 沙箱环境 | https://sandbox.nuonuocs.cn/open/v1/services |
公共请求参数(消息头)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| Content-type | String | 否 | - | MIME类型【消息头】 | - |
公共请求参数(消息体)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| senid | String | 否 | - | 唯一标识,由企业自己生成32位随机码【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| jksbz | String | 是 | - | 缴款书标志0-勾选发票 1-勾选缴款书 2-代扣代缴完税凭证。不传默认0 | 0 |
| gxUserName | String | 是 | 20 | 勾选人名称 | - |
| invData | Array | 否 | - | 发票数据列表(最多100张发 票) | - |
| └ unDeductibleReason | String | 是 | - | 不抵扣原因 1用于非应税项目,2用于免税项目,3用于集体福利或者个人消费,4遭受非正常损失,5其他 | 5 |
| └ unDeductibleOtherReason | String | 是 | - | 全电平台不抵扣原因为其他时具体原因 | 测试 |
| └ invoiceCode | String | 是 | 12 | 发票代码 | - |
| └ invoiceNum | String | 是 | - | 发票号码或缴款书号码或完税凭证号 | 23332000000040162207 |
| └ salerTaxnum | String | 是 | - | 被扣缴人识别号(仅当发票流水号为空且jksbz=2时必填) | - |
| └ sid | String | 是 | - | 发票流水号(默认传了流水号以流水号勾选,如果流水号为空则使用代码号码或缴款书号码勾选,都为空则不进行勾选) | - |
| deductibleMode | String | 是 | - | 1:抵扣勾选(默认) -1:取消抵扣勾选 4:不抵扣勾选 -4:取消不抵扣勾选 5:退税勾选 -5:取消退税勾选 | 4 |
| eleAccount | String | 是 | - | 数电平台登录账号 | - |
| role | Number | 是 | - | 数电平台登录身份 1-开票员 2-办税员 3-管理员 4-财务负责人 5-法定代表人 | 1 |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| code | String | 否 | - | | E5008 |
| describe | String | 否 | - | | 当前已申请统计,若需勾选,请先撤销统计 |
| result | String | 否 | - | | - |
| success | String | 否 | - | | 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 | 请先配置客户端进项勾选信息 | 找管理员确定进项勾选账号信息是否完整 |