2.1.04 数电票红冲（直接红冲或通过红字确认单）

接口说明

红冲先后顺序说明
1、流水号在待开发票列表存在，则直接匹配数据红冲
2、存在明细匹配组装明细红冲（发票云版本5.0.024支持）
3、乐企且存在红字确认单编号（发票云版本5.0.024支持）
4、根据红字确认单编号和UUID查找存量确认单数据红冲
5、根据原蓝票号码查询存量蓝票数据录入提交生成红字确认单全额红冲

本接口可自动申请红字确认单，当确认单状态为无需确认时，自动根据红字确认单红冲，开具红票，发票开具完成后，可通过2.1.02数电票回调接口回调发票数据；当确认单状态为待对方确认等异常状态，则将状态返回，不开具发票。
注意：本接口调用后，原蓝票将自动红冲，红字确认单无法关联至负数开票申请单。

部分红冲匹配原蓝票明细规则（2选1）：

明细直接传 originaldetailRowNo 匹配到原蓝票明细

明细发票云比对接口传值与蓝票明细自动匹配行序号，匹配字段包含：商品名称+税收分类编码+税率+不含税单价（红冲原因为销售折让时，可不根据单价匹配）

验证方法

验证接口返回编码91401
1、带明细行的数据验证，发票号码需要符合：066574780154360003开头，确认单状态结尾（状态值参考上面的参数）如：066574780154360003XXXX03
2、原蓝originaldetailRowNo需要修改数据库的发票号码。发票号码需要符合：066574780154360003开头，确认单状态结尾（状态值参考上面的参数）如：066574780154360003XXXX03

验证回推返回91401
1、确认单编号验证：需要先在系统生成对应的红字确认单，然后修改红字确认单编号为：066574780154360004开头，确认单状态结尾（状态值参考上面的参数）如：066574780154360004XXXX03
2、原蓝票红冲校验：需要先在系统生成对应的红字确认单，然后修改原蓝票号码为：066574780154360001开头，确认单状态结尾（状态值参考上面的参数）如：066574780154360001XXXX03

税局业务规则

备注

数电票红冲的规则较为复杂，建议对接者对接前先阅读底下文档：https://jdpiaozone.yuque.com/nbklz3/sszola/edhu9lhwt2kq46sv

部分红冲说明
金税四期数电发票全额红冲、部分红冲规则：红冲时，需要先申请红字确认单，且必须关联至原蓝票、原蓝票明细行序号才可以进行红冲。

税局规则：
1、~~数电票在购买方将蓝字发票勾选或入账后，销售方才可以发起部分红冲~~；当购买方未勾选未入账时，仅能由销售方发起全额红冲。
更新补充：税局最新规则，购方未勾选未入账等未使用蓝票的情形，支持进行部分红冲、全额红冲，红冲时，不需要对方确认。---更新时间：2024.9.20
2、税局的四种红冲原因，开票有误仅支持全额红冲，其他三种支持全额红冲、部分红冲，部分红冲时，原则上单价不允许变更。

请求参数

Query 参数

Header 参数

Body 参数application/json

示例

{
    "requestId": "string",
    "businessSystemCode": "string",
    "interfaceCode": " ALLE.INVOICE.RED",
    "data": {
        "serialNo": "string",
        "invoiceCode": "string",
        "invoiceNum": "string",
        "originalIssueTime": "string",
        "originalInvoiceAmount": 0,
        "originalTotalTaxAmount": 0,
        "redReason": "01",
        "govRedConfirmBillUuid": "string",
        "redInfoBillNo": "string",
        "account": "string",
        "drawer": "string",
        "invoiceType": "01",
        "orgCode": "string",
        "sellerName": "string",
        "sellerTaxpayerId": "string",
        "sellerBank": "string",
        "sellerBankAccount": "string",
        "sellerAddress": "string",
        "sellerTel": "string",
        "buyerName": "string",
        "buyerTaxpayerId": "string",
        "buyerBank": "string",
        "buyerBankAccount": "string",
        "buyerAddress": "string",
        "buyerTel": "string",
        "specialType": "null",
        "buyerRecipientPhone": "string",
        "buyerRecipientMail": "string",
        "naturalPersonFlag": "Y",
        "invoiceDetail": [
            {
                "lineProperty": "0",
                "originalSeq": 0,
                "originaldetailRowNo": "string",
                "billSourceId": "string",
                "goodsCode": "string",
                "goodsName": "string",
                "revenueCode": "string",
                "specification": "string",
                "units": "string",
                "quantity": 0,
                "price": 0,
                "amount": 0,
                "taxRate": 0,
                "taxAmount": 0
            }
        ]
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

2.1.04 数电票红冲（直接红冲或通过红字确认单）

接口说明#

验证方法#

税局业务规则#

请求参数

示例代码

返回响应

接口说明

验证方法

税局业务规则