接口说明
用于数电纸票快捷冲红
注：数电电票（票种：pc、bs）申请红字确认单后，当红字确认单为无需确认/双方已确认的时候会自动开具红票；若红票在税局已自动开具，但本地开票状态非开票完成，此接口也支持向税局查询自动开具的数电电子红票。
API 方法名：nuonuo.OpeMplatform.fastInvoiceRed 版本：V2.0
请求地址
| 环境 | 请求地址 |
|---|
| 正式环境 | https://sdk.nuonuo.com/open/v1/services |
| 沙箱环境 | https://sandbox.nuonuocs.cn/open/v1/services |
公共请求参数（消息头）
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| Content-type | String | 否 | - | MIME类型【消息头】 | - |
公共请求参数（消息体）
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| senid | String | 否 | - | 唯一标识，由企业自己生成32位随机码【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| orderNo | String | 否 | 20 | 开票单号,每个企业唯一；自动开具的数电红票，支持传该值替换掉自动开具红票诺诺生成的开票单号，仅支持替换一次 | 20250623221952851952 |
| extensionNumber | String | 是 | 5 | 分机号（只能为空或者数字；不传默认取蓝票的分机，传了则以传入的为准） | - |
| clerkId | String | 是 | 32 | 开票员id（诺诺系统中的id） | - |
| deptId | String | 是 | 32 | 部门门店id（诺诺系统中的id） | - |
| clerk | String | 是 | 20 | 开票员，仅乐企通道需要传值 | 张三 |
| clerkCardType | String | 是 | 30 | 开票人证件号码，仅乐企通道需要传值 | - |
| clerkCardNo | String | 是 | - | 开票人证件类型，仅乐企通道需要传值，枚举值为201：居民身份证 237：中华人民共和国港澳居民居住证 238：中华人民共和国台湾居民居住证 210：港澳居民来往内地通行证 213：台湾居民来往大陆通行证 233：外国人永久居留身份证 227：中华人民共和国护照 | 201 |
| orderTime | String | 是 | - | 单据时间 | - |
| taxNum | String | 否 | 20 | 销方企业税号（需要校验与开放平台头部报文中的税号一致） | 338801999999001 |
| invoiceCode | String | 是 | 12 | 对应蓝字增值税发票代码 | - |
| invoiceNumber | String | 是 | 20 | 对应蓝字增值税发票号码,若传入20位发票号码，则当做数电票号码处理 | - |
| elecInvoiceNumber | String | 是 | 20 | 对应蓝字数电票号码,蓝票为数电票时，请传入该字段 | 23312000000000540837 |
| invoiceId | String | 是 | 20 | 对应蓝票发票流水号 | - |
| billNo | String | 否 | 32 | 红字确认单编号,数电红票必传；且必须在备注中注明“被冲红蓝字数电票号码：YYYYYYYYY 红字发票信息确认单编号：XXXXXXXXX”字样，其中“Y”为数电蓝票的号码，“X”对应的红字确认单编号（由接口自动拼接） | 202302089545783568390 |
| billUuid | String | 否 | 32 | 红字确认单uuid | 1d7f08b6ddb64cb19b095b0360f074d7 |
| invoiceLine | String | 是 | 2 | 数电发票票种： bs:电子发票(增值税专用发票), pc:电子发票(普通发票) es:数电纸质发票(增值税专用发票) ec:数电纸质发票(普通发票)；注：1、默认为对应蓝票数电票种； 2、蓝票为es 时可选择 bs、es进行冲红 3、蓝票为ec时可选择pc、ec进行冲红 4、蓝票为全电电票时只能拿原票种冲红 | pc |
| paperInvoiceType | String | 是 | 12 | 数电纸票类型；04：2016版增值税普通发票（二联折叠票），05：2016版增值税普通发票（五联折叠票），1130：增值税专用发票（中文三联版），1140：增值税专用发票（中文四联版），1160：增值税专用发票（中文六联版），1170：增值税专用发票（中文七联版），000008102600：机动车销售统一发票（六联版），000008101200：2008版增值税普通发票（二联版），000008101500： 2008版增值税普通发票（五联版），17：2017版二手车销售统一发票 | - |
| callBackUrl | String | 是 | 255 | 回调地址（开票结果回调优先取传入的回调地址，若不传则取企业资质中配置的地址） | - |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| code | String | 否 | - | 状态码 | E0000 |
| describe | String | 否 | - | 详细信息 | 成功 |
| result | Object | 否 | - | 结果 | - |
| └ invoiceSerialNum | String | 否 | - | 发票流水号 | 17102510461601000165 |
请求报文示例
NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.OpeMplatform.fastInvoiceRed"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
\"elecInvoiceNumber\": \"23312000000000540837\",
\"orderNo\": \"20250623221952851952\",
\"callBackUrl\": \"\",
\"billUuid\": \"1d7f08b6ddb64cb19b095b0360f074d7\",
\"deptId\": \"\",
\"clerkCardNo\": \"201\",
\"clerkId\": \"\",
\"paperInvoiceType\": \"\",
\"invoiceCode\": \"\",
\"clerk\": \"张三\",
\"orderTime\": \"\",
\"extensionNumber\": \"\",
\"invoiceNumber\": \"\",
\"invoiceId\": \"\",
\"invoiceLine\": \"pc\",
\"taxNum\": \"338801999999001\",
\"clerkCardType\": \"\",
\"billNo\": \"202302089545783568390\"
}";
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);
返回码说明
