| 接口名称:/open/invoice/invoiceRed |
|---|
请求参数：
| 字段 | 类型 | 必填项 | 描述 |
| merchantCode | text | 是 | 机构商户号 |
| outTransNo | text | 是 | 商户外部流水号，全局唯一最长50位（必填） |
| tradeNo | text | 是 | 商户请求流水号，固定16位长度，后面将弃用 |
| blueReqSerialNo | text | 是 | 蓝票请求流水号 |
| redBillNo | text | 按条件 | 红字信息表编号，发票类型01，08，81，82时，必填，红字信息表编号由红字信息表申请接口返回 |
| invoiceCode | text | 是 | 发票代码 |
| invoiceNo | text | 是 | 发票号码 |
| redReason | text | 否 | 冲红原因 |
| notifyUrl | text | 否 | 开票结果后台通知地址 |
| items | Json Array | 否 | 开票项目列表，若不传，蓝票将全部冲红；需部分冲红时，必传，发票类型01，81，82不支持部分冲红 |
开票项目列表：
| 字段 | 类型 | 必填项 | 描述 |
| taxClassificationCode | text | 是 | 税收分类编码 |
| goodsName | text | 是 | 开票项目名称（必填） |
| taxRateValue | text | 是 | 税率(0.13，小数点后2位) |
| includeTaxFlag | text | 否 | 含税标示(0：不含税，1：含税，默认为 0 不含税) |
| quantity | text | 否 | 数量，票面信息，支持到小数点前8位,数量只能为负数。成品油发票数量不能为空，数量和单价必须同时为空或同时不为空 |
| meteringUnit | text | 否 | 单位 |
| unitPrice | text | 否 | 单价，票面信息，支持到小数点前8位,默认为不含税，可通过含税标示 includeTaxFlag，定义此字段为含税,单价只能为正数。成品油发票数量不能为空，数量和单价必须同时为空或同时不为空。 |
| zeroTaxFlag | text | 否 | 非零税率传""，0:出口零税，1:免税，2:不征税，3:普通零税率 |
| discountAmount | text | 否 | 该商品行的折扣金额，传正数 |
| invoiceAmount | text | 是 | 开票项目金额，票面信息，支持到小数点前8位,默认为不含税，可通过含税标示 includeTaxFlag，定义此字段为含税,金额只能为负数 |
响应：
| invoiceReqSerialNo | text | 发票请求流水号 |
| qrCodePath | text | 电子发票链接 |
后台通知：
通知类型 event: InvoiceNotify
| code | text | 发票状态码：0000：开票成功；6666：未开票（撤回开票中发票）；9999：开票失败。 |
| msg | text | 发票状态描述（成功/失败原因） |
| invoiceType | text | 开票类型1：蓝票；2：红票；3：蓝废；4：红废。 |
| reqSerialNo | text | 发票请求流水号，旧 |
| invoiceReqSerialNo | text | 发票请求流水号 |
| outTransNo | text | 商户外部流水号 |
| tradeNo | text | 订单号，开票成功时必传，失败时不传 |
| invoiceCode | text | 发票代码，开票成功时必传，失败时不传 |
| invoiceNo | text | 发票号码，开票成功时必传，失败时不传 |
| invoiceDate | text | 开票日期，开票成功时必传yyyy-MM-dd HH:mm:ss，失败时不传 |
| downloadUrl | text | 发票下载Url，电子发票开票成功时，即发票种类代码为 10 或 08 时必传，失败时不传，不定长，Base64字符串，其他发票种类不传 |
| securityCode | text | 效验码，开票成功时必传，失败时不传 |
| buyerName | text | 购买方名称 |
| buyerTaxpayerNum | text | 购买方纳税人识别号 |
| buyerAddress | text | 购买方地址 |
| buyerTel | text | 购买方电话 |
| buyerBankName | text | 购买方开户行 |
| buyerBankAccount | text | 购买方银行账号 |
接入商接收到异步通知后，响应“SUCCESS”这7个大写字母即表示通知成功，不成功的将会在下次尝试通知，通知频率为5s/10s/15s ······，最多通知20次