接口说明
整合支付宝/微信联用冲红能力,调用方无需手动区分渠道,且无需提前申请确认单,系统自动分流并开具红票。 仅支持全额冲红,且限定原蓝票为微信联用或者支付宝联用开具。 渠道自动识别(后端根据原蓝票自动判断): 开票模式 = 支付宝乐企联用 → 支付宝联用冲红 ;开票模式 = 微信乐企联用 → 微信联用冲红;
建议使用方法:判断发票第5位为7,则调用【诺税通saas统一快捷冲红接口】进行冲红,根据返回的发票请求流水号调用【发票详情查询接口】查询红票信息。否则还是通过红字确认单冲红。
API 方法名:nuonuo.OpeMplatform.unifiedfastInvoiceRed 版本:V2.0
请求地址
| 环境 | 请求地址 |
|---|
| 正式环境 | https://sdk.nuonuo.com/open/v1/services |
| 沙箱环境 | https://sandbox.nuonuocs.cn/open/v1/services |
公共请求参数(消息头)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| Content-type | String | 否 | - | MIME类型【消息头】 | - |
公共请求参数(消息体)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| senid | String | 否 | - | 唯一标识,由企业自己生成32位随机码【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| elecInvoiceNumber | String | 是 | - | 对应蓝票发票号码(和对应蓝票发票流水号二选一必传) | 025123456789 |
| invoiceId | String | 是 | - | 对应蓝票发票流水号(和对应蓝票发票号码二选一必传) | 260820103000000001 |
| orderNo | String | 是 | - | 红票开票单号,不传则系统自动生成 | RED202608200001 |
| taxNum | String | 否 | - | 销方企业税号 | 91330100XXXXXXXXXX |
| callBackUrl | String | 是 | - | 冲红结果回调地址 | https://openapi.example.com/invoice/red/callback |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| code | String | 否 | - | 返回编码 | E0000 |
| describe | String | 否 | - | 返回描述 | 冲红申请成功 |
| result | Object | 否 | - | 返回结果 | - |
| └ invoiceSerialNum | String | 否 | - | 发票请求流水号 | 2608011314101000000 |
请求报文示例
NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.OpeMplatform.unifiedfastInvoiceRed"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
\"elecInvoiceNumber\": \"025123456789\",
\"orderNo\": \"RED202608200001\",
\"callBackUrl\": \"https://openapi.example.com/invoice/red/callback\",
\"invoiceId\": \"260820103000000001\",
\"taxNum\": \"91330100XXXXXXXXXX\"
}";
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 | 成功 | |
N9003 | 仅支持原蓝票为支付宝、微信支付乐企联用模式的发票冲红 | 请通过红字确认单进行冲红 |