接口说明
红字专用发票信息表下载接口:接口调用顺序为红字专用发票信息表申请接口--红字专用发票信息表查询接口--红字专用发票信息表下载接口--请求开具发票接口 入参分机、机器编号、终端号后可指定开票设备去进行下载操作
API 方法名:nuonuo.OpeMplatform.downloadInvoiceRedApply 版本:V2.0
请求地址
| 环境 | 请求地址 |
|---|
| 正式环境 | https://sdk.nuonuo.com/open/v1/services |
| 沙箱环境 | https://sandbox.nuonuocs.cn/open/v1/services |
公共请求参数(消息头)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| Content-type | String | 否 | - | MIME类型【消息头】 | - |
公共请求参数(消息体)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| senid | String | 否 | - | 唯一标识,由企业自己生成32位随机码【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| invoiceLine | String | 否 | 1 | 发票种类: s增值税专用发票 | s |
| billTimeBegin | String | 是 | 8 | 填开起始时间,信息表编号有值时,可为空 | 20200526 |
| billTimeEnd | String | 是 | 8 | 填开结束时间,信息表编号有值时,可为空 | 20200526 |
| buyerTaxNo | String | 是 | 20 | 购方税号 | 123456789 |
| billInfoNo | String | 是 | 24 | 信息表编号 | 5001012005015965 |
| extensionNumber | String | 是 | 5 | 分机号 | 0 |
| machineCode | String | 是 | 12 | 机器编号 | 661288888888 |
| terminalNumber | String | 是 | 4 | 终端号 | 1 |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| code | String | 否 | - | 申请结果代码 | E0000 |
| describe | String | 否 | - | 结果描述 | 同步成功 |
请求报文示例
NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.OpeMplatform.downloadInvoiceRedApply"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
\"terminalNumber\": \"1\",
\"machineCode\": \"661288888888\",
\"buyerTaxNo\": \"123456789\",
\"extensionNumber\": \"0\",
\"billTimeEnd\": \"20200526\",
\"billInfoNo\": \"5001012005015965\",
\"invoiceLine\": \"s\",
\"billTimeBegin\": \"20200526\"
}";
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);
返回码说明
| 返回码 | 说明 | 处理建议 |
|---|
E9520 | 只支持专票申请 | |
E9540 | 信息表编号不能超过 24 位 | |
E9545 | 填开日期不能为空 | |