首页 > 开放平台 > 诺税通saas > 红字信息表
开放平台/红字信息表/诺税通saas红字专用发票信息表申请接口

诺税通saas红字专用发票信息表申请接口

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

接口说明

红字专用发票信息表申请接口

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

请求地址

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

公共请求参数(消息头)

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

公共请求参数(消息体)

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

私有请求参数

参数名类型必填长度说明示例
billNoString否2424 位申请单号:12 位 金税盘编号+12 位该 红字信息表请求时间 (YYMMDDHHMMSS)661545611111111233232323
buyerNameString否100购方名称诺诺网
buyerTaxNoString否20购方税号914419001234567890
applyRemarkString是10申请说明: 1100000000,购方申请-已抵扣;1010000000,购方申请-未抵扣; 0000000100,销方申请(默认)0000000100
invoiceLineString否1发票种类: s 增值税专用发票,b 增值税电子专用发票s
oriInvoiceCodeString否12对应蓝票代码,10位或12位,11位请左补05000201530
oriInvoiceNumberString否8对应蓝票号码,不满8位请左补046829224
blueInvoiceTimeString是6对应蓝票的开票年月,YYYYMM格式202011
sellerNameString否20销方名称移动测试盘
sellerTaxNoString否20销方税号150301199811285326
taxAmountNumber否-合计税额,带负号,精确到小数点后面两位-0.12
taxExcludedAmountNumber否-合计不含税金额,带负号,精确到小数点后面两位-0.88
clerkIdString是32开票员id(诺诺网系统中的id)3F7EA439CA8B4C60A2FFF3EA3290B084
departmentIdString是32部门门店id(诺诺网系统中的id)9F7E9439CA8B4C60A2FFF3EA3290B088
productOilFlagString否1成品油标志:0,非成品油;1,成品油0
vehicleFlagString是10-非机动车(默认);1-机动车0
specificFactorString是2特定要素:0普通发票(默认)、2 稀土、34 电子烟、35 矿产品0
billTypeString是10-正常(默认);1-逾期;2-机动车类专票信息表(涉及退货和开具错误等,合格证退回);3-机动车类专票信息表(仅涉及销售折让,合格证不退回);4-矿产品类专用信息表(涉及销售数量和金额变更);5-矿产品类专用信息表(仅涉及销售金额变更,不涉及数量变动)0
extensionNumberString是5分机号0
machineCodeString是12机器编号661288888888
terminalNumberString是4终端号1
callbackUrlString是150信息表回调地址http:127.0.0.1/invoice/scan
invoiceRedApplyDetailsArray否-红字申请明细-
   └ goodsCodeString否19商品编码1030101010000000000
   └ selfCodeString是20企业自编码-
   └ goodsCodeAbbString是90商品编码简称,当企业资质配置追加简称时,则此项必填。商品编码简称+商品名称不超过90位谷物细粉
   └ goodsNameString否90商品名称:商品编码简称+商品名称不超过90 位。商品名称qqq
   └ numString是16数量,带负号;数量、单价必须都不填,或者都必填,不可只填一个;当数量、单价都不填时,商品金额(不含税)、商品税额都必填。建议保留小数点后8位。最大支持16位数字(小数点后最多13位)-1
   └ specTypeString是40规格型号袋装
   └ taxAmountString是-商品税额,带负号,精确到小数点后面两位。商品金额 (不含税)、商品税额任何一个不传时,会根据传入的单价含税标志、单价、 数量进行计算, 可能和实际数值存在误差,建议都传入。-0.12
   └ taxExcludedAmountString是16商品金额(不含税);带负号,精确到小数点后面两位。商品金额 (不含税)、商品税额任何一个不传时,会根据传入的单价含税标志、单价、数量进行计算,可能和实际数值存在误差,建议都传入。-0.88
   └ deductionsString是16扣除额(带负号),小数点后两位。差额征收的发票目前只支持一行明细。不含税差额 = 不含税金额 - 扣除额; 税额 = 不含税差额*税率。0
   └ taxExcludedPriceString是16单价(不含税)为正数,如单价含税标志 withTaxFlag=false,则此项必填。数量、单价必须都不填,或者都必填,不可只填一个;当数量、单价都不填时,商品金额 (不含税)、商品税额都必填。建议金税盘保留小数点后8位;百旺盘保留小数点后6位0.88
   └ priceString是16单价(含税)为正数,如单价含税标志withTaxFlag=true,则此项必填。数量、单价必须都不填,或者都必填,不可只填一个;当数量、单价都不填时,商品金额(不含税)、商品税额都必填。 建议金税盘保留小数点后8位;百旺盘保留小数点后6位。最大支持16位数字(小数点后最多13位)1.0
   └ taxRateString否10税率0.13
   └ unitString是22单位袋
   └ withTaxFlagString否-单价含税标志:false,不含税;true,含税false
   └ favouredPolicyFlagString是-优惠政策标识:false,不使用;true,使用false
   └ favouredPolicyNameString是50优惠政策内容:即征即退、免税、简易征收等, 当优惠政策标识favouredPolicyFlag为1时,则此项必填。免税
   └ zeroRateFlagString是1零税率标识:空,非零税率;1,免税;2,不征税;3,普通零税率-

响应参数

参数名类型必填长度说明示例
codeString否-结果代码E0000
describeString否-详细信息同步成功
resultObject否-业务数据(A9+开票服务器类型时同步返回如下的申请结果)-
   └ billNoString否-24位申请单号661545611111111233232323
   └ billInfoNoString否-信息表编号1403011905002804
   └ billStatusString否-信息表状态(0:申请中 1:审核成功 2:审核失败 3:申请成功 4:申请失败 6:撤销中 7:撤销失败 8:已撤销)1
   └ billMessageString否-[信息表状态代码]信息表状态描述"[TZD0000]审核通过"

请求报文示例

NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.OpeMplatform.InvoiceRedApply"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
  \"terminalNumber\": \"1\",
  \"machineCode\": \"661288888888\",
  \"buyerTaxNo\": \"914419001234567890\",
  \"taxExcludedAmount\": -0.88,
  \"departmentId\": \"9F7E9439CA8B4C60A2FFF3EA3290B088\",
  \"billType\": \"0\",
  \"invoiceRedApplyDetails\": [
    {
      \"specType\": \"袋装\",
      \"taxExcludedAmount\": \"-0.88\",
      \"favouredPolicyName\": \"免税\",
      \"goodsCodeAbb\": \"谷物细粉\",
      \"num\": \"-1\",
      \"withTaxFlag\": \"false\",
      \"favouredPolicyFlag\": \"false\",
      \"deductions\": \"0\",
      \"taxRate\": \"0.13\",
      \"unit\": \"袋\",
      \"price\": \"1.0\",
      \"zeroRateFlag\": \"-\",
      \"goodsCode\": \"1030101010000000000\",
      \"selfCode\": \"-\",
      \"taxAmount\": \"-0.12\",
      \"taxExcludedPrice\": \"0.88\",
      \"goodsName\": \"商品名称qqq\"
    }
  ],
  \"sellerName\": \"移动测试盘\",
  \"oriInvoiceNumber\": \"46829224\",
  \"clerkId\": \"3F7EA439CA8B4C60A2FFF3EA3290B084\",
  \"vehicleFlag\": \"0\",
  \"buyerName\": \"诺诺网\",
  \"blueInvoiceTime\": \"202011\",
  \"sellerTaxNo\": \"150301199811285326\",
  \"applyRemark\": \"0000000100\",
  \"oriInvoiceCode\": \"5000201530\",
  \"productOilFlag\": \"0\",
  \"extensionNumber\": \"0\",
  \"invoiceLine\": \"s\",
  \"callbackUrl\": \"http:127.0.0.1/invoice/scan\",
  \"taxAmount\": -0.12,
  \"billNo\": \"661545611111111233232323\",
  \"specificFactor\": \"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同步成功
E9512申请单号不能超过 24 位
E9520只支持专票申请
E9522该发票为红字发票,不能冲红
E9529购方税号不能为空
标签: 诺税通saas

申请试用

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