接口说明
开票前根据税号、分机号、机器编号、终端号、票种获取下一张发票代码、号码的接⼝ (只支持A9+开票服务器类型) 票种支持:p:普通发票(电子) c:普通发票(纸质) s:专用发票 e:收购发票(电子) f:收购发票(纸质) r:普通发票(卷式) j:机动车销售统一发票 b:专用发票(电子)
API 方法名:nuonuo.OpeMplatform.queryNextInvoiceCode 版本:V2.0
请求地址
| 环境 | 请求地址 |
|---|
| 正式环境 | https://sdk.nuonuo.com/open/v1/services |
| 沙箱环境 | https://sandbox.nuonuocs.cn/open/v1/services |
公共请求参数(消息头)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| Content-type | String | 否 | - | MIME类型【消息头】 | - |
公共请求参数(消息体)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| senid | String | 否 | - | 唯一标识,由企业自己生成32位随机码【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| extensionNum | String | 否 | 5 | 分机号 | 0 |
| invoiceLine | String | 否 | 2 | 发票种类(p:普通发票(电子) c:普通发票(纸质) s:专用发票 e:收购发票(电子) f:收购发票(纸质) r:普通发票(卷式) j:机动车销售统一发票 b:专用发票(电子) | p |
| terminalNum | String | 否 | 4 | 终端号 | 1 |
| machineCode | String | 是 | 12 | 机器编号 | 661716747141 |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| code | String | 否 | - | 状态码 | E0000 |
| describe | String | 否 | - | 描述 | 同步成功 |
| result | Object | 否 | - | 返回结果 | - |
| └ invoiceLine | String | 否 | - | 发票种类(p:普通发票(电子) c:普通发票(纸质) s:专用发票 e:收购发票(电子) f:收购发票(纸质) r:普通发票(卷式) j:机动车销售统一发票 b:专用发票(电子)) | p |
| └ nextInvoiceCode | String | 否 | - | 发票代码 | 150010020012 |
| └ nextInvoiceNum | String | 否 | - | 发票号码 | 35425107 |
| └ remainNum | String | 否 | - | 剩余份数 | 1094 |
请求报文示例
NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.OpeMplatform.queryNextInvoiceCode"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
\"machineCode\": \"661716747141\",
\"invoiceLine\": \"p\",
\"terminalNum\": \"1\",
\"extensionNum\": \"0\"
}";
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);
返回码说明
| 返回码 | 说明 | 处理建议 |
|---|
E0000 | 同步成功 | |
E1001 | 分机号不能为空/票种不能为空/终端号不能为空/开票订单号最大长度为64 | 输入正确参数 |
E9513 | 企业资质不存在或已关闭 | 联系诺诺管理员 |
E9556 | 未找到指定设备 | 检查分机号、税号、终端号、票种是否正确 |
E9561 | 只支持A9+设备 | 检查传入参数是否为A9+设备数据 |
E9999 | 处理异常 | 联系诺诺管理员 |
E9702 | 开票服务器地址为空 | 联系诺诺管理员 |
E9703 | 此设备不支持该票种或未找到设备 | 检查参数是否正确 |