# 数电发票快速申请红字信息及自动红冲

# 接口说明

如果出现交易失败或退货等情况，开发者可通过此接口快速申请红字信息表以及自动红冲已经开具的数电蓝票，通过回调地址返回红冲后的结果。此接口由申请红字信息表、自动下载红字信息表以及红冲等多个接口合成。

# 地址

/tax-api/invoice/red/quick/v1

# 请求参数

说明：如果既传了order_sn也传了order_id则以order_sn为准

参数名称	类型	必填	最大长度	描述	示例
invoices	list	是		红冲发票信息
invoices.seller_taxpayer_num	string	是	20	销方纳税人识别号（销方票面信息）：即统一社会信用代码（一般是15、17、18、20位长度位数字或大写字母，字母I、O、S、V、Z除外）	91469027MA5RH09M0R
invoices.callback_url	string	是	500	发票结果回传地址：接收平台推送的开票结果消息地址，可参见【开票结果异步通知】	开发者服务器地址
invoices.order_sn	string	否	21	高灯方商户订单号：开发者商户订单号对应的高灯方商户订单唯一标识((开具蓝票时返回值) 此字段与order_id不能同时为空	6590128277141372177
invoices.order_id	string	否	64	商户订单号：开发者接入方业务订单唯一标识(开具蓝票开具时填入值) 此字段与order_sn不能同时为空	gd_1904242006002627690
invoices.apply_reason	string	是	64	申请原因（全电发票只支持销方申请）销方申请： 2、对应以下两个理由中的其中一个：开票有误购买方拒收；开票有误等原因尚未交付 3、销货退回 4、服务中止 5、销售折让	传空默认为2

# 响应参数

说明：响应参数为list

字段	类型	必须	备注
state	int	是	红冲状态 1：已提交成功【开票结果会通过异步通知，开发者可以通过查询接口手动进行查询】 3：提交失败或已红冲
message	int	是	提交红冲描述
order_sn	int	是	高灯方商户订单号：开发者商户订单号对应的高灯方商户订单唯一标识((开具蓝票时返回值)
invoice_id	int	是	高灯红票发票唯一标识

# 请求示例

{
    "invoices":[{
       "seller_taxpayer_num":"111112222233333",
       "callback_url":"http://test.feehi.com/sign/mock/invoice-callback.php",
       "order_sn":"6555407740980870214"
    }]
}

# 响应示例

{
    "code": 0,
    "data": [
        {
            "state": 1,
            "message": "",
            "order_sn": "6555407740980870214",
            "invoice_id": "6555408438640385099"
        }
    ],
    "message": ""
}

← 上一篇：红字信息表撤销下一篇：红字信息表审核 →