接口说明
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-type | String | 否 | - | MIME类型【消息头】 | - |
公共请求参数(消息体)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| senid | String | 否 | - | 唯一标识,由企业自己生成32位随机码【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| departmentId | String | 是 | 32 | 部门id(不传分机号、机器编号时使用) | 1AE5BDF1C42A4021B6150BEF0DD3576E |
| extensionNums | String | 是 | 5 | 分机号 | 0 |
| machineCode | String | 是 | 12 | 机器编号 | 661234567899 |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| code | String | 否 | - | 状态码 | E0000 |
| describe | String | 否 | - | 描述 | 调用成功 |
| result | Object | 否 | - | 返回结果 | - |
请求报文示例
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 | 未找到该设备,请检查开票设备或先刷新数据 | 检查入参是否正确 |