首页 > 开放平台 > 诺税通saas > 发票库存
开放平台/发票库存/诺税通saas企业发票余量刷新接口

诺税通saas企业发票余量刷新接口

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

接口说明

1、刷新企业发票余量接口,先使用该接口,再调用 企业发票余量查询接口,可获取准确的发票库存余量 2、入参参数都传入的时候,优先级:分机号+机器编号 > 部门ID 3、相同设备的请求频率每分钟只能一次,否则提示:频繁刷新,请稍后再试

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

请求地址

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

公共请求参数(消息头)

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

公共请求参数(消息体)

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

私有请求参数

参数名类型必填长度说明示例
departmentIdString是32部门id(不传分机号、机器编号时使用)1AE5BDF1C42A4021B6150BEF0DD3576E
extensionNumsString是5分机号0
machineCodeString是12机器编号661234567899

响应参数

参数名类型必填长度说明示例
codeString否-状态码E0000
describeString否-描述调用成功
resultObject否-返回结果-

请求报文示例

NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.OpeMplatform.refreshInvoiceStock"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
  \"extensionNums\": \"0\",
  \"machineCode\": \"661234567899\",
  \"departmentId\": \"1AE5BDF1C42A4021B6150BEF0DD3576E\"
}";
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": "E0000",
 "describe": "调用成功",
 "result": {
        "单机版(全自动 2.0)_339901999999142_2_2": {
            "E0000": "库存刷新下发请求成功"
        },
        "诺诺机柜_339901999999142_655_null": {
            "E9999": "库存刷新下发请求失败:未找到该设备,请检查开票设备或先刷新数据"
        },
        "诺诺机柜_339901999999142_111_null": {
            "E9999": "库存刷新下发请求失败:未找到该设备,请检查开票设备或先刷新数据"
        },
        "诺诺开票_339901999999142_6777_null": {
            "E9999": "库存刷新下发请求失败:未找到该设备,请检查开票设备或先刷新数据"
        },
        "诺诺盒子_339901999999142_0_111111111111": {
            "E9999": "库存刷新下发请求失败:未找到该设备,请检查开票设备或先刷新数据"
        }
    }

}

返回码说明

返回码说明处理建议
E0000调用成功
E9607企业税号不能为空检查参数请求头中businessTaxNum是否正确
E9307税号只能包含数字和字母检查参数请求头中businessTaxNum是否正确
E9306购方税号只支持6-20位检查参数请求头中businessTaxNum是否正确
E9296分机号只能是空或数字检查入参分机号是否正确
E9449分机号最大长度为5位检查入参分机号是否正确
E9236分机号设置信息错误检查入参分机号是否正确
E9293设备号只能为数字检查入参机器编号是否正确
E9294设备号长度为12位检查入参机器编号是否正确
E9291部门id长度不能超过32位,且只包含字母和数字检查入参部门Id是否正确
E9621未找到该设备,请检查开票设备或先刷新数据检查入参是否正确
标签: 诺税通saas

申请试用

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