# 发票红冲

# 接口说明

如果出现交易失败或退货等情况，开发者可通过此接口红冲已经开具的发票。

电子发票只有红冲没有作废，纸质发票为当月作废，跨月红冲。

专用发票红冲时，需先申请红字信息表。

全电发票无论是专业发票还是普通发票，均需先申请信息确认表，如果调用快速申请红字信息表及自动红冲接口，可调用此接口做查询结果使用。

此接口纸票、电票、全电发票共用。

# 地址

/tax-api/invoice/red/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.red_serial_no	string	否	64	红字信息表编码：专票红冲时需申请红字信息表，此字段专票红冲时必填	3202201506013858
invoices.confirm_info_state	string	否		全电发票时必填，红字确认信息状态代码	01
invoices.confirm_info_uuid	string	否		全电发票(以及税控发票使用数电通道红冲)时必填，红字确认单uuid	a35494ab1e7f49e59ae30be9ac321cb5
invoices.special_element_code	string	否		全电发票特定要素代码, 传入红字信息表下载查询接口返回的值	08
invoices.tax_to_ele_channel	int	否		税控发票通过数电通道红冲必填 0:否 1:是默认0	0

# 响应参数

说明：响应参数为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",
        "order_id":"",
        "red_serial_no":"",
        "confirm_info_state":"",
        "confirm_info_uuid":"",
        "special_element_code":""
    }]    
}

# 响应示例

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

← 上一篇：红字信息表审核下一篇：实人认证二维码查询 →