首页 > 开放平台 > 诺税通saas > 发票开具
开放平台/发票开具/诺税通saas统一快捷冲红接口

诺税通saas统一快捷冲红接口

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

接口说明

整合支付宝/微信联用冲红能力,调用方无需手动区分渠道,且无需提前申请确认单,系统自动分流并开具红票。 仅支持全额冲红,且限定原蓝票为微信联用或者支付宝联用开具。 渠道自动识别(后端根据原蓝票自动判断): 开票模式 = 支付宝乐企联用 → 支付宝联用冲红 ;开票模式 = 微信乐企联用 → 微信联用冲红; 建议使用方法:判断发票第5位为7,则调用【诺税通saas统一快捷冲红接口】进行冲红,根据返回的发票请求流水号调用【发票详情查询接口】查询红票信息。否则还是通过红字确认单冲红。

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

请求地址

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

公共请求参数(消息头)

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

公共请求参数(消息体)

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

私有请求参数

参数名类型必填长度说明示例
elecInvoiceNumberString是-对应蓝票发票号码(和对应蓝票发票流水号二选一必传)025123456789
invoiceIdString是-对应蓝票发票流水号(和对应蓝票发票号码二选一必传)260820103000000001
orderNoString是-红票开票单号,不传则系统自动生成RED202608200001
taxNumString否-销方企业税号91330100XXXXXXXXXX
callBackUrlString是-冲红结果回调地址https://openapi.example.com/invoice/red/callback

响应参数

参数名类型必填长度说明示例
codeString否-返回编码E0000
describeString否-返回描述冲红申请成功
resultObject否-返回结果-
   └ invoiceSerialNumString否-发票请求流水号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仅支持原蓝票为支付宝、微信支付乐企联用模式的发票冲红请通过红字确认单进行冲红
标签: 诺税通saas
上一篇:诺税通saas审核开票库执行开票接口
已经是最后一篇

申请试用

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