2.1.03 红字确认单生成 - 发票云(旗舰版)API文档

1、数电票红冲，税局规定必须先申请红字确认单，再根据红字确认单红冲。本接口仅支持申请红字确认单，申请成功，需再次调用开具红冲接口。
（1）红冲时，如需关联负数开票申请单开票，可调用1.1.01开票申请单（支持拆分合并后，再开票）接口。
（2）红冲时，如不需要关联负数开票申请单开票，可调用2.1.04 数电票红冲（直接红冲或通过红字确认单）接口。

2、税局数电票红冲知识，请查看文档：https://jdpiaozone.yuque.com/nbklz3/sszola/edhu9lhwt2kq46sv

请求参数

Query 参数

access_token

string

可选

示例值:

1107974180231447552_L3nqi9yB42ysU25QKA2Z6qgxT3blIVYsp9Nr1eLbP9B63o4Pjb3177JC7544rQ0dgNCgwLEfI92NHbAaM5Cdxz1rsQwF9u1ANbDI

Body 参数application/json

requestId

string

时间戳

必需

businessSystemCode

string

必需

对接业务系统来源编码

interfaceCode

enum<string>

业务编码

必需

枚举值:

REDCONFIRMBILL.APPLY

data

object

必需

需要把data里面的base64字符串解密

orderNo

string

必需

流水号，重复推送会查询出之前流水号对应的红字确认单

<= 50 字符

invoiceCode

string

可选

要红冲的蓝票代码，非数电发票必填

<= 100 字符

invoiceNo

string

要红冲的蓝票号

必需

<= 100 字符

redReason

enum<string>

必需

红冲原因，默认值为2：开票有误

枚举值:

1234

invoiceType

string

可选

发票种类(部分红冲必传)， 01-数字化电子专票，02-数字化电子普票

invoiceDetail

array [object {13}]

可选

明细,全额红冲时不传

示例

{
  "requestId": "string",
  "businessSystemCode": "string",
  "interfaceCode": "REDCONFIRMBILL.APPLY",
  "data": {
    "orderNo": "string",
    "invoiceCode": "string",
    "invoiceNo": "string",
    "redReason": "1",
    "invoiceType": "string",
    "invoiceDetail": [
      {
        "lineProperty": "string",
        "originalSeq": 0,
        "billSourceId": "string",
        "goodsCode": "string",
        "goodsName": "string",
        "revenueCode": "string",
        "specification": "string",
        "units": "string",
        "quantity": "string",
        "price": "string",
        "amount": "string",
        "taxRate": "string",
        "taxAmount": "string"
      }
    ]
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

message

string

错误描述

可选

errorCode

string

错误代码，0-成功

必需

success

boolean

必需

data

object

必需

number

string

红字确认单编号

必需

govRedConfirmBillUuid

string

税局uuid

必需

riskInfo

array [object {2}]

可选

风控信息。当错误编码(errorCode)为30001时，存在当前节点数据。发票云版本6.0.6支持。如需解除风控，请调用6.0.01 风控解除接口。

confirmStatus

string

必需

红字确认单状态，01-无需确认,02-销方录入待购方确认,03-购方录入待销方确认,04-购销双方已确认,05-作废（销方录入购方否认）,06-作废（购方录入销方否认）,07-作废（超72小时未确认） 08-作废（发起方已撤销）,09-作废（确认后撤销）,10-作废（异常凭证）

示例

{
  "message": "生成成功",
  "errorCode": "0",
  "success": true
}

🟢200失败